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,133 +0,0 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * StaleTTLCleanup.hook.ts — Auto-cleanup stale workflow-state.json and .ship-active files (#256, #270)
4
- *
5
- * TRIGGER: SessionStart
6
- *
7
- * Enforces 4-hour TTL on ship workflow artifacts to prevent stale state from blocking new sessions.
8
- * Preserves files in BUILD, VERIFY, and SCOPE phases (active work).
9
- * 7-day hard TTL on BUILD/VERIFY/SCOPE phase files (zombie prevention).
10
- */
11
-
12
- import { readdirSync, readFileSync, statSync, unlinkSync, existsSync, appendFileSync } from 'fs';
13
- import { join, dirname } from 'path';
14
-
15
- const PAI_WORK = process.env.RUNGATE_WORK_DIR || process.env.PAI_WORK_DIR || join(process.env.HOME!, '.rungate');
16
- const STALE_LOG = join(process.env.HOME!, '.claude', 'state', 'stale-cleanup.log');
17
-
18
- const FOUR_HOURS_MS = 4 * 60 * 60 * 1000;
19
- const SEVEN_DAYS_MS = 7 * 24 * 60 * 60 * 1000;
20
-
21
- if (!existsSync(PAI_WORK)) {
22
- process.exit(0);
23
- }
24
-
25
- let deletedCount = 0;
26
- const now = Date.now();
27
- const timestamp = new Date().toISOString();
28
-
29
- function log(msg: string): void {
30
- try {
31
- appendFileSync(STALE_LOG, `${timestamp} ${msg}\n`);
32
- } catch {
33
- // Log dir may not exist yet
34
- }
35
- }
36
-
37
- function findFiles(dir: string, name: string): string[] {
38
- const results: string[] = [];
39
- try {
40
- const entries = readdirSync(dir, { withFileTypes: true });
41
- for (const entry of entries) {
42
- const fullPath = join(dir, entry.name);
43
- if (entry.isDirectory()) {
44
- results.push(...findFiles(fullPath, name));
45
- } else if (entry.name === name) {
46
- results.push(fullPath);
47
- }
48
- }
49
- } catch {
50
- // Permission errors or missing dirs
51
- }
52
- return results;
53
- }
54
-
55
- // Clean .ship-active files > 4h old
56
- for (const f of findFiles(PAI_WORK, '.ship-active')) {
57
- try {
58
- const stat = statSync(f);
59
- const ageMs = now - stat.mtimeMs;
60
- if (ageMs > FOUR_HOURS_MS) {
61
- const ageMin = Math.floor(ageMs / 60000);
62
- log(`DELETED .ship-active age=${ageMin}m path=${f}`);
63
- unlinkSync(f);
64
- deletedCount++;
65
- }
66
- } catch {
67
- // File may have been deleted between find and stat
68
- }
69
- }
70
-
71
- // Clean workflow-state.json > 4h old (preserve active BUILD/VERIFY/SCOPE phases)
72
- for (const f of findFiles(PAI_WORK, 'workflow-state.json')) {
73
- try {
74
- const stat = statSync(f);
75
- const ageMs = now - stat.mtimeMs;
76
-
77
- const data = JSON.parse(readFileSync(f, 'utf-8'));
78
- const phase = data.phase || '';
79
- const isActivePhase = ['BUILD', 'VERIFY', 'SCOPE'].includes(phase);
80
-
81
- // Hard TTL: BUILD/VERIFY/SCOPE-phase files older than 7 days (zombie prevention)
82
- if (isActivePhase && ageMs > SEVEN_DAYS_MS) {
83
- const ageDays = Math.floor(ageMs / 86400000);
84
- log(`DELETED workflow-state.json age=${ageDays}d phase=${phase} (7-day hard TTL) path=${f}`);
85
- unlinkSync(f);
86
- deletedCount++;
87
- continue;
88
- }
89
-
90
- // Skip active phases for the 4h TTL
91
- if (isActivePhase) continue;
92
-
93
- // GoalRecord TTL exemption (ADR-007): skip if goal-record.json exists in same directory
94
- if (existsSync(join(dirname(f), 'goal-record.json'))) {
95
- log(`EXEMPT goal-record TTL-exempt path=${f}`);
96
- continue;
97
- }
98
-
99
- if (ageMs > FOUR_HOURS_MS) {
100
- const ageMin = Math.floor(ageMs / 60000);
101
- log(`DELETED workflow-state.json age=${ageMin}m phase=${phase || 'unknown'} path=${f}`);
102
- unlinkSync(f);
103
- deletedCount++;
104
- }
105
- } catch {
106
- // Parse or stat failure — skip
107
- }
108
- }
109
-
110
- // Clean up empty directories
111
- try {
112
- const topDirs = readdirSync(PAI_WORK, { withFileTypes: true }).filter(d => d.isDirectory());
113
- for (const d of topDirs) {
114
- const dirPath = join(PAI_WORK, d.name);
115
- try {
116
- const contents = readdirSync(dirPath);
117
- if (contents.length === 0) {
118
- const { rmdirSync } = require('fs');
119
- rmdirSync(dirPath);
120
- }
121
- } catch {
122
- // Skip if can't read or remove
123
- }
124
- }
125
- } catch {
126
- // Skip
127
- }
128
-
129
- if (deletedCount > 0) {
130
- console.log(`Stale TTL cleanup: removed ${deletedCount} files older than 4h`);
131
- } else {
132
- console.log('Stale TTL cleanup: no stale files found');
133
- }
@@ -1,81 +0,0 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * VerifyPhaseLock.hook.ts — PreToolUse on Bash
4
- *
5
- * Blocks `gh issue create` during VERIFY phase.
6
- * Use verifyBlockers[] instead. Allows `gh issue comment`
7
- * and `gh issue create` with --label follow-up.
8
- *
9
- * Issue: #443
10
- */
11
-
12
- import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
13
- import { join } from 'path';
14
- import { parseHookInput } from './lib/parseStdin';
15
-
16
- const WORK_DIR = process.env.RUNGATE_WORK_DIR || process.env.PAI_WORK_DIR || join(process.env.HOME!, '.rungate');
17
-
18
- function findActiveWorkflow(): { path: string; data: any } | null {
19
- if (!existsSync(WORK_DIR)) return null;
20
- let best: { path: string; data: any; mtime: number } | null = null;
21
-
22
- try {
23
- for (const entry of readdirSync(WORK_DIR, { withFileTypes: true })) {
24
- if (!entry.isDirectory()) continue;
25
- const wfPath = join(WORK_DIR, entry.name, 'workflow-state.json');
26
- if (existsSync(wfPath)) {
27
- try {
28
- const data = JSON.parse(readFileSync(wfPath, 'utf-8'));
29
- const mtime = statSync(wfPath).mtimeMs;
30
- if (!best || mtime > best.mtime) {
31
- best = { path: wfPath, data, mtime };
32
- }
33
- } catch {}
34
- }
35
- const nested = join(WORK_DIR, entry.name);
36
- try {
37
- for (const sub of readdirSync(nested, { withFileTypes: true })) {
38
- if (!sub.isDirectory()) continue;
39
- const nestedWf = join(nested, sub.name, 'workflow-state.json');
40
- if (!existsSync(nestedWf)) continue;
41
- try {
42
- const data = JSON.parse(readFileSync(nestedWf, 'utf-8'));
43
- const mtime = statSync(nestedWf).mtimeMs;
44
- if (!best || mtime > best.mtime) {
45
- best = { path: nestedWf, data, mtime };
46
- }
47
- } catch {}
48
- }
49
- } catch {}
50
- }
51
- } catch {}
52
-
53
- return best ? { path: best.path, data: best.data } : null;
54
- }
55
-
56
- async function main() {
57
- const payload = await parseHookInput();
58
- if (!payload) process.exit(0);
59
-
60
- if (payload.tool_name !== 'Bash') process.exit(0);
61
-
62
- const cmd = payload.tool_input?.command || '';
63
- if (!cmd.includes('gh issue create')) process.exit(0);
64
-
65
- const wf = findActiveWorkflow();
66
- if (!wf || wf.data.phase !== 'VERIFY') process.exit(0);
67
-
68
- // Allow follow-up issues
69
- if (cmd.includes('--label') && cmd.includes('follow-up')) process.exit(0);
70
-
71
- // Allow gh issue comment
72
- if (cmd.includes('gh issue comment')) process.exit(0);
73
-
74
- console.log(JSON.stringify({
75
- decision: "block",
76
- reason: "[VerifyPhaseLock] During VERIFY phase, use verifyBlockers[] in workflow-state.json instead of creating new issues. Add --label follow-up to override."
77
- }));
78
- process.exit(0);
79
- }
80
-
81
- main();
@@ -1,37 +0,0 @@
1
- #!/usr/bin/env bun
2
- /**
3
- * WorkflowStateGuard.hook.ts -- PreToolUse on Write, Edit
4
- *
5
- * Blocks direct Write/Edit of workflow-state.json.
6
- * All writes must go through writeWorkflowState() for Zod validation.
7
- */
8
-
9
- import { parseHookInput } from './lib/utils';
10
-
11
- async function main() {
12
- const input = await parseHookInput();
13
- if (!input) process.exit(0);
14
-
15
- const tool = input.tool_name;
16
- if (tool !== 'Write' && tool !== 'Edit') process.exit(0);
17
-
18
- const toolInput = input.tool_input || {};
19
-
20
- // Write tool uses file_path; Edit tool uses file_path
21
- const path = (toolInput.file_path as string) || (toolInput.path as string) || '';
22
-
23
- if (!path.includes('workflow-state.json')) process.exit(0);
24
-
25
- // Block the write
26
- const reason = [
27
- 'BLOCKED: workflow-state.json is protected.',
28
- 'All writes must go through writeWorkflowState() for Zod validation.',
29
- 'Use this pattern instead:',
30
- '',
31
- 'bun -e "import {writeWorkflowState} from \'./gates/orchestrator.ts\'; import {readFileSync} from \'fs\'; const s = JSON.parse(readFileSync(\'WORK_DIR/workflow-state.json\',\'utf8\')); /* apply fix */; writeWorkflowState(\'WORK_DIR/workflow-state.json\', s);"',
32
- ].join('\n');
33
-
34
- console.log(JSON.stringify({ decision: 'block', reason }));
35
- }
36
-
37
- main();
@@ -1,70 +0,0 @@
1
- /**
2
- * Shared Agent Detection — Config-Driven
3
- *
4
- * Reads agent matching patterns from agent-config.json instead of hardcoding.
5
- * Adding new agents requires only a JSON change, zero code changes.
6
- *
7
- * Issue: #374 (extracted from AutoVerifyGate + MarcusCommitCheck)
8
- * Refactored: #382 (config-driven, supports N agents)
9
- */
10
-
11
- import { readFileSync } from 'fs';
12
- import { join, dirname } from 'path';
13
-
14
- interface AgentConfig {
15
- match: string[];
16
- exclude?: string[];
17
- }
18
-
19
- interface AgentConfigFile {
20
- agents: Record<string, AgentConfig>;
21
- }
22
-
23
- export type AgentKey = string;
24
-
25
- export interface DetectedAgent {
26
- key: AgentKey;
27
- name: string;
28
- }
29
-
30
- let _configCache: AgentConfigFile | null = null;
31
-
32
- function loadConfig(): AgentConfigFile {
33
- if (_configCache) return _configCache;
34
- try {
35
- const configPath = join(dirname(new URL(import.meta.url).pathname), 'agent-config.json');
36
- _configCache = JSON.parse(readFileSync(configPath, 'utf-8'));
37
- return _configCache!;
38
- } catch {
39
- return { agents: {} };
40
- }
41
- }
42
-
43
- /**
44
- * Detect which known agent a tool invocation targets.
45
- * Returns null if no agent from config matches.
46
- *
47
- * Detection signals (checked per agent):
48
- * 1. Exclude check — if prompt contains any exclude term, skip agent
49
- * 2. Name contains a match pattern
50
- * 3. subagent_type equals a match pattern
51
- * 4. Prompt contains a match pattern
52
- */
53
- export function detectAgent(toolInput: { name?: string; subagent_type?: string; prompt?: string }): DetectedAgent | null {
54
- const agentName = (toolInput.name || '').toLowerCase();
55
- const agentType = (toolInput.subagent_type || '').toLowerCase();
56
- const prompt = (toolInput.prompt || '').toLowerCase();
57
- const config = loadConfig();
58
-
59
- for (const [key, cfg] of Object.entries(config.agents)) {
60
- const excluded = (cfg.exclude || []).some(ex => prompt.includes(ex));
61
- if (excluded) continue;
62
-
63
- const matched = cfg.match.some(pattern =>
64
- agentName.includes(pattern) || agentType === pattern || prompt.includes(pattern)
65
- );
66
- if (matched) return { key, name: toolInput.name || key };
67
- }
68
-
69
- return null;
70
- }
@@ -1,101 +0,0 @@
1
- /**
2
- * findWorkflow.ts — Shared workflow discovery for hooks
3
- *
4
- * Used by: ScopeGateGuard, AutoVerifyGate
5
- * Issue: #269
6
- *
7
- * Finds workflow-state.json by issue number (preferred) or mtime fallback.
8
- */
9
-
10
- import { readdirSync, readFileSync, existsSync, statSync } from 'fs';
11
- import { join } from 'path';
12
-
13
- const RUNGATE_WORK_DIR = process.env.RUNGATE_WORK_DIR || process.env.RUNGATE_WORK_DIR || join(process.env.HOME!, '.rungate');
14
-
15
- interface WorkflowState {
16
- path: string;
17
- data: any;
18
- slug: string;
19
- }
20
-
21
- export function findWorkflowForIssue(issueNum?: string, phases?: string[], repo?: string, projectRoot?: string): WorkflowState | null {
22
- if (!existsSync(RUNGATE_WORK_DIR)) return null;
23
-
24
- const validPhases = phases || ['BUILD', 'VERIFY', 'SCOPE', 'SHIP', 'DONE'];
25
- let candidates: { path: string; data: any; mtime: number; slug: string }[] = [];
26
-
27
- // Collect all valid workflow entries
28
- const collectWorkflow = (wfPath: string, slug: string) => {
29
- if (!existsSync(wfPath)) return;
30
- try {
31
- const data = JSON.parse(readFileSync(wfPath, 'utf-8'));
32
- if (!validPhases.includes(data.phase)) return;
33
- const mtime = statSync(wfPath).mtimeMs;
34
- candidates.push({ path: wfPath, data, mtime, slug });
35
- } catch {}
36
- };
37
-
38
- try {
39
- const dirs = readdirSync(RUNGATE_WORK_DIR, { withFileTypes: true })
40
- .filter(d => d.isDirectory());
41
-
42
- for (const d of dirs) {
43
- // Level 1: direct children
44
- collectWorkflow(join(RUNGATE_WORK_DIR, d.name, 'workflow-state.json'), d.name);
45
-
46
- // Level 2: nested subdirectories (e.g., pai/361)
47
- const subDir = join(RUNGATE_WORK_DIR, d.name);
48
- try {
49
- const subDirs = readdirSync(subDir, { withFileTypes: true }).filter(sd => sd.isDirectory());
50
- for (const sd of subDirs) {
51
- collectWorkflow(join(subDir, sd.name, 'workflow-state.json'), `${d.name}/${sd.name}`);
52
- }
53
- } catch {}
54
- }
55
- } catch {}
56
-
57
- if (candidates.length === 0) return null;
58
-
59
- // Resolution priority: projectRoot > issueNum > mtime fallback
60
-
61
- // Priority 1: Match by projectRoot
62
- if (projectRoot) {
63
- const byRoot = candidates.filter(c => c.data.projectRoot === projectRoot);
64
- if (byRoot.length === 1) return { path: byRoot[0].path, data: byRoot[0].data, slug: byRoot[0].slug };
65
- if (byRoot.length > 1) {
66
- // Multiple matches — narrow by issue if available
67
- if (issueNum) {
68
- const rootAndIssue = byRoot.find(c => String(c.data.issue) === issueNum);
69
- if (rootAndIssue) return { path: rootAndIssue.path, data: rootAndIssue.data, slug: rootAndIssue.slug };
70
- }
71
- // Return most recent among projectRoot matches
72
- byRoot.sort((a, b) => b.mtime - a.mtime);
73
- return { path: byRoot[0].path, data: byRoot[0].data, slug: byRoot[0].slug };
74
- }
75
- }
76
-
77
- // Priority 2: Match by issue number
78
- if (issueNum) {
79
- const byIssue = candidates.filter(c => String(c.data.issue) === issueNum);
80
- if (byIssue.length > 0) {
81
- // Narrow by repo if provided
82
- if (repo) {
83
- const byRepo = byIssue.find(c => c.data.repo === repo);
84
- if (byRepo) return { path: byRepo.path, data: byRepo.data, slug: byRepo.slug };
85
- }
86
- return { path: byIssue[0].path, data: byIssue[0].data, slug: byIssue[0].slug };
87
- }
88
- }
89
-
90
- // If issueNum was specified but not matched, don't fall back to mtime
91
- if (issueNum) return null;
92
-
93
- // Priority 3: Most recent by mtime (last resort)
94
- candidates.sort((a, b) => b.mtime - a.mtime);
95
- return { path: candidates[0].path, data: candidates[0].data, slug: candidates[0].slug };
96
- }
97
-
98
- export function extractIssueNumber(text: string): string | undefined {
99
- const match = text.match(/#(\d+)/);
100
- return match ? match[1] : undefined;
101
- }
@@ -1,37 +0,0 @@
1
- /**
2
- * Shared Stdin Parsing
3
- *
4
- * Centralizes JSON stdin reading used by all hooks.
5
- * Single source of truth — replaces stream, text, and event patterns.
6
- *
7
- * Issue: #370 (extracted from 34 hooks)
8
- */
9
-
10
- export interface HookInput {
11
- tool_name?: string;
12
- tool_input?: { command?: string; file_path?: string; prompt?: string; [k: string]: unknown };
13
- tool_response?: { output?: string; [k: string]: unknown } | string;
14
- session_id?: string;
15
- transcript_path?: string;
16
- hook_event_name?: string;
17
- [k: string]: unknown;
18
- }
19
-
20
- /**
21
- * Read and parse JSON from stdin with timeout.
22
- * Returns parsed object or null on failure/timeout/empty.
23
- */
24
- export async function parseHookInput<T = HookInput>(timeoutMs = 2000): Promise<T | null> {
25
- try {
26
- const raw = await Promise.race([
27
- Bun.stdin.text(),
28
- new Promise<string>((_, reject) =>
29
- setTimeout(() => reject(new Error('stdin timeout')), timeoutMs),
30
- ),
31
- ]);
32
- if (!raw?.trim()) return null;
33
- return JSON.parse(raw) as T;
34
- } catch {
35
- return null;
36
- }
37
- }
@@ -1,111 +0,0 @@
1
- /**
2
- * Centralized Path Resolution
3
- *
4
- * Handles environment variable expansion for portable PAI configuration.
5
- * Claude Code doesn't expand $HOME in settings.json env values, so we do it here.
6
- *
7
- * Usage:
8
- * import { getPaiDir, getSettingsPath } from './lib/paths';
9
- * const paiDir = getPaiDir(); // Always returns expanded absolute path
10
- */
11
-
12
- import { homedir } from 'os';
13
- import { join } from 'path';
14
-
15
- /**
16
- * Expand shell variables in a path string
17
- * Supports: $HOME, ${HOME}, ~
18
- */
19
- export function expandPath(path: string): string {
20
- const home = homedir();
21
-
22
- return path
23
- .replace(/^\$HOME(?=\/|$)/, home)
24
- .replace(/^\$\{HOME\}(?=\/|$)/, home)
25
- .replace(/^~(?=\/|$)/, home);
26
- }
27
-
28
- /**
29
- * Get the PAI directory (expanded)
30
- * Priority: PAI_DIR env var (expanded) → ~/.claude
31
- */
32
- export function getPaiDir(): string {
33
- const envPaiDir = process.env.PAI_DIR;
34
-
35
- if (envPaiDir) {
36
- return expandPath(envPaiDir);
37
- }
38
-
39
- return join(homedir(), '.claude');
40
- }
41
-
42
- /**
43
- * Get the settings.json path
44
- */
45
- export function getSettingsPath(): string {
46
- return join(getPaiDir(), 'settings.json');
47
- }
48
-
49
- /**
50
- * Get a path relative to PAI_DIR
51
- */
52
- export function paiPath(...segments: string[]): string {
53
- return join(getPaiDir(), ...segments);
54
- }
55
-
56
- /**
57
- * Get the hooks directory
58
- * Priority: PAI_HOOKS_DIR env var → ~/.pai/hooks
59
- */
60
- export function getHooksDir(): string {
61
- const envHooksDir = process.env.PAI_HOOKS_DIR;
62
- if (envHooksDir) return expandPath(envHooksDir);
63
- return join(homedir(), '.pai', 'hooks');
64
- }
65
-
66
- /**
67
- * Get the skills directory
68
- */
69
- export function getSkillsDir(): string {
70
- return paiPath('skills');
71
- }
72
-
73
- /**
74
- * Get the MEMORY directory
75
- */
76
- export function getMemoryDir(): string {
77
- return paiPath('MEMORY');
78
- }
79
-
80
- /**
81
- * Get the PAI work directory (expanded)
82
- * Priority: RUNGATE_WORK_DIR env var (expanded) → ~/.rungate
83
- */
84
- export function getWorkDir(): string {
85
- const envWorkDir = process.env.RUNGATE_WORK_DIR;
86
-
87
- if (envWorkDir) {
88
- return expandPath(envWorkDir);
89
- }
90
-
91
- return join(homedir(), '.rungate');
92
- }
93
-
94
- /**
95
- * Get a path relative to WORK_DIR
96
- */
97
- export function workPath(...segments: string[]): string {
98
- return join(getWorkDir(), ...segments);
99
- }
100
-
101
- /**
102
- * Get the signals directory
103
- */
104
- export function getSignalDir(): string {
105
- return workPath('signals');
106
- }
107
-
108
- // Convenience constants (evaluated once at module load)
109
- export const BASE_DIR = getPaiDir();
110
- export const WORK_DIR = getWorkDir();
111
- export const SIGNAL_DIR = getSignalDir();
@@ -1,81 +0,0 @@
1
- import { readdirSync, readFileSync, existsSync, statSync } from 'fs';
2
- import { join } from 'path';
3
-
4
- export const WORK_DIR = join(process.env.RUNGATE_WORK_DIR || process.env.HOME!, '.rungate');
5
- export const HARNESS_ROOT = process.env.HARNESS_ROOT || join(process.env.HOME!, 'Projects', 'rungate');
6
-
7
- export interface HookInput {
8
- tool_name?: string;
9
- tool_input?: { command?: string; name?: string; subagent_type?: string; prompt?: string; [k: string]: unknown };
10
- tool_response?: { output?: string; content?: string; [k: string]: unknown } | string;
11
- session_id?: string;
12
- [k: string]: unknown;
13
- }
14
-
15
- export async function parseHookInput(timeoutMs = 2000): Promise<HookInput | null> {
16
- try {
17
- const raw = await Promise.race([
18
- Bun.stdin.text(),
19
- new Promise<string>((_, reject) => setTimeout(() => reject(new Error('timeout')), timeoutMs)),
20
- ]);
21
- if (!raw?.trim()) return null;
22
- return JSON.parse(raw) as HookInput;
23
- } catch { return null; }
24
- }
25
-
26
- const AGENT_CONFIG: Record<string, { match: string[]; exclude: string[] }> = {
27
- marcus: { match: ['marcus', 'engineer', 'marcus webb'], exclude: ['council'] },
28
- quinn: { match: ['quinn', 'qatester', 'quinn torres'], exclude: [] },
29
- rook: { match: ['rook', 'pentester', 'rook blackburn'], exclude: [] },
30
- };
31
-
32
- export function detectAgent(toolInput: { name?: string; subagent_type?: string; prompt?: string }): { key: string; name: string } | null {
33
- const name = (toolInput.name || '').toLowerCase();
34
- const type = (toolInput.subagent_type || '').toLowerCase();
35
- const prompt = (toolInput.prompt || '').toLowerCase();
36
- for (const [key, cfg] of Object.entries(AGENT_CONFIG)) {
37
- if (cfg.exclude.some(ex => prompt.includes(ex))) continue;
38
- if (cfg.match.some(p => name.includes(p) || type === p || prompt.includes(p)))
39
- return { key, name: toolInput.name || key };
40
- }
41
- return null;
42
- }
43
-
44
- export interface WorkflowResult { path: string; data: any; slug: string }
45
-
46
- export function findWorkflowState(issueNum?: string, phases?: string[]): WorkflowResult | null {
47
- if (!existsSync(WORK_DIR)) return null;
48
- const validPhases = phases || ['BUILD', 'VERIFY', 'SCOPE', 'SHIP', 'DONE'];
49
- const candidates: (WorkflowResult & { mtime: number })[] = [];
50
-
51
- const collect = (wfPath: string, slug: string) => {
52
- if (!existsSync(wfPath)) return;
53
- try {
54
- const data = JSON.parse(readFileSync(wfPath, 'utf-8'));
55
- if (!validPhases.includes(data.phase)) return;
56
- candidates.push({ path: wfPath, data, slug, mtime: statSync(wfPath).mtimeMs });
57
- } catch {}
58
- };
59
-
60
- try {
61
- for (const d of readdirSync(WORK_DIR, { withFileTypes: true }).filter(d => d.isDirectory())) {
62
- collect(join(WORK_DIR, d.name, 'workflow-state.json'), d.name);
63
- try {
64
- for (const sd of readdirSync(join(WORK_DIR, d.name), { withFileTypes: true }).filter(sd => sd.isDirectory()))
65
- collect(join(WORK_DIR, d.name, sd.name, 'workflow-state.json'), `${d.name}/${sd.name}`);
66
- } catch {}
67
- }
68
- } catch {}
69
-
70
- if (!candidates.length) return null;
71
- if (issueNum) {
72
- const match = candidates.find(c => String(c.data.issue) === issueNum);
73
- return match ? { path: match.path, data: match.data, slug: match.slug } : null;
74
- }
75
- candidates.sort((a, b) => b.mtime - a.mtime);
76
- return { path: candidates[0].path, data: candidates[0].data, slug: candidates[0].slug };
77
- }
78
-
79
- export function extractIssueNumber(text: string): string | undefined {
80
- return text.match(/#(\d+)/)?.[1];
81
- }