rungate 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (282) hide show
  1. package/bin/rungate.ts +70 -0
  2. package/lib/aes-calculator.ts +66 -0
  3. package/lib/agent-audit.ts +139 -0
  4. package/lib/agent-brief-validation.ts +359 -0
  5. package/lib/agents-md-refs.ts +90 -0
  6. package/lib/bash-file-read.ts +197 -0
  7. package/lib/behavioral-cache.ts +78 -0
  8. package/lib/branch-cleanup.ts +234 -0
  9. package/lib/brief-context-parser.ts +35 -0
  10. package/lib/canary.ts +117 -0
  11. package/lib/check-registry.ts +226 -0
  12. package/lib/ci-checkout.ts +400 -0
  13. package/lib/cli-commands.ts +137 -0
  14. package/lib/compliance-backfill.ts +220 -0
  15. package/lib/compliance-report.ts +504 -0
  16. package/lib/compliance.ts +361 -0
  17. package/lib/config-loader.ts +255 -0
  18. package/lib/conformity.ts +1818 -131
  19. package/lib/container-provenance.ts +230 -0
  20. package/lib/create-brief.ts +150 -0
  21. package/lib/create-sc.ts +272 -0
  22. package/lib/deep-merge.ts +69 -0
  23. package/lib/dev-liveness.ts +214 -0
  24. package/lib/directive-extractor.ts +210 -0
  25. package/lib/distribution-standing.ts +113 -0
  26. package/lib/doc-hygiene.ts +238 -0
  27. package/lib/eval-criteria.ts +6 -0
  28. package/lib/evidence-portability.ts +123 -0
  29. package/lib/evidence-prevalidator.ts +390 -0
  30. package/lib/evidence-required.ts +150 -0
  31. package/lib/evidence-satisfiability.ts +288 -0
  32. package/lib/frontmatter.ts +163 -0
  33. package/lib/gap-scanner.ts +348 -0
  34. package/lib/gate-enforcement.ts +366 -0
  35. package/lib/generators/agent-briefs.ts +136 -0
  36. package/lib/generators/agents-md.ts +506 -0
  37. package/lib/generators/code-map.ts +60 -0
  38. package/lib/generators/types.ts +184 -0
  39. package/lib/git-ref-normalizer.ts +107 -0
  40. package/lib/github.ts +539 -0
  41. package/lib/harness-identity.ts +63 -0
  42. package/lib/hill-climb.ts +164 -0
  43. package/lib/instruction-effectiveness.ts +131 -0
  44. package/lib/issue-closure-audit.ts +225 -0
  45. package/lib/issue-create-override.ts +343 -0
  46. package/lib/js-top-level-code.ts +250 -0
  47. package/lib/liveness-contradiction.ts +149 -0
  48. package/lib/organize.ts +505 -0
  49. package/lib/paths.ts +197 -6
  50. package/lib/post-fix-verify.ts +157 -0
  51. package/lib/prior-branch.ts +489 -0
  52. package/lib/project-state-shape.ts +166 -0
  53. package/lib/promote-outputs.ts +156 -0
  54. package/lib/prove-label-gate.ts +35 -0
  55. package/lib/reachability.ts +302 -0
  56. package/lib/release-preflight.ts +186 -0
  57. package/lib/rule-health-pipeline.ts +264 -0
  58. package/lib/rule-health-trend.ts +161 -0
  59. package/lib/rule-provenance.ts +149 -0
  60. package/lib/rule-registry.ts +128 -0
  61. package/lib/rungate-schema.ts +114 -4
  62. package/lib/sc-claim-forms.ts +179 -0
  63. package/lib/sc-cover.ts +150 -0
  64. package/lib/sc-guard.ts +157 -0
  65. package/lib/sc-ids.ts +344 -0
  66. package/lib/scaffold/defaults.ts +165 -0
  67. package/lib/scaffold/managed-workflow.ts +370 -0
  68. package/lib/scaffold/owned-files.ts +265 -0
  69. package/lib/scaffold/steps.ts +2680 -0
  70. package/lib/scanner.ts +701 -0
  71. package/lib/screenshot-upload.ts +73 -0
  72. package/lib/secret-patterns.ts +112 -0
  73. package/lib/security-verdict.ts +616 -0
  74. package/lib/signal-phrases.ts +1 -0
  75. package/lib/spec-change-conformity.ts +80 -0
  76. package/lib/spec-files.ts +62 -0
  77. package/lib/spec-registry.ts +133 -0
  78. package/lib/spec-updater.ts +96 -0
  79. package/lib/stale-cleanup.ts +224 -0
  80. package/lib/stale-issue-scanner.ts +36 -0
  81. package/lib/strip-js-comments.ts +269 -0
  82. package/lib/suite-measurement.ts +228 -0
  83. package/lib/task-completion-checks.ts +177 -0
  84. package/lib/test-suite-lock.ts +1136 -0
  85. package/lib/transcript-checker.ts +1140 -0
  86. package/lib/validators/spec-validators.ts +171 -0
  87. package/lib/verdict-capture.ts +73 -0
  88. package/lib/verified-push.ts +358 -0
  89. package/lib/workflow-security.ts +174 -0
  90. package/lib/worktree-cleanup.ts +250 -0
  91. package/lib/worktree-collect.ts +283 -0
  92. package/lib/worktree-isolation.ts +82 -0
  93. package/package.json +36 -3
  94. package/prompts/ac-adversary.md +14 -2
  95. package/prompts/aditi.md +5 -0
  96. package/prompts/blast-radius.md +5 -0
  97. package/prompts/container-verify.md +5 -0
  98. package/prompts/discovery.md +4 -0
  99. package/prompts/environment.md +5 -0
  100. package/prompts/evidence-hierarchy.md +5 -0
  101. package/prompts/evidence-validator.md +11 -0
  102. package/prompts/marcus.md +5 -0
  103. package/prompts/prevention.md +5 -0
  104. package/prompts/prove-reproducer.md +12 -0
  105. package/prompts/quinn-decision-tree.md +5 -0
  106. package/prompts/quinn-ui-brief.md +5 -0
  107. package/prompts/quinn.md +5 -0
  108. package/prompts/rca.md +5 -0
  109. package/prompts/read-before-write.md +4 -0
  110. package/prompts/regression.md +5 -0
  111. package/prompts/serena.md +5 -0
  112. package/scripts/audit-specs.ts +464 -0
  113. package/scripts/convert-spec.ts +293 -0
  114. package/scripts/create-sc.ts +92 -0
  115. package/scripts/create-spec.ts +166 -0
  116. package/scripts/extract-constraints.ts +4 -3
  117. package/scripts/generate-code-map.ts +1 -1
  118. package/scripts/scaffold-project.ts +138 -1426
  119. package/scripts/sync-spec-tests.ts +211 -126
  120. package/.claude/agents/aditi.md +0 -47
  121. package/.claude/agents/marcus.md +0 -50
  122. package/.claude/agents/quinn.md +0 -58
  123. package/.claude/agents/rook.md +0 -47
  124. package/.claude/agents/serena.md +0 -46
  125. package/.claude/rungate.json +0 -11
  126. package/.fallowrc.json +0 -28
  127. package/.github/copilot-instructions.md +0 -20
  128. package/.rungate/conformity-findings.json +0 -648
  129. package/AGENTS.md +0 -106
  130. package/CODE-MAP.md +0 -50
  131. package/HARNESS.md +0 -88
  132. package/bun.lock +0 -26
  133. package/bunfig.toml +0 -2
  134. package/config/brief-policies.json +0 -28
  135. package/config/ceremony-profiles.json +0 -212
  136. package/config/consumer-cascade-map.json +0 -24
  137. package/config/doc-cascade-map.json +0 -24
  138. package/config/eval.json +0 -84
  139. package/config/profiles/account-plan.yaml +0 -36
  140. package/config/profiles/campaign.yaml +0 -94
  141. package/config/prove-evidence.schema.json +0 -65
  142. package/config/spec-policies.json +0 -36
  143. package/config/workflow-schema.json +0 -281
  144. package/gates/SCHEMA-GUIDE.md +0 -121
  145. package/gates/ac-quality.test.ts +0 -106
  146. package/gates/adversarial.test.ts +0 -274
  147. package/gates/brief-assembler.test.ts +0 -429
  148. package/gates/brief-assembler.ts +0 -334
  149. package/gates/bunfig.toml +0 -2
  150. package/gates/chain.test.ts +0 -91
  151. package/gates/e2e-smoke.test.ts +0 -234
  152. package/gates/error-classifier.test.ts +0 -249
  153. package/gates/error-classifier.ts +0 -89
  154. package/gates/orchestrator.test.ts +0 -950
  155. package/gates/orchestrator.ts +0 -569
  156. package/gates/preload.ts +0 -77
  157. package/gates/prompts/ac-adversary.md +0 -20
  158. package/gates/prompts/evidence-validator.md +0 -22
  159. package/gates/prompts/prove-reproducer.md +0 -53
  160. package/gates/prove.test.ts +0 -164
  161. package/gates/run-gate.ts +0 -936
  162. package/gates/schema-parity.test.ts +0 -197
  163. package/gates/schema.ts +0 -362
  164. package/gates/self-heal.test.ts +0 -511
  165. package/gates/self-heal.ts +0 -121
  166. package/gates/ship-orchestrator.test.ts +0 -379
  167. package/gates/ship-orchestrator.ts +0 -363
  168. package/gates/test-fixtures/broken-no-environments.json +0 -60
  169. package/gates/test-fixtures/valid-standard.json +0 -54
  170. package/gates/test-utils.ts +0 -43
  171. package/gates/witness.ts +0 -220
  172. package/gates/workflow.test.ts +0 -1053
  173. package/hooks/AgentBriefGuard.hook.ts +0 -586
  174. package/hooks/AgentVerdictCapture.hook.ts +0 -134
  175. package/hooks/AutoVerifyGate.hook.ts +0 -76
  176. package/hooks/GateEnforcement.hook.ts +0 -273
  177. package/hooks/IssueCloseGuard.hook.ts +0 -116
  178. package/hooks/MergeGuard.hook.ts +0 -55
  179. package/hooks/StaleTTLCleanup.hook.ts +0 -133
  180. package/hooks/VerifyPhaseLock.hook.ts +0 -81
  181. package/hooks/WorkflowStateGuard.hook.ts +0 -37
  182. package/hooks/lib/agentDetection.ts +0 -70
  183. package/hooks/lib/findWorkflow.ts +0 -101
  184. package/hooks/lib/parseStdin.ts +0 -37
  185. package/hooks/lib/paths.ts +0 -111
  186. package/hooks/lib/utils.ts +0 -81
  187. package/reference/migration-manifest.json +0 -554
  188. package/reference/prompts/agent-aditi.md +0 -38
  189. package/reference/prompts/agent-marcus.md +0 -38
  190. package/reference/prompts/agent-quinn.md +0 -38
  191. package/reference/prompts/agent-rook.md +0 -37
  192. package/reference/prompts/agent-serena.md +0 -37
  193. package/reference/prompts/council-skill.md +0 -170
  194. package/reference/prompts/goal-skill.md +0 -235
  195. package/reference/prompts/prove-skill.md +0 -283
  196. package/reference/prompts/quinn-standard.md +0 -246
  197. package/reference/prompts/ship-convergence.md +0 -65
  198. package/reference/prompts/ship-escalation.md +0 -43
  199. package/reference/prompts/ship-iteration.md +0 -382
  200. package/reference/prompts/ship-pending-patches.md +0 -246
  201. package/reference/prompts/ship-reference.md +0 -250
  202. package/reference/prompts/ship-skill.md +0 -347
  203. package/reference/prompts/ship-templates.md +0 -215
  204. package/reference/scripts/batch-status.sh +0 -68
  205. package/reference/scripts/chain-compat-check.sh +0 -67
  206. package/reference/scripts/context-audit.sh +0 -314
  207. package/reference/scripts/dead-export-check.sh +0 -61
  208. package/reference/scripts/generate-qc-tables.sh +0 -92
  209. package/reference/scripts/harness-init.sh +0 -111
  210. package/reference/scripts/pai-054-baseline-check.sh +0 -40
  211. package/reference/scripts/prove-smoke-test.sh +0 -112
  212. package/reference/scripts/setup-keychain-salt.sh +0 -12
  213. package/reference/scripts/skill-optimizer-friday.sh +0 -88
  214. package/reference/scripts/skill-qc-test.sh +0 -351
  215. package/reference/scripts/skill-synthesize-tonight.sh +0 -66
  216. package/reference/specs/HARNESS-EXTRACTION-SPEC.md +0 -263
  217. package/reference/specs/harness-v3-bash-deletion-plan.md +0 -65
  218. package/reference/specs/harness-v3-migration-plan.md +0 -188
  219. package/scripts/decision-reconcile.sh +0 -74
  220. package/scripts/decision-reconcile.ts +0 -152
  221. package/scripts/git-hooks/pre-commit +0 -76
  222. package/scripts/git-hooks/pre-push +0 -271
  223. package/scripts/harness-skill-check.sh +0 -52
  224. package/scripts/lib/gap-emit.sh +0 -65
  225. package/scripts/lib/jq-update.sh +0 -30
  226. package/scripts/lib/resolve-slug.sh +0 -30
  227. package/scripts/lib/verify-spec-compliance.sh +0 -102
  228. package/scripts/prove-backfill.sh +0 -87
  229. package/scripts/scaffold-rungate-config.ts +0 -91
  230. package/scripts/self-containment-check.sh +0 -109
  231. package/scripts/skill-qc-validator.sh +0 -402
  232. package/scripts/slug-resolver.sh +0 -14
  233. package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +0 -2493
  234. package/specs/BOOTSTRAP-TEST-PLAN.md +0 -571
  235. package/specs/HARNESS-GATES.md +0 -256
  236. package/specs/HARNESS-SKILL-CHAIN.md +0 -286
  237. package/specs/HARNESS-SKILL-CONTRACT.md +0 -93
  238. package/specs/HARNESS-STANDARD.md +0 -488
  239. package/specs/SPEC-TEMPLATE.md +0 -53
  240. package/specs/bootstrap-data-flow.png +0 -0
  241. package/specs/harness-automation-matrix.md +0 -314
  242. package/specs/harness-automation-matrix.rules.json +0 -64
  243. package/test/anti.test.ts +0 -80
  244. package/test/contract-negative.test.ts +0 -86
  245. package/test/contract.test.ts +0 -158
  246. package/test/external-deps.test.ts +0 -48
  247. package/test/fixtures/golden-project/.env.example +0 -3
  248. package/test/fixtures/golden-project/Makefile +0 -7
  249. package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +0 -23
  250. package/test/fixtures/golden-project/docs/setup-guide.md +0 -10
  251. package/test/fixtures/golden-project/package.json +0 -10
  252. package/test/fixtures/golden-project/specs/api-spec.md +0 -20
  253. package/test/fixtures/golden-project/src/auth.ts +0 -8
  254. package/test/fixtures/golden-project/src/db.ts +0 -11
  255. package/test/fixtures/golden-project/src/index.ts +0 -19
  256. package/test/fixtures/golden-project/src/utils/format.ts +0 -3
  257. package/test/fixtures/golden-project/test/auth.test.ts +0 -15
  258. package/test/fixtures/golden-project/tsconfig.json +0 -12
  259. package/test/meta-sc-coverage.test.ts +0 -159
  260. package/test/phase-0.test.ts +0 -846
  261. package/test/phase-1.test.ts +0 -617
  262. package/test/phase-2.test.ts +0 -620
  263. package/test/phase-3.test.ts +0 -99
  264. package/test/scaffold-conformity.test.ts +0 -8
  265. package/test/schema-canary.test.ts +0 -51
  266. package/test/spec-compliance-auto.test.ts +0 -64
  267. package/test/spec-compliance.test.ts +0 -295
  268. package/test/spec-discovery.test.ts +0 -68
  269. package/test/spec-drift.test.ts +0 -5
  270. package/test/structure.test.ts +0 -165
  271. package/test/unit/agent-brief-guard-ship.test.ts +0 -293
  272. package/test/unit/extract-constraints.test.ts +0 -145
  273. package/test/unit/issue-close-guard.test.ts +0 -204
  274. package/test/unit/scaffold-project.test.ts +0 -417
  275. package/test/unit/skill-cooccurrence.test.ts +0 -177
  276. package/test/unit/skill-sequence-logger.test.ts +0 -244
  277. package/test/unit/workflow-state-guard.test.ts +0 -95
  278. package/workflows/batch-ship.js +0 -295
  279. package/workflows/council.js +0 -481
  280. package/workflows/prove.js +0 -560
  281. package/workflows/ship.js +0 -789
  282. package/workflows/verify.js +0 -236
@@ -1,379 +0,0 @@
1
- import { test, expect, describe, beforeEach, afterEach } from "bun:test";
2
- import { mkdirSync, writeFileSync, readFileSync, rmSync, existsSync } from "fs";
3
- import { join } from "path";
4
-
5
- const TEST_BASE = `/tmp/ship-orch-test-${process.pid}`;
6
- const TEST_SLUG = `orch-test-${process.pid}`;
7
- const WORK_DIR = join(TEST_BASE, TEST_SLUG);
8
- const SF = join(WORK_DIR, "workflow-state.json");
9
-
10
- function minimalState(overrides: Record<string, any> = {}): Record<string, any> {
11
- return {
12
- schemaVersion: 2,
13
- issue: 9999,
14
- repo: "test/repo",
15
- issueRepo: "test/repo",
16
- projectRoot: "/tmp/test-project",
17
- slug: TEST_SLUG,
18
- phase: "GOAL",
19
- issueGoal: "Test goal for ship orchestrator validation",
20
- acs: [],
21
- gates: {},
22
- changelog: [],
23
- ...overrides,
24
- };
25
- }
26
-
27
- function createState(overrides: Record<string, any> = {}): void {
28
- mkdirSync(WORK_DIR, { recursive: true });
29
- writeFileSync(SF, JSON.stringify(minimalState(overrides), null, 2));
30
- }
31
-
32
- function readState(): any {
33
- return JSON.parse(readFileSync(SF, "utf-8"));
34
- }
35
-
36
- // Override WORK_DIR_BASE for tests via env
37
- process.env.RUNGATE_WORK_DIR = TEST_BASE;
38
-
39
- import {
40
- advancePhase,
41
- currentState,
42
- runGate,
43
- setGateExecutor,
44
- getIterationCount,
45
- isCircuitBroken,
46
- validatePhaseTransition,
47
- getRequiredGate,
48
- MAX_ITERATIONS,
49
- } from "./ship-orchestrator";
50
-
51
- // Mock gate executor — writes FAIL result to workflow-state.json instead of spawning bun subprocess
52
- function mockGateExecutor(gate: string, slug: string, _issue: number): void {
53
- const sf = join(TEST_BASE, slug, "workflow-state.json");
54
- const state = JSON.parse(readFileSync(sf, "utf-8"));
55
- state.gates = state.gates || {};
56
- state.gates[gate] = { result: "FAIL", attempt: 1, failures: [{ check: "mock-gate", detail: "mock executor" }] };
57
- writeFileSync(sf, JSON.stringify(state, null, 2));
58
- }
59
-
60
- describe("ship-orchestrator", () => {
61
- // Use mock executor to prevent subprocess spawning
62
- beforeEach(() => setGateExecutor(mockGateExecutor));
63
- afterEach(() => setGateExecutor(null));
64
- beforeEach(() => {
65
- mkdirSync(WORK_DIR, { recursive: true });
66
- });
67
-
68
- afterEach(() => {
69
- try { rmSync(TEST_BASE, { recursive: true, force: true }); } catch {}
70
- });
71
-
72
- // ── currentState ─────────────────────────────────────────────────
73
-
74
- describe("currentState", () => {
75
- test("returns workflow state for valid slug", async () => {
76
- createState({ phase: "BUILD" });
77
- const state = await currentState(TEST_SLUG);
78
- expect(state.phase).toBe("BUILD");
79
- expect(state.slug).toBe(TEST_SLUG);
80
- expect(state.issue).toBe(9999);
81
- });
82
-
83
- test("throws for missing slug", async () => {
84
- await expect(currentState("nonexistent-slug-xyz-12345")).rejects.toThrow(/not found/);
85
- });
86
- });
87
-
88
- // ── getRequiredGate ──────────────────────────────────────────────
89
-
90
- describe("getRequiredGate", () => {
91
- test("returns scope for SCOPE phase", () => {
92
- expect(getRequiredGate("SCOPE")).toBe("scope");
93
- });
94
-
95
- test("returns verify for BUILD phase", () => {
96
- expect(getRequiredGate("BUILD")).toBe("verify");
97
- });
98
-
99
- test("returns ship for SHIP phase", () => {
100
- expect(getRequiredGate("SHIP")).toBe("ship");
101
- });
102
-
103
- test("returns null for ungated phases", () => {
104
- expect(getRequiredGate("GOAL")).toBeNull();
105
- expect(getRequiredGate("DISCOVERY")).toBeNull();
106
- expect(getRequiredGate("DONE")).toBeNull();
107
- });
108
- });
109
-
110
- // ── validatePhaseTransition ──────────────────────────────────────
111
-
112
- describe("validatePhaseTransition", () => {
113
- test("GOAL → DISCOVERY is valid", () => {
114
- expect(validatePhaseTransition("GOAL", "DISCOVERY")).toBe(true);
115
- });
116
-
117
- test("DISCOVERY → SCOPE is valid", () => {
118
- expect(validatePhaseTransition("DISCOVERY", "SCOPE")).toBe(true);
119
- });
120
-
121
- test("SCOPE → BUILD is valid (via scope gate)", () => {
122
- expect(validatePhaseTransition("SCOPE", "BUILD")).toBe(true);
123
- });
124
-
125
- test("BUILD → SHIP is valid (via verify gate)", () => {
126
- expect(validatePhaseTransition("BUILD", "SHIP")).toBe(true);
127
- });
128
-
129
- test("SHIP → DONE is valid (via ship gate)", () => {
130
- expect(validatePhaseTransition("SHIP", "DONE")).toBe(true);
131
- });
132
-
133
- test("cannot skip phases — GOAL → BUILD is invalid", () => {
134
- expect(validatePhaseTransition("GOAL", "BUILD")).toBe(false);
135
- });
136
-
137
- test("cannot skip phases — GOAL → SHIP is invalid", () => {
138
- expect(validatePhaseTransition("GOAL", "SHIP")).toBe(false);
139
- });
140
-
141
- test("cannot advance from DONE", () => {
142
- expect(validatePhaseTransition("DONE", "GOAL")).toBe(false);
143
- });
144
-
145
- test("cannot advance from CIRCUIT_BREAK", () => {
146
- expect(validatePhaseTransition("CIRCUIT_BREAK", "GOAL")).toBe(false);
147
- });
148
-
149
- test("VERIFY → SHIP is valid (direct)", () => {
150
- expect(validatePhaseTransition("VERIFY", "SHIP")).toBe(true);
151
- });
152
- });
153
-
154
- // ── advancePhase — ungated transitions ───────────────────────────
155
-
156
- describe("advancePhase — ungated transitions", () => {
157
- test("advances GOAL → DISCOVERY without gate", async () => {
158
- createState({ phase: "GOAL" });
159
- const result = await advancePhase(TEST_SLUG);
160
- expect(result.phase).toBe("DISCOVERY");
161
- expect(result.gateResult).toBe("SKIPPED");
162
- const state = readState();
163
- expect(state.phase).toBe("DISCOVERY");
164
- });
165
-
166
- test("advances DISCOVERY → SCOPE without gate", async () => {
167
- createState({ phase: "DISCOVERY" });
168
- const result = await advancePhase(TEST_SLUG);
169
- expect(result.phase).toBe("SCOPE");
170
- expect(result.gateResult).toBe("SKIPPED");
171
- });
172
-
173
- test("advances VERIFY → SHIP without gate", async () => {
174
- createState({ phase: "VERIFY" });
175
- const result = await advancePhase(TEST_SLUG);
176
- expect(result.phase).toBe("SHIP");
177
- expect(result.gateResult).toBe("SKIPPED");
178
- });
179
-
180
- test("blocks advancement from DONE", async () => {
181
- createState({ phase: "DONE" });
182
- const result = await advancePhase(TEST_SLUG);
183
- expect(result.phase).toBe("DONE");
184
- expect(result.gateResult).toBe("SKIPPED");
185
- });
186
-
187
- test("blocks advancement from CIRCUIT_BREAK", async () => {
188
- createState({ phase: "CIRCUIT_BREAK" });
189
- const result = await advancePhase(TEST_SLUG);
190
- expect(result.phase).toBe("CIRCUIT_BREAK");
191
- expect(result.gateResult).toBe("SKIPPED");
192
- });
193
-
194
- test("records phase advancement in changelog", async () => {
195
- createState({ phase: "GOAL", changelog: [] });
196
- await advancePhase(TEST_SLUG);
197
- const state = readState();
198
- const last = state.changelog[state.changelog.length - 1];
199
- expect(last.event).toBe("phase-advance");
200
- expect(last.detail).toContain("GOAL");
201
- expect(last.detail).toContain("DISCOVERY");
202
- expect(last.actor).toBe("gate-runner");
203
- });
204
-
205
- test("tracks phase timings on advancement", async () => {
206
- createState({ phase: "GOAL", changelog: [] });
207
- await advancePhase(TEST_SLUG);
208
- const state = readState();
209
- expect(state.phaseTimings).toBeDefined();
210
- expect(state.phaseTimings.DISCOVERY).toBeDefined();
211
- expect(state.phaseTimings.DISCOVERY.length).toBe(1);
212
- expect(state.phaseTimings.DISCOVERY[0].enteredTs).toBeTruthy();
213
- expect(state.phaseTimings.DISCOVERY[0].source).toBe("gate-runner");
214
- });
215
-
216
- test("sequential ungated advances work correctly", async () => {
217
- createState({ phase: "GOAL" });
218
- let result = await advancePhase(TEST_SLUG);
219
- expect(result.phase).toBe("DISCOVERY");
220
- result = await advancePhase(TEST_SLUG);
221
- expect(result.phase).toBe("SCOPE");
222
- });
223
- });
224
-
225
- // ── runGate — phase validation ───────────────────────────────────
226
-
227
- describe("runGate — phase validation", () => {
228
- test("rejects scope gate from GOAL phase", async () => {
229
- createState({ phase: "GOAL" });
230
- await expect(runGate(TEST_SLUG, "scope")).rejects.toThrow(/Cannot run scope gate from phase GOAL/);
231
- });
232
-
233
- test("rejects verify gate from SCOPE phase", async () => {
234
- createState({ phase: "SCOPE" });
235
- await expect(runGate(TEST_SLUG, "verify")).rejects.toThrow(/Cannot run verify gate from phase SCOPE/);
236
- });
237
-
238
- test("rejects ship gate from BUILD phase", async () => {
239
- createState({ phase: "BUILD" });
240
- await expect(runGate(TEST_SLUG, "ship")).rejects.toThrow(/Cannot run ship gate from phase BUILD/);
241
- });
242
-
243
- test("rejects scope gate from DONE phase", async () => {
244
- createState({ phase: "DONE" });
245
- await expect(runGate(TEST_SLUG, "scope")).rejects.toThrow(/Cannot run scope gate from phase DONE/);
246
- });
247
-
248
- test("scope gate allowed from SCOPE phase", async () => {
249
- createState({ phase: "SCOPE" });
250
- // This will try to call run-gate.ts and fail due to missing ACs etc,
251
- // but it should NOT throw a phase validation error
252
- const result = await runGate(TEST_SLUG, "scope");
253
- // Gate will fail because no ACs, but that proves the phase validation passed
254
- expect(result.gateResult).toBe("FAIL");
255
- });
256
- });
257
-
258
- // ── Circuit breaker ─────────────────────────────────────────────
259
-
260
- describe("circuit breaker", () => {
261
- test("MAX_ITERATIONS is 3", () => {
262
- expect(MAX_ITERATIONS).toBe(3);
263
- });
264
-
265
- test("getIterationCount returns 0 for fresh workflow", () => {
266
- createState({ phase: "BUILD", changelog: [] });
267
- expect(getIterationCount(TEST_SLUG)).toBe(0);
268
- });
269
-
270
- test("getIterationCount counts iteration-loopback events", () => {
271
- createState({
272
- phase: "BUILD",
273
- changelog: [
274
- { ts: "2026-01-01T00:00:00Z", event: "iteration-loopback", detail: "iteration 1", actor: "gate-runner" },
275
- { ts: "2026-01-01T00:01:00Z", event: "iteration-loopback", detail: "iteration 2", actor: "gate-runner" },
276
- ],
277
- });
278
- expect(getIterationCount(TEST_SLUG)).toBe(2);
279
- });
280
-
281
- test("isCircuitBroken returns false below threshold", () => {
282
- createState({
283
- phase: "BUILD",
284
- changelog: [
285
- { ts: "2026-01-01T00:00:00Z", event: "iteration-loopback", detail: "iteration 1", actor: "gate-runner" },
286
- { ts: "2026-01-01T00:01:00Z", event: "iteration-loopback", detail: "iteration 2", actor: "gate-runner" },
287
- ],
288
- });
289
- expect(isCircuitBroken(TEST_SLUG)).toBe(false);
290
- });
291
-
292
- test("isCircuitBroken returns true at threshold", () => {
293
- createState({
294
- phase: "BUILD",
295
- changelog: [
296
- { ts: "2026-01-01T00:00:00Z", event: "iteration-loopback", detail: "iteration 1", actor: "gate-runner" },
297
- { ts: "2026-01-01T00:01:00Z", event: "iteration-loopback", detail: "iteration 2", actor: "gate-runner" },
298
- { ts: "2026-01-01T00:02:00Z", event: "iteration-loopback", detail: "iteration 3", actor: "gate-runner" },
299
- ],
300
- });
301
- expect(isCircuitBroken(TEST_SLUG)).toBe(true);
302
- });
303
-
304
- test("isCircuitBroken returns true when phase is CIRCUIT_BREAK", () => {
305
- createState({ phase: "CIRCUIT_BREAK", changelog: [] });
306
- expect(isCircuitBroken(TEST_SLUG)).toBe(true);
307
- });
308
-
309
- test("runGate returns circuit breaker result when broken", async () => {
310
- createState({
311
- phase: "BUILD",
312
- changelog: [
313
- { ts: "2026-01-01T00:00:00Z", event: "iteration-loopback", detail: "1", actor: "gate-runner" },
314
- { ts: "2026-01-01T00:01:00Z", event: "iteration-loopback", detail: "2", actor: "gate-runner" },
315
- { ts: "2026-01-01T00:02:00Z", event: "iteration-loopback", detail: "3", actor: "gate-runner" },
316
- ],
317
- });
318
- const result = await runGate(TEST_SLUG, "verify");
319
- expect(result.circuitBreaker).toBe(true);
320
- expect(result.gateResult).toBe("FAIL");
321
- });
322
- });
323
-
324
- // ── advancePhase — gated transitions ─────────────────────────────
325
-
326
- describe("advancePhase — gated transitions", () => {
327
- test("advancePhase from SCOPE triggers scope gate", async () => {
328
- createState({ phase: "SCOPE" });
329
- const result = await advancePhase(TEST_SLUG);
330
- // Gate will fail because no ACs, but it was invoked (not SKIPPED)
331
- expect(result.gateResult).not.toBe("SKIPPED");
332
- });
333
-
334
- test("advancePhase from BUILD triggers verify gate", async () => {
335
- createState({ phase: "BUILD" });
336
- const result = await advancePhase(TEST_SLUG);
337
- expect(result.gateResult).not.toBe("SKIPPED");
338
- });
339
-
340
- test("advancePhase from SHIP triggers ship gate", async () => {
341
- createState({ phase: "SHIP" });
342
- const result = await advancePhase(TEST_SLUG);
343
- expect(result.gateResult).not.toBe("SKIPPED");
344
- });
345
-
346
- test("gate failure blocks phase advancement", async () => {
347
- createState({ phase: "SCOPE" });
348
- const result = await advancePhase(TEST_SLUG);
349
- expect(result.gateResult).toBe("FAIL");
350
- // Phase should not have advanced (gate runner behavior)
351
- const state = readState();
352
- // State may still be SCOPE because the gate failed
353
- expect(["SCOPE", "BUILD"]).toContain(state.phase);
354
- });
355
- });
356
-
357
- // ── State consistency ────────────────────────────────────────────
358
-
359
- describe("state consistency", () => {
360
- test("updatedTs is set on phase advancement", async () => {
361
- createState({ phase: "GOAL" });
362
- const before = readState();
363
- await advancePhase(TEST_SLUG);
364
- const after = readState();
365
- expect(after.updatedTs).toBeTruthy();
366
- expect(after.updatedTs).not.toBe(before.updatedTs);
367
- });
368
-
369
- test("multiple advances maintain changelog order", async () => {
370
- createState({ phase: "GOAL", changelog: [] });
371
- await advancePhase(TEST_SLUG); // GOAL → DISCOVERY
372
- await advancePhase(TEST_SLUG); // DISCOVERY → SCOPE
373
- const state = readState();
374
- expect(state.changelog.length).toBe(2);
375
- expect(state.changelog[0].detail).toContain("GOAL");
376
- expect(state.changelog[1].detail).toContain("DISCOVERY");
377
- });
378
- });
379
- });