moflo 4.8.54 → 4.8.55

package/bin/session-start-launcher.mjs

@@ -300,6 +300,21 @@ try {
       dirty = true;
     }
 
+    // 3a-iv. Repair missing required hook wirings (same logic as doctor --fix
+    // and moflo upgrade — shared via hook-wiring.js to stay DRY)
+    try {
+      const hwPaths = [
+        resolve(projectRoot, 'node_modules/moflo/src/modules/cli/dist/src/services/hook-wiring.js'),
+        resolve(projectRoot, 'src/modules/cli/dist/src/services/hook-wiring.js'),
+      ];
+      const hwPath = hwPaths.find(p => existsSync(p));
+      if (hwPath) {
+        const { repairHookWiring } = await import(`file://${hwPath.replace(/\\/g, '/')}`);
+        const { repaired } = repairHookWiring(settings);
+        if (repaired.length > 0) dirty = true;
+      }
+    } catch { /* non-fatal — doctor can still fix later */ }
+
     if (dirty) {
       writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moflo",
-  "version": "4.8.54",
+  "version": "4.8.55",
   "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",
@@ -109,7 +109,7 @@
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.19.37",
     "eslint": "^8.0.0",
-    "moflo": "^4.8.53",
+    "moflo": "^4.8.54",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.0"

package/src/modules/cli/dist/src/commands/doctor-checks-deep.js

@@ -426,19 +426,11 @@ const REQUIRED_GATE_CASES = [
     'prompt-reminder',
     'session-reset',
 ];
-/** Required hook matchers that must exist in settings.json for gate enforcement. */
-export const REQUIRED_HOOK_WIRING = [
-    { event: 'PreToolUse', pattern: 'check-before-scan' },
-    { event: 'PreToolUse', pattern: 'check-before-read' },
-    { event: 'PreToolUse', pattern: 'check-dangerous-command' },
-    { event: 'PreToolUse', pattern: 'check-before-pr' },
-    { event: 'PostToolUse', pattern: 'record-task-created' },
-    { event: 'PostToolUse', pattern: 'record-memory-searched' },
-    { event: 'PostToolUse', pattern: 'check-task-transition' },
-    { event: 'PostToolUse', pattern: 'record-learnings-stored' },
-    { event: 'PostToolUse', pattern: 'check-bash-memory' },
-    { event: 'UserPromptSubmit', pattern: 'prompt-reminder' },
-];
+// Import + re-export from the self-contained hook-wiring module (single source of truth).
+// hook-wiring.ts has zero moflo imports so it can be dynamically imported by
+// session-start-launcher.mjs in consumer projects without transitive failures.
+import { REQUIRED_HOOK_WIRING } from '../services/hook-wiring.js';
+export { REQUIRED_HOOK_WIRING };
 /**
  * Verify gate infrastructure health:
  * 1. gate.cjs exists and contains all required cases

package/src/modules/cli/dist/src/commands/doctor.js

@@ -12,7 +12,8 @@ import { execSync, exec } from 'child_process';
 import { promisify } from 'util';
 import os from 'os';
 import { getDaemonLockHolder, releaseDaemonLock, isDaemonProcess } from '../services/daemon-lock.js';
-import { checkSubagentHealth, checkWorkflowExecution, checkMcpToolInvocation, checkHookExecution, checkMcpWorkflowIntegration, checkGateHealth, getMofloRoot, REQUIRED_HOOK_WIRING, } from './doctor-checks-deep.js';
+import { checkSubagentHealth, checkWorkflowExecution, checkMcpToolInvocation, checkHookExecution, checkMcpWorkflowIntegration, checkGateHealth, getMofloRoot, } from './doctor-checks-deep.js';
+import { repairHookWiring } from '../services/hook-wiring.js';
 // Promisified exec with proper shell and env inheritance for cross-platform support
 const execAsync = promisify(exec);
 /**
@@ -663,25 +664,10 @@ async function runFixCommand(cmd) {
         return false;
     }
 }
-/**
- * Map gate pattern → hook entry to add when missing from settings.json.
- * Gate commands use node with $CLAUDE_PROJECT_DIR helpers for portability.
- */
-const HOOK_ENTRY_MAP = {
-    'check-before-scan': { event: 'PreToolUse', matcher: '^(Glob|Grep)$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-scan', timeout: 3000 } },
-    'check-before-read': { event: 'PreToolUse', matcher: '^Read$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-read', timeout: 3000 } },
-    'check-dangerous-command': { event: 'PreToolUse', matcher: '^Bash$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-dangerous-command', timeout: 2000 } },
-    'check-before-pr': { event: 'PreToolUse', matcher: '^Bash$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-pr', timeout: 2000 } },
-    'record-task-created': { event: 'PostToolUse', matcher: '^TaskCreate$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" record-task-created', timeout: 2000 } },
-    'record-memory-searched': { event: 'PostToolUse', matcher: 'mcp__moflo__memory_', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" record-memory-searched', timeout: 3000 } },
-    'check-task-transition': { event: 'PostToolUse', matcher: '^TaskUpdate$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" check-task-transition', timeout: 2000 } },
-    'record-learnings-stored': { event: 'PostToolUse', matcher: '^mcp__moflo__memory_store$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" record-learnings-stored', timeout: 2000 } },
-    'check-bash-memory': { event: 'PostToolUse', matcher: '^Bash$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-bash-memory', timeout: 2000 } },
-    'prompt-reminder': { event: 'UserPromptSubmit', matcher: '', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" prompt-reminder', timeout: 3000 } },
-};
 /**
  * Fix missing hook wiring in settings.json by patching in entries for
  * any REQUIRED_HOOK_WIRING patterns that aren't present.
+ * Delegates to shared repairHookWiring() to stay DRY with the upgrade path.
  */
 async function fixGateHealthHooks() {
     const settingsPath = join(process.cwd(), '.claude', 'settings.json');
@@ -690,31 +676,9 @@ async function fixGateHealthHooks() {
     try {
         const raw = readFileSync(settingsPath, 'utf8');
         const settings = JSON.parse(raw);
-        const hooks = (settings.hooks ?? {});
-        const missingPatterns = REQUIRED_HOOK_WIRING.filter(h => !raw.includes(h.pattern));
-        if (missingPatterns.length === 0)
+        const { repaired } = repairHookWiring(settings);
+        if (repaired.length === 0)
             return true; // nothing to fix
-        for (const { pattern } of missingPatterns) {
-            const entry = HOOK_ENTRY_MAP[pattern];
-            if (!entry)
-                continue;
-            const eventArray = (hooks[entry.event] ?? []);
-            // If the matcher already has an entry, append the hook to it; otherwise add a new matcher block
-            const existing = eventArray.find((block) => block.matcher === entry.matcher);
-            if (existing) {
-                const blockHooks = (existing.hooks ?? []);
-                blockHooks.push(entry.hook);
-                existing.hooks = blockHooks;
-            }
-            else {
-                const newBlock = { hooks: [entry.hook] };
-                if (entry.matcher)
-                    newBlock.matcher = entry.matcher;
-                eventArray.push(newBlock);
-            }
-            hooks[entry.event] = eventArray;
-        }
-        settings.hooks = hooks;
         writeFileSync(settingsPath, JSON.stringify(settings, null, 2), 'utf-8');
         return true;
     }

package/src/modules/cli/dist/src/init/executor.js

@@ -17,6 +17,7 @@ import { generateStatuslineScript } from './statusline-generator.js';
 import { generatePreCommitHook, generatePostCommitHook, generateAutoMemoryHook, generateGateScript, generateGateHookScript, generatePromptHookScript, generateHookHandlerScript, } from './helpers-generator.js';
 import { generateClaudeMd } from './claudemd-generator.js';
 import { writeEnvrc } from './envrc-generator.js';
+import { repairHookWiring } from '../services/hook-wiring.js';
 /**
  * Skills to copy based on configuration
  */
@@ -328,6 +329,8 @@ function mergeSettingsForUpgrade(existing) {
             agentScopes: existingMemory.agentScopes ?? { enabled: true },
         },
     };
+    // 5. Repair any missing required hook wirings (same logic doctor --fix uses)
+    repairHookWiring(merged);
     return merged;
 }
 /**
@@ -632,6 +635,7 @@ export async function executeUpgrade(targetDir, _upgradeSettings = false) {
                         'hooks.SessionEnd (auto-memory sync)',
                         'hooks.TeammateIdle (removed — not a valid Claude Code hook)',
                         'hooks.TaskCompleted (removed — not a valid Claude Code hook)',
+                        'hooks (repaired missing gate wirings)',
                         'claudeFlow.agentTeams',
                         'claudeFlow.memory (learningBridge, memoryGraph, agentScopes)',
                         'statusLine',

package/src/modules/cli/dist/src/services/hook-wiring.js

@@ -0,0 +1,81 @@
+/**
+ * Shared hook wiring repair logic.
+ *
+ * Used by `doctor --fix`, `mergeSettingsForUpgrade()`, and
+ * `session-start-launcher.mjs` so that all three paths stay DRY.
+ *
+ * IMPORTANT: This module must remain self-contained with ZERO imports
+ * from other moflo modules. It is dynamically imported at runtime by
+ * session-start-launcher.mjs in consumer projects, where transitive
+ * dependencies (project-root.js, etc.) may not resolve.
+ */
+/**
+ * Required hook matchers that must exist in settings.json for gate enforcement.
+ * This is the single source of truth — doctor-checks-deep re-exports it.
+ */
+export const REQUIRED_HOOK_WIRING = [
+    { event: 'PreToolUse', pattern: 'check-before-scan' },
+    { event: 'PreToolUse', pattern: 'check-before-read' },
+    { event: 'PreToolUse', pattern: 'check-dangerous-command' },
+    { event: 'PreToolUse', pattern: 'check-before-pr' },
+    { event: 'PostToolUse', pattern: 'record-task-created' },
+    { event: 'PostToolUse', pattern: 'record-memory-searched' },
+    { event: 'PostToolUse', pattern: 'check-task-transition' },
+    { event: 'PostToolUse', pattern: 'record-learnings-stored' },
+    { event: 'PostToolUse', pattern: 'check-bash-memory' },
+    { event: 'UserPromptSubmit', pattern: 'prompt-reminder' },
+];
+/**
+ * Map gate pattern → hook entry to add when missing from settings.json.
+ * Gate commands use node with $CLAUDE_PROJECT_DIR helpers for portability.
+ */
+export const HOOK_ENTRY_MAP = {
+    'check-before-scan': { event: 'PreToolUse', matcher: '^(Glob|Grep)$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-scan', timeout: 3000 } },
+    'check-before-read': { event: 'PreToolUse', matcher: '^Read$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-read', timeout: 3000 } },
+    'check-dangerous-command': { event: 'PreToolUse', matcher: '^Bash$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-dangerous-command', timeout: 2000 } },
+    'check-before-pr': { event: 'PreToolUse', matcher: '^Bash$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-pr', timeout: 2000 } },
+    'record-task-created': { event: 'PostToolUse', matcher: '^TaskCreate$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" record-task-created', timeout: 2000 } },
+    'record-memory-searched': { event: 'PostToolUse', matcher: 'mcp__moflo__memory_', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" record-memory-searched', timeout: 3000 } },
+    'check-task-transition': { event: 'PostToolUse', matcher: '^TaskUpdate$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" check-task-transition', timeout: 2000 } },
+    'record-learnings-stored': { event: 'PostToolUse', matcher: '^mcp__moflo__memory_store$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" record-learnings-stored', timeout: 2000 } },
+    'check-bash-memory': { event: 'PostToolUse', matcher: '^Bash$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-bash-memory', timeout: 2000 } },
+    'prompt-reminder': { event: 'UserPromptSubmit', matcher: '', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" prompt-reminder', timeout: 3000 } },
+};
+/**
+ * Inspect a parsed settings.json object for missing required hook wirings
+ * and patch them in.  Pure logic — no file I/O.
+ *
+ * @returns The (potentially mutated) settings and a list of repaired pattern names.
+ */
+export function repairHookWiring(settings) {
+    const raw = JSON.stringify(settings);
+    const hooks = (settings.hooks ?? {});
+    const missingPatterns = REQUIRED_HOOK_WIRING.filter(h => !raw.includes(h.pattern));
+    if (missingPatterns.length === 0)
+        return { settings, repaired: [] };
+    const repaired = [];
+    for (const { pattern } of missingPatterns) {
+        const entry = HOOK_ENTRY_MAP[pattern];
+        if (!entry)
+            continue;
+        const eventArray = (hooks[entry.event] ?? []);
+        // If the matcher already has an entry, append the hook; otherwise add a new matcher block
+        const existing = eventArray.find((block) => block.matcher === entry.matcher);
+        if (existing) {
+            const blockHooks = (existing.hooks ?? []);
+            blockHooks.push(entry.hook);
+            existing.hooks = blockHooks;
+        }
+        else {
+            const newBlock = { hooks: [entry.hook] };
+            if (entry.matcher)
+                newBlock.matcher = entry.matcher;
+            eventArray.push(newBlock);
+        }
+        hooks[entry.event] = eventArray;
+        repaired.push(pattern);
+    }
+    settings.hooks = hooks;
+    return { settings, repaired };
+}
+//# sourceMappingURL=hook-wiring.js.map

package/src/modules/cli/dist/src/services/index.js

@@ -13,4 +13,6 @@ export { LearningService, getLearningService, HNSWIndex, hashEmbed, cosineSimila
 export { AgentRouter, getAgentRouter, routeTask, AGENT_CAPABILITIES, } from './agent-router.js';
 // Dashboard
 export { startDashboard, createDashboardMemoryAccessor, DEFAULT_DASHBOARD_PORT, } from './daemon-dashboard.js';
+// Hook Wiring (shared between doctor, upgrade, and session-start)
+export { repairHookWiring, HOOK_ENTRY_MAP, REQUIRED_HOOK_WIRING, } from './hook-wiring.js';
 //# sourceMappingURL=index.js.map

package/src/modules/cli/dist/src/version.js

@@ -2,5 +2,5 @@
  * Auto-generated by build. Do not edit manually.
  * Source of truth: root package.json → scripts/sync-version.mjs
  */
-export const VERSION = '4.8.54';
+export const VERSION = '4.8.55';
 //# sourceMappingURL=version.js.map

package/src/modules/cli/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moflo/cli",
-  "version": "4.8.54",
+  "version": "4.8.55",
   "type": "module",
   "main": "dist/src/index.js",
   "types": "dist/src/index.d.ts",

package/src/modules/plugins/dist/index.js

@@ -100,7 +100,6 @@ export { Security, validateString, validateNumber, validateBoolean, validateArra
 // ============================================================================
 // Version
 // ============================================================================
-export const MODULE_ID = '@claude-flow/plugins';
 export const VERSION = '3.0.0-alpha.1';
 export const SDK_VERSION = '1.0.0';
 // ============================================================================

package/src/modules/workflows/dist/core/runner.js

@@ -5,7 +5,6 @@
  * delegating step execution, validation, loop iteration, rollback,
  * credential masking, and timeout handling to focused modules.
  */
-export const ENGINE_VERSION = '1.0.0';
 import { ConnectorAccessorImpl } from './connector-accessor.js';
 import { validateWorkflowDefinition, resolveArguments } from '../schema/validator.js';
 import { compareMofloLevels } from './capability-validator.js';