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,204 +0,0 @@
1
- /**
2
- * Regression tests for IssueCloseGuard.hook.ts
3
- * Covers:
4
- * #63 — checkGateFile must find files archived to completed/ subdir
5
- * #64 — findWorkDirForIssue must prefer slug-pattern dirs and use mtime fallback
6
- */
7
-
8
- import { describe, it, expect, beforeEach, afterEach } from 'bun:test';
9
- import { mkdtempSync, mkdirSync, writeFileSync, rmSync, utimesSync, existsSync, readFileSync, readdirSync, statSync } from 'fs';
10
- import { join } from 'path';
11
- import { tmpdir } from 'os';
12
-
13
- let tempDir: string;
14
- let workDir: string;
15
-
16
- const origPaiDir = process.env.PAI_DIR;
17
-
18
- beforeEach(() => {
19
- tempDir = mkdtempSync(join(tmpdir(), 'guard-test-'));
20
- workDir = join(tempDir, 'MEMORY', 'WORK');
21
- mkdirSync(workDir, { recursive: true });
22
- process.env.PAI_DIR = tempDir;
23
- });
24
-
25
- afterEach(() => {
26
- rmSync(tempDir, { recursive: true, force: true });
27
- if (origPaiDir !== undefined) {
28
- process.env.PAI_DIR = origPaiDir;
29
- } else {
30
- delete process.env.PAI_DIR;
31
- }
32
- });
33
-
34
- // Helper: create a gate file in a work subdirectory
35
- function createGateFile(dirName: string, fileName: string, data: object, inCompleted = false) {
36
- const dir = inCompleted
37
- ? join(workDir, dirName, 'completed')
38
- : join(workDir, dirName);
39
- mkdirSync(dir, { recursive: true });
40
- writeFileSync(join(dir, fileName), JSON.stringify(data));
41
- }
42
-
43
- // Helper: create a CHECKPOINT.md in a work subdirectory
44
- function createCheckpoint(dirName: string, content: string, mtime?: Date) {
45
- const dir = join(workDir, dirName);
46
- mkdirSync(dir, { recursive: true });
47
- const cpPath = join(dir, 'CHECKPOINT.md');
48
- writeFileSync(cpPath, content);
49
- if (mtime) {
50
- utimesSync(cpPath, mtime, mtime);
51
- }
52
- }
53
-
54
- // ----------------------------------------------------------------
55
- // Function reimplementations matching the FIXED source code.
56
- // These test the EXPECTED behavior after the fix is applied.
57
- // Integration test at the end verifies the actual script.
58
- // ----------------------------------------------------------------
59
-
60
- function checkGateFile(testWorkDir: string, gateFile: string): { exists: boolean; passed: boolean; fails: number } {
61
- let filePath = join(testWorkDir, gateFile);
62
- if (!existsSync(filePath)) {
63
- // #63 fix: fallback to completed/ subdirectory
64
- filePath = join(testWorkDir, 'completed', gateFile);
65
- if (!existsSync(filePath)) {
66
- return { exists: false, passed: false, fails: 0 };
67
- }
68
- }
69
-
70
- try {
71
- const data = JSON.parse(readFileSync(filePath, 'utf-8'));
72
- const fails = data.fail ?? data.fail_count ?? 0;
73
- return { exists: true, passed: fails === 0, fails };
74
- } catch {
75
- return { exists: true, passed: true, fails: 0 };
76
- }
77
- }
78
-
79
- function findWorkDirForIssue(issueNum: string): string | null {
80
- if (!existsSync(workDir)) return null;
81
-
82
- try {
83
- const dirs = readdirSync(workDir, { withFileTypes: true })
84
- .filter(d => d.isDirectory())
85
- .map(d => d.name);
86
-
87
- // Pass 1: slug-pattern match (#64 fix)
88
- const slugPrefix = `${issueNum}-`;
89
- for (const dir of dirs) {
90
- if (dir.startsWith(slugPrefix)) {
91
- return join(workDir, dir);
92
- }
93
- }
94
-
95
- // Pass 2: content match with mtime tiebreaker (#64 fix)
96
- const contentMatches: { dir: string; mtime: number }[] = [];
97
- for (const dir of dirs) {
98
- const checkpointPath = join(workDir, dir, 'CHECKPOINT.md');
99
- if (existsSync(checkpointPath)) {
100
- try {
101
- const content = readFileSync(checkpointPath, 'utf-8');
102
- const issuePattern = new RegExp(`#${issueNum}(?:\\b|[^0-9]|$)|[Ii]ssue:\\s*${issueNum}(?:\\b|[^0-9]|$)`);
103
- if (issuePattern.test(content)) {
104
- const stat = statSync(checkpointPath);
105
- contentMatches.push({ dir, mtime: stat.mtimeMs });
106
- }
107
- } catch { /* skip */ }
108
- }
109
- }
110
-
111
- if (contentMatches.length > 0) {
112
- contentMatches.sort((a, b) => b.mtime - a.mtime);
113
- return join(workDir, contentMatches[0].dir);
114
- }
115
- } catch { /* skip */ }
116
-
117
- return null;
118
- }
119
-
120
-
121
- describe('IssueCloseGuard', () => {
122
-
123
- describe('#63 — checkGateFile completed/ fallback', () => {
124
-
125
- it('finds gate file in root directory (existing behavior)', () => {
126
- const issueDir = '43-goal-audit-gate';
127
- createGateFile(issueDir, 'scope-check.json', { fail: 0 });
128
-
129
- const result = checkGateFile(join(workDir, issueDir), 'scope-check.json');
130
- expect(result.exists).toBe(true);
131
- expect(result.passed).toBe(true);
132
- expect(result.fails).toBe(0);
133
- });
134
-
135
- it('finds gate file in completed/ subdir when not in root', () => {
136
- const issueDir = '43-goal-audit-gate';
137
- createGateFile(issueDir, 'scope-check.json', { fail: 0 }, true);
138
-
139
- const result = checkGateFile(join(workDir, issueDir), 'scope-check.json');
140
- expect(result.exists).toBe(true);
141
- expect(result.passed).toBe(true);
142
- expect(result.fails).toBe(0);
143
- });
144
-
145
- it('returns exists=false when file is in neither location', () => {
146
- const issueDir = '43-goal-audit-gate';
147
- mkdirSync(join(workDir, issueDir), { recursive: true });
148
-
149
- const result = checkGateFile(join(workDir, issueDir), 'scope-check.json');
150
- expect(result.exists).toBe(false);
151
- expect(result.passed).toBe(false);
152
- });
153
-
154
- it('detects failures in completed/ subdir gate file', () => {
155
- const issueDir = '43-goal-audit-gate';
156
- createGateFile(issueDir, 'verify-check.json', { fail: 2 }, true);
157
-
158
- const result = checkGateFile(join(workDir, issueDir), 'verify-check.json');
159
- expect(result.exists).toBe(true);
160
- expect(result.passed).toBe(false);
161
- expect(result.fails).toBe(2);
162
- });
163
- });
164
-
165
- describe('#64 — findWorkDirForIssue slug preference + mtime fallback', () => {
166
-
167
- it('prefers slug-pattern directory over alphabetically-first content match', () => {
168
- createCheckpoint('20260101-some-old-work', '# Work\nIssue: 63\nOld checkpoint');
169
- createCheckpoint('63-gate-guard-fixes', '# Work\nIssue: 63\nCorrect checkpoint');
170
-
171
- const result = findWorkDirForIssue('63');
172
- expect(result).toBe(join(workDir, '63-gate-guard-fixes'));
173
- });
174
-
175
- it('falls back to most-recent mtime when no slug match exists', () => {
176
- const oldDate = new Date('2026-06-20T00:00:00Z');
177
- const newDate = new Date('2026-06-28T00:00:00Z');
178
-
179
- createCheckpoint('20260620-goal-audit-gate', '# Work\nWorking on #43\nOld work', oldDate);
180
- createCheckpoint('20260628-goal-audit-gate', '# Work\nWorking on #43\nNew work', newDate);
181
-
182
- const result = findWorkDirForIssue('43');
183
- expect(result).toBe(join(workDir, '20260628-goal-audit-gate'));
184
- });
185
-
186
- it('returns null when no directory matches at all', () => {
187
- createCheckpoint('63-unrelated', '# Work\nSome unrelated checkpoint');
188
-
189
- const result = findWorkDirForIssue('99');
190
- expect(result).toBeNull();
191
- });
192
-
193
- it('slug match wins even if content-matching dir has newer mtime', () => {
194
- const oldDate = new Date('2026-06-01T00:00:00Z');
195
- const newDate = new Date('2026-06-28T00:00:00Z');
196
-
197
- createCheckpoint('43-goal-audit-gate', '# Work\nIssue: 43', oldDate);
198
- createCheckpoint('20260628-audit-rework', '# Work\nReworking #43', newDate);
199
-
200
- const result = findWorkDirForIssue('43');
201
- expect(result).toBe(join(workDir, '43-goal-audit-gate'));
202
- });
203
- });
204
- });
@@ -1,417 +0,0 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * scaffold-project.test.ts — TDD tests for scripts/scaffold-project.ts
4
- *
5
- * Tests the CLI that bootstraps any project to scaffold conformity.
6
- * Validates: project type detection, directory creation, AGENTS.md generation,
7
- * test file creation, spec frontmatter injection, no-overwrite guarantee.
8
- */
9
- import { describe, test, expect, beforeEach, afterEach } from "bun:test";
10
- import { existsSync, mkdirSync, readFileSync, writeFileSync, rmSync, readdirSync } from "fs";
11
- import { join } from "path";
12
- import { execSync } from "child_process";
13
-
14
- const SCRIPT = join(import.meta.dir, "..", "..", "scripts", "scaffold-project.ts");
15
-
16
- function createTempDir(): string {
17
- const dir = join("/tmp", `scaffold-test-${Date.now()}-${Math.random().toString(36).slice(2, 8)}`);
18
- mkdirSync(dir, { recursive: true });
19
- return dir;
20
- }
21
-
22
- function runScaffold(projectPath: string, opts?: { expectFail?: boolean }): string {
23
- try {
24
- return execSync(`bun ${SCRIPT} ${projectPath}`, {
25
- encoding: "utf-8",
26
- timeout: 15000,
27
- });
28
- } catch (e: any) {
29
- if (opts?.expectFail) return e.stderr || e.stdout || "";
30
- throw e;
31
- }
32
- }
33
-
34
- // ── Test 1: Project Type Detection ─────────────────────────────
35
-
36
- describe("scaffold-project: project type detection", () => {
37
- let tmpDir: string;
38
-
39
- afterEach(() => {
40
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
41
- });
42
-
43
- test("detects code project when src/ and package.json exist", () => {
44
- tmpDir = createTempDir();
45
- mkdirSync(join(tmpDir, "src"), { recursive: true });
46
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test-code", dependencies: {} }));
47
- const output = runScaffold(tmpDir);
48
- expect(output).toContain("code");
49
- });
50
-
51
- test("detects content project when only markdown files exist", () => {
52
- tmpDir = createTempDir();
53
- writeFileSync(join(tmpDir, "posts.md"), "# Posts\n\nSome content.");
54
- writeFileSync(join(tmpDir, "README.md"), "# readme");
55
- const output = runScaffold(tmpDir);
56
- expect(output).toContain("content");
57
- });
58
-
59
- test("detects infra project when scripts/ or manifests exist", () => {
60
- tmpDir = createTempDir();
61
- mkdirSync(join(tmpDir, "scripts"), { recursive: true });
62
- writeFileSync(join(tmpDir, "docker-compose.yml"), "version: '3'");
63
- const output = runScaffold(tmpDir);
64
- expect(output).toContain("infra");
65
- });
66
- });
67
-
68
- // ── Test 2: Directory Creation ─────────────────────────────────
69
-
70
- describe("scaffold-project: directory creation", () => {
71
- let tmpDir: string;
72
-
73
- afterEach(() => {
74
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
75
- });
76
-
77
- test("creates specs/, reference/, tests/, .github/ when missing", () => {
78
- tmpDir = createTempDir();
79
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
80
- runScaffold(tmpDir);
81
-
82
- expect(existsSync(join(tmpDir, "specs"))).toBe(true);
83
- expect(existsSync(join(tmpDir, "reference"))).toBe(true);
84
- // tests/ OR test/ accepted
85
- const hasTests = existsSync(join(tmpDir, "tests")) || existsSync(join(tmpDir, "test"));
86
- expect(hasTests).toBe(true);
87
- expect(existsSync(join(tmpDir, ".github"))).toBe(true);
88
- });
89
-
90
- test("does not create dirs that already exist", () => {
91
- tmpDir = createTempDir();
92
- mkdirSync(join(tmpDir, "specs"), { recursive: true });
93
- writeFileSync(join(tmpDir, "specs", "existing.md"), "---\ntestable: true\n---\n# Existing");
94
- runScaffold(tmpDir);
95
-
96
- // specs/ still exists, existing file still there
97
- expect(existsSync(join(tmpDir, "specs", "existing.md"))).toBe(true);
98
- });
99
- });
100
-
101
- // ── Test 3: AGENTS.md Generation ───────────────────────────────
102
-
103
- describe("scaffold-project: AGENTS.md generation", () => {
104
- let tmpDir: string;
105
-
106
- afterEach(() => {
107
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
108
- });
109
-
110
- test("generates AGENTS.md with all standard sections", () => {
111
- tmpDir = createTempDir();
112
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "my-project" }));
113
- runScaffold(tmpDir);
114
-
115
- const agentsPath = join(tmpDir, "AGENTS.md");
116
- expect(existsSync(agentsPath)).toBe(true);
117
-
118
- const content = readFileSync(agentsPath, "utf-8");
119
- const requiredSections = [
120
- "Project Identity",
121
- "Key Files",
122
- "Specs",
123
- "Tests",
124
- "Commands",
125
- "Workflow",
126
- "Quick Reference",
127
- "Harness-Managed Files",
128
- ];
129
- for (const section of requiredSections) {
130
- expect(content.toLowerCase()).toContain(section.toLowerCase());
131
- }
132
- });
133
-
134
- test("AGENTS.md is ≤150 lines", () => {
135
- tmpDir = createTempDir();
136
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
137
- runScaffold(tmpDir);
138
-
139
- const content = readFileSync(join(tmpDir, "AGENTS.md"), "utf-8");
140
- expect(content.split("\n").length).toBeLessThanOrEqual(150);
141
- });
142
-
143
- test("AGENTS.md contains TODO markers for customization", () => {
144
- tmpDir = createTempDir();
145
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
146
- runScaffold(tmpDir);
147
-
148
- const content = readFileSync(join(tmpDir, "AGENTS.md"), "utf-8");
149
- expect(content).toContain("TODO");
150
- });
151
- });
152
-
153
- // ── Test 4: No-Overwrite Guarantee ─────────────────────────────
154
-
155
- describe("scaffold-project: no-overwrite guarantee", () => {
156
- let tmpDir: string;
157
-
158
- afterEach(() => {
159
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
160
- });
161
-
162
- test("never overwrites existing AGENTS.md", () => {
163
- tmpDir = createTempDir();
164
- const existingContent = "# My Custom AGENTS.md\n\nThis should not be overwritten.";
165
- writeFileSync(join(tmpDir, "AGENTS.md"), existingContent);
166
- runScaffold(tmpDir);
167
-
168
- const content = readFileSync(join(tmpDir, "AGENTS.md"), "utf-8");
169
- expect(content).toBe(existingContent);
170
- });
171
-
172
- test("never overwrites existing copilot-instructions.md", () => {
173
- tmpDir = createTempDir();
174
- mkdirSync(join(tmpDir, ".github"), { recursive: true });
175
- const existing = "# Custom instructions\nDo not touch.";
176
- writeFileSync(join(tmpDir, ".github", "copilot-instructions.md"), existing);
177
- runScaffold(tmpDir);
178
-
179
- const content = readFileSync(join(tmpDir, ".github", "copilot-instructions.md"), "utf-8");
180
- expect(content).toBe(existing);
181
- });
182
-
183
- test("never overwrites existing test files", () => {
184
- tmpDir = createTempDir();
185
- mkdirSync(join(tmpDir, "tests"), { recursive: true });
186
- const existing = "// my custom test\n";
187
- writeFileSync(join(tmpDir, "tests", "scaffold-conformity.test.ts"), existing);
188
- runScaffold(tmpDir);
189
-
190
- const content = readFileSync(join(tmpDir, "tests", "scaffold-conformity.test.ts"), "utf-8");
191
- expect(content).toBe(existing);
192
- });
193
- });
194
-
195
- // ── Test 5: Copilot Instructions ───────────────────────────────
196
-
197
- describe("scaffold-project: copilot instructions", () => {
198
- let tmpDir: string;
199
-
200
- afterEach(() => {
201
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
202
- });
203
-
204
- test("creates .github/copilot-instructions.md with pointer to AGENTS.md", () => {
205
- tmpDir = createTempDir();
206
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
207
- runScaffold(tmpDir);
208
-
209
- const path = join(tmpDir, ".github", "copilot-instructions.md");
210
- expect(existsSync(path)).toBe(true);
211
- const content = readFileSync(path, "utf-8");
212
- expect(content).toContain("AGENTS.md");
213
- });
214
- });
215
-
216
- // ── Test 6: Thin Conformity Test File ──────────────────────────
217
-
218
- describe("scaffold-project: conformity test file", () => {
219
- let tmpDir: string;
220
-
221
- afterEach(() => {
222
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
223
- });
224
-
225
- test("creates scaffold-conformity.test.ts in tests/", () => {
226
- tmpDir = createTempDir();
227
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
228
- runScaffold(tmpDir);
229
-
230
- // Should create in tests/ (or test/ if that already exists)
231
- const testDir = existsSync(join(tmpDir, "test")) ? "test" : "tests";
232
- const testFile = join(tmpDir, testDir, "scaffold-conformity.test.ts");
233
- expect(existsSync(testFile)).toBe(true);
234
-
235
- const content = readFileSync(testFile, "utf-8");
236
- expect(content).toContain("runScaffoldConformity");
237
- expect(content).toContain("rungate");
238
- });
239
- });
240
-
241
- // ── Test 7: Spec Frontmatter Injection ─────────────────────────
242
-
243
- describe("scaffold-project: spec frontmatter injection", () => {
244
- let tmpDir: string;
245
-
246
- afterEach(() => {
247
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
248
- });
249
-
250
- test("adds frontmatter to bare spec files in specs/", () => {
251
- tmpDir = createTempDir();
252
- mkdirSync(join(tmpDir, "specs"), { recursive: true });
253
- // Write a spec file WITHOUT frontmatter
254
- writeFileSync(join(tmpDir, "specs", "bare-spec.md"), "# My Spec\n\nSome content here.");
255
- runScaffold(tmpDir);
256
-
257
- const content = readFileSync(join(tmpDir, "specs", "bare-spec.md"), "utf-8");
258
- expect(content).toMatch(/^---\n/);
259
- expect(content).toContain("testable:");
260
- expect(content).toContain("doc-type: spec");
261
- });
262
-
263
- test("does not modify spec files that already have frontmatter", () => {
264
- tmpDir = createTempDir();
265
- mkdirSync(join(tmpDir, "specs"), { recursive: true });
266
- const existing = "---\ndoc-type: spec\ntestable: true\n---\n# Already Good";
267
- writeFileSync(join(tmpDir, "specs", "good-spec.md"), existing);
268
- runScaffold(tmpDir);
269
-
270
- const content = readFileSync(join(tmpDir, "specs", "good-spec.md"), "utf-8");
271
- expect(content).toBe(existing);
272
- });
273
- });
274
-
275
- // ── Test 8: Package.json devDeps ───────────────────────────────
276
-
277
- describe("scaffold-project: package.json devDeps", () => {
278
- let tmpDir: string;
279
-
280
- afterEach(() => {
281
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
282
- });
283
-
284
- test("adds rungate to package.json devDependencies when package.json exists", () => {
285
- tmpDir = createTempDir();
286
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test", dependencies: {} }, null, 2));
287
- runScaffold(tmpDir);
288
-
289
- const pkg = JSON.parse(readFileSync(join(tmpDir, "package.json"), "utf-8"));
290
- expect(pkg.devDependencies).toBeDefined();
291
- expect(pkg.devDependencies["rungate"]).toBeDefined();
292
- });
293
-
294
- test("does not create package.json when it does not exist", () => {
295
- tmpDir = createTempDir();
296
- mkdirSync(join(tmpDir, "docs"), { recursive: true });
297
- writeFileSync(join(tmpDir, "docs", "notes.md"), "# Notes");
298
- runScaffold(tmpDir);
299
-
300
- // Content project — no package.json should be created
301
- expect(existsSync(join(tmpDir, "package.json"))).toBe(false);
302
- });
303
- });
304
-
305
- // ── Test 9: Report Output ──────────────────────────────────────
306
-
307
- describe("scaffold-project: report output", () => {
308
- let tmpDir: string;
309
-
310
- afterEach(() => {
311
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
312
- });
313
-
314
- test("reports what it created and what it skipped", () => {
315
- tmpDir = createTempDir();
316
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
317
- const output = runScaffold(tmpDir);
318
-
319
- expect(output).toContain("CREATED");
320
- // Should report at least AGENTS.md creation
321
- expect(output).toContain("AGENTS.md");
322
- });
323
-
324
- test("reports AUDITED or SKIPPED for existing files", () => {
325
- tmpDir = createTempDir();
326
- writeFileSync(join(tmpDir, "AGENTS.md"), "# Existing");
327
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
328
- const output = runScaffold(tmpDir);
329
-
330
- expect(output).toMatch(/SKIP|AUDITED/);
331
- expect(output).toContain("AGENTS.md");
332
- });
333
- });
334
-
335
- // ── Test 10: CLI Error Handling ────────────────────────────────
336
-
337
- describe("scaffold-project: CLI error handling", () => {
338
- test("exits with error when no path provided", () => {
339
- try {
340
- execSync(`bun ${SCRIPT}`, { encoding: "utf-8", timeout: 10000 });
341
- expect(false).toBe(true); // should not reach here
342
- } catch (e: any) {
343
- expect(e.status).not.toBe(0);
344
- }
345
- });
346
-
347
- test("exits with error when path does not exist", () => {
348
- try {
349
- execSync(`bun ${SCRIPT} /nonexistent/path/that/surely/does/not/exist`, {
350
- encoding: "utf-8",
351
- timeout: 10000,
352
- });
353
- expect(false).toBe(true);
354
- } catch (e: any) {
355
- expect(e.status).not.toBe(0);
356
- }
357
- });
358
- });
359
-
360
- // ── Test 11: Existing test/ dir is respected ───────────────────
361
-
362
- describe("scaffold-project: respects existing test/ directory name", () => {
363
- let tmpDir: string;
364
-
365
- afterEach(() => {
366
- if (tmpDir && existsSync(tmpDir)) rmSync(tmpDir, { recursive: true });
367
- });
368
-
369
- test("uses test/ if it exists instead of creating tests/", () => {
370
- tmpDir = createTempDir();
371
- mkdirSync(join(tmpDir, "test"), { recursive: true });
372
- writeFileSync(join(tmpDir, "package.json"), JSON.stringify({ name: "test" }));
373
- runScaffold(tmpDir);
374
-
375
- // Should place conformity test in existing test/ dir
376
- expect(existsSync(join(tmpDir, "test", "scaffold-conformity.test.ts"))).toBe(true);
377
- // Should NOT create a second tests/ dir
378
- expect(existsSync(join(tmpDir, "tests"))).toBe(false);
379
- });
380
- });
381
-
382
- // ── Test 12: Hard Constraints last-section edge case ─────────
383
-
384
- describe("scaffold-project: hard constraints regex", () => {
385
- test("Hard Constraints preserved when last section in AGENTS.md", () => {
386
- const content = `## Identity\nTest project\n\n## Hard Constraints (non-inferrable)\n\n- **Rule one** — important\n- **Rule two** — also important\n`;
387
- const hcMatch = content.match(/## Hard Constraints[^\n]*\n\n([\s\S]*?)(?=\n## |\s*$)/);
388
- expect(hcMatch).not.toBeNull();
389
- expect(hcMatch![1]).toContain("Rule one");
390
- expect(hcMatch![1]).toContain("Rule two");
391
- });
392
- });
393
-
394
- // ── Test 13: Per-type staleness thresholds ────────────────────
395
-
396
- describe("scaffold-project: per-type staleness thresholds", () => {
397
- function classifyStale(ref: string, daysSince: number): boolean {
398
- const isAdr = ref.includes('docs/adr/') || /ADR/i.test(ref);
399
- if (isAdr) return false;
400
- const threshold = ref.startsWith('specs/') ? 90 : 180;
401
- return daysSince > threshold;
402
- }
403
-
404
- test("ADR paths are never stale regardless of age", () => {
405
- expect(classifyStale("docs/adr/ADR-001.md", 500)).toBe(false);
406
- });
407
-
408
- test("spec paths use 90-day threshold", () => {
409
- expect(classifyStale("specs/BOOTSTRAP.md", 91)).toBe(true);
410
- expect(classifyStale("specs/BOOTSTRAP.md", 89)).toBe(false);
411
- });
412
-
413
- test("other doc paths use 180-day threshold", () => {
414
- expect(classifyStale("docs/GUIDE.md", 181)).toBe(true);
415
- expect(classifyStale("docs/GUIDE.md", 179)).toBe(false);
416
- });
417
- });