docs(rfc): define the production command composition kit - #1389
Conversation
|
[PHASE: RESEARCH] Harness bootstrap is live on draft PR #1389 at commit Scope
Evidence
DriftThe read-only agentic runtime status probe returned NextRe-baseline the carried proposal against current public APIs, implementations, tests, generated surfaces, live dependencies, and primary adapter/runtime documentation. |
|
[PHASE: PLAN] Plan locked at commit Evidence completed:
Locked direction: conformant one-store/same-commit command store only; service/database/contracts/telemetry focused subpaths; consumer-owned generated rows; RFC-8785 + SHA-256 fingerprints; explicit replay codecs; repository CAS; no hidden callback retries; no external I/O in the transaction; at-least-once outbox relay with stable message identity; KV refused in v1 and SQLite unclaimed until conformance. Formal PLAN-EVAL/IMPL-EVAL has not been triggered. Per the owner brief, the root orchestrator will steer the existing Fable review only after the complete RFC and final handoff. |
|
[PHASE: IMPL] The complete RFC draft is now on the branch in commit Slices landed
Evidence
Next
|
|
PLAN-EVAL HANDOFF — EXTERNAL VERDICT PENDING The generator handoff is complete at branch HEAD
Next owner: the root orchestrator resumes the existing Claude Fable 5 session with the quoted handoff, then owns any remediation and the independent Qwen adversarial pass. This comment deliberately carries no evaluator phase token or verdict. |
Cross-family evaluator (Fable 5 high, owner-designated). Findings F-B1..F-B7; core transaction/receipt/relay laws verified honest. Deep-dive delegation recorded (wf_b3416478-edf, Opus 5 xhigh). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
[PHASE: PLAN-EVAL] [VERDICT: CHANGES_REQUESTED] FAIL_PLAN, cycle 1 of 2. Evaluator of record: Claude Fable 5 · high (owner-designated cross-family PLAN-EVAL; generator was Codex). Full verdict: The core promise is verified honest and internally consistent — one store transaction with an explicit Findings
FCP adjudication: Q1/Q3/Q4 safe to defer; Q2 safe once F-B7(f) folds in. F-B1–F-B3 are missing from FCP and must be resolved in text or added as fully-specified FCP questions before FCP closes. Next
|
|
[PHASE: PLAN] [CYCLE: 2 REMEDIATION] Authoring remediation for the authoritative cycle-1 Resolved in the RFC and locked harness plan:
The RFC remains |
|
[PHASE: PLAN-EVAL] [CYCLE: 2 READY] [EXTERNAL VERDICT: PENDING] Cycle-1 remediation is complete and this draft is ready for the root orchestrator to resume the existing Fable 5 evaluator session. This is an author handoff, not an approval or evaluator trigger. Exact review target
Required-for-PASS reconciliation
Evidence
PR #1389 remains draft, the RFC remains |
All F-B1..F-B7 verified resolved at c98c08a; per-provider claim table exceeds the asked bar; labels remain honest (docs-only diff). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
|
[PHASE: PLAN-EVAL] [VERDICT: APPROVED] PASS, cycle 2. Same owner-designated Fable 5 evaluator session as cycle 1. Verdict of record: All seven cycle-1 findings verified resolved mechanically:
The four amended FCP questions are policy-only and safe; the three cycle-1 rework-forcing gaps are now resolved design inputs. Labels remain honest (diff = RFC + run artifacts only; changed-file audit confirms no package/lock change). NextLabel moved |
Final Comment Period — disposition: acceptThe independent review sequence is complete:
Authoritative final report: Maintainer disposition of the safe questions
The authenticated envelope path will explicitly depend on #1387's typed-principal/context surface. RFC-B receives 0002 after RFC-A receives FCP windowThis comment opens the repository-required approximately seven-day FCP with disposition accept. Please raise any concrete objection by 2026-08-15 22:00 Europe/Zurich. Unless a blocking objection is substantiated, the maintainer will then assign |
…afts) (#1347) * plan(seed): bootstrap fable5 remediation roadmap seed run Run dir + supervisor identity, owner eval waivers (PLAN-EVAL/IMPL-EVAL), lane overrides (Fable 5 high orchestrator, Opus 5 workflow contributors), drafts-only mutation boundary. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): commit Stage-B corpus workflows before execution Two read-only Opus-subagent research workflows (prior waves + live board; repo/docs domain audit + external comparisons), per seed-run Tier-C rule. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): supervisor distillation of Codex pre-plan package; record Stage-B fan-out Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): land Stage-B corpus slice 1 — prior waves + live board ground truth Seven Opus-5 research artifacts (3.8k lines): waves 1-6 evidence, exhaustive open-board snapshot (259 issues/13 milestones), 0.0.5 orchestration history, live conventions incl. label/milestone/RFC practice. Supervisor-reviewed. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): land Stage-B corpus slice 2 — repo/docs domain audit + external bar Eleven Opus-5 artifacts (5.2k lines): docs/MCP/CLI/web/SDK/auth/runtime/ observability/scaffold-doctrine audits with execution-verified defect verdicts, plus eis-chat teardown, meta-framework competitive bar, oRPC extension-model deep dive. Supervisor-reviewed (see worklog S2b note). Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): Stage-C synthesis — gap taxonomy, adjudications, T1-T8 packs, train direction Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): commit Stage-D design-pack workflow before execution Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): milestone train + Wave-7 adoption proposal (supervisor drafts) Two-milestone insertion via house rename pattern; complete per-issue move ledger; entry/exit criteria; thin Wave-7 A/B/C measured smoke matrix. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): dedup & supersession dispositions for existing issues Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): land Stage-D design packs — 41 issue drafts, RFC-A/RFC-B, amendments Three milestone directories (0.0.6 verification/docs/RFCs; 0.0.7 typed seams+generation; 0.0.8 runtime truth+service slice), 929-line amendments file, dedup table + Stage-E ledger. Supervisor-reviewed; six corpus corrections recorded. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): Stage-E plan lock — master plan, implementation handoff, run close 12-fork owner sweep, program DAG, filing gate + first executable PR groups; plan.md locked, context-pack finalized, session record written. No board mutation occurred in this run. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): ratify Stage-H filing manifest * docs(plan): record ratified roadmap filing * plan(seed): commit PLAN-EVAL deep-dive workflow before execution (evaluator delegation record) Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): record cross-family PLAN-EVAL of RFC-A/#1390 and RFC-B/#1389 Both CHANGES_REQUESTED (cycle 1); cross-RFC composition verdict, amendment map, and v2-migration epic proposal in CROSS-RFC-REVIEW.md. Evaluator-only writes; no board mutation. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): record PLAN-EVAL cycle 2 — both RFCs APPROVED; Qwen handoff brief Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> * plan(seed): record final Qwen RFC acceptance --------- Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
Summary
Drafts the production command composition kit RFC: a narrow, one-store transaction boundary for business state, idempotent replay receipts, audit records, and outbox messages, with explicit adapter refusal and post-commit at-least-once relay semantics.
This is an RFC/docs-only PR. It does not implement or change a package, plugin, schema, scaffold, export, or runtime. Fable PLAN-EVAL cycle 2 and the independent Qwen adversarial evaluation both passed. This PR is now in the formal Final Comment Period and remains draft until that process completes.
Scope
deno task testfails on an empty tree #1362, Epic: Production command composition — transaction, audit, idempotency, outbox, and relay #1363, docs(orchestration-runtime): outbound webhook delivery has no recipe or template — triggers ship inbound ingress only, so every product hand-rolls signing, retry and dead-lettering #1364, [sdk-client S1] fix(sdk): preserve contract errors through safe() and isDefinedError #1350, prisma-adapter-mysql: adapter class is unexported and has no connection-error hook — the honest example needs both #1293, Type soundness ratification: eliminate unsound and arbitrary types across the public surface and the docs #1278.llm/runs/docs-rfc-command-composition-kit--rfc/Slices
ad643e15de0b98f289ad16c42f82dfe8c841,62304176f122301d25c98c08ada6c2043d91Cycle-1 remediation
service → databasedependency.SNAPSHOTis a distinct Stage-6 blocker; SQLite is default-only; generated Prisma transaction typing belongs todb command-store add.The one-store atomicity, same-commit receipt/audit/outbox, at-least-once relay, capability honesty, and refusal laws remain unchanged.
Validation
git diff --check— PASSdeno task docs:links— PASS; 102 docs, 0 broken links, 0 broken anchors, 0 orphansdeno task docs:accuracy— PASSdeno check --no-lock --unstable-kv— PASS; existing warnings onlydeno.lockor product changeHarness handoff
.llm/runs/docs-rfc-command-composition-kit--rfc/final-handoff.mdc98c08adabbd992a557ff7c596deae68b9c9cd626c2043d915ea2afbe7020bbb88d90ea4d0ea16a5status:review; Fable cycle 2 and Qwen final evaluation both passed; formal FCP opened 2026-08-080000/DraftBoard / lifecycle
No issue was created or closed, no RFC number was assigned, no milestone was mutated, and this PR was not readied or merged. The RFC references #1361 without a closing keyword. A queue runtime-DDL reconciliation child is proposed for maintainer filing only after acceptance.