Ship a planning registry that reads, and let Slack name it

[Shashankss1205]

The gap this closes, demonstrated live today: plan "summarise the docs in this workspace" returned an honest negative (the incident registry has no kind that reads), while a vaguer goal produced a hollow goal_met from three stub nodes. The planner was never the problem — the registry vocabulary was.

grapharc/examples/plan_docs.py — three read-only kinds (survey, read, summarise) whose bodies really read documentation under Path.cwd():

• deterministic operator code — the model plans, node bodies never call a model, so the scripted path produces the same real content the paid path does
• confined: suffix-filtered (.md/.txt/.rst), capped (20 files, 40k chars), skip-listed dirs, and symlinks resolved and checked against the root before a byte is read
• no argument surface: proposals name kinds, bodies take none — the issue-planner: the admission gate authorises a kind, not its arguments #10 gap doesn't open here
• behaviour keys on NodeBuild.kind, not the planner-invented instance name; the loop test proposes docs_survey-of-kind-survey specifically to catch a name-keyed factory (it caught mine)

grapharc/cli/plan.py — the scripted planner's replies now come off the registry module when it exports scripted_planner_replies (incident replies stay the fallback). Without this, the free path against the docs registry was five rounds of unregistered_node and a planning_failed — verified before and after.

Slack gate — plan --registry accepts exactly the two shipped registry modules via a new choice_flags mechanism; every other value (and the flag on run) stays refused, since its general form imports arbitrary code.

From Slack, free, no key needed:

@grapharc plan "summarise the docs in this workspace" --registry grapharc.examples.plan_docs:build_registry --trace docs.jsonl --run-id docs-1

Six new tests (registry confinement incl. symlink escape, kind-keyed factory via the governed loop, CLI scripted-path regression, gate allowlist). Full suite green, ruff clean.

🤖 Generated with Claude Code