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,586 +0,0 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * AgentBriefGuard.hook.ts — PreToolUse on Agent
4
- *
5
- * TRIGGER: PreToolUse (matcher: Agent)
6
- *
7
- * PURPOSE:
8
- * Validate that every named agent spawn uses the brief template from
9
- * BRIEF-TEMPLATES.md, has bypassPermissions mode, and gets sizing-aware
10
- * max_turns. Also inject single-attempt constraint.
11
- *
12
- * BYPASS (evaluated before name detection — exit 0 if any match):
13
- * B1. Council: prompt contains "council" (case-insensitive) → skip all validation
14
- * B2. Research: prompt contains "research|investigate|audit" AND lacks
15
- * implementation markers (## Task + ## Verify) → skip all validation
16
- * B3. No active ship: .ship-active absent or stale (>4h) → skip all validation
17
- * EXCEPTION: Engineer (Marcus) never bypasses — falls through to Check 3
18
- *
19
- * CHECKS (only reached during active ship with non-bypassed agents):
20
- * 1. bypassPermissions: BLOCK if mode !== "bypassPermissions"
21
- * 2. Template markers: BLOCK (Engineer) or WARN (others) if missing required markers
22
- * 3. Ship-active marker (Engineer only): BLOCK if no valid .ship-active in ~/.rungate/
23
- * 4. max_turns: WARN if not set (inject reminder)
24
- * 5. Single-attempt constraint: inject system-reminder
25
- * 6. Brief content policies: WARN if prompt missing required content patterns (from brief-policies.json)
26
- *
27
- * Named agents (matched via subagent_type or tool_input.name):
28
- * - Marcus / Engineer: ## Context, ## Task, ## Verify, ## Report back
29
- * - Quinn / QATester: ## Context, ## Environment, ## What to test, ## Report back
30
- * - Rook / Pentester: ## Context, ## Files changed this session, ## Report back
31
- * - Serena / Architect: ## Context, ## Decision needed, ## Report back
32
- * - Aditi / Designer: ## Context, ## Task, ## Design direction
33
- *
34
- * For non-named agents → exit 0 silently.
35
- *
36
- * INPUT:
37
- * - stdin: PreToolUse JSON payload { tool_name, tool_input }
38
- *
39
- * OUTPUT:
40
- * - stdout: JSON block decision OR system-reminder injection
41
- * - stderr: status messages
42
- * - exit(0): always
43
- */
44
-
45
- import {
46
- appendFileSync,
47
- existsSync,
48
- mkdirSync,
49
- readdirSync,
50
- readFileSync,
51
- statSync,
52
- } from 'fs';
53
- import { join } from 'path';
54
- import { BASE_DIR, WORK_DIR } from './lib/paths';
55
- import { parseHookInput } from './lib/parseStdin';
56
-
57
- const SIGNALS_DIR = join(BASE_DIR, 'MEMORY', 'LEARNING', 'SIGNALS');
58
- const SIGNALS_FILE = join(SIGNALS_DIR, 'signals.jsonl');
59
-
60
- // Named agent definitions: name patterns → required template markers
61
- interface AgentDef {
62
- names: string[]; // case-insensitive patterns to match in tool_input.name
63
- subagentTypes: string[]; // subagent_type values to match
64
- markers: string[]; // required template section headers
65
- label: string; // display name for logs/messages
66
- }
67
-
68
- const NAMED_AGENTS: AgentDef[] = [
69
- {
70
- names: ['marcus', 'engineer'],
71
- subagentTypes: ['Engineer'],
72
- markers: ['## Context', '## Task', '## Verify', '## Report back'],
73
- label: 'Marcus',
74
- },
75
- {
76
- names: ['quinn', 'qatester', 'qa tester'],
77
- subagentTypes: ['QATester'],
78
- markers: ['## Context', '## Environment', '## What to test', '## Report back'],
79
- label: 'Quinn',
80
- },
81
- {
82
- names: ['rook', 'pentester'],
83
- subagentTypes: ['Pentester'],
84
- markers: ['## Context', '## Files changed this session', '## Report back'],
85
- label: 'Rook',
86
- },
87
- {
88
- names: ['serena', 'architect'],
89
- subagentTypes: ['Architect'],
90
- markers: ['## Context', '## Decision needed', '## Report back'],
91
- label: 'Serena',
92
- },
93
- {
94
- names: ['aditi', 'designer'],
95
- subagentTypes: ['Designer'],
96
- markers: ['## Context', '## Task', '## Design direction'],
97
- label: 'Aditi',
98
- },
99
- ];
100
-
101
- // Sizing → max_turns mapping
102
- const SIZE_MAX_TURNS: Record<string, number> = {
103
- XS: 20,
104
- S: 30,
105
- M: 50,
106
- L: 75,
107
- };
108
- const DEFAULT_MAX_TURNS = 30;
109
-
110
- interface HookInput {
111
- tool_name?: string;
112
- tool_input?: {
113
- prompt?: string;
114
- description?: string;
115
- mode?: string;
116
- model?: string;
117
- subagent_type?: string;
118
- max_turns?: number;
119
- run_in_background?: boolean;
120
- isolation?: string;
121
- name?: string;
122
- [k: string]: unknown;
123
- };
124
- }
125
-
126
-
127
- function logSignal(event: Record<string, unknown>): void {
128
- try {
129
- if (!existsSync(SIGNALS_DIR)) mkdirSync(SIGNALS_DIR, { recursive: true });
130
- if (existsSync(SIGNALS_FILE)) {
131
- appendFileSync(SIGNALS_FILE, JSON.stringify(event) + '\n', 'utf-8');
132
- }
133
- } catch (err) {
134
- console.error(`[AgentBriefGuard] Signal log write failed: ${err}`);
135
- }
136
- }
137
-
138
- /**
139
- * Detect which named agent (if any) is being spawned.
140
- * Checks subagent_type first, then matches name patterns against tool_input.name only.
141
- */
142
- function detectAgent(input: HookInput): AgentDef | null {
143
- const toolInput = input.tool_input || {};
144
- const subagentType = (toolInput.subagent_type || '').trim();
145
- const agentName = (toolInput.name || '').toLowerCase();
146
-
147
- for (const agent of NAMED_AGENTS) {
148
- // Check subagent_type first (most reliable)
149
- if (subagentType && agent.subagentTypes.includes(subagentType)) {
150
- return agent;
151
- }
152
- // Fall back to name pattern matching in tool_input.name only
153
- if (agentName) {
154
- for (const name of agent.names) {
155
- if (agentName.includes(name.toLowerCase())) {
156
- return agent;
157
- }
158
- }
159
- }
160
- }
161
- return null;
162
- }
163
-
164
- /**
165
- * Find the most recent checkpoint and extract sizing.
166
- * Looks for **Size:** or ## Sizing in CHECKPOINT.md files.
167
- */
168
- function findSizingFromCheckpoint(): string | null {
169
- try {
170
- if (!existsSync(WORK_DIR)) return null;
171
-
172
- // Get subdirectories sorted by mtime (most recent first)
173
- const entries = readdirSync(WORK_DIR)
174
- .map(name => {
175
- const full = join(WORK_DIR, name);
176
- try {
177
- const stat = statSync(full);
178
- return { name, mtime: stat.mtimeMs, isDir: stat.isDirectory() };
179
- } catch (err) {
180
- console.error(`[brief-guard] statSync failed for ${full}: ${err}`);
181
- return null;
182
- }
183
- })
184
- .filter((e): e is NonNullable<typeof e> => e !== null && e.isDir)
185
- .sort((a, b) => b.mtime - a.mtime);
186
-
187
- // Check up to 5 most recent directories for a checkpoint with sizing
188
- for (const entry of entries.slice(0, 5)) {
189
- const checkpointPath = join(WORK_DIR, entry.name, 'CHECKPOINT.md');
190
- if (!existsSync(checkpointPath)) continue;
191
-
192
- try {
193
- const content = readFileSync(checkpointPath, 'utf-8');
194
- // Match **Size:** XS/S/M/L or ## Sizing ... XS/S/M/L
195
- const sizeMatch = content.match(/\*\*Size:\*\*\s*(XS|S|M|L)\b/i)
196
- || content.match(/##\s*Sizing[\s\S]*?\b(XS|S|M|L)\b/i);
197
- if (sizeMatch) {
198
- return sizeMatch[1].toUpperCase();
199
- }
200
- } catch (err) {
201
- console.error(`[brief-guard] checkpoint read failed for ${checkpointPath}: ${err}`);
202
- continue;
203
- }
204
- }
205
- return null;
206
- } catch (err) {
207
- console.error(`[brief-guard] findSizingFromCheckpoint failed: ${err}`);
208
- return null;
209
- }
210
- }
211
-
212
- // Ship-active marker TTL: 4 hours in milliseconds
213
- const SHIP_MARKER_TTL_MS = 4 * 60 * 60 * 1000;
214
-
215
- interface ShipMarker {
216
- issue: number;
217
- ts: string;
218
- }
219
-
220
- /**
221
- * Scan ~/.rungate/ directories for .ship-active marker files.
222
- * Returns the most recent valid marker, or null if none found.
223
- */
224
- function checkShipActive(): ShipMarker | null {
225
- if (!existsSync(WORK_DIR)) return null;
226
-
227
- const markers: ShipMarker[] = [];
228
-
229
- try {
230
- const entries = readdirSync(WORK_DIR, { withFileTypes: true });
231
- for (const entry of entries) {
232
- if (!entry.isDirectory()) continue;
233
- const markerPath = join(WORK_DIR, entry.name, '.ship-active');
234
- if (!existsSync(markerPath)) continue;
235
-
236
- try {
237
- const raw = readFileSync(markerPath, 'utf-8').trim();
238
- if (!raw.startsWith('{')) {
239
- console.error(`[brief-guard] marker not JSON object at ${markerPath}: starts with "${raw.slice(0, 20)}"`);
240
- continue;
241
- }
242
- const parsed = JSON.parse(raw) as ShipMarker;
243
- if (parsed.issue && parsed.ts) {
244
- markers.push(parsed);
245
- }
246
- } catch (err) {
247
- console.error(`[brief-guard] malformed marker at ${markerPath}: ${err}`);
248
- }
249
- }
250
-
251
- // Nested scan for 2-level slugs (e.g., pai/352/)
252
- for (const entry of entries) {
253
- if (!entry.isDirectory()) continue;
254
- try {
255
- const subEntries = readdirSync(join(WORK_DIR, entry.name), { withFileTypes: true });
256
- for (const sub of subEntries) {
257
- if (!sub.isDirectory()) continue;
258
- const nestedMarkerPath = join(WORK_DIR, entry.name, sub.name, '.ship-active');
259
- if (!existsSync(nestedMarkerPath)) continue;
260
- try {
261
- const raw = readFileSync(nestedMarkerPath, 'utf-8').trim();
262
- if (!raw.startsWith('{')) {
263
- console.error(`[brief-guard] nested marker not JSON object at ${nestedMarkerPath}: starts with "${raw.slice(0, 20)}"`);
264
- continue;
265
- }
266
- const parsed = JSON.parse(raw) as ShipMarker;
267
- if (parsed.issue && parsed.ts) markers.push(parsed);
268
- } catch (err) {
269
- console.error(`[brief-guard] malformed nested marker at ${nestedMarkerPath}: ${err}`);
270
- }
271
- }
272
- } catch (err) {
273
- console.error(`[brief-guard] nested scan failed for ${join(WORK_DIR, entry.name)}: ${err}`);
274
- }
275
- }
276
- } catch (err) {
277
- console.error(`[brief-guard] checkShipActive scan failed: ${err}`);
278
- return null;
279
- }
280
-
281
- if (markers.length === 0) return null;
282
-
283
- // Return most recent by ts field
284
- markers.sort((a, b) => new Date(b.ts).getTime() - new Date(a.ts).getTime());
285
- return markers[0];
286
- }
287
-
288
- function checkWorkflowState(): ShipMarker | null {
289
- if (!existsSync(WORK_DIR)) return null;
290
- const BUILD_PHASES = ['BUILD', 'VERIFY', 'SHIP', 'DONE'];
291
- try {
292
- const entries = readdirSync(WORK_DIR, { withFileTypes: true });
293
- for (const entry of entries) {
294
- if (!entry.isDirectory()) continue;
295
- const wfPath = join(WORK_DIR, entry.name, 'workflow-state.json');
296
- if (!existsSync(wfPath)) continue;
297
- try {
298
- const raw = readFileSync(wfPath, 'utf-8').trim();
299
- if (!raw.startsWith('{')) continue;
300
- const wf = JSON.parse(raw);
301
- if (wf.issue && wf.phase && BUILD_PHASES.includes(wf.phase)) {
302
- return { issue: wf.issue, ts: new Date().toISOString() };
303
- }
304
- } catch { /* skip malformed */ }
305
- }
306
- } catch { /* skip scan errors */ }
307
- return null;
308
- }
309
-
310
-
311
- /**
312
- * Validate brief content against policies from brief-policies.json.
313
- * Returns list of missing content field names. Empty = all present.
314
- */
315
- function validateBriefPolicies(agent: AgentDef, prompt: string): string[] {
316
- const policyPath = join(BASE_DIR, 'skills', 'ship', 'brief-policies.json');
317
- if (!existsSync(policyPath)) return [];
318
-
319
- try {
320
- const raw = readFileSync(policyPath, 'utf-8').trim();
321
- if (!raw.startsWith('{')) {
322
- console.error(`[brief-guard] brief-policies.json not JSON object: starts with "${raw.slice(0, 20)}"`);
323
- return [];
324
- }
325
- const policies = JSON.parse(raw);
326
- const agentKey = agent.label.toLowerCase();
327
- const policy = policies.policies?.[agentKey];
328
- if (!policy?.requiredPatterns) return [];
329
-
330
- const missing: string[] = [];
331
- for (const req of policy.requiredPatterns) {
332
- const regex = new RegExp(req.pattern, 'i');
333
- if (!regex.test(prompt)) {
334
- missing.push(req.name);
335
- }
336
- }
337
- return missing;
338
- } catch (err) {
339
- console.error(`[brief-guard] validateBriefPolicies failed: ${err}`);
340
- return [];
341
- }
342
- }
343
-
344
- async function main() {
345
- const input = await parseHookInput();
346
- if (!input) process.exit(0);
347
-
348
- try {
349
- // Only process Agent tool calls
350
- if (input.tool_name !== 'Agent') {
351
- process.exit(0);
352
- }
353
-
354
- const toolInput = input.tool_input || {};
355
-
356
- // === Early bypass checks (before name detection) ===
357
- // These prevent council, research, and non-ship agents from being
358
- // blocked by the specialist name detection that follows.
359
- // Order: council → research → ship-active → then name detection.
360
- const rawPrompt = toolInput.prompt || '';
361
-
362
- // Bypass 1: Council agents — never need brief templates
363
- if (/\bcouncil\b/i.test(rawPrompt)) {
364
- console.error('[AgentBriefGuard] Bypass — council agent detected');
365
- process.exit(0);
366
- }
367
-
368
- // Bypass 2: Research/investigate/audit agents without implementation markers
369
- // If prompt has implementation brief markers (## Task + ## Verify), it's an
370
- // implementation agent that happens to mention research — don't bypass.
371
- const isResearchAgent = /\b(research|investigate|audit)\b/i.test(rawPrompt);
372
- const hasImplementationMarkers = rawPrompt.includes('## Task') && rawPrompt.includes('## Verify');
373
- if (isResearchAgent && !hasImplementationMarkers) {
374
- console.error('[AgentBriefGuard] Bypass — research/investigate/audit agent (no implementation markers)');
375
- process.exit(0);
376
- }
377
-
378
- // === Name detection (moved before Bypass 3 so Engineer check works) ===
379
- const agent = detectAgent(input);
380
-
381
- // Bypass 3: No active ship session → no brief validation needed
382
- // Brief templates are only enforced during active ship workflows.
383
- // EXCEPTION: Engineer (Marcus) agents NEVER bypass — they must always
384
- // reach Check 3 which blocks direct spawns without an active ship session.
385
- const earlyShipMarker = checkShipActive();
386
- const shipIsActive = earlyShipMarker
387
- && (Date.now() - new Date(earlyShipMarker.ts).getTime()) <= SHIP_MARKER_TTL_MS;
388
- if (!shipIsActive && agent?.label !== 'Marcus') {
389
- console.error('[AgentBriefGuard] Bypass — no active ship session');
390
- process.exit(0);
391
- }
392
-
393
- // Non-named agent → exit silently
394
- if (!agent) {
395
- process.exit(0);
396
- }
397
-
398
- const prompt = rawPrompt;
399
- const outputs: string[] = [];
400
-
401
- // Check 1: bypassPermissions
402
- const hasBypass = toolInput.mode === 'bypassPermissions';
403
- if (!hasBypass) {
404
- const decision = {
405
- decision: 'block',
406
- reason: `${agent.label} agent must use mode: "bypassPermissions". Current mode: "${toolInput.mode || 'not set'}". Without bypassPermissions, the agent hangs on permission prompts nobody sees. Add mode: "bypassPermissions" to the Agent call.`,
407
- };
408
- console.log(JSON.stringify(decision));
409
-
410
- logSignal({
411
- ts: new Date().toISOString(),
412
- type: 'agent_spawn',
413
- agent: agent.label.toLowerCase(),
414
- has_template: false,
415
- has_bypass: false,
416
- blocked: true,
417
- block_reason: 'missing_bypass_permissions',
418
- });
419
-
420
- console.error(`[AgentBriefGuard] BLOCKED ${agent.label} — missing bypassPermissions`);
421
- process.exit(0);
422
- }
423
-
424
- // Check 2: Template markers
425
- const isEngineer = agent.label === 'Marcus';
426
- const missingMarkers = agent.markers.filter(
427
- marker => !prompt.includes(marker)
428
- );
429
- if (missingMarkers.length > 0) {
430
- if (isEngineer) {
431
- // Engineer: hard BLOCK — template is mandatory
432
- const decision = {
433
- decision: 'block',
434
- reason: `${agent.label} brief doesn't use template from BRIEF-TEMPLATES.md. Missing required markers: ${missingMarkers.join(', ')}. Read BRIEF-TEMPLATES.md (in harness repo) and use the ${agent.label} template.`,
435
- };
436
- console.log(JSON.stringify(decision));
437
-
438
- logSignal({
439
- ts: new Date().toISOString(),
440
- type: 'agent_spawn',
441
- agent: agent.label.toLowerCase(),
442
- has_template: false,
443
- has_bypass: true,
444
- blocked: true,
445
- block_reason: 'missing_template_markers',
446
- missing_markers: missingMarkers,
447
- });
448
-
449
- console.error(
450
- `[AgentBriefGuard] BLOCKED ${agent.label} — missing template markers: ${missingMarkers.join(', ')}`
451
- );
452
- process.exit(0);
453
- } else {
454
- // Non-Engineer: advisory WARN — template recommended, not required
455
- console.error(
456
- `[AgentBriefGuard] WARN ${agent.label} — missing template markers (advisory): ${missingMarkers.join(', ')}`
457
- );
458
- const advisory = [
459
- '<system-reminder>',
460
- `ADVISORY: ${agent.label} brief is missing recommended template markers from BRIEF-TEMPLATES.md: ${missingMarkers.join(', ')}. Using the template improves agent output quality. Read BRIEF-TEMPLATES.md (in harness repo) for the ${agent.label} template.`,
461
- '</system-reminder>',
462
- ].join('\n');
463
- console.log(advisory);
464
-
465
- logSignal({
466
- ts: new Date().toISOString(),
467
- type: 'agent_spawn_advisory',
468
- agent: agent.label.toLowerCase(),
469
- has_template: false,
470
- has_bypass: true,
471
- blocked: false,
472
- advisory_reason: 'missing_template_markers',
473
- missing_markers: missingMarkers,
474
- });
475
- }
476
- }
477
-
478
- // Check 3: Ship-active marker (Engineer only)
479
- // Marcus must be spawned through ship — direct spawns bypass SCOPE.
480
- if (isEngineer) {
481
- const shipMarker = checkShipActive() || checkWorkflowState();
482
- const isStale = shipMarker
483
- ? (Date.now() - new Date(shipMarker.ts).getTime()) > SHIP_MARKER_TTL_MS
484
- : true;
485
-
486
- if (!shipMarker || isStale) {
487
- const decision = {
488
- decision: 'block',
489
- reason: `Engineer (Marcus) requires an active ship session. No .ship-active marker found in ~/.rungate/. Run Skill('ship') first — ship writes the marker during SCOPE. Direct Engineer spawns bypass SCOPE (templates, ACs, DISCOVERY, sizing) and produce incomplete gate artifacts.`,
490
- };
491
- console.log(JSON.stringify(decision));
492
-
493
- logSignal({
494
- ts: new Date().toISOString(),
495
- type: 'agent_spawn',
496
- agent: agent.label.toLowerCase(),
497
- has_template: true,
498
- has_bypass: true,
499
- blocked: true,
500
- block_reason: 'no_ship_session',
501
- stale_marker: shipMarker ? true : false,
502
- });
503
-
504
- console.error(
505
- `[AgentBriefGuard] BLOCKED ${agent.label} — no_ship_session${shipMarker ? ' (stale marker)' : ''}`
506
- );
507
- process.exit(0);
508
- }
509
- }
510
-
511
- // Check 6: Brief content policy validation (WARN only, never blocks)
512
- const policyMissing = validateBriefPolicies(agent, prompt);
513
- if (policyMissing.length > 0) {
514
- console.error(
515
- `[AgentBriefGuard] BRIEF CONTENT WARN: ${agent.label} brief missing: ${policyMissing.join(', ')}`
516
- );
517
- outputs.push(
518
- `BRIEF CONTENT WARN: ${agent.label} brief missing: ${policyMissing.join(', ')}. See BRIEF-TEMPLATES/${agent.label.toLowerCase()}.md for required content.`
519
- );
520
-
521
- logSignal({
522
- ts: new Date().toISOString(),
523
- type: 'agent_spawn_content_warn',
524
- agent: agent.label.toLowerCase(),
525
- missing_content: policyMissing,
526
- blocked: false,
527
- });
528
- }
529
-
530
- // All checks passed — inject advisory and single-attempt constraint
531
-
532
- // Check 4: max_turns advisory
533
- const sizing = findSizingFromCheckpoint();
534
- const recommendedMaxTurns = sizing
535
- ? SIZE_MAX_TURNS[sizing] || DEFAULT_MAX_TURNS
536
- : DEFAULT_MAX_TURNS;
537
-
538
- if (!toolInput.max_turns) {
539
- outputs.push(
540
- `NOTE: No max_turns set for ${agent.label}. ` +
541
- `Recommended: ${recommendedMaxTurns} (sizing: ${sizing || 'unknown'}).`
542
- );
543
- }
544
-
545
- // Check 5: Single-attempt constraint
546
- outputs.push(
547
- `SCOPE CONSTRAINT: Try to resolve errors within a few attempts. If you encounter a persistent error you cannot fix:`,
548
- `1. STOP — do not attempt 10+ different approaches`,
549
- `2. Report back: what you tried, the exact error, your hypothesis`,
550
- `3. Do NOT work around errors silently — surface them`
551
- );
552
-
553
- if (outputs.length > 0) {
554
- const reminder = [
555
- '<system-reminder>',
556
- ...outputs,
557
- '</system-reminder>',
558
- ].join('\n');
559
- console.log(reminder);
560
- }
561
-
562
- // Log successful spawn
563
- logSignal({
564
- ts: new Date().toISOString(),
565
- type: 'agent_spawn',
566
- agent: agent.label.toLowerCase(),
567
- has_template: true,
568
- has_bypass: true,
569
- max_turns: toolInput.max_turns || null,
570
- recommended_max_turns: recommendedMaxTurns,
571
- sizing: sizing || 'unknown',
572
- blocked: false,
573
- });
574
-
575
- console.error(
576
- `[AgentBriefGuard] ${agent.label} spawn validated — template OK, bypass OK, sizing: ${sizing || 'unknown'}`
577
- );
578
-
579
- process.exit(0);
580
- } catch (err) {
581
- console.error(`[AgentBriefGuard] Error: ${err}`);
582
- process.exit(0);
583
- }
584
- }
585
-
586
- main();