pi_agent_rust/docs/contracts/runtime-intelligence-closeout-gate-contract.json at main · chatek/pi_agent_rust · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
{
  "schema": "pi.runtime_intelligence.closeout_gate_contract.v1",
  "decision_gate_schema": "pi.runtime_intelligence.closeout_gate.v1",
  "purpose": "prompt_to_artifact_runtime_intelligence_closeout_gate_not_source_of_truth",
  "allowed_statuses": [
    "pass",
    "fail"
  ],
  "allowed_check_statuses": [
    "pass",
    "fail"
  ],
  "allowed_decisions": [
    "close_final_gate_and_parent_epic",
    "file_follow_up_beads_before_closing_epic"
  ],
  "required_top_level_keys": [
    "schema",
    "generated_at",
    "status",
    "purpose",
    "parent_epic",
    "final_gate_bead",
    "required_checks",
    "child_artifact_map",
    "source_boundary_checks",
    "quality_gate_results",
    "checklist",
    "missing_checks",
    "remaining_follow_ups",
    "known_limitations",
    "claim_boundaries",
    "follow_up_required",
    "follow_up_beads",
    "decision",
    "epic_can_close_after_this_commit"
  ],
  "required_child_bead_ids": [
    "bd-h66tp.1",
    "bd-h66tp.2",
    "bd-h66tp.3",
    "bd-h66tp.4",
    "bd-h66tp.5",
    "bd-h66tp.6",
    "bd-h66tp.7"
  ],
  "required_check_ids": [
    "child_beads_closed",
    "compaction_admission",
    "tool_output_artifacts",
    "provider_routing",
    "scheduler_fairness",
    "frame_budget",
    "cancellation_cleanup",
    "extension_safety_provenance",
    "docs_and_evidence",
    "source_boundaries",
    "pushed_commits",
    "quality_gates"
  ],
  "required_source_boundary_ids": [
    "beads_are_source_of_truth",
    "agent_mail_is_coordination_only",
    "read_only_gate",
    "rch_required_for_heavy_cargo",
    "staged_ubs_required",
    "beads_ledger_required",
    "no_release_or_dropin_claims",
    "closeout_does_not_replace_child_artifacts"
  ],
  "required_quality_gate_ids": [
    "py_compile",
    "runpack_self_test",
    "json_contracts",
    "runtime_intelligence_closeout_gate_contract_rch",
    "cargo_fmt",
    "git_diff_check",
    "cargo_check_all_targets_rch",
    "cargo_clippy_all_targets_rch",
    "staged_ubs",
    "beads_ledger_reconcile"
  ],
  "requirements": [
    {
      "id": "child_artifact_mapping",
      "description": "Every third-wave runtime-intelligence implementation child bead maps to committed code paths, test paths, docs or evidence paths, validation commands, close reason, and commit hash."
    },
    {
      "id": "prompt_to_artifact_coverage",
      "description": "The checklist covers child closure, compaction admission, tool-output artifacts, provider routing, scheduler fairness, TUI frame budgets, cancellation cleanup, extension safety provenance, docs/evidence, source boundaries, pushed refs, and quality gates."
    },
    {
      "id": "safe_close_behavior",
      "description": "A passing gate may close the final gate and parent epic only after this commit lands and the branch is pushed. A failing gate must emit follow-up Beads instead of optimistic closeout."
    },
    {
      "id": "rch_heavy_gates",
      "description": "All heavy Cargo validation evidence must prove RCH execution, including the runtime-intelligence closeout contract test plus cargo check and clippy."
    },
    {
      "id": "not_source_of_truth",
      "description": "The closeout gate is evidence over Beads, git, docs, tests, RCH, Agent Mail, UBS, and source artifacts. It does not replace those sources of truth."
    },
    {
      "id": "claim_boundaries",
      "description": "The closeout gate must not make release-facing performance, capacity, benchmark, or strict drop-in claims. Runtime-intelligence evidence remains advisory operator evidence."
    }
  ]
}