moflo 4.8.26 → 4.8.29

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 (260) hide show
  1. package/.claude/agents/browser/browser-agent.yaml +182 -182
  2. package/.claude/agents/core/coder.md +265 -265
  3. package/.claude/agents/core/planner.md +167 -167
  4. package/.claude/agents/core/researcher.md +189 -189
  5. package/.claude/agents/core/reviewer.md +325 -325
  6. package/.claude/agents/core/tester.md +318 -318
  7. package/.claude/agents/database-specialist.yaml +21 -21
  8. package/.claude/agents/dual-mode/codex-coordinator.md +224 -224
  9. package/.claude/agents/dual-mode/codex-worker.md +211 -211
  10. package/.claude/agents/dual-mode/dual-orchestrator.md +291 -291
  11. package/.claude/agents/flow-nexus/app-store.md +88 -0
  12. package/.claude/agents/flow-nexus/authentication.md +69 -0
  13. package/.claude/agents/flow-nexus/challenges.md +81 -0
  14. package/.claude/agents/flow-nexus/neural-network.md +88 -0
  15. package/.claude/agents/flow-nexus/payments.md +83 -0
  16. package/.claude/agents/flow-nexus/sandbox.md +76 -0
  17. package/.claude/agents/flow-nexus/swarm.md +76 -0
  18. package/.claude/agents/flow-nexus/user-tools.md +96 -0
  19. package/.claude/agents/flow-nexus/workflow.md +84 -0
  20. package/.claude/agents/github/code-review-swarm.md +537 -537
  21. package/.claude/agents/github/github-modes.md +172 -172
  22. package/.claude/agents/github/issue-tracker.md +318 -318
  23. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  24. package/.claude/agents/github/pr-manager.md +190 -190
  25. package/.claude/agents/github/project-board-sync.md +508 -508
  26. package/.claude/agents/github/release-manager.md +366 -366
  27. package/.claude/agents/github/release-swarm.md +582 -582
  28. package/.claude/agents/github/repo-architect.md +397 -397
  29. package/.claude/agents/github/swarm-issue.md +572 -572
  30. package/.claude/agents/github/swarm-pr.md +427 -427
  31. package/.claude/agents/github/sync-coordinator.md +451 -451
  32. package/.claude/agents/github/workflow-automation.md +634 -634
  33. package/.claude/agents/goal/code-goal-planner.md +445 -445
  34. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  35. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  36. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  37. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  38. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  39. package/.claude/agents/index.yaml +17 -17
  40. package/.claude/agents/neural/safla-neural.md +73 -73
  41. package/.claude/agents/payments/agentic-payments.md +126 -0
  42. package/.claude/agents/project-coordinator.yaml +15 -15
  43. package/.claude/agents/python-specialist.yaml +21 -21
  44. package/.claude/agents/reasoning/goal-planner.md +72 -72
  45. package/.claude/agents/security-auditor.yaml +20 -20
  46. package/.claude/agents/sona/sona-learning-optimizer.md +74 -0
  47. package/.claude/agents/sublinear/consensus-coordinator.md +338 -0
  48. package/.claude/agents/sublinear/matrix-optimizer.md +185 -0
  49. package/.claude/agents/sublinear/pagerank-analyzer.md +299 -0
  50. package/.claude/agents/sublinear/performance-optimizer.md +368 -0
  51. package/.claude/agents/sublinear/trading-predictor.md +246 -0
  52. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  53. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  54. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  55. package/.claude/agents/templates/migration-plan.md +745 -745
  56. package/.claude/agents/typescript-specialist.yaml +21 -21
  57. package/.claude/agents/v3/adr-architect.md +184 -0
  58. package/.claude/agents/v3/aidefence-guardian.md +282 -0
  59. package/.claude/agents/v3/claims-authorizer.md +208 -0
  60. package/.claude/agents/v3/collective-intelligence-coordinator.md +993 -0
  61. package/.claude/agents/v3/ddd-domain-expert.md +220 -0
  62. package/.claude/agents/v3/injection-analyst.md +236 -0
  63. package/.claude/agents/v3/memory-specialist.md +995 -0
  64. package/.claude/agents/v3/performance-engineer.md +1233 -0
  65. package/.claude/agents/v3/pii-detector.md +151 -0
  66. package/.claude/agents/v3/reasoningbank-learner.md +213 -0
  67. package/.claude/agents/v3/security-architect-aidefence.md +410 -0
  68. package/.claude/agents/v3/security-architect.md +867 -0
  69. package/.claude/agents/v3/security-auditor.md +771 -0
  70. package/.claude/agents/v3/sparc-orchestrator.md +182 -0
  71. package/.claude/agents/v3/swarm-memory-manager.md +157 -0
  72. package/.claude/agents/v3/v3-integration-architect.md +205 -0
  73. package/.claude/checkpoints/1767754460.json +8 -8
  74. package/.claude/commands/agents/agent-spawning.md +28 -28
  75. package/.claude/commands/analysis/COMMAND_COMPLIANCE_REPORT.md +54 -0
  76. package/.claude/commands/analysis/README.md +9 -0
  77. package/.claude/commands/analysis/bottleneck-detect.md +162 -0
  78. package/.claude/commands/analysis/performance-bottlenecks.md +59 -0
  79. package/.claude/commands/analysis/performance-report.md +25 -0
  80. package/.claude/commands/analysis/token-efficiency.md +45 -0
  81. package/.claude/commands/analysis/token-usage.md +25 -0
  82. package/.claude/commands/automation/README.md +9 -0
  83. package/.claude/commands/automation/auto-agent.md +122 -0
  84. package/.claude/commands/automation/self-healing.md +106 -0
  85. package/.claude/commands/automation/session-memory.md +90 -0
  86. package/.claude/commands/automation/smart-agents.md +73 -0
  87. package/.claude/commands/automation/smart-spawn.md +25 -0
  88. package/.claude/commands/automation/workflow-select.md +25 -0
  89. package/.claude/commands/github/github-modes.md +146 -146
  90. package/.claude/commands/github/github-swarm.md +121 -121
  91. package/.claude/commands/github/issue-tracker.md +291 -291
  92. package/.claude/commands/github/pr-manager.md +169 -169
  93. package/.claude/commands/github/release-manager.md +337 -337
  94. package/.claude/commands/github/repo-architect.md +366 -366
  95. package/.claude/commands/github/sync-coordinator.md +300 -300
  96. package/.claude/commands/memory/neural.md +47 -47
  97. package/.claude/commands/monitoring/README.md +9 -0
  98. package/.claude/commands/monitoring/agent-metrics.md +25 -0
  99. package/.claude/commands/monitoring/agents.md +44 -0
  100. package/.claude/commands/monitoring/real-time-view.md +25 -0
  101. package/.claude/commands/monitoring/status.md +46 -0
  102. package/.claude/commands/monitoring/swarm-monitor.md +25 -0
  103. package/.claude/commands/optimization/README.md +9 -0
  104. package/.claude/commands/optimization/auto-topology.md +62 -0
  105. package/.claude/commands/optimization/cache-manage.md +25 -0
  106. package/.claude/commands/optimization/parallel-execute.md +25 -0
  107. package/.claude/commands/optimization/parallel-execution.md +50 -0
  108. package/.claude/commands/optimization/topology-optimize.md +25 -0
  109. package/.claude/commands/sparc/analyzer.md +51 -51
  110. package/.claude/commands/sparc/architect.md +53 -53
  111. package/.claude/commands/sparc/ask.md +97 -97
  112. package/.claude/commands/sparc/batch-executor.md +54 -54
  113. package/.claude/commands/sparc/code.md +89 -89
  114. package/.claude/commands/sparc/coder.md +54 -54
  115. package/.claude/commands/sparc/debug.md +83 -83
  116. package/.claude/commands/sparc/debugger.md +54 -54
  117. package/.claude/commands/sparc/designer.md +53 -53
  118. package/.claude/commands/sparc/devops.md +109 -109
  119. package/.claude/commands/sparc/docs-writer.md +80 -80
  120. package/.claude/commands/sparc/documenter.md +54 -54
  121. package/.claude/commands/sparc/innovator.md +54 -54
  122. package/.claude/commands/sparc/integration.md +83 -83
  123. package/.claude/commands/sparc/mcp.md +117 -117
  124. package/.claude/commands/sparc/memory-manager.md +54 -54
  125. package/.claude/commands/sparc/optimizer.md +54 -54
  126. package/.claude/commands/sparc/orchestrator.md +131 -131
  127. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  128. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  129. package/.claude/commands/sparc/researcher.md +54 -54
  130. package/.claude/commands/sparc/reviewer.md +54 -54
  131. package/.claude/commands/sparc/security-review.md +80 -80
  132. package/.claude/commands/sparc/sparc-modes.md +174 -174
  133. package/.claude/commands/sparc/sparc.md +111 -111
  134. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  135. package/.claude/commands/sparc/supabase-admin.md +348 -348
  136. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  137. package/.claude/commands/sparc/tdd.md +54 -54
  138. package/.claude/commands/sparc/tester.md +54 -54
  139. package/.claude/commands/sparc/tutorial.md +79 -79
  140. package/.claude/commands/sparc/workflow-manager.md +54 -54
  141. package/.claude/commands/sparc.md +166 -166
  142. package/.claude/commands/swarm/analysis.md +95 -95
  143. package/.claude/commands/swarm/development.md +96 -96
  144. package/.claude/commands/swarm/examples.md +168 -168
  145. package/.claude/commands/swarm/maintenance.md +102 -102
  146. package/.claude/commands/swarm/optimization.md +117 -117
  147. package/.claude/commands/swarm/research.md +136 -136
  148. package/.claude/commands/swarm/testing.md +131 -131
  149. package/.claude/commands/workflows/development.md +77 -77
  150. package/.claude/commands/workflows/research.md +62 -62
  151. package/.claude/guidance/moflo-bootstrap.md +126 -126
  152. package/.claude/guidance/shipped/agent-bootstrap.md +148 -143
  153. package/.claude/guidance/shipped/guidance-memory-strategy.md +262 -262
  154. package/.claude/guidance/shipped/memory-strategy.md +204 -204
  155. package/.claude/guidance/shipped/moflo.md +668 -675
  156. package/.claude/guidance/shipped/task-icons.md +42 -0
  157. package/.claude/guidance/shipped/task-swarm-integration.md +441 -441
  158. package/.claude/helpers/gate-hook.mjs +50 -0
  159. package/.claude/helpers/gate.cjs +138 -0
  160. package/.claude/helpers/hook-handler.cjs +76 -0
  161. package/.claude/helpers/intelligence.cjs +207 -207
  162. package/.claude/helpers/prompt-hook.mjs +72 -0
  163. package/.claude/helpers/statusline.cjs +851 -851
  164. package/.claude/scripts/build-embeddings.mjs +549 -0
  165. package/.claude/scripts/generate-code-map.mjs +776 -0
  166. package/.claude/scripts/hooks.mjs +656 -0
  167. package/.claude/scripts/index-guidance.mjs +893 -0
  168. package/.claude/scripts/index-tests.mjs +710 -0
  169. package/.claude/scripts/semantic-search.mjs +473 -0
  170. package/.claude/scripts/session-start-launcher.mjs +238 -0
  171. package/.claude/settings.local.json +18 -0
  172. package/.claude/skills/fl/SKILL.md +583 -583
  173. package/.claude/skills/flo/SKILL.md +583 -583
  174. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  175. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  176. package/.claude/skills/github-project-management/SKILL.md +1277 -1277
  177. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  178. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  179. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  180. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  181. package/.claude/skills/pair-programming/SKILL.md +1202 -0
  182. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  183. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  184. package/.claude/skills/stream-chain/SKILL.md +563 -0
  185. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  186. package/.claude/skills/v3-cli-modernization/SKILL.md +872 -0
  187. package/.claude/skills/v3-core-implementation/SKILL.md +797 -0
  188. package/.claude/skills/v3-ddd-architecture/SKILL.md +442 -0
  189. package/.claude/skills/v3-integration-deep/SKILL.md +241 -0
  190. package/.claude/skills/v3-mcp-optimization/SKILL.md +777 -0
  191. package/.claude/skills/v3-memory-unification/SKILL.md +174 -0
  192. package/.claude/skills/v3-performance-optimization/SKILL.md +390 -0
  193. package/.claude/skills/v3-security-overhaul/SKILL.md +82 -0
  194. package/.claude/skills/v3-swarm-coordination/SKILL.md +340 -0
  195. package/.claude/workflow-state.json +5 -5
  196. package/LICENSE +21 -21
  197. package/README.md +698 -685
  198. package/bin/cli.js +0 -0
  199. package/bin/gate-hook.mjs +50 -50
  200. package/bin/gate.cjs +138 -138
  201. package/bin/generate-code-map.mjs +956 -938
  202. package/bin/hook-handler.cjs +83 -83
  203. package/bin/hooks.mjs +696 -696
  204. package/bin/index-guidance.mjs +906 -893
  205. package/bin/index-tests.mjs +729 -710
  206. package/bin/lib/process-manager.mjs +256 -256
  207. package/bin/lib/registry-cleanup.cjs +41 -41
  208. package/bin/prompt-hook.mjs +72 -72
  209. package/bin/semantic-search.mjs +472 -472
  210. package/bin/session-start-launcher.mjs +238 -238
  211. package/bin/setup-project.mjs +253 -251
  212. package/package.json +123 -123
  213. package/src/@claude-flow/cli/README.md +452 -452
  214. package/src/@claude-flow/cli/bin/cli.js +180 -180
  215. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  216. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  217. package/src/@claude-flow/cli/dist/src/commands/doctor.js +1107 -1091
  218. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  219. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  220. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  221. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  222. package/src/@claude-flow/cli/dist/src/commands/init.js +3 -8
  223. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  224. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  225. package/src/@claude-flow/cli/dist/src/config/moflo-config.d.ts +3 -0
  226. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +101 -91
  227. package/src/@claude-flow/cli/dist/src/index.d.ts +5 -0
  228. package/src/@claude-flow/cli/dist/src/index.js +44 -0
  229. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  230. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +89 -87
  231. package/src/@claude-flow/cli/dist/src/init/executor.js +453 -453
  232. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  233. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  234. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +904 -848
  235. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +876 -876
  236. package/src/@claude-flow/cli/dist/src/mcp-tools/hooks-tools.js +5 -11
  237. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  238. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  239. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +197 -0
  240. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +584 -0
  241. package/src/@claude-flow/cli/dist/src/services/daemon-lock.d.ts +14 -0
  242. package/src/@claude-flow/cli/dist/src/services/daemon-lock.js +1 -1
  243. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  244. package/src/@claude-flow/cli/package.json +106 -106
  245. package/src/@claude-flow/guidance/README.md +1195 -1195
  246. package/src/@claude-flow/guidance/package.json +198 -198
  247. package/src/@claude-flow/memory/README.md +587 -587
  248. package/src/@claude-flow/memory/dist/agentdb-backend.js +26 -26
  249. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +27 -27
  250. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +245 -0
  251. package/src/@claude-flow/memory/dist/hybrid-backend.js +569 -0
  252. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +8 -0
  253. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +320 -0
  254. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +121 -0
  255. package/src/@claude-flow/memory/dist/sqlite-backend.js +572 -0
  256. package/src/@claude-flow/memory/dist/sqljs-backend.js +26 -26
  257. package/src/@claude-flow/memory/package.json +44 -44
  258. package/src/@claude-flow/shared/README.md +323 -323
  259. package/src/@claude-flow/shared/dist/events/event-store.js +31 -31
  260. package/src/README.md +493 -493
