moflo 4.8.21 → 4.8.23

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 (178) 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/github/code-review-swarm.md +537 -537
  12. package/.claude/agents/github/github-modes.md +172 -172
  13. package/.claude/agents/github/issue-tracker.md +318 -318
  14. package/.claude/agents/github/multi-repo-swarm.md +552 -552
  15. package/.claude/agents/github/pr-manager.md +190 -190
  16. package/.claude/agents/github/project-board-sync.md +508 -508
  17. package/.claude/agents/github/release-manager.md +366 -366
  18. package/.claude/agents/github/release-swarm.md +582 -582
  19. package/.claude/agents/github/repo-architect.md +397 -397
  20. package/.claude/agents/github/swarm-issue.md +572 -572
  21. package/.claude/agents/github/swarm-pr.md +427 -427
  22. package/.claude/agents/github/sync-coordinator.md +451 -451
  23. package/.claude/agents/github/workflow-automation.md +634 -634
  24. package/.claude/agents/goal/code-goal-planner.md +445 -445
  25. package/.claude/agents/hive-mind/collective-intelligence-coordinator.md +129 -129
  26. package/.claude/agents/hive-mind/queen-coordinator.md +202 -202
  27. package/.claude/agents/hive-mind/scout-explorer.md +241 -241
  28. package/.claude/agents/hive-mind/swarm-memory-manager.md +192 -192
  29. package/.claude/agents/hive-mind/worker-specialist.md +216 -216
  30. package/.claude/agents/index.yaml +17 -17
  31. package/.claude/agents/neural/safla-neural.md +73 -73
  32. package/.claude/agents/project-coordinator.yaml +15 -15
  33. package/.claude/agents/python-specialist.yaml +21 -21
  34. package/.claude/agents/reasoning/goal-planner.md +72 -72
  35. package/.claude/agents/security-auditor.yaml +20 -20
  36. package/.claude/agents/swarm/adaptive-coordinator.md +395 -395
  37. package/.claude/agents/swarm/hierarchical-coordinator.md +326 -326
  38. package/.claude/agents/swarm/mesh-coordinator.md +391 -391
  39. package/.claude/agents/templates/migration-plan.md +745 -745
  40. package/.claude/agents/typescript-specialist.yaml +21 -21
  41. package/.claude/checkpoints/1767754460.json +8 -8
  42. package/.claude/commands/agents/agent-spawning.md +28 -28
  43. package/.claude/commands/github/github-modes.md +146 -146
  44. package/.claude/commands/github/github-swarm.md +121 -121
  45. package/.claude/commands/github/issue-tracker.md +291 -291
  46. package/.claude/commands/github/pr-manager.md +169 -169
  47. package/.claude/commands/github/release-manager.md +337 -337
  48. package/.claude/commands/github/repo-architect.md +366 -366
  49. package/.claude/commands/github/sync-coordinator.md +300 -300
  50. package/.claude/commands/memory/neural.md +47 -47
  51. package/.claude/commands/sparc/analyzer.md +51 -51
  52. package/.claude/commands/sparc/architect.md +53 -53
  53. package/.claude/commands/sparc/ask.md +97 -97
  54. package/.claude/commands/sparc/batch-executor.md +54 -54
  55. package/.claude/commands/sparc/code.md +89 -89
  56. package/.claude/commands/sparc/coder.md +54 -54
  57. package/.claude/commands/sparc/debug.md +83 -83
  58. package/.claude/commands/sparc/debugger.md +54 -54
  59. package/.claude/commands/sparc/designer.md +53 -53
  60. package/.claude/commands/sparc/devops.md +109 -109
  61. package/.claude/commands/sparc/docs-writer.md +80 -80
  62. package/.claude/commands/sparc/documenter.md +54 -54
  63. package/.claude/commands/sparc/innovator.md +54 -54
  64. package/.claude/commands/sparc/integration.md +83 -83
  65. package/.claude/commands/sparc/mcp.md +117 -117
  66. package/.claude/commands/sparc/memory-manager.md +54 -54
  67. package/.claude/commands/sparc/optimizer.md +54 -54
  68. package/.claude/commands/sparc/orchestrator.md +131 -131
  69. package/.claude/commands/sparc/post-deployment-monitoring-mode.md +83 -83
  70. package/.claude/commands/sparc/refinement-optimization-mode.md +83 -83
  71. package/.claude/commands/sparc/researcher.md +54 -54
  72. package/.claude/commands/sparc/reviewer.md +54 -54
  73. package/.claude/commands/sparc/security-review.md +80 -80
  74. package/.claude/commands/sparc/sparc-modes.md +174 -174
  75. package/.claude/commands/sparc/sparc.md +111 -111
  76. package/.claude/commands/sparc/spec-pseudocode.md +80 -80
  77. package/.claude/commands/sparc/supabase-admin.md +348 -348
  78. package/.claude/commands/sparc/swarm-coordinator.md +54 -54
  79. package/.claude/commands/sparc/tdd.md +54 -54
  80. package/.claude/commands/sparc/tester.md +54 -54
  81. package/.claude/commands/sparc/tutorial.md +79 -79
  82. package/.claude/commands/sparc/workflow-manager.md +54 -54
  83. package/.claude/commands/sparc.md +166 -166
  84. package/.claude/commands/swarm/analysis.md +95 -95
  85. package/.claude/commands/swarm/development.md +96 -96
  86. package/.claude/commands/swarm/examples.md +168 -168
  87. package/.claude/commands/swarm/maintenance.md +102 -102
  88. package/.claude/commands/swarm/optimization.md +117 -117
  89. package/.claude/commands/swarm/research.md +136 -136
  90. package/.claude/commands/swarm/testing.md +131 -131
  91. package/.claude/commands/workflows/development.md +77 -77
  92. package/.claude/commands/workflows/research.md +62 -62
  93. package/.claude/guidance/moflo-bootstrap.md +126 -126
  94. package/.claude/guidance/shipped/agent-bootstrap.md +126 -126
  95. package/.claude/guidance/shipped/guidance-memory-strategy.md +262 -262
  96. package/.claude/guidance/shipped/memory-strategy.md +204 -204
  97. package/.claude/guidance/shipped/moflo.md +668 -653
  98. package/.claude/guidance/shipped/task-swarm-integration.md +441 -441
  99. package/.claude/helpers/intelligence.cjs +207 -207
  100. package/.claude/helpers/statusline.cjs +851 -851
  101. package/.claude/settings.local.json +18 -0
  102. package/.claude/skills/fl/SKILL.md +583 -583
  103. package/.claude/skills/flo/SKILL.md +583 -583
  104. package/.claude/skills/github-code-review/SKILL.md +1140 -1140
  105. package/.claude/skills/github-multi-repo/SKILL.md +874 -874
  106. package/.claude/skills/github-project-management/SKILL.md +1277 -1277
  107. package/.claude/skills/github-release-management/SKILL.md +1081 -1081
  108. package/.claude/skills/github-workflow-automation/SKILL.md +1065 -1065
  109. package/.claude/skills/hive-mind-advanced/SKILL.md +712 -712
  110. package/.claude/skills/hooks-automation/SKILL.md +1201 -1201
  111. package/.claude/skills/performance-analysis/SKILL.md +563 -563
  112. package/.claude/skills/sparc-methodology/SKILL.md +1115 -1115
  113. package/.claude/skills/swarm-advanced/SKILL.md +973 -973
  114. package/.claude/workflow-state.json +4 -4
  115. package/LICENSE +21 -21
  116. package/README.md +698 -685
  117. package/bin/cli.js +0 -0
  118. package/bin/gate-hook.mjs +50 -50
  119. package/bin/gate.cjs +138 -138
  120. package/bin/generate-code-map.mjs +775 -775
  121. package/bin/hook-handler.cjs +83 -83
  122. package/bin/hooks.mjs +656 -656
  123. package/bin/index-guidance.mjs +892 -892
  124. package/bin/index-tests.mjs +709 -709
  125. package/bin/lib/process-manager.mjs +243 -243
  126. package/bin/lib/registry-cleanup.cjs +41 -41
  127. package/bin/prompt-hook.mjs +72 -72
  128. package/bin/semantic-search.mjs +472 -472
  129. package/bin/session-start-launcher.mjs +238 -238
  130. package/bin/setup-project.mjs +250 -250
  131. package/package.json +123 -123
  132. package/src/@claude-flow/cli/README.md +452 -452
  133. package/src/@claude-flow/cli/bin/cli.js +180 -180
  134. package/src/@claude-flow/cli/bin/preinstall.cjs +2 -2
  135. package/src/@claude-flow/cli/dist/src/commands/completions.js +409 -409
  136. package/src/@claude-flow/cli/dist/src/commands/doctor.js +18 -2
  137. package/src/@claude-flow/cli/dist/src/commands/embeddings.js +25 -25
  138. package/src/@claude-flow/cli/dist/src/commands/github.js +61 -61
  139. package/src/@claude-flow/cli/dist/src/commands/hive-mind.js +90 -90
  140. package/src/@claude-flow/cli/dist/src/commands/hooks.js +9 -9
  141. package/src/@claude-flow/cli/dist/src/commands/init.js +3 -8
  142. package/src/@claude-flow/cli/dist/src/commands/ruvector/import.js +14 -14
  143. package/src/@claude-flow/cli/dist/src/commands/ruvector/setup.js +624 -624
  144. package/src/@claude-flow/cli/dist/src/config/moflo-config.d.ts +3 -0
  145. package/src/@claude-flow/cli/dist/src/config/moflo-config.js +101 -91
  146. package/src/@claude-flow/cli/dist/src/index.d.ts +5 -0
  147. package/src/@claude-flow/cli/dist/src/index.js +44 -0
  148. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.d.ts +29 -29
  149. package/src/@claude-flow/cli/dist/src/init/claudemd-generator.js +43 -43
  150. package/src/@claude-flow/cli/dist/src/init/executor.js +453 -453
  151. package/src/@claude-flow/cli/dist/src/init/helpers-generator.js +482 -482
  152. package/src/@claude-flow/cli/dist/src/init/moflo-init.d.ts +30 -30
  153. package/src/@claude-flow/cli/dist/src/init/moflo-init.js +140 -140
  154. package/src/@claude-flow/cli/dist/src/init/statusline-generator.js +876 -876
  155. package/src/@claude-flow/cli/dist/src/memory/memory-initializer.js +371 -371
  156. package/src/@claude-flow/cli/dist/src/runtime/headless.js +28 -28
  157. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.d.ts +197 -0
  158. package/src/@claude-flow/cli/dist/src/services/container-worker-pool.js +584 -0
  159. package/src/@claude-flow/cli/dist/src/services/daemon-lock.d.ts +14 -0
  160. package/src/@claude-flow/cli/dist/src/services/daemon-lock.js +1 -1
  161. package/src/@claude-flow/cli/dist/src/services/headless-worker-executor.js +84 -84
  162. package/src/@claude-flow/cli/package.json +1 -1
  163. package/src/@claude-flow/guidance/README.md +1195 -1195
  164. package/src/@claude-flow/guidance/package.json +198 -198
  165. package/src/@claude-flow/memory/README.md +587 -587
  166. package/src/@claude-flow/memory/dist/agentdb-backend.js +26 -26
  167. package/src/@claude-flow/memory/dist/auto-memory-bridge.test.js +27 -27
  168. package/src/@claude-flow/memory/dist/hybrid-backend.d.ts +245 -0
  169. package/src/@claude-flow/memory/dist/hybrid-backend.js +569 -0
  170. package/src/@claude-flow/memory/dist/hybrid-backend.test.d.ts +8 -0
  171. package/src/@claude-flow/memory/dist/hybrid-backend.test.js +320 -0
  172. package/src/@claude-flow/memory/dist/sqlite-backend.d.ts +121 -0
  173. package/src/@claude-flow/memory/dist/sqlite-backend.js +572 -0
  174. package/src/@claude-flow/memory/dist/sqljs-backend.js +26 -26
  175. package/src/@claude-flow/memory/package.json +44 -44
  176. package/src/@claude-flow/shared/README.md +323 -323
  177. package/src/@claude-flow/shared/dist/events/event-store.js +31 -31
  178. 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