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,429 +0,0 @@
1
- import { test, expect, describe, beforeEach, afterEach } from "bun:test";
2
- import { mkdirSync, writeFileSync, readFileSync, rmSync, existsSync } from "fs";
3
- import { join } from "path";
4
-
5
- const TEST_BASE = `/tmp/brief-asm-test-${process.pid}`;
6
- const TEST_SLUG = `brief-test-${process.pid}`;
7
- const WORK_DIR = join(TEST_BASE, TEST_SLUG);
8
- const SF = join(WORK_DIR, "workflow-state.json");
9
- const PROJECT_ROOT = join(TEST_BASE, "project");
10
-
11
- function minimalState(overrides: Record<string, any> = {}): Record<string, any> {
12
- return {
13
- schemaVersion: 2,
14
- issue: 9999,
15
- repo: "test/repo",
16
- issueRepo: "test/repo",
17
- projectRoot: PROJECT_ROOT,
18
- slug: TEST_SLUG,
19
- phase: "BUILD",
20
- issueGoal: "Implement the brief assembler module for deterministic Marcus brief generation",
21
- acs: [
22
- {
23
- id: "AC-1",
24
- type: "CODE",
25
- statement: "brief-assembler.ts exports assembleBrief function with correct signature",
26
- threshold: { op: "contains", value: "assembleBrief", unit: "export" },
27
- evidenceMethod: { type: "grep", command: "grep 'export.*assembleBrief' gates/brief-assembler.ts" },
28
- evidence: null,
29
- verdict: "PENDING",
30
- },
31
- {
32
- id: "AC-2",
33
- type: "CODE",
34
- statement: "Generated brief includes Goal, ACs, Files, Scope, and Verify sections",
35
- threshold: { op: ">=", value: 5, unit: "sections" },
36
- evidenceMethod: { type: "grep", command: "grep -c '## ' /tmp/brief.md" },
37
- evidence: null,
38
- verdict: "PENDING",
39
- contextFiles: [
40
- { path: "gates/brief-assembler.ts", reason: "implementation" },
41
- { path: "gates/orchestrator.ts", reason: "state management" },
42
- ],
43
- },
44
- ],
45
- gates: {},
46
- changelog: [],
47
- governingSpec: {
48
- path: "/tmp/test-spec.md",
49
- detectedFrom: "test",
50
- },
51
- ...overrides,
52
- };
53
- }
54
-
55
- function createState(overrides: Record<string, any> = {}): void {
56
- mkdirSync(WORK_DIR, { recursive: true });
57
- writeFileSync(SF, JSON.stringify(minimalState(overrides), null, 2));
58
- }
59
-
60
- function setupProjectRoot(): void {
61
- mkdirSync(join(PROJECT_ROOT, ".claude"), { recursive: true });
62
- writeFileSync(
63
- join(PROJECT_ROOT, ".claude", "rungate.json"),
64
- JSON.stringify({
65
- project: "TestProject",
66
- dev: { apiBase: "http://localhost:7778", start: "make dev-all" },
67
- test: { apiBase: "http://localhost:7776" },
68
- prod: { apiBase: "http://localhost:7777" },
69
- }),
70
- );
71
- }
72
-
73
- import { assembleBrief, type AssembleResult } from "./brief-assembler";
74
-
75
- describe("brief-assembler", () => {
76
- beforeEach(() => {
77
- mkdirSync(WORK_DIR, { recursive: true });
78
- setupProjectRoot();
79
- });
80
-
81
- afterEach(() => {
82
- try { rmSync(TEST_BASE, { recursive: true, force: true }); } catch {}
83
- });
84
-
85
- describe("assembleBrief", () => {
86
- test("generates brief with all required sections", async () => {
87
- createState();
88
-
89
- const result = await assembleBrief({
90
- slug: TEST_SLUG,
91
- workDir: WORK_DIR,
92
- projectRoot: PROJECT_ROOT,
93
- });
94
-
95
- expect(result.validated).toBe(true);
96
- expect(result.acCount).toBe(2);
97
- expect(existsSync(result.briefPath)).toBe(true);
98
-
99
- const brief = readFileSync(result.briefPath, "utf-8");
100
- expect(brief).toContain("## Context");
101
- expect(brief).toContain("## Task");
102
- expect(brief).toContain("## Scope");
103
- expect(brief).toContain("## Verify");
104
- });
105
-
106
- test("includes issue goal in task section", async () => {
107
- createState({ issueGoal: "Fix the widget rendering bug in customer detail view" });
108
-
109
- const result = await assembleBrief({
110
- slug: TEST_SLUG,
111
- workDir: WORK_DIR,
112
- projectRoot: PROJECT_ROOT,
113
- });
114
-
115
- const brief = readFileSync(result.briefPath, "utf-8");
116
- expect(brief).toContain("Fix the widget rendering bug in customer detail view");
117
- });
118
-
119
- test("includes ACs with thresholds", async () => {
120
- createState();
121
-
122
- const result = await assembleBrief({
123
- slug: TEST_SLUG,
124
- workDir: WORK_DIR,
125
- projectRoot: PROJECT_ROOT,
126
- });
127
-
128
- const brief = readFileSync(result.briefPath, "utf-8");
129
- expect(brief).toContain("AC-1");
130
- expect(brief).toContain("AC-2");
131
- expect(brief).toContain("assembleBrief");
132
- });
133
-
134
- test("deduplicates context files in Files section", async () => {
135
- createState({
136
- acs: [
137
- {
138
- id: "AC-1", type: "CODE",
139
- statement: "First criterion with context files for testing dedup",
140
- threshold: { op: "contains", value: "foo" },
141
- evidenceMethod: { type: "grep", command: "grep foo bar" },
142
- evidence: null, verdict: "PENDING",
143
- contextFiles: [
144
- { path: "gates/orchestrator.ts", reason: "state" },
145
- { path: "gates/schema.ts", reason: "types" },
146
- ],
147
- },
148
- {
149
- id: "AC-2", type: "CODE",
150
- statement: "Second criterion sharing context file for dedup test",
151
- threshold: { op: "contains", value: "bar" },
152
- evidenceMethod: { type: "grep", command: "grep bar baz" },
153
- evidence: null, verdict: "PENDING",
154
- contextFiles: [
155
- { path: "gates/orchestrator.ts", reason: "state again" },
156
- { path: "gates/run-gate.ts", reason: "runner" },
157
- ],
158
- },
159
- ],
160
- });
161
-
162
- const result = await assembleBrief({
163
- slug: TEST_SLUG,
164
- workDir: WORK_DIR,
165
- projectRoot: PROJECT_ROOT,
166
- });
167
-
168
- expect(result.contextFileCount).toBe(3);
169
- const brief = readFileSync(result.briefPath, "utf-8");
170
- const orchestratorMatches = brief.match(/gates\/orchestrator\.ts/g);
171
- expect(orchestratorMatches).toHaveLength(1);
172
- });
173
-
174
- test("includes governing spec in Spec Alignment section", async () => {
175
- createState({
176
- governingSpec: {
177
- path: "/Users/test/specs/MY-SPEC.md",
178
- detectedFrom: "discovery",
179
- },
180
- });
181
-
182
- const result = await assembleBrief({
183
- slug: TEST_SLUG,
184
- workDir: WORK_DIR,
185
- projectRoot: PROJECT_ROOT,
186
- });
187
-
188
- const brief = readFileSync(result.briefPath, "utf-8");
189
- expect(brief).toContain("Spec Alignment");
190
- expect(brief).toContain("MY-SPEC.md");
191
- });
192
-
193
- test("includes verify commands from AC evidence methods", async () => {
194
- createState({
195
- acs: [
196
- {
197
- id: "AC-1", type: "CODE",
198
- statement: "Verify command appears in brief for validation purposes",
199
- threshold: { op: "contains", value: "PASS" },
200
- evidenceMethod: { type: "command", command: "bun test --isolate gates/self-heal.test.ts" },
201
- evidence: null, verdict: "PENDING",
202
- },
203
- ],
204
- });
205
-
206
- const result = await assembleBrief({
207
- slug: TEST_SLUG,
208
- workDir: WORK_DIR,
209
- projectRoot: PROJECT_ROOT,
210
- });
211
-
212
- const brief = readFileSync(result.briefPath, "utf-8");
213
- expect(brief).toContain("bun test --isolate gates/self-heal.test.ts");
214
- });
215
-
216
- test("writes brief to workDir/marcus-brief.md", async () => {
217
- createState();
218
-
219
- const result = await assembleBrief({
220
- slug: TEST_SLUG,
221
- workDir: WORK_DIR,
222
- projectRoot: PROJECT_ROOT,
223
- });
224
-
225
- expect(result.briefPath).toBe(join(WORK_DIR, "marcus-brief.md"));
226
- });
227
-
228
- test("handles missing governingSpec gracefully", async () => {
229
- createState({ governingSpec: undefined });
230
-
231
- const result = await assembleBrief({
232
- slug: TEST_SLUG,
233
- workDir: WORK_DIR,
234
- projectRoot: PROJECT_ROOT,
235
- });
236
-
237
- expect(result.validated).toBe(true);
238
- const brief = readFileSync(result.briefPath, "utf-8");
239
- expect(brief).toContain("## Context");
240
- });
241
-
242
- test("handles empty ACs array", async () => {
243
- createState({ acs: [] });
244
-
245
- const result = await assembleBrief({
246
- slug: TEST_SLUG,
247
- workDir: WORK_DIR,
248
- projectRoot: PROJECT_ROOT,
249
- });
250
-
251
- expect(result.acCount).toBe(0);
252
- expect(result.validated).toBe(true);
253
- });
254
-
255
- test("handles missing workflow-state.json", async () => {
256
- await expect(
257
- assembleBrief({
258
- slug: TEST_SLUG,
259
- workDir: "/tmp/nonexistent-dir-xyz",
260
- projectRoot: PROJECT_ROOT,
261
- }),
262
- ).rejects.toThrow(/workflow-state\.json/i);
263
- });
264
-
265
- test("includes git protocol section with issue number", async () => {
266
- createState({ issue: 1372 });
267
-
268
- const result = await assembleBrief({
269
- slug: TEST_SLUG,
270
- workDir: WORK_DIR,
271
- projectRoot: PROJECT_ROOT,
272
- });
273
-
274
- const brief = readFileSync(result.briefPath, "utf-8");
275
- expect(brief).toContain("Git protocol");
276
- expect(brief).toContain("1372");
277
- });
278
-
279
- test("includes scope-out boundaries when available", async () => {
280
- createState({
281
- scopeOut: ["gates/run-gate.ts", "gates/orchestrator.ts", "src/"],
282
- });
283
-
284
- const result = await assembleBrief({
285
- slug: TEST_SLUG,
286
- workDir: WORK_DIR,
287
- projectRoot: PROJECT_ROOT,
288
- });
289
-
290
- const brief = readFileSync(result.briefPath, "utf-8");
291
- expect(brief).toContain("gates/run-gate.ts");
292
- expect(brief).toContain("do NOT touch");
293
- });
294
-
295
- test("validates brief against policy patterns", async () => {
296
- createState();
297
-
298
- const result = await assembleBrief({
299
- slug: TEST_SLUG,
300
- workDir: WORK_DIR,
301
- projectRoot: PROJECT_ROOT,
302
- });
303
-
304
- expect(result.validated).toBe(true);
305
- });
306
-
307
- test("AC-1: includes AGENTS.md from projectRoot when present", async () => {
308
- writeFileSync(
309
- join(PROJECT_ROOT, "AGENTS.md"),
310
- "# Agents\n\n## Marcus Webb\nSenior engineer\n\n## Quinn Torres\nQA lead\n",
311
- );
312
- createState();
313
-
314
- const result = await assembleBrief({
315
- slug: TEST_SLUG,
316
- workDir: WORK_DIR,
317
- projectRoot: PROJECT_ROOT,
318
- });
319
-
320
- const brief = readFileSync(result.briefPath, "utf-8");
321
- expect(brief).toContain("AGENTS.md");
322
- expect(brief).toContain("## Context");
323
- });
324
-
325
- test("AC-1: omits AGENTS.md reference when file does not exist", async () => {
326
- createState();
327
-
328
- const result = await assembleBrief({
329
- slug: TEST_SLUG,
330
- workDir: WORK_DIR,
331
- projectRoot: PROJECT_ROOT,
332
- });
333
-
334
- const brief = readFileSync(result.briefPath, "utf-8");
335
- expect(brief).not.toContain("AGENTS.md");
336
- });
337
-
338
- test("AC-2: includes contextDocs from rungate.json (array form)", async () => {
339
- writeFileSync(
340
- join(PROJECT_ROOT, ".claude", "rungate.json"),
341
- JSON.stringify({
342
- project: "TestProject",
343
- contextDocs: ["HARNESS.md", "DESIGN.md"],
344
- }),
345
- );
346
- createState();
347
-
348
- const result = await assembleBrief({
349
- slug: TEST_SLUG,
350
- workDir: WORK_DIR,
351
- projectRoot: PROJECT_ROOT,
352
- });
353
-
354
- const brief = readFileSync(result.briefPath, "utf-8");
355
- expect(brief).toContain("HARNESS.md");
356
- expect(brief).toContain("DESIGN.md");
357
- expect(result.contextFileCount).toBeGreaterThanOrEqual(2);
358
- });
359
-
360
- test("AC-2: includes contextDocs from rungate.json (object form)", async () => {
361
- writeFileSync(
362
- join(PROJECT_ROOT, ".claude", "rungate.json"),
363
- JSON.stringify({
364
- project: "TestProject",
365
- contextDocs: {
366
- routing: "DOCS.md",
367
- model: "MODEL.md",
368
- architecture: "ARCHITECTURE.md",
369
- },
370
- }),
371
- );
372
- createState();
373
-
374
- const result = await assembleBrief({
375
- slug: TEST_SLUG,
376
- workDir: WORK_DIR,
377
- projectRoot: PROJECT_ROOT,
378
- });
379
-
380
- const brief = readFileSync(result.briefPath, "utf-8");
381
- expect(brief).toContain("DOCS.md");
382
- expect(brief).toContain("MODEL.md");
383
- expect(brief).toContain("ARCHITECTURE.md");
384
- });
385
-
386
- test("AC-3: no hardcoded harness-owned template paths in context", async () => {
387
- createState();
388
-
389
- const result = await assembleBrief({
390
- slug: TEST_SLUG,
391
- workDir: WORK_DIR,
392
- projectRoot: PROJECT_ROOT,
393
- });
394
-
395
- const brief = readFileSync(result.briefPath, "utf-8");
396
- expect(brief).not.toContain("MarcusContext.md");
397
- expect(brief).not.toContain("MarcusChecklist.md");
398
- });
399
-
400
- test("AC-4: produces >= 5 sections from structured data only", async () => {
401
- writeFileSync(
402
- join(PROJECT_ROOT, "AGENTS.md"),
403
- "# Agents\n## Marcus Webb\nSenior engineer\n",
404
- );
405
- writeFileSync(
406
- join(PROJECT_ROOT, ".claude", "rungate.json"),
407
- JSON.stringify({
408
- project: "TestProject",
409
- contextDocs: ["HARNESS.md"],
410
- }),
411
- );
412
- createState({
413
- governingSpec: { path: "/tmp/spec.md", detectedFrom: "test" },
414
- scopeOut: ["src/secret.ts"],
415
- });
416
-
417
- const result = await assembleBrief({
418
- slug: TEST_SLUG,
419
- workDir: WORK_DIR,
420
- projectRoot: PROJECT_ROOT,
421
- });
422
-
423
- const brief = readFileSync(result.briefPath, "utf-8");
424
- const sectionHeaders = brief.match(/^## /gm) || [];
425
- expect(sectionHeaders.length).toBeGreaterThanOrEqual(5);
426
- expect(result.validated).toBe(true);
427
- });
428
- });
429
- });