docs(FAFF-328): trial runbook + TrialRecord scaffold for Channel A live-run validation#331
Draft
alechill wants to merge 2 commits into
Draft
Conversation
…at human-launch step Per the FAFF-328 spec's Execution-mode design decision, the launch step is human-initiated by design; this pass prepares the runbook, preflight results, seed-issue draft, and an unfilled TrialRecord scaffold and parks before launch.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Prepares the FAFF-328 live-run trial per its spec's Execution-mode design decision: an
autonomous graft may prepare the runbook and seed materials, but the launch step is
human-initiated by design (the run invocation is itself the authorization). This PR delivers
the prep half only — the trial has not been run.
docs/specs/2026-07-12-FAFF-328-live-run-validation-of-channel-a-corrective-authority-design.md— the spec, committed per the graft prep-gate step (spec-review: approve on Linear FAFF-328).docs/trials/2026-07-12-FAFF-328-live-run-validation-of-channel-a-corrective-authority/runbook.md— preflight results as run from this dev worktree today, the seed-issue draft, launch/observe/teardown/record procedure for the human who runs the trial.docs/trials/2026-07-12-FAFF-328-live-run-validation-of-channel-a-corrective-authority/trial-record.json— the unfilled TrialRecord scaffold (spec section 3 shape) to be filled during the trial's Record step.Preflight findings (this dev worktree, not the trial container)
asserted:false, basis:no-declaration— expected outside a cage launch.faff lights-out --check --jsoncurrently refuses for three reasons, only one of which (corrective-integrity, noFAFF_INTEGRITY_BOUNDARYdeclaration) is the expected "needs a real cage launch" condition. The other two are pre-existing repo dial-coherence gaps unrelated to this trial (slots.spec_reviewis the single-pass default, not adversarial;gates.fallbackisadvisory, notfail-closed) — both would block any L4 lights-out launch today, trial or otherwise. Recorded as discovered scope rather than fixed here (a production config change is outside a docs-only trial-prep ticket).correctiveCLI region +correctsentry rung match the spec's Assumes exactly; no runbook rebind needed.Acceptance Criteria
faff corrective-integrity --json,faff lights-out --check --json,faff corrective/corrective check/corrective authorusage probes,grep SENTRY_INTERVENTIONS— all captured in runbook.md section 0.trial-record.jsonfields mirror the spec'sRECORD TrialRecordblock 1:1.trial-record.jsonis scaffolded, unfilled by design.This is a docs-only PR (the FAFF-278 spike-deliverable shape) — no production code ships, per spec §8 "From tests".
Why parked (not merged/shipped)
Per the FAFF-328 spec §6 "Execution mode — autonomous graft vs human-initiated window?": "Chosen: a human-initiated trial window (the run invocation is the human authorization — the FAFF-278 human-supervised spike precedent) ... an autonomous graft may prepare the runbook and seed but parks at the launch step with cause 'trial window needs human launch' — expected and by design."
FAFF-325 and FAFF-326 (this ticket's blockers) are both shipped and merged (PR #328, PR #329) — confirmed via Linear +
git log/git merge-base. This PR is not blocked on missing dependencies; it is deliberately parked at the launch step per the spec's own design.Test plan
faff gates run --json→{"signal":"pass","discovery":"none"}(docs-only diff)trial-record.json, and land ADR-0039's verdict entry as a follow-up PR.