moflo 4.9.20 → 4.9.22

package/dist/src/cli/services/hook-block-hash.js

@@ -59,6 +59,10 @@ export function getReferenceHookBlock() {
                 matcher: '^Bash$',
                 hooks: [gateHook('check-dangerous-command', 2000), gateHook('check-before-pr', 2000)],
             },
+            // #931 — TaskCreate REMINDER + namespace hint advisory at Agent-spawn time.
+            // Routed via gate-hook.mjs so HOOK_SESSION_ID is forwarded for per-actor
+            // single-shot emission of the namespace hint.
+            { matcher: '^Agent$', hooks: [gateHook('check-before-agent', 2000)] },
         ],
         PostToolUse: [
             {
@@ -72,13 +76,18 @@ export function getReferenceHookBlock() {
                 hooks: [gateHook('check-bash-memory', 2000), gateHook('record-test-run', 2000)],
             },
             { matcher: '^Skill$', hooks: [gateHook('record-skill-run', 2000)] },
-            { matcher: 'mcp__moflo__memory_', hooks: [gateHook('record-memory-searched', 3000)] },
+            { matcher: '^mcp__moflo__memory_(search|retrieve|list|stats|store)$', hooks: [gateHook('record-memory-searched', 3000)] },
             { matcher: '^TaskUpdate$', hooks: [gateCjs('check-task-transition', 2000)] },
             { matcher: '^mcp__moflo__memory_store$', hooks: [gateCjs('record-learnings-stored', 2000)] },
+            // #952 — wired so /fl -s/--swarm and /fl -h/--hive runs satisfy the
+            // check-before-agent gate after the protected MCP init has been called.
+            { matcher: '^mcp__moflo__swarm_init$', hooks: [gateCjs('record-swarm-init', 2000)] },
+            { matcher: '^mcp__moflo__hive-mind_init$', hooks: [gateCjs('record-hive-init', 2000)] },
         ],
         UserPromptSubmit: [
             { hooks: [helperHook('prompt-hook.mjs', '', 3000)] },
-            { hooks: [gateHook('prompt-reminder', 3000)] },
+            // #931 — Defensive safety-net hook. State reset only, no emission.
+            { hooks: [gateHook('prompt-state-reset', 3000)] },
         ],
         SubagentStart: [
             { hooks: [helperHook('subagent-start.cjs', '', 2000)] },

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

@@ -18,6 +18,9 @@ export const REQUIRED_HOOK_WIRING = [
     { event: 'PreToolUse', pattern: 'check-before-read' },
     { event: 'PreToolUse', pattern: 'check-dangerous-command' },
     { event: 'PreToolUse', pattern: 'check-before-pr' },
+    // #931 — TaskCreate REMINDER + namespace hint emit only at Agent spawn now,
+    // not on every prompt. Saves ~90 tokens × every prompt × every consumer.
+    { event: 'PreToolUse', pattern: 'check-before-agent' },
     { event: 'PostToolUse', pattern: 'record-task-created' },
     { event: 'PostToolUse', pattern: 'record-memory-searched' },
     { event: 'PostToolUse', pattern: 'check-task-transition' },
@@ -26,7 +29,14 @@ export const REQUIRED_HOOK_WIRING = [
     { event: 'PostToolUse', pattern: 'record-test-run' },
     { event: 'PostToolUse', pattern: 'record-skill-run' },
     { event: 'PostToolUse', pattern: 'reset-edit-gates' },
-    { event: 'UserPromptSubmit', pattern: 'prompt-reminder' },
+    // First UserPromptSubmit hook (prompt-hook.mjs internally calls
+    // `gate.cjs prompt-reminder`). Substring check tolerates either the
+    // shipped helper-script command or an inlined gate call.
+    { event: 'UserPromptSubmit', pattern: 'prompt-hook.mjs' },
+    // Second (defensive) UserPromptSubmit hook — state reset only. Replaced
+    // the duplicate `prompt-reminder` wiring that was emitting the TaskCreate
+    // REMINDER twice per prompt (#931).
+    { event: 'UserPromptSubmit', pattern: 'prompt-state-reset' },
 ];
 /**
  * Map gate pattern → hook entry to add when missing from settings.json.
@@ -41,14 +51,29 @@ export const HOOK_ENTRY_MAP = {
     // record-memory-searched MUST go through gate-hook.mjs (not gate.cjs directly)
     // — the wrapper forwards Claude Code's session_id as HOOK_SESSION_ID, which
     // markMemorySearched needs to stamp the per-actor map (#879).
-    'record-memory-searched': { event: 'PostToolUse', matcher: 'mcp__moflo__memory_', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" record-memory-searched', timeout: 3000 } },
+    // Matcher MUST be a fully-anchored regex: Claude Code anchors hook matchers
+    // (`^...$` semantics), so a bare `mcp__moflo__memory_` never fires for any
+    // tool name (#929 regression — the hook silently no-ops, leaving every
+    // memory_search uncounted by the gate).
+    'record-memory-searched': { event: 'PostToolUse', matcher: '^mcp__moflo__memory_(search|retrieve|list|stats|store)$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" 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 } },
     'record-test-run': { event: 'PostToolUse', matcher: '^Bash$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" record-test-run', timeout: 2000 } },
     'record-skill-run': { event: 'PostToolUse', matcher: '^Skill$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" record-skill-run', timeout: 2000 } },
     'reset-edit-gates': { event: 'PostToolUse', matcher: '^(Write|Edit|MultiEdit)$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" reset-edit-gates', timeout: 2000 } },
-    'prompt-reminder': { event: 'UserPromptSubmit', matcher: '', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" prompt-reminder', timeout: 3000 } },
+    // #931 — Agent-time advisory; never blocks. Pulled the TaskCreate REMINDER
+    // and namespace hint out of prompt-reminder so they fire only when Claude is
+    // actually about to spawn an Agent. Routed via gate-hook.mjs so Claude Code's
+    // session_id is forwarded as HOOK_SESSION_ID — the namespace hint emission
+    // is per-actor single-shot (mirror of #879's record-memory-searched fix).
+    'check-before-agent': { event: 'PreToolUse', matcher: '^Agent$', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-agent', timeout: 2000 } },
+    // Re-add the prompt-hook.mjs wiring as its own bare UserPromptSubmit block
+    // when missing. Empty matcher = bare block, like settings-generator emits.
+    'prompt-hook.mjs': { event: 'UserPromptSubmit', matcher: '', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/prompt-hook.mjs"', timeout: 3000 } },
+    // Defensive safety-net — runs gate.cjs `prompt-state-reset` if prompt-hook.mjs
+    // throws before completing the per-prompt state reset. State-only, no emission.
+    'prompt-state-reset': { event: 'UserPromptSubmit', matcher: '', hook: { type: 'command', command: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" prompt-state-reset', timeout: 3000 } },
 };
 /**
  * Inspect a parsed settings.json object for missing required hook wirings
@@ -104,6 +129,42 @@ export const HOOK_REWRITE_RULES = [
         from: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" check-bash-memory',
         to: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-bash-memory',
     },
+    // Issue #931 — the second UserPromptSubmit hook used to invoke
+    // gate-hook.mjs `prompt-reminder`, which (a) duplicated the first hook's
+    // emission of `REMINDER: Use TaskCreate...` per prompt and (b) double-
+    // incremented `interactionCount`. The first hook (prompt-hook.mjs) still
+    // calls gate.cjs `prompt-reminder` internally for the full reset + Context
+    // warnings; the safety-net hook now runs `prompt-state-reset` instead —
+    // idempotent state reset, no emission, no increment.
+    {
+        name: '#931: dedupe UserPromptSubmit prompt-reminder → prompt-state-reset',
+        from: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" prompt-reminder',
+        to: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" prompt-state-reset',
+    },
+    // Issue #931 — `check-before-agent` was first wired through gate.cjs
+    // directly (no stdin parsing). Without HOOK_SESSION_ID the namespace hint's
+    // per-actor tracking falls back to a single `_legacy_` bucket, so a
+    // subagent spawning its own agent would silently miss the hint after the
+    // parent already consumed it. Route through gate-hook.mjs (the same wrapper
+    // that fixed #879) so each session_id gets its own single-shot.
+    {
+        name: '#931: route check-before-agent → gate-hook.mjs (forwards HOOK_SESSION_ID)',
+        from: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate.cjs" check-before-agent',
+        to: 'node "$CLAUDE_PROJECT_DIR/.claude/helpers/gate-hook.mjs" check-before-agent',
+    },
+];
+export const MATCHER_REWRITE_RULES = [
+    // Issue #929 — Claude Code anchors hook matchers (`^…$` semantics), so a
+    // bare `mcp__moflo__memory_` never matches any real MCP tool name and the
+    // record-memory-searched stamp silently no-ops on every memory_search.
+    // The fix is anchored alternation. Existing consumers that upgrade through
+    // this version self-heal here without needing `flo doctor --fix`.
+    {
+        name: '#929: anchor record-memory-searched matcher',
+        from: 'mcp__moflo__memory_',
+        to: '^mcp__moflo__memory_(search|retrieve|list|stats|store)$',
+        cmdContains: 'record-memory-searched',
+    },
 ];
 /**
  * Apply HOOK_REWRITE_RULES to every hook command in `settings.hooks.*`.
@@ -135,6 +196,28 @@ export function rewriteIncorrectHookWiring(settings) {
         if (count > 0)
             rewrites.push({ name: rule.name, count });
     }
+    for (const rule of MATCHER_REWRITE_RULES) {
+        let count = 0;
+        for (const eventName of Object.keys(hooks)) {
+            const eventArray = hooks[eventName];
+            if (!Array.isArray(eventArray))
+                continue;
+            for (const block of eventArray) {
+                if (block.matcher !== rule.from)
+                    continue;
+                const blockHooks = block.hooks;
+                if (!Array.isArray(blockHooks))
+                    continue;
+                const hasMatchingCmd = blockHooks.some((h) => typeof h.command === 'string' && h.command.includes(rule.cmdContains));
+                if (!hasMatchingCmd)
+                    continue;
+                block.matcher = rule.to;
+                count++;
+            }
+        }
+        if (count > 0)
+            rewrites.push({ name: rule.name, count });
+    }
     return { settings, rewrites };
 }
 //# sourceMappingURL=hook-wiring.js.map

package/dist/src/cli/services/subagent-bootstrap.js

@@ -21,7 +21,7 @@ const BOOTSTRAP_JSON_REL = '.claude/helpers/subagent-bootstrap.json';
 // Defense-in-depth copy of the canonical directive in subagent-bootstrap.json.
 // Kept as a single-line literal so the parity test can verify it matches the
 // JSON via plain substring containment.
-const FALLBACK_DIRECTIVE = 'MANDATORY FIRST ACTION: Your very first tool call MUST be mcp__moflo__memory_search (any query, any namespace). The memory-first gate WILL BLOCK all Glob, Grep, and Read calls until you do this. After memory search, follow `.claude/guidance/shipped/moflo-subagents.md` protocol.';
+const FALLBACK_DIRECTIVE = 'MANDATORY FIRST ACTION: Your very first tool call MUST be mcp__moflo__memory_search (any query, any namespace). The memory-first gate WILL BLOCK all Glob, Grep, and Read calls until you do this. After memory search, follow `.claude/guidance/moflo-subagents.md` protocol.';
 function loadDirective() {
     const jsonPath = locateMofloRootPath(BOOTSTRAP_JSON_REL);
     if (!jsonPath) {

package/dist/src/cli/shared/events/example-usage.js

@@ -36,20 +36,20 @@ async function main() {
     // 3. Record Agent Lifecycle Events
     // =========================================================================
     console.log('3. Recording Agent Lifecycle Events...');
-    // Agent 1: Queen Coordinator
-    await eventStore.append(createAgentSpawnedEvent('agent-1', 'queen-coordinator', 'coordination', [
+    // Agent 1: Coordinator
+    await eventStore.append(createAgentSpawnedEvent('agent-1', 'coordinator', 'coordination', [
         'orchestration',
         'task-assignment',
     ]));
     await eventStore.append(createAgentStartedEvent('agent-1'));
-    // Agent 2: Security Architect
-    await eventStore.append(createAgentSpawnedEvent('agent-2', 'security-architect', 'security', [
+    // Agent 2: Security Auditor
+    await eventStore.append(createAgentSpawnedEvent('agent-2', 'security-auditor', 'security', [
         'threat-modeling',
         'security-design',
     ]));
     await eventStore.append(createAgentStartedEvent('agent-2'));
-    // Agent 3: Core Architect
-    await eventStore.append(createAgentSpawnedEvent('agent-3', 'core-architect', 'core', ['ddd-design', 'architecture']));
+    // Agent 3: Architect
+    await eventStore.append(createAgentSpawnedEvent('agent-3', 'architect', 'core', ['ddd-design', 'architecture']));
     await eventStore.append(createAgentStartedEvent('agent-3'));
     console.log('   Agent events recorded\n');
     // =========================================================================

package/dist/src/cli/shared/hooks/task-hooks.js

@@ -144,27 +144,27 @@ export class TaskHooksManager {
             },
             {
                 keywords: ['security', 'vulnerability', 'cve', 'threat'],
-                agent: 'security-architect',
+                agent: 'security-auditor',
                 capabilities: ['security-analysis', 'vulnerability-detection', 'threat-modeling'],
             },
             {
-                keywords: ['performance', 'optimize', 'speed', 'memory'],
-                agent: 'performance-engineer',
+                keywords: ['performance', 'optimize', 'speed', 'memory', 'profile', 'benchmark'],
+                agent: 'reviewer',
                 capabilities: ['performance-optimization', 'profiling', 'benchmarking'],
             },
             {
                 keywords: ['architect', 'design', 'structure', 'pattern'],
-                agent: 'core-architect',
+                agent: 'architect',
                 capabilities: ['architecture-design', 'pattern-application', 'system-design'],
             },
             {
-                keywords: ['memory', 'storage', 'database', 'cache'],
-                agent: 'memory-specialist',
+                keywords: ['storage', 'database', 'cache', 'persistence'],
+                agent: 'researcher',
                 capabilities: ['memory-management', 'data-persistence', 'caching'],
             },
             {
-                keywords: ['swarm', 'coordinate', 'orchestrate', 'agent'],
-                agent: 'swarm-specialist',
+                keywords: ['swarm', 'coordinate', 'orchestrate', 'agent', 'hive'],
+                agent: 'coordinator',
                 capabilities: ['swarm-coordination', 'agent-orchestration', 'distributed-systems'],
             },
         ];

package/dist/src/cli/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.9.20';
+export const VERSION = '4.9.22';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "moflo",
-  "version": "4.9.20",
+  "version": "4.9.22",
   "description": "MoFlo — AI agent orchestration for Claude Code. A standalone, opinionated toolkit with semantic memory, learned routing, gates, spells, and the /flo issue-execution skill.",
   "main": "dist/src/cli/index.js",
   "type": "module",
@@ -39,6 +39,7 @@
     "!.claude/**/*.map",
     "README.md",
     "LICENSE",
+    "retired-files.json",
     "scripts/prune-native-binaries.mjs",
     "scripts/post-install-notice.mjs",
     "scripts/post-install-bootstrap.mjs"
@@ -81,7 +82,7 @@
     "@typescript-eslint/eslint-plugin": "^7.18.0",
     "@typescript-eslint/parser": "^7.18.0",
     "eslint": "^8.0.0",
-    "moflo": "^4.9.19",
+    "moflo": "^4.9.21",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "^4.0.0"