00 — README First

Macro: DOT_AGENT_API_CONTRACT_DISPATCHER_TRUE_DRYRUN_UI_REGISTRATION Date: 2026-06-04 · Mode: EXECUTION_MODE · Status: PARTIAL (all safe branches LIVE; true DRY_RUN blocked on a missing agent_api endpoint).

What this macro did

Advanced the KG agent_api pilot one full rung up the dry-run ladder: from runner_contract_missing to plan_only_tested, by building the missing plan-only contract layer and a generic dispatcher — without executing any DOT, without faking a dry-run.

LIVE deliverables (additive, reversible, birth-free)

1. dot_agent_api_contract — generic plan-only contract registry (keyed by dot_code; NOT hardcoded to dot-kg).
2. fn_process_agent_api_dispatch(...) — generic, fail-closed dispatcher that validates a contract and can only write SIMULATED_DRY_RUN prepared observations. It cannot execute a DOT and never writes DRY_RUN/REAL_RUN.
3. KG EXPLAIN pilot pair bound: 2 contract rows (DOT_KG_EXPLAIN PLAN_ONLY producer, DOT_KG_EXPLAIN_VERIFY VERIFY_ONLY verifier), endpoint_ref = NULL.
4. 5 v5 read-only views: v_process_discovery_{agent_api_contract_status, runner_contract_status, dryrun_plan_status, candidate_status_v5, birth_readiness_v5}.

The one exact blocker

endpoint_ref is NULL because no agent_api invocation endpoint exists (host grep for an agent_api dispatcher source = empty). PLAN_ONLY/VERIFY_ONLY validation is complete; a true DRY_RUN needs a real no-mutation agent_api endpoint that takes the fixture and returns a verifier-checkable result.

Invariants held

verified_candidates_v3 = only job:cut. 0 DRY_RUN, 0 REAL_RUN observations anywhere. Pilot usage_count/last_executed still NULL. 0 events emitted. births before == after (1,163,392) across the commit.

Read order

01 live state · 02 reusable runner patterns · 03 contract · 04 dispatcher · 05 KG binding · 06 no-execute test · 07 true dry-run blocker · 08 v5/UI · 09 job:cut reg prep · 10 dot:kg owner/event prep · 11 D1/D2 · 12 safety audit · 13 next macro · 14 final summary · 15 checkpoint.

Short SSOT: checkpoint-dot-agent-api-contract-dispatcher-2026-06-04.md.