Repository navigation
0.18.0 - Complete listings, accountable writes and verifiable facts
Released 2026-10-08.
- Complete completed-task listings.
ats tasks completed [DAYS]pages through the completion window past the backend's per-call limit, deduplicates boundary entries, and reportspagesandcomplete; a listing that stops at its page budget warns and fails--require-complete. - Actor on every write. Ledger records carry
actor: { id, kind, session? }for agents, humans and unattributed callers. A global--agentnames the acting agent for one invocation;ATS_ACTOR_KINDandATS_SESSION_IDare honored, andats ledger listfilters by--actor-kindand--session. - Fact source verification.
ats kg verifyrechecks every active fact's source against the system that holds it — task references through the adapter, files on disk, URLs with--network— and reportsverified,changed,staleorunverifiable. Stale or changed sources exit 2;--propose-retractstages reviewed retractions. - Lossless body normalization. The Goal+Log normalizer keeps every word it receives; a body it cannot restructure without loss is written verbatim with a warning naming the words, and one-line bodies of literal
\nsequences get a hint to pass real line breaks. - Review separation of duties. Approvals come from an identity other than the one that staged the item (exit 4 otherwise);
ATS_REVIEW_REQUIRE_HUMAN=1also requires a human approver. Items record the staging and deciding actor, andreview approve|rejectaccept--note. - Provenance policy for facts.
kg propose --require-source any|checkable, orATS_KG_REQUIRE_SOURCEwith optionalATS_KG_REQUIRE_SOURCE_DOMAINS, refuses unsourced proposals with verdictunsourcedand exit 4, per line in batches too. - Lossless frontmatter updates. Obsidian and OKF updates rewrite only the keys they change; block lists, nested maps, comments, key case and unknown keys stay byte for byte.
- Hash-chained action ledger. Each record carries
prevHash;ats ledger verifychecks the chain, names breaks by line, exits 2, and prints aheadhash that--expect-headcompares. - Ratification tiers.
kg propose --tier source-fact|action-record|statement|beliefrecords the kind of claim;kg pendingcounts and filters by tier, and ratified facts and exports keep it. - Dependency maintenance. The lockfile resolves the patched proxy-addr release;
npm auditreports no findings. - Release preparation. Document batching pending consumer changes before review and merging repository-only maintenance without publishing unchanged packages.
- Beads worker setup. Document matching ATS and Beads actor identities for claiming and completing owned issues.
- Cache refresh validation. Wait for the refreshed corpus and lease cleanup together in the stale-cache CLI proof, preserving the bounded deadline and final cleanup assertion.