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,363 +0,0 @@
1
- #!/usr/bin/env bun
2
- import { readFileSync, writeFileSync, existsSync } from "fs";
3
- import { join } from "path";
4
- import { execFileSync } from "child_process";
5
-
6
- export const MAX_ITERATIONS = 3;
7
-
8
- function workDirBase(): string {
9
- return process.env.RUNGATE_WORK_DIR || join(process.env.HOME || "", ".rungate");
10
- }
11
- const GATES_DIR = __dirname;
12
-
13
- export type GateName = "scope" | "verify" | "ship";
14
-
15
- const PHASE_GATE: Record<string, GateName> = {
16
- SCOPE: "scope",
17
- BUILD: "verify",
18
- SHIP: "ship",
19
- };
20
-
21
- const DIRECT_ADVANCE: Record<string, string> = {
22
- GOAL: "DISCOVERY",
23
- DISCOVERY: "SCOPE",
24
- VERIFY: "SHIP",
25
- };
26
-
27
- const GATE_TARGET: Record<string, string> = {
28
- scope: "BUILD",
29
- verify: "SHIP",
30
- ship: "DONE",
31
- };
32
-
33
- export interface AdvanceResult {
34
- phase: string;
35
- gateResult: "PASS" | "FAIL" | "SKIPPED";
36
- failures?: string[];
37
- iteration?: number;
38
- circuitBreaker?: boolean;
39
- }
40
-
41
- function statePath(slug: string): string {
42
- return join(workDirBase(), slug, "workflow-state.json");
43
- }
44
-
45
- function readState(slug: string): Record<string, any> {
46
- const sf = statePath(slug);
47
- if (!existsSync(sf)) {
48
- throw new Error(`workflow-state.json not found: ${sf}`);
49
- }
50
- return JSON.parse(readFileSync(sf, "utf-8"));
51
- }
52
-
53
- function writeStateFile(slug: string, state: Record<string, any>): void {
54
- const sf = statePath(slug);
55
- writeFileSync(sf, JSON.stringify(state, null, 2));
56
- }
57
-
58
- function isoNow(): string {
59
- return new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
60
- }
61
-
62
- export async function currentState(slug: string): Promise<Record<string, any>> {
63
- return readState(slug);
64
- }
65
-
66
- export function getIterationCount(slug: string): number {
67
- const state = readState(slug);
68
- return (state.changelog || []).filter(
69
- (e: any) => e.event === "iteration-loopback",
70
- ).length;
71
- }
72
-
73
- export function isCircuitBroken(slug: string): boolean {
74
- const state = readState(slug);
75
- if (state.phase === "CIRCUIT_BREAK") return true;
76
- return getIterationCount(slug) >= MAX_ITERATIONS;
77
- }
78
-
79
- export function getRequiredGate(phase: string): GateName | null {
80
- return PHASE_GATE[phase] || null;
81
- }
82
-
83
- export function validatePhaseTransition(from: string, to: string): boolean {
84
- if (from === "DONE" || from === "CIRCUIT_BREAK") return false;
85
-
86
- const gate = PHASE_GATE[from];
87
- if (gate) {
88
- return GATE_TARGET[gate] === to;
89
- }
90
-
91
- return DIRECT_ADVANCE[from] === to;
92
- }
93
-
94
- type GateExecutor = (gate: GateName, slug: string, issue: number) => void;
95
-
96
- let _gateExecutor: GateExecutor | null = null;
97
-
98
- export function setGateExecutor(executor: GateExecutor | null): void {
99
- _gateExecutor = executor;
100
- }
101
-
102
- function defaultGateExecutor(gate: GateName, slug: string, issue: number): void {
103
- execFileSync(
104
- "bun",
105
- ["run", join(GATES_DIR, "run-gate.ts"), "--gate", gate, "--slug", slug, "--issue", String(issue)],
106
- {
107
- encoding: "utf-8",
108
- timeout: 180000,
109
- cwd: join(process.env.HOME || "", ".claude"),
110
- env: { ...process.env, TEST_WORK_DIR: join(workDirBase(), slug) },
111
- },
112
- );
113
- }
114
-
115
- export async function runGate(slug: string, gate: GateName): Promise<AdvanceResult> {
116
- const state = readState(slug);
117
- const currentPhase = state.phase;
118
-
119
- const expectedGate = getRequiredGate(currentPhase);
120
- if (expectedGate !== gate) {
121
- throw new Error(
122
- `Cannot run ${gate} gate from phase ${currentPhase} — ` +
123
- (expectedGate ? `expected ${expectedGate}` : "no gate required"),
124
- );
125
- }
126
-
127
- if (isCircuitBroken(slug)) {
128
- return {
129
- phase: "CIRCUIT_BREAK",
130
- gateResult: "FAIL",
131
- failures: ["Circuit breaker: maximum iterations reached"],
132
- circuitBreaker: true,
133
- };
134
- }
135
-
136
- const issue = state.issue || 0;
137
- const executor = _gateExecutor || defaultGateExecutor;
138
-
139
- try {
140
- executor(gate, slug, issue);
141
- } catch {
142
- // gate failure — result read from workflow-state.json below
143
- }
144
-
145
- const updatedState = readState(slug);
146
- const gateResult: "PASS" | "FAIL" = updatedState.gates?.[gate]?.result || "FAIL";
147
- const failures = (updatedState.gates?.[gate]?.failures || [])
148
- .map((f: any) => f.check || f.detail || JSON.stringify(f));
149
- const iteration = updatedState.gates?.[gate]?.attempt || 1;
150
-
151
- return {
152
- phase: updatedState.phase,
153
- gateResult,
154
- failures: gateResult === "FAIL" ? failures : undefined,
155
- iteration,
156
- circuitBreaker: updatedState.phase === "CIRCUIT_BREAK",
157
- };
158
- }
159
-
160
- export async function advancePhase(slug: string): Promise<AdvanceResult> {
161
- const state = readState(slug);
162
- const currentPhase = state.phase;
163
-
164
- if (currentPhase === "DONE" || currentPhase === "CIRCUIT_BREAK") {
165
- return { phase: currentPhase, gateResult: "SKIPPED" };
166
- }
167
-
168
- const gate = getRequiredGate(currentPhase);
169
-
170
- if (gate) {
171
- return runGate(slug, gate);
172
- }
173
-
174
- const nextPhase = DIRECT_ADVANCE[currentPhase];
175
- if (!nextPhase) {
176
- throw new Error(`No transition defined for phase: ${currentPhase}`);
177
- }
178
-
179
- const ts = isoNow();
180
- state.phase = nextPhase;
181
- state.updatedTs = ts;
182
- state.changelog = state.changelog || [];
183
- state.changelog.push({
184
- ts,
185
- event: "phase-advance",
186
- detail: `${currentPhase} → ${nextPhase}`,
187
- actor: "gate-runner",
188
- });
189
-
190
- state.phaseTimings = state.phaseTimings || {};
191
- const currentTimings = state.phaseTimings[currentPhase] || [];
192
- if (currentTimings.length > 0) {
193
- currentTimings[currentTimings.length - 1].exitedTs = ts;
194
- }
195
- state.phaseTimings[currentPhase] = currentTimings;
196
- state.phaseTimings[nextPhase] = (state.phaseTimings[nextPhase] || []).concat([
197
- { enteredTs: ts, source: "gate-runner" },
198
- ]);
199
-
200
- writeStateFile(slug, state);
201
-
202
- return { phase: nextPhase, gateResult: "SKIPPED" };
203
- }
204
-
205
- // ── Slug management ────────────────────────────────────────────────
206
-
207
- export function slugExists(issue: number): string | null {
208
- const base = workDirBase();
209
- if (!existsSync(base)) return null;
210
- const { readdirSync } = require("fs");
211
- for (const dir of readdirSync(base)) {
212
- const sf = join(base, dir, "workflow-state.json");
213
- if (existsSync(sf)) {
214
- try {
215
- const state = JSON.parse(readFileSync(sf, "utf-8"));
216
- if (state.issue === issue) return dir;
217
- } catch {}
218
- }
219
- }
220
- return null;
221
- }
222
-
223
- // ── Container rebuild (null check) ─────────────────────────────────
224
-
225
- export function shouldRebuildContainer(projectRoot: string): boolean {
226
- const configPath = join(projectRoot, ".claude", "rungate.json");
227
- if (!existsSync(configPath)) return false;
228
- const config = JSON.parse(readFileSync(configPath, "utf-8"));
229
- return config.prod?.rebuild != null;
230
- }
231
-
232
- // ── Post-verify scaffold refresh ───────────────────────────────────
233
-
234
- export function shouldRefreshScaffold(slug: string): boolean {
235
- const state = readState(slug);
236
- return state.phase === "SHIP" && state.gates?.verify?.result === "PASS";
237
- }
238
-
239
- // ── Worktree support ───────────────────────────────────────────────
240
-
241
- export function worktreeBranchName(issue: number, slug: string): string {
242
- return `issue-${issue}-${slug}`;
243
- }
244
-
245
- export function checkPortCollision(basePort: number, offset: number, activePorts: number[]): boolean {
246
- const targetPort = basePort + offset;
247
- return activePorts.includes(targetPort);
248
- }
249
-
250
- // ── Pre-existing failure tracking ──────────────────────────────────
251
-
252
- export function trackPreExistingFailures(slug: string, failures: string[]): void {
253
- const state = readState(slug);
254
- state.preExistingFailures = state.preExistingFailures || [];
255
- for (const f of failures) {
256
- if (!state.preExistingFailures.includes(f)) {
257
- state.preExistingFailures.push(f);
258
- }
259
- }
260
- writeStateFile(slug, state);
261
- }
262
-
263
- // ── Lock management ────────────────────────────────────────────────
264
-
265
- export function releaseLock(slug: string): void {
266
- const lockPath = join(workDirBase(), slug, ".lock");
267
- if (existsSync(lockPath)) {
268
- const { unlinkSync } = require("fs");
269
- unlinkSync(lockPath);
270
- }
271
- const state = readState(slug);
272
- state.changelog = state.changelog || [];
273
- state.changelog.push({ ts: isoNow(), event: "lock-released", detail: "cleanup after test completion", actor: "gate-runner" });
274
- writeStateFile(slug, state);
275
- }
276
-
277
- // ── File-set overlap detection ─────────────────────────────────────
278
-
279
- export function detectFileSetOverlap(filesA: string[], filesB: string[]): string[] {
280
- const setA = new Set(filesA);
281
- return filesB.filter(f => setA.has(f));
282
- }
283
-
284
- // ── Sequential merge protocol ──────────────────────────────────────
285
-
286
- export interface MergeQueueEntry {
287
- slug: string;
288
- issue: number;
289
- branch: string;
290
- readyAt: string;
291
- }
292
-
293
- export function sequentialMergeOrder(entries: MergeQueueEntry[]): MergeQueueEntry[] {
294
- return entries.sort((a, b) => a.readyAt.localeCompare(b.readyAt));
295
- }
296
-
297
- export function shouldRunCIVerification(entry: MergeQueueEntry): boolean {
298
- return true;
299
- }
300
-
301
- // ── Research escalation ────────────────────────────────────────────
302
-
303
- export function requiresResearchEscalation(slug: string): boolean {
304
- const iteration = getIterationCount(slug);
305
- return iteration >= 2;
306
- }
307
-
308
- // ── CLI ──────────────────────────────────────────────────────────────
309
-
310
- if (import.meta.main) {
311
- const args = process.argv.slice(2);
312
- let slug = "";
313
- let action = "";
314
- let gate = "";
315
-
316
- for (let i = 0; i < args.length; i++) {
317
- if (args[i] === "--slug" && args[i + 1]) slug = args[++i];
318
- if (args[i] === "--action" && args[i + 1]) action = args[++i];
319
- if (args[i] === "--gate" && args[i + 1]) gate = args[++i];
320
- }
321
-
322
- if (!slug) {
323
- console.error("Usage: bun run gates/ship-orchestrator.ts --slug SLUG --action advance|status|gate [--gate scope|verify|ship]");
324
- process.exit(1);
325
- }
326
-
327
- if (!action || !["advance", "status", "gate"].includes(action)) {
328
- console.error("--action must be one of: advance, status, gate");
329
- process.exit(1);
330
- }
331
-
332
- try {
333
- if (action === "status") {
334
- const state = await currentState(slug);
335
- console.log(JSON.stringify({
336
- phase: state.phase,
337
- issue: state.issue,
338
- slug: state.slug,
339
- iteration: getIterationCount(slug),
340
- circuitBroken: isCircuitBroken(slug),
341
- gates: state.gates,
342
- }, null, 2));
343
- } else if (action === "advance") {
344
- const result = await advancePhase(slug);
345
- console.log(JSON.stringify(result, null, 2));
346
- if (result.gateResult === "FAIL") process.exit(1);
347
- if (result.circuitBreaker) process.exit(2);
348
- } else if (action === "gate") {
349
- const validGates = Object.values(PHASE_GATE);
350
- if (!gate || !validGates.includes(gate as GateName)) {
351
- console.error("--gate must be one of: scope, verify, ship");
352
- process.exit(1);
353
- }
354
- const result = await runGate(slug, gate as GateName);
355
- console.log(JSON.stringify(result, null, 2));
356
- if (result.gateResult === "FAIL") process.exit(1);
357
- if (result.circuitBreaker) process.exit(2);
358
- }
359
- } catch (e: any) {
360
- console.error(`ERROR: ${e.message}`);
361
- process.exit(1);
362
- }
363
- }
@@ -1,60 +0,0 @@
1
- {
2
- "schemaVersion": 2,
3
- "issue": 9998,
4
- "repo": "hornjason/asaCommandCenter",
5
- "issueRepo": "hornjason/asaCommandCenter",
6
- "projectRoot": "/Users/jhorn/Projects/DailyBriefDashboard",
7
- "slug": "test-broken",
8
- "phase": "DONE",
9
- "issueGoal": "Test fixture with missing environments",
10
- "sizing": { "predicted": "S", "ceremonyTier": "STANDARD" },
11
- "acs": [
12
- {
13
- "id": "AC-1",
14
- "type": "CODE",
15
- "statement": "Fix applied to campaign quality gate",
16
- "threshold": { "op": "contains", "value": "email-subject" },
17
- "evidenceMethod": { "type": "grep", "command": "grep email-subject src/lib/campaign-quality.ts" },
18
- "evidence": { "type": "command-output", "content": "email-subject" },
19
- "verdict": "PASS"
20
- },
21
- {
22
- "id": "AC-2",
23
- "type": "CODE",
24
- "statement": "Quality gate logs input mode",
25
- "threshold": { "op": "contains", "value": "inputMode" },
26
- "evidenceMethod": { "type": "grep", "command": "grep inputMode src/campaign-service.ts" },
27
- "evidence": { "type": "command-output", "content": "inputMode" },
28
- "verdict": "PASS"
29
- },
30
- {
31
- "id": "AC-3",
32
- "type": "CODE",
33
- "statement": "Regression tests pass",
34
- "threshold": { "op": ">=", "value": 1 },
35
- "evidenceMethod": { "type": "grep", "command": "grep email-subject test/unit/campaign-quality-gate.test.ts" },
36
- "evidence": { "type": "command-output", "content": "1" },
37
- "verdict": "PASS"
38
- },
39
- {
40
- "id": "AC-A1",
41
- "type": "CODE",
42
- "statement": "Other modes unaffected",
43
- "threshold": { "op": ">=", "value": 1 },
44
- "evidenceMethod": { "type": "grep", "command": "grep BLOCKED test/unit/campaign-quality-gate.test.ts" },
45
- "evidence": { "type": "command-output", "content": "1" },
46
- "verdict": "PASS"
47
- }
48
- ],
49
- "gates": {
50
- "scope": { "result": "PASS", "attempt": 1, "failures": [] },
51
- "verify": { "result": "PASS", "attempt": 1, "failures": [] }
52
- },
53
- "environments": {},
54
- "agents": {
55
- "marcus": { "spawned": true, "verdict": "PASS" }
56
- },
57
- "buildCommit": "abc1234",
58
- "changelog": [],
59
- "bootstrappedFrom": "ship-workflow"
60
- }
@@ -1,54 +0,0 @@
1
- {
2
- "schemaVersion": 2,
3
- "issue": 9999,
4
- "repo": "hornjason/asaCommandCenter",
5
- "issueRepo": "hornjason/asaCommandCenter",
6
- "projectRoot": "/Users/jhorn/Projects/DailyBriefDashboard",
7
- "slug": "test-canary",
8
- "phase": "DONE",
9
- "issueGoal": "Test canary issue for harness validation",
10
- "sizing": { "predicted": "XS", "ceremonyTier": "LIGHT" },
11
- "acs": [
12
- {
13
- "id": "AC-1",
14
- "type": "CODE",
15
- "statement": "Test file contains canary comment marker",
16
- "threshold": { "op": "contains", "value": "CANARY_MARKER" },
17
- "evidenceMethod": { "type": "grep", "command": "grep -c CANARY_MARKER test/unit/canary.test.ts" },
18
- "evidence": { "type": "command-output", "content": "1" },
19
- "verdict": "PASS"
20
- },
21
- {
22
- "id": "AC-2",
23
- "type": "CODE",
24
- "statement": "Unit tests pass including canary test",
25
- "threshold": { "op": ">=", "value": 1, "unit": "passing tests" },
26
- "evidenceMethod": { "type": "BUN_TEST", "command": "bun test test/unit/canary.test.ts" },
27
- "evidence": { "type": "command-output", "content": "1 pass, 0 fail" },
28
- "verdict": "PASS"
29
- }
30
- ],
31
- "gates": {
32
- "scope": { "result": "PASS", "attempt": 1, "failures": [] },
33
- "verify": { "result": "PASS", "attempt": 1, "failures": [] }
34
- },
35
- "environments": {
36
- "local": {
37
- "api": "200",
38
- "ui": "200",
39
- "tests": "24 pass, 0 fail"
40
- },
41
- "prod": {
42
- "rebuild": "SKIP",
43
- "smoke": "SKIP",
44
- "quinn": "SKIP"
45
- }
46
- },
47
- "agents": {
48
- "marcus": { "spawned": true, "verdict": "PASS", "branch": "9999-fix", "commitSha": "abc1234" },
49
- "quinn": { "spawned": false }
50
- },
51
- "buildCommit": "abc1234",
52
- "changelog": [],
53
- "bootstrappedFrom": "ship-workflow"
54
- }
@@ -1,43 +0,0 @@
1
- /**
2
- * Shared test utilities for gate test files.
3
- *
4
- * Provides safe accessors for workflow-state.json with graceful
5
- * error handling when no active workflow is present (standalone runs).
6
- */
7
- import { readFileSync, existsSync } from "fs";
8
-
9
- /**
10
- * Whether the test suite is running in standalone mode (no active workflow).
11
- * When true, tests that depend on workflow-state.json should skip.
12
- */
13
- export const STANDALONE = !process.env.TEST_WORK_DIR;
14
-
15
- /**
16
- * Safely read and parse a JSON file. Returns null on ENOENT or parse error.
17
- */
18
- export function safeReadJson(path: string): any | null {
19
- if (!existsSync(path)) return null;
20
- try {
21
- return JSON.parse(readFileSync(path, "utf-8"));
22
- } catch {
23
- return null;
24
- }
25
- }
26
-
27
- /**
28
- * Create a safe workflow-state accessor for a given file path.
29
- * Returns undefined for any path if the file doesn't exist.
30
- */
31
- export function createSf(statePath: string): (path: string) => any {
32
- return (path: string): any => {
33
- const raw = safeReadJson(statePath);
34
- if (!raw) return undefined;
35
- const parts = path.replace(/^\./, "").split(".").filter(Boolean);
36
- let val: any = raw;
37
- for (const p of parts) {
38
- if (val == null) return undefined;
39
- val = val[p];
40
- }
41
- return val;
42
- };
43
- }