moflo 4.8.50 → 4.8.51

package/bin/index-all.mjs

@@ -54,11 +54,11 @@ function resolveBin(binName, localScript) {
 
 function getLocalCliPath() {
   const paths = [
-    resolve(projectRoot, 'node_modules/moflo/src/@claude-flow/cli/bin/cli.js'),
+    resolve(projectRoot, 'node_modules/moflo/src/packages/cli/bin/cli.js'),
     resolve(projectRoot, 'node_modules/moflo/bin/cli.js'),
     resolve(projectRoot, 'node_modules/.bin/flo'),
     // Development: local CLI
-    resolve(projectRoot, 'src/@claude-flow/cli/bin/cli.js'),
+    resolve(projectRoot, 'src/packages/cli/bin/cli.js'),
   ];
   for (const p of paths) {
     if (existsSync(p)) return p;

package/bin/session-start-launcher.mjs

@@ -1,272 +1,272 @@
-#!/usr/bin/env node
-/**
- * Fast session-start launcher — single hook that replaces all SessionStart entries.
- *
- * Spawns background tasks via spawn(detached + unref) and exits immediately.
- *
- * Invoked by: node .claude/scripts/session-start-launcher.mjs
- */
-
-import { spawn } from 'child_process';
-import { existsSync, readFileSync, writeFileSync, copyFileSync, unlinkSync, readdirSync, mkdirSync } from 'fs';
-import { resolve, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-// Detect project root by walking up from cwd to find package.json.
-// IMPORTANT: Do NOT use resolve(__dirname, '..') or '../..' — this script lives
-// in bin/ during development but gets synced to .claude/scripts/ in consumer
-// projects, so __dirname-relative paths break. findProjectRoot() works everywhere.
-function findProjectRoot() {
-  let dir = process.cwd();
-  const root = resolve(dir, '/');
-  while (dir !== root) {
-    if (existsSync(resolve(dir, 'package.json'))) return dir;
-    dir = dirname(dir);
-  }
-  return process.cwd();
-}
-
-const projectRoot = findProjectRoot();
-
-// ── 1. Helper: fire-and-forget a background process ─────────────────────────
-function fireAndForget(cmd, args, label) {
-  try {
-    const proc = spawn(cmd, args, {
-      cwd: projectRoot,
-      stdio: 'ignore',     // Don't hold stdio pipes open
-      detached: true,       // New process group
-      shell: false,
-      windowsHide: true     // No console popup on Windows
-    });
-    proc.unref();           // Let this process exit without waiting
-  } catch {
-    // If spawn fails (e.g. node not found), don't block startup
-  }
-}
-
-// ── 2. Reset workflow state for new session ──────────────────────────────────
-const stateDir = resolve(projectRoot, '.claude');
-const stateFile = resolve(stateDir, 'workflow-state.json');
-try {
-  if (!existsSync(stateDir)) mkdirSync(stateDir, { recursive: true });
-  writeFileSync(stateFile, JSON.stringify({
-    tasksCreated: false,
-    taskCount: 0,
-    memorySearched: false,
-    sessionStart: new Date().toISOString()
-  }, null, 2));
-} catch {
-  // Non-fatal - workflow gate will use defaults
-}
-
-// ── 3. Auto-sync scripts and helpers on version change ───────────────────────
-// Controlled by `auto_update.enabled` in moflo.yaml (default: true).
-// When moflo is upgraded (npm install), scripts and helpers may be stale.
-// Detect version change and sync from source before running hooks.
-let autoUpdateConfig = { enabled: true, scripts: true, helpers: true };
-try {
-  const mofloYaml = resolve(projectRoot, 'moflo.yaml');
-  if (existsSync(mofloYaml)) {
-    const yamlContent = readFileSync(mofloYaml, 'utf-8');
-    // Simple YAML parsing for auto_update block (avoids js-yaml dependency)
-    const enabledMatch = yamlContent.match(/auto_update:\s*\n\s+enabled:\s*(true|false)/);
-    const scriptsMatch = yamlContent.match(/auto_update:\s*\n(?:\s+\w+:.*\n)*?\s+scripts:\s*(true|false)/);
-    const helpersMatch = yamlContent.match(/auto_update:\s*\n(?:\s+\w+:.*\n)*?\s+helpers:\s*(true|false)/);
-    if (enabledMatch) autoUpdateConfig.enabled = enabledMatch[1] === 'true';
-    if (scriptsMatch) autoUpdateConfig.scripts = scriptsMatch[1] === 'true';
-    if (helpersMatch) autoUpdateConfig.helpers = helpersMatch[1] === 'true';
-  }
-} catch { /* non-fatal — use defaults (all true) */ }
-
-try {
-  const mofloPkgPath = resolve(projectRoot, 'node_modules/moflo/package.json');
-  const versionStampPath = resolve(projectRoot, '.claude-flow', 'moflo-version');
-  if (autoUpdateConfig.enabled && existsSync(mofloPkgPath)) {
-    const installedVersion = JSON.parse(readFileSync(mofloPkgPath, 'utf-8')).version;
-    let cachedVersion = '';
-    try { cachedVersion = readFileSync(versionStampPath, 'utf-8').trim(); } catch {}
-
-    if (installedVersion !== cachedVersion) {
-      const binDir = resolve(projectRoot, 'node_modules/moflo/bin');
-      const manifestPath = resolve(projectRoot, '.claude-flow', 'installed-files.json');
-
-      // ── Manifest-based auto-update ──────────────────────────────────────
-      //
-      // IMPORTANT: Every file moflo installs into the destination project
-      // MUST be recorded in `currentManifest` via syncFile() or a manual
-      // push. On upgrade, files in the OLD manifest but NOT in the new one
-      // are deleted — this is how we clean up files from prior versions
-      // without accidentally deleting user-created or runtime files.
-      //
-      // When adding/removing files from the sync lists below:
-      //  1. Use syncFile() for copied files (it records automatically)
-      //  2. Push to currentManifest manually for generated files
-      //  3. That's it — cleanup is automatic on the next upgrade
-      // ────────────────────────────────────────────────────────────────────
-
-      // Load the previous manifest so we can diff after syncing
-      let previousManifest = [];
-      try { previousManifest = JSON.parse(readFileSync(manifestPath, 'utf-8')); } catch { /* ok */ }
-
-      // Track every file we install this round
-      const currentManifest = [];
-
-      /** Copy src → dest if src exists, record in manifest. */
-      function syncFile(src, dest, manifestKey) {
-        if (existsSync(src)) {
-          try { copyFileSync(src, dest); currentManifest.push(manifestKey); } catch { /* non-fatal */ }
-        }
-      }
-
-      // Version changed — sync scripts from bin/
-      if (autoUpdateConfig.scripts) {
-        const scriptsDir = resolve(projectRoot, '.claude/scripts');
-        const scriptFiles = [
-          'hooks.mjs', 'session-start-launcher.mjs', 'index-guidance.mjs',
-          'build-embeddings.mjs', 'generate-code-map.mjs', 'semantic-search.mjs',
-          'index-tests.mjs', 'index-all.mjs',
-        ];
-        for (const file of scriptFiles) {
-          syncFile(resolve(binDir, file), resolve(scriptsDir, file), `.claude/scripts/${file}`);
-        }
-
-        // Sync lib/ subdirectory (process-manager.mjs, registry-cleanup.cjs, etc.)
-        // hooks.mjs imports ./lib/process-manager.mjs — without this, session-start
-        // silently fails and the daemon, indexer, and pretrain never run.
-        const libSrcDir = resolve(binDir, 'lib');
-        const libDestDir = resolve(scriptsDir, 'lib');
-        if (existsSync(libSrcDir)) {
-          if (!existsSync(libDestDir)) mkdirSync(libDestDir, { recursive: true });
-          for (const file of readdirSync(libSrcDir)) {
-            syncFile(resolve(libSrcDir, file), resolve(libDestDir, file), `.claude/scripts/lib/${file}`);
-          }
-        }
-      }
-
-      // Sync helpers from bin/ and source .claude/helpers/
-      if (autoUpdateConfig.helpers) {
-        const helpersDir = resolve(projectRoot, '.claude/helpers');
-        if (!existsSync(helpersDir)) mkdirSync(helpersDir, { recursive: true });
-
-        // Gate and hook helpers — shipped as static files in bin/
-        const binHelperFiles = [
-          'gate.cjs', 'gate-hook.mjs', 'prompt-hook.mjs', 'hook-handler.cjs',
-        ];
-        for (const file of binHelperFiles) {
-          syncFile(resolve(binDir, file), resolve(helpersDir, file), `.claude/helpers/${file}`);
-        }
-
-        // Other helpers from .claude/helpers/ and CLI .claude/helpers/
-        const helperSources = [
-          resolve(projectRoot, 'node_modules/moflo/.claude/helpers'),
-          resolve(projectRoot, 'node_modules/moflo/src/@claude-flow/cli/.claude/helpers'),
-        ];
-        const sourceHelperFiles = [
-          'auto-memory-hook.mjs', 'statusline.cjs', 'intelligence.cjs', 'pre-commit', 'post-commit',
-        ];
-        for (const file of sourceHelperFiles) {
-          const dest = resolve(helpersDir, file);
-          for (const srcDir of helperSources) {
-            const src = resolve(srcDir, file);
-            if (existsSync(src)) {
-              try { copyFileSync(src, dest); currentManifest.push(`.claude/helpers/${file}`); } catch { /* non-fatal */ }
-              break; // first source wins
-            }
-          }
-        }
-      }
-
-      // Sync all shipped guidance files from node_modules/moflo/.claude/guidance/shipped/
-      const guidanceDir = resolve(projectRoot, '.claude/guidance');
-      const shippedDir = resolve(projectRoot, 'node_modules/moflo/.claude/guidance/shipped');
-      if (existsSync(shippedDir)) {
-        try {
-          if (!existsSync(guidanceDir)) mkdirSync(guidanceDir, { recursive: true });
-          const shippedFiles = readdirSync(shippedDir).filter(f => f.endsWith('.md'));
-          for (const file of shippedFiles) {
-            const src = resolve(shippedDir, file);
-            const dest = resolve(guidanceDir, file);
-            const header = `<!-- AUTO-GENERATED by moflo session-start. Do not edit — changes will be overwritten. -->\n<!-- Source: node_modules/moflo/.claude/guidance/shipped/${file} -->\n\n`;
-            const content = readFileSync(src, 'utf-8');
-            writeFileSync(dest, header + content);
-            currentManifest.push(`.claude/guidance/${file}`);
-          }
-        } catch { /* non-fatal */ }
-      }
-
-      // ── Clean up files we installed previously but no longer ship ──
-      // Only remove files that are in the OLD manifest but NOT in the new one.
-      // This ensures we never delete user-created or runtime-generated files.
-      if (previousManifest.length > 0) {
-        const currentSet = new Set(currentManifest);
-        for (const rel of previousManifest) {
-          if (!currentSet.has(rel)) {
-            const abs = resolve(projectRoot, rel);
-            try { if (existsSync(abs)) unlinkSync(abs); } catch { /* non-fatal */ }
-          }
-        }
-      }
-
-      // Write updated manifest + version stamp
-      try {
-        const cfDir = resolve(projectRoot, '.claude-flow');
-        if (!existsSync(cfDir)) mkdirSync(cfDir, { recursive: true });
-        writeFileSync(manifestPath, JSON.stringify(currentManifest, null, 2));
-        writeFileSync(versionStampPath, installedVersion);
-      } catch {}
-    }
-  }
-} catch {
-  // Non-fatal — scripts will still work, just may be stale
-}
-
-// ── 3b. Ensure shipped guidance files exist (even without version change) ──
-// Subagents need these files on disk for direct reads without memory search.
-try {
-  const guidanceDir = resolve(projectRoot, '.claude/guidance');
-  const shippedDir = resolve(projectRoot, 'node_modules/moflo/.claude/guidance/shipped');
-  if (existsSync(shippedDir)) {
-    const shippedFiles = readdirSync(shippedDir).filter(f => f.endsWith('.md'));
-    for (const file of shippedFiles) {
-      const dest = resolve(guidanceDir, file);
-      if (!existsSync(dest)) {
-        if (!existsSync(guidanceDir)) mkdirSync(guidanceDir, { recursive: true });
-        const header = `<!-- AUTO-GENERATED by moflo session-start. Do not edit — changes will be overwritten. -->\n<!-- Source: node_modules/moflo/.claude/guidance/shipped/${file} -->\n\n`;
-        const content = readFileSync(resolve(shippedDir, file), 'utf-8');
-        writeFileSync(dest, header + content);
-      }
-    }
-  }
-} catch { /* non-fatal */ }
-
-// ── 3c. Clean up double-prefixed guidance files from pre-4.8.45 upgrade ─────
-// Before 4.8.45, session-start dynamically prepended "moflo-" to shipped filenames.
-// When upgrading to 4.8.45+ (where files already have the prefix), the old in-memory
-// code runs once and produces "moflo-moflo-*" duplicates. Remove them here.
-try {
-  const guidanceDir = resolve(projectRoot, '.claude/guidance');
-  if (existsSync(guidanceDir)) {
-    for (const file of readdirSync(guidanceDir)) {
-      if ((file.startsWith('moflo-moflo-') || file === 'moflo-moflo.md' || file === 'moflo.md') && file.endsWith('.md')) {
-        try { unlinkSync(resolve(guidanceDir, file)); } catch { /* non-fatal */ }
-      }
-    }
-  }
-} catch { /* non-fatal */ }
-
-// ── 4. Spawn background tasks ───────────────────────────────────────────────
-const localCli = resolve(projectRoot, 'node_modules/moflo/src/@claude-flow/cli/bin/cli.js');
-const hasLocalCli = existsSync(localCli);
-
-// hooks.mjs session-start (daemon, indexer, pretrain, HNSW, neural patterns)
-const hooksScript = resolve(projectRoot, '.claude/scripts/hooks.mjs');
-if (existsSync(hooksScript)) {
-  fireAndForget('node', [hooksScript, 'session-start'], 'hooks session-start');
-}
-
-// Patches are now baked into moflo@4.0.0 source — no runtime patching needed.
-
-// ── 5. Done — exit immediately ──────────────────────────────────────────────
-process.exit(0);
+#!/usr/bin/env node
+/**
+ * Fast session-start launcher — single hook that replaces all SessionStart entries.
+ *
+ * Spawns background tasks via spawn(detached + unref) and exits immediately.
+ *
+ * Invoked by: node .claude/scripts/session-start-launcher.mjs
+ */
+
+import { spawn } from 'child_process';
+import { existsSync, readFileSync, writeFileSync, copyFileSync, unlinkSync, readdirSync, mkdirSync } from 'fs';
+import { resolve, dirname } from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+
+// Detect project root by walking up from cwd to find package.json.
+// IMPORTANT: Do NOT use resolve(__dirname, '..') or '../..' — this script lives
+// in bin/ during development but gets synced to .claude/scripts/ in consumer
+// projects, so __dirname-relative paths break. findProjectRoot() works everywhere.
+function findProjectRoot() {
+  let dir = process.cwd();
+  const root = resolve(dir, '/');
+  while (dir !== root) {
+    if (existsSync(resolve(dir, 'package.json'))) return dir;
+    dir = dirname(dir);
+  }
+  return process.cwd();
+}
+
+const projectRoot = findProjectRoot();
+
+// ── 1. Helper: fire-and-forget a background process ─────────────────────────
+function fireAndForget(cmd, args, label) {
+  try {
+    const proc = spawn(cmd, args, {
+      cwd: projectRoot,
+      stdio: 'ignore',     // Don't hold stdio pipes open
+      detached: true,       // New process group
+      shell: false,
+      windowsHide: true     // No console popup on Windows
+    });
+    proc.unref();           // Let this process exit without waiting
+  } catch {
+    // If spawn fails (e.g. node not found), don't block startup
+  }
+}
+
+// ── 2. Reset workflow state for new session ──────────────────────────────────
+const stateDir = resolve(projectRoot, '.claude');
+const stateFile = resolve(stateDir, 'workflow-state.json');
+try {
+  if (!existsSync(stateDir)) mkdirSync(stateDir, { recursive: true });
+  writeFileSync(stateFile, JSON.stringify({
+    tasksCreated: false,
+    taskCount: 0,
+    memorySearched: false,
+    sessionStart: new Date().toISOString()
+  }, null, 2));
+} catch {
+  // Non-fatal - workflow gate will use defaults
+}
+
+// ── 3. Auto-sync scripts and helpers on version change ───────────────────────
+// Controlled by `auto_update.enabled` in moflo.yaml (default: true).
+// When moflo is upgraded (npm install), scripts and helpers may be stale.
+// Detect version change and sync from source before running hooks.
+let autoUpdateConfig = { enabled: true, scripts: true, helpers: true };
+try {
+  const mofloYaml = resolve(projectRoot, 'moflo.yaml');
+  if (existsSync(mofloYaml)) {
+    const yamlContent = readFileSync(mofloYaml, 'utf-8');
+    // Simple YAML parsing for auto_update block (avoids js-yaml dependency)
+    const enabledMatch = yamlContent.match(/auto_update:\s*\n\s+enabled:\s*(true|false)/);
+    const scriptsMatch = yamlContent.match(/auto_update:\s*\n(?:\s+\w+:.*\n)*?\s+scripts:\s*(true|false)/);
+    const helpersMatch = yamlContent.match(/auto_update:\s*\n(?:\s+\w+:.*\n)*?\s+helpers:\s*(true|false)/);
+    if (enabledMatch) autoUpdateConfig.enabled = enabledMatch[1] === 'true';
+    if (scriptsMatch) autoUpdateConfig.scripts = scriptsMatch[1] === 'true';
+    if (helpersMatch) autoUpdateConfig.helpers = helpersMatch[1] === 'true';
+  }
+} catch { /* non-fatal — use defaults (all true) */ }
+
+try {
+  const mofloPkgPath = resolve(projectRoot, 'node_modules/moflo/package.json');
+  const versionStampPath = resolve(projectRoot, '.claude-flow', 'moflo-version');
+  if (autoUpdateConfig.enabled && existsSync(mofloPkgPath)) {
+    const installedVersion = JSON.parse(readFileSync(mofloPkgPath, 'utf-8')).version;
+    let cachedVersion = '';
+    try { cachedVersion = readFileSync(versionStampPath, 'utf-8').trim(); } catch {}
+
+    if (installedVersion !== cachedVersion) {
+      const binDir = resolve(projectRoot, 'node_modules/moflo/bin');
+      const manifestPath = resolve(projectRoot, '.claude-flow', 'installed-files.json');
+
+      // ── Manifest-based auto-update ──────────────────────────────────────
+      //
+      // IMPORTANT: Every file moflo installs into the destination project
+      // MUST be recorded in `currentManifest` via syncFile() or a manual
+      // push. On upgrade, files in the OLD manifest but NOT in the new one
+      // are deleted — this is how we clean up files from prior versions
+      // without accidentally deleting user-created or runtime files.
+      //
+      // When adding/removing files from the sync lists below:
+      //  1. Use syncFile() for copied files (it records automatically)
+      //  2. Push to currentManifest manually for generated files
+      //  3. That's it — cleanup is automatic on the next upgrade
+      // ────────────────────────────────────────────────────────────────────
+
+      // Load the previous manifest so we can diff after syncing
+      let previousManifest = [];
+      try { previousManifest = JSON.parse(readFileSync(manifestPath, 'utf-8')); } catch { /* ok */ }
+
+      // Track every file we install this round
+      const currentManifest = [];
+
+      /** Copy src → dest if src exists, record in manifest. */
+      function syncFile(src, dest, manifestKey) {
+        if (existsSync(src)) {
+          try { copyFileSync(src, dest); currentManifest.push(manifestKey); } catch { /* non-fatal */ }
+        }
+      }
+
+      // Version changed — sync scripts from bin/
+      if (autoUpdateConfig.scripts) {
+        const scriptsDir = resolve(projectRoot, '.claude/scripts');
+        const scriptFiles = [
+          'hooks.mjs', 'session-start-launcher.mjs', 'index-guidance.mjs',
+          'build-embeddings.mjs', 'generate-code-map.mjs', 'semantic-search.mjs',
+          'index-tests.mjs', 'index-all.mjs',
+        ];
+        for (const file of scriptFiles) {
+          syncFile(resolve(binDir, file), resolve(scriptsDir, file), `.claude/scripts/${file}`);
+        }
+
+        // Sync lib/ subdirectory (process-manager.mjs, registry-cleanup.cjs, etc.)
+        // hooks.mjs imports ./lib/process-manager.mjs — without this, session-start
+        // silently fails and the daemon, indexer, and pretrain never run.
+        const libSrcDir = resolve(binDir, 'lib');
+        const libDestDir = resolve(scriptsDir, 'lib');
+        if (existsSync(libSrcDir)) {
+          if (!existsSync(libDestDir)) mkdirSync(libDestDir, { recursive: true });
+          for (const file of readdirSync(libSrcDir)) {
+            syncFile(resolve(libSrcDir, file), resolve(libDestDir, file), `.claude/scripts/lib/${file}`);
+          }
+        }
+      }
+
+      // Sync helpers from bin/ and source .claude/helpers/
+      if (autoUpdateConfig.helpers) {
+        const helpersDir = resolve(projectRoot, '.claude/helpers');
+        if (!existsSync(helpersDir)) mkdirSync(helpersDir, { recursive: true });
+
+        // Gate and hook helpers — shipped as static files in bin/
+        const binHelperFiles = [
+          'gate.cjs', 'gate-hook.mjs', 'prompt-hook.mjs', 'hook-handler.cjs',
+        ];
+        for (const file of binHelperFiles) {
+          syncFile(resolve(binDir, file), resolve(helpersDir, file), `.claude/helpers/${file}`);
+        }
+
+        // Other helpers from .claude/helpers/ and CLI .claude/helpers/
+        const helperSources = [
+          resolve(projectRoot, 'node_modules/moflo/.claude/helpers'),
+          resolve(projectRoot, 'node_modules/moflo/src/packages/cli/.claude/helpers'),
+        ];
+        const sourceHelperFiles = [
+          'auto-memory-hook.mjs', 'statusline.cjs', 'intelligence.cjs', 'pre-commit', 'post-commit',
+        ];
+        for (const file of sourceHelperFiles) {
+          const dest = resolve(helpersDir, file);
+          for (const srcDir of helperSources) {
+            const src = resolve(srcDir, file);
+            if (existsSync(src)) {
+              try { copyFileSync(src, dest); currentManifest.push(`.claude/helpers/${file}`); } catch { /* non-fatal */ }
+              break; // first source wins
+            }
+          }
+        }
+      }
+
+      // Sync all shipped guidance files from node_modules/moflo/.claude/guidance/shipped/
+      const guidanceDir = resolve(projectRoot, '.claude/guidance');
+      const shippedDir = resolve(projectRoot, 'node_modules/moflo/.claude/guidance/shipped');
+      if (existsSync(shippedDir)) {
+        try {
+          if (!existsSync(guidanceDir)) mkdirSync(guidanceDir, { recursive: true });
+          const shippedFiles = readdirSync(shippedDir).filter(f => f.endsWith('.md'));
+          for (const file of shippedFiles) {
+            const src = resolve(shippedDir, file);
+            const dest = resolve(guidanceDir, file);
+            const header = `<!-- AUTO-GENERATED by moflo session-start. Do not edit — changes will be overwritten. -->\n<!-- Source: node_modules/moflo/.claude/guidance/shipped/${file} -->\n\n`;
+            const content = readFileSync(src, 'utf-8');
+            writeFileSync(dest, header + content);
+            currentManifest.push(`.claude/guidance/${file}`);
+          }
+        } catch { /* non-fatal */ }
+      }
+
+      // ── Clean up files we installed previously but no longer ship ──
+      // Only remove files that are in the OLD manifest but NOT in the new one.
+      // This ensures we never delete user-created or runtime-generated files.
+      if (previousManifest.length > 0) {
+        const currentSet = new Set(currentManifest);
+        for (const rel of previousManifest) {
+          if (!currentSet.has(rel)) {
+            const abs = resolve(projectRoot, rel);
+            try { if (existsSync(abs)) unlinkSync(abs); } catch { /* non-fatal */ }
+          }
+        }
+      }
+
+      // Write updated manifest + version stamp
+      try {
+        const cfDir = resolve(projectRoot, '.claude-flow');
+        if (!existsSync(cfDir)) mkdirSync(cfDir, { recursive: true });
+        writeFileSync(manifestPath, JSON.stringify(currentManifest, null, 2));
+        writeFileSync(versionStampPath, installedVersion);
+      } catch {}
+    }
+  }
+} catch {
+  // Non-fatal — scripts will still work, just may be stale
+}
+
+// ── 3b. Ensure shipped guidance files exist (even without version change) ──
+// Subagents need these files on disk for direct reads without memory search.
+try {
+  const guidanceDir = resolve(projectRoot, '.claude/guidance');
+  const shippedDir = resolve(projectRoot, 'node_modules/moflo/.claude/guidance/shipped');
+  if (existsSync(shippedDir)) {
+    const shippedFiles = readdirSync(shippedDir).filter(f => f.endsWith('.md'));
+    for (const file of shippedFiles) {
+      const dest = resolve(guidanceDir, file);
+      if (!existsSync(dest)) {
+        if (!existsSync(guidanceDir)) mkdirSync(guidanceDir, { recursive: true });
+        const header = `<!-- AUTO-GENERATED by moflo session-start. Do not edit — changes will be overwritten. -->\n<!-- Source: node_modules/moflo/.claude/guidance/shipped/${file} -->\n\n`;
+        const content = readFileSync(resolve(shippedDir, file), 'utf-8');
+        writeFileSync(dest, header + content);
+      }
+    }
+  }
+} catch { /* non-fatal */ }
+
+// ── 3c. Clean up double-prefixed guidance files from pre-4.8.45 upgrade ─────
+// Before 4.8.45, session-start dynamically prepended "moflo-" to shipped filenames.
+// When upgrading to 4.8.45+ (where files already have the prefix), the old in-memory
+// code runs once and produces "moflo-moflo-*" duplicates. Remove them here.
+try {
+  const guidanceDir = resolve(projectRoot, '.claude/guidance');
+  if (existsSync(guidanceDir)) {
+    for (const file of readdirSync(guidanceDir)) {
+      if ((file.startsWith('moflo-moflo-') || file === 'moflo-moflo.md' || file === 'moflo.md') && file.endsWith('.md')) {
+        try { unlinkSync(resolve(guidanceDir, file)); } catch { /* non-fatal */ }
+      }
+    }
+  }
+} catch { /* non-fatal */ }
+
+// ── 4. Spawn background tasks ───────────────────────────────────────────────
+const localCli = resolve(projectRoot, 'node_modules/moflo/src/packages/cli/bin/cli.js');
+const hasLocalCli = existsSync(localCli);
+
+// hooks.mjs session-start (daemon, indexer, pretrain, HNSW, neural patterns)
+const hooksScript = resolve(projectRoot, '.claude/scripts/hooks.mjs');
+if (existsSync(hooksScript)) {
+  fireAndForget('node', [hooksScript, 'session-start'], 'hooks session-start');
+}
+
+// Patches are now baked into moflo@4.0.0 source — no runtime patching needed.
+
+// ── 5. Done — exit immediately ──────────────────────────────────────────────
+process.exit(0);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moflo",
-  "version": "4.8.50",
+  "version": "4.8.51",
   "description": "MoFlo — AI agent orchestration for Claude Code. Forked from ruflo/claude-flow with patches applied to source, plus feature-level orchestration.",
   "main": "dist/index.js",
   "type": "module",
@@ -21,22 +21,22 @@
   },
   "files": [
     "bin/**",
-    "src/@claude-flow/cli/bin/**",
-    "src/@claude-flow/cli/dist/**/*.js",
-    "!src/@claude-flow/cli/dist/**/*.map",
-    "src/@claude-flow/cli/package.json",
-    "src/@claude-flow/shared/dist/**/*.js",
-    "!src/@claude-flow/shared/dist/**/*.map",
-    "src/@claude-flow/shared/package.json",
-    "src/@claude-flow/guidance/dist/**/*.js",
-    "!src/@claude-flow/guidance/dist/**/*.map",
-    "src/@claude-flow/guidance/package.json",
-    "src/@claude-flow/memory/dist/**/*.js",
-    "!src/@claude-flow/memory/dist/**/*.map",
-    "src/@claude-flow/memory/package.json",
-    "src/@claude-flow/neural/dist/**/*.js",
-    "!src/@claude-flow/neural/dist/**/*.map",
-    "src/@claude-flow/neural/package.json",
+    "src/packages/cli/bin/**",
+    "src/packages/cli/dist/**/*.js",
+    "!src/packages/cli/dist/**/*.map",
+    "src/packages/cli/package.json",
+    "src/packages/shared/dist/**/*.js",
+    "!src/packages/shared/dist/**/*.map",
+    "src/packages/shared/package.json",
+    "src/packages/guidance/dist/**/*.js",
+    "!src/packages/guidance/dist/**/*.map",
+    "src/packages/guidance/package.json",
+    "src/packages/memory/dist/**/*.js",
+    "!src/packages/memory/dist/**/*.map",
+    "src/packages/memory/package.json",
+    "src/packages/neural/dist/**/*.js",
+    "!src/packages/neural/dist/**/*.map",
+    "src/packages/neural/package.json",
     ".claude/commands/**/*.md",
     ".claude/agents/**/*.md",
     ".claude/helpers/**",
@@ -50,19 +50,19 @@
     "dev": "tsx watch src/index.ts",
     "prebuild": "node scripts/sync-version.mjs",
     "build": "tsc -b",
-    "build:ts": "cd src/@claude-flow/cli && npm run build",
-    "build:neural": "cd src/@claude-flow/neural && npx tsc -p tsconfig.json",
-    "build:guidance": "cd src/@claude-flow/guidance && npx tsc -p tsconfig.json",
+    "build:ts": "cd src/packages/cli && npm run build",
+    "build:neural": "cd src/packages/neural && npx tsc -p tsconfig.json",
+    "build:guidance": "cd src/packages/guidance && npx tsc -p tsconfig.json",
     "prepublishOnly": "npm run build",
     "test": "vitest run",
     "test:ui": "vitest --ui",
     "test:security": "vitest run src/__tests__/security/",
-    "lint": "cd src/@claude-flow/cli && npm run lint || true",
+    "lint": "cd src/packages/cli && npm run lint || true",
     "security:audit": "npm audit --audit-level high",
     "security:fix": "npm audit fix",
     "security:test": "npm run test:security",
     "moflo:security": "npm run security:audit && npm run security:test",
-    "version": "node scripts/sync-version.mjs && git add src/@claude-flow/cli/package.json src/@claude-flow/cli/src/version.ts"
+    "version": "node scripts/sync-version.mjs && git add src/packages/cli/package.json src/packages/cli/src/version.ts"
   },
   "dependencies": {
     "@ruvector/learning-wasm": "^0.1.29",