@@ -7,54 +7,54 @@ import { generateStatuslineScript } from './statusline-generator.js';
7
7
  * Generate pre-commit hook script
8
8
  */
9
9
  export function generatePreCommitHook() {
10
- return `#!/bin/bash
11
- # Claude Flow Pre-Commit Hook
12
- # Validates code quality before commit
13
-
14
- set -e
15
-
16
- echo "🔍 Running Claude Flow pre-commit checks..."
17
-
18
- # Get staged files
19
- STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
20
-
21
- # Run validation for each staged file
22
- for FILE in $STAGED_FILES; do
23
- if [[ "$FILE" =~ \\.(ts|js|tsx|jsx)$ ]]; then
24
- echo " Validating: $FILE"
25
- npx moflo hooks pre-edit --file "$FILE" --validate-syntax 2>/dev/null || true
26
- fi
27
- done
28
-
29
- # Run tests if available
30
- if [ -f "package.json" ] && grep -q '"test"' package.json; then
31
- echo "🧪 Running tests..."
32
- npm test --if-present 2>/dev/null || echo " Tests skipped or failed"
33
- fi
34
-
35
- echo "✅ Pre-commit checks complete"
10
+ return `#!/bin/bash
11
+ # Claude Flow Pre-Commit Hook
12
+ # Validates code quality before commit
13
+
14
+ set -e
15
+
16
+ echo "🔍 Running Claude Flow pre-commit checks..."
17
+
18
+ # Get staged files
19
+ STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
20
+
21
+ # Run validation for each staged file
22
+ for FILE in $STAGED_FILES; do
23
+ if [[ "$FILE" =~ \\.(ts|js|tsx|jsx)$ ]]; then
24
+ echo " Validating: $FILE"
25
+ npx moflo hooks pre-edit --file "$FILE" --validate-syntax 2>/dev/null || true
26
+ fi
27
+ done
28
+
29
+ # Run tests if available
30
+ if [ -f "package.json" ] && grep -q '"test"' package.json; then
31
+ echo "🧪 Running tests..."
32
+ npm test --if-present 2>/dev/null || echo " Tests skipped or failed"
33
+ fi
34
+
35
+ echo "✅ Pre-commit checks complete"
36
36
  `;
37
37
  }
38
38
  /**
39
39
  * Generate post-commit hook script
40
40
  */
41
41
  export function generatePostCommitHook() {
42
- return `#!/bin/bash
43
- # Claude Flow Post-Commit Hook
44
- # Records commit metrics and trains patterns
45
-
46
- COMMIT_HASH=$(git rev-parse HEAD)
47
- COMMIT_MSG=$(git log -1 --pretty=%B)
48
-
49
- echo "📊 Recording commit metrics..."
50
-
51
- # Notify claude-flow of commit
52
- npx moflo hooks notify \\
53
- --message "Commit: $COMMIT_MSG" \\
54
- --level info \\
55
- --metadata '{"hash": "'$COMMIT_HASH'"}' 2>/dev/null || true
56
-
57
- echo "✅ Commit recorded"
42
+ return `#!/bin/bash
43
+ # Claude Flow Post-Commit Hook
44
+ # Records commit metrics and trains patterns
45
+
46
+ COMMIT_HASH=$(git rev-parse HEAD)
47
+ COMMIT_MSG=$(git log -1 --pretty=%B)
48
+
49
+ echo "📊 Recording commit metrics..."
50
+
51
+ # Notify claude-flow of commit
52
+ npx moflo hooks notify \\
53
+ --message "Commit: $COMMIT_MSG" \\
54
+ --level info \\
55
+ --metadata '{"hash": "'$COMMIT_HASH'"}' 2>/dev/null || true
56
+
57
+ echo "✅ Commit recorded"
58
58
  `;
59
59
  }
60
60
  /**
@@ -63,110 +63,110 @@ echo "✅ Commit recorded"
63
63
  * @claude-flow/memory is not installed. Gets overwritten when source copy succeeds.
64
64
  */
65
65
  export function generateAutoMemoryHook() {
66
- return `#!/usr/bin/env node
67
- /**
68
- * Auto Memory Bridge Hook (ADR-048/049) — Minimal Fallback
69
- * Full version is copied from package source when available.
70
- *
71
- * Usage:
72
- * node auto-memory-hook.mjs import # SessionStart
73
- * node auto-memory-hook.mjs sync # SessionEnd / Stop
74
- * node auto-memory-hook.mjs status # Show bridge status
75
- */
76
-
77
- import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
78
- import { join, dirname } from 'path';
79
- import { fileURLToPath } from 'url';
80
-
81
- const __filename = fileURLToPath(import.meta.url);
82
- const __dirname = dirname(__filename);
83
- const PROJECT_ROOT = join(__dirname, '../..');
84
- const DATA_DIR = join(PROJECT_ROOT, '.claude-flow', 'data');
85
- const STORE_PATH = join(DATA_DIR, 'auto-memory-store.json');
86
-
87
- const DIM = '\\x1b[2m';
88
- const RESET = '\\x1b[0m';
89
- const dim = (msg) => console.log(\` \${DIM}\${msg}\${RESET}\`);
90
-
91
- // Ensure data dir
92
- if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true });
93
-
94
- async function loadMemoryPackage() {
95
- // Strategy 1: Use createRequire for CJS-style resolution (handles nested node_modules
96
- // when installed as a transitive dependency via npx ruflo / npx claude-flow)
97
- try {
98
- const { createRequire } = await import('module');
99
- const require = createRequire(join(PROJECT_ROOT, 'package.json'));
100
- return require('@claude-flow/memory');
101
- } catch { /* fall through */ }
102
-
103
- // Strategy 2: ESM import (works when @claude-flow/memory is a direct dependency)
104
- try { return await import('@claude-flow/memory'); } catch { /* fall through */ }
105
-
106
- // Strategy 3: Walk up from PROJECT_ROOT looking for the package in any node_modules
107
- let searchDir = PROJECT_ROOT;
108
- const { parse } = await import('path');
109
- while (searchDir !== parse(searchDir).root) {
110
- const candidate = join(searchDir, 'node_modules', '@claude-flow', 'memory', 'dist', 'index.js');
111
- if (existsSync(candidate)) {
112
- try { return await import(\`file://\${candidate}\`); } catch { /* fall through */ }
113
- }
114
- searchDir = dirname(searchDir);
115
- }
116
-
117
- return null;
118
- }
119
-
120
- async function doImport() {
121
- const memPkg = await loadMemoryPackage();
122
-
123
- if (!memPkg || !memPkg.AutoMemoryBridge) {
124
- dim('Memory package not available — auto memory import skipped (non-critical)');
125
- return;
126
- }
127
-
128
- // Full implementation deferred to copied version
129
- dim('Auto memory import available — run init --upgrade for full support');
130
- }
131
-
132
- async function doSync() {
133
- if (!existsSync(STORE_PATH)) {
134
- dim('No entries to sync');
135
- return;
136
- }
137
-
138
- const memPkg = await loadMemoryPackage();
139
-
140
- if (!memPkg || !memPkg.AutoMemoryBridge) {
141
- dim('Memory package not available — sync skipped (non-critical)');
142
- return;
143
- }
144
-
145
- dim('Auto memory sync available — run init --upgrade for full support');
146
- }
147
-
148
- function doStatus() {
149
- console.log('\\n=== Auto Memory Bridge Status ===\\n');
150
- console.log(' Package: Fallback mode (run init --upgrade for full)');
151
- console.log(\` Store: \${existsSync(STORE_PATH) ? 'Initialized' : 'Not initialized'}\`);
152
- console.log('');
153
- }
154
-
155
- const command = process.argv[2] || 'status';
156
-
157
- try {
158
- switch (command) {
159
- case 'import': await doImport(); break;
160
- case 'sync': await doSync(); break;
161
- case 'status': doStatus(); break;
162
- default:
163
- console.log('Usage: auto-memory-hook.mjs <import|sync|status>');
164
- process.exit(1);
165
- }
166
- } catch (err) {
167
- // Hooks must never crash Claude Code - fail silently
168
- dim(\`Error (non-critical): \${err.message}\`);
169
- }
66
+ return `#!/usr/bin/env node
67
+ /**
68
+ * Auto Memory Bridge Hook (ADR-048/049) — Minimal Fallback
69
+ * Full version is copied from package source when available.
70
+ *
71
+ * Usage:
72
+ * node auto-memory-hook.mjs import # SessionStart
73
+ * node auto-memory-hook.mjs sync # SessionEnd / Stop
74
+ * node auto-memory-hook.mjs status # Show bridge status
75
+ */
76
+
77
+ import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
78
+ import { join, dirname } from 'path';
79
+ import { fileURLToPath } from 'url';
80
+
81
+ const __filename = fileURLToPath(import.meta.url);
82
+ const __dirname = dirname(__filename);
83
+ const PROJECT_ROOT = join(__dirname, '../..');
84
+ const DATA_DIR = join(PROJECT_ROOT, '.claude-flow', 'data');
85
+ const STORE_PATH = join(DATA_DIR, 'auto-memory-store.json');
86
+
87
+ const DIM = '\\x1b[2m';
88
+ const RESET = '\\x1b[0m';
89
+ const dim = (msg) => console.log(\` \${DIM}\${msg}\${RESET}\`);
90
+
91
+ // Ensure data dir
92
+ if (!existsSync(DATA_DIR)) mkdirSync(DATA_DIR, { recursive: true });
93
+
94
+ async function loadMemoryPackage() {
95
+ // Strategy 1: Use createRequire for CJS-style resolution (handles nested node_modules
96
+ // when installed as a transitive dependency via npx ruflo / npx claude-flow)
97
+ try {
98
+ const { createRequire } = await import('module');
99
+ const require = createRequire(join(PROJECT_ROOT, 'package.json'));
100
+ return require('@claude-flow/memory');
101
+ } catch { /* fall through */ }
102
+
103
+ // Strategy 2: ESM import (works when @claude-flow/memory is a direct dependency)
104
+ try { return await import('@claude-flow/memory'); } catch { /* fall through */ }
105
+
106
+ // Strategy 3: Walk up from PROJECT_ROOT looking for the package in any node_modules
107
+ let searchDir = PROJECT_ROOT;
108
+ const { parse } = await import('path');
109
+ while (searchDir !== parse(searchDir).root) {
110
+ const candidate = join(searchDir, 'node_modules', '@claude-flow', 'memory', 'dist', 'index.js');
111
+ if (existsSync(candidate)) {
112
+ try { return await import(\`file://\${candidate}\`); } catch { /* fall through */ }
113
+ }
114
+ searchDir = dirname(searchDir);
115
+ }
116
+
117
+ return null;
118
+ }
119
+
120
+ async function doImport() {
121
+ const memPkg = await loadMemoryPackage();
122
+
123
+ if (!memPkg || !memPkg.AutoMemoryBridge) {
124
+ dim('Memory package not available — auto memory import skipped (non-critical)');
125
+ return;
126
+ }
127
+
128
+ // Full implementation deferred to copied version
129
+ dim('Auto memory import available — run init --upgrade for full support');
130
+ }
131
+
132
+ async function doSync() {
133
+ if (!existsSync(STORE_PATH)) {
134
+ dim('No entries to sync');
135
+ return;
136
+ }
137
+
138
+ const memPkg = await loadMemoryPackage();
139
+
140
+ if (!memPkg || !memPkg.AutoMemoryBridge) {
141
+ dim('Memory package not available — sync skipped (non-critical)');
142
+ return;
143
+ }
144
+
145
+ dim('Auto memory sync available — run init --upgrade for full support');
146
+ }
147
+
148
+ function doStatus() {
149
+ console.log('\\n=== Auto Memory Bridge Status ===\\n');
150
+ console.log(' Package: Fallback mode (run init --upgrade for full)');
151
+ console.log(\` Store: \${existsSync(STORE_PATH) ? 'Initialized' : 'Not initialized'}\`);
152
+ console.log('');
153
+ }
154
+
155
+ const command = process.argv[2] || 'status';
156
+
157
+ try {
158
+ switch (command) {
159
+ case 'import': await doImport(); break;
160
+ case 'sync': await doSync(); break;
161
+ case 'status': doStatus(); break;
162
+ default:
163
+ console.log('Usage: auto-memory-hook.mjs <import|sync|status>');
164
+ process.exit(1);
165
+ }
166
+ } catch (err) {
167
+ // Hooks must never crash Claude Code - fail silently
168
+ dim(\`Error (non-critical): \${err.message}\`);
169
+ }
170
170
  `;
171
171
  }
172
172
  /**
@@ -194,144 +194,144 @@ export function generateHelpers(options) {
194
194
  * on every tool call (~500ms npx overhead → ~20ms direct node).
195
195
  */
196
196
  export function generateGateScript() {
197
- return `#!/usr/bin/env node
198
- 'use strict';
199
- var fs = require('fs');
200
- var path = require('path');
201
-
202
- var PROJECT_DIR = (process.env.CLAUDE_PROJECT_DIR || process.cwd()).replace(/^\\/([a-z])\\//i, '$1:/');
203
- var STATE_FILE = path.join(PROJECT_DIR, '.claude', 'workflow-state.json');
204
-
205
- function readState() {
206
- try {
207
- if (fs.existsSync(STATE_FILE)) return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
208
- } catch (e) { /* reset on corruption */ }
209
- return { tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: null, lastBlockedAt: null };
210
- }
211
-
212
- function writeState(s) {
213
- try {
214
- var dir = path.dirname(STATE_FILE);
215
- if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
216
- fs.writeFileSync(STATE_FILE, JSON.stringify(s, null, 2));
217
- } catch (e) { /* non-fatal */ }
218
- }
219
-
220
- // Load moflo.yaml gate config (defaults: all enabled)
221
- function loadGateConfig() {
222
- var defaults = { memory_first: true, task_create_first: true, context_tracking: true };
223
- try {
224
- var yamlPath = path.join(PROJECT_DIR, 'moflo.yaml');
225
- if (fs.existsSync(yamlPath)) {
226
- var content = fs.readFileSync(yamlPath, 'utf-8');
227
- if (/memory_first:\\s*false/i.test(content)) defaults.memory_first = false;
228
- if (/task_create_first:\\s*false/i.test(content)) defaults.task_create_first = false;
229
- if (/context_tracking:\\s*false/i.test(content)) defaults.context_tracking = false;
230
- }
231
- } catch (e) { /* use defaults */ }
232
- return defaults;
233
- }
234
-
235
- var config = loadGateConfig();
236
- var command = process.argv[2];
237
-
238
- var EXEMPT = ['.claude/', '.claude\\\\', 'CLAUDE.md', 'MEMORY.md', 'workflow-state', 'node_modules'];
239
- var DANGEROUS = ['rm -rf /', 'format c:', 'del /s /q c:\\\\', ':(){:|:&};:', 'mkfs.', '> /dev/sda'];
240
- var DIRECTIVE_RE = /^(yes|no|yeah|yep|nope|sure|ok|okay|correct|right|exactly|perfect)\\b/i;
241
- var TASK_RE = /\\b(fix|bug|error|implement|add|create|build|write|refactor|debug|test|feature|issue|security|optimi)\\b/i;
242
-
243
- switch (command) {
244
- case 'check-before-agent': {
245
- var s = readState();
246
- // Hard gate: memory must be searched
247
- if (config.memory_first && s.memoryRequired && !s.memorySearched) {
248
- process.stderr.write('BLOCKED: Search memory (mcp__moflo__memory_search) before spawning agents.\\n');
249
- process.exit(2);
250
- }
251
- // Soft gate: TaskCreate recommended but not blocking
252
- // (TaskCreate PostToolUse doesn't fire in Claude Code, so we can't track it reliably)
253
- if (config.task_create_first && !s.tasksCreated) {
254
- process.stdout.write('REMINDER: Use TaskCreate before spawning agents. Task tool is blocked until then.\\n');
255
- }
256
- break;
257
- }
258
- case 'check-before-scan': {
259
- if (!config.memory_first) break;
260
- var s = readState();
261
- if (s.memorySearched || !s.memoryRequired) break;
262
- var target = (process.env.TOOL_INPUT_pattern || '') + ' ' + (process.env.TOOL_INPUT_path || '');
263
- if (EXEMPT.some(function(p) { return target.indexOf(p) >= 0; })) break;
264
- process.stderr.write('BLOCKED: Search memory before exploring files. Use mcp__moflo__memory_search.\\n');
265
- process.exit(2);
266
- }
267
- case 'check-before-read': {
268
- if (!config.memory_first) break;
269
- var s = readState();
270
- if (s.memorySearched || !s.memoryRequired) break;
271
- var fp = process.env.TOOL_INPUT_file_path || '';
272
- if (fp.indexOf('.claude/guidance/') < 0 && fp.indexOf('.claude\\\\guidance\\\\') < 0) break;
273
- process.stderr.write('BLOCKED: Search memory before reading guidance files. Use mcp__moflo__memory_search.\\n');
274
- process.exit(2);
275
- }
276
- case 'record-task-created': {
277
- var s = readState();
278
- s.tasksCreated = true;
279
- s.taskCount = (s.taskCount || 0) + 1;
280
- writeState(s);
281
- break;
282
- }
283
- case 'record-memory-searched': {
284
- var s = readState();
285
- s.memorySearched = true;
286
- writeState(s);
287
- break;
288
- }
289
- case 'check-bash-memory': {
290
- var cmd = process.env.TOOL_INPUT_command || '';
291
- if (/semantic-search|memory search|memory retrieve|memory-search/.test(cmd)) {
292
- var s = readState();
293
- s.memorySearched = true;
294
- writeState(s);
295
- }
296
- break;
297
- }
298
- case 'check-dangerous-command': {
299
- var cmd = (process.env.TOOL_INPUT_command || '').toLowerCase();
300
- for (var i = 0; i < DANGEROUS.length; i++) {
301
- if (cmd.indexOf(DANGEROUS[i]) >= 0) {
302
- console.log('[BLOCKED] Dangerous command: ' + DANGEROUS[i]);
303
- process.exit(2);
304
- }
305
- }
306
- break;
307
- }
308
- case 'prompt-reminder': {
309
- var s = readState();
310
- s.memorySearched = false;
311
- var prompt = process.env.CLAUDE_USER_PROMPT || '';
312
- s.memoryRequired = prompt.length >= 4 && !DIRECTIVE_RE.test(prompt) && (TASK_RE.test(prompt) || prompt.length > 80);
313
- s.interactionCount = (s.interactionCount || 0) + 1;
314
- writeState(s);
315
- if (!s.tasksCreated) console.log('REMINDER: Use TaskCreate before spawning agents. Task tool is blocked until then.');
316
- if (config.context_tracking) {
317
- var ic = s.interactionCount;
318
- if (ic > 30) console.log('Context: CRITICAL. Commit, store learnings, suggest new session.');
319
- else if (ic > 20) console.log('Context: DEPLETED. Checkpoint progress. Recommend /compact or fresh session.');
320
- else if (ic > 10) console.log('Context: MODERATE. Re-state goal before architectural decisions. Use agents for >300 LOC.');
321
- }
322
- break;
323
- }
324
- case 'compact-guidance': {
325
- console.log('Pre-Compact: Check CLAUDE.md for rules. Use memory search to recover context after compact.');
326
- break;
327
- }
328
- case 'session-reset': {
329
- writeState({ tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: new Date().toISOString(), lastBlockedAt: null });
330
- break;
331
- }
332
- default:
333
- break;
334
- }
197
+ return `#!/usr/bin/env node
198
+ 'use strict';
199
+ var fs = require('fs');
200
+ var path = require('path');
201
+
202
+ var PROJECT_DIR = (process.env.CLAUDE_PROJECT_DIR || process.cwd()).replace(/^\\/([a-z])\\//i, '$1:/');
203
+ var STATE_FILE = path.join(PROJECT_DIR, '.claude', 'workflow-state.json');
204
+
205
+ function readState() {
206
+ try {
207
+ if (fs.existsSync(STATE_FILE)) return JSON.parse(fs.readFileSync(STATE_FILE, 'utf-8'));
208
+ } catch (e) { /* reset on corruption */ }
209
+ return { tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: null, lastBlockedAt: null };
210
+ }
211
+
212
+ function writeState(s) {
213
+ try {
214
+ var dir = path.dirname(STATE_FILE);
215
+ if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
216
+ fs.writeFileSync(STATE_FILE, JSON.stringify(s, null, 2));
217
+ } catch (e) { /* non-fatal */ }
218
+ }
219
+
220
+ // Load moflo.yaml gate config (defaults: all enabled)
221
+ function loadGateConfig() {
222
+ var defaults = { memory_first: true, task_create_first: true, context_tracking: true };
223
+ try {
224
+ var yamlPath = path.join(PROJECT_DIR, 'moflo.yaml');
225
+ if (fs.existsSync(yamlPath)) {
226
+ var content = fs.readFileSync(yamlPath, 'utf-8');
227
+ if (/memory_first:\\s*false/i.test(content)) defaults.memory_first = false;
228
+ if (/task_create_first:\\s*false/i.test(content)) defaults.task_create_first = false;
229
+ if (/context_tracking:\\s*false/i.test(content)) defaults.context_tracking = false;
230
+ }
231
+ } catch (e) { /* use defaults */ }
232
+ return defaults;
233
+ }
234
+
235
+ var config = loadGateConfig();
236
+ var command = process.argv[2];
237
+
238
+ var EXEMPT = ['.claude/', '.claude\\\\', 'CLAUDE.md', 'MEMORY.md', 'workflow-state', 'node_modules'];
239
+ var DANGEROUS = ['rm -rf /', 'format c:', 'del /s /q c:\\\\', ':(){:|:&};:', 'mkfs.', '> /dev/sda'];
240
+ var DIRECTIVE_RE = /^(yes|no|yeah|yep|nope|sure|ok|okay|correct|right|exactly|perfect)\\b/i;
241
+ var TASK_RE = /\\b(fix|bug|error|implement|add|create|build|write|refactor|debug|test|feature|issue|security|optimi)\\b/i;
242
+
243
+ switch (command) {
244
+ case 'check-before-agent': {
245
+ var s = readState();
246
+ // Hard gate: memory must be searched
247
+ if (config.memory_first && s.memoryRequired && !s.memorySearched) {
248
+ process.stderr.write('BLOCKED: Search memory (mcp__moflo__memory_search) before spawning agents.\\n');
249
+ process.exit(2);
250
+ }
251
+ // Soft gate: TaskCreate recommended but not blocking
252
+ // (TaskCreate PostToolUse doesn't fire in Claude Code, so we can't track it reliably)
253
+ if (config.task_create_first && !s.tasksCreated) {
254
+ process.stdout.write('REMINDER: Use TaskCreate before spawning agents. Task tool is blocked until then.\\n');
255
+ }
256
+ break;
257
+ }
258
+ case 'check-before-scan': {
259
+ if (!config.memory_first) break;
260
+ var s = readState();
261
+ if (s.memorySearched || !s.memoryRequired) break;
262
+ var target = (process.env.TOOL_INPUT_pattern || '') + ' ' + (process.env.TOOL_INPUT_path || '');
263
+ if (EXEMPT.some(function(p) { return target.indexOf(p) >= 0; })) break;
264
+ process.stderr.write('BLOCKED: Search memory before exploring files. Use mcp__moflo__memory_search.\\n');
265
+ process.exit(2);
266
+ }
267
+ case 'check-before-read': {
268
+ if (!config.memory_first) break;
269
+ var s = readState();
270
+ if (s.memorySearched || !s.memoryRequired) break;
271
+ var fp = process.env.TOOL_INPUT_file_path || '';
272
+ if (fp.indexOf('.claude/guidance/') < 0 && fp.indexOf('.claude\\\\guidance\\\\') < 0) break;
273
+ process.stderr.write('BLOCKED: Search memory before reading guidance files. Use mcp__moflo__memory_search.\\n');
274
+ process.exit(2);
275
+ }
276
+ case 'record-task-created': {
277
+ var s = readState();
278
+ s.tasksCreated = true;
279
+ s.taskCount = (s.taskCount || 0) + 1;
280
+ writeState(s);
281
+ break;
282
+ }
283
+ case 'record-memory-searched': {
284
+ var s = readState();
285
+ s.memorySearched = true;
286
+ writeState(s);
287
+ break;
288
+ }
289
+ case 'check-bash-memory': {
290
+ var cmd = process.env.TOOL_INPUT_command || '';
291
+ if (/semantic-search|memory search|memory retrieve|memory-search/.test(cmd)) {
292
+ var s = readState();
293
+ s.memorySearched = true;
294
+ writeState(s);
295
+ }
296
+ break;
297
+ }
298
+ case 'check-dangerous-command': {
299
+ var cmd = (process.env.TOOL_INPUT_command || '').toLowerCase();
300
+ for (var i = 0; i < DANGEROUS.length; i++) {
301
+ if (cmd.indexOf(DANGEROUS[i]) >= 0) {
302
+ console.log('[BLOCKED] Dangerous command: ' + DANGEROUS[i]);
303
+ process.exit(2);
304
+ }
305
+ }
306
+ break;
307
+ }
308
+ case 'prompt-reminder': {
309
+ var s = readState();
310
+ s.memorySearched = false;
311
+ var prompt = process.env.CLAUDE_USER_PROMPT || '';
312
+ s.memoryRequired = prompt.length >= 4 && !DIRECTIVE_RE.test(prompt) && (TASK_RE.test(prompt) || prompt.length > 80);
313
+ s.interactionCount = (s.interactionCount || 0) + 1;
314
+ writeState(s);
315
+ if (!s.tasksCreated) console.log('REMINDER: Use TaskCreate before spawning agents. Task tool is blocked until then.');
316
+ if (config.context_tracking) {
317
+ var ic = s.interactionCount;
318
+ if (ic > 30) console.log('Context: CRITICAL. Commit, store learnings, suggest new session.');
319
+ else if (ic > 20) console.log('Context: DEPLETED. Checkpoint progress. Recommend /compact or fresh session.');
320
+ else if (ic > 10) console.log('Context: MODERATE. Re-state goal before architectural decisions. Use agents for >300 LOC.');
321
+ }
322
+ break;
323
+ }
324
+ case 'compact-guidance': {
325
+ console.log('Pre-Compact: Check CLAUDE.md for rules. Use memory search to recover context after compact.');
326
+ break;
327
+ }
328
+ case 'session-reset': {
329
+ writeState({ tasksCreated: false, taskCount: 0, memorySearched: false, memoryRequired: true, interactionCount: 0, sessionStart: new Date().toISOString(), lastBlockedAt: null });
330
+ break;
331
+ }
332
+ default:
333
+ break;
334
+ }
335
335
  `;
336
336
  }
337
337
  /**
@@ -343,56 +343,56 @@ switch (command) {
343
343
  * from gate.cjs into exit code 2 (which Claude Code requires to block tools).
344
344
  */
345
345
  export function generateGateHookScript() {
346
- return `#!/usr/bin/env node
347
- import { execSync } from 'child_process';
348
- import { resolve } from 'path';
349
-
350
- var command = process.argv[2];
351
- if (!command) process.exit(0);
352
-
353
- // Read stdin JSON from Claude Code
354
- var stdinData = '';
355
- try {
356
- stdinData = await new Promise(function(res) {
357
- var data = '';
358
- var timeout = setTimeout(function() { res(data); }, 500);
359
- process.stdin.setEncoding('utf-8');
360
- process.stdin.on('data', function(chunk) { data += chunk; });
361
- process.stdin.on('end', function() { clearTimeout(timeout); res(data); });
362
- process.stdin.on('error', function() { clearTimeout(timeout); res(''); });
363
- if (process.stdin.isTTY) { clearTimeout(timeout); res(''); }
364
- });
365
- } catch (e) { /* no stdin */ }
366
-
367
- var hookContext = {};
368
- try { if (stdinData.trim()) hookContext = JSON.parse(stdinData); } catch (e) {}
369
-
370
- // Pass tool info as env vars for gate.cjs
371
- var env = Object.assign({}, process.env);
372
- if (hookContext.tool_name) env.TOOL_NAME = hookContext.tool_name;
373
- if (hookContext.tool_input && typeof hookContext.tool_input === 'object') {
374
- Object.keys(hookContext.tool_input).forEach(function(key) {
375
- if (typeof hookContext.tool_input[key] === 'string') {
376
- env['TOOL_INPUT_' + key] = hookContext.tool_input[key];
377
- }
378
- });
379
- }
380
-
381
- // Run gate.cjs with the enriched environment
382
- var projectDir = (env.CLAUDE_PROJECT_DIR || process.cwd()).replace(/^\\/([a-z])\\//i, '$1:/');
383
- var gateScript = resolve(projectDir, '.claude/helpers/gate.cjs');
384
- try {
385
- var output = execSync('node "' + gateScript + '" ' + command, {
386
- env: env, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe']
387
- });
388
- if (output.trim()) process.stdout.write(output);
389
- process.exit(0);
390
- } catch (err) {
391
- // gate.cjs exit(2) = block, exit(1) = also block attempt — translate both to exit(2)
392
- if (err.stderr) process.stderr.write(err.stderr);
393
- if (err.stdout) process.stderr.write(err.stdout);
394
- process.exit(err.status === 2 || err.status === 1 ? 2 : 0);
395
- }
346
+ return `#!/usr/bin/env node
347
+ import { execSync } from 'child_process';
348
+ import { resolve } from 'path';
349
+
350
+ var command = process.argv[2];
351
+ if (!command) process.exit(0);
352
+
353
+ // Read stdin JSON from Claude Code
354
+ var stdinData = '';
355
+ try {
356
+ stdinData = await new Promise(function(res) {
357
+ var data = '';
358
+ var timeout = setTimeout(function() { res(data); }, 500);
359
+ process.stdin.setEncoding('utf-8');
360
+ process.stdin.on('data', function(chunk) { data += chunk; });
361
+ process.stdin.on('end', function() { clearTimeout(timeout); res(data); });
362
+ process.stdin.on('error', function() { clearTimeout(timeout); res(''); });
363
+ if (process.stdin.isTTY) { clearTimeout(timeout); res(''); }
364
+ });
365
+ } catch (e) { /* no stdin */ }
366
+
367
+ var hookContext = {};
368
+ try { if (stdinData.trim()) hookContext = JSON.parse(stdinData); } catch (e) {}
369
+
370
+ // Pass tool info as env vars for gate.cjs
371
+ var env = Object.assign({}, process.env);
372
+ if (hookContext.tool_name) env.TOOL_NAME = hookContext.tool_name;
373
+ if (hookContext.tool_input && typeof hookContext.tool_input === 'object') {
374
+ Object.keys(hookContext.tool_input).forEach(function(key) {
375
+ if (typeof hookContext.tool_input[key] === 'string') {
376
+ env['TOOL_INPUT_' + key] = hookContext.tool_input[key];
377
+ }
378
+ });
379
+ }
380
+
381
+ // Run gate.cjs with the enriched environment
382
+ var projectDir = (env.CLAUDE_PROJECT_DIR || process.cwd()).replace(/^\\/([a-z])\\//i, '$1:/');
383
+ var gateScript = resolve(projectDir, '.claude/helpers/gate.cjs');
384
+ try {
385
+ var output = execSync('node "' + gateScript + '" ' + command, {
386
+ env: env, encoding: 'utf-8', timeout: 5000, stdio: ['pipe', 'pipe', 'pipe']
387
+ });
388
+ if (output.trim()) process.stdout.write(output);
389
+ process.exit(0);
390
+ } catch (err) {
391
+ // gate.cjs exit(2) = block, exit(1) = also block attempt — translate both to exit(2)
392
+ if (err.stderr) process.stderr.write(err.stderr);
393
+ if (err.stdout) process.stderr.write(err.stdout);
394
+ process.exit(err.status === 2 || err.status === 1 ? 2 : 0);
395
+ }
396
396
  `;
397
397
  }
398
398
  /**
@@ -400,78 +400,78 @@ try {
400
400
  * runs prompt classification via gate.cjs, and appends namespace hints.
401
401
  */
402
402
  export function generatePromptHookScript() {
403
- return `#!/usr/bin/env node
404
- import { execSync } from 'child_process';
405
- import { resolve } from 'path';
406
-
407
- // Read stdin JSON from Claude Code
408
- var stdinData = '';
409
- try {
410
- stdinData = await new Promise(function(res) {
411
- var data = '';
412
- var timeout = setTimeout(function() { res(data); }, 500);
413
- process.stdin.setEncoding('utf-8');
414
- process.stdin.on('data', function(chunk) { data += chunk; });
415
- process.stdin.on('end', function() { clearTimeout(timeout); res(data); });
416
- process.stdin.on('error', function() { clearTimeout(timeout); res(''); });
417
- if (process.stdin.isTTY) { clearTimeout(timeout); res(''); }
418
- });
419
- } catch (e) { /* no stdin */ }
420
-
421
- var hookContext = {};
422
- try { if (stdinData.trim()) hookContext = JSON.parse(stdinData); } catch (e) {}
423
-
424
- var userPrompt = hookContext.user_prompt || hookContext.prompt || '';
425
- var env = Object.assign({}, process.env, { CLAUDE_USER_PROMPT: userPrompt });
426
-
427
- // Run prompt-reminder via gate.cjs
428
- var projectDir = (env.CLAUDE_PROJECT_DIR || process.cwd()).replace(/^\\/([a-z])\\//i, '$1:/');
429
- var gateScript = resolve(projectDir, '.claude/helpers/gate.cjs');
430
- var output = '';
431
- try {
432
- output = execSync('node "' + gateScript + '" prompt-reminder', {
433
- env: env, encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe']
434
- });
435
- } catch (err) { output = (err && err.stdout) || ''; }
436
-
437
- // Classify prompt for namespace hint
438
- var lower = userPrompt.toLowerCase();
439
-
440
- var KNOWLEDGE_ONLY = /\\b(knowledge|remember|recall)\\b|we (decid|agree|chose|said)/;
441
- var EXPLICIT_NS = [
442
- { pattern: /\\b(pattern|convention|best practice|style|coding rule)\\b/, ns: 'patterns', label: 'code patterns and conventions' },
443
- { pattern: /\\b(code.?map|file structure|project structure|directory)\\b/, ns: 'code-map', label: 'codebase navigation' },
444
- ];
445
- var PATTERN_HINTS = [/\\b(template|example|similar to|how do we|how should)\\b/];
446
- var DOMAIN_HINTS = [
447
- /\\b(guidance|guide|docs|documentation|rules|how-to)\\b/,
448
- /\\b(architecture|design|domain|tenant|migrat|schema|deploy)/,
449
- /\\b(rule|requirement|constraint|compliance)\\b/,
450
- ];
451
- var NAV_PATTERNS = [
452
- /\\b(find|where|which file|look up|locate|endpoint|route|url|path)\\b/,
453
- /\\b(class|function|method|component|service|entity|module)\\b/,
454
- ];
455
-
456
- var nsHint = '';
457
- if (KNOWLEDGE_ONLY.test(lower)) {
458
- nsHint = 'Memory namespace hint: use "knowledge" for user-directed project decisions.';
459
- } else {
460
- var found = EXPLICIT_NS.find(function(e) { return e.pattern.test(lower); });
461
- if (found) {
462
- nsHint = 'Memory namespace hint: use "' + found.ns + '" for ' + found.label + '.';
463
- } else if (DOMAIN_HINTS.some(function(p) { return p.test(lower); })) {
464
- nsHint = 'Memory namespace hint: search "guidance" and "knowledge" for domain rules and project decisions.';
465
- } else if (PATTERN_HINTS.some(function(p) { return p.test(lower); })) {
466
- nsHint = 'Memory namespace hint: use "patterns" for code patterns and conventions.';
467
- } else if (NAV_PATTERNS.some(function(p) { return p.test(lower); })) {
468
- nsHint = 'Memory namespace hint: use "code-map" for codebase navigation.';
469
- }
470
- }
471
-
472
- var parts = [output.trim(), nsHint].filter(Boolean);
473
- if (parts.length) process.stdout.write(parts.join('\\n') + '\\n');
474
- process.exit(0);
403
+ return `#!/usr/bin/env node
404
+ import { execSync } from 'child_process';
405
+ import { resolve } from 'path';
406
+
407
+ // Read stdin JSON from Claude Code
408
+ var stdinData = '';
409
+ try {
410
+ stdinData = await new Promise(function(res) {
411
+ var data = '';
412
+ var timeout = setTimeout(function() { res(data); }, 500);
413
+ process.stdin.setEncoding('utf-8');
414
+ process.stdin.on('data', function(chunk) { data += chunk; });
415
+ process.stdin.on('end', function() { clearTimeout(timeout); res(data); });
416
+ process.stdin.on('error', function() { clearTimeout(timeout); res(''); });
417
+ if (process.stdin.isTTY) { clearTimeout(timeout); res(''); }
418
+ });
419
+ } catch (e) { /* no stdin */ }
420
+
421
+ var hookContext = {};
422
+ try { if (stdinData.trim()) hookContext = JSON.parse(stdinData); } catch (e) {}
423
+
424
+ var userPrompt = hookContext.user_prompt || hookContext.prompt || '';
425
+ var env = Object.assign({}, process.env, { CLAUDE_USER_PROMPT: userPrompt });
426
+
427
+ // Run prompt-reminder via gate.cjs
428
+ var projectDir = (env.CLAUDE_PROJECT_DIR || process.cwd()).replace(/^\\/([a-z])\\//i, '$1:/');
429
+ var gateScript = resolve(projectDir, '.claude/helpers/gate.cjs');
430
+ var output = '';
431
+ try {
432
+ output = execSync('node "' + gateScript + '" prompt-reminder', {
433
+ env: env, encoding: 'utf-8', timeout: 3000, stdio: ['pipe', 'pipe', 'pipe']
434
+ });
435
+ } catch (err) { output = (err && err.stdout) || ''; }
436
+
437
+ // Classify prompt for namespace hint
438
+ var lower = userPrompt.toLowerCase();
439
+
440
+ var KNOWLEDGE_ONLY = /\\b(knowledge|remember|recall)\\b|we (decid|agree|chose|said)/;
441
+ var EXPLICIT_NS = [
442
+ { pattern: /\\b(pattern|convention|best practice|style|coding rule)\\b/, ns: 'patterns', label: 'code patterns and conventions' },
443
+ { pattern: /\\b(code.?map|file structure|project structure|directory)\\b/, ns: 'code-map', label: 'codebase navigation' },
444
+ ];
445
+ var PATTERN_HINTS = [/\\b(template|example|similar to|how do we|how should)\\b/];
446
+ var DOMAIN_HINTS = [
447
+ /\\b(guidance|guide|docs|documentation|rules|how-to)\\b/,
448
+ /\\b(architecture|design|domain|tenant|migrat|schema|deploy)/,
449
+ /\\b(rule|requirement|constraint|compliance)\\b/,
450
+ ];
451
+ var NAV_PATTERNS = [
452
+ /\\b(find|where|which file|look up|locate|endpoint|route|url|path)\\b/,
453
+ /\\b(class|function|method|component|service|entity|module)\\b/,
454
+ ];
455
+
456
+ var nsHint = '';
457
+ if (KNOWLEDGE_ONLY.test(lower)) {
458
+ nsHint = 'Memory namespace hint: use "knowledge" for user-directed project decisions.';
459
+ } else {
460
+ var found = EXPLICIT_NS.find(function(e) { return e.pattern.test(lower); });
461
+ if (found) {
462
+ nsHint = 'Memory namespace hint: use "' + found.ns + '" for ' + found.label + '.';
463
+ } else if (DOMAIN_HINTS.some(function(p) { return p.test(lower); })) {
464
+ nsHint = 'Memory namespace hint: search "guidance" and "knowledge" for domain rules and project decisions.';
465
+ } else if (PATTERN_HINTS.some(function(p) { return p.test(lower); })) {
466
+ nsHint = 'Memory namespace hint: use "patterns" for code patterns and conventions.';
467
+ } else if (NAV_PATTERNS.some(function(p) { return p.test(lower); })) {
468
+ nsHint = 'Memory namespace hint: use "code-map" for codebase navigation.';
469
+ }
470
+ }
471
+
472
+ var parts = [output.trim(), nsHint].filter(Boolean);
473
+ if (parts.length) process.stdout.write(parts.join('\\n') + '\\n');
474
+ process.exit(0);
475
475
  `;
476
476
  }
477
477
  /**
@@ -480,82 +480,82 @@ process.exit(0);
480
480
  * This replaces `npx flo hooks <command>` to avoid spawning a full CLI process.
481
481
  */
482
482
  export function generateHookHandlerScript() {
483
- return `#!/usr/bin/env node
484
- 'use strict';
485
- var fs = require('fs');
486
- var path = require('path');
487
-
488
- var PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
489
- var METRICS_FILE = path.join(PROJECT_DIR, '.claude-flow', 'metrics', 'learning.json');
490
- var command = process.argv[2];
491
-
492
- // Read stdin (Claude Code sends hook data as JSON)
493
- function readStdin() {
494
- if (process.stdin.isTTY) return Promise.resolve('');
495
- return new Promise(function(resolve) {
496
- var data = '';
497
- var timer = setTimeout(function() {
498
- process.stdin.removeAllListeners();
499
- process.stdin.pause();
500
- resolve(data);
501
- }, 500);
502
- process.stdin.setEncoding('utf8');
503
- process.stdin.on('data', function(chunk) { data += chunk; });
504
- process.stdin.on('end', function() { clearTimeout(timer); resolve(data); });
505
- process.stdin.on('error', function() { clearTimeout(timer); resolve(data); });
506
- process.stdin.resume();
507
- });
508
- }
509
-
510
- function bumpMetric(key) {
511
- try {
512
- var metrics = {};
513
- if (fs.existsSync(METRICS_FILE)) metrics = JSON.parse(fs.readFileSync(METRICS_FILE, 'utf-8'));
514
- metrics[key] = (metrics[key] || 0) + 1;
515
- metrics.lastUpdated = new Date().toISOString();
516
- var dir = path.dirname(METRICS_FILE);
517
- if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
518
- fs.writeFileSync(METRICS_FILE, JSON.stringify(metrics, null, 2));
519
- } catch (e) { /* non-fatal */ }
520
- }
521
-
522
- readStdin().then(function(stdinData) {
523
- var hookInput = {};
524
- if (stdinData && stdinData.trim()) {
525
- try { hookInput = JSON.parse(stdinData); } catch (e) { /* ignore */ }
526
- }
527
-
528
- switch (command) {
529
- case 'route': {
530
- var prompt = hookInput.prompt || hookInput.command || process.env.PROMPT || '';
531
- if (prompt) console.log('[INFO] Routing: ' + prompt.substring(0, 80));
532
- else console.log('[INFO] Ready');
533
- break;
534
- }
535
- case 'pre-edit':
536
- case 'post-edit':
537
- bumpMetric('edits');
538
- console.log('[OK] Edit recorded');
539
- break;
540
- case 'pre-task':
541
- bumpMetric('tasks');
542
- console.log('[OK] Task started');
543
- break;
544
- case 'post-task':
545
- bumpMetric('tasksCompleted');
546
- console.log('[OK] Task completed');
547
- break;
548
- case 'session-end':
549
- console.log('[OK] Session ended');
550
- break;
551
- case 'notification':
552
- // Silent — just acknowledge
553
- break;
554
- default:
555
- if (command) console.log('[OK] Hook: ' + command);
556
- break;
557
- }
558
- });
483
+ return `#!/usr/bin/env node
484
+ 'use strict';
485
+ var fs = require('fs');
486
+ var path = require('path');
487
+
488
+ var PROJECT_DIR = process.env.CLAUDE_PROJECT_DIR || process.cwd();
489
+ var METRICS_FILE = path.join(PROJECT_DIR, '.claude-flow', 'metrics', 'learning.json');
490
+ var command = process.argv[2];
491
+
492
+ // Read stdin (Claude Code sends hook data as JSON)
493
+ function readStdin() {
494
+ if (process.stdin.isTTY) return Promise.resolve('');
495
+ return new Promise(function(resolve) {
496
+ var data = '';
497
+ var timer = setTimeout(function() {
498
+ process.stdin.removeAllListeners();
499
+ process.stdin.pause();
500
+ resolve(data);
501
+ }, 500);
502
+ process.stdin.setEncoding('utf8');
503
+ process.stdin.on('data', function(chunk) { data += chunk; });
504
+ process.stdin.on('end', function() { clearTimeout(timer); resolve(data); });
505
+ process.stdin.on('error', function() { clearTimeout(timer); resolve(data); });
506
+ process.stdin.resume();
507
+ });
508
+ }
509
+
510
+ function bumpMetric(key) {
511
+ try {
512
+ var metrics = {};
513
+ if (fs.existsSync(METRICS_FILE)) metrics = JSON.parse(fs.readFileSync(METRICS_FILE, 'utf-8'));
514
+ metrics[key] = (metrics[key] || 0) + 1;
515
+ metrics.lastUpdated = new Date().toISOString();
516
+ var dir = path.dirname(METRICS_FILE);
517
+ if (!fs.existsSync(dir)) fs.mkdirSync(dir, { recursive: true });
518
+ fs.writeFileSync(METRICS_FILE, JSON.stringify(metrics, null, 2));
519
+ } catch (e) { /* non-fatal */ }
520
+ }
521
+
522
+ readStdin().then(function(stdinData) {
523
+ var hookInput = {};
524
+ if (stdinData && stdinData.trim()) {
525
+ try { hookInput = JSON.parse(stdinData); } catch (e) { /* ignore */ }
526
+ }
527
+
528
+ switch (command) {
529
+ case 'route': {
530
+ var prompt = hookInput.prompt || hookInput.command || process.env.PROMPT || '';
531
+ if (prompt) console.log('[INFO] Routing: ' + prompt.substring(0, 80));
532
+ else console.log('[INFO] Ready');
533
+ break;
534
+ }
535
+ case 'pre-edit':
536
+ case 'post-edit':
537
+ bumpMetric('edits');
538
+ console.log('[OK] Edit recorded');
539
+ break;
540
+ case 'pre-task':
541
+ bumpMetric('tasks');
542
+ console.log('[OK] Task started');
543
+ break;
544
+ case 'post-task':
545
+ bumpMetric('tasksCompleted');
546
+ console.log('[OK] Task completed');
547
+ break;
548
+ case 'session-end':
549
+ console.log('[OK] Session ended');
550
+ break;
551
+ case 'notification':
552
+ // Silent — just acknowledge
553
+ break;
554
+ default:
555
+ if (command) console.log('[OK] Hook: ' + command);
556
+ break;
557
+ }
558
+ });
559
559
  `;
560
560
  }
561
561
  //# sourceMappingURL=helpers-generator.js.map