Scaffold the docs/ba BA docs tree.

Start or resume a BA session (mode: discovery | stabilize | change | ground). For ground mode, pass readScope: the user-supplied paths/globs (relative to projectRoot) the BA may read; it is persisted to the session and bounds what ba_ground can auto-accept.

Analyze current state and return the questions to ask the user. Writes no BA documents (it only updates session state).

Record the user's answers as traceable decisions.

Materialize/update documents from recorded decisions. Every artifact must cite derived_from decisions.

Report open questions, gaps, pending decisions, the open coverage plan, and stability.

Declare or retire agent/user coverage topics (the visible, steerable coverage plan on top of the floor). Declaring is idempotent; retiring stops a topic from gating stability. Returns the current open plan.

Promote every draft BA document (persona/fr/nfr/use-case/story/glossary/tech-surface) to status 'reviewed' in one batch — the clean 'here are your docs' step. Idempotent and repeatable: a second call with nothing in draft is a no-op, and it promotes again after a change loop re-opens work. Only changes status; never touches backing. Returns what was promoted.

For a mid-project change: report blast radius, conflicts, severity, consequences, and change questions for the given target ids. Creates nothing.

Ground flow (ground session only): record code observations the host agent read. Each is { fact_kind, claim, anchors }. Auto-accepts ONLY existence facts the server can re-verify (entity-exists | dependency-present) whose anchors resolve on disk and sit inside the session read scope — recorded as confirmed/code-verified. Everything else (route/middleware/config-key, anything mislabeled, out-of-scope or unresolvable anchors) is recorded as an inferred+open observation that the user must confirm. Idempotent by (anchors+claim).

Get one artifact by id.

List artifacts filtered by type/status/priority/tag.