aaronrene / knowtation public
docs flow feat/flow-projection-pilot #5 / 18
aaronrene · 1 day ago · Jun 21, 2026 · Diff

docs(flow): freeze execution gate contract (7A-L3a)

Run advancement, automatable orchestration, consent model, SD-6 separation from external-agent grants, import sandbox, and seven-tier test matrix — no impl, gates OFF.

sha256:2f5915feb1e6b18d98844163b41d69e10205ddfcab3efb8dbba909d2b436bf2e sha
sha256:1f885dbfff4d37a90b778092ee8f9cfb63054528eb669897a6806b1e52e4a118 parent
+47 symbols
sha256:db12c25f57f27a237eb2e717e76acf2fe556e48034907306538654a96e36aee3 snapshot
+47
symbols added
0
dead code introduced
Semantic Changes 47 symbols
~ docs/FLOW-EXECUTION-GATE-CONTRACT-7A-L3.md .md 47 symbols added
+ Flow Execution Gate — Canonical Contract (Phase 7A, Step 7A-L3a) section Flow Execution Gate — Canonical Contract (Phase 7A, Step 7A-L3a) L1–467
+ Design decision (recorded as SD-6) section 0. Design decision (recorded as SD-6) L81–101
+ Two sub-gates (independent posture) section 1. Two sub-gates (independent posture) L101–118
+ table section table L103–107
+ Acceptance (7A-L3a) section 10. Acceptance (7A-L3a) L427–444
+ Surfaces (triple-exposed when sub-gate ON — design only in 7A-L3a) section 2. Surfaces (triple-exposed when sub-gate ON — design only in 7A-L3a) L118–262
+ 1 Request — start run (flow_run / POST …/runs) section 2.1 Request — start run (flow_run / POST …/runs) L133–153
+ code[jsonc]@L135 variable variable code[jsonc]@L135 L135–143
+ code[jsonc]@L146 variable variable code[jsonc]@L146 L146–152
+ 2 Request — advance step (manual) section 2.2 Request — advance step (manual) L153–169
+ code[jsonc] variable variable code[jsonc] L155–162
+ 3 Request — record evidence (pointer only) section 2.3 Request — record evidence (pointer only) L169–182
+ code[jsonc] variable variable code[jsonc] L171–179
+ 4 Request — execute automatable step section 2.4 Request — execute automatable step L182–225
+ code[jsonc]@L184 variable variable code[jsonc]@L184 L184–193
+ code[jsonc]@L207 variable variable code[jsonc]@L207 L207–222
+ 5 Request — execution consent mint (prerequisite for automatable) section 2.5 Request — execution consent mint (prerequisite for automatable) L225–247
+ code[jsonc]@L227 variable variable code[jsonc]@L227 L227–235
+ code[jsonc]@L238 variable variable code[jsonc]@L238 L238–244
+ 6 Request — submit to review (durable outcome) section 2.6 Request — submit to review (durable outcome) L247–262
+ code[jsonc] variable variable code[jsonc] L249–255
+ table section table L123–128
+ Canonical records section 3. Canonical records L262–306
+ 5) section 3.1 Run record — knowtation.flow_run/v0 (unchanged from FLOW-V0-SPEC §1.5) L264–281
+ table section table L268–276
+ flow_execution_consent/v0 section 3.2 Execution consent — knowtation.flow_execution_consent/v0 L281–306
+ code[jsonc] variable variable code[jsonc] L283–300
+ Run advancement rules section 4. Run advancement rules L306–337
+ 1 Manual advancement (agent_assisted and manual steps) section 4.1 Manual advancement (agent_assisted and manual steps) L308–316
+ table section table L310–315
+ 2 Automatable execution orchestration (gate ON only) section 4.2 Automatable execution orchestration (gate ON only) L316–337
+ code variable variable code L320–326
+ table section table L327–334
+ Separation from external-agent grants (7A-L2 / SD-5) section 5. Separation from external-agent grants (7A-L2 / SD-5) L337–353
+ table section table L339–347
+ Import sandbox carry-over (extends 7A-L1 §5 + 7A-L2 §6) import section 6. Import sandbox carry-over (extends 7A-L1 §5 + 7A-L2 §6) L353–366
+ table section table L355–363
+ Posture / gating (default off) section 7. Posture / gating (default off) L366–382
+ table section table L368–376
+ Error taxonomy (opaque codes; no scope/id/secret leak) section 8. Error taxonomy (opaque codes; no scope/id/secret leak) L382–408
+ table section table L386–403
+ Seven-tier test matrix (what each tier proves — design only) section 9. Seven-tier test matrix (what each tier proves — design only) L408–427
+ table section table L415–424
+ Handoff notes (for 7A-L3b — Auto) section Handoff notes (for 7A-L3b — Auto) L455–467
+ Non-goals (7A-L3) section Non-goals (7A-L3) L444–455
+ Simple summary section Simple summary L41–63
+ Technical summary section Technical summary L63–81
Older feat(flow): implement external-agent gate (7A-L2b) sha256:1f885dbfff4d37a90b778092ee8f9cfb63054528eb669897a6806b1e52e4a118 All commits Newer feat(flow): execution gate handlers + routes + seven-tier tests … sha256:033b53826c6a19fbf16470fcfb2320825de89cff25ce403f862a4e2593028868

0 comments

No comments yet. Be the first to start the discussion.

To add a comment, use the Muse CLI: muse hub commit comment sha256:2f5915feb1e6b18d98844163b41d69e10205ddfcab3efb8dbba909d2b436bf2e --body "your comment"