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,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
- });