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.
- package/bin/rungate.ts +70 -0
- package/lib/aes-calculator.ts +66 -0
- package/lib/agent-audit.ts +139 -0
- package/lib/agent-brief-validation.ts +359 -0
- package/lib/agents-md-refs.ts +90 -0
- package/lib/bash-file-read.ts +197 -0
- package/lib/behavioral-cache.ts +78 -0
- package/lib/branch-cleanup.ts +234 -0
- package/lib/brief-context-parser.ts +35 -0
- package/lib/canary.ts +117 -0
- package/lib/check-registry.ts +226 -0
- package/lib/ci-checkout.ts +400 -0
- package/lib/cli-commands.ts +137 -0
- package/lib/compliance-backfill.ts +220 -0
- package/lib/compliance-report.ts +504 -0
- package/lib/compliance.ts +361 -0
- package/lib/config-loader.ts +255 -0
- package/lib/conformity.ts +1818 -131
- package/lib/container-provenance.ts +230 -0
- package/lib/create-brief.ts +150 -0
- package/lib/create-sc.ts +272 -0
- package/lib/deep-merge.ts +69 -0
- package/lib/dev-liveness.ts +214 -0
- package/lib/directive-extractor.ts +210 -0
- package/lib/distribution-standing.ts +113 -0
- package/lib/doc-hygiene.ts +238 -0
- package/lib/eval-criteria.ts +6 -0
- package/lib/evidence-portability.ts +123 -0
- package/lib/evidence-prevalidator.ts +390 -0
- package/lib/evidence-required.ts +150 -0
- package/lib/evidence-satisfiability.ts +288 -0
- package/lib/frontmatter.ts +163 -0
- package/lib/gap-scanner.ts +348 -0
- package/lib/gate-enforcement.ts +366 -0
- package/lib/generators/agent-briefs.ts +136 -0
- package/lib/generators/agents-md.ts +506 -0
- package/lib/generators/code-map.ts +60 -0
- package/lib/generators/types.ts +184 -0
- package/lib/git-ref-normalizer.ts +107 -0
- package/lib/github.ts +539 -0
- package/lib/harness-identity.ts +63 -0
- package/lib/hill-climb.ts +164 -0
- package/lib/instruction-effectiveness.ts +131 -0
- package/lib/issue-closure-audit.ts +225 -0
- package/lib/issue-create-override.ts +343 -0
- package/lib/js-top-level-code.ts +250 -0
- package/lib/liveness-contradiction.ts +149 -0
- package/lib/organize.ts +505 -0
- package/lib/paths.ts +197 -6
- package/lib/post-fix-verify.ts +157 -0
- package/lib/prior-branch.ts +489 -0
- package/lib/project-state-shape.ts +166 -0
- package/lib/promote-outputs.ts +156 -0
- package/lib/prove-label-gate.ts +35 -0
- package/lib/reachability.ts +302 -0
- package/lib/release-preflight.ts +186 -0
- package/lib/rule-health-pipeline.ts +264 -0
- package/lib/rule-health-trend.ts +161 -0
- package/lib/rule-provenance.ts +149 -0
- package/lib/rule-registry.ts +128 -0
- package/lib/rungate-schema.ts +114 -4
- package/lib/sc-claim-forms.ts +179 -0
- package/lib/sc-cover.ts +150 -0
- package/lib/sc-guard.ts +157 -0
- package/lib/sc-ids.ts +344 -0
- package/lib/scaffold/defaults.ts +165 -0
- package/lib/scaffold/managed-workflow.ts +370 -0
- package/lib/scaffold/owned-files.ts +265 -0
- package/lib/scaffold/steps.ts +2680 -0
- package/lib/scanner.ts +701 -0
- package/lib/screenshot-upload.ts +73 -0
- package/lib/secret-patterns.ts +112 -0
- package/lib/security-verdict.ts +616 -0
- package/lib/signal-phrases.ts +1 -0
- package/lib/spec-change-conformity.ts +80 -0
- package/lib/spec-files.ts +62 -0
- package/lib/spec-registry.ts +133 -0
- package/lib/spec-updater.ts +96 -0
- package/lib/stale-cleanup.ts +224 -0
- package/lib/stale-issue-scanner.ts +36 -0
- package/lib/strip-js-comments.ts +269 -0
- package/lib/suite-measurement.ts +228 -0
- package/lib/task-completion-checks.ts +177 -0
- package/lib/test-suite-lock.ts +1136 -0
- package/lib/transcript-checker.ts +1140 -0
- package/lib/validators/spec-validators.ts +171 -0
- package/lib/verdict-capture.ts +73 -0
- package/lib/verified-push.ts +358 -0
- package/lib/workflow-security.ts +174 -0
- package/lib/worktree-cleanup.ts +250 -0
- package/lib/worktree-collect.ts +283 -0
- package/lib/worktree-isolation.ts +82 -0
- package/package.json +36 -3
- package/prompts/ac-adversary.md +14 -2
- package/prompts/aditi.md +5 -0
- package/prompts/blast-radius.md +5 -0
- package/prompts/container-verify.md +5 -0
- package/prompts/discovery.md +4 -0
- package/prompts/environment.md +5 -0
- package/prompts/evidence-hierarchy.md +5 -0
- package/prompts/evidence-validator.md +11 -0
- package/prompts/marcus.md +5 -0
- package/prompts/prevention.md +5 -0
- package/prompts/prove-reproducer.md +12 -0
- package/prompts/quinn-decision-tree.md +5 -0
- package/prompts/quinn-ui-brief.md +5 -0
- package/prompts/quinn.md +5 -0
- package/prompts/rca.md +5 -0
- package/prompts/read-before-write.md +4 -0
- package/prompts/regression.md +5 -0
- package/prompts/serena.md +5 -0
- package/scripts/audit-specs.ts +464 -0
- package/scripts/convert-spec.ts +293 -0
- package/scripts/create-sc.ts +92 -0
- package/scripts/create-spec.ts +166 -0
- package/scripts/extract-constraints.ts +4 -3
- package/scripts/generate-code-map.ts +1 -1
- package/scripts/scaffold-project.ts +138 -1426
- package/scripts/sync-spec-tests.ts +211 -126
- package/.claude/agents/aditi.md +0 -47
- package/.claude/agents/marcus.md +0 -50
- package/.claude/agents/quinn.md +0 -58
- package/.claude/agents/rook.md +0 -47
- package/.claude/agents/serena.md +0 -46
- package/.claude/rungate.json +0 -11
- package/.fallowrc.json +0 -28
- package/.github/copilot-instructions.md +0 -20
- package/.rungate/conformity-findings.json +0 -648
- package/AGENTS.md +0 -106
- package/CODE-MAP.md +0 -50
- package/HARNESS.md +0 -88
- package/bun.lock +0 -26
- package/bunfig.toml +0 -2
- package/config/brief-policies.json +0 -28
- package/config/ceremony-profiles.json +0 -212
- package/config/consumer-cascade-map.json +0 -24
- package/config/doc-cascade-map.json +0 -24
- package/config/eval.json +0 -84
- package/config/profiles/account-plan.yaml +0 -36
- package/config/profiles/campaign.yaml +0 -94
- package/config/prove-evidence.schema.json +0 -65
- package/config/spec-policies.json +0 -36
- package/config/workflow-schema.json +0 -281
- package/gates/SCHEMA-GUIDE.md +0 -121
- package/gates/ac-quality.test.ts +0 -106
- package/gates/adversarial.test.ts +0 -274
- package/gates/brief-assembler.test.ts +0 -429
- package/gates/brief-assembler.ts +0 -334
- package/gates/bunfig.toml +0 -2
- package/gates/chain.test.ts +0 -91
- package/gates/e2e-smoke.test.ts +0 -234
- package/gates/error-classifier.test.ts +0 -249
- package/gates/error-classifier.ts +0 -89
- package/gates/orchestrator.test.ts +0 -950
- package/gates/orchestrator.ts +0 -569
- package/gates/preload.ts +0 -77
- package/gates/prompts/ac-adversary.md +0 -20
- package/gates/prompts/evidence-validator.md +0 -22
- package/gates/prompts/prove-reproducer.md +0 -53
- package/gates/prove.test.ts +0 -164
- package/gates/run-gate.ts +0 -936
- package/gates/schema-parity.test.ts +0 -197
- package/gates/schema.ts +0 -362
- package/gates/self-heal.test.ts +0 -511
- package/gates/self-heal.ts +0 -121
- package/gates/ship-orchestrator.test.ts +0 -379
- package/gates/ship-orchestrator.ts +0 -363
- package/gates/test-fixtures/broken-no-environments.json +0 -60
- package/gates/test-fixtures/valid-standard.json +0 -54
- package/gates/test-utils.ts +0 -43
- package/gates/witness.ts +0 -220
- package/gates/workflow.test.ts +0 -1053
- package/hooks/AgentBriefGuard.hook.ts +0 -586
- package/hooks/AgentVerdictCapture.hook.ts +0 -134
- package/hooks/AutoVerifyGate.hook.ts +0 -76
- package/hooks/GateEnforcement.hook.ts +0 -273
- package/hooks/IssueCloseGuard.hook.ts +0 -116
- package/hooks/MergeGuard.hook.ts +0 -55
- package/hooks/StaleTTLCleanup.hook.ts +0 -133
- package/hooks/VerifyPhaseLock.hook.ts +0 -81
- package/hooks/WorkflowStateGuard.hook.ts +0 -37
- package/hooks/lib/agentDetection.ts +0 -70
- package/hooks/lib/findWorkflow.ts +0 -101
- package/hooks/lib/parseStdin.ts +0 -37
- package/hooks/lib/paths.ts +0 -111
- package/hooks/lib/utils.ts +0 -81
- package/reference/migration-manifest.json +0 -554
- package/reference/prompts/agent-aditi.md +0 -38
- package/reference/prompts/agent-marcus.md +0 -38
- package/reference/prompts/agent-quinn.md +0 -38
- package/reference/prompts/agent-rook.md +0 -37
- package/reference/prompts/agent-serena.md +0 -37
- package/reference/prompts/council-skill.md +0 -170
- package/reference/prompts/goal-skill.md +0 -235
- package/reference/prompts/prove-skill.md +0 -283
- package/reference/prompts/quinn-standard.md +0 -246
- package/reference/prompts/ship-convergence.md +0 -65
- package/reference/prompts/ship-escalation.md +0 -43
- package/reference/prompts/ship-iteration.md +0 -382
- package/reference/prompts/ship-pending-patches.md +0 -246
- package/reference/prompts/ship-reference.md +0 -250
- package/reference/prompts/ship-skill.md +0 -347
- package/reference/prompts/ship-templates.md +0 -215
- package/reference/scripts/batch-status.sh +0 -68
- package/reference/scripts/chain-compat-check.sh +0 -67
- package/reference/scripts/context-audit.sh +0 -314
- package/reference/scripts/dead-export-check.sh +0 -61
- package/reference/scripts/generate-qc-tables.sh +0 -92
- package/reference/scripts/harness-init.sh +0 -111
- package/reference/scripts/pai-054-baseline-check.sh +0 -40
- package/reference/scripts/prove-smoke-test.sh +0 -112
- package/reference/scripts/setup-keychain-salt.sh +0 -12
- package/reference/scripts/skill-optimizer-friday.sh +0 -88
- package/reference/scripts/skill-qc-test.sh +0 -351
- package/reference/scripts/skill-synthesize-tonight.sh +0 -66
- package/reference/specs/HARNESS-EXTRACTION-SPEC.md +0 -263
- package/reference/specs/harness-v3-bash-deletion-plan.md +0 -65
- package/reference/specs/harness-v3-migration-plan.md +0 -188
- package/scripts/decision-reconcile.sh +0 -74
- package/scripts/decision-reconcile.ts +0 -152
- package/scripts/git-hooks/pre-commit +0 -76
- package/scripts/git-hooks/pre-push +0 -271
- package/scripts/harness-skill-check.sh +0 -52
- package/scripts/lib/gap-emit.sh +0 -65
- package/scripts/lib/jq-update.sh +0 -30
- package/scripts/lib/resolve-slug.sh +0 -30
- package/scripts/lib/verify-spec-compliance.sh +0 -102
- package/scripts/prove-backfill.sh +0 -87
- package/scripts/scaffold-rungate-config.ts +0 -91
- package/scripts/self-containment-check.sh +0 -109
- package/scripts/skill-qc-validator.sh +0 -402
- package/scripts/slug-resolver.sh +0 -14
- package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +0 -2493
- package/specs/BOOTSTRAP-TEST-PLAN.md +0 -571
- package/specs/HARNESS-GATES.md +0 -256
- package/specs/HARNESS-SKILL-CHAIN.md +0 -286
- package/specs/HARNESS-SKILL-CONTRACT.md +0 -93
- package/specs/HARNESS-STANDARD.md +0 -488
- package/specs/SPEC-TEMPLATE.md +0 -53
- package/specs/bootstrap-data-flow.png +0 -0
- package/specs/harness-automation-matrix.md +0 -314
- package/specs/harness-automation-matrix.rules.json +0 -64
- package/test/anti.test.ts +0 -80
- package/test/contract-negative.test.ts +0 -86
- package/test/contract.test.ts +0 -158
- package/test/external-deps.test.ts +0 -48
- package/test/fixtures/golden-project/.env.example +0 -3
- package/test/fixtures/golden-project/Makefile +0 -7
- package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +0 -23
- package/test/fixtures/golden-project/docs/setup-guide.md +0 -10
- package/test/fixtures/golden-project/package.json +0 -10
- package/test/fixtures/golden-project/specs/api-spec.md +0 -20
- package/test/fixtures/golden-project/src/auth.ts +0 -8
- package/test/fixtures/golden-project/src/db.ts +0 -11
- package/test/fixtures/golden-project/src/index.ts +0 -19
- package/test/fixtures/golden-project/src/utils/format.ts +0 -3
- package/test/fixtures/golden-project/test/auth.test.ts +0 -15
- package/test/fixtures/golden-project/tsconfig.json +0 -12
- package/test/meta-sc-coverage.test.ts +0 -159
- package/test/phase-0.test.ts +0 -846
- package/test/phase-1.test.ts +0 -617
- package/test/phase-2.test.ts +0 -620
- package/test/phase-3.test.ts +0 -99
- package/test/scaffold-conformity.test.ts +0 -8
- package/test/schema-canary.test.ts +0 -51
- package/test/spec-compliance-auto.test.ts +0 -64
- package/test/spec-compliance.test.ts +0 -295
- package/test/spec-discovery.test.ts +0 -68
- package/test/spec-drift.test.ts +0 -5
- package/test/structure.test.ts +0 -165
- package/test/unit/agent-brief-guard-ship.test.ts +0 -293
- package/test/unit/extract-constraints.test.ts +0 -145
- package/test/unit/issue-close-guard.test.ts +0 -204
- package/test/unit/scaffold-project.test.ts +0 -417
- package/test/unit/skill-cooccurrence.test.ts +0 -177
- package/test/unit/skill-sequence-logger.test.ts +0 -244
- package/test/unit/workflow-state-guard.test.ts +0 -95
- package/workflows/batch-ship.js +0 -295
- package/workflows/council.js +0 -481
- package/workflows/prove.js +0 -560
- package/workflows/ship.js +0 -789
- 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
|
-
});
|