@petepetrash/circuit 0.1.0

package/generated/flows/explainer/circuit.work-contract.v0.json

@@ -0,0 +1,1552 @@
+{
+  "schema_version": 0,
+  "contract_ref": {
+    "kind": "work_contract",
+    "ref": "generated/flows/explainer/circuit.work-contract.v0.json",
+    "sha256": "5e16791856a2fdee57f0b475398a42932c049e42116fa4d8669f2a1af749d394",
+    "flow_id": "explainer"
+  },
+  "work_contract": {
+    "flow": {
+      "id": "explainer",
+      "version": "0.1.0",
+      "purpose": "Explainer flow: turn a research paper into an interactive web explainer. Frame the subject, build a lossless digest, ideate persona-lensed concepts, run a six-criteria tournament, harden the survivors against teaching the wrong driver, take an operator pick, write a house-style spec, run a child build, verify the site, take an operator fidelity sign-off, and close honestly.",
+      "axes": {
+        "allowed_depths": ["low", "medium", "high"],
+        "supports_tournament": true,
+        "supports_autonomous": true,
+        "default": {
+          "depth": "medium",
+          "tournament": false,
+          "tournament_n": 3,
+          "autonomous": false
+        },
+        "tournament_fan_out_stage": "plan-stage"
+      },
+      "starts_at": "intake-step"
+    },
+    "topology": {
+      "stages": [
+        {
+          "id": "frame-stage",
+          "title": "Frame",
+          "canonical": "frame",
+          "steps": ["intake-step"]
+        },
+        {
+          "id": "analyze-stage",
+          "title": "Digest",
+          "canonical": "analyze",
+          "steps": ["digest-step"]
+        },
+        {
+          "id": "plan-stage",
+          "title": "Ideate & Choose",
+          "canonical": "plan",
+          "steps": [
+            "ideas-step",
+            "tournament-step",
+            "hardening-step",
+            "pick-checkpoint-step",
+            "spec-step",
+            "build-gate-step"
+          ]
+        },
+        {
+          "id": "act-stage",
+          "title": "Build",
+          "canonical": "act",
+          "steps": ["build-step", "retry-gate-step"]
+        },
+        {
+          "id": "verify-stage",
+          "title": "Verify",
+          "canonical": "verify",
+          "steps": ["verify-step"]
+        },
+        {
+          "id": "review-stage",
+          "title": "Sign Off",
+          "canonical": "review",
+          "steps": ["signoff-checkpoint-step"]
+        },
+        {
+          "id": "close-stage",
+          "title": "Close",
+          "canonical": "close",
+          "steps": ["close-step"]
+        }
+      ],
+      "stage_path_policy": {
+        "mode": "strict"
+      },
+      "routes": [
+        {
+          "step_id": "intake-step",
+          "route_id": "continue",
+          "target": "digest-step"
+        },
+        {
+          "step_id": "intake-step",
+          "route_id": "pass",
+          "target": "digest-step"
+        },
+        {
+          "step_id": "intake-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "digest-step",
+          "route_id": "continue",
+          "target": "ideas-step"
+        },
+        {
+          "step_id": "digest-step",
+          "route_id": "pass",
+          "target": "ideas-step"
+        },
+        {
+          "step_id": "digest-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "ideas-step",
+          "route_id": "continue",
+          "target": "tournament-step"
+        },
+        {
+          "step_id": "ideas-step",
+          "route_id": "pass",
+          "target": "tournament-step"
+        },
+        {
+          "step_id": "ideas-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "tournament-step",
+          "route_id": "continue",
+          "target": "hardening-step"
+        },
+        {
+          "step_id": "tournament-step",
+          "route_id": "pass",
+          "target": "hardening-step"
+        },
+        {
+          "step_id": "tournament-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "hardening-step",
+          "route_id": "continue",
+          "target": "pick-checkpoint-step"
+        },
+        {
+          "step_id": "hardening-step",
+          "route_id": "pass",
+          "target": "pick-checkpoint-step"
+        },
+        {
+          "step_id": "hardening-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "pick-checkpoint-step",
+          "route_id": "continue",
+          "target": "spec-step"
+        },
+        {
+          "step_id": "pick-checkpoint-step",
+          "route_id": "pass",
+          "target": "spec-step"
+        },
+        {
+          "step_id": "pick-checkpoint-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "spec-step",
+          "route_id": "continue",
+          "target": "build-gate-step"
+        },
+        {
+          "step_id": "spec-step",
+          "route_id": "pass",
+          "target": "build-gate-step"
+        },
+        {
+          "step_id": "spec-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "build-gate-step",
+          "route_id": "continue",
+          "target": "build-step"
+        },
+        {
+          "step_id": "build-gate-step",
+          "route_id": "pass",
+          "target": "build-step"
+        },
+        {
+          "step_id": "build-gate-step",
+          "route_id": "revise",
+          "target": "spec-step"
+        },
+        {
+          "step_id": "build-gate-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "build-step",
+          "route_id": "continue",
+          "target": "verify-step"
+        },
+        {
+          "step_id": "build-step",
+          "route_id": "pass",
+          "target": "verify-step"
+        },
+        {
+          "step_id": "build-step",
+          "route_id": "stop",
+          "target": "retry-gate-step"
+        },
+        {
+          "step_id": "retry-gate-step",
+          "route_id": "continue",
+          "target": "build-step"
+        },
+        {
+          "step_id": "retry-gate-step",
+          "route_id": "pass",
+          "target": "build-step"
+        },
+        {
+          "step_id": "retry-gate-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "verify-step",
+          "route_id": "continue",
+          "target": "signoff-checkpoint-step"
+        },
+        {
+          "step_id": "verify-step",
+          "route_id": "pass",
+          "target": "signoff-checkpoint-step"
+        },
+        {
+          "step_id": "verify-step",
+          "route_id": "retry",
+          "target": "verify-step"
+        },
+        {
+          "step_id": "verify-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "signoff-checkpoint-step",
+          "route_id": "continue",
+          "target": "close-step"
+        },
+        {
+          "step_id": "signoff-checkpoint-step",
+          "route_id": "pass",
+          "target": "close-step"
+        },
+        {
+          "step_id": "signoff-checkpoint-step",
+          "route_id": "blocked",
+          "target": "close-step"
+        },
+        {
+          "step_id": "signoff-checkpoint-step",
+          "route_id": "handoff",
+          "target": "@handoff"
+        },
+        {
+          "step_id": "signoff-checkpoint-step",
+          "route_id": "stop",
+          "target": "@stop"
+        },
+        {
+          "step_id": "close-step",
+          "route_id": "complete",
+          "target": "@complete"
+        },
+        {
+          "step_id": "close-step",
+          "route_id": "pass",
+          "target": "@complete"
+        },
+        {
+          "step_id": "close-step",
+          "route_id": "stop",
+          "target": "@stop"
+        }
+      ]
+    },
+    "blocks": [
+      {
+        "step_id": "intake-step",
+        "title": "Frame — produce explainer.intake",
+        "kind": "compose",
+        "executor": "orchestrator",
+        "protocol": "explainer-intake@v1",
+        "reads": [],
+        "writes": {
+          "report": {
+            "path": "reports/intake.json",
+            "schema": "explainer.intake@v1"
+          }
+        },
+        "check": {
+          "kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          },
+          "required": ["subject", "success_condition"]
+        },
+        "routes": {
+          "continue": "digest-step",
+          "pass": "digest-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "digest-step",
+        "title": "Digest — produce the lossless outline",
+        "kind": "compose",
+        "executor": "orchestrator",
+        "protocol": "explainer-digest@v1",
+        "reads": ["reports/intake.json"],
+        "writes": {
+          "report": {
+            "path": "reports/digest.json",
+            "schema": "explainer.digest@v1"
+          }
+        },
+        "check": {
+          "kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          },
+          "required": ["lossless_principle", "outline_sections"]
+        },
+        "routes": {
+          "continue": "ideas-step",
+          "pass": "ideas-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "ideas-step",
+        "title": "Ideate — draft persona-lensed concepts",
+        "kind": "compose",
+        "executor": "orchestrator",
+        "protocol": "explainer-ideas@v1",
+        "reads": ["reports/intake.json", "reports/digest.json"],
+        "writes": {
+          "report": {
+            "path": "reports/ideas.json",
+            "schema": "explainer.ideas@v1"
+          }
+        },
+        "check": {
+          "kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          },
+          "required": ["brief_question", "concepts"]
+        },
+        "routes": {
+          "continue": "tournament-step",
+          "pass": "tournament-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "tournament-step",
+        "title": "Tournament — fan out one advocate per concept",
+        "kind": "fanout",
+        "executor": "orchestrator",
+        "protocol": "explainer-tournament@v1",
+        "reads": ["reports/intake.json", "reports/ideas.json"],
+        "writes": {
+          "branches_dir": "reports/tournament-branches",
+          "aggregate": {
+            "path": "reports/tournament-aggregate.json",
+            "schema": "explainer.tournament-aggregate@v1"
+          }
+        },
+        "check": {
+          "kind": "fanout_aggregate",
+          "source": {
+            "kind": "fanout_results",
+            "ref": "aggregate"
+          },
+          "join": {
+            "policy": "aggregate-survivors"
+          },
+          "verdicts": {
+            "admit": ["accept"]
+          }
+        },
+        "routes": {
+          "continue": "hardening-step",
+          "pass": "hardening-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "hardening-step",
+        "title": "Harden — adversarial fidelity pass over survivors",
+        "kind": "relay",
+        "executor": "worker",
+        "protocol": "explainer-hardening@v1",
+        "reads": ["reports/intake.json", "reports/ideas.json", "reports/tournament-aggregate.json"],
+        "writes": {
+          "report": {
+            "path": "reports/hardening.json",
+            "schema": "explainer.hardening@v1"
+          },
+          "request": "reports/relay/hardening.request.json",
+          "receipt": "reports/relay/hardening.receipt.txt",
+          "result": "reports/relay/hardening.result.json"
+        },
+        "check": {
+          "kind": "result_verdict",
+          "source": {
+            "kind": "relay_result",
+            "ref": "result"
+          },
+          "pass": ["recommend", "no-clear-winner", "needs-operator"]
+        },
+        "routes": {
+          "continue": "pick-checkpoint-step",
+          "pass": "pick-checkpoint-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "pick-checkpoint-step",
+        "title": "Pick — operator chooses a concept to build",
+        "kind": "checkpoint",
+        "executor": "orchestrator",
+        "protocol": "explainer-pick-checkpoint@v1",
+        "reads": ["reports/hardening.json", "reports/tournament-aggregate.json"],
+        "writes": {
+          "request": "reports/checkpoints/pick-request.json",
+          "response": "reports/checkpoints/pick-response.json"
+        },
+        "check": {
+          "kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          },
+          "allow_from": {
+            "kind": "policy_choices"
+          }
+        },
+        "routes": {
+          "continue": "spec-step",
+          "pass": "spec-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "spec-step",
+        "title": "Spec — assemble the house-style build law",
+        "kind": "compose",
+        "executor": "orchestrator",
+        "protocol": "explainer-spec@v1",
+        "reads": [
+          "reports/intake.json",
+          "reports/ideas.json",
+          "reports/tournament-aggregate.json",
+          "reports/hardening.json"
+        ],
+        "writes": {
+          "report": {
+            "path": "reports/explainer/spec.json",
+            "schema": "explainer.spec@v1"
+          }
+        },
+        "check": {
+          "kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          },
+          "required": ["concept_id", "build_brief", "fidelity_citations"]
+        },
+        "routes": {
+          "continue": "build-gate-step",
+          "pass": "build-gate-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "build-gate-step",
+        "title": "Build gate — confirm the spec before spending the build",
+        "kind": "checkpoint",
+        "executor": "orchestrator",
+        "protocol": "explainer-build-gate-checkpoint@v1",
+        "reads": ["reports/explainer/spec.json", "reports/tournament-aggregate.json"],
+        "writes": {
+          "request": "reports/checkpoints/build-gate-request.json",
+          "response": "reports/checkpoints/build-gate-response.json"
+        },
+        "check": {
+          "kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          },
+          "allow": ["continue", "revise"]
+        },
+        "routes": {
+          "continue": "build-step",
+          "pass": "build-step",
+          "revise": "spec-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "build-step",
+        "title": "Build — run the child build flow on the spec",
+        "kind": "sub-run",
+        "executor": "orchestrator",
+        "protocol": "explainer-build@v1",
+        "reads": ["reports/explainer/spec.json"],
+        "writes": {
+          "result": "reports/explainer/build-result.json",
+          "report": {
+            "path": "reports/explainer/build-result.json",
+            "schema": "explainer.build-result@v1"
+          }
+        },
+        "check": {
+          "kind": "result_verdict",
+          "source": {
+            "kind": "sub_run_result",
+            "ref": "result"
+          },
+          "pass": [
+            "accept",
+            "accept-with-fixes",
+            "accept-with-fold-ins",
+            "clean",
+            "needs-followup",
+            "decided",
+            "NO_ISSUES_FOUND",
+            "ISSUES_FOUND"
+          ]
+        },
+        "routes": {
+          "continue": "verify-step",
+          "pass": "verify-step",
+          "stop": "retry-gate-step"
+        }
+      },
+      {
+        "step_id": "retry-gate-step",
+        "title": "Retry gate — the build failed; retry or stop without losing editorial",
+        "kind": "checkpoint",
+        "executor": "orchestrator",
+        "protocol": "explainer-retry-gate-checkpoint@v1",
+        "reads": ["reports/explainer/spec.json", "reports/tournament-aggregate.json"],
+        "writes": {
+          "request": "reports/checkpoints/retry-gate-request.json",
+          "response": "reports/checkpoints/retry-gate-response.json"
+        },
+        "check": {
+          "kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          },
+          "allow": ["continue", "stop"]
+        },
+        "routes": {
+          "continue": "build-step",
+          "pass": "build-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "verify-step",
+        "title": "Verify — prove the built site",
+        "kind": "verification",
+        "executor": "orchestrator",
+        "protocol": "explainer-verify@v1",
+        "reads": ["reports/explainer/spec.json", "reports/explainer/build-result.json"],
+        "writes": {
+          "report": {
+            "path": "reports/explainer/verification.json",
+            "schema": "explainer.verification@v1"
+          }
+        },
+        "check": {
+          "kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          },
+          "required": ["overall_status", "commands"]
+        },
+        "routes": {
+          "continue": "signoff-checkpoint-step",
+          "pass": "signoff-checkpoint-step",
+          "retry": "verify-step",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "signoff-checkpoint-step",
+        "title": "Sign off — operator fidelity gate and publish authorization",
+        "kind": "checkpoint",
+        "executor": "orchestrator",
+        "protocol": "explainer-signoff-checkpoint@v1",
+        "reads": ["reports/explainer/verification.json", "reports/explainer/build-result.json"],
+        "writes": {
+          "request": "reports/checkpoints/signoff-request.json",
+          "response": "reports/checkpoints/signoff-response.json"
+        },
+        "check": {
+          "kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          },
+          "allow": ["continue", "blocked", "handoff"]
+        },
+        "routes": {
+          "continue": "close-step",
+          "pass": "close-step",
+          "blocked": "close-step",
+          "handoff": "@handoff",
+          "stop": "@stop"
+        }
+      },
+      {
+        "step_id": "close-step",
+        "title": "Close — emit the explainer result",
+        "kind": "compose",
+        "executor": "orchestrator",
+        "protocol": "explainer-close@v1",
+        "reads": [
+          "reports/intake.json",
+          "reports/explainer/spec.json",
+          "reports/explainer/verification.json",
+          "reports/explainer/build-result.json"
+        ],
+        "writes": {
+          "report": {
+            "path": "reports/explainer-result.json",
+            "schema": "explainer.result@v1"
+          }
+        },
+        "check": {
+          "kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          },
+          "required": ["outcome", "summary", "evidence_pointers"]
+        },
+        "routes": {
+          "complete": "@complete",
+          "pass": "@complete",
+          "stop": "@stop"
+        }
+      }
+    ],
+    "authority": {
+      "relays": [
+        {
+          "step_id": "hardening-step",
+          "role": "reviewer",
+          "writes": {
+            "report": {
+              "path": "reports/hardening.json",
+              "schema": "explainer.hardening@v1"
+            },
+            "request": "reports/relay/hardening.request.json",
+            "receipt": "reports/relay/hardening.receipt.txt",
+            "result": "reports/relay/hardening.result.json"
+          },
+          "report": {
+            "step_id": "hardening-step",
+            "slot": "report",
+            "path": "reports/hardening.json",
+            "schema": "explainer.hardening@v1"
+          }
+        }
+      ],
+      "checkpoints": [
+        {
+          "step_id": "pick-checkpoint-step",
+          "choices": {
+            "kind": "dynamic",
+            "source_ref": {
+              "kind": "report_items",
+              "source_report": "reports/tournament-aggregate.json",
+              "items_path": "branches",
+              "filter": {
+                "kind": "path_equals",
+                "path": "child_outcome",
+                "value": "complete"
+              },
+              "id_path": "branch_id",
+              "label_path": "result_body.concept_label",
+              "description_path": "result_body.case_summary"
+            }
+          },
+          "writes": {
+            "request": "reports/checkpoints/pick-request.json",
+            "response": "reports/checkpoints/pick-response.json"
+          }
+        },
+        {
+          "step_id": "build-gate-step",
+          "choices": {
+            "kind": "static",
+            "ids": ["continue", "revise"]
+          },
+          "writes": {
+            "request": "reports/checkpoints/build-gate-request.json",
+            "response": "reports/checkpoints/build-gate-response.json"
+          }
+        },
+        {
+          "step_id": "retry-gate-step",
+          "choices": {
+            "kind": "static",
+            "ids": ["continue", "stop"]
+          },
+          "writes": {
+            "request": "reports/checkpoints/retry-gate-request.json",
+            "response": "reports/checkpoints/retry-gate-response.json"
+          }
+        },
+        {
+          "step_id": "signoff-checkpoint-step",
+          "choices": {
+            "kind": "static",
+            "ids": ["continue", "blocked", "handoff"]
+          },
+          "writes": {
+            "request": "reports/checkpoints/signoff-request.json",
+            "response": "reports/checkpoints/signoff-response.json"
+          }
+        }
+      ],
+      "sub_runs": [
+        {
+          "step_id": "build-step",
+          "flow_ref": {
+            "flow_id": "build",
+            "entry_mode": "default"
+          },
+          "goal": "Build the interactive web explainer described in reports/explainer/spec.json. Honor the house-style specs and teach the paper’s actual driver, never the seductive wrong one. Produce a locally building site; do not deploy.",
+          "depth": "medium",
+          "writes": {
+            "result": "reports/explainer/build-result.json",
+            "report": {
+              "path": "reports/explainer/build-result.json",
+              "schema": "explainer.build-result@v1"
+            }
+          }
+        }
+      ],
+      "fanouts": [
+        {
+          "step_id": "tournament-step",
+          "branches": {
+            "kind": "dynamic",
+            "source_report": "reports/ideas.json",
+            "items_path": "concepts",
+            "template": {
+              "branch_id": "$item.id",
+              "execution": {
+                "kind": "relay",
+                "role": "researcher",
+                "goal": "$item.scoped_prompt",
+                "report_schema": "explainer.tournament-proposal@v1",
+                "provenance_field": "concept_id"
+              }
+            },
+            "max_branches": {
+              "kind": "axis",
+              "axis": "tournament_n"
+            },
+            "required_count": {
+              "kind": "axis",
+              "axis": "tournament_n"
+            }
+          },
+          "writes": {
+            "branches_dir": "reports/tournament-branches",
+            "aggregate": {
+              "path": "reports/tournament-aggregate.json",
+              "schema": "explainer.tournament-aggregate@v1"
+            }
+          }
+        }
+      ],
+      "skill_slots": [
+        {
+          "step_id": "hardening-step",
+          "slot_id": "explainer-fidelity-audit",
+          "description": "A skill for adversarially checking each finalist concept against the paper, catching any that would teach the seductive wrong driver instead of the real one."
+        }
+      ],
+      "equipment_scopes": []
+    },
+    "proof": {
+      "reports": [
+        {
+          "step_id": "intake-step",
+          "slot": "report",
+          "path": "reports/intake.json",
+          "schema": "explainer.intake@v1"
+        },
+        {
+          "step_id": "digest-step",
+          "slot": "report",
+          "path": "reports/digest.json",
+          "schema": "explainer.digest@v1"
+        },
+        {
+          "step_id": "ideas-step",
+          "slot": "report",
+          "path": "reports/ideas.json",
+          "schema": "explainer.ideas@v1"
+        },
+        {
+          "step_id": "tournament-step",
+          "slot": "aggregate",
+          "path": "reports/tournament-aggregate.json",
+          "schema": "explainer.tournament-aggregate@v1"
+        },
+        {
+          "step_id": "hardening-step",
+          "slot": "report",
+          "path": "reports/hardening.json",
+          "schema": "explainer.hardening@v1"
+        },
+        {
+          "step_id": "spec-step",
+          "slot": "report",
+          "path": "reports/explainer/spec.json",
+          "schema": "explainer.spec@v1"
+        },
+        {
+          "step_id": "build-step",
+          "slot": "report",
+          "path": "reports/explainer/build-result.json",
+          "schema": "explainer.build-result@v1"
+        },
+        {
+          "step_id": "verify-step",
+          "slot": "report",
+          "path": "reports/explainer/verification.json",
+          "schema": "explainer.verification@v1"
+        },
+        {
+          "step_id": "close-step",
+          "slot": "report",
+          "path": "reports/explainer-result.json",
+          "schema": "explainer.result@v1"
+        }
+      ],
+      "checks": [
+        {
+          "step_id": "intake-step",
+          "check_kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          }
+        },
+        {
+          "step_id": "digest-step",
+          "check_kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          }
+        },
+        {
+          "step_id": "ideas-step",
+          "check_kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          }
+        },
+        {
+          "step_id": "tournament-step",
+          "check_kind": "fanout_aggregate",
+          "source": {
+            "kind": "fanout_results",
+            "ref": "aggregate"
+          }
+        },
+        {
+          "step_id": "hardening-step",
+          "check_kind": "result_verdict",
+          "source": {
+            "kind": "relay_result",
+            "ref": "result"
+          }
+        },
+        {
+          "step_id": "pick-checkpoint-step",
+          "check_kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          }
+        },
+        {
+          "step_id": "spec-step",
+          "check_kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          }
+        },
+        {
+          "step_id": "build-gate-step",
+          "check_kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          }
+        },
+        {
+          "step_id": "build-step",
+          "check_kind": "result_verdict",
+          "source": {
+            "kind": "sub_run_result",
+            "ref": "result"
+          }
+        },
+        {
+          "step_id": "retry-gate-step",
+          "check_kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          }
+        },
+        {
+          "step_id": "verify-step",
+          "check_kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          }
+        },
+        {
+          "step_id": "signoff-checkpoint-step",
+          "check_kind": "checkpoint_selection",
+          "source": {
+            "kind": "checkpoint_response",
+            "ref": "response"
+          }
+        },
+        {
+          "step_id": "close-step",
+          "check_kind": "schema_sections",
+          "source": {
+            "kind": "report",
+            "ref": "report"
+          }
+        }
+      ],
+      "acceptance_criteria": []
+    },
+    "recovery": [
+      {
+        "schema_version": 0,
+        "step_id": "intake-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/intake-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "digest-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/digest-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "ideas-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/ideas-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "tournament-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/tournament-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "hardening-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/hardening-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "pick-checkpoint-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/pick-checkpoint-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "spec-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/spec-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "build-gate-step",
+        "route_id": "revise",
+        "route_target": "spec-step",
+        "kind": "narrow_scope",
+        "allowed_failure_causes": ["failed_check", "scope_drift", "weak_proof", "unproved_claim"],
+        "required_refs": ["proof_assessment", "runtime_diff"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/build-gate-step/routes/revise",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "build-gate-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/build-gate-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "build-step",
+        "route_id": "stop",
+        "route_target": "retry-gate-step",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/build-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "retry-gate-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/retry-gate-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "verify-step",
+        "route_id": "retry",
+        "route_target": "verify-step",
+        "kind": "retry_same_step_with_feedback",
+        "allowed_failure_causes": [
+          "failed_check",
+          "failed_acceptance_criteria",
+          "relay_result_invalid"
+        ],
+        "required_refs": ["failed_check", "acceptance_feedback", "budget_state"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": true,
+          "must_respect_max_attempts": true,
+          "retry_target": "same_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/verify-step/routes/retry",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "verify-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/verify-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "signoff-checkpoint-step",
+        "route_id": "blocked",
+        "route_target": "close-step",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/signoff-checkpoint-step/routes/blocked",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "signoff-checkpoint-step",
+        "route_id": "handoff",
+        "route_target": "@handoff",
+        "kind": "handoff",
+        "allowed_failure_causes": ["checkpoint_boundary", "budget_exceeded", "unknown_failure"],
+        "required_refs": ["trace", "report"],
+        "operator_authority": "required_to_continue_after_route",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/signoff-checkpoint-step/routes/handoff",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "signoff-checkpoint-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/signoff-checkpoint-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      },
+      {
+        "schema_version": 0,
+        "step_id": "close-step",
+        "route_id": "stop",
+        "route_target": "@stop",
+        "kind": "stop_unsafe",
+        "allowed_failure_causes": [
+          "failed_check",
+          "contradicted_evidence",
+          "scope_drift",
+          "budget_exceeded",
+          "unknown_failure"
+        ],
+        "required_refs": ["failed_check", "trace"],
+        "operator_authority": "not_required",
+        "attempt_budget": {
+          "consumes_step_attempt": false,
+          "must_respect_max_attempts": true,
+          "retry_target": "declared_step"
+        },
+        "guidance": {
+          "subject": "recovery_route",
+          "must_match_step_completed": true
+        },
+        "source_ref": {
+          "kind": "work_contract",
+          "ref": "compiled-flow/steps/close-step/routes/stop",
+          "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+          "flow_id": "explainer"
+        }
+      }
+    ],
+    "limits": {
+      "budgets": []
+    }
+  },
+  "guidance_seed": {
+    "selection_hints": [],
+    "connector_hints": [],
+    "skill_hints": [],
+    "checkpoint_default_hints": [
+      {
+        "kind": "work_contract",
+        "ref": "compiled-flow/steps/pick-checkpoint-step/policy/safe_default_choice",
+        "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+        "flow_id": "explainer"
+      },
+      {
+        "kind": "work_contract",
+        "ref": "compiled-flow/steps/build-gate-step/policy/safe_default_choice",
+        "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+        "flow_id": "explainer"
+      },
+      {
+        "kind": "work_contract",
+        "ref": "compiled-flow/steps/retry-gate-step/policy/safe_default_choice",
+        "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+        "flow_id": "explainer"
+      },
+      {
+        "kind": "work_contract",
+        "ref": "compiled-flow/steps/signoff-checkpoint-step/policy/safe_default_choice",
+        "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+        "flow_id": "explainer"
+      }
+    ],
+    "host_recommendations": []
+  },
+  "rejected_authority": [
+    {
+      "path": "compiled-flow/steps/pick-checkpoint-step/policy/auto_resolution",
+      "field": "auto_resolution",
+      "reason": "checkpoint auto-resolution must become a declared default or traced guidance",
+      "source_ref": {
+        "kind": "work_contract",
+        "ref": "compiled-flow/steps/pick-checkpoint-step/policy/auto_resolution",
+        "sha256": "2b489416a2105f34a94282d913c11be938d9d56e01609415ffa85a05a3257a00",
+        "flow_id": "explainer"
+      }
+    }
+  ]
+}