rungate 0.2.0 → 0.2.1

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 (164) hide show
  1. package/package.json +14 -3
  2. package/.claude/agents/aditi.md +0 -47
  3. package/.claude/agents/marcus.md +0 -50
  4. package/.claude/agents/quinn.md +0 -58
  5. package/.claude/agents/rook.md +0 -47
  6. package/.claude/agents/serena.md +0 -46
  7. package/.claude/rungate.json +0 -11
  8. package/.fallowrc.json +0 -28
  9. package/.github/copilot-instructions.md +0 -20
  10. package/.rungate/conformity-findings.json +0 -648
  11. package/AGENTS.md +0 -106
  12. package/CODE-MAP.md +0 -50
  13. package/HARNESS.md +0 -88
  14. package/bun.lock +0 -26
  15. package/bunfig.toml +0 -2
  16. package/config/brief-policies.json +0 -28
  17. package/config/ceremony-profiles.json +0 -212
  18. package/config/consumer-cascade-map.json +0 -24
  19. package/config/doc-cascade-map.json +0 -24
  20. package/config/eval.json +0 -84
  21. package/config/profiles/account-plan.yaml +0 -36
  22. package/config/profiles/campaign.yaml +0 -94
  23. package/config/prove-evidence.schema.json +0 -65
  24. package/config/spec-policies.json +0 -36
  25. package/config/workflow-schema.json +0 -281
  26. package/gates/SCHEMA-GUIDE.md +0 -121
  27. package/gates/ac-quality.test.ts +0 -106
  28. package/gates/adversarial.test.ts +0 -274
  29. package/gates/brief-assembler.test.ts +0 -429
  30. package/gates/brief-assembler.ts +0 -334
  31. package/gates/bunfig.toml +0 -2
  32. package/gates/chain.test.ts +0 -91
  33. package/gates/e2e-smoke.test.ts +0 -234
  34. package/gates/error-classifier.test.ts +0 -249
  35. package/gates/error-classifier.ts +0 -89
  36. package/gates/orchestrator.test.ts +0 -950
  37. package/gates/orchestrator.ts +0 -569
  38. package/gates/preload.ts +0 -77
  39. package/gates/prompts/ac-adversary.md +0 -20
  40. package/gates/prompts/evidence-validator.md +0 -22
  41. package/gates/prompts/prove-reproducer.md +0 -53
  42. package/gates/prove.test.ts +0 -164
  43. package/gates/run-gate.ts +0 -936
  44. package/gates/schema-parity.test.ts +0 -197
  45. package/gates/schema.ts +0 -362
  46. package/gates/self-heal.test.ts +0 -511
  47. package/gates/self-heal.ts +0 -121
  48. package/gates/ship-orchestrator.test.ts +0 -379
  49. package/gates/ship-orchestrator.ts +0 -363
  50. package/gates/test-fixtures/broken-no-environments.json +0 -60
  51. package/gates/test-fixtures/valid-standard.json +0 -54
  52. package/gates/test-utils.ts +0 -43
  53. package/gates/witness.ts +0 -220
  54. package/gates/workflow.test.ts +0 -1053
  55. package/hooks/AgentBriefGuard.hook.ts +0 -586
  56. package/hooks/AgentVerdictCapture.hook.ts +0 -134
  57. package/hooks/AutoVerifyGate.hook.ts +0 -76
  58. package/hooks/GateEnforcement.hook.ts +0 -273
  59. package/hooks/IssueCloseGuard.hook.ts +0 -116
  60. package/hooks/MergeGuard.hook.ts +0 -55
  61. package/hooks/StaleTTLCleanup.hook.ts +0 -133
  62. package/hooks/VerifyPhaseLock.hook.ts +0 -81
  63. package/hooks/WorkflowStateGuard.hook.ts +0 -37
  64. package/hooks/lib/agentDetection.ts +0 -70
  65. package/hooks/lib/findWorkflow.ts +0 -101
  66. package/hooks/lib/parseStdin.ts +0 -37
  67. package/hooks/lib/paths.ts +0 -111
  68. package/hooks/lib/utils.ts +0 -81
  69. package/reference/migration-manifest.json +0 -554
  70. package/reference/prompts/agent-aditi.md +0 -38
  71. package/reference/prompts/agent-marcus.md +0 -38
  72. package/reference/prompts/agent-quinn.md +0 -38
  73. package/reference/prompts/agent-rook.md +0 -37
  74. package/reference/prompts/agent-serena.md +0 -37
  75. package/reference/prompts/council-skill.md +0 -170
  76. package/reference/prompts/goal-skill.md +0 -235
  77. package/reference/prompts/prove-skill.md +0 -283
  78. package/reference/prompts/quinn-standard.md +0 -246
  79. package/reference/prompts/ship-convergence.md +0 -65
  80. package/reference/prompts/ship-escalation.md +0 -43
  81. package/reference/prompts/ship-iteration.md +0 -382
  82. package/reference/prompts/ship-pending-patches.md +0 -246
  83. package/reference/prompts/ship-reference.md +0 -250
  84. package/reference/prompts/ship-skill.md +0 -347
  85. package/reference/prompts/ship-templates.md +0 -215
  86. package/reference/scripts/batch-status.sh +0 -68
  87. package/reference/scripts/chain-compat-check.sh +0 -67
  88. package/reference/scripts/context-audit.sh +0 -314
  89. package/reference/scripts/dead-export-check.sh +0 -61
  90. package/reference/scripts/generate-qc-tables.sh +0 -92
  91. package/reference/scripts/harness-init.sh +0 -111
  92. package/reference/scripts/pai-054-baseline-check.sh +0 -40
  93. package/reference/scripts/prove-smoke-test.sh +0 -112
  94. package/reference/scripts/setup-keychain-salt.sh +0 -12
  95. package/reference/scripts/skill-optimizer-friday.sh +0 -88
  96. package/reference/scripts/skill-qc-test.sh +0 -351
  97. package/reference/scripts/skill-synthesize-tonight.sh +0 -66
  98. package/reference/specs/HARNESS-EXTRACTION-SPEC.md +0 -263
  99. package/reference/specs/harness-v3-bash-deletion-plan.md +0 -65
  100. package/reference/specs/harness-v3-migration-plan.md +0 -188
  101. package/scripts/decision-reconcile.sh +0 -74
  102. package/scripts/decision-reconcile.ts +0 -152
  103. package/scripts/git-hooks/pre-commit +0 -76
  104. package/scripts/git-hooks/pre-push +0 -271
  105. package/scripts/harness-skill-check.sh +0 -52
  106. package/scripts/lib/gap-emit.sh +0 -65
  107. package/scripts/lib/jq-update.sh +0 -30
  108. package/scripts/lib/resolve-slug.sh +0 -30
  109. package/scripts/lib/verify-spec-compliance.sh +0 -102
  110. package/scripts/prove-backfill.sh +0 -87
  111. package/scripts/scaffold-rungate-config.ts +0 -91
  112. package/scripts/self-containment-check.sh +0 -109
  113. package/scripts/skill-qc-validator.sh +0 -402
  114. package/scripts/slug-resolver.sh +0 -14
  115. package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +0 -2493
  116. package/specs/BOOTSTRAP-TEST-PLAN.md +0 -571
  117. package/specs/HARNESS-GATES.md +0 -256
  118. package/specs/HARNESS-SKILL-CHAIN.md +0 -286
  119. package/specs/HARNESS-SKILL-CONTRACT.md +0 -93
  120. package/specs/HARNESS-STANDARD.md +0 -488
  121. package/specs/SPEC-TEMPLATE.md +0 -53
  122. package/specs/bootstrap-data-flow.png +0 -0
  123. package/specs/harness-automation-matrix.md +0 -314
  124. package/specs/harness-automation-matrix.rules.json +0 -64
  125. package/test/anti.test.ts +0 -80
  126. package/test/contract-negative.test.ts +0 -86
  127. package/test/contract.test.ts +0 -158
  128. package/test/external-deps.test.ts +0 -48
  129. package/test/fixtures/golden-project/.env.example +0 -3
  130. package/test/fixtures/golden-project/Makefile +0 -7
  131. package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +0 -23
  132. package/test/fixtures/golden-project/docs/setup-guide.md +0 -10
  133. package/test/fixtures/golden-project/package.json +0 -10
  134. package/test/fixtures/golden-project/specs/api-spec.md +0 -20
  135. package/test/fixtures/golden-project/src/auth.ts +0 -8
  136. package/test/fixtures/golden-project/src/db.ts +0 -11
  137. package/test/fixtures/golden-project/src/index.ts +0 -19
  138. package/test/fixtures/golden-project/src/utils/format.ts +0 -3
  139. package/test/fixtures/golden-project/test/auth.test.ts +0 -15
  140. package/test/fixtures/golden-project/tsconfig.json +0 -12
  141. package/test/meta-sc-coverage.test.ts +0 -159
  142. package/test/phase-0.test.ts +0 -846
  143. package/test/phase-1.test.ts +0 -617
  144. package/test/phase-2.test.ts +0 -620
  145. package/test/phase-3.test.ts +0 -99
  146. package/test/scaffold-conformity.test.ts +0 -8
  147. package/test/schema-canary.test.ts +0 -51
  148. package/test/spec-compliance-auto.test.ts +0 -64
  149. package/test/spec-compliance.test.ts +0 -295
  150. package/test/spec-discovery.test.ts +0 -68
  151. package/test/spec-drift.test.ts +0 -5
  152. package/test/structure.test.ts +0 -165
  153. package/test/unit/agent-brief-guard-ship.test.ts +0 -293
  154. package/test/unit/extract-constraints.test.ts +0 -145
  155. package/test/unit/issue-close-guard.test.ts +0 -204
  156. package/test/unit/scaffold-project.test.ts +0 -417
  157. package/test/unit/skill-cooccurrence.test.ts +0 -177
  158. package/test/unit/skill-sequence-logger.test.ts +0 -244
  159. package/test/unit/workflow-state-guard.test.ts +0 -95
  160. package/workflows/batch-ship.js +0 -295
  161. package/workflows/council.js +0 -481
  162. package/workflows/prove.js +0 -560
  163. package/workflows/ship.js +0 -789
  164. 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
- });