Skip to content

v0.50.0

Choose a tag to compare

@github-actions github-actions released this 05 Jun 01:41
· 781 commits to main since this release
13448e8

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 full boot envelope now also carries contract_etag. --lean is a contract arg, so it threads to every surface (CLI flag, MCP lean tool arg, Ruby kwarg).
  • textus ships as a Claude Code plugin (ADR 0084) — a single self-contained .claude-plugin/plugin.json with an inline SessionStart hook (startup/clear/compact) that runs boot --lean, so enabling the plugin auto-orients each session. The agent-invokable boot tool is unchanged; the hook is additive. Plugin data is kept inside .claude-plugin/ (a separate concern from the gem), not a top-level hooks/ dir.
  • Agent-integration config is textus-managed, projected from canon (ADR 0086). This repo's .mcp.json and .claude-plugin/plugin.json are now build artifacts — textus build projects them from knowledge.project + Textus::VERSION (so the plugin version can never drift off the gem) the same way it projects CLAUDE.md. The plugin manifest also gains an inline mcpServers stanza (enable the plugin → MCP server and orientation hook in one). A new provenance: false derived-entry flag lets the JSON renderer emit config without a _meta block. Downstream consumers are unaffected — init --with-agent still 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; boot self-heals (ADR 0083). A mid-session manifest/hook/schema edit no longer deadlocks every MCP verb behind "re-run boot": pure reads and boot bypass the guard, boot re-arms the session's cached contract_etag, and only mutating verbs (the Write:: family + the destructive Maintenance:: verbs tend/zone_mv/key_mv_prefix/key_delete_prefix) enforce it. "Re-run boot" now actually recovers instead of looping. Refines ADR 0074.
  • tend returns a health summary, not full issues[] (ADR 0085) — matching pulse; doctor stays the sole owner of detailed health output.

Removed (breaking)

  • The public freshness verb (ADR 0085). Observability is now two verbs on orthogonal axes — pulse (transient/temporal: changed + stale + next_due_at) and doctor (structural correctness). The lifecycle scan that backed freshness becomes a Ruby-only internal (empty surfaces, ADR 0073) consumed by pulse and the hook context; per-entry detail is reconstructable from get (carries stale/last_fetched_at) + rule_explain (the lifecycle: ttl + on_expire). Migration: replace textus freshness with textus pulse (for the stale list / next_due_at) or get + rule_explain (for one entry's verdict). SPEC's generator-drift attribution is corrected to doctor's generator_drift check.