opencode-matrixx 2.6.1 → 2.6.2

package/dist/index.js

@@ -4551,7 +4551,7 @@ var require_picomatch2 = __commonJS(function(exports, module) {
 });
 
 // src/hooks/matrix-loop/constants.ts
-var HOOK_NAME5 = "matrix-loop", DEFAULT_STATE_FILE = ".matrixx/matrix-loop.local.md", DEFAULT_MAX_ITERATIONS = 100, DEFAULT_COMPLETION_PROMISE = "DONE", DEFAULT_VERIFICATION_AGENT = "merovingian", DEFAULT_VERIFICATION_TIMEOUT_MS = 30000, DEFAULT_VERIFICATION_MAX_RETRIES = 2;
+var HOOK_NAME6 = "matrix-loop", DEFAULT_STATE_FILE = ".matrixx/matrix-loop.local.md", DEFAULT_MAX_ITERATIONS = 100, DEFAULT_COMPLETION_PROMISE = "DONE", DEFAULT_VERIFICATION_AGENT = "merovingian", DEFAULT_VERIFICATION_TIMEOUT_MS = 30000, DEFAULT_VERIFICATION_MAX_RETRIES = 2;
 
 // src/hooks/matrix-loop/storage.ts
 var exports_storage = {};
@@ -55689,6 +55689,75 @@ function createCompactionTodoPreserverHook(ctx) {
   };
   return { capture, event };
 }
+// src/hooks/context-mode-enforcer/constants.ts
+var HOOK_NAME3 = "context-mode-enforcer";
+var WARN_MESSAGE_READ = "Use ctx_search / ctx_batch_execute / ctx_execute for analysis \u2014 raw read/grep/glob bypasses FTS5 sandbox and pollutes context. Use Read only with hashline IDs for Edit.";
+var BLOCK_MESSAGE_GREP_GLOB = "Blocked: raw grep/glob is forbidden when context-mode is enforced. Use ctx_search (indexed) \u2192 grep/glob fallback only when ctx_* unavailable, or ctx_batch_execute / ctx_execute for multi-file analysis.";
+var WARN_MESSAGE_BASH_READ = "Use ctx_* / Read tool instead of `cat`/`head`/`tail`/`grep` via bash for analysis. Raw bash file reads bypass sandbox.";
+
+// src/hooks/context-mode-enforcer/hook.ts
+var BASH_FILE_READ_RE = /^\s*(cat|head|tail)\s+/;
+var BASH_GREP_RE = /\bgrep\b/;
+function resolveContextModeConfig(pluginConfig) {
+  const cfg = pluginConfig.context_mode;
+  return {
+    enabled: cfg?.enabled ?? true,
+    enforce: cfg?.enforce ?? false,
+    blockedTools: new Set((cfg?.blocked_tools ?? ["grep", "glob"]).map((t) => t.toLowerCase()))
+  };
+}
+function createContextModeEnforcerHook(pluginConfig) {
+  const { enabled, enforce, blockedTools } = resolveContextModeConfig(pluginConfig);
+  return {
+    "tool.execute.before": async (input, output) => {
+      if (!enabled)
+        return;
+      const tool = input.tool.toLowerCase();
+      const isBlocked = blockedTools.has(tool);
+      const isRead = tool === "read";
+      const isGrepGlob = tool === "grep" || tool === "glob";
+      const isBash = tool === "bash";
+      if (isBash) {
+        const command = output.args.command;
+        if (typeof command !== "string")
+          return;
+        const isFileRead = BASH_FILE_READ_RE.test(command);
+        const isGrep = BASH_GREP_RE.test(command);
+        if (!isFileRead && !isGrep)
+          return;
+        if (enforce && blockedTools.has("bash")) {
+          log(`[${HOOK_NAME3}] BLOCKED bash file read`, {
+            sessionID: input.sessionID,
+            command: command.slice(0, 120)
+          });
+          throw new Error(`${BLOCK_MESSAGE_GREP_GLOB}
+
+Bash command: ${command.slice(0, 200)}`);
+        }
+        output.message = WARN_MESSAGE_BASH_READ;
+        log(`[${HOOK_NAME3}] warned on bash`, { sessionID: input.sessionID, command: command.slice(0, 120) });
+        return;
+      }
+      if (isRead) {
+        if (!isBlocked)
+          return;
+        output.message = WARN_MESSAGE_READ;
+        log(`[${HOOK_NAME3}] warned on read (soft)`, { sessionID: input.sessionID });
+        return;
+      }
+      if (isGrepGlob) {
+        if (!isBlocked)
+          return;
+        if (enforce) {
+          log(`[${HOOK_NAME3}] BLOCKED ${tool}`, { sessionID: input.sessionID });
+          throw new Error(BLOCK_MESSAGE_GREP_GLOB);
+        }
+        output.message = WARN_MESSAGE_READ;
+        log(`[${HOOK_NAME3}] warned on ${tool} (soft)`, { sessionID: input.sessionID });
+      }
+    }
+  };
+}
 // src/hooks/context-window-monitor.ts
 var ANTHROPIC_DISPLAY_LIMIT = 1e6;
 var ANTHROPIC_ACTUAL_LIMIT2 = process.env.ANTHROPIC_1M_CONTEXT === "true" || process.env.VERTEX_ANTHROPIC_1M_CONTEXT === "true" ? 1e6 : 200000;
@@ -55881,7 +55950,7 @@ ${guidance}`;
 import { join as join35 } from "path";
 
 // src/hooks/design-intent-preserver/constants.ts
-var HOOK_NAME3 = "design-intent-preserver";
+var HOOK_NAME4 = "design-intent-preserver";
 var PLANS_DIR2 = ".matrixx/plans";
 var PHASE_TRANSITION_PATTERN = /\bphase[\s\-:]*(\d+)\b/i;
 var CONSTRUCT_INDICATORS = /\b(?:construct|web[\s-]?designer|frontend[\s-]?ui[\s-]?ux)\b|@designer/i;
@@ -55968,7 +56037,7 @@ function createDesignIntentPreserverHook(_ctx) {
 ---
 
 ${originalText}`;
-      log(`[${HOOK_NAME3}] injected design intent guardrail`, {
+      log(`[${HOOK_NAME4}] injected design intent guardrail`, {
         sessionID: input.sessionID,
         planPath
       });
@@ -59515,18 +59584,18 @@ function extractPromptText3(parts) {
 }
 // src/features/ultrawork-state/manager.ts
 init_logger();
-var HOOK_NAME4 = "ultrawork-state";
+var HOOK_NAME5 = "ultrawork-state";
 var sessionStates = new Map;
 function getUltraworkState(sessionID) {
   return sessionStates.get(sessionID);
 }
 function enableUltrawork(sessionID) {
   sessionStates.set(sessionID, "enabled");
-  log(`[${HOOK_NAME4}] Ultrawork enabled for session`, { sessionID });
+  log(`[${HOOK_NAME5}] Ultrawork enabled for session`, { sessionID });
 }
 function disableUltrawork(sessionID) {
   sessionStates.set(sessionID, "disabled");
-  log(`[${HOOK_NAME4}] Ultrawork disabled for session`, { sessionID });
+  log(`[${HOOK_NAME5}] Ultrawork disabled for session`, { sessionID });
 }
 // src/hooks/keyword-detector/hook.ts
 function createKeywordDetectorHook(ctx, _collector) {
@@ -59659,7 +59728,7 @@ function createLoopStateController(options) {
       };
       const success2 = writeState(directory, state3, stateDir);
       if (success2) {
-        log(`[${HOOK_NAME5}] Loop started`, {
+        log(`[${HOOK_NAME6}] Loop started`, {
           sessionID,
           maxIterations: state3.max_iterations,
           completionPromise: state3.completion_promise
@@ -59674,7 +59743,7 @@ function createLoopStateController(options) {
       }
       const success2 = clearState(directory, stateDir);
       if (success2) {
-        log(`[${HOOK_NAME5}] Loop cancelled`, { sessionID, iteration: state3.iteration });
+        log(`[${HOOK_NAME6}] Loop cancelled`, { sessionID, iteration: state3.iteration });
       }
       return success2;
     },
@@ -59751,7 +59820,7 @@ async function detectCompletionInSessionMessages(ctx, options) {
     return false;
   } catch (err) {
     setTimeout(() => {
-      log(`[${HOOK_NAME5}] Session messages check failed`, {
+      log(`[${HOOK_NAME6}] Session messages check failed`, {
         sessionID: options.sessionID,
         error: String(err)
       });
@@ -59832,7 +59901,7 @@ async function verifyCompletion(ctx, options) {
       query: { directory: options.directory }
     });
     if (createResult.error || !createResult.data?.id) {
-      log(`[${HOOK_NAME5}] Verification session creation failed`);
+      log(`[${HOOK_NAME6}] Verification session creation failed`);
       return { verified: true };
     }
     verifySessionID = createResult.data.id;
@@ -59862,16 +59931,16 @@ async function verifyCompletion(ctx, options) {
           return parseVerificationResponse(assistantText);
         }
       } catch {
-        log(`[${HOOK_NAME5}] Verification poll error`);
+        log(`[${HOOK_NAME6}] Verification poll error`);
       }
       await new Promise((resolve5) => {
         setTimeout(resolve5, pollIntervalMs);
       });
     }
-    log(`[${HOOK_NAME5}] Verification timed out, assuming pass`);
+    log(`[${HOOK_NAME6}] Verification timed out, assuming pass`);
     return { verified: true };
   } catch (err) {
-    log(`[${HOOK_NAME5}] Verification error: ${String(err)}`);
+    log(`[${HOOK_NAME6}] Verification error: ${String(err)}`);
     return { verified: true };
   } finally {
     if (verifySessionID) {
@@ -59947,7 +60016,7 @@ async function injectContinuationPrompt(ctx, options) {
 
 // src/hooks/matrix-loop/matrix-loop-event-handler.ts
 async function handleVerificationFailure(ctx, options, state3, sessionID, reason, failedCount) {
-  log(`[${HOOK_NAME5}] Verification failed`, { sessionID, reason });
+  log(`[${HOOK_NAME6}] Verification failed`, { sessionID, reason });
   const newState = options.loopState.incrementIteration();
   if (newState) {
     newState.verification_failed_count = failedCount + 1;
@@ -59965,7 +60034,7 @@ ${buildContinuationPrompt(newState ?? state3)}`,
       apiTimeoutMs: options.apiTimeoutMs
     });
   } catch (err) {
-    log(`[${HOOK_NAME5}] Failed to inject verification feedback`, { sessionID, error: String(err) });
+    log(`[${HOOK_NAME6}] Failed to inject verification feedback`, { sessionID, error: String(err) });
   }
 }
 function createMatrixLoopEventHandler(ctx, options) {
@@ -59977,13 +60046,13 @@ function createMatrixLoopEventHandler(ctx, options) {
       if (!sessionID)
         return;
       if (inFlightSessions.has(sessionID)) {
-        log(`[${HOOK_NAME5}] Skipped: handler in flight`, { sessionID });
+        log(`[${HOOK_NAME6}] Skipped: handler in flight`, { sessionID });
         return;
       }
       inFlightSessions.add(sessionID);
       try {
         if (options.sessionRecovery.isRecovering(sessionID)) {
-          log(`[${HOOK_NAME5}] Skipped: in recovery`, { sessionID });
+          log(`[${HOOK_NAME6}] Skipped: in recovery`, { sessionID });
           return;
         }
         const state3 = options.loopState.getState();
@@ -59995,11 +60064,11 @@ function createMatrixLoopEventHandler(ctx, options) {
               const exists = await options.checkSessionExists(state3.session_id);
               if (!exists) {
                 options.loopState.clear();
-                log(`[${HOOK_NAME5}] Cleared orphaned state from deleted session`, { orphanedSessionId: state3.session_id, currentSessionId: sessionID });
+                log(`[${HOOK_NAME6}] Cleared orphaned state from deleted session`, { orphanedSessionId: state3.session_id, currentSessionId: sessionID });
                 return;
               }
             } catch (err) {
-              log(`[${HOOK_NAME5}] Failed to check session existence`, { sessionId: state3.session_id, error: String(err) });
+              log(`[${HOOK_NAME6}] Failed to check session existence`, { sessionId: state3.session_id, error: String(err) });
             }
           }
           return;
@@ -60018,7 +60087,7 @@ function createMatrixLoopEventHandler(ctx, options) {
             messages = Array.isArray(messagesResponse) ? messagesResponse : Array.isArray(responseData) ? responseData : [];
           } catch (err) {
             setTimeout(() => {
-              log(`[${HOOK_NAME5}] Session messages fetch failed`, { sessionID, error: String(err) });
+              log(`[${HOOK_NAME6}] Session messages fetch failed`, { sessionID, error: String(err) });
             }, 0);
             messages = [];
           }
@@ -60031,7 +60100,7 @@ function createMatrixLoopEventHandler(ctx, options) {
           preFetchedMessages: messages
         });
         if (completionViaTranscript || completionViaApi) {
-          log(`[${HOOK_NAME5}] Completion detected!`, { sessionID, iteration: state3.iteration, promise: state3.completion_promise, detectedVia: completionViaTranscript ? "transcript_file" : "session_messages_api" });
+          log(`[${HOOK_NAME6}] Completion detected!`, { sessionID, iteration: state3.iteration, promise: state3.completion_promise, detectedVia: completionViaTranscript ? "transcript_file" : "session_messages_api" });
           if (options.verification?.enabled === true) {
             const maxRetries = options.verification?.maxRetries ?? DEFAULT_VERIFICATION_MAX_RETRIES;
             const failedCount = state3.verification_failed_count ?? 0;
@@ -60066,7 +60135,7 @@ function createMatrixLoopEventHandler(ctx, options) {
           return;
         }
         if (state3.iteration >= state3.max_iterations) {
-          log(`[${HOOK_NAME5}] Max iterations reached`, { sessionID, iteration: state3.iteration, max: state3.max_iterations });
+          log(`[${HOOK_NAME6}] Max iterations reached`, { sessionID, iteration: state3.iteration, max: state3.max_iterations });
           options.loopState.clear();
           await ctx.client.tui.showToast({ body: { title: "Matrix Loop Stopped", message: `Max iterations (${state3.max_iterations}) reached without completion`, variant: "warning", duration: 5000 } }).catch((err) => {
             log("[matrix-loop] Max iterations toast failed:", err);
@@ -60075,17 +60144,17 @@ function createMatrixLoopEventHandler(ctx, options) {
         }
         const newState = options.loopState.incrementIteration();
         if (!newState) {
-          log(`[${HOOK_NAME5}] Failed to increment iteration`, { sessionID });
+          log(`[${HOOK_NAME6}] Failed to increment iteration`, { sessionID });
           return;
         }
-        log(`[${HOOK_NAME5}] Continuing loop`, { sessionID, iteration: newState.iteration, max: newState.max_iterations });
+        log(`[${HOOK_NAME6}] Continuing loop`, { sessionID, iteration: newState.iteration, max: newState.max_iterations });
         await ctx.client.tui.showToast({ body: { title: "Matrix Loop", message: `Iteration ${newState.iteration}/${newState.max_iterations}`, variant: "info", duration: 2000 } }).catch((err) => {
           log("[matrix-loop] Iteration toast failed:", err);
         });
         try {
           await injectContinuationPrompt(ctx, { sessionID, prompt: buildContinuationPrompt(newState), directory: options.directory, apiTimeoutMs: options.apiTimeoutMs });
         } catch (err) {
-          log(`[${HOOK_NAME5}] Failed to inject continuation`, { sessionID, error: String(err) });
+          log(`[${HOOK_NAME6}] Failed to inject continuation`, { sessionID, error: String(err) });
         }
         return;
       } finally {
@@ -60099,7 +60168,7 @@ function createMatrixLoopEventHandler(ctx, options) {
       const state3 = options.loopState.getState();
       if (state3?.session_id === sessionInfo.id) {
         options.loopState.clear();
-        log(`[${HOOK_NAME5}] Session deleted, loop cleared`, { sessionID: sessionInfo.id });
+        log(`[${HOOK_NAME6}] Session deleted, loop cleared`, { sessionID: sessionInfo.id });
       }
       options.sessionRecovery.clear(sessionInfo.id);
       return;
@@ -60112,7 +60181,7 @@ function createMatrixLoopEventHandler(ctx, options) {
           const state3 = options.loopState.getState();
           if (state3?.session_id === sessionID) {
             options.loopState.clear();
-            log(`[${HOOK_NAME5}] User aborted, loop cleared`, { sessionID });
+            log(`[${HOOK_NAME6}] User aborted, loop cleared`, { sessionID });
           }
           options.sessionRecovery.clear(sessionID);
         }
@@ -60205,7 +60274,7 @@ function createMcpStartupNotificationHook(ctx) {
   };
 }
 // src/hooks/mouse-notepad/constants.ts
-var HOOK_NAME6 = "mouse-notepad";
+var HOOK_NAME7 = "mouse-notepad";
 var NOTEPAD_DIRECTIVE = `
 <Work_Context>
 ## Notepad Location (for recording learnings)
@@ -60252,14 +60321,14 @@ function createMouseNotepadHook(ctx) {
         return;
       }
       output.args.prompt = NOTEPAD_DIRECTIVE + prompt;
-      log(`[${HOOK_NAME6}] Injected notepad directive to task`, {
+      log(`[${HOOK_NAME7}] Injected notepad directive to task`, {
         sessionID: input.sessionID
       });
     }
   };
 }
 // src/hooks/non-interactive-env/constants.ts
-var HOOK_NAME7 = "non-interactive-env";
+var HOOK_NAME8 = "non-interactive-env";
 var NON_INTERACTIVE_ENV = {
   CI: "true",
   DEBIAN_FRONTEND: "noninteractive",
@@ -60350,7 +60419,7 @@ function createNonInteractiveEnvHook(_ctx) {
       }
       const envPrefix = buildEnvPrefix(NON_INTERACTIVE_ENV, "unix");
       output.args.command = `${envPrefix} ${command}`;
-      log(`[${HOOK_NAME7}] Prepended non-interactive env vars to git command`, {
+      log(`[${HOOK_NAME8}] Prepended non-interactive env vars to git command`, {
         sessionID: input.sessionID,
         envPrefix
       });
@@ -60358,7 +60427,7 @@ function createNonInteractiveEnvHook(_ctx) {
   };
 }
 // src/hooks/oracle-md-only/constants.ts
-var HOOK_NAME8 = "oracle-md-only";
+var HOOK_NAME9 = "oracle-md-only";
 var ORACLE_AGENT = "oracle";
 var ALLOWED_EXTENSIONS = [".md"];
 var BLOCKED_TOOLS = ["Write", "Edit", "write", "edit"];
@@ -60491,7 +60560,7 @@ function createOracleMdOnlyHook(ctx) {
         const prompt = output.args.prompt;
         if (prompt && !prompt.includes(SYSTEM_DIRECTIVE_PREFIX)) {
           output.args.prompt = PLANNING_CONSULT_WARNING + prompt;
-          log(`[${HOOK_NAME8}] Injected read-only planning warning to ${toolName}`, {
+          log(`[${HOOK_NAME9}] Injected read-only planning warning to ${toolName}`, {
             sessionID: input.sessionID,
             tool: toolName,
             agent: agentName
@@ -60507,17 +60576,17 @@ function createOracleMdOnlyHook(ctx) {
         return;
       }
       if (!isAllowedFile(filePath, ctx.directory)) {
-        log(`[${HOOK_NAME8}] Blocked: Oracle can only write to .matrixx/*.md`, {
+        log(`[${HOOK_NAME9}] Blocked: Oracle can only write to .matrixx/*.md`, {
           sessionID: input.sessionID,
           tool: toolName,
           filePath,
           agent: agentName
         });
-        throw new Error(`[${HOOK_NAME8}] ${getAgentDisplayName("oracle")} can only write/edit .md files inside .matrixx/ directory. ` + `Attempted to modify: ${filePath}. ` + `${getAgentDisplayName("oracle")} is a READ-ONLY planner. Use /start-work to execute the plan. ` + `APOLOGIZE TO THE USER, REMIND OF YOUR PLAN WRITING PROCESSES, TELL USER WHAT YOU WILL GOING TO DO AS THE PROCESS, WRITE THE PLAN`);
+        throw new Error(`[${HOOK_NAME9}] ${getAgentDisplayName("oracle")} can only write/edit .md files inside .matrixx/ directory. ` + `Attempted to modify: ${filePath}. ` + `${getAgentDisplayName("oracle")} is a READ-ONLY planner. Use /start-work to execute the plan. ` + `APOLOGIZE TO THE USER, REMIND OF YOUR PLAN WRITING PROCESSES, TELL USER WHAT YOU WILL GOING TO DO AS THE PROCESS, WRITE THE PLAN`);
       }
       const normalizedPath = filePath.toLowerCase().replace(/\\/g, "/");
       if (normalizedPath.includes(".matrixx/plans/") || normalizedPath.includes(".matrixx\\plans\\")) {
-        log(`[${HOOK_NAME8}] Injecting workflow reminder for plan write`, {
+        log(`[${HOOK_NAME9}] Injecting workflow reminder for plan write`, {
           sessionID: input.sessionID,
           tool: toolName,
           filePath,
@@ -60525,7 +60594,7 @@ function createOracleMdOnlyHook(ctx) {
         });
         output.message = (output.message || "") + ORACLE_WORKFLOW_REMINDER;
       }
-      log(`[${HOOK_NAME8}] Allowed: .matrixx/*.md write permitted`, {
+      log(`[${HOOK_NAME9}] Allowed: .matrixx/*.md write permitted`, {
         sessionID: input.sessionID,
         tool: toolName,
         filePath,
@@ -60596,7 +60665,7 @@ async function getGitHead(directory) {
 }
 
 // src/hooks/plan-persister/hook.ts
-var HOOK_NAME9 = "plan-persister";
+var HOOK_NAME10 = "plan-persister";
 function createPlanPersister(ctx, options) {
   const { directory } = options;
   const capture = async (sessionID) => {
@@ -60615,7 +60684,7 @@ function createPlanPersister(ctx, options) {
       const response = await ctx.client.session.todo({ path: { id: sessionID } });
       todos = normalizeTodos(response);
     } catch (err) {
-      log(`[${HOOK_NAME9}] Failed to fetch todos`, { sessionID, error: String(err) });
+      log(`[${HOOK_NAME10}] Failed to fetch todos`, { sessionID, error: String(err) });
       return;
     }
     const content = readPlanFile(planPath);
@@ -60637,9 +60706,9 @@ function createPlanPersister(ctx, options) {
     ensurePlanDir(directory);
     const ok = atomicWrite(planPath, finalContent);
     if (ok) {
-      log(`[${HOOK_NAME9}] Plan file updated`, { planPath, completed, total });
+      log(`[${HOOK_NAME10}] Plan file updated`, { planPath, completed, total });
     } else {
-      log(`[${HOOK_NAME9}] Failed to write plan file`, { planPath });
+      log(`[${HOOK_NAME10}] Failed to write plan file`, { planPath });
     }
   };
   const event = async ({ event: evt }) => {
@@ -62640,7 +62709,7 @@ var RETRYABLE_ERROR_PATTERNS = [
   /(?:^|\s)503(?:\s|$)/,
   /(?:^|\s)529(?:\s|$)/
 ];
-var HOOK_NAME10 = "runtime-fallback";
+var HOOK_NAME11 = "runtime-fallback";
 
 // src/hooks/runtime-fallback/fallback-models.ts
 init_logger();
@@ -62731,7 +62800,7 @@ function getRawFallbackModelsForSession(sessionID, agent, pluginConfig) {
     if (result)
       return result;
   }
-  log(`[${HOOK_NAME10}] No category/agent fallback models resolved for session`, { sessionID, agent });
+  log(`[${HOOK_NAME11}] No category/agent fallback models resolved for session`, { sessionID, agent });
   return;
 }
 
@@ -62760,21 +62829,21 @@ function findNextAvailableFallback(state3, fallbackModels, cooldownSeconds) {
     if (!isModelInCooldown(candidate, state3, cooldownSeconds)) {
       return candidate;
     }
-    log(`[${HOOK_NAME10}] Skipping fallback model in cooldown`, { model: candidate, index: i });
+    log(`[${HOOK_NAME11}] Skipping fallback model in cooldown`, { model: candidate, index: i });
   }
   return;
 }
 function prepareFallback(sessionID, state3, fallbackModels, config2) {
   if (state3.attemptCount >= config2.max_fallback_attempts) {
-    log(`[${HOOK_NAME10}] Max fallback attempts reached`, { sessionID, attempts: state3.attemptCount });
+    log(`[${HOOK_NAME11}] Max fallback attempts reached`, { sessionID, attempts: state3.attemptCount });
     return { success: false, error: "Max fallback attempts reached", maxAttemptsReached: true };
   }
   const nextModel = findNextAvailableFallback(state3, fallbackModels, config2.cooldown_seconds);
   if (!nextModel) {
-    log(`[${HOOK_NAME10}] No available fallback models`, { sessionID });
+    log(`[${HOOK_NAME11}] No available fallback models`, { sessionID });
     return { success: false, error: "No available fallback models (all in cooldown or exhausted)" };
   }
-  log(`[${HOOK_NAME10}] Preparing fallback`, {
+  log(`[${HOOK_NAME11}] Preparing fallback`, {
     sessionID,
     from: state3.currentModel,
     to: nextModel,
@@ -62860,9 +62929,9 @@ function createAutoRetryHelpers(deps) {
   const abortSessionRequest = async (sessionID, source) => {
     try {
       await ctx.client.session.abort({ path: { id: sessionID } });
-      log(`[${HOOK_NAME10}] Aborted in-flight session request (${source})`, { sessionID });
+      log(`[${HOOK_NAME11}] Aborted in-flight session request (${source})`, { sessionID });
     } catch (error51) {
-      log(`[${HOOK_NAME10}] Failed to abort in-flight session request (${source})`, {
+      log(`[${HOOK_NAME11}] Failed to abort in-flight session request (${source})`, {
         sessionID,
         error: String(error51)
       });
@@ -62886,7 +62955,7 @@ function createAutoRetryHelpers(deps) {
       if (!state3)
         return;
       if (sessionRetryInFlight.has(sessionID)) {
-        log(`[${HOOK_NAME10}] Overriding in-flight retry due to session timeout`, { sessionID });
+        log(`[${HOOK_NAME11}] Overriding in-flight retry due to session timeout`, { sessionID });
       }
       await abortSessionRequest(sessionID, "session.timeout");
       sessionRetryInFlight.delete(sessionID);
@@ -62896,7 +62965,7 @@ function createAutoRetryHelpers(deps) {
       const fallbackModels = getFallbackModelsForSession(sessionID, resolvedAgent, pluginConfig);
       if (fallbackModels.length === 0)
         return;
-      log(`[${HOOK_NAME10}] Session fallback timeout reached`, {
+      log(`[${HOOK_NAME11}] Session fallback timeout reached`, {
         sessionID,
         timeoutSeconds: config2.timeout_seconds,
         currentModel: state3.currentModel
@@ -62910,7 +62979,7 @@ function createAutoRetryHelpers(deps) {
   };
   const autoRetryWithFallback = async (sessionID, newModel, resolvedAgent, source) => {
     if (sessionRetryInFlight.has(sessionID)) {
-      log(`[${HOOK_NAME10}] Retry already in flight, skipping (${source})`, { sessionID });
+      log(`[${HOOK_NAME11}] Retry already in flight, skipping (${source})`, { sessionID });
       return;
     }
     const agentSettings = resolvedAgent ? pluginConfig?.agents?.[resolvedAgent] : undefined;
@@ -62919,7 +62988,7 @@ function createAutoRetryHelpers(deps) {
       reasoningEffort: agentSettings.reasoningEffort
     } : undefined);
     if (!retryModelPayload) {
-      log(`[${HOOK_NAME10}] Invalid model format (missing provider prefix): ${newModel}`);
+      log(`[${HOOK_NAME11}] Invalid model format (missing provider prefix): ${newModel}`);
       const state3 = sessionStates2.get(sessionID);
       if (state3?.pendingFallbackModel) {
         state3.pendingFallbackModel = undefined;
@@ -62935,7 +63004,7 @@ function createAutoRetryHelpers(deps) {
       });
       const retryParts = getLastUserRetryParts(messagesResp);
       if (retryParts.length > 0) {
-        log(`[${HOOK_NAME10}] Auto-retrying with fallback model (${source})`, {
+        log(`[${HOOK_NAME11}] Auto-retrying with fallback model (${source})`, {
           sessionID,
           model: newModel
         });
@@ -62954,10 +63023,10 @@ function createAutoRetryHelpers(deps) {
         });
         retryDispatched = true;
       } else {
-        log(`[${HOOK_NAME10}] No user message found for auto-retry (${source})`, { sessionID });
+        log(`[${HOOK_NAME11}] No user message found for auto-retry (${source})`, { sessionID });
       }
     } catch (retryError) {
-      log(`[${HOOK_NAME10}] Auto-retry failed (${source})`, { sessionID, error: String(retryError) });
+      log(`[${HOOK_NAME11}] Auto-retry failed (${source})`, { sessionID, error: String(retryError) });
     } finally {
       sessionRetryInFlight.delete(sessionID);
       if (!retryDispatched) {
@@ -63011,7 +63080,7 @@ function createAutoRetryHelpers(deps) {
       }
     }
     if (cleanedCount > 0) {
-      log(`[${HOOK_NAME10}] Cleaned up ${cleanedCount} stale session states`);
+      log(`[${HOOK_NAME11}] Cleaned up ${cleanedCount} stale session states`);
     }
   };
   return {
@@ -63042,7 +63111,7 @@ function createChatMessageHandler(deps) {
         state3.pendingFallbackModel = undefined;
         return;
       }
-      log(`[${HOOK_NAME10}] Detected manual model change, resetting fallback state`, {
+      log(`[${HOOK_NAME11}] Detected manual model change, resetting fallback state`, {
         sessionID,
         from: state3.currentModel,
         to: requestedModel
@@ -63054,7 +63123,7 @@ function createChatMessageHandler(deps) {
     if (state3.currentModel === state3.originalModel)
       return;
     const activeModel = state3.currentModel;
-    log(`[${HOOK_NAME10}] Applying fallback model override`, {
+    log(`[${HOOK_NAME11}] Applying fallback model override`, {
       sessionID,
       from: input.model,
       to: activeModel
@@ -63241,7 +63310,7 @@ function resolveFallbackBootstrapModel(options) {
   const agentConfig = options.resolvedAgent && agentConfigs ? agentConfigs[options.resolvedAgent] : undefined;
   const agentModel = typeof agentConfig?.model === "string" ? agentConfig.model : undefined;
   if (agentModel) {
-    log(`[${HOOK_NAME10}] Derived model from agent config for ${options.source}`, {
+    log(`[${HOOK_NAME11}] Derived model from agent config for ${options.source}`, {
       sessionID: options.sessionID,
       agent: options.resolvedAgent,
       model: agentModel
@@ -63252,7 +63321,7 @@ function resolveFallbackBootstrapModel(options) {
   if (agentCategory) {
     const agentCategoryModel = options.pluginConfig?.categories?.[agentCategory]?.model;
     if (typeof agentCategoryModel === "string" && agentCategoryModel.length > 0) {
-      log(`[${HOOK_NAME10}] Derived model from agent category config for ${options.source}`, {
+      log(`[${HOOK_NAME11}] Derived model from agent category config for ${options.source}`, {
         sessionID: options.sessionID,
         agent: options.resolvedAgent,
         category: agentCategory,
@@ -63264,7 +63333,7 @@ function resolveFallbackBootstrapModel(options) {
   const sessionCategory = SessionCategoryRegistry.get(options.sessionID);
   const categoryModel = sessionCategory ? options.pluginConfig?.categories?.[sessionCategory]?.model : undefined;
   if (typeof categoryModel === "string" && categoryModel.length > 0) {
-    log(`[${HOOK_NAME10}] Derived model from session category config for ${options.source}`, {
+    log(`[${HOOK_NAME11}] Derived model from session category config for ${options.source}`, {
       sessionID: options.sessionID,
       category: sessionCategory,
       model: categoryModel
@@ -63294,7 +63363,7 @@ async function dispatchFallbackRetry(deps, helpers, options) {
     await helpers.autoRetryWithFallback(options.sessionID, result.newModel, options.resolvedAgent, options.source);
     return;
   }
-  log(`[${HOOK_NAME10}] Fallback preparation failed`, {
+  log(`[${HOOK_NAME11}] Fallback preparation failed`, {
     sessionID: options.sessionID,
     source: options.source,
     error: result.error
@@ -63347,14 +63416,14 @@ function createSessionStatusHandler(deps, helpers, sessionStatusRetryKeys) {
     sessionStatusRetryKeys.set(sessionID, retryKey);
     if (sessionRetryInFlight.has(sessionID)) {
       if (timeoutEnabled) {
-        log(`[${HOOK_NAME10}] Overriding in-flight retry due to provider auto-retry signal`, {
+        log(`[${HOOK_NAME11}] Overriding in-flight retry due to provider auto-retry signal`, {
           sessionID,
           model
         });
         await helpers.abortSessionRequest(sessionID, "session.status.retry-signal");
         sessionRetryInFlight.delete(sessionID);
       } else {
-        log(`[${HOOK_NAME10}] session.status retry skipped - retry already in flight`, { sessionID });
+        log(`[${HOOK_NAME11}] session.status retry skipped - retry already in flight`, { sessionID });
         return;
       }
     }
@@ -63377,7 +63446,7 @@ function createSessionStatusHandler(deps, helpers, sessionStatusRetryKeys) {
       });
       if (!initialModel) {
         sessionStatusRetryKeys.delete(sessionID);
-        log(`[${HOOK_NAME10}] session.status retry missing model info, cannot fallback`, { sessionID });
+        log(`[${HOOK_NAME11}] session.status retry missing model info, cannot fallback`, { sessionID });
         return;
       }
       state3 = createFallbackState(initialModel);
@@ -63386,20 +63455,20 @@ function createSessionStatusHandler(deps, helpers, sessionStatusRetryKeys) {
     sessionLastAccess.set(sessionID, Date.now());
     if (state3.pendingFallbackModel) {
       if (timeoutEnabled) {
-        log(`[${HOOK_NAME10}] Clearing pending fallback due to provider auto-retry signal`, {
+        log(`[${HOOK_NAME11}] Clearing pending fallback due to provider auto-retry signal`, {
           sessionID,
           pendingFallbackModel: state3.pendingFallbackModel
         });
         state3.pendingFallbackModel = undefined;
       } else {
-        log(`[${HOOK_NAME10}] session.status retry skipped (pending fallback in progress)`, {
+        log(`[${HOOK_NAME11}] session.status retry skipped (pending fallback in progress)`, {
           sessionID,
           pendingFallbackModel: state3.pendingFallbackModel
         });
         return;
       }
     }
-    log(`[${HOOK_NAME10}] Detected provider auto-retry signal in session.status`, {
+    log(`[${HOOK_NAME11}] Detected provider auto-retry signal in session.status`, {
       sessionID,
       model: state3.currentModel,
       retryAttempt: status.attempt
@@ -63435,7 +63504,7 @@ function createEventHandler(deps, helpers) {
     const sessionID = sessionInfo?.id;
     const model = sessionInfo?.model;
     if (sessionID && model) {
-      log(`[${HOOK_NAME10}] Session created with model`, { sessionID, model });
+      log(`[${HOOK_NAME11}] Session created with model`, { sessionID, model });
       sessionStates2.set(sessionID, createFallbackState(model));
       sessionLastAccess.set(sessionID, Date.now());
     }
@@ -63444,7 +63513,7 @@ function createEventHandler(deps, helpers) {
     const sessionInfo = props?.info;
     const sessionID = sessionInfo?.id;
     if (sessionID) {
-      log(`[${HOOK_NAME10}] Cleaning up session state`, { sessionID });
+      log(`[${HOOK_NAME11}] Cleaning up session state`, { sessionID });
       cancelledSessions.delete(sessionID);
       sessionStates2.delete(sessionID);
       sessionLastAccess.delete(sessionID);
@@ -63464,7 +63533,7 @@ function createEventHandler(deps, helpers) {
     }
     cancelledSessions.add(sessionID);
     resetRetryState(sessionID);
-    log(`[${HOOK_NAME10}] Cleared fallback retry state on session.stop`, { sessionID });
+    log(`[${HOOK_NAME11}] Cleared fallback retry state on session.stop`, { sessionID });
   };
   const handleMessageUpdated = (props) => {
     const info = props?.info;
@@ -63480,11 +63549,11 @@ function createEventHandler(deps, helpers) {
       return;
     if (cancelledSessions.has(sessionID)) {
       resetRetryState(sessionID);
-      log(`[${HOOK_NAME10}] Cleared fallback retry state for cancelled session on idle`, { sessionID });
+      log(`[${HOOK_NAME11}] Cleared fallback retry state for cancelled session on idle`, { sessionID });
       return;
     }
     if (sessionAwaitingFallbackResult.has(sessionID)) {
-      log(`[${HOOK_NAME10}] session.idle while awaiting fallback result; keeping timeout armed`, { sessionID });
+      log(`[${HOOK_NAME11}] session.idle while awaiting fallback result; keeping timeout armed`, { sessionID });
       return;
     }
     const hadTimeout = sessionFallbackTimeouts.has(sessionID);
@@ -63496,7 +63565,7 @@ function createEventHandler(deps, helpers) {
       state3.pendingFallbackModel = undefined;
     }
     if (hadTimeout) {
-      log(`[${HOOK_NAME10}] Cleared fallback timeout after session completion`, { sessionID });
+      log(`[${HOOK_NAME11}] Cleared fallback timeout after session completion`, { sessionID });
     }
   };
   const handleSessionError = async (props) => {
@@ -63504,18 +63573,18 @@ function createEventHandler(deps, helpers) {
     const error51 = props?.error;
     const agent = props?.agent;
     if (!sessionID) {
-      log(`[${HOOK_NAME10}] session.error without sessionID, skipping`);
+      log(`[${HOOK_NAME11}] session.error without sessionID, skipping`);
       return;
     }
     const resolvedAgent = await helpers.resolveAgentForSessionFromContext(sessionID, agent);
     if (isAbortError(error51)) {
       cancelledSessions.add(sessionID);
       resetRetryState(sessionID);
-      log(`[${HOOK_NAME10}] session.error matched cancellation; cleared retry state`, { sessionID, resolvedAgent });
+      log(`[${HOOK_NAME11}] session.error matched cancellation; cleared retry state`, { sessionID, resolvedAgent });
       return;
     }
     if (sessionRetryInFlight.has(sessionID)) {
-      log(`[${HOOK_NAME10}] session.error skipped - retry in flight`, {
+      log(`[${HOOK_NAME11}] session.error skipped - retry in flight`, {
         sessionID,
         retryInFlight: true
       });
@@ -63523,7 +63592,7 @@ function createEventHandler(deps, helpers) {
     }
     sessionAwaitingFallbackResult.delete(sessionID);
     helpers.clearSessionFallbackTimeout(sessionID);
-    log(`[${HOOK_NAME10}] session.error received`, {
+    log(`[${HOOK_NAME11}] session.error received`, {
       sessionID,
       agent,
       resolvedAgent,
@@ -63532,7 +63601,7 @@ function createEventHandler(deps, helpers) {
       errorType: classifyErrorType(error51)
     });
     if (!isRetryableError(error51, config2.retry_on_errors)) {
-      log(`[${HOOK_NAME10}] Error not retryable, skipping fallback`, {
+      log(`[${HOOK_NAME11}] Error not retryable, skipping fallback`, {
         sessionID,
         retryable: false,
         statusCode: extractStatusCode(error51, config2.retry_on_errors),
@@ -63544,7 +63613,7 @@ function createEventHandler(deps, helpers) {
     let state3 = sessionStates2.get(sessionID);
     const fallbackModels = getFallbackModelsForSession(sessionID, resolvedAgent, pluginConfig);
     if (fallbackModels.length === 0) {
-      log(`[${HOOK_NAME10}] No fallback models configured`, { sessionID, agent });
+      log(`[${HOOK_NAME11}] No fallback models configured`, { sessionID, agent });
       return;
     }
     if (!state3) {
@@ -63556,7 +63625,7 @@ function createEventHandler(deps, helpers) {
         pluginConfig
       });
       if (!initialModel) {
-        log(`[${HOOK_NAME10}] No model info available, cannot fallback`, { sessionID });
+        log(`[${HOOK_NAME11}] No model info available, cannot fallback`, { sessionID });
         return;
       }
       state3 = createFallbackState(initialModel);
@@ -63696,7 +63765,7 @@ function createMessageUpdateHandler(deps, helpers) {
       }
       const hasVisible = await checkVisibleResponse(ctx, sessionID, info);
       if (!hasVisible) {
-        log(`[${HOOK_NAME10}] Assistant update observed without visible final response; keeping fallback timeout`, {
+        log(`[${HOOK_NAME11}] Assistant update observed without visible final response; keeping fallback timeout`, {
           sessionID,
           model
         });
@@ -63709,17 +63778,17 @@ function createMessageUpdateHandler(deps, helpers) {
       if (state3?.pendingFallbackModel) {
         state3.pendingFallbackModel = undefined;
       }
-      log(`[${HOOK_NAME10}] Assistant response observed; cleared fallback timeout`, { sessionID, model });
+      log(`[${HOOK_NAME11}] Assistant response observed; cleared fallback timeout`, { sessionID, model });
       return;
     }
     if (sessionID && role === "assistant" && error51) {
       sessionAwaitingFallbackResult.delete(sessionID);
       if (sessionRetryInFlight.has(sessionID) && !retrySignal) {
-        log(`[${HOOK_NAME10}] message.updated fallback skipped (retry in flight)`, { sessionID });
+        log(`[${HOOK_NAME11}] message.updated fallback skipped (retry in flight)`, { sessionID });
         return;
       }
       if (retrySignal && sessionRetryInFlight.has(sessionID) && timeoutEnabled) {
-        log(`[${HOOK_NAME10}] Overriding in-flight retry due to provider auto-retry signal`, {
+        log(`[${HOOK_NAME11}] Overriding in-flight retry due to provider auto-retry signal`, {
           sessionID,
           model
         });
@@ -63727,12 +63796,12 @@ function createMessageUpdateHandler(deps, helpers) {
         sessionRetryInFlight.delete(sessionID);
       }
       if (retrySignal && timeoutEnabled) {
-        log(`[${HOOK_NAME10}] Detected provider auto-retry signal`, { sessionID, model });
+        log(`[${HOOK_NAME11}] Detected provider auto-retry signal`, { sessionID, model });
       }
       if (!retrySignal) {
         helpers.clearSessionFallbackTimeout(sessionID);
       }
-      log(`[${HOOK_NAME10}] message.updated with assistant error`, {
+      log(`[${HOOK_NAME11}] message.updated with assistant error`, {
         sessionID,
         model,
         statusCode: extractStatusCode(error51, config2.retry_on_errors),
@@ -63740,7 +63809,7 @@ function createMessageUpdateHandler(deps, helpers) {
         errorType: classifyErrorType(error51)
       });
       if (!isRetryableError(error51, config2.retry_on_errors)) {
-        log(`[${HOOK_NAME10}] message.updated error not retryable, skipping fallback`, {
+        log(`[${HOOK_NAME11}] message.updated error not retryable, skipping fallback`, {
           sessionID,
           statusCode: extractStatusCode(error51, config2.retry_on_errors),
           errorName: extractErrorName(error51),
@@ -63764,7 +63833,7 @@ function createMessageUpdateHandler(deps, helpers) {
           pluginConfig
         });
         if (!initialModel) {
-          log(`[${HOOK_NAME10}] message.updated missing model info, cannot fallback`, {
+          log(`[${HOOK_NAME11}] message.updated missing model info, cannot fallback`, {
             sessionID,
             errorName: extractErrorName(error51),
             errorType: classifyErrorType(error51)
@@ -63778,13 +63847,13 @@ function createMessageUpdateHandler(deps, helpers) {
         sessionLastAccess.set(sessionID, Date.now());
         if (state3.pendingFallbackModel) {
           if (retrySignal && timeoutEnabled) {
-            log(`[${HOOK_NAME10}] Clearing pending fallback due to provider auto-retry signal`, {
+            log(`[${HOOK_NAME11}] Clearing pending fallback due to provider auto-retry signal`, {
               sessionID,
               pendingFallbackModel: state3.pendingFallbackModel
             });
             state3.pendingFallbackModel = undefined;
           } else {
-            log(`[${HOOK_NAME10}] message.updated fallback skipped (pending fallback in progress)`, {
+            log(`[${HOOK_NAME11}] message.updated fallback skipped (pending fallback in progress)`, {
               sessionID,
               pendingFallbackModel: state3.pendingFallbackModel
             });
@@ -64790,7 +64859,7 @@ function createSessionRecoveryHook(ctx, options) {
 }
 // src/hooks/start-work/start-work-hook.ts
 init_logger();
-var HOOK_NAME11 = "start-work";
+var HOOK_NAME12 = "start-work";
 var KEYWORD_PATTERN = /\b(ultrawork|ulw)\b/gi;
 function extractUserRequestPlanName(promptText) {
   const userRequestMatch = promptText.match(/<user-request>\s*([\s\S]*?)\s*<\/user-request>/i);
@@ -64820,7 +64889,7 @@ function createStartWorkHook(ctx) {
       if (!isStartWorkCommand) {
         return;
       }
-      log(`[${HOOK_NAME11}] Processing start-work command`, {
+      log(`[${HOOK_NAME12}] Processing start-work command`, {
         sessionID: input.sessionID
       });
       updateSessionAgent(input.sessionID, "architect");
@@ -64830,7 +64899,7 @@ function createStartWorkHook(ctx) {
       let contextInfo = "";
       const explicitPlanName = extractUserRequestPlanName(promptText);
       if (explicitPlanName) {
-        log(`[${HOOK_NAME11}] Explicit plan name requested: ${explicitPlanName}`, {
+        log(`[${HOOK_NAME12}] Explicit plan name requested: ${explicitPlanName}`, {
           sessionID: input.sessionID
         });
         const allPlans = findOraclePlans(ctx.directory);
@@ -64971,7 +65040,7 @@ Ask the user which plan to work on. Present the options above and wait for their
 ---
 ${contextInfo}`;
       }
-      log(`[${HOOK_NAME11}] Context injected`, {
+      log(`[${HOOK_NAME12}] Context injected`, {
         sessionID: input.sessionID,
         hasExistingState: !!existingState
       });
@@ -64980,16 +65049,16 @@ ${contextInfo}`;
 }
 // src/hooks/stop-continuation-guard/hook.ts
 init_logger();
-var HOOK_NAME12 = "stop-continuation-guard";
+var HOOK_NAME13 = "stop-continuation-guard";
 function createStopContinuationGuardHook(_ctx, options) {
   const stoppedSessions = new Set;
   const stop = (sessionID) => {
     stoppedSessions.add(sessionID);
-    log(`[${HOOK_NAME12}] Continuation stopped for session`, { sessionID });
+    log(`[${HOOK_NAME13}] Continuation stopped for session`, { sessionID });
     if (options?.backgroundManager) {
       const cancelled = options.backgroundManager.cancelAllForSession(sessionID);
       if (cancelled > 0) {
-        log(`[${HOOK_NAME12}] Cancelled ${cancelled} background task(s) for session`, { sessionID });
+        log(`[${HOOK_NAME13}] Cancelled ${cancelled} background task(s) for session`, { sessionID });
       }
     }
   };
@@ -64998,7 +65067,7 @@ function createStopContinuationGuardHook(_ctx, options) {
   };
   const clear = (sessionID) => {
     stoppedSessions.delete(sessionID);
-    log(`[${HOOK_NAME12}] Continuation guard cleared for session`, { sessionID });
+    log(`[${HOOK_NAME13}] Continuation guard cleared for session`, { sessionID });
   };
   const event = async ({
     event: event2
@@ -65008,7 +65077,7 @@ function createStopContinuationGuardHook(_ctx, options) {
       const sessionInfo = props?.info;
       if (sessionInfo?.id) {
         clear(sessionInfo.id);
-        log(`[${HOOK_NAME12}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
+        log(`[${HOOK_NAME13}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
       }
     }
   };
@@ -65017,7 +65086,7 @@ function createStopContinuationGuardHook(_ctx, options) {
   }) => {
     if (sessionID && stoppedSessions.has(sessionID)) {
       clear(sessionID);
-      log(`[${HOOK_NAME12}] Cleared stop state on new user message`, { sessionID });
+      log(`[${HOOK_NAME13}] Cleared stop state on new user message`, { sessionID });
     }
   };
   return {
@@ -65032,7 +65101,7 @@ function createStopContinuationGuardHook(_ctx, options) {
 init_logger();
 
 // src/hooks/task-continuation-enforcer/constants.ts
-var HOOK_NAME13 = "task-continuation-enforcer";
+var HOOK_NAME14 = "task-continuation-enforcer";
 var DEFAULT_SKIP_AGENTS = ["oracle", "compaction"];
 var CONTINUATION_PROMPT2 = `${createSystemDirective(SystemDirectiveTypes.TASK_CONTINUATION)}
 
@@ -65352,12 +65421,12 @@ async function injectContinuation(args) {
   } = args;
   const state3 = sessionStateStore.getExistingState(sessionID);
   if (state3?.isRecovering) {
-    log(`[${HOOK_NAME13}] Skipped injection: in recovery`, { sessionID });
+    log(`[${HOOK_NAME14}] Skipped injection: in recovery`, { sessionID });
     return;
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME13}] Skipped injection: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME14}] Skipped injection: background tasks running`, { sessionID });
     return;
   }
   const tasks = [];
@@ -65365,7 +65434,7 @@ async function injectContinuation(args) {
   try {
     const taskDir = getTaskDir({}, ctx.directory);
     if (!existsSync43(taskDir)) {
-      log(`[${HOOK_NAME13}] Skipped injection: no task dir`, { sessionID, taskDir });
+      log(`[${HOOK_NAME14}] Skipped injection: no task dir`, { sessionID, taskDir });
       return;
     }
     const files = readdirSync14(taskDir).filter((f) => f.startsWith("T-") && f.endsWith(".json"));
@@ -65376,16 +65445,16 @@ async function injectContinuation(args) {
     }
     total = tasks.length;
     if (total === 0) {
-      log(`[${HOOK_NAME13}] Skipped injection: no tasks`, { sessionID });
+      log(`[${HOOK_NAME14}] Skipped injection: no tasks`, { sessionID });
       return;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME13}] Failed to fetch tasks`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME14}] Failed to fetch tasks`, { sessionID, error: String(error51) });
     return;
   }
   const freshIncompleteCount = getIncompleteTaskCount(tasks);
   if (freshIncompleteCount === 0) {
-    log(`[${HOOK_NAME13}] Skipped injection: no incomplete tasks`, { sessionID, total });
+    log(`[${HOOK_NAME14}] Skipped injection: no incomplete tasks`, { sessionID, total });
     return;
   }
   let agentName = resolvedInfo?.agent;
@@ -65408,11 +65477,11 @@ async function injectContinuation(args) {
     tools = tools ?? previousMessage?.tools;
   }
   if (agentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(agentName))) {
-    log(`[${HOOK_NAME13}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME14}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
     return;
   }
   if (!hasWritePermission(tools)) {
-    log(`[${HOOK_NAME13}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME14}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
     return;
   }
   const byId = new Map(tasks.map((t) => [t.id, t]));
@@ -65436,7 +65505,7 @@ ${taskList}`;
     injectionState.inFlight = true;
   }
   try {
-    log(`[${HOOK_NAME13}] Injecting continuation`, {
+    log(`[${HOOK_NAME14}] Injecting continuation`, {
       sessionID,
       agent: agentName,
       model,
@@ -65451,14 +65520,14 @@ ${taskList}`;
       },
       query: { directory: ctx.directory }
     });
-    log(`[${HOOK_NAME13}] Injection successful`, { sessionID });
+    log(`[${HOOK_NAME14}] Injection successful`, { sessionID });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
       injectionState.consecutiveFailures = 0;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME13}] Injection failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME14}] Injection failed`, { sessionID, error: String(error51) });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
@@ -65491,7 +65560,10 @@ function startCountdown(args) {
     sessionStateStore
   } = args;
   const state3 = sessionStateStore.getState(sessionID);
-  sessionStateStore.cancelCountdown(sessionID);
+  if (state3.countdownTimer || state3.countdownInterval) {
+    log(`[${HOOK_NAME14}] Skipped: countdown already active`, { sessionID });
+    return;
+  }
   let secondsRemaining = COUNTDOWN_SECONDS;
   showCountdownToast(ctx, secondsRemaining, incompleteCount);
   state3.countdownStartedAt = Date.now();
@@ -65512,7 +65584,7 @@ function startCountdown(args) {
       sessionStateStore
     });
   }, COUNTDOWN_SECONDS * 1000);
-  log(`[${HOOK_NAME13}] Countdown started`, {
+  log(`[${HOOK_NAME14}] Countdown started`, {
     sessionID,
     seconds: COUNTDOWN_SECONDS,
     incompleteCount
@@ -65529,16 +65601,20 @@ async function handleSessionIdle(args) {
     skipAgents = DEFAULT_SKIP_AGENTS,
     isContinuationStopped
   } = args;
-  log(`[${HOOK_NAME13}] session.idle`, { sessionID });
+  log(`[${HOOK_NAME14}] session.idle`, { sessionID });
   const state3 = sessionStateStore.getState(sessionID);
+  if (state3.countdownTimer || state3.countdownInterval) {
+    log(`[${HOOK_NAME14}] Skipped: countdown already active`, { sessionID });
+    return;
+  }
   if (state3.isRecovering) {
-    log(`[${HOOK_NAME13}] Skipped: in recovery`, { sessionID });
+    log(`[${HOOK_NAME14}] Skipped: in recovery`, { sessionID });
     return;
   }
   if (state3.abortDetectedAt) {
     const timeSinceAbort = Date.now() - state3.abortDetectedAt;
     if (timeSinceAbort < ABORT_WINDOW_MS) {
-      log(`[${HOOK_NAME13}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
+      log(`[${HOOK_NAME14}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
       state3.abortDetectedAt = undefined;
       return;
     }
@@ -65546,7 +65622,7 @@ async function handleSessionIdle(args) {
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME13}] Skipped: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME14}] Skipped: background tasks running`, { sessionID });
     return;
   }
   try {
@@ -65556,18 +65632,18 @@ async function handleSessionIdle(args) {
     });
     const messages = normalizeSDKResponse(messagesResp, []);
     if (isLastAssistantMessageAborted(messages)) {
-      log(`[${HOOK_NAME13}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
+      log(`[${HOOK_NAME14}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
       return;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME13}] Messages fetch failed, continuing`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME14}] Messages fetch failed, continuing`, { sessionID, error: String(error51) });
   }
   let incompleteCount = 0;
   let total = 0;
   try {
     const taskDir = getTaskDir({}, ctx.directory);
     if (!existsSync44(taskDir)) {
-      log(`[${HOOK_NAME13}] No task dir`, { sessionID, taskDir });
+      log(`[${HOOK_NAME14}] No task dir`, { sessionID, taskDir });
       return;
     }
     const files = readdirSync15(taskDir).filter((f) => f.startsWith("T-") && f.endsWith(".json"));
@@ -65579,31 +65655,31 @@ async function handleSessionIdle(args) {
     }
     total = tasks.length;
     if (total === 0) {
-      log(`[${HOOK_NAME13}] No tasks`, { sessionID });
+      log(`[${HOOK_NAME14}] No tasks`, { sessionID });
       return;
     }
     incompleteCount = getIncompleteTaskCount(tasks);
   } catch (error51) {
-    log(`[${HOOK_NAME13}] Task fetch failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME14}] Task fetch failed`, { sessionID, error: String(error51) });
     return;
   }
   if (incompleteCount === 0) {
-    log(`[${HOOK_NAME13}] All tasks complete`, { sessionID, total });
+    log(`[${HOOK_NAME14}] All tasks complete`, { sessionID, total });
     return;
   }
   if (state3.inFlight) {
-    log(`[${HOOK_NAME13}] Skipped: injection in flight`, { sessionID });
+    log(`[${HOOK_NAME14}] Skipped: injection in flight`, { sessionID });
     return;
   }
   if ((state3.consecutiveFailures ?? 0) >= MAX_CONSECUTIVE_FAILURES && state3.lastInjectedAt && Date.now() - state3.lastInjectedAt >= FAILURE_RESET_WINDOW_MS) {
     state3.consecutiveFailures = 0;
-    log(`[${HOOK_NAME13}] Reset consecutive failures after recovery window`, {
+    log(`[${HOOK_NAME14}] Reset consecutive failures after recovery window`, {
       sessionID,
       failureResetWindowMs: FAILURE_RESET_WINDOW_MS
     });
   }
   if ((state3.consecutiveFailures ?? 0) >= MAX_CONSECUTIVE_FAILURES) {
-    log(`[${HOOK_NAME13}] Skipped: max consecutive failures reached`, {
+    log(`[${HOOK_NAME14}] Skipped: max consecutive failures reached`, {
       sessionID,
       consecutiveFailures: state3.consecutiveFailures ?? 0,
       maxConsecutiveFailures: MAX_CONSECUTIVE_FAILURES
@@ -65612,7 +65688,7 @@ async function handleSessionIdle(args) {
   }
   const effectiveCooldown = CONTINUATION_COOLDOWN_MS2 * 2 ** Math.min(state3.consecutiveFailures ?? 0, 5);
   if (state3.lastInjectedAt && Date.now() - state3.lastInjectedAt < effectiveCooldown) {
-    log(`[${HOOK_NAME13}] Skipped: cooldown active`, {
+    log(`[${HOOK_NAME14}] Skipped: cooldown active`, {
       sessionID,
       effectiveCooldown,
       consecutiveFailures: state3.consecutiveFailures ?? 0
@@ -65642,20 +65718,20 @@ async function handleSessionIdle(args) {
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME13}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME14}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
   }
-  log(`[${HOOK_NAME13}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
+  log(`[${HOOK_NAME14}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
   const resolvedAgentName = resolvedInfo?.agent;
   if (resolvedAgentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(resolvedAgentName))) {
-    log(`[${HOOK_NAME13}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
+    log(`[${HOOK_NAME14}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
     return;
   }
   if (hasCompactionMessage && !resolvedInfo?.agent) {
-    log(`[${HOOK_NAME13}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
+    log(`[${HOOK_NAME14}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
     return;
   }
   if (isContinuationStopped?.(sessionID)) {
-    log(`[${HOOK_NAME13}] Skipped: continuation stopped for session`, { sessionID });
+    log(`[${HOOK_NAME14}] Skipped: continuation stopped for session`, { sessionID });
     return;
   }
   startCountdown({
@@ -65685,7 +65761,7 @@ function handleNonIdleEvent(args) {
       if (state3?.countdownStartedAt) {
         const elapsed = Date.now() - state3.countdownStartedAt;
         if (elapsed < COUNTDOWN_GRACE_PERIOD_MS) {
-          log(`[${HOOK_NAME13}] Ignoring user message in grace period`, { sessionID, elapsed });
+          log(`[${HOOK_NAME14}] Ignoring user message in grace period`, { sessionID, elapsed });
           return;
         }
       }
@@ -65729,7 +65805,7 @@ function handleNonIdleEvent(args) {
     const sessionInfo = properties?.info;
     if (sessionInfo?.id) {
       sessionStateStore.cleanup(sessionInfo.id);
-      log(`[${HOOK_NAME13}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
+      log(`[${HOOK_NAME14}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
     }
     return;
   }
@@ -65754,10 +65830,10 @@ function createTaskContinuationHandler(args) {
       if (error51?.name === "MessageAbortedError" || error51?.name === "AbortError") {
         const state3 = sessionStateStore.getState(sessionID);
         state3.abortDetectedAt = Date.now();
-        log(`[${HOOK_NAME13}] Abort detected via session.error`, { sessionID, errorName: error51.name });
+        log(`[${HOOK_NAME14}] Abort detected via session.error`, { sessionID, errorName: error51.name });
       }
       sessionStateStore.cancelCountdown(sessionID);
-      log(`[${HOOK_NAME13}] session.error`, { sessionID });
+      log(`[${HOOK_NAME14}] session.error`, { sessionID });
       return;
     }
     if (event.type === "session.idle") {
@@ -65872,13 +65948,13 @@ function createTaskContinuationEnforcer(ctx, options = {}) {
     const state3 = sessionStateStore.getState(sessionID);
     state3.isRecovering = true;
     sessionStateStore.cancelCountdown(sessionID);
-    log(`[${HOOK_NAME13}] Session marked as recovering`, { sessionID });
+    log(`[${HOOK_NAME14}] Session marked as recovering`, { sessionID });
   };
   const markRecoveryComplete = (sessionID) => {
     const state3 = sessionStateStore.getExistingState(sessionID);
     if (state3) {
       state3.isRecovering = false;
-      log(`[${HOOK_NAME13}] Session recovery complete`, { sessionID });
+      log(`[${HOOK_NAME14}] Session recovery complete`, { sessionID });
     }
   };
   const handler = createTaskContinuationHandler({
@@ -65890,7 +65966,7 @@ function createTaskContinuationEnforcer(ctx, options = {}) {
   });
   const cancelAllCountdowns = () => {
     sessionStateStore.cancelAllCountdowns();
-    log(`[${HOOK_NAME13}] All countdowns cancelled`);
+    log(`[${HOOK_NAME14}] All countdowns cancelled`);
   };
   return {
     handler,
@@ -65900,7 +65976,7 @@ function createTaskContinuationEnforcer(ctx, options = {}) {
   };
 }
 // src/hooks/task-edit-guard/constants.ts
-var HOOK_NAME14 = "task-edit-guard";
+var HOOK_NAME15 = "task-edit-guard";
 var BLOCKED_PATTERNS = [
   /sed\s+.*\.matrixx\/plans/,
   /sed\s+.*\.matrixx\/tasks/,
@@ -65936,7 +66012,7 @@ function createTaskEditGuardHook(ctx) {
       if (!hit)
         return;
       ctx.directory;
-      log(`[${HOOK_NAME14}] BLOCKED raw bash edit`, {
+      log(`[${HOOK_NAME15}] BLOCKED raw bash edit`, {
         sessionID: input.sessionID,
         command: cmd.slice(0, 120)
       });
@@ -65945,7 +66021,7 @@ function createTaskEditGuardHook(ctx) {
   };
 }
 // src/hooks/task-notepad/constants.ts
-var HOOK_NAME15 = "task-notepad";
+var HOOK_NAME16 = "task-notepad";
 var PLAN_DIR_NAME = ".matrixx";
 var PLANS_SUBDIR = "plans";
 var NOTEPAD_DIR_NAME = "notepads";
@@ -65974,7 +66050,7 @@ function createTaskNotepadHook(ctx) {
       const plan = resolveActivePlan(ctx.directory);
       if (inProgress) {
         if (!plan) {
-          log(`[${HOOK_NAME15}] No active plan, skipping notepad creation`, {
+          log(`[${HOOK_NAME16}] No active plan, skipping notepad creation`, {
             sessionID: input.sessionID
           });
         } else {
@@ -66001,7 +66077,7 @@ async function fetchTodos(ctx, sessionID) {
     }
     return [];
   } catch (err) {
-    log(`[${HOOK_NAME15}] ${TODO_FETCH_ERROR_FRAGMENT}`, {
+    log(`[${HOOK_NAME16}] ${TODO_FETCH_ERROR_FRAGMENT}`, {
       sessionID,
       error: String(err)
     });
@@ -66046,7 +66122,7 @@ function ensureNotepad(directory, planName, todo) {
   mkdirSync16(dirname15(notepadPath), { recursive: true });
   const content = renderNotepad(todo);
   writeFileSync19(notepadPath, content, "utf-8");
-  log(`[${HOOK_NAME15}] Created task notepad`, { plan: planName, taskID: todo.id });
+  log(`[${HOOK_NAME16}] Created task notepad`, { plan: planName, taskID: todo.id });
 }
 function appendCompletion(directory, planName, todo) {
   const notepadPath = notepadPathFor(directory, planName, todo.id);
@@ -66062,7 +66138,7 @@ function appendCompletion(directory, planName, todo) {
 - status: completed
 `;
   writeFileSync19(notepadPath, updated, "utf-8");
-  log(`[${HOOK_NAME15}] Appended completion to notepad`, { plan: planName, taskID: todo.id });
+  log(`[${HOOK_NAME16}] Appended completion to notepad`, { plan: planName, taskID: todo.id });
 }
 function notepadPathFor(directory, planName, taskID) {
   return join52(directory, PLAN_DIR_NAME, NOTEPAD_DIR_NAME, planName, TASKS_SUBDIR, `${taskID}${NOTEPAD_EXTENSION}`);
@@ -66655,7 +66731,7 @@ function createThinkingBlockValidatorHook() {
 init_logger();
 
 // src/hooks/todo-continuation-enforcer/constants.ts
-var HOOK_NAME16 = "todo-continuation-enforcer";
+var HOOK_NAME17 = "todo-continuation-enforcer";
 var DEFAULT_SKIP_AGENTS2 = ["oracle", "compaction"];
 var CONTINUATION_PROMPT3 = `${createSystemDirective(SystemDirectiveTypes.TODO_CONTINUATION)}
 
@@ -66721,12 +66797,12 @@ async function injectContinuation2(args) {
   } = args;
   const state3 = sessionStateStore.getExistingState(sessionID);
   if (state3?.isRecovering) {
-    log(`[${HOOK_NAME16}] Skipped injection: in recovery`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped injection: in recovery`, { sessionID });
     return;
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME16}] Skipped injection: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped injection: background tasks running`, { sessionID });
     return;
   }
   let todos = [];
@@ -66734,12 +66810,12 @@ async function injectContinuation2(args) {
     const response = await ctx.client.session.todo({ path: { id: sessionID } });
     todos = normalizeSDKResponse(response, [], { preferResponseOnMissingData: true });
   } catch (error51) {
-    log(`[${HOOK_NAME16}] Failed to fetch todos`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME17}] Failed to fetch todos`, { sessionID, error: String(error51) });
     return;
   }
   const freshIncompleteCount = getIncompleteCount(todos);
   if (freshIncompleteCount === 0) {
-    log(`[${HOOK_NAME16}] Skipped injection: no incomplete todos`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped injection: no incomplete todos`, { sessionID });
     return;
   }
   let agentName = resolvedInfo?.agent;
@@ -66762,11 +66838,11 @@ async function injectContinuation2(args) {
     tools = tools ?? previousMessage?.tools;
   }
   if (agentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(agentName))) {
-    log(`[${HOOK_NAME16}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME17}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
     return;
   }
   if (!hasWritePermission2(tools)) {
-    log(`[${HOOK_NAME16}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME17}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
     return;
   }
   const incompleteTodos = todos.filter((todo) => todo.status !== "completed" && todo.status !== "cancelled");
@@ -66783,7 +66859,7 @@ ${todoList}`;
     injectionState.inFlight = true;
   }
   try {
-    log(`[${HOOK_NAME16}] Injecting continuation`, {
+    log(`[${HOOK_NAME17}] Injecting continuation`, {
       sessionID,
       agent: agentName,
       model,
@@ -66798,14 +66874,14 @@ ${todoList}`;
       },
       query: { directory: ctx.directory }
     });
-    log(`[${HOOK_NAME16}] Injection successful`, { sessionID });
+    log(`[${HOOK_NAME17}] Injection successful`, { sessionID });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
       injectionState.consecutiveFailures = 0;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME16}] Injection failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME17}] Injection failed`, { sessionID, error: String(error51) });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
@@ -66838,7 +66914,10 @@ function startCountdown2(args) {
     sessionStateStore
   } = args;
   const state3 = sessionStateStore.getState(sessionID);
-  sessionStateStore.cancelCountdown(sessionID);
+  if (state3.countdownTimer || state3.countdownInterval) {
+    log(`[${HOOK_NAME17}] Skipped: countdown already active`, { sessionID });
+    return;
+  }
   let secondsRemaining = COUNTDOWN_SECONDS2;
   showCountdownToast2(ctx, secondsRemaining, incompleteCount);
   state3.countdownStartedAt = Date.now();
@@ -66859,7 +66938,7 @@ function startCountdown2(args) {
       sessionStateStore
     });
   }, COUNTDOWN_SECONDS2 * 1000);
-  log(`[${HOOK_NAME16}] Countdown started`, {
+  log(`[${HOOK_NAME17}] Countdown started`, {
     sessionID,
     seconds: COUNTDOWN_SECONDS2,
     incompleteCount
@@ -66876,16 +66955,20 @@ async function handleSessionIdle2(args) {
     skipAgents = DEFAULT_SKIP_AGENTS2,
     isContinuationStopped
   } = args;
-  log(`[${HOOK_NAME16}] session.idle`, { sessionID });
+  log(`[${HOOK_NAME17}] session.idle`, { sessionID });
   const state3 = sessionStateStore.getState(sessionID);
+  if (state3.countdownTimer || state3.countdownInterval) {
+    log(`[${HOOK_NAME17}] Skipped: countdown already active`, { sessionID });
+    return;
+  }
   if (state3.isRecovering) {
-    log(`[${HOOK_NAME16}] Skipped: in recovery`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped: in recovery`, { sessionID });
     return;
   }
   if (state3.abortDetectedAt) {
     const timeSinceAbort = Date.now() - state3.abortDetectedAt;
     if (timeSinceAbort < ABORT_WINDOW_MS2) {
-      log(`[${HOOK_NAME16}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
+      log(`[${HOOK_NAME17}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
       state3.abortDetectedAt = undefined;
       return;
     }
@@ -66893,7 +66976,7 @@ async function handleSessionIdle2(args) {
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME16}] Skipped: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped: background tasks running`, { sessionID });
     return;
   }
   try {
@@ -66903,42 +66986,42 @@ async function handleSessionIdle2(args) {
     });
     const messages = normalizeSDKResponse(messagesResp, []);
     if (isLastAssistantMessageAborted2(messages)) {
-      log(`[${HOOK_NAME16}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
+      log(`[${HOOK_NAME17}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
       return;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME16}] Messages fetch failed, continuing`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME17}] Messages fetch failed, continuing`, { sessionID, error: String(error51) });
   }
   let todos = [];
   try {
     const response = await ctx.client.session.todo({ path: { id: sessionID } });
     todos = normalizeSDKResponse(response, [], { preferResponseOnMissingData: true });
   } catch (error51) {
-    log(`[${HOOK_NAME16}] Todo fetch failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME17}] Todo fetch failed`, { sessionID, error: String(error51) });
     return;
   }
   if (!todos || todos.length === 0) {
-    log(`[${HOOK_NAME16}] No todos`, { sessionID });
+    log(`[${HOOK_NAME17}] No todos`, { sessionID });
     return;
   }
   const incompleteCount = getIncompleteCount(todos);
   if (incompleteCount === 0) {
-    log(`[${HOOK_NAME16}] All todos complete`, { sessionID, total: todos.length });
+    log(`[${HOOK_NAME17}] All todos complete`, { sessionID, total: todos.length });
     return;
   }
   if (state3.inFlight) {
-    log(`[${HOOK_NAME16}] Skipped: injection in flight`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped: injection in flight`, { sessionID });
     return;
   }
   if (state3.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES2 && state3.lastInjectedAt && Date.now() - state3.lastInjectedAt >= FAILURE_RESET_WINDOW_MS2) {
     state3.consecutiveFailures = 0;
-    log(`[${HOOK_NAME16}] Reset consecutive failures after recovery window`, {
+    log(`[${HOOK_NAME17}] Reset consecutive failures after recovery window`, {
       sessionID,
       failureResetWindowMs: FAILURE_RESET_WINDOW_MS2
     });
   }
   if (state3.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES2) {
-    log(`[${HOOK_NAME16}] Skipped: max consecutive failures reached`, {
+    log(`[${HOOK_NAME17}] Skipped: max consecutive failures reached`, {
       sessionID,
       consecutiveFailures: state3.consecutiveFailures,
       maxConsecutiveFailures: MAX_CONSECUTIVE_FAILURES2
@@ -66947,7 +67030,7 @@ async function handleSessionIdle2(args) {
   }
   const effectiveCooldown = CONTINUATION_COOLDOWN_MS3 * 2 ** Math.min(state3.consecutiveFailures, 5);
   if (state3.lastInjectedAt && Date.now() - state3.lastInjectedAt < effectiveCooldown) {
-    log(`[${HOOK_NAME16}] Skipped: cooldown active`, {
+    log(`[${HOOK_NAME17}] Skipped: cooldown active`, {
       sessionID,
       effectiveCooldown,
       consecutiveFailures: state3.consecutiveFailures
@@ -66977,20 +67060,20 @@ async function handleSessionIdle2(args) {
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME16}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME17}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
   }
-  log(`[${HOOK_NAME16}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
+  log(`[${HOOK_NAME17}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
   const resolvedAgentName = resolvedInfo?.agent;
   if (resolvedAgentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(resolvedAgentName))) {
-    log(`[${HOOK_NAME16}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
+    log(`[${HOOK_NAME17}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
     return;
   }
   if (hasCompactionMessage && !resolvedInfo?.agent) {
-    log(`[${HOOK_NAME16}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
     return;
   }
   if (isContinuationStopped?.(sessionID)) {
-    log(`[${HOOK_NAME16}] Skipped: continuation stopped for session`, { sessionID });
+    log(`[${HOOK_NAME17}] Skipped: continuation stopped for session`, { sessionID });
     return;
   }
   startCountdown2({
@@ -67020,7 +67103,7 @@ function handleNonIdleEvent2(args) {
       if (state3?.countdownStartedAt) {
         const elapsed = Date.now() - state3.countdownStartedAt;
         if (elapsed < COUNTDOWN_GRACE_PERIOD_MS2) {
-          log(`[${HOOK_NAME16}] Ignoring user message in grace period`, { sessionID, elapsed });
+          log(`[${HOOK_NAME17}] Ignoring user message in grace period`, { sessionID, elapsed });
           return;
         }
       }
@@ -67064,7 +67147,7 @@ function handleNonIdleEvent2(args) {
     const sessionInfo = properties?.info;
     if (sessionInfo?.id) {
       sessionStateStore.cleanup(sessionInfo.id);
-      log(`[${HOOK_NAME16}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
+      log(`[${HOOK_NAME17}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
     }
     return;
   }
@@ -67089,10 +67172,10 @@ function createTodoContinuationHandler(args) {
       if (error51?.name === "MessageAbortedError" || error51?.name === "AbortError") {
         const state3 = sessionStateStore.getState(sessionID);
         state3.abortDetectedAt = Date.now();
-        log(`[${HOOK_NAME16}] Abort detected via session.error`, { sessionID, errorName: error51.name });
+        log(`[${HOOK_NAME17}] Abort detected via session.error`, { sessionID, errorName: error51.name });
       }
       sessionStateStore.cancelCountdown(sessionID);
-      log(`[${HOOK_NAME16}] session.error`, { sessionID });
+      log(`[${HOOK_NAME17}] session.error`, { sessionID });
       return;
     }
     if (event.type === "session.idle") {
@@ -67207,13 +67290,13 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
     const state3 = sessionStateStore.getState(sessionID);
     state3.isRecovering = true;
     sessionStateStore.cancelCountdown(sessionID);
-    log(`[${HOOK_NAME16}] Session marked as recovering`, { sessionID });
+    log(`[${HOOK_NAME17}] Session marked as recovering`, { sessionID });
   };
   const markRecoveryComplete = (sessionID) => {
     const state3 = sessionStateStore.getExistingState(sessionID);
     if (state3) {
       state3.isRecovering = false;
-      log(`[${HOOK_NAME16}] Session recovery complete`, { sessionID });
+      log(`[${HOOK_NAME17}] Session recovery complete`, { sessionID });
     }
   };
   const handler = createTodoContinuationHandler({
@@ -67225,7 +67308,7 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
   });
   const cancelAllCountdowns = () => {
     sessionStateStore.cancelAllCountdowns();
-    log(`[${HOOK_NAME16}] All countdowns cancelled`);
+    log(`[${HOOK_NAME17}] All countdowns cancelled`);
   };
   return {
     handler,
@@ -67449,7 +67532,7 @@ This is a reminder only. No automatic action was taken.`;
 }
 // src/hooks/unstable-agent-babysitter/unstable-agent-babysitter-hook.ts
 init_logger();
-var HOOK_NAME17 = "unstable-agent-babysitter";
+var HOOK_NAME18 = "unstable-agent-babysitter";
 var DEFAULT_TIMEOUT_MS = 120000;
 var COOLDOWN_MS = 5 * 60 * 1000;
 async function resolveMainSessionTarget(ctx, sessionID) {
@@ -67469,7 +67552,7 @@ async function resolveMainSessionTarget(ctx, sessionID) {
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME17}] Failed to resolve main session agent`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME18}] Failed to resolve main session agent`, { sessionID, error: String(error51) });
   }
   return { agent, model };
 }
@@ -67502,7 +67585,7 @@ async function getThinkingSummary(ctx, sessionID) {
       return combined;
     return `${combined.slice(0, THINKING_SUMMARY_MAX_CHARS)}...`;
   } catch (error51) {
-    log(`[${HOOK_NAME17}] Failed to fetch thinking summary`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME18}] Failed to fetch thinking summary`, { sessionID, error: String(error51) });
     return null;
   }
 }
@@ -67551,9 +67634,9 @@ function createUnstableAgentBabysitterHook(ctx, options) {
           query: { directory: ctx.directory }
         });
         reminderCooldowns.set(task.id, now);
-        log(`[${HOOK_NAME17}] Reminder injected`, { taskId: task.id, sessionID: mainSessionID });
+        log(`[${HOOK_NAME18}] Reminder injected`, { taskId: task.id, sessionID: mainSessionID });
       } catch (error51) {
-        log(`[${HOOK_NAME17}] Reminder injection failed`, { taskId: task.id, error: String(error51) });
+        log(`[${HOOK_NAME18}] Reminder injection failed`, { taskId: task.id, error: String(error51) });
       }
     }
   };
@@ -92343,6 +92426,7 @@ function createToolGuardHooks(args) {
   const envFileWriteGuard = isHookEnabled("env-file-write-guard") ? safeHook("env-file-write-guard", () => createEnvFileWriteGuardHook(pluginConfig.security?.env_file_guard)) : null;
   const jsonErrorRecovery = isHookEnabled("json-error-recovery") ? safeHook("json-error-recovery", () => createJsonErrorRecoveryHook(ctx)) : null;
   const bashFileReadGuard = isHookEnabled("bash-file-read-guard") ? safeHook("bash-file-read-guard", () => createBashFileReadGuardHook()) : null;
+  const contextModeEnforcer = isHookEnabled("context-mode-enforcer") ? safeHook("context-mode-enforcer", () => createContextModeEnforcerHook(pluginConfig)) : null;
   const readImageResizer = isHookEnabled("read-image-resizer") ? safeHook("read-image-resizer", () => createReadImageResizerHook(ctx)) : null;
   const webfetchRedirectGuard = isHookEnabled("webfetch-redirect-guard") ? safeHook("webfetch-redirect-guard", () => createWebFetchRedirectGuardHook(ctx)) : null;
   const hashlineEditDiffEnhancer = isHookEnabled("hashline-edit-diff-enhancer") ? safeHook("hashline-edit-diff-enhancer", () => createHashlineEditDiffEnhancerHook({ hashline_edit: { enabled: pluginConfig.experimental?.hashline_edit ?? false } })) : null;
@@ -92364,6 +92448,7 @@ function createToolGuardHooks(args) {
     envFileWriteGuard,
     jsonErrorRecovery,
     bashFileReadGuard,
+    contextModeEnforcer,
     readImageResizer,
     webfetchRedirectGuard,
     hashlineEditDiffEnhancer,
@@ -95397,14 +95482,14 @@ function buildCompactContextDisciplineSection(hasContextMode = false) {
 | Docs / Web | ctx_fetch_and_index -> ctx_search |
 | Compression | compress when ctx_stats > 40% or 10+ tool calls |
 
-Edits need prior read for LINE#ID \u2014 read\u2192edit chain exempt. When in doubt, use ctx_*.`;
+Edits need prior read for LINE#ID \u2014 read\u2192edit chain exempt. MUST use ctx_* when available \u2014 raw grep/read is forbidden for analysis.`;
 }
 function buildExploreDisciplineSection(hasContextMode = false, hasHeadroom = false) {
   if (!hasContextMode && !hasHeadroom)
     return "";
   const parts = [];
   if (hasContextMode) {
-    parts.push("Prefer ctx_search for indexed hits \u2192 grep/glob fallback for raw FS; use ctx_batch_execute / ctx_execute for multi-file analysis; use ctx_fetch_and_index for docs/web \u2192 ctx_search.");
+    parts.push("MUST use ctx_search for indexed hits \u2192 grep/glob fallback ONLY when ctx_* unavailable; use ctx_batch_execute / ctx_execute for multi-file analysis; use ctx_fetch_and_index for docs/web \u2192 ctx_search. Raw grep/read/glob for analysis is forbidden when ctx_* is available.");
   }
   if (hasHeadroom) {
     parts.push("Use headroom_retrieve / headroom_search for compressed history \u2014 NEVER re-read full history.");
@@ -102738,6 +102823,12 @@ var BuiltinCommandNameSchema = exports_external.enum([
 var CommentCheckerConfigSchema = exports_external.object({
   custom_prompt: exports_external.string().optional()
 });
+// src/config/schema/context-mode.ts
+var ContextModeConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().default(true),
+  enforce: exports_external.boolean().default(false),
+  blocked_tools: exports_external.array(exports_external.string()).default(["read", "grep", "glob"])
+});
 // src/config/schema/evolution.ts
 var EvolutionWatcherConfigSchema = exports_external.object({
   maxArgChars: exports_external.number().int().min(1).default(4000),
@@ -102887,6 +102978,8 @@ var HookNameSchema = exports_external.enum([
   "evolution-compressor",
   "evolution-quality-gate",
   "evolution-hitl",
+  "context-mode-enforcer",
+  "task-edit-guard",
   "task-edit-guard"
 ]);
 // src/config/schema/matrix-loop.ts
@@ -103076,6 +103169,7 @@ var MatrixxConfigSchema = exports_external.object({
   agent_definitions: AgentDefinitionsConfigSchema.optional(),
   matrixx_self_config: MatrixxSelfConfigSkillConfigSchema.optional(),
   headroom: HeadroomConfigSchema.optional(),
+  context_mode: ContextModeConfigSchema.optional(),
   rtk: RtkConfigSchema.optional(),
   evolution: EvolutionConfigSchema.optional(),
   _migrations: exports_external.array(exports_external.string()).optional()
@@ -103638,22 +103732,22 @@ function createToolExecuteAfterHandler2(args) {
 
 // src/features/assembly-state/manager.ts
 init_logger();
-var HOOK_NAME18 = "assembly-state";
+var HOOK_NAME19 = "assembly-state";
 var disabledSessions = new Set;
 function isAssemblyDisabled(sessionID) {
   return disabledSessions.has(sessionID);
 }
 function disableAssembly(sessionID) {
   disabledSessions.add(sessionID);
-  log(`[${HOOK_NAME18}] Assembly disabled for session`, { sessionID });
+  log(`[${HOOK_NAME19}] Assembly disabled for session`, { sessionID });
   disabledSessions.add(sessionID);
-  log(`[${HOOK_NAME18}] Consensus disabled for session`, { sessionID });
+  log(`[${HOOK_NAME19}] Consensus disabled for session`, { sessionID });
 }
 function enableAssembly(sessionID) {
   disabledSessions.delete(sessionID);
-  log(`[${HOOK_NAME18}] Assembly enabled for session`, { sessionID });
+  log(`[${HOOK_NAME19}] Assembly enabled for session`, { sessionID });
   disabledSessions.delete(sessionID);
-  log(`[${HOOK_NAME18}] Consensus enabled for session`, { sessionID });
+  log(`[${HOOK_NAME19}] Consensus enabled for session`, { sessionID });
 }
 // src/plugin/session-agent-resolver.ts
 async function resolveSessionAgent(client2, sessionId, timeoutMs = 5000) {
@@ -103696,6 +103790,7 @@ function createToolExecuteBeforeHandler2(args) {
   const writeExistingFileGuardHook = hooks2.writeExistingFileGuard?.["tool.execute.before"];
   const tasksTodowriteDisablerHook = hooks2.tasksTodowriteDisabler?.["tool.execute.before"];
   const oracleMdOnlyHook = hooks2.oracleMdOnly?.["tool.execute.before"];
+  const contextModeEnforcerHook = hooks2.contextModeEnforcer?.["tool.execute.before"];
   const nonInteractiveEnvHook = hooks2.nonInteractiveEnv?.["tool.execute.before"];
   const bashFileReadGuardHook = hooks2.bashFileReadGuard?.["tool.execute.before"];
   const questionLabelTruncatorHook = hooks2.questionLabelTruncator?.["tool.execute.before"];
@@ -103715,7 +103810,8 @@ function createToolExecuteBeforeHandler2(args) {
       envFileWriteGuardHook?.(input, output),
       writeExistingFileGuardHook?.(input, output),
       tasksTodowriteDisablerHook?.(input, output),
-      oracleMdOnlyHook?.(input, output)
+      oracleMdOnlyHook?.(input, output),
+      contextModeEnforcerHook?.(input, output)
     ]);
     let resolvePromise;
     if (input.tool === "task") {