Repository navigation
v0.50.0
freshness collapses into pulse, the contract-drift guard stops deadlocking, and boot gains a lean session-start projection shipped via a plugin.
Added
boot --lean(ADR 0084) — a compact orientation projection (protocol,store_root,zones,agent_quickstart,contract_etag) for cheap session-start injection. The fullbootenvelope now also carriescontract_etag.--leanis a contract arg, so it threads to every surface (CLI flag, MCPleantool arg, Ruby kwarg).- textus ships as a Claude Code plugin (ADR 0084) — a single self-contained
.claude-plugin/plugin.jsonwith an inlineSessionStarthook (startup/clear/compact) that runsboot --lean, so enabling the plugin auto-orients each session. The agent-invokableboottool is unchanged; the hook is additive. Plugin data is kept inside.claude-plugin/(a separate concern from the gem), not a top-levelhooks/dir. - Agent-integration config is textus-managed, projected from canon (ADR 0086). This repo's
.mcp.jsonand.claude-plugin/plugin.jsonare now build artifacts —textus buildprojects them fromknowledge.project+Textus::VERSION(so the plugin version can never drift off the gem) the same way it projectsCLAUDE.md. The plugin manifest also gains an inlinemcpServersstanza (enable the plugin → MCP server and orientation hook in one). A newprovenance: falsederived-entry flag lets the JSON renderer emit config without a_metablock. Downstream consumers are unaffected —init --with-agentstill scaffolds a write-once.mcp.json(a build must never clobber a user's config).
Changed
- The contract-drift guard applies to mutating verbs only;
bootself-heals (ADR 0083). A mid-session manifest/hook/schema edit no longer deadlocks every MCP verb behind "re-run boot": pure reads andbootbypass the guard,bootre-arms the session's cachedcontract_etag, and only mutating verbs (theWrite::family + the destructiveMaintenance::verbstend/zone_mv/key_mv_prefix/key_delete_prefix) enforce it. "Re-run boot" now actually recovers instead of looping. Refines ADR 0074. tendreturns a health summary, not fullissues[](ADR 0085) — matchingpulse;doctorstays the sole owner of detailed health output.
Removed (breaking)
- The public
freshnessverb (ADR 0085). Observability is now two verbs on orthogonal axes —pulse(transient/temporal:changed+stale+next_due_at) anddoctor(structural correctness). The lifecycle scan that backedfreshnessbecomes a Ruby-only internal (emptysurfaces, ADR 0073) consumed bypulseand the hook context; per-entry detail is reconstructable fromget(carriesstale/last_fetched_at) +rule_explain(thelifecycle:ttl +on_expire). Migration: replacetextus freshnesswithtextus pulse(for thestalelist /next_due_at) orget+rule_explain(for one entry's verdict). SPEC's generator-drift attribution is corrected todoctor'sgenerator_driftcheck.