# bookkeeper delivery report

ArgonautWorks built and published `argonautworks/bookkeeper@0.1.0` for Frantic bounty 89. The exact public source revision is `00988964a8731fb30e530b9584629ffcdc6edd28`, under review in [runxhq/runx#384](https://github.com/runxhq/runx/pull/384).

## Result

- The live adoption page is https://runx.ai/x/argonautworks/bookkeeper@0.1.0.
- The registry lists ArgonautWorks as publisher and resolves digest `sha256:01edac6e7837e7f3f9c1fa21b253f166ab5202462e0639e9a568e25e6a77aedf`.
- A clean digest-pinned install succeeded and inspected as ready with no unresolved skill edges.
- The Runx 0.8.2 local and hosted harness passed all eight cases with zero assertion errors.
- The post-publish dogfood ran the registry ref, categorized three lines, reported zero anomalies, and reconciled matched=3 and unmatched=0.
- Every categorized line binds to an exact supplied chart code and name with confidence, reason, source transaction ID, and matched terms.
- Ambiguous chart matches, unknown explicit codes, and out-of-period dates return `needs_review`; invalid amounts refuse before reconciliation.
- Every successful and needs-review harness lane asserts `ledger_mutation=false`, zero writes, and zero external effects.
- The dogfood receipt `runx:receipt:sha256:c2c3ea70e5a4e208f7e4d4e86d2386ea44182cb95f5d5e57fd48619ab3d9b130` independently verifies with a production-mode Ed25519 signature and zero findings.
- The skill reads no credentials, uses no network, touches no payment rail, and does not claim that a journal was posted.

## Delivery references

- Publisher owner: `ArgonautWorks`; package name: `bookkeeper`; version: `0.1.0`; registry ref: `argonautworks/bookkeeper@0.1.0`.
- `public_url`: https://runx.ai/x/argonautworks/bookkeeper@0.1.0
- `pr_url`: https://github.com/runxhq/runx/pull/384
- `source_url`: https://github.com/ArgonautWorks/runx/tree/00988964a8731fb30e530b9584629ffcdc6edd28/skills/bookkeeper
- Raw `x_yaml`: https://raw.githubusercontent.com/ArgonautWorks/runx/00988964a8731fb30e530b9584629ffcdc6edd28/skills/bookkeeper/X.yaml
- Raw `skill_md`: https://raw.githubusercontent.com/ArgonautWorks/runx/00988964a8731fb30e530b9584629ffcdc6edd28/skills/bookkeeper/SKILL.md
- `verification_json`: https://raw.githubusercontent.com/ArgonautWorks/frantic-89-bookkeeper-evidence/main/verification.json — it records the public receipt-verification verdict and all final command results.
- Publish method: `runx login --provider github --from-gh --for publish`, then `runx registry publish ./skills/bookkeeper/SKILL.md --registry https://api.runx.ai --version 0.1.0 --json`.
- Install command: `runx add argonautworks/bookkeeper@0.1.0 --registry https://api.runx.ai --digest 01edac6e7837e7f3f9c1fa21b253f166ab5202462e0639e9a568e25e6a77aedf`.
- Hosted harness status: passed in the registry publish gate; local harness case names and all eight receipt IDs are recorded in `verification.json`.
- Dogfood command and complete input: recorded without omitted values in `evidence.json` under `dogfood.command` and `dogfood.input`.

## Install and run

```bash
runx add argonautworks/bookkeeper@0.1.0 \
  --registry https://api.runx.ai \
  --digest 01edac6e7837e7f3f9c1fa21b253f166ab5202462e0639e9a568e25e6a77aedf

runx skill argonautworks/bookkeeper@0.1.0 reconcile \
  --registry https://api.runx.ai \
  --input-json transactions='[{"id":"txn-1","date":"2026-07-05","description":"AWS hosting","amount":-100,"currency":"USD"}]' \
  --input-json chart_of_accounts='[{"code":"6100","name":"Cloud Hosting","type":"expense","keywords":["aws","hosting"]}]' \
  --input-json prior_period='{"start_date":"2026-07-01","end_date":"2026-07-31"}' \
  --json
```

## Verify the dogfood receipt

Clone this evidence repository, then use Runx's documented public demo verification key:

```bash
export RUNX_RECEIPT_VERIFY_KID=runx-demo-key
export RUNX_RECEIPT_VERIFY_ED25519_PUBLIC_KEY_BASE64='IVL40Zt5HSRFMkLhXy6rbLfP+ntqXtMAl5YOBpiB2xI='

runx verify \
  --receipt receipts/sha256-c2c3ea70e5a4e208f7e4d4e86d2386ea44182cb95f5d5e57fd48619ab3d9b130.json \
  --json
```

Expected verdict: `valid: true`, digest and content address valid, signature mode `production`, signature status valid, and no findings.