rungate 0.2.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 (196) hide show
  1. package/.claude/agents/aditi.md +47 -0
  2. package/.claude/agents/marcus.md +50 -0
  3. package/.claude/agents/quinn.md +58 -0
  4. package/.claude/agents/rook.md +47 -0
  5. package/.claude/agents/serena.md +46 -0
  6. package/.claude/rungate.json +11 -0
  7. package/.fallowrc.json +28 -0
  8. package/.github/copilot-instructions.md +20 -0
  9. package/.rungate/conformity-findings.json +648 -0
  10. package/AGENTS.md +106 -0
  11. package/CODE-MAP.md +50 -0
  12. package/HARNESS.md +88 -0
  13. package/bun.lock +26 -0
  14. package/bunfig.toml +2 -0
  15. package/config/brief-policies.json +28 -0
  16. package/config/ceremony-profiles.json +212 -0
  17. package/config/consumer-cascade-map.json +24 -0
  18. package/config/doc-cascade-map.json +24 -0
  19. package/config/eval.json +84 -0
  20. package/config/profiles/account-plan.yaml +36 -0
  21. package/config/profiles/campaign.yaml +94 -0
  22. package/config/prove-evidence.schema.json +65 -0
  23. package/config/spec-policies.json +36 -0
  24. package/config/workflow-schema.json +281 -0
  25. package/gates/SCHEMA-GUIDE.md +121 -0
  26. package/gates/ac-quality.test.ts +106 -0
  27. package/gates/adversarial.test.ts +274 -0
  28. package/gates/brief-assembler.test.ts +429 -0
  29. package/gates/brief-assembler.ts +334 -0
  30. package/gates/bunfig.toml +2 -0
  31. package/gates/chain.test.ts +91 -0
  32. package/gates/e2e-smoke.test.ts +234 -0
  33. package/gates/error-classifier.test.ts +249 -0
  34. package/gates/error-classifier.ts +89 -0
  35. package/gates/orchestrator.test.ts +950 -0
  36. package/gates/orchestrator.ts +569 -0
  37. package/gates/preload.ts +77 -0
  38. package/gates/prompts/ac-adversary.md +20 -0
  39. package/gates/prompts/evidence-validator.md +22 -0
  40. package/gates/prompts/prove-reproducer.md +53 -0
  41. package/gates/prove.test.ts +164 -0
  42. package/gates/run-gate.ts +936 -0
  43. package/gates/schema-parity.test.ts +197 -0
  44. package/gates/schema.ts +362 -0
  45. package/gates/self-heal.test.ts +511 -0
  46. package/gates/self-heal.ts +121 -0
  47. package/gates/ship-orchestrator.test.ts +379 -0
  48. package/gates/ship-orchestrator.ts +363 -0
  49. package/gates/test-fixtures/broken-no-environments.json +60 -0
  50. package/gates/test-fixtures/valid-standard.json +54 -0
  51. package/gates/test-utils.ts +43 -0
  52. package/gates/witness.ts +220 -0
  53. package/gates/workflow.test.ts +1053 -0
  54. package/hooks/AgentBriefGuard.hook.ts +586 -0
  55. package/hooks/AgentVerdictCapture.hook.ts +134 -0
  56. package/hooks/AutoVerifyGate.hook.ts +76 -0
  57. package/hooks/GateEnforcement.hook.ts +273 -0
  58. package/hooks/IssueCloseGuard.hook.ts +116 -0
  59. package/hooks/MergeGuard.hook.ts +55 -0
  60. package/hooks/StaleTTLCleanup.hook.ts +133 -0
  61. package/hooks/VerifyPhaseLock.hook.ts +81 -0
  62. package/hooks/WorkflowStateGuard.hook.ts +37 -0
  63. package/hooks/lib/agentDetection.ts +70 -0
  64. package/hooks/lib/findWorkflow.ts +101 -0
  65. package/hooks/lib/parseStdin.ts +37 -0
  66. package/hooks/lib/paths.ts +111 -0
  67. package/hooks/lib/utils.ts +81 -0
  68. package/lib/conformity.ts +959 -0
  69. package/lib/paths.ts +23 -0
  70. package/lib/rungate-schema.ts +60 -0
  71. package/lib/signal-phrases.ts +7 -0
  72. package/package.json +20 -0
  73. package/prompts/ac-adversary.md +20 -0
  74. package/prompts/ac-format.md +34 -0
  75. package/prompts/aditi.md +29 -0
  76. package/prompts/blast-radius.md +29 -0
  77. package/prompts/coding-principles.md +34 -0
  78. package/prompts/container-rebuild.md +29 -0
  79. package/prompts/container-verify.md +28 -0
  80. package/prompts/discovery.md +27 -0
  81. package/prompts/environment.md +28 -0
  82. package/prompts/escalation-decision-tree.md +38 -0
  83. package/prompts/evidence-hierarchy.md +31 -0
  84. package/prompts/evidence-validator.md +22 -0
  85. package/prompts/marcus.md +29 -0
  86. package/prompts/prevention.md +26 -0
  87. package/prompts/prove-reproducer.md +43 -0
  88. package/prompts/quinn-decision-tree.md +31 -0
  89. package/prompts/quinn-ui-brief.md +106 -0
  90. package/prompts/quinn.md +29 -0
  91. package/prompts/rca.md +28 -0
  92. package/prompts/read-before-write.md +30 -0
  93. package/prompts/regression.md +26 -0
  94. package/prompts/rook.md +29 -0
  95. package/prompts/serena.md +28 -0
  96. package/prompts/testing-strategy.md +34 -0
  97. package/reference/migration-manifest.json +554 -0
  98. package/reference/prompts/agent-aditi.md +38 -0
  99. package/reference/prompts/agent-marcus.md +38 -0
  100. package/reference/prompts/agent-quinn.md +38 -0
  101. package/reference/prompts/agent-rook.md +37 -0
  102. package/reference/prompts/agent-serena.md +37 -0
  103. package/reference/prompts/council-skill.md +170 -0
  104. package/reference/prompts/goal-skill.md +235 -0
  105. package/reference/prompts/prove-skill.md +283 -0
  106. package/reference/prompts/quinn-standard.md +246 -0
  107. package/reference/prompts/ship-convergence.md +65 -0
  108. package/reference/prompts/ship-escalation.md +43 -0
  109. package/reference/prompts/ship-iteration.md +382 -0
  110. package/reference/prompts/ship-pending-patches.md +246 -0
  111. package/reference/prompts/ship-reference.md +250 -0
  112. package/reference/prompts/ship-skill.md +347 -0
  113. package/reference/prompts/ship-templates.md +215 -0
  114. package/reference/scripts/batch-status.sh +68 -0
  115. package/reference/scripts/chain-compat-check.sh +67 -0
  116. package/reference/scripts/context-audit.sh +314 -0
  117. package/reference/scripts/dead-export-check.sh +61 -0
  118. package/reference/scripts/generate-qc-tables.sh +92 -0
  119. package/reference/scripts/harness-init.sh +111 -0
  120. package/reference/scripts/pai-054-baseline-check.sh +40 -0
  121. package/reference/scripts/prove-smoke-test.sh +112 -0
  122. package/reference/scripts/setup-keychain-salt.sh +12 -0
  123. package/reference/scripts/skill-optimizer-friday.sh +88 -0
  124. package/reference/scripts/skill-qc-test.sh +351 -0
  125. package/reference/scripts/skill-synthesize-tonight.sh +66 -0
  126. package/reference/specs/HARNESS-EXTRACTION-SPEC.md +263 -0
  127. package/reference/specs/harness-v3-bash-deletion-plan.md +65 -0
  128. package/reference/specs/harness-v3-migration-plan.md +188 -0
  129. package/scripts/decision-reconcile.sh +74 -0
  130. package/scripts/decision-reconcile.ts +152 -0
  131. package/scripts/extract-constraints.ts +260 -0
  132. package/scripts/generate-code-map.ts +339 -0
  133. package/scripts/git-hooks/pre-commit +76 -0
  134. package/scripts/git-hooks/pre-push +271 -0
  135. package/scripts/harness-skill-check.sh +52 -0
  136. package/scripts/lib/gap-emit.sh +65 -0
  137. package/scripts/lib/jq-update.sh +30 -0
  138. package/scripts/lib/resolve-slug.sh +30 -0
  139. package/scripts/lib/verify-spec-compliance.sh +102 -0
  140. package/scripts/prove-backfill.sh +87 -0
  141. package/scripts/scaffold-project.ts +1488 -0
  142. package/scripts/scaffold-rungate-config.ts +91 -0
  143. package/scripts/self-containment-check.sh +109 -0
  144. package/scripts/skill-qc-validator.sh +402 -0
  145. package/scripts/slug-resolver.sh +14 -0
  146. package/scripts/sync-spec-tests.ts +236 -0
  147. package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +2493 -0
  148. package/specs/BOOTSTRAP-TEST-PLAN.md +571 -0
  149. package/specs/HARNESS-GATES.md +256 -0
  150. package/specs/HARNESS-SKILL-CHAIN.md +286 -0
  151. package/specs/HARNESS-SKILL-CONTRACT.md +93 -0
  152. package/specs/HARNESS-STANDARD.md +488 -0
  153. package/specs/SPEC-TEMPLATE.md +53 -0
  154. package/specs/bootstrap-data-flow.png +0 -0
  155. package/specs/harness-automation-matrix.md +314 -0
  156. package/specs/harness-automation-matrix.rules.json +64 -0
  157. package/test/anti.test.ts +80 -0
  158. package/test/contract-negative.test.ts +86 -0
  159. package/test/contract.test.ts +158 -0
  160. package/test/external-deps.test.ts +48 -0
  161. package/test/fixtures/golden-project/.env.example +3 -0
  162. package/test/fixtures/golden-project/Makefile +7 -0
  163. package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +23 -0
  164. package/test/fixtures/golden-project/docs/setup-guide.md +10 -0
  165. package/test/fixtures/golden-project/package.json +10 -0
  166. package/test/fixtures/golden-project/specs/api-spec.md +20 -0
  167. package/test/fixtures/golden-project/src/auth.ts +8 -0
  168. package/test/fixtures/golden-project/src/db.ts +11 -0
  169. package/test/fixtures/golden-project/src/index.ts +19 -0
  170. package/test/fixtures/golden-project/src/utils/format.ts +3 -0
  171. package/test/fixtures/golden-project/test/auth.test.ts +15 -0
  172. package/test/fixtures/golden-project/tsconfig.json +12 -0
  173. package/test/meta-sc-coverage.test.ts +159 -0
  174. package/test/phase-0.test.ts +846 -0
  175. package/test/phase-1.test.ts +617 -0
  176. package/test/phase-2.test.ts +620 -0
  177. package/test/phase-3.test.ts +99 -0
  178. package/test/scaffold-conformity.test.ts +8 -0
  179. package/test/schema-canary.test.ts +51 -0
  180. package/test/spec-compliance-auto.test.ts +64 -0
  181. package/test/spec-compliance.test.ts +295 -0
  182. package/test/spec-discovery.test.ts +68 -0
  183. package/test/spec-drift.test.ts +5 -0
  184. package/test/structure.test.ts +165 -0
  185. package/test/unit/agent-brief-guard-ship.test.ts +293 -0
  186. package/test/unit/extract-constraints.test.ts +145 -0
  187. package/test/unit/issue-close-guard.test.ts +204 -0
  188. package/test/unit/scaffold-project.test.ts +417 -0
  189. package/test/unit/skill-cooccurrence.test.ts +177 -0
  190. package/test/unit/skill-sequence-logger.test.ts +244 -0
  191. package/test/unit/workflow-state-guard.test.ts +95 -0
  192. package/workflows/batch-ship.js +295 -0
  193. package/workflows/council.js +481 -0
  194. package/workflows/prove.js +560 -0
  195. package/workflows/ship.js +789 -0
  196. package/workflows/verify.js +236 -0
@@ -0,0 +1,220 @@
1
+ #!/usr/bin/env bun
2
+ /**
3
+ * witness.ts — Tamper-evident witness signing and verification
4
+ *
5
+ * Issue: #471
6
+ * ADR: ADR-008 (harness v3)
7
+ *
8
+ * Provides HMAC-signed witness files for gate results.
9
+ * Used by run-gate.ts (write) and pre-push (verify).
10
+ *
11
+ * Witness chain: scope -> verify -> ship
12
+ * Each witness stores gate result + commit SHA + HMAC signature.
13
+ */
14
+
15
+ import { readFileSync, writeFileSync, existsSync, mkdirSync, readdirSync } from "fs";
16
+ import { join } from "path";
17
+ import { createHmac } from "crypto";
18
+ import { execSync } from "child_process";
19
+
20
+ import { gateSaltPath } from "../lib/paths";
21
+
22
+ const GATE_SALT_PATH = gateSaltPath();
23
+
24
+ const REQUIRED_GATES = ["scope", "ship"] as const;
25
+
26
+ export interface WitnessRecord {
27
+ gate: string;
28
+ result: "PASS" | "FAIL";
29
+ slug: string;
30
+ issue: number;
31
+ commitSha: string;
32
+ timestamp: string;
33
+ testOutputHash: string;
34
+ hmac: string;
35
+ }
36
+
37
+ // ── Internal helpers ────────────────────────────────────────────────
38
+
39
+ function getSalt(): string {
40
+ if (!existsSync(GATE_SALT_PATH)) {
41
+ throw new Error(`Gate salt not found at ${GATE_SALT_PATH}`);
42
+ }
43
+ return readFileSync(GATE_SALT_PATH, "utf-8").trim();
44
+ }
45
+
46
+ function gitSha(cwd?: string): string {
47
+ try {
48
+ return execSync("git rev-parse HEAD", { encoding: "utf-8", timeout: 5000, cwd }).trim();
49
+ } catch {
50
+ return "unknown";
51
+ }
52
+ }
53
+
54
+ function hashTestOutput(testOutput: string): string {
55
+ return createHmac("sha256", "test-output")
56
+ .update(testOutput)
57
+ .digest("hex")
58
+ .slice(0, 16);
59
+ }
60
+
61
+ function computeHmac(record: Omit<WitnessRecord, "hmac">): string {
62
+ const salt = getSalt();
63
+ const input = [
64
+ record.gate,
65
+ record.result,
66
+ record.slug,
67
+ record.issue,
68
+ record.commitSha,
69
+ record.timestamp,
70
+ record.testOutputHash,
71
+ ].join(":");
72
+ return createHmac("sha256", salt).update(input).digest("hex").slice(0, 16);
73
+ }
74
+
75
+ // ── Public API ──────────────────────────────────────────────────────
76
+
77
+ /**
78
+ * Write a signed witness file after gate execution.
79
+ * Returns the path to the witness file.
80
+ */
81
+ export function writeWitness(
82
+ slug: string,
83
+ gate: string,
84
+ result: "PASS" | "FAIL",
85
+ testOutput: string,
86
+ issue: number = 0,
87
+ projectRoot?: string,
88
+ ): string {
89
+ const base = process.env.RUNGATE_WORK_DIR || join(process.env.HOME || "", ".rungate");
90
+ const wDir = join(base, slug);
91
+ const witnessDir = join(wDir, "witnesses");
92
+ mkdirSync(witnessDir, { recursive: true });
93
+
94
+ const ts = new Date().toISOString().replace(/\.\d{3}Z$/, "Z");
95
+ const commitSha = gitSha(projectRoot);
96
+ const testOutputHash = hashTestOutput(testOutput);
97
+
98
+ const record: Omit<WitnessRecord, "hmac"> = {
99
+ gate,
100
+ result,
101
+ slug,
102
+ issue,
103
+ commitSha,
104
+ timestamp: ts,
105
+ testOutputHash,
106
+ };
107
+
108
+ const hmac = computeHmac(record);
109
+ const witness: WitnessRecord = { ...record, hmac };
110
+
111
+ const filename = `${gate}-${ts.replace(/[:.]/g, "-")}.json`;
112
+ const witnessPath = join(witnessDir, filename);
113
+ writeFileSync(witnessPath, JSON.stringify(witness, null, 2) + "\n");
114
+
115
+ return witnessPath;
116
+ }
117
+
118
+ /**
119
+ * Verify a single witness file's HMAC signature.
120
+ * Returns { valid, record, error? }
121
+ */
122
+ export function verifyWitness(
123
+ witnessPath: string,
124
+ ): { valid: boolean; record: WitnessRecord | null; error?: string } {
125
+ if (!existsSync(witnessPath)) {
126
+ return { valid: false, record: null, error: "Witness file not found" };
127
+ }
128
+
129
+ let record: WitnessRecord;
130
+ try {
131
+ record = JSON.parse(readFileSync(witnessPath, "utf-8"));
132
+ } catch {
133
+ return { valid: false, record: null, error: "Invalid JSON in witness file" };
134
+ }
135
+
136
+ // Check required fields
137
+ const required = ["gate", "result", "slug", "issue", "commitSha", "timestamp", "testOutputHash", "hmac"];
138
+ for (const field of required) {
139
+ if (!(field in record)) {
140
+ return { valid: false, record, error: `Missing field: ${field}` };
141
+ }
142
+ }
143
+
144
+ // Verify HMAC
145
+ const { hmac: storedHmac, ...fields } = record;
146
+ let expectedHmac: string;
147
+ try {
148
+ expectedHmac = computeHmac(fields);
149
+ } catch (e: any) {
150
+ return { valid: false, record, error: `HMAC computation failed: ${e.message}` };
151
+ }
152
+
153
+ if (storedHmac !== expectedHmac) {
154
+ return { valid: false, record, error: `HMAC mismatch: stored=${storedHmac}, expected=${expectedHmac}` };
155
+ }
156
+
157
+ return { valid: true, record };
158
+ }
159
+
160
+ /**
161
+ * Verify the complete witness chain for a workflow.
162
+ * Checks: required gates present, HMACs valid, latest SHA matches HEAD.
163
+ *
164
+ * Returns { valid, errors[], witnesses[] }
165
+ */
166
+ export function verifyWitnessChain(
167
+ slug: string,
168
+ headSha?: string,
169
+ ): { valid: boolean; errors: string[]; witnesses: WitnessRecord[] } {
170
+ const base = process.env.RUNGATE_WORK_DIR || join(process.env.HOME || "", ".rungate");
171
+ const wDir = join(base, slug);
172
+ const witnessDir = join(wDir, "witnesses");
173
+ const errors: string[] = [];
174
+ const witnesses: WitnessRecord[] = [];
175
+
176
+ if (!existsSync(witnessDir)) {
177
+ return { valid: false, errors: ["No witnesses directory found"], witnesses };
178
+ }
179
+
180
+ // Read all witness files
181
+ const files = readdirSync(witnessDir).filter(f => f.endsWith(".json")).sort();
182
+ if (files.length === 0) {
183
+ return { valid: false, errors: ["No witness files found"], witnesses };
184
+ }
185
+
186
+ // Verify each witness
187
+ for (const file of files) {
188
+ const result = verifyWitness(join(witnessDir, file));
189
+ if (!result.valid) {
190
+ errors.push(`${file}: ${result.error}`);
191
+ }
192
+ if (result.record) {
193
+ witnesses.push(result.record);
194
+ }
195
+ }
196
+
197
+ // Check required gates have PASS witnesses
198
+ const passedGates = new Set(
199
+ witnesses
200
+ .filter(w => w.result === "PASS")
201
+ .map(w => w.gate),
202
+ );
203
+
204
+ for (const gate of REQUIRED_GATES) {
205
+ if (!passedGates.has(gate)) {
206
+ errors.push(`Missing PASS witness for required gate: ${gate}`);
207
+ }
208
+ }
209
+
210
+ // Check latest witness commitSha matches HEAD
211
+ const currentHead = headSha || gitSha();
212
+ const latestWitness = witnesses[witnesses.length - 1];
213
+ if (latestWitness && latestWitness.commitSha !== currentHead) {
214
+ errors.push(
215
+ `Stale witness: latest commitSha=${latestWitness.commitSha} but HEAD=${currentHead}`,
216
+ );
217
+ }
218
+
219
+ return { valid: errors.length === 0, errors, witnesses };
220
+ }