{
  "tools": [
    {
      "name": "auth_whoami",
      "description": "Who is asking, and what may they do? Asks GitHub for the caller's login and repository role, maps the role to a gateway actor, and answers from the ODRL policies: unscoped grants, an action (optionally scoped by process, task, role and target), or the full task-authorization verdict for a BPMN step. Always states that GitHub's role covers the whole repository, never a sub-graph, node or query path.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "actor": {
            "description": "A declared actor you are acting as (cat-harness/scenarios/actors/)",
            "type": "string"
          },
          "action": {
            "description": "An ODRL action to ask about, e.g. content-authoring",
            "type": "string"
          },
          "process": {
            "description": "Process id, to scope the question or check a task",
            "type": "string"
          },
          "task": {
            "description": "Node id; with process, runs the task-authorization check",
            "type": "string"
          },
          "role": {
            "description": "The role the lane binds",
            "type": "string"
          },
          "target": {
            "description": "The content acted on: a block id, path or bean id",
            "type": "string"
          }
        }
      },
      "_meta": {
        "tool": "user-auth",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/user-auth.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "bean_query",
      "description": "Query the beans knowledge graph using named graph analytics or arbitrary SPARQL 1.1. Available named queries: safe_drain_candidates, actionable_leaves, critical_path_blockers, epic_burndown, rollup_invariant_violations, stale_claims, unparented_open_tasks, circular_blockers, high_fanout_epics",
      "inputSchema": {
        "type": "object",
        "properties": {
          "named": {
            "description": "Pre-defined named query: safe_drain_candidates, actionable_leaves, critical_path_blockers, epic_burndown, rollup_invariant_violations, stale_claims, unparented_open_tasks, circular_blockers, high_fanout_epics",
            "type": "string"
          },
          "sparql": {
            "description": "Arbitrary SPARQL 1.1 SELECT query over the bean store",
            "type": "string"
          },
          "format": {
            "default": "table",
            "description": "Output format: table, json, or ids",
            "type": "string",
            "enum": [
              "table",
              "json",
              "ids"
            ]
          }
        }
      },
      "_meta": {
        "tool": "bean-query",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/bean-query.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "corpus_search",
      "description": "Search the authored corpus AND the ingested library together, then follow the graph out from what matched. Reach for this before declaring anything open, unproved or novel. A block one `uses` hop from a match is found whatever words it uses, which a lexical search cannot do. Each hit says whether it MATCHED or was REACHED, and by which edge. A `~` prefix means the edge was traversed backwards, so that node depends on the seed. Counts are split authored vs ingested: many ingested hits and no authored ones means cite it, not derive it. `emptyRoots` names a root that exists but holds no graph nodes, which is what an ungenerated .jsonld corpus looks like. Seeding is lexical, so query with a short phrase: a long multi-word query that no node contains seeds nothing (`noSeeds: true`).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "description": "Words to seed on. A short phrase works best."
          },
          "hops": {
            "description": "Expansion depth (default 1). 0 is a plain lexical search.",
            "type": "integer",
            "minimum": 0,
            "maximum": 4
          },
          "direction": {
            "description": "'out' = what the seeds depend on; 'in' = what depends on them. Default both.",
            "type": "string",
            "enum": [
              "out",
              "in",
              "both"
            ]
          },
          "provenance": {
            "description": "Restrict SEEDS to one population. Expansion still crosses both.",
            "type": "string",
            "enum": [
              "authored",
              "ingested"
            ]
          },
          "searchText": {
            "description": "Also scan companion Markdown for seeds. Turn it on when a label/title search comes back empty.",
            "type": "boolean"
          },
          "limit": {
            "description": "Seed cap before expansion (default 20).",
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "query"
        ]
      },
      "_meta": {
        "tool": "corpus-search",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/corpus-search.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "folio_init",
      "description": "Scaffold a new folio (content repository) that uses folio-assistant: folio/, uploads/, library/, the document + chapter + first block manifests, <slug>.json and index.config.json (the instance config inline in its entry), the builder shim, AGENTS.md with CLAUDE.md and GEMINI.md stubs, .mcp.json, and the beans work plan. Run this in an empty repo before authoring anything. Pass content_type 'paper' for a folio with Lean-backed mathematics, 'document' for prose (policy guidance, standards, reports) with no Lean and no required TeX.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "title": {
            "type": "string",
            "minLength": 1,
            "description": "Document title, e.g. 'Cold Chain Guidance'"
          },
          "authors": {
            "minItems": 1,
            "type": "array",
            "items": {
              "type": "string",
              "minLength": 1
            },
            "description": "Author names. At least one — the manifest's `authors` may not be empty."
          },
          "content_type": {
            "default": "document",
            "description": "'document': structured prose, no Lean, no TeX needed to publish. 'paper': a document PLUS blocks whose assertion is a formal claim, backed by Lean 4 and rendered through LaTeX. Choose 'paper' only if the folio will actually carry machine-checked mathematics — it adds elan and texlive as dependencies.",
            "type": "string",
            "enum": [
              "paper",
              "document"
            ]
          },
          "slug": {
            "description": "Directory name under folio/. Derived from the title when omitted.",
            "type": "string"
          },
          "dir": {
            "default": ".",
            "description": "Folio root to scaffold into, relative to the repo the server was pointed at.",
            "type": "string"
          },
          "link": {
            "default": "submodule",
            "description": "How the folio reaches folio-assistant. 'submodule' pins it at folio-assistant/ inside the folio, so a clone gets the exact platform revision the content was authored against. 'sibling' uses a checkout beside the folio — right when one platform copy serves several folios. 'remote' declares the platform layers as pinned source.remote mounts in index.config.json.",
            "type": "string",
            "enum": [
              "submodule",
              "sibling",
              "remote"
            ]
          },
          "assistant_path": {
            "description": "Override the path to folio-assistant, relative to the folio root.",
            "type": "string"
          },
          "force": {
            "default": false,
            "description": "Overwrite files that already exist. Off by default — this never clobbers an author's AGENTS.md silently.",
            "type": "boolean"
          },
          "dry_run": {
            "default": false,
            "description": "Report what would be written without writing it.",
            "type": "boolean"
          }
        },
        "required": [
          "title",
          "authors"
        ]
      },
      "_meta": {
        "tool": "folio-init",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/folio-init.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "get_graph_stats",
      "description": "Node and edge counts for the content graph by provenance and kind, and whether each root exists. Use it to tell 'nothing matched' from 'that population has not been built yet'.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "refresh": {
            "description": "Rebuild the index from disk first.",
            "type": "boolean"
          }
        }
      },
      "_meta": {
        "tool": "get-graph-stats",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/get-graph-stats.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "get_neighbors",
      "description": "Walk the content graph from one node. direction 'out' answers 'what must a reader have read first?'; 'in' answers 'what breaks if this changes?'. Accepts an @id or an authored label such as 'thm:main'. An unknown edge term is reported, never silently dropped.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "minLength": 1,
            "description": "Node @id or authored label."
          },
          "direction": {
            "description": "Default out.",
            "type": "string",
            "enum": [
              "out",
              "in",
              "both"
            ]
          },
          "hops": {
            "description": "Traversal depth (default 1).",
            "type": "integer",
            "minimum": 1,
            "maximum": 6
          },
          "edges": {
            "description": "Restrict to these edge terms (uses, interprets, cites, contains, …). Omit for all.",
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        },
        "required": [
          "id"
        ]
      },
      "_meta": {
        "tool": "get-neighbors",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/get-neighbors.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "lsi_query",
      "description": "Latent Semantic Indexing over a declared prose graph (a library, the skills, the beans, docs): find units that discuss the query in OTHER words. Run the lexical search first; this is the supplement for the vocabulary gap. Each hit is marked `lexical+latent` or `latent only`. The score is a cosine in the latent space, not a relevance rank, and it is a proposal — it never establishes that a unit is relevant, correct, or a dependency.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string",
            "minLength": 1,
            "description": "The query, in any words."
          },
          "instance": {
            "description": "Instance declaring the graph, e.g. `cat-harness`. Omit for all.",
            "type": "string"
          },
          "graph": {
            "description": "Graph id within the instance, e.g. `library`, `skills`. Omit for all.",
            "type": "string"
          },
          "top": {
            "default": 10,
            "description": "Hits per graph.",
            "type": "integer",
            "minimum": 1,
            "maximum": 50
          }
        },
        "required": [
          "text"
        ]
      },
      "_meta": {
        "tool": "lsi-query",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/lsi-query.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "memory_checkpoint",
      "description": "Before you stop or hand over, keep where the work stands: what is done, what is next, and anything the next person must know to carry on.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "note": {
            "type": "string",
            "description": "Where the work stands, in plain words."
          },
          "shared": {
            "description": "true: the memory you share with the other agents working with you. Default: your own memory of this work.",
            "type": "boolean"
          }
        },
        "required": [
          "note"
        ]
      },
      "_meta": {
        "tool": "memory-checkpoint",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/memory-checkpoint.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "memory_note",
      "description": "Keep a short note on the work you are doing — what you did, what you decided and why, and what is left open — so it is there when this work is picked up again, by you or by someone else.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "note": {
            "type": "string",
            "description": "The note, in plain words. One paragraph is plenty."
          },
          "shared": {
            "description": "true: the memory you share with the other agents working with you. Default: your own memory of this work.",
            "type": "boolean"
          }
        },
        "required": [
          "note"
        ]
      },
      "_meta": {
        "tool": "memory-note",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/memory-note.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "memory_recall",
      "description": "Read what has been kept about this work so far, oldest first, so you can start where the last person stopped.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "shared": {
            "description": "true: the memory you share with the other agents working with you. Default: your own memory of this work.",
            "type": "boolean"
          }
        }
      },
      "_meta": {
        "tool": "memory-recall",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/memory-recall.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "readme_audit",
      "description": "Verify every Markdown link in the folio's README (or another file) still resolves: relative paths against the working tree, links naming one of the repo's own refs against a real listing of that ref, and GitHub Pages URLs against the publish ref the site is served from. External URLs, in-page anchors, and refs this checkout cannot read are reported as NOT CHECKED rather than dead. Read-only — it never edits the file.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "file": {
            "description": "Markdown file to audit. Defaults to the folio's README.md.",
            "type": "string"
          },
          "fetch": {
            "default": false,
            "description": "Fetch a repo ref that is missing locally, so its links can be checked instead of counted as unchecked. Needed in a shallow clone.",
            "type": "boolean"
          },
          "dir": {
            "description": "Folio root. Defaults to the repo the server was pointed at.",
            "type": "string"
          }
        }
      },
      "_meta": {
        "tool": "readme-audit",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/readme-audit.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "readme_sync",
      "description": "Refresh the generated sections of the folio's README. Each section is written ONLY where the README already carries its marker pair (`<!-- folio:toc:begin -->` … `<!-- folio:toc:end -->`), so nothing outside a marked region is ever touched and a folio opts in per section. Available: folio:toc, cat-harness:cold-start, skills:index, cat-harness:instances, folio:lean-coverage, folio:lean-modules, folio:simulators, folio:workflows, kg:processes, kg:files, kg:roles, readme:toc. The contents table lists every paper in the folio and verifies each PDF link against the publish ref, so an unpublished chapter renders an em dash instead of a dead link.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "check": {
            "default": false,
            "description": "Report whether any section is stale without writing. Fails when one is.",
            "type": "boolean"
          },
          "only": {
            "description": "Refresh just these sections. Omit for every marker the README carries.",
            "type": "array",
            "items": {
              "type": "string",
              "enum": [
                "folio:toc",
                "cat-harness:cold-start",
                "skills:index",
                "cat-harness:instances",
                "folio:lean-coverage",
                "folio:lean-modules",
                "folio:simulators",
                "folio:workflows",
                "kg:processes",
                "kg:files",
                "kg:roles",
                "readme:toc"
              ]
            }
          },
          "link_style": {
            "description": "Override `<name>.config.json`'s `readme.linkStyle`. 'blob' (github.com/<owner>/<repo>/blob/<ref>/<path>) is the only one that resolves for a PRIVATE repository — GitHub Pages needs a public site, and raw.githubusercontent.com 404s without a token.",
            "type": "string",
            "enum": [
              "blob",
              "pages",
              "raw"
            ]
          },
          "fetch": {
            "default": false,
            "description": "Fetch the publish ref first. Needed in a shallow clone, which has no gh-pages and would otherwise render every PDF cell as an em dash.",
            "type": "boolean"
          },
          "dir": {
            "description": "Folio root. Defaults to the repo the server was pointed at.",
            "type": "string"
          }
        }
      },
      "_meta": {
        "tool": "readme-sync",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/readme-sync.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "render_order",
      "description": "Flatten this repository's renders into the order their `needs` imply, and run them unless `dry_run`. Stage 1 — the current declared state as json/jsonld, then the README derived from it — is FATAL: a graph that does not render is an unknown build, not a degraded one, and a README generated from a half-read graph states a wrong fact in the file a reader opens first. The dynamic renderers skip and log instead, and a failure skips what NEEDED it rather than what merely follows it. A cycle or a missing dependency yields no order at all.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "dry_run": {
            "default": false,
            "description": "Print the order and each step's failure policy; run nothing.",
            "type": "boolean"
          }
        }
      },
      "_meta": {
        "tool": "render-order",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/render-order.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "search_graph",
      "description": "Lexical search over the JSON-LD content graph, across authored blocks and ingested library documents. No graph expansion; corpus_search composes this with a neighbour walk.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string",
            "minLength": 1,
            "description": "Substring to look for."
          },
          "provenance": {
            "description": "Restrict to one population. Omit to search both.",
            "type": "string",
            "enum": [
              "authored",
              "ingested"
            ]
          },
          "searchText": {
            "description": "Also scan companion Markdown bodies, not just metadata. Slower.",
            "type": "boolean"
          },
          "limit": {
            "description": "Max hits (default 20).",
            "type": "integer",
            "minimum": 1,
            "maximum": 9007199254740991
          }
        },
        "required": [
          "query"
        ]
      },
      "_meta": {
        "tool": "search-graph",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/search-graph.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "skill_fetch",
      "description": "Fetch a skill's instruction body for the agent to follow. Serves the local platform bundles (package_name 'folio-assistant' = agent skills, 'content-lifecycle' = the plan/author/validate/review/test/publish/feedback skills every BPMN content process names, 'folio-core' = content-agnostic platform skills, 'folio-document-adapter' = prose-folio skills (no Lean, no required TeX), 'folio-paper-adapter' = formal-math paper skills) and external reference packages (Tier 2 escalation: academic-paper-reviewer, deep-research, academic-pipeline).",
      "inputSchema": {
        "type": "object",
        "properties": {
          "skill": {
            "type": "string",
            "description": "Skill identifier. Examples: 'lean-generation' (package_name 'folio-paper-adapter'), 'bean-coordination' (package_name 'sdlc-core'), 'corpus-grep' (package_name 'kg-core'), 'content-validate' (package_name 'content-lifecycle'), 'l3-fhir-authoring' (package_name 'authoring-who-smart-guidelines'), 'academic-paper-reviewer' (package_name 'academic-research-skills')"
          },
          "package_name": {
            "default": "folio-core",
            "description": "Package name. Local: 'authoring-core' | 'bootstrap' | 'catalogue' | 'cataloguing' | 'conduct-core' | 'content-lifecycle' | 'content-lifecycle-ext' | 'crdm' | 'folio-assistant-core' | 'folio-core' | 'folio-document-adapter' | 'graph-management' | 'ingestion' | 'kg-core' | 'kg-navigation' | 'large-datasets' | 'library-core' | 'platform-ui' | 'process-core' | 'raci' | 'requirements-planning' | 'review' | 'sdlc-core' | 'security' | 'spec-kit' | 'theming' | 'ui-core' | 'who-iris' | 'work-plan' | 'workflow'. Reference: 'academic-research-skills'.",
            "type": "string"
          }
        },
        "required": [
          "skill"
        ]
      },
      "_meta": {
        "tool": "skill-fetch",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/skill-fetch.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "skill_list",
      "description": "List available skills WITH their one-line summaries — the local platform bundles (folio-assistant, content-lifecycle, folio-core, folio-document-adapter, folio-paper-adapter, authoring-who-smart-guidelines, authoring-math) and external reference packages — each fetchable via skill_fetch. Call this before improvising a procedure: the summary is what lets you pick the right skill without fetching several.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "_meta": {
        "tool": "skill-list",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/skill-list.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "skill_update",
      "description": "Edit an existing local skill through a governed gate instead of a raw file write (folio-assistant#875). Every gate must pass: the skill resolves as skill_fetch serves it, it is tracked in this repository (not another layer's or a mounted copy), it is not generated, a policy grants `skill-update` to the actor, the file is unchanged since it was read (base_sha256), the front matter parses and keeps its name, and every link the edit adds resolves. A gate that cannot decide refuses. Writes the working tree only; commit it yourself.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "skill": {
            "type": "string",
            "description": "Skill id, as skill_fetch takes it."
          },
          "package_name": {
            "default": "folio-core",
            "description": "Package, as skill_fetch takes it.",
            "type": "string"
          },
          "new_content": {
            "type": "string",
            "minLength": 1,
            "description": "The whole new file: front matter and body."
          },
          "base_sha256": {
            "type": "string",
            "pattern": "^[0-9a-fA-F]{64}$",
            "description": "SHA-256 hex of the file as you read it."
          },
          "reason": {
            "type": "string",
            "minLength": 1,
            "maxLength": 400,
            "description": "Why the skill changes, in one line."
          },
          "actor": {
            "description": "The declared actor making the write.",
            "type": "string"
          },
          "process": {
            "description": "The BPMN process this write is a step of, for the PROV-O activity.",
            "type": "string"
          },
          "task": {
            "description": "The task id in that process.",
            "type": "string"
          },
          "role": {
            "description": "The role the lane binds.",
            "type": "string"
          }
        },
        "required": [
          "skill",
          "new_content",
          "base_sha256",
          "reason"
        ]
      },
      "_meta": {
        "tool": "skill-update",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/skill-update.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "stakeholder_map",
      "description": "Given the paths a proposed change touches, report which skills change, which roles those skills declare, and which BPMN process lanes — i.e. which accountable actors — reach work that uses them. Use in CRDM phase 1 to sharpen the stakeholder question before putting it to the BA. It deliberately does NOT name people: the process says the agent does not guess who is affected, and this respects that.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "paths": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Repo-relative paths the change touches, as `git diff --name-only` prints them."
          }
        },
        "required": [
          "paths"
        ]
      },
      "_meta": {
        "tool": "stakeholder-map",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/stakeholder-map.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "translation_extract",
      "description": "Extract translatable strings from a markdown file or directory into a GNU gettext .pot template. Segments prose by paragraph, strips inline formatting, skips code blocks and front matter. Output goes to translations/<locale>/<name>.pot. Uses the same extraction state machine as the WHO DAK base IG's extract_translations.py.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "path": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._][A-Za-z0-9._/-]*$",
            "description": "Path to a .md file or directory of .md files (relative to repo root). E.g. 'docs/guides/agent-onboarding.md' or 'folio/paper/chapters/ch1/'"
          },
          "locale": {
            "default": "en",
            "description": "Source locale (BCP 47 tag). Default: 'en'.",
            "type": "string",
            "minLength": 2,
            "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$"
          },
          "project_name": {
            "description": "Project name for the POT header. Default: 'folio'.",
            "type": "string"
          }
        },
        "required": [
          "path"
        ]
      },
      "_meta": {
        "tool": "translation-extract",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/translation-extract.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "translation_inject",
      "description": "Inject translations from a .po file into the source markdown, producing a translated copy. Uses the same state machine as extraction to identify translatable spans, looks up each span's msgid in the PO translations, and substitutes the msgstr. Fuzzy entries are skipped. Output goes to translations/<locale>/<filename>.md.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "source": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._][A-Za-z0-9._/-]*$",
            "description": "Path to the source .md file (relative to repo root)."
          },
          "po_file": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._][A-Za-z0-9._/-]*$",
            "description": "Path to the .po file with translations (relative to repo root)."
          },
          "locale": {
            "type": "string",
            "minLength": 2,
            "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
            "description": "Target locale (BCP 47 tag, e.g. 'fr', 'ar', 'zh')."
          }
        },
        "required": [
          "source",
          "po_file",
          "locale"
        ]
      },
      "_meta": {
        "tool": "translation-inject",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/translation-inject.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "translation_signoff",
      "description": "Sign off a translation as official. Records who signed off, when, and the SHA-256 hash of the source .md for staleness detection. Updates translations/<locale>/status.json. Use after SME review confirms accuracy.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "locale": {
            "type": "string",
            "minLength": 2,
            "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
            "description": "Target locale being signed off (e.g. 'fr')."
          },
          "source": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._][A-Za-z0-9._/-]*$",
            "description": "Path to the source .md file (for hash computation)."
          },
          "signed_off_by": {
            "type": "string",
            "description": "Identity of the reviewer signing off."
          },
          "level": {
            "default": "chapter",
            "description": "Granularity of the sign-off.",
            "type": "string",
            "enum": [
              "block",
              "section",
              "chapter",
              "folio"
            ]
          }
        },
        "required": [
          "locale",
          "source",
          "signed_off_by"
        ]
      },
      "_meta": {
        "tool": "translation-signoff",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/translation-signoff.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "translation_status",
      "description": "Report translation coverage for a given locale. Scans the translations/ directory for .po files and computes per-file and aggregate statistics: total strings, translated, untranslated, fuzzy. Also reports whether translations are official (signed off) or unofficial.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "locale": {
            "description": "Locale to report on (e.g. 'fr'). Omit to report all available locales.",
            "type": "string",
            "minLength": 2,
            "pattern": "^[a-z]{2,3}(-[A-Za-z0-9]{2,8})*$"
          }
        }
      },
      "_meta": {
        "tool": "translation-status",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/translation-status.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "translation_validate",
      "description": "Validate a translated .po file against its source .pot. Checks: (1) all msgids from the POT have a corresponding PO entry, (2) no orphaned placeholder tokens in translations, (3) structural consistency (paragraph count), (4) staleness — whether the source .md has changed since the PO was generated. Bean ktt2 tracks the round-trip QA extension of this tool.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "pot_file": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._][A-Za-z0-9._/-]*$",
            "description": "Path to the .pot template file."
          },
          "po_file": {
            "type": "string",
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._][A-Za-z0-9._/-]*$",
            "description": "Path to the .po translation file."
          },
          "source": {
            "description": "Path to the source .md file for staleness check. If omitted, only PO/POT consistency is checked.",
            "type": "string",
            "minLength": 1,
            "pattern": "^[A-Za-z0-9._][A-Za-z0-9._/-]*$"
          }
        },
        "required": [
          "pot_file",
          "po_file"
        ]
      },
      "_meta": {
        "tool": "translation-validate",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/translation-validate.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "work_plan_prime",
      "description": "Prime yourself with the current beans work-plan (session + cross-session/cross-agent todos). Runs `beans prime` + `beans list`; if the beans CLI is not installed, falls back to reading the committed beans/ store directly. Use at the start of a task to see open items and claim before working.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "_meta": {
        "tool": "work-plan-prime",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/work-plan-prime.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_complete",
      "description": "Record that an enabled step is done, or answer a decision, and advance the process. Refuses a step that is not currently enabled — that refusal is the point: it is what keeps work from being claimed out of order. A step inside a subprocess is named by its own id, exactly as workflow_next reported it; the call activity itself is not completable, because a phase is done when its steps are.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instance": {
            "type": "string"
          },
          "node": {
            "type": "string",
            "description": "Node id from workflow_next, e.g. `Task_DraftEdit`"
          },
          "outcome": {
            "description": "For a decision a person makes — one of the outcomes workflow_next listed",
            "type": "string"
          },
          "facts": {
            "description": "For a decision workflow_next reported as `computed by <table>`: the values it reads, e.g. { failCritical: 0, failMajor: 2 } from qa_sweep totals. The table returns the branch — do not pass `outcome` for these.",
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          },
          "actor": {
            "description": "Who you say did it, written to the history. Authorization is decided on the principal GitHub vouches for (owner or collaborator), in strict mode, before the step is recorded",
            "type": "string"
          },
          "target": {
            "description": "The content the step acted on: a block id, path or bean id",
            "type": "string"
          },
          "note": {
            "description": "What happened, for the instance history",
            "type": "string"
          },
          "activities": {
            "description": "PROV-O activities a Tool returned while doing this step, verbatim (e.g. skill_update's `activity`). Kept on the step's history entry; each must name this step as its plan",
            "type": "array",
            "items": {}
          }
        },
        "required": [
          "instance",
          "node"
        ]
      },
      "_meta": {
        "tool": "workflow-complete",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/workflow-complete.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_complete",
      "description": "Record that an enabled step is done, or answer a decision, and advance the process. Refuses a step that is not currently enabled — that refusal is the point: it is what keeps work from being claimed out of order. A step inside a subprocess is named by its own id, exactly as workflow_next reported it; the call activity itself is not completable, because a phase is done when its steps are.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instance": {
            "type": "string"
          },
          "node": {
            "type": "string",
            "description": "Node id from workflow_next, e.g. `Task_DraftEdit`"
          },
          "outcome": {
            "description": "For a decision a person makes — one of the outcomes workflow_next listed",
            "type": "string"
          },
          "facts": {
            "description": "For a decision workflow_next reported as `computed by <table>`: the values it reads, e.g. { failCritical: 0, failMajor: 2 } from qa_sweep totals. The table returns the branch — do not pass `outcome` for these.",
            "type": "object",
            "propertyNames": {
              "type": "string"
            },
            "additionalProperties": {}
          },
          "actor": {
            "description": "Who you say did it, written to the history. Authorization is decided on the principal GitHub vouches for (owner or collaborator), in strict mode, before the step is recorded",
            "type": "string"
          },
          "target": {
            "description": "The content the step acted on: a block id, path or bean id",
            "type": "string"
          },
          "note": {
            "description": "What happened, for the instance history",
            "type": "string"
          },
          "activities": {
            "description": "PROV-O activities a Tool returned while doing this step, verbatim (e.g. skill_update's `activity`). Kept on the step's history entry; each must name this step as its plan",
            "type": "array",
            "items": {}
          }
        },
        "required": [
          "instance",
          "node"
        ]
      },
      "_meta": {
        "tool": "bpmn-engine",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness-tools/tools/bpmn-engine.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_gate",
      "description": "May a step be performed right now? Ask before doing work a strict process governs. The content-agnostic processes (editing, publication, lifecycle) enforce: a step that is not enabled is refused unless a content package declares a relaxation for it in skills/<package>/workflow-policy.json. The per-content-type processes are advisory and always allow.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instance": {
            "type": "string"
          },
          "activity": {
            "type": "string",
            "description": "Node id, e.g. `Task_Commit`"
          },
          "actor": {
            "description": "Who you say would perform it. Recorded only: strict mode authorizes the principal GitHub vouches for",
            "type": "string"
          },
          "target": {
            "description": "The content it would act on: a block id, path or bean id",
            "type": "string"
          }
        },
        "required": [
          "instance",
          "activity"
        ]
      },
      "_meta": {
        "tool": "workflow-gate",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/workflow-gate.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_gate",
      "description": "May a step be performed right now? Ask before doing work a strict process governs. The content-agnostic processes (editing, publication, lifecycle) enforce: a step that is not enabled is refused unless a content package declares a relaxation for it in skills/<package>/workflow-policy.json. The per-content-type processes are advisory and always allow.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instance": {
            "type": "string"
          },
          "activity": {
            "type": "string",
            "description": "Node id, e.g. `Task_Commit`"
          },
          "actor": {
            "description": "Who you say would perform it. Recorded only: strict mode authorizes the principal GitHub vouches for",
            "type": "string"
          },
          "target": {
            "description": "The content it would act on: a block id, path or bean id",
            "type": "string"
          }
        },
        "required": [
          "instance",
          "activity"
        ]
      },
      "_meta": {
        "tool": "bpmn-engine",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness-tools/tools/bpmn-engine.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_list",
      "description": "List the BPMN processes this folio defines, across every directory it declares as holding its knowledge graph, and any instances currently open. Use before workflow_start to see what exists.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "_meta": {
        "tool": "workflow-list",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/workflow-list.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_list",
      "description": "List the BPMN processes this folio defines, across every directory it declares as holding its knowledge graph, and any instances currently open. Use before workflow_start to see what exists.",
      "inputSchema": {
        "type": "object",
        "properties": {}
      },
      "_meta": {
        "tool": "bpmn-engine",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness-tools/tools/bpmn-engine.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_next",
      "description": "What is enabled RIGHT NOW in an instance — the activities that may be worked, with the lane (role) that performs each and the skill that implements it, plus any decision waiting on an outcome. Derived from the diagram: a step not listed here has not been reached yet. A call activity is entered automatically, so what is reported is the leaf step, with the phases it sits inside shown as `inside:`.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instance": {
            "type": "string",
            "description": "Instance id, from workflow_start or workflow_list"
          }
        },
        "required": [
          "instance"
        ]
      },
      "_meta": {
        "tool": "workflow-next",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/workflow-next.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_next",
      "description": "What is enabled RIGHT NOW in an instance — the activities that may be worked, with the lane (role) that performs each and the skill that implements it, plus any decision waiting on an outcome. Derived from the diagram: a step not listed here has not been reached yet. A call activity is entered automatically, so what is reported is the leaf step, with the phases it sits inside shown as `inside:`.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "instance": {
            "type": "string",
            "description": "Instance id, from workflow_start or workflow_list"
          }
        },
        "required": [
          "instance"
        ]
      },
      "_meta": {
        "tool": "bpmn-engine",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness-tools/tools/bpmn-engine.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_start",
      "description": "Begin a process instance for a subject (a block label, a release, a bean id). Idempotent: an instance already open for the same process and subject is returned rather than duplicated. Returns what is enabled first.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "process": {
            "type": "string",
            "description": "File stem, e.g. `editing-hci-validation`, or the bpmn:process id"
          },
          "subject": {
            "type": "string",
            "description": "What this run is about — a block label, a release name"
          },
          "bean": {
            "description": "Bean id this work is tracked under",
            "type": "string"
          },
          "plan": {
            "description": "Work plan this run is part of: the id of an epic or milestone whose `process:` tag names this process. Optional; not every process needs a plan",
            "type": "string"
          }
        },
        "required": [
          "process",
          "subject"
        ]
      },
      "_meta": {
        "tool": "workflow-start",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness/tools/workflow-start.jsonld",
        "source": "registrar"
      }
    },
    {
      "name": "workflow_start",
      "description": "Begin a process instance for a subject (a block label, a release, a bean id). Idempotent: an instance already open for the same process and subject is returned rather than duplicated. Returns what is enabled first.",
      "inputSchema": {
        "type": "object",
        "properties": {
          "process": {
            "type": "string",
            "description": "File stem, e.g. `editing-hci-validation`, or the bpmn:process id"
          },
          "subject": {
            "type": "string",
            "description": "What this run is about — a block label, a release name"
          },
          "bean": {
            "description": "Bean id this work is tracked under",
            "type": "string"
          },
          "plan": {
            "description": "Work plan this run is part of: the id of an epic or milestone whose `process:` tag names this process. Optional; not every process needs a plan",
            "type": "string"
          }
        },
        "required": [
          "process",
          "subject"
        ]
      },
      "_meta": {
        "tool": "bpmn-engine",
        "toolIri": "https://litlfred.github.io/folio-assistant/cat-harness-tools/tools/bpmn-engine.jsonld",
        "source": "registrar"
      }
    }
  ]
}
