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,53 +0,0 @@
1
- ---
2
- doc-type: reference
3
- status: active
4
- owner: jason
5
- updated: 2026-09-19
6
- ---
7
-
8
- You are a prove reproducer. Your objective: reproduce the bug described
9
- in the issue, verify the fix works, and capture evidence.
10
-
11
- **Tool limitation:** You have Bash and Read tools only — no browser,
12
- no Playwright, no screenshot capability. For UI-related ACs (screenshots,
13
- visual elements, page navigation, OUTCOME-type criteria), output a SKIP
14
- verdict with reason "B3 limitation: no browser tools — requires Quinn".
15
- Focus your verification on CODE ACs that can be tested via command line
16
- (grep, bun test, bun -e, curl, file reads).
17
-
18
- 1. Read the issue body (provided). Identify the user's complaint and
19
- derive a test plan from the issue description.
20
- 2. Compare your test plan against the ACs provided. If the issue
21
- describes a bug the ACs don't test, flag the gap.
22
- 3. For API/data issues: call the endpoints described in the issue via
23
- curl, capture the response bodies as evidence.
24
- 4. For CODE issues: run evidence commands (grep, bun test, file reads)
25
- to verify the fix is present and correct.
26
- 5. For UI issues: output SKIP for those criteria — you cannot navigate
27
- pages or take screenshots. Note which ACs need Quinn verification.
28
- 6. Compare the before-state (provided) against the current after-state.
29
- The before state shows what was broken. The after state must show
30
- the fix working.
31
- 6b. For S-tier evidence (bug fixes): apply negative control — revert the
32
- fix temporarily, confirm the bug returns, then re-apply. This proves
33
- the fix is the actual cause of the improvement, not a coincidence.
34
- 7. For each criterion, capture real evidence — API responses, console
35
- output, grep results. Never claim UI verification without browser tools.
36
-
37
- Output JSON:
38
- {
39
- "verdict": "PROVEN|UNPROVEN|INCONCLUSIVE",
40
- "criteriaResults": [
41
- {"scId": "SC-1", "verdict": "PASS|FAIL", "evidence": "description of what was observed"}
42
- ],
43
- "reproduced": true|false,
44
- "evidence": [
45
- {"type": "screenshot|api-response|console", "description": "what this shows"}
46
- ],
47
- "gaps": []
48
- }
49
-
50
- Verdict rules:
51
- - PROVEN: bug was reproduced in before-state AND fix verified in after-state
52
- - UNPROVEN: fix does not resolve the issue (evidence shows problem persists)
53
- - INCONCLUSIVE: could not reproduce the bug or connect to dev server
@@ -1,164 +0,0 @@
1
- import { test, expect, describe } from "bun:test";
2
- import { readFileSync, existsSync, writeFileSync } from "fs";
3
- import { execSync } from "child_process";
4
-
5
- const TEST_DIR = process.env.TEST_WORK_DIR || "";
6
- const PROJECT_ROOT = process.env.PROJECT_ROOT || process.cwd();
7
- const GATE = process.env.GATE || "";
8
-
9
- function tryRead(filename: string) {
10
- const path = `${TEST_DIR}/${filename}`;
11
- if (!existsSync(path)) return null;
12
- return JSON.parse(readFileSync(path, "utf-8"));
13
- }
14
-
15
- function runEvidence(command: string): { exitCode: number; output: string } {
16
- try {
17
- const output = execSync(command, { cwd: PROJECT_ROOT, timeout: 30000, encoding: "utf-8" });
18
- return { exitCode: 0, output: output.trim() };
19
- } catch (e: any) {
20
- return { exitCode: e.status ?? 1, output: (e.stdout ?? "").trim() };
21
- }
22
- }
23
-
24
- function compareThreshold(actual: string, op: string, expected: string): boolean {
25
- if (op === "contains") return actual.includes(String(expected));
26
- if (op === "!contains") return !actual.includes(String(expected));
27
- if (op === "exists") return actual.length > 0;
28
- const num = parseFloat(actual);
29
- const exp = parseFloat(expected);
30
- if (isNaN(num) || isNaN(exp)) return actual === expected;
31
- switch (op) {
32
- case ">=": return num >= exp;
33
- case "<=": return num <= exp;
34
- case "==": return num === exp;
35
- case ">": return num > exp;
36
- case "<": return num < exp;
37
- case "!=": return num !== exp;
38
- default: return actual === expected;
39
- }
40
- }
41
-
42
- describe("prove: run evidence commands from workflow-state", () => {
43
- if (GATE && GATE !== "prove") {
44
- test("skipped — prove tests only run for prove/ship gates", () => {});
45
- return;
46
- }
47
- const wf = tryRead("workflow-state.json");
48
- if (!wf) {
49
- test("skipped — no active workflow (TEST_WORK_DIR not set or workflow-state.json missing)", () => {});
50
- return;
51
- }
52
-
53
- const commitSha = execSync("git rev-parse --short HEAD", { cwd: PROJECT_ROOT, encoding: "utf-8" }).trim();
54
- const ceremonyTier = wf.sizing?.ceremonyTier || "STANDARD";
55
- const proveEnvironment = ceremonyTier === "LIGHT" ? "local" : "prod";
56
- const criteriaResults: any[] = [];
57
-
58
- // B3 prove reproducer has Bash+Read only — no browser/screenshot capability.
59
- // OUTCOME-type ACs and UI-related evidence commands get SKIP, not FAIL (#486).
60
- const B3_UI_PATTERN = /screenshot|browser|playwright|visual|navigate|page\./i;
61
- const isB3UiAc = (ac: any): boolean => {
62
- if (ac.type === "OUTCOME") return true;
63
- const cmd = ac.evidenceMethod?.command || "";
64
- return B3_UI_PATTERN.test(cmd);
65
- };
66
-
67
- for (const ac of wf.acs) {
68
- test(`${ac.id}: ${ac.statement.slice(0, 80)}`, () => {
69
- // B3 exempt: OUTCOME/UI ACs cannot be verified without browser tools
70
- if (isB3UiAc(ac)) {
71
- criteriaResults.push({
72
- scId: ac.id,
73
- verdict: "SKIP",
74
- evidence: "B3 cannot verify UI — requires Quinn (#486)",
75
- });
76
- return;
77
- }
78
-
79
- const cmd = ac.evidenceMethod?.command;
80
- if (!cmd) {
81
- criteriaResults.push({ scId: ac.id, verdict: "SKIP", evidence: "no evidence command" });
82
- return;
83
- }
84
-
85
- const result = runEvidence(cmd);
86
- const lastLine = result.output.split("\n").pop() || "";
87
- const isTestRunner = /^bun test\b/.test(cmd);
88
-
89
- let verdict: string;
90
- let evidence: string;
91
-
92
- if (isTestRunner) {
93
- verdict = result.exitCode === 0 ? "PASS" : "FAIL";
94
- evidence = `${cmd} → exit ${result.exitCode} (test runner: exit code is verdict)`;
95
- } else if (ac.threshold && result.exitCode === 0) {
96
- const passed = compareThreshold(lastLine, ac.threshold.op, ac.threshold.value);
97
- verdict = passed ? "PASS" : "FAIL";
98
- evidence = `${cmd} → "${lastLine}" ${ac.threshold.op} ${ac.threshold.value} = ${passed}`;
99
- } else if (result.exitCode === 0) {
100
- verdict = "PASS";
101
- evidence = `${cmd} → exit 0`;
102
- } else {
103
- verdict = "FAIL";
104
- evidence = `${cmd} → exit ${result.exitCode}, output: "${lastLine}"`;
105
- }
106
-
107
- criteriaResults.push({ scId: ac.id, verdict, evidence });
108
-
109
- if (verdict === "FAIL") {
110
- expect(`${ac.id}: ${evidence}`).toBe("PASS");
111
- }
112
- });
113
- }
114
-
115
- test("write prove-evidence.json", () => {
116
- const fails = criteriaResults.filter(r => r.verdict === "FAIL");
117
- const verdict = criteriaResults.length === 0 ? "INCONCLUSIVE"
118
- : fails.length > 0 ? "UNPROVEN" : "PROVEN";
119
-
120
- const evidence = {
121
- issueNumber: wf.issue,
122
- verdict,
123
- commitSHA: commitSha,
124
- capturedAt: new Date().toISOString(),
125
- beforeEvidence: wf.beforeState ?? {
126
- type: "none", path: null,
127
- capturedAt: new Date().toISOString(),
128
- description: "no before-state captured",
129
- },
130
- afterEvidence: {
131
- type: "text", path: null,
132
- capturedAt: new Date().toISOString(),
133
- environment: proveEnvironment,
134
- description: criteriaResults.map(r => `${r.scId}: ${r.verdict}`).join(", "),
135
- },
136
- comparisonSummary: `${criteriaResults.filter(r => r.verdict === "PASS").length}/${criteriaResults.length} criteria passed`,
137
- reproduced: true,
138
- gaps: fails.map(f => ({ ac: f.scId, status: "UNPROVEN", detail: f.evidence })),
139
- criteriaResults,
140
- };
141
-
142
- writeFileSync(`${TEST_DIR}/prove-evidence.json`, JSON.stringify(evidence, null, 2));
143
- expect(verdict).toBe("PROVEN");
144
- });
145
-
146
- test("prod environment enforcement: STANDARD+ requires prod evidence (#294, ported to Bun in #484)", () => {
147
- if (ceremonyTier === "LIGHT") {
148
- // LIGHT tier is exempt from prod enforcement — API check only
149
- return;
150
- }
151
-
152
- // For STANDARD and THOROUGH tiers, afterEvidence.environment must be "prod"
153
- const evidencePath = `${TEST_DIR}/prove-evidence.json`;
154
- if (!existsSync(evidencePath)) {
155
- expect("prove-evidence.json").toBe("must exist before prod enforcement check");
156
- return;
157
- }
158
-
159
- const proveEvidence = JSON.parse(readFileSync(evidencePath, "utf-8"));
160
- const env = proveEvidence.afterEvidence?.environment;
161
-
162
- expect(env).toBe("prod");
163
- });
164
- });