Skip to content

feat: add bookkeeper skill - #384

Open
ArgonautWorks wants to merge 1 commit into
runxhq:mainfrom
ArgonautWorks:feat/bookkeeper
Open

feat: add bookkeeper skill#384
ArgonautWorks wants to merge 1 commit into
runxhq:mainfrom
ArgonautWorks:feat/bookkeeper

Conversation

@ArgonautWorks

@ArgonautWorks ArgonautWorks commented Aug 4, 2026

Copy link
Copy Markdown

What changed

  • add a deterministic public bookkeeper skill with typed transaction, chart-of-accounts, and prior-period inputs
  • categorize only when a transaction binds uniquely to an existing chart account
  • return confidence, reason, anomaly findings, and exact matched/unmatched reconciliation totals
  • seal ambiguous, unknown-account, and out-of-period batches as needs_review without guessing
  • expose explicit no-write evidence: no ledger mutation, writes, external effects, network access, or downstream dispatch

Why

Bookkeeping reconciliation should be explainable without implying that a journal was posted. This package turns admitted transaction lines into a bounded read-only artifact and makes unmatched or anomalous evidence visible rather than weakening the account-binding rule.

Validation

  • runx-cli 0.8.2
  • node --check skills/bookkeeper/run.mjs — passed
  • runx skill inspect ./skills/bookkeeper --json — ready, fully bound, no unresolved edges
  • runx harness ./skills/bookkeeper -R <fresh-dir> --json — 8/8 cases passed, zero assertion errors
  • hosted registry publish gate — passed; argonautworks/bookkeeper@0.1.0 published
  • digest-pinned clean install — passed; installed package inspected ready
  • post-publish registry dogfood — sealed; 3 categorized, 0 anomalies, matched 3, unmatched 0
  • production receipt verification — valid digest, content address, and Ed25519 signature; zero findings
  • git diff --check — passed

Public evidence

Frantic bounty: https://gofrantic.com/bounties/89

Signed-off-by: Timothy Robert Peterson <312591046+ArgonautWorks@users.noreply.github.com>
@ArgonautWorks
ArgonautWorks marked this pull request as ready for review August 4, 2026 10:28
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant