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