rungate 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/agents/aditi.md +47 -0
- package/.claude/agents/marcus.md +50 -0
- package/.claude/agents/quinn.md +58 -0
- package/.claude/agents/rook.md +47 -0
- package/.claude/agents/serena.md +46 -0
- package/.claude/rungate.json +11 -0
- package/.fallowrc.json +28 -0
- package/.github/copilot-instructions.md +20 -0
- package/.rungate/conformity-findings.json +648 -0
- package/AGENTS.md +106 -0
- package/CODE-MAP.md +50 -0
- package/HARNESS.md +88 -0
- package/bun.lock +26 -0
- package/bunfig.toml +2 -0
- package/config/brief-policies.json +28 -0
- package/config/ceremony-profiles.json +212 -0
- package/config/consumer-cascade-map.json +24 -0
- package/config/doc-cascade-map.json +24 -0
- package/config/eval.json +84 -0
- package/config/profiles/account-plan.yaml +36 -0
- package/config/profiles/campaign.yaml +94 -0
- package/config/prove-evidence.schema.json +65 -0
- package/config/spec-policies.json +36 -0
- package/config/workflow-schema.json +281 -0
- package/gates/SCHEMA-GUIDE.md +121 -0
- package/gates/ac-quality.test.ts +106 -0
- package/gates/adversarial.test.ts +274 -0
- package/gates/brief-assembler.test.ts +429 -0
- package/gates/brief-assembler.ts +334 -0
- package/gates/bunfig.toml +2 -0
- package/gates/chain.test.ts +91 -0
- package/gates/e2e-smoke.test.ts +234 -0
- package/gates/error-classifier.test.ts +249 -0
- package/gates/error-classifier.ts +89 -0
- package/gates/orchestrator.test.ts +950 -0
- package/gates/orchestrator.ts +569 -0
- package/gates/preload.ts +77 -0
- package/gates/prompts/ac-adversary.md +20 -0
- package/gates/prompts/evidence-validator.md +22 -0
- package/gates/prompts/prove-reproducer.md +53 -0
- package/gates/prove.test.ts +164 -0
- package/gates/run-gate.ts +936 -0
- package/gates/schema-parity.test.ts +197 -0
- package/gates/schema.ts +362 -0
- package/gates/self-heal.test.ts +511 -0
- package/gates/self-heal.ts +121 -0
- package/gates/ship-orchestrator.test.ts +379 -0
- package/gates/ship-orchestrator.ts +363 -0
- package/gates/test-fixtures/broken-no-environments.json +60 -0
- package/gates/test-fixtures/valid-standard.json +54 -0
- package/gates/test-utils.ts +43 -0
- package/gates/witness.ts +220 -0
- package/gates/workflow.test.ts +1053 -0
- package/hooks/AgentBriefGuard.hook.ts +586 -0
- package/hooks/AgentVerdictCapture.hook.ts +134 -0
- package/hooks/AutoVerifyGate.hook.ts +76 -0
- package/hooks/GateEnforcement.hook.ts +273 -0
- package/hooks/IssueCloseGuard.hook.ts +116 -0
- package/hooks/MergeGuard.hook.ts +55 -0
- package/hooks/StaleTTLCleanup.hook.ts +133 -0
- package/hooks/VerifyPhaseLock.hook.ts +81 -0
- package/hooks/WorkflowStateGuard.hook.ts +37 -0
- package/hooks/lib/agentDetection.ts +70 -0
- package/hooks/lib/findWorkflow.ts +101 -0
- package/hooks/lib/parseStdin.ts +37 -0
- package/hooks/lib/paths.ts +111 -0
- package/hooks/lib/utils.ts +81 -0
- package/lib/conformity.ts +959 -0
- package/lib/paths.ts +23 -0
- package/lib/rungate-schema.ts +60 -0
- package/lib/signal-phrases.ts +7 -0
- package/package.json +20 -0
- package/prompts/ac-adversary.md +20 -0
- package/prompts/ac-format.md +34 -0
- package/prompts/aditi.md +29 -0
- package/prompts/blast-radius.md +29 -0
- package/prompts/coding-principles.md +34 -0
- package/prompts/container-rebuild.md +29 -0
- package/prompts/container-verify.md +28 -0
- package/prompts/discovery.md +27 -0
- package/prompts/environment.md +28 -0
- package/prompts/escalation-decision-tree.md +38 -0
- package/prompts/evidence-hierarchy.md +31 -0
- package/prompts/evidence-validator.md +22 -0
- package/prompts/marcus.md +29 -0
- package/prompts/prevention.md +26 -0
- package/prompts/prove-reproducer.md +43 -0
- package/prompts/quinn-decision-tree.md +31 -0
- package/prompts/quinn-ui-brief.md +106 -0
- package/prompts/quinn.md +29 -0
- package/prompts/rca.md +28 -0
- package/prompts/read-before-write.md +30 -0
- package/prompts/regression.md +26 -0
- package/prompts/rook.md +29 -0
- package/prompts/serena.md +28 -0
- package/prompts/testing-strategy.md +34 -0
- package/reference/migration-manifest.json +554 -0
- package/reference/prompts/agent-aditi.md +38 -0
- package/reference/prompts/agent-marcus.md +38 -0
- package/reference/prompts/agent-quinn.md +38 -0
- package/reference/prompts/agent-rook.md +37 -0
- package/reference/prompts/agent-serena.md +37 -0
- package/reference/prompts/council-skill.md +170 -0
- package/reference/prompts/goal-skill.md +235 -0
- package/reference/prompts/prove-skill.md +283 -0
- package/reference/prompts/quinn-standard.md +246 -0
- package/reference/prompts/ship-convergence.md +65 -0
- package/reference/prompts/ship-escalation.md +43 -0
- package/reference/prompts/ship-iteration.md +382 -0
- package/reference/prompts/ship-pending-patches.md +246 -0
- package/reference/prompts/ship-reference.md +250 -0
- package/reference/prompts/ship-skill.md +347 -0
- package/reference/prompts/ship-templates.md +215 -0
- package/reference/scripts/batch-status.sh +68 -0
- package/reference/scripts/chain-compat-check.sh +67 -0
- package/reference/scripts/context-audit.sh +314 -0
- package/reference/scripts/dead-export-check.sh +61 -0
- package/reference/scripts/generate-qc-tables.sh +92 -0
- package/reference/scripts/harness-init.sh +111 -0
- package/reference/scripts/pai-054-baseline-check.sh +40 -0
- package/reference/scripts/prove-smoke-test.sh +112 -0
- package/reference/scripts/setup-keychain-salt.sh +12 -0
- package/reference/scripts/skill-optimizer-friday.sh +88 -0
- package/reference/scripts/skill-qc-test.sh +351 -0
- package/reference/scripts/skill-synthesize-tonight.sh +66 -0
- package/reference/specs/HARNESS-EXTRACTION-SPEC.md +263 -0
- package/reference/specs/harness-v3-bash-deletion-plan.md +65 -0
- package/reference/specs/harness-v3-migration-plan.md +188 -0
- package/scripts/decision-reconcile.sh +74 -0
- package/scripts/decision-reconcile.ts +152 -0
- package/scripts/extract-constraints.ts +260 -0
- package/scripts/generate-code-map.ts +339 -0
- package/scripts/git-hooks/pre-commit +76 -0
- package/scripts/git-hooks/pre-push +271 -0
- package/scripts/harness-skill-check.sh +52 -0
- package/scripts/lib/gap-emit.sh +65 -0
- package/scripts/lib/jq-update.sh +30 -0
- package/scripts/lib/resolve-slug.sh +30 -0
- package/scripts/lib/verify-spec-compliance.sh +102 -0
- package/scripts/prove-backfill.sh +87 -0
- package/scripts/scaffold-project.ts +1488 -0
- package/scripts/scaffold-rungate-config.ts +91 -0
- package/scripts/self-containment-check.sh +109 -0
- package/scripts/skill-qc-validator.sh +402 -0
- package/scripts/slug-resolver.sh +14 -0
- package/scripts/sync-spec-tests.ts +236 -0
- package/specs/BOOTSTRAP-DATA-FLOW-SPEC.md +2493 -0
- package/specs/BOOTSTRAP-TEST-PLAN.md +571 -0
- package/specs/HARNESS-GATES.md +256 -0
- package/specs/HARNESS-SKILL-CHAIN.md +286 -0
- package/specs/HARNESS-SKILL-CONTRACT.md +93 -0
- package/specs/HARNESS-STANDARD.md +488 -0
- package/specs/SPEC-TEMPLATE.md +53 -0
- package/specs/bootstrap-data-flow.png +0 -0
- package/specs/harness-automation-matrix.md +314 -0
- package/specs/harness-automation-matrix.rules.json +64 -0
- package/test/anti.test.ts +80 -0
- package/test/contract-negative.test.ts +86 -0
- package/test/contract.test.ts +158 -0
- package/test/external-deps.test.ts +48 -0
- package/test/fixtures/golden-project/.env.example +3 -0
- package/test/fixtures/golden-project/Makefile +7 -0
- package/test/fixtures/golden-project/docs/adr/ADR-001-framework.md +23 -0
- package/test/fixtures/golden-project/docs/setup-guide.md +10 -0
- package/test/fixtures/golden-project/package.json +10 -0
- package/test/fixtures/golden-project/specs/api-spec.md +20 -0
- package/test/fixtures/golden-project/src/auth.ts +8 -0
- package/test/fixtures/golden-project/src/db.ts +11 -0
- package/test/fixtures/golden-project/src/index.ts +19 -0
- package/test/fixtures/golden-project/src/utils/format.ts +3 -0
- package/test/fixtures/golden-project/test/auth.test.ts +15 -0
- package/test/fixtures/golden-project/tsconfig.json +12 -0
- package/test/meta-sc-coverage.test.ts +159 -0
- package/test/phase-0.test.ts +846 -0
- package/test/phase-1.test.ts +617 -0
- package/test/phase-2.test.ts +620 -0
- package/test/phase-3.test.ts +99 -0
- package/test/scaffold-conformity.test.ts +8 -0
- package/test/schema-canary.test.ts +51 -0
- package/test/spec-compliance-auto.test.ts +64 -0
- package/test/spec-compliance.test.ts +295 -0
- package/test/spec-discovery.test.ts +68 -0
- package/test/spec-drift.test.ts +5 -0
- package/test/structure.test.ts +165 -0
- package/test/unit/agent-brief-guard-ship.test.ts +293 -0
- package/test/unit/extract-constraints.test.ts +145 -0
- package/test/unit/issue-close-guard.test.ts +204 -0
- package/test/unit/scaffold-project.test.ts +417 -0
- package/test/unit/skill-cooccurrence.test.ts +177 -0
- package/test/unit/skill-sequence-logger.test.ts +244 -0
- package/test/unit/workflow-state-guard.test.ts +95 -0
- package/workflows/batch-ship.js +295 -0
- package/workflows/council.js +481 -0
- package/workflows/prove.js +560 -0
- package/workflows/ship.js +789 -0
- package/workflows/verify.js +236 -0
|
@@ -0,0 +1,429 @@
|
|
|
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
|
+
});
|