- PROTOCOL_ID =
PROTOCOL
- ZONE_PURPOSES =
Conventional zone purposes. Unknown zones (declared in the manifest but not listed here) get no ‘purpose` field.
{
"identity" => "slow-changing identity; human-only writes",
"working" => "active project state; humans, AI, and scripts share this surface",
"intake" => "declared external inputs; script-refreshed via actions",
"review" => "AI proposals awaiting human accept",
"output" => "build-computed outputs; never hand-edited",
}.freeze- WRITE_FLOW_TEMPLATES =
Per-kind write-flow templates. Each lambda receives the user-facing role name and returns a guidance string for that role. Roles whose kind has no template (e.g. unknown future kinds) are omitted from write_flows.
{
accept_authority: lambda do |name, _manifest|
"edit files in identity/working zones, then 'textus put KEY --as=#{name}'"
end,
proposer: lambda do |name, manifest|
authority = manifest.roles_with_kind(:accept_authority).first || "accept_authority"
"propose changes by writing review.* entries with --as=#{name} and a 'proposal:' frontmatter block; " \
"the #{authority} role runs 'textus accept' to apply"
end,
runner: lambda do |name, _manifest|
"refresh intake entries with 'textus refresh KEY --as=#{name}' (uses the entry's declared action)"
end,
generator: lambda do |_name, _manifest|
"'textus build' computes output entries from projections; output files are never hand-edited"
end,
}.freeze- AGENT_PROTOCOL_TEMPLATE =
Static, store-independent parts of the agent-facing protocol. The ‘role_resolution` block is derived per-manifest in agent_protocol(…) because role names are user-configurable.
{
"envelope_shape" => {
"summary" => "every read/write payload is a JSON envelope with _meta, body, uid, and etag",
"fields" => {
"_meta" => "hash of structured frontmatter; schema-validated per entry family",
"body" => "string payload (markdown/text) or nil for json/yaml formats where body lives in _meta",
"uid" => "stable 16-char hex identifier; preserved across writes and key renames",
"etag" => "content hash; pass back on writes to detect concurrent edits",
},
"ref" => "SPEC.md §8",
},
"recipes" => {
"read" => {
"purpose" => "find and read an entry",
"steps" => [
"textus list --zone=ZONE --prefix=PREFIX # discover keys",
"textus get KEY # returns envelope JSON",
],
},
"write" => {
"purpose" => "create or update an entry",
"steps" => [
"textus schema get FAMILY # learn the _meta field shape",
"build an envelope JSON: {_meta: {...}, body: \"...\"}",
"echo ENVELOPE | textus put KEY --as=ROLE --stdin",
],
},
"propose" => {
"purpose" => "agent suggests a change for human review",
"agent_steps" => [
"echo ENVELOPE | textus put review.KEY --as=agent --stdin",
],
"human_steps" => [
"textus accept review.KEY --as=human # promotes the proposal to its target zone",
],
},
"refresh" => {
"purpose" => "rebuild stale intake-zone caches from their declared actions",
"steps" => [
"textus freshness --zone=intake # report fresh/stale per entry",
"textus refresh stale --zone=intake --as=runner",
],
},
},
}.freeze- CLI_VERBS =
The CLI verb catalog. Truth lives here; do not derive dynamically. Agents that read boot should see a stable shape regardless of how verb implementations evolve.
[
{ "name" => "boot", "summary" => "this output — orientation for agents and tools" },
{ "name" => "list", "summary" => "enumerate keys (optional --prefix)" },
{ "name" => "get", "summary" => "read an entry; envelope with _meta, body, uid, etag" },
{ "name" => "where", "summary" => "resolve a key to its zone and path without reading" },
{ "name" => "schema", "summary" => "field shape for a key family" },
{ "name" => "put", "summary" => "write an entry; --as=<role>, --stdin payload" },
{ "name" => "accept", "summary" => "apply a review.* proposal; --as=human only" },
{ "name" => "key", "summary" => "key operations: 'key mv', 'key uid'" },
{ "name" => "delete", "summary" => "delete an entry; --as=<role>" },
{ "name" => "build", "summary" => "materialize output entries; publish_to and publish_each fan out copies" },
{ "name" => "refresh", "summary" => "run an action for an intake entry" },
{ "name" => "freshness", "summary" => "per-entry freshness report (status, age, ttl, on_stale)" },
{ "name" => "audit", "summary" => "query .textus/audit.log with filters (key, role, since, correlation-id, ...)" },
{ "name" => "blame", "summary" => "audit rows for one key joined with git commit metadata" },
{ "name" => "rule", "summary" => "inspect effective rules: 'rule list', 'rule explain KEY'" },
{ "name" => "doctor", "summary" => "health-check the store (missing schemas, illegal keys, sentinel drift, etc.)" },
{ "name" => "hook",
"summary" => "list and run registered hooks: 'hook list', 'hook run NAME'" },
{ "name" => "pulse",
"summary" => "delta since cursor — changed entries, stale, pending review, doctor summary" },
].freeze