opencode-matrixx 2.6.9 → 2.6.10

package/dist/index.js

@@ -4540,7 +4540,7 @@ var require_picomatch2 = __commonJS(function(exports, module) {
 });
 
 // src/hooks/matrix-loop/constants.ts
-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;
+var HOOK_NAME7 = "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 = {};
@@ -29559,7 +29559,7 @@ var init_ulw_research = __esm(() => {
       "glob",
       "look_at",
       "websearch_web_search_exa",
-      "white_rabbit_searchGitHub",
+      "github_search",
       "context7_resolve-library-id",
       "context7_query-docs"
     ],
@@ -29670,7 +29670,7 @@ task(
   prompt="""
 Search open source repositories for implementations related to: <CURRENT_LEAD>
 
-Use white_rabbit_searchGitHub to find real-world code patterns.
+Use github_search to find real-world code patterns.
 Focus on:
 - Production implementations in similar projects
 - Reference implementations or canonical examples
@@ -48167,7 +48167,7 @@ var TARGET_TOOLS = new Set([
   "context7_query-docs",
   "websearch_web_search_exa",
   "context7_get-library-docs",
-  "white_rabbit_searchgithub"
+  "github_search"
 ]);
 var AGENT_TOOLS = new Set([
   "task"
@@ -55863,6 +55863,80 @@ function createPostReadInjectorHook(ctx, options) {
 function createDirectoryAgentsInjectorHook(ctx) {
   return createPostReadInjectorHook(ctx, { trackedTools: ["read"] });
 }
+// src/hooks/document-reader-guard/constants.ts
+var HOOK_NAME5 = "document-reader-guard";
+var BINARY_EXTENSIONS = [
+  ".pdf",
+  ".docx",
+  ".doc",
+  ".xlsx",
+  ".xls",
+  ".pptx",
+  ".ppt",
+  ".jpg",
+  ".jpeg",
+  ".png",
+  ".gif",
+  ".webp",
+  ".mp3",
+  ".wav"
+];
+var BLOCKED_PATTERNS = [
+  /\bpdftotext\b/,
+  /\bpdfinfo\b/,
+  /\bpandoc\b.*\.(pdf|docx?|xlsx?|pptx?)/,
+  /\blibreoffice\b|\bsoffice\b/,
+  /\bcat\s+[^|&;]*\.(pdf|docx?|xlsx?|pptx?|jpe?g|png|gif|webp|mp3|wav)/,
+  /\bhead\s+[^|&;]*\.(pdf|docx?|xlsx?|pptx?|jpe?g|png|gif|webp|mp3|wav)/,
+  /\btail\s+[^|&;]*\.(pdf|docx?|xlsx?|pptx?|jpe?g|png|gif|webp|mp3|wav)/,
+  /\bless\s+[^|&;]*\.(pdf|docx?|xlsx?|pptx?|jpe?g|png|gif|webp|mp3|wav)/,
+  /\bpython3?\b.*(fitz|pymupdf|pdfminer|pdfplumber|python-pptx|\bdocx\b|openpyxl|pillow|\bPIL\b)/,
+  /\bpython3?\b[^|&;]*\.(pdf|docx?|xlsx?|pptx?|jpe?g|png|gif|webp|mp3|wav)/,
+  /\bmarkitdown\b/
+];
+var READ_BLOCK_MESSAGE = "[document-reader-guard] BLOCKED: Use document_reader__convert_to_markdown (document_reader MCP, Microsoft MarkItDown) for binary documents \u2014 generic Read cannot parse them. " + "Call convert_to_markdown with an absolute URI like file:///absolute/path/to/report.pdf, then summarize \u2014 do not dump raw output. " + "For context isolation delegate to the construct subagent so the main context stays clean.";
+var BASH_BLOCK_MESSAGE = "[document-reader-guard] BLOCKED: Do not read documents via bash CLIs (pdftotext, pdfinfo, pandoc, libreoffice, cat/head/tail, python fitz/pypdf/pdfminer/pdfplumber/docx/openpyxl, markitdown CLI). " + "Use document_reader__convert_to_markdown with file:///absolute/path instead \u2014 delegate to construct for summarization.";
+// src/hooks/document-reader-guard/hook.ts
+function getFilePath(args) {
+  const raw = args?.filePath ?? args?.path ?? args?.file;
+  return typeof raw === "string" ? raw : undefined;
+}
+function isBinaryDocument(filePath) {
+  const normalized = filePath.toLowerCase().replace(/\\/g, "/").split("?")[0].split("#")[0];
+  return BINARY_EXTENSIONS.some((ext) => normalized.endsWith(ext));
+}
+function createDocumentReaderGuardHook(ctx) {
+  return {
+    "tool.execute.before": async (input, output) => {
+      const tool = input.tool?.toLowerCase();
+      if (tool !== "read" && tool !== "bash")
+        return;
+      if (tool === "read") {
+        const filePath = getFilePath(output.args);
+        if (!filePath || !isBinaryDocument(filePath))
+          return;
+        log(`[${HOOK_NAME5}] BLOCKED generic Read on binary document \u2014 use document_reader MCP`, {
+          sessionID: input.sessionID,
+          tool: input.tool,
+          filePath
+        });
+        throw new Error(READ_BLOCK_MESSAGE);
+      }
+      const args = output.args;
+      const cmd = args?.command;
+      if (!cmd)
+        return;
+      if (!BLOCKED_PATTERNS.some((rx) => rx.test(cmd)))
+        return;
+      ctx.directory;
+      log(`[${HOOK_NAME5}] BLOCKED bash document read`, {
+        sessionID: input.sessionID,
+        command: cmd.slice(0, 120)
+      });
+      throw new Error(BASH_BLOCK_MESSAGE);
+    }
+  };
+}
 // src/hooks/edit-error-recovery/hook.ts
 var EDIT_ERROR_PATTERNS = [
   "oldString and newString must be different",
@@ -59571,7 +59645,7 @@ var JSON_ERROR_TOOL_EXCLUDE_LIST = [
   "grep",
   "webfetch",
   "look_at",
-  "white_rabbit_searchgithub",
+  "github_search",
   "websearch_web_search_exa"
 ];
 var JSON_ERROR_PATTERNS = [
@@ -59616,18 +59690,18 @@ ${JSON_ERROR_REMINDER}`;
 }
 // src/features/ultrawork-state/manager.ts
 init_logger();
-var HOOK_NAME5 = "ultrawork-state";
+var HOOK_NAME6 = "ultrawork-state";
 var sessionStates = new Map;
 function getUltraworkState(sessionID) {
   return sessionStates.get(sessionID);
 }
 function enableUltrawork(sessionID) {
   sessionStates.set(sessionID, "enabled");
-  log(`[${HOOK_NAME5}] Ultrawork enabled for session`, { sessionID });
+  log(`[${HOOK_NAME6}] Ultrawork enabled for session`, { sessionID });
 }
 function disableUltrawork(sessionID) {
   sessionStates.set(sessionID, "disabled");
-  log(`[${HOOK_NAME5}] Ultrawork disabled for session`, { sessionID });
+  log(`[${HOOK_NAME6}] Ultrawork disabled for session`, { sessionID });
 }
 // src/hooks/keyword-detector/hook.ts
 function createKeywordDetectorHook(ctx, _collector) {
@@ -59760,7 +59834,7 @@ function createLoopStateController(options) {
       };
       const success2 = writeState(directory, state3, stateDir);
       if (success2) {
-        log(`[${HOOK_NAME6}] Loop started`, {
+        log(`[${HOOK_NAME7}] Loop started`, {
           sessionID,
           maxIterations: state3.max_iterations,
           completionPromise: state3.completion_promise
@@ -59775,7 +59849,7 @@ function createLoopStateController(options) {
       }
       const success2 = clearState(directory, stateDir);
       if (success2) {
-        log(`[${HOOK_NAME6}] Loop cancelled`, { sessionID, iteration: state3.iteration });
+        log(`[${HOOK_NAME7}] Loop cancelled`, { sessionID, iteration: state3.iteration });
       }
       return success2;
     },
@@ -59852,7 +59926,7 @@ async function detectCompletionInSessionMessages(ctx, options) {
     return false;
   } catch (err) {
     setTimeout(() => {
-      log(`[${HOOK_NAME6}] Session messages check failed`, {
+      log(`[${HOOK_NAME7}] Session messages check failed`, {
         sessionID: options.sessionID,
         error: String(err)
       });
@@ -59933,7 +60007,7 @@ async function verifyCompletion(ctx, options) {
       query: { directory: options.directory }
     });
     if (createResult.error || !createResult.data?.id) {
-      log(`[${HOOK_NAME6}] Verification session creation failed`);
+      log(`[${HOOK_NAME7}] Verification session creation failed`);
       return { verified: true };
     }
     verifySessionID = createResult.data.id;
@@ -59963,16 +60037,16 @@ async function verifyCompletion(ctx, options) {
           return parseVerificationResponse(assistantText);
         }
       } catch {
-        log(`[${HOOK_NAME6}] Verification poll error`);
+        log(`[${HOOK_NAME7}] Verification poll error`);
       }
       await new Promise((resolve4) => {
         setTimeout(resolve4, pollIntervalMs);
       });
     }
-    log(`[${HOOK_NAME6}] Verification timed out, assuming pass`);
+    log(`[${HOOK_NAME7}] Verification timed out, assuming pass`);
     return { verified: true };
   } catch (err) {
-    log(`[${HOOK_NAME6}] Verification error: ${String(err)}`);
+    log(`[${HOOK_NAME7}] Verification error: ${String(err)}`);
     return { verified: true };
   } finally {
     if (verifySessionID) {
@@ -60048,7 +60122,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_NAME6}] Verification failed`, { sessionID, reason });
+  log(`[${HOOK_NAME7}] Verification failed`, { sessionID, reason });
   const newState = options.loopState.incrementIteration();
   if (newState) {
     newState.verification_failed_count = failedCount + 1;
@@ -60066,7 +60140,7 @@ ${buildContinuationPrompt(newState ?? state3)}`,
       apiTimeoutMs: options.apiTimeoutMs
     });
   } catch (err) {
-    log(`[${HOOK_NAME6}] Failed to inject verification feedback`, { sessionID, error: String(err) });
+    log(`[${HOOK_NAME7}] Failed to inject verification feedback`, { sessionID, error: String(err) });
   }
 }
 function createMatrixLoopEventHandler(ctx, options) {
@@ -60078,13 +60152,13 @@ function createMatrixLoopEventHandler(ctx, options) {
       if (!sessionID)
         return;
       if (inFlightSessions.has(sessionID)) {
-        log(`[${HOOK_NAME6}] Skipped: handler in flight`, { sessionID });
+        log(`[${HOOK_NAME7}] Skipped: handler in flight`, { sessionID });
         return;
       }
       inFlightSessions.add(sessionID);
       try {
         if (options.sessionRecovery.isRecovering(sessionID)) {
-          log(`[${HOOK_NAME6}] Skipped: in recovery`, { sessionID });
+          log(`[${HOOK_NAME7}] Skipped: in recovery`, { sessionID });
           return;
         }
         const state3 = options.loopState.getState();
@@ -60096,11 +60170,11 @@ function createMatrixLoopEventHandler(ctx, options) {
               const exists = await options.checkSessionExists(state3.session_id);
               if (!exists) {
                 options.loopState.clear();
-                log(`[${HOOK_NAME6}] Cleared orphaned state from deleted session`, { orphanedSessionId: state3.session_id, currentSessionId: sessionID });
+                log(`[${HOOK_NAME7}] Cleared orphaned state from deleted session`, { orphanedSessionId: state3.session_id, currentSessionId: sessionID });
                 return;
               }
             } catch (err) {
-              log(`[${HOOK_NAME6}] Failed to check session existence`, { sessionId: state3.session_id, error: String(err) });
+              log(`[${HOOK_NAME7}] Failed to check session existence`, { sessionId: state3.session_id, error: String(err) });
             }
           }
           return;
@@ -60119,7 +60193,7 @@ function createMatrixLoopEventHandler(ctx, options) {
             messages = Array.isArray(messagesResponse) ? messagesResponse : Array.isArray(responseData) ? responseData : [];
           } catch (err) {
             setTimeout(() => {
-              log(`[${HOOK_NAME6}] Session messages fetch failed`, { sessionID, error: String(err) });
+              log(`[${HOOK_NAME7}] Session messages fetch failed`, { sessionID, error: String(err) });
             }, 0);
             messages = [];
           }
@@ -60132,7 +60206,7 @@ function createMatrixLoopEventHandler(ctx, options) {
           preFetchedMessages: messages
         });
         if (completionViaTranscript || completionViaApi) {
-          log(`[${HOOK_NAME6}] Completion detected!`, { sessionID, iteration: state3.iteration, promise: state3.completion_promise, detectedVia: completionViaTranscript ? "transcript_file" : "session_messages_api" });
+          log(`[${HOOK_NAME7}] 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;
@@ -60167,7 +60241,7 @@ function createMatrixLoopEventHandler(ctx, options) {
           return;
         }
         if (state3.iteration >= state3.max_iterations) {
-          log(`[${HOOK_NAME6}] Max iterations reached`, { sessionID, iteration: state3.iteration, max: state3.max_iterations });
+          log(`[${HOOK_NAME7}] 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);
@@ -60176,17 +60250,17 @@ function createMatrixLoopEventHandler(ctx, options) {
         }
         const newState = options.loopState.incrementIteration();
         if (!newState) {
-          log(`[${HOOK_NAME6}] Failed to increment iteration`, { sessionID });
+          log(`[${HOOK_NAME7}] Failed to increment iteration`, { sessionID });
           return;
         }
-        log(`[${HOOK_NAME6}] Continuing loop`, { sessionID, iteration: newState.iteration, max: newState.max_iterations });
+        log(`[${HOOK_NAME7}] 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_NAME6}] Failed to inject continuation`, { sessionID, error: String(err) });
+          log(`[${HOOK_NAME7}] Failed to inject continuation`, { sessionID, error: String(err) });
         }
         return;
       } finally {
@@ -60200,7 +60274,7 @@ function createMatrixLoopEventHandler(ctx, options) {
       const state3 = options.loopState.getState();
       if (state3?.session_id === sessionInfo.id) {
         options.loopState.clear();
-        log(`[${HOOK_NAME6}] Session deleted, loop cleared`, { sessionID: sessionInfo.id });
+        log(`[${HOOK_NAME7}] Session deleted, loop cleared`, { sessionID: sessionInfo.id });
       }
       options.sessionRecovery.clear(sessionInfo.id);
       return;
@@ -60213,7 +60287,7 @@ function createMatrixLoopEventHandler(ctx, options) {
           const state3 = options.loopState.getState();
           if (state3?.session_id === sessionID) {
             options.loopState.clear();
-            log(`[${HOOK_NAME6}] User aborted, loop cleared`, { sessionID });
+            log(`[${HOOK_NAME7}] User aborted, loop cleared`, { sessionID });
           }
           options.sessionRecovery.clear(sessionID);
         }
@@ -60260,7 +60334,7 @@ function createMatrixLoopHook(ctx, options) {
 // src/hooks/matrix-loop/index.ts
 init_storage();
 // src/hooks/mouse-notepad/constants.ts
-var HOOK_NAME7 = "mouse-notepad";
+var HOOK_NAME8 = "mouse-notepad";
 var NOTEPAD_DIRECTIVE = `
 <Work_Context>
 ## Notepad Location (for recording learnings)
@@ -60307,14 +60381,14 @@ function createMouseNotepadHook(ctx) {
         return;
       }
       output.args.prompt = NOTEPAD_DIRECTIVE + prompt;
-      log(`[${HOOK_NAME7}] Injected notepad directive to task`, {
+      log(`[${HOOK_NAME8}] Injected notepad directive to task`, {
         sessionID: input.sessionID
       });
     }
   };
 }
 // src/hooks/non-interactive-env/constants.ts
-var HOOK_NAME8 = "non-interactive-env";
+var HOOK_NAME9 = "non-interactive-env";
 var NON_INTERACTIVE_ENV = {
   CI: "true",
   DEBIAN_FRONTEND: "noninteractive",
@@ -60405,7 +60479,7 @@ function createNonInteractiveEnvHook(_ctx) {
       }
       const envPrefix = buildEnvPrefix(NON_INTERACTIVE_ENV, "unix");
       output.args.command = `${envPrefix} ${command}`;
-      log(`[${HOOK_NAME8}] Prepended non-interactive env vars to git command`, {
+      log(`[${HOOK_NAME9}] Prepended non-interactive env vars to git command`, {
         sessionID: input.sessionID,
         envPrefix
       });
@@ -60413,7 +60487,7 @@ function createNonInteractiveEnvHook(_ctx) {
   };
 }
 // src/hooks/oracle-md-only/constants.ts
-var HOOK_NAME9 = "oracle-md-only";
+var HOOK_NAME10 = "oracle-md-only";
 var ORACLE_AGENT = "oracle";
 var ALLOWED_EXTENSIONS = [".md"];
 var BLOCKED_TOOLS = ["Write", "Edit", "write", "edit"];
@@ -60546,7 +60620,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_NAME9}] Injected read-only planning warning to ${toolName}`, {
+          log(`[${HOOK_NAME10}] Injected read-only planning warning to ${toolName}`, {
             sessionID: input.sessionID,
             tool: toolName,
             agent: agentName
@@ -60562,17 +60636,17 @@ function createOracleMdOnlyHook(ctx) {
         return;
       }
       if (!isAllowedFile(filePath, ctx.directory)) {
-        log(`[${HOOK_NAME9}] Blocked: Oracle can only write to .matrixx/*.md`, {
+        log(`[${HOOK_NAME10}] Blocked: Oracle can only write to .matrixx/*.md`, {
           sessionID: input.sessionID,
           tool: toolName,
           filePath,
           agent: agentName
         });
-        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`);
+        throw new Error(`[${HOOK_NAME10}] ${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_NAME9}] Injecting workflow reminder for plan write`, {
+        log(`[${HOOK_NAME10}] Injecting workflow reminder for plan write`, {
           sessionID: input.sessionID,
           tool: toolName,
           filePath,
@@ -60580,7 +60654,7 @@ function createOracleMdOnlyHook(ctx) {
         });
         output.message = (output.message || "") + ORACLE_WORKFLOW_REMINDER;
       }
-      log(`[${HOOK_NAME9}] Allowed: .matrixx/*.md write permitted`, {
+      log(`[${HOOK_NAME10}] Allowed: .matrixx/*.md write permitted`, {
         sessionID: input.sessionID,
         tool: toolName,
         filePath,
@@ -60919,7 +60993,7 @@ var TaskDeleteInputSchema = exports_external.object({
 });
 
 // src/hooks/plan-persister/hook.ts
-var HOOK_NAME10 = "plan-persister";
+var HOOK_NAME11 = "plan-persister";
 function createPlanPersister(ctx, options) {
   const { directory } = options;
   const capture = async (sessionID) => {
@@ -60954,7 +61028,7 @@ function createPlanPersister(ctx, options) {
         const response = await ctx.client.session.todo({ path: { id: sessionID } });
         todos = normalizeTodos(response);
       } catch (err) {
-        log(`[${HOOK_NAME10}] Failed to fetch todos`, { sessionID, error: String(err) });
+        log(`[${HOOK_NAME11}] Failed to fetch todos`, { sessionID, error: String(err) });
         return;
       }
     }
@@ -60977,9 +61051,9 @@ function createPlanPersister(ctx, options) {
     ensurePlanDir(directory);
     const ok = atomicWrite(planPath, finalContent);
     if (ok) {
-      log(`[${HOOK_NAME10}] Plan file updated`, { planPath, completed, total });
+      log(`[${HOOK_NAME11}] Plan file updated`, { planPath, completed, total });
     } else {
-      log(`[${HOOK_NAME10}] Failed to write plan file`, { planPath });
+      log(`[${HOOK_NAME11}] Failed to write plan file`, { planPath });
     }
   };
   const event = async ({ event: evt }) => {
@@ -62341,7 +62415,7 @@ var RETRYABLE_ERROR_PATTERNS = [
   /(?:^|\s)503(?:\s|$)/,
   /(?:^|\s)529(?:\s|$)/
 ];
-var HOOK_NAME11 = "runtime-fallback";
+var HOOK_NAME12 = "runtime-fallback";
 
 // src/hooks/runtime-fallback/fallback-models.ts
 init_logger();
@@ -62430,7 +62504,7 @@ function getRawFallbackModelsForSession(sessionID, agent, pluginConfig) {
     if (result)
       return result;
   }
-  log(`[${HOOK_NAME11}] No category/agent fallback models resolved for session`, { sessionID, agent });
+  log(`[${HOOK_NAME12}] No category/agent fallback models resolved for session`, { sessionID, agent });
   return;
 }
 
@@ -62459,21 +62533,21 @@ function findNextAvailableFallback(state3, fallbackModels, cooldownSeconds) {
     if (!isModelInCooldown(candidate, state3, cooldownSeconds)) {
       return candidate;
     }
-    log(`[${HOOK_NAME11}] Skipping fallback model in cooldown`, { model: candidate, index: i });
+    log(`[${HOOK_NAME12}] 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_NAME11}] Max fallback attempts reached`, { sessionID, attempts: state3.attemptCount });
+    log(`[${HOOK_NAME12}] 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_NAME11}] No available fallback models`, { sessionID });
+    log(`[${HOOK_NAME12}] No available fallback models`, { sessionID });
     return { success: false, error: "No available fallback models (all in cooldown or exhausted)" };
   }
-  log(`[${HOOK_NAME11}] Preparing fallback`, {
+  log(`[${HOOK_NAME12}] Preparing fallback`, {
     sessionID,
     from: state3.currentModel,
     to: nextModel,
@@ -62559,9 +62633,9 @@ function createAutoRetryHelpers(deps) {
   const abortSessionRequest = async (sessionID, source) => {
     try {
       await ctx.client.session.abort({ path: { id: sessionID } });
-      log(`[${HOOK_NAME11}] Aborted in-flight session request (${source})`, { sessionID });
+      log(`[${HOOK_NAME12}] Aborted in-flight session request (${source})`, { sessionID });
     } catch (error51) {
-      log(`[${HOOK_NAME11}] Failed to abort in-flight session request (${source})`, {
+      log(`[${HOOK_NAME12}] Failed to abort in-flight session request (${source})`, {
         sessionID,
         error: String(error51)
       });
@@ -62585,7 +62659,7 @@ function createAutoRetryHelpers(deps) {
       if (!state3)
         return;
       if (sessionRetryInFlight.has(sessionID)) {
-        log(`[${HOOK_NAME11}] Overriding in-flight retry due to session timeout`, { sessionID });
+        log(`[${HOOK_NAME12}] Overriding in-flight retry due to session timeout`, { sessionID });
       }
       await abortSessionRequest(sessionID, "session.timeout");
       sessionRetryInFlight.delete(sessionID);
@@ -62595,7 +62669,7 @@ function createAutoRetryHelpers(deps) {
       const fallbackModels = getFallbackModelsForSession(sessionID, resolvedAgent, pluginConfig);
       if (fallbackModels.length === 0)
         return;
-      log(`[${HOOK_NAME11}] Session fallback timeout reached`, {
+      log(`[${HOOK_NAME12}] Session fallback timeout reached`, {
         sessionID,
         timeoutSeconds: config2.timeout_seconds,
         currentModel: state3.currentModel
@@ -62609,7 +62683,7 @@ function createAutoRetryHelpers(deps) {
   };
   const autoRetryWithFallback = async (sessionID, newModel, resolvedAgent, source) => {
     if (sessionRetryInFlight.has(sessionID)) {
-      log(`[${HOOK_NAME11}] Retry already in flight, skipping (${source})`, { sessionID });
+      log(`[${HOOK_NAME12}] Retry already in flight, skipping (${source})`, { sessionID });
       return;
     }
     const agentSettings = resolvedAgent ? pluginConfig?.agents?.[resolvedAgent] : undefined;
@@ -62618,7 +62692,7 @@ function createAutoRetryHelpers(deps) {
       reasoningEffort: agentSettings.reasoningEffort
     } : undefined);
     if (!retryModelPayload) {
-      log(`[${HOOK_NAME11}] Invalid model format (missing provider prefix): ${newModel}`);
+      log(`[${HOOK_NAME12}] Invalid model format (missing provider prefix): ${newModel}`);
       const state3 = sessionStates2.get(sessionID);
       if (state3?.pendingFallbackModel) {
         state3.pendingFallbackModel = undefined;
@@ -62634,7 +62708,7 @@ function createAutoRetryHelpers(deps) {
       });
       const retryParts = getLastUserRetryParts(messagesResp);
       if (retryParts.length > 0) {
-        log(`[${HOOK_NAME11}] Auto-retrying with fallback model (${source})`, {
+        log(`[${HOOK_NAME12}] Auto-retrying with fallback model (${source})`, {
           sessionID,
           model: newModel
         });
@@ -62653,10 +62727,10 @@ function createAutoRetryHelpers(deps) {
         });
         retryDispatched = true;
       } else {
-        log(`[${HOOK_NAME11}] No user message found for auto-retry (${source})`, { sessionID });
+        log(`[${HOOK_NAME12}] No user message found for auto-retry (${source})`, { sessionID });
       }
     } catch (retryError) {
-      log(`[${HOOK_NAME11}] Auto-retry failed (${source})`, { sessionID, error: String(retryError) });
+      log(`[${HOOK_NAME12}] Auto-retry failed (${source})`, { sessionID, error: String(retryError) });
     } finally {
       sessionRetryInFlight.delete(sessionID);
       if (!retryDispatched) {
@@ -62710,7 +62784,7 @@ function createAutoRetryHelpers(deps) {
       }
     }
     if (cleanedCount > 0) {
-      log(`[${HOOK_NAME11}] Cleaned up ${cleanedCount} stale session states`);
+      log(`[${HOOK_NAME12}] Cleaned up ${cleanedCount} stale session states`);
     }
   };
   return {
@@ -62741,7 +62815,7 @@ function createChatMessageHandler(deps) {
         state3.pendingFallbackModel = undefined;
         return;
       }
-      log(`[${HOOK_NAME11}] Detected manual model change, resetting fallback state`, {
+      log(`[${HOOK_NAME12}] Detected manual model change, resetting fallback state`, {
         sessionID,
         from: state3.currentModel,
         to: requestedModel
@@ -62753,7 +62827,7 @@ function createChatMessageHandler(deps) {
     if (state3.currentModel === state3.originalModel)
       return;
     const activeModel = state3.currentModel;
-    log(`[${HOOK_NAME11}] Applying fallback model override`, {
+    log(`[${HOOK_NAME12}] Applying fallback model override`, {
       sessionID,
       from: input.model,
       to: activeModel
@@ -62940,7 +63014,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_NAME11}] Derived model from agent config for ${options.source}`, {
+    log(`[${HOOK_NAME12}] Derived model from agent config for ${options.source}`, {
       sessionID: options.sessionID,
       agent: options.resolvedAgent,
       model: agentModel
@@ -62951,7 +63025,7 @@ function resolveFallbackBootstrapModel(options) {
   if (agentCategory) {
     const agentCategoryModel = options.pluginConfig?.categories?.[agentCategory]?.model;
     if (typeof agentCategoryModel === "string" && agentCategoryModel.length > 0) {
-      log(`[${HOOK_NAME11}] Derived model from agent category config for ${options.source}`, {
+      log(`[${HOOK_NAME12}] Derived model from agent category config for ${options.source}`, {
         sessionID: options.sessionID,
         agent: options.resolvedAgent,
         category: agentCategory,
@@ -62963,7 +63037,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_NAME11}] Derived model from session category config for ${options.source}`, {
+    log(`[${HOOK_NAME12}] Derived model from session category config for ${options.source}`, {
       sessionID: options.sessionID,
       category: sessionCategory,
       model: categoryModel
@@ -62993,7 +63067,7 @@ async function dispatchFallbackRetry(deps, helpers, options) {
     await helpers.autoRetryWithFallback(options.sessionID, result.newModel, options.resolvedAgent, options.source);
     return;
   }
-  log(`[${HOOK_NAME11}] Fallback preparation failed`, {
+  log(`[${HOOK_NAME12}] Fallback preparation failed`, {
     sessionID: options.sessionID,
     source: options.source,
     error: result.error
@@ -63046,14 +63120,14 @@ function createSessionStatusHandler(deps, helpers, sessionStatusRetryKeys) {
     sessionStatusRetryKeys.set(sessionID, retryKey);
     if (sessionRetryInFlight.has(sessionID)) {
       if (timeoutEnabled) {
-        log(`[${HOOK_NAME11}] Overriding in-flight retry due to provider auto-retry signal`, {
+        log(`[${HOOK_NAME12}] 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_NAME11}] session.status retry skipped - retry already in flight`, { sessionID });
+        log(`[${HOOK_NAME12}] session.status retry skipped - retry already in flight`, { sessionID });
         return;
       }
     }
@@ -63076,7 +63150,7 @@ function createSessionStatusHandler(deps, helpers, sessionStatusRetryKeys) {
       });
       if (!initialModel) {
         sessionStatusRetryKeys.delete(sessionID);
-        log(`[${HOOK_NAME11}] session.status retry missing model info, cannot fallback`, { sessionID });
+        log(`[${HOOK_NAME12}] session.status retry missing model info, cannot fallback`, { sessionID });
         return;
       }
       state3 = createFallbackState(initialModel);
@@ -63085,20 +63159,20 @@ function createSessionStatusHandler(deps, helpers, sessionStatusRetryKeys) {
     sessionLastAccess.set(sessionID, Date.now());
     if (state3.pendingFallbackModel) {
       if (timeoutEnabled) {
-        log(`[${HOOK_NAME11}] Clearing pending fallback due to provider auto-retry signal`, {
+        log(`[${HOOK_NAME12}] Clearing pending fallback due to provider auto-retry signal`, {
           sessionID,
           pendingFallbackModel: state3.pendingFallbackModel
         });
         state3.pendingFallbackModel = undefined;
       } else {
-        log(`[${HOOK_NAME11}] session.status retry skipped (pending fallback in progress)`, {
+        log(`[${HOOK_NAME12}] session.status retry skipped (pending fallback in progress)`, {
           sessionID,
           pendingFallbackModel: state3.pendingFallbackModel
         });
         return;
       }
     }
-    log(`[${HOOK_NAME11}] Detected provider auto-retry signal in session.status`, {
+    log(`[${HOOK_NAME12}] Detected provider auto-retry signal in session.status`, {
       sessionID,
       model: state3.currentModel,
       retryAttempt: status.attempt
@@ -63134,7 +63208,7 @@ function createEventHandler(deps, helpers) {
     const sessionID = sessionInfo?.id;
     const model = sessionInfo?.model;
     if (sessionID && model) {
-      log(`[${HOOK_NAME11}] Session created with model`, { sessionID, model });
+      log(`[${HOOK_NAME12}] Session created with model`, { sessionID, model });
       sessionStates2.set(sessionID, createFallbackState(model));
       sessionLastAccess.set(sessionID, Date.now());
     }
@@ -63143,7 +63217,7 @@ function createEventHandler(deps, helpers) {
     const sessionInfo = props?.info;
     const sessionID = sessionInfo?.id;
     if (sessionID) {
-      log(`[${HOOK_NAME11}] Cleaning up session state`, { sessionID });
+      log(`[${HOOK_NAME12}] Cleaning up session state`, { sessionID });
       cancelledSessions.delete(sessionID);
       sessionStates2.delete(sessionID);
       sessionLastAccess.delete(sessionID);
@@ -63163,7 +63237,7 @@ function createEventHandler(deps, helpers) {
     }
     cancelledSessions.add(sessionID);
     resetRetryState(sessionID);
-    log(`[${HOOK_NAME11}] Cleared fallback retry state on session.stop`, { sessionID });
+    log(`[${HOOK_NAME12}] Cleared fallback retry state on session.stop`, { sessionID });
   };
   const handleMessageUpdated = (props) => {
     const info = props?.info;
@@ -63179,11 +63253,11 @@ function createEventHandler(deps, helpers) {
       return;
     if (cancelledSessions.has(sessionID)) {
       resetRetryState(sessionID);
-      log(`[${HOOK_NAME11}] Cleared fallback retry state for cancelled session on idle`, { sessionID });
+      log(`[${HOOK_NAME12}] Cleared fallback retry state for cancelled session on idle`, { sessionID });
       return;
     }
     if (sessionAwaitingFallbackResult.has(sessionID)) {
-      log(`[${HOOK_NAME11}] session.idle while awaiting fallback result; keeping timeout armed`, { sessionID });
+      log(`[${HOOK_NAME12}] session.idle while awaiting fallback result; keeping timeout armed`, { sessionID });
       return;
     }
     const hadTimeout = sessionFallbackTimeouts.has(sessionID);
@@ -63195,7 +63269,7 @@ function createEventHandler(deps, helpers) {
       state3.pendingFallbackModel = undefined;
     }
     if (hadTimeout) {
-      log(`[${HOOK_NAME11}] Cleared fallback timeout after session completion`, { sessionID });
+      log(`[${HOOK_NAME12}] Cleared fallback timeout after session completion`, { sessionID });
     }
   };
   const handleSessionError = async (props) => {
@@ -63203,18 +63277,18 @@ function createEventHandler(deps, helpers) {
     const error51 = props?.error;
     const agent = props?.agent;
     if (!sessionID) {
-      log(`[${HOOK_NAME11}] session.error without sessionID, skipping`);
+      log(`[${HOOK_NAME12}] session.error without sessionID, skipping`);
       return;
     }
     const resolvedAgent = await helpers.resolveAgentForSessionFromContext(sessionID, agent);
     if (isAbortError(error51)) {
       cancelledSessions.add(sessionID);
       resetRetryState(sessionID);
-      log(`[${HOOK_NAME11}] session.error matched cancellation; cleared retry state`, { sessionID, resolvedAgent });
+      log(`[${HOOK_NAME12}] session.error matched cancellation; cleared retry state`, { sessionID, resolvedAgent });
       return;
     }
     if (sessionRetryInFlight.has(sessionID)) {
-      log(`[${HOOK_NAME11}] session.error skipped - retry in flight`, {
+      log(`[${HOOK_NAME12}] session.error skipped - retry in flight`, {
         sessionID,
         retryInFlight: true
       });
@@ -63222,7 +63296,7 @@ function createEventHandler(deps, helpers) {
     }
     sessionAwaitingFallbackResult.delete(sessionID);
     helpers.clearSessionFallbackTimeout(sessionID);
-    log(`[${HOOK_NAME11}] session.error received`, {
+    log(`[${HOOK_NAME12}] session.error received`, {
       sessionID,
       agent,
       resolvedAgent,
@@ -63231,7 +63305,7 @@ function createEventHandler(deps, helpers) {
       errorType: classifyErrorType(error51)
     });
     if (!isRetryableError(error51, config2.retry_on_errors)) {
-      log(`[${HOOK_NAME11}] Error not retryable, skipping fallback`, {
+      log(`[${HOOK_NAME12}] Error not retryable, skipping fallback`, {
         sessionID,
         retryable: false,
         statusCode: extractStatusCode(error51, config2.retry_on_errors),
@@ -63243,7 +63317,7 @@ function createEventHandler(deps, helpers) {
     let state3 = sessionStates2.get(sessionID);
     const fallbackModels = getFallbackModelsForSession(sessionID, resolvedAgent, pluginConfig);
     if (fallbackModels.length === 0) {
-      log(`[${HOOK_NAME11}] No fallback models configured`, { sessionID, agent });
+      log(`[${HOOK_NAME12}] No fallback models configured`, { sessionID, agent });
       return;
     }
     if (!state3) {
@@ -63255,7 +63329,7 @@ function createEventHandler(deps, helpers) {
         pluginConfig
       });
       if (!initialModel) {
-        log(`[${HOOK_NAME11}] No model info available, cannot fallback`, { sessionID });
+        log(`[${HOOK_NAME12}] No model info available, cannot fallback`, { sessionID });
         return;
       }
       state3 = createFallbackState(initialModel);
@@ -63395,7 +63469,7 @@ function createMessageUpdateHandler(deps, helpers) {
       }
       const hasVisible = await checkVisibleResponse(ctx, sessionID, info);
       if (!hasVisible) {
-        log(`[${HOOK_NAME11}] Assistant update observed without visible final response; keeping fallback timeout`, {
+        log(`[${HOOK_NAME12}] Assistant update observed without visible final response; keeping fallback timeout`, {
           sessionID,
           model
         });
@@ -63408,17 +63482,17 @@ function createMessageUpdateHandler(deps, helpers) {
       if (state3?.pendingFallbackModel) {
         state3.pendingFallbackModel = undefined;
       }
-      log(`[${HOOK_NAME11}] Assistant response observed; cleared fallback timeout`, { sessionID, model });
+      log(`[${HOOK_NAME12}] Assistant response observed; cleared fallback timeout`, { sessionID, model });
       return;
     }
     if (sessionID && role === "assistant" && error51) {
       sessionAwaitingFallbackResult.delete(sessionID);
       if (sessionRetryInFlight.has(sessionID) && !retrySignal) {
-        log(`[${HOOK_NAME11}] message.updated fallback skipped (retry in flight)`, { sessionID });
+        log(`[${HOOK_NAME12}] message.updated fallback skipped (retry in flight)`, { sessionID });
         return;
       }
       if (retrySignal && sessionRetryInFlight.has(sessionID) && timeoutEnabled) {
-        log(`[${HOOK_NAME11}] Overriding in-flight retry due to provider auto-retry signal`, {
+        log(`[${HOOK_NAME12}] Overriding in-flight retry due to provider auto-retry signal`, {
           sessionID,
           model
         });
@@ -63426,12 +63500,12 @@ function createMessageUpdateHandler(deps, helpers) {
         sessionRetryInFlight.delete(sessionID);
       }
       if (retrySignal && timeoutEnabled) {
-        log(`[${HOOK_NAME11}] Detected provider auto-retry signal`, { sessionID, model });
+        log(`[${HOOK_NAME12}] Detected provider auto-retry signal`, { sessionID, model });
       }
       if (!retrySignal) {
         helpers.clearSessionFallbackTimeout(sessionID);
       }
-      log(`[${HOOK_NAME11}] message.updated with assistant error`, {
+      log(`[${HOOK_NAME12}] message.updated with assistant error`, {
         sessionID,
         model,
         statusCode: extractStatusCode(error51, config2.retry_on_errors),
@@ -63439,7 +63513,7 @@ function createMessageUpdateHandler(deps, helpers) {
         errorType: classifyErrorType(error51)
       });
       if (!isRetryableError(error51, config2.retry_on_errors)) {
-        log(`[${HOOK_NAME11}] message.updated error not retryable, skipping fallback`, {
+        log(`[${HOOK_NAME12}] message.updated error not retryable, skipping fallback`, {
           sessionID,
           statusCode: extractStatusCode(error51, config2.retry_on_errors),
           errorName: extractErrorName(error51),
@@ -63463,7 +63537,7 @@ function createMessageUpdateHandler(deps, helpers) {
           pluginConfig
         });
         if (!initialModel) {
-          log(`[${HOOK_NAME11}] message.updated missing model info, cannot fallback`, {
+          log(`[${HOOK_NAME12}] message.updated missing model info, cannot fallback`, {
             sessionID,
             errorName: extractErrorName(error51),
             errorType: classifyErrorType(error51)
@@ -63477,13 +63551,13 @@ function createMessageUpdateHandler(deps, helpers) {
         sessionLastAccess.set(sessionID, Date.now());
         if (state3.pendingFallbackModel) {
           if (retrySignal && timeoutEnabled) {
-            log(`[${HOOK_NAME11}] Clearing pending fallback due to provider auto-retry signal`, {
+            log(`[${HOOK_NAME12}] Clearing pending fallback due to provider auto-retry signal`, {
               sessionID,
               pendingFallbackModel: state3.pendingFallbackModel
             });
             state3.pendingFallbackModel = undefined;
           } else {
-            log(`[${HOOK_NAME11}] message.updated fallback skipped (pending fallback in progress)`, {
+            log(`[${HOOK_NAME12}] message.updated fallback skipped (pending fallback in progress)`, {
               sessionID,
               pendingFallbackModel: state3.pendingFallbackModel
             });
@@ -64489,7 +64563,7 @@ function createSessionRecoveryHook(ctx, options) {
 }
 // src/hooks/start-work/start-work-hook.ts
 init_logger();
-var HOOK_NAME12 = "start-work";
+var HOOK_NAME13 = "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);
@@ -64519,7 +64593,7 @@ function createStartWorkHook(ctx) {
       if (!isStartWorkCommand) {
         return;
       }
-      log(`[${HOOK_NAME12}] Processing start-work command`, {
+      log(`[${HOOK_NAME13}] Processing start-work command`, {
         sessionID: input.sessionID
       });
       updateSessionAgent(input.sessionID, "architect");
@@ -64529,7 +64603,7 @@ function createStartWorkHook(ctx) {
       let contextInfo = "";
       const explicitPlanName = extractUserRequestPlanName(promptText);
       if (explicitPlanName) {
-        log(`[${HOOK_NAME12}] Explicit plan name requested: ${explicitPlanName}`, {
+        log(`[${HOOK_NAME13}] Explicit plan name requested: ${explicitPlanName}`, {
           sessionID: input.sessionID
         });
         const allPlans = findOraclePlans(ctx.directory);
@@ -64670,7 +64744,7 @@ Ask the user which plan to work on. Present the options above and wait for their
 ---
 ${contextInfo}`;
       }
-      log(`[${HOOK_NAME12}] Context injected`, {
+      log(`[${HOOK_NAME13}] Context injected`, {
         sessionID: input.sessionID,
         hasExistingState: !!existingState
       });
@@ -64756,7 +64830,7 @@ function isQuestionTool(properties) {
 
 // src/hooks/stop-continuation-guard/hook.ts
 init_logger();
-var HOOK_NAME13 = "stop-continuation-guard";
+var HOOK_NAME14 = "stop-continuation-guard";
 function createStopContinuationGuardHook(ctx, options) {
   const stoppedSessions = new Set;
   const isSessionAwaitingUser = async (sessionID) => {
@@ -64769,22 +64843,22 @@ function createStopContinuationGuardHook(ctx, options) {
       });
       return hasPendingQuestionMessage(normalizeSDKResponse(resp, []));
     } catch (error51) {
-      log(`[${HOOK_NAME13}] Messages fetch failed, assuming not awaiting user`, { sessionID, error: String(error51) });
+      log(`[${HOOK_NAME14}] Messages fetch failed, assuming not awaiting user`, { sessionID, error: String(error51) });
       return false;
     }
   };
   const stop = async (sessionID) => {
     stoppedSessions.add(sessionID);
-    log(`[${HOOK_NAME13}] Continuation stopped for session`, { sessionID });
+    log(`[${HOOK_NAME14}] Continuation stopped for session`, { sessionID });
     if (!options?.backgroundManager)
       return;
     if (await isSessionAwaitingUser(sessionID)) {
-      log(`[${HOOK_NAME13}] Background cancellation suppressed: awaiting user`, { sessionID });
+      log(`[${HOOK_NAME14}] Background cancellation suppressed: awaiting user`, { sessionID });
       return;
     }
     const cancelled = options.backgroundManager.cancelAllForSession(sessionID);
     if (cancelled > 0) {
-      log(`[${HOOK_NAME13}] Cancelled ${cancelled} background task(s) for session`, { sessionID });
+      log(`[${HOOK_NAME14}] Cancelled ${cancelled} background task(s) for session`, { sessionID });
     }
   };
   const isStopped = (sessionID) => {
@@ -64792,7 +64866,7 @@ function createStopContinuationGuardHook(ctx, options) {
   };
   const clear = (sessionID) => {
     stoppedSessions.delete(sessionID);
-    log(`[${HOOK_NAME13}] Continuation guard cleared for session`, { sessionID });
+    log(`[${HOOK_NAME14}] Continuation guard cleared for session`, { sessionID });
   };
   const event = async ({
     event: event2
@@ -64802,7 +64876,7 @@ function createStopContinuationGuardHook(ctx, options) {
       const sessionInfo = props?.info;
       if (sessionInfo?.id) {
         clear(sessionInfo.id);
-        log(`[${HOOK_NAME13}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
+        log(`[${HOOK_NAME14}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
       }
     }
   };
@@ -64811,7 +64885,7 @@ function createStopContinuationGuardHook(ctx, options) {
   }) => {
     if (sessionID && stoppedSessions.has(sessionID)) {
       clear(sessionID);
-      log(`[${HOOK_NAME13}] Cleared stop state on new user message`, { sessionID });
+      log(`[${HOOK_NAME14}] Cleared stop state on new user message`, { sessionID });
     }
   };
   return {
@@ -64826,7 +64900,7 @@ function createStopContinuationGuardHook(ctx, options) {
 init_logger();
 
 // src/hooks/task-continuation-enforcer/constants.ts
-var HOOK_NAME14 = "task-continuation-enforcer";
+var HOOK_NAME15 = "task-continuation-enforcer";
 var DEFAULT_SKIP_AGENTS = ["oracle", "compaction"];
 var EXPLORER_AGENTS = ["trinity", "operator"];
 function hasNonExplorerBgTasks(tasks) {
@@ -64973,21 +65047,21 @@ async function injectContinuation(args) {
     config: config2
   } = args;
   if (subagentSessions.has(sessionID)) {
-    log(`[${HOOK_NAME14}] Skipped injection: subagent session`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped injection: subagent session`, { sessionID });
     return;
   }
   const state3 = sessionStateStore.getExistingState(sessionID);
   if (state3?.isRecovering) {
-    log(`[${HOOK_NAME14}] Skipped injection: in recovery`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped injection: in recovery`, { sessionID });
     return;
   }
   if (isAwaitingUser(state3)) {
-    log(`[${HOOK_NAME14}] Skipped injection: awaiting user`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped injection: awaiting user`, { sessionID });
     return;
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME14}] Skipped injection: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped injection: background tasks running`, { sessionID });
     return;
   }
   const earlyInjectionState = sessionStateStore.getExistingState(sessionID);
@@ -64995,7 +65069,7 @@ async function injectContinuation(args) {
     const now = Date.now();
     const elapsedMs = now - earlyInjectionState.lastInjectedAt;
     if (elapsedMs < CONTINUATION_COOLDOWN_MS3) {
-      log(`[${HOOK_NAME14}] Skipped injection: cooldown active`, {
+      log(`[${HOOK_NAME15}] Skipped injection: cooldown active`, {
         sessionID,
         cooldownMs: CONTINUATION_COOLDOWN_MS3,
         elapsedMs
@@ -65013,10 +65087,10 @@ async function injectContinuation(args) {
     if (!existsSync42(taskDir)) {
       const hadNonExplorerBgTasks = backgroundManager ? hasNonExplorerBgTasks(backgroundManager.getTasksByParentSession(sessionID)) : false;
       if (hadNonExplorerBgTasks) {
-        log(`[${HOOK_NAME14}] Bootstrap injection: no task dir (hadNonExplorerBgTasks)`, { sessionID, taskDir });
+        log(`[${HOOK_NAME15}] Bootstrap injection: no task dir (hadNonExplorerBgTasks)`, { sessionID, taskDir });
         isBootstrap = true;
       } else {
-        log(`[${HOOK_NAME14}] Skipped injection: no task dir`, { sessionID, taskDir });
+        log(`[${HOOK_NAME15}] Skipped injection: no task dir`, { sessionID, taskDir });
         return;
       }
       total = 0;
@@ -65036,16 +65110,16 @@ async function injectContinuation(args) {
       if (total === 0) {
         const hadNonExplorerBgTasks = backgroundManager ? hasNonExplorerBgTasks(backgroundManager.getTasksByParentSession(sessionID)) : false;
         if (hadNonExplorerBgTasks) {
-          log(`[${HOOK_NAME14}] Bootstrap injection: no tasks (hadNonExplorerBgTasks)`, { sessionID });
+          log(`[${HOOK_NAME15}] Bootstrap injection: no tasks (hadNonExplorerBgTasks)`, { sessionID });
           isBootstrap = true;
         } else {
-          log(`[${HOOK_NAME14}] Skipped injection: no tasks`, { sessionID });
+          log(`[${HOOK_NAME15}] Skipped injection: no tasks`, { sessionID });
           return;
         }
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME14}] Failed to fetch tasks`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME15}] Failed to fetch tasks`, { sessionID, error: String(error51) });
     return;
   }
   const stateForBootstrap = sessionStateStore.getExistingState(sessionID);
@@ -65056,7 +65130,7 @@ async function injectContinuation(args) {
   const staleAfterMs = getStaleAfterMs(config2);
   const freshIncompleteCount = isBootstrap ? 1 : filterFreshIncompleteTasks(getIncompleteTasks(filteredTasks), taskDir, staleAfterMs).length;
   if (!isBootstrap && freshIncompleteCount === 0) {
-    log(`[${HOOK_NAME14}] Skipped injection: only stale tasks remain`, { sessionID, total });
+    log(`[${HOOK_NAME15}] Skipped injection: only stale tasks remain`, { sessionID, total });
     return;
   }
   let agentName = resolvedInfo?.agent;
@@ -65079,11 +65153,11 @@ async function injectContinuation(args) {
     tools = tools ?? previousMessage?.tools;
   }
   if (agentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(agentName))) {
-    log(`[${HOOK_NAME14}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME15}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
     return;
   }
   if (!hasWritePermission(tools)) {
-    log(`[${HOOK_NAME14}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME15}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
     return;
   }
   let prompt;
@@ -65117,11 +65191,11 @@ ${taskList}${staleNote}`;
     if (injectionState) {
       injectionState.inFlight = false;
     }
-    log(`[${HOOK_NAME14}] Skipped injection: awaiting user (race)`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped injection: awaiting user (race)`, { sessionID });
     return;
   }
   try {
-    log(`[${HOOK_NAME14}] Injecting continuation`, {
+    log(`[${HOOK_NAME15}] Injecting continuation`, {
       sessionID,
       agent: agentName,
       model,
@@ -65136,14 +65210,14 @@ ${taskList}${staleNote}`;
       },
       query: { directory: ctx.directory }
     });
-    log(`[${HOOK_NAME14}] Injection successful`, { sessionID });
+    log(`[${HOOK_NAME15}] Injection successful`, { sessionID });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
       injectionState.consecutiveFailures = 0;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME14}] Injection failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME15}] Injection failed`, { sessionID, error: String(error51) });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
@@ -65178,7 +65252,7 @@ function startCountdown(args) {
   } = args;
   const state3 = sessionStateStore.getState(sessionID);
   if (state3.countdownTimer || state3.countdownInterval) {
-    log(`[${HOOK_NAME14}] Skipped: countdown already active`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: countdown already active`, { sessionID });
     return;
   }
   let secondsRemaining = COUNTDOWN_SECONDS;
@@ -65202,7 +65276,7 @@ function startCountdown(args) {
       config: config2
     });
   }, COUNTDOWN_SECONDS * 1000);
-  log(`[${HOOK_NAME14}] Countdown started`, {
+  log(`[${HOOK_NAME15}] Countdown started`, {
     sessionID,
     seconds: COUNTDOWN_SECONDS,
     incompleteCount
@@ -65220,36 +65294,36 @@ async function handleSessionIdle(args) {
     isContinuationStopped,
     config: config2
   } = args;
-  log(`[${HOOK_NAME14}] session.idle`, { sessionID });
+  log(`[${HOOK_NAME15}] session.idle`, { sessionID });
   if (subagentSessions.has(sessionID)) {
-    log(`[${HOOK_NAME14}] Skipped: subagent session`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: subagent session`, { sessionID });
     return;
   }
   const state3 = sessionStateStore.getState(sessionID);
   if (state3.countdownTimer || state3.countdownInterval) {
-    log(`[${HOOK_NAME14}] Skipped: countdown already active`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: countdown already active`, { sessionID });
     return;
   }
   if (state3.isRecovering) {
-    log(`[${HOOK_NAME14}] Skipped: in recovery`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: in recovery`, { sessionID });
     return;
   }
   if (state3.abortDetectedAt) {
     const timeSinceAbort = Date.now() - state3.abortDetectedAt;
     if (timeSinceAbort < ABORT_WINDOW_MS) {
-      log(`[${HOOK_NAME14}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
+      log(`[${HOOK_NAME15}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
       state3.abortDetectedAt = undefined;
       return;
     }
     state3.abortDetectedAt = undefined;
   }
   if (isAwaitingUser(state3)) {
-    log(`[${HOOK_NAME14}] Skipped: awaiting user`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: awaiting user`, { sessionID });
     return;
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME14}] Skipped: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: background tasks running`, { sessionID });
     return;
   }
   try {
@@ -65259,15 +65333,15 @@ async function handleSessionIdle(args) {
     });
     const messages = normalizeSDKResponse(messagesResp, []);
     if (isLastAssistantMessageAborted(messages)) {
-      log(`[${HOOK_NAME14}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
+      log(`[${HOOK_NAME15}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
       return;
     }
     if (isAwaitingUser(state3, messages)) {
-      log(`[${HOOK_NAME14}] Skipped: awaiting user (pending question)`, { sessionID });
+      log(`[${HOOK_NAME15}] Skipped: awaiting user (pending question)`, { sessionID });
       return;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME14}] Messages fetch failed, continuing`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME15}] Messages fetch failed, continuing`, { sessionID, error: String(error51) });
   }
   let incompleteCount = 0;
   let total = 0;
@@ -65278,12 +65352,12 @@ async function handleSessionIdle(args) {
     if (!existsSync43(taskDir)) {
       const hadNonExplorerBgTasks = backgroundManager ? hasNonExplorerBgTasks(backgroundManager.getTasksByParentSession(sessionID)) : false;
       if (hadNonExplorerBgTasks) {
-        log(`[${HOOK_NAME14}] No task dir \u2014 bootstrap (hadBgTasks)`, { sessionID, taskDir });
+        log(`[${HOOK_NAME15}] No task dir \u2014 bootstrap (hadBgTasks)`, { sessionID, taskDir });
         isBootstrap = true;
         total = 0;
         incompleteCount = 1;
       } else {
-        log(`[${HOOK_NAME14}] No task dir`, { sessionID, taskDir });
+        log(`[${HOOK_NAME15}] No task dir`, { sessionID, taskDir });
         return;
       }
     } else {
@@ -65303,11 +65377,11 @@ async function handleSessionIdle(args) {
       if (total === 0) {
         const hadNonExplorerBgTasks = backgroundManager ? hasNonExplorerBgTasks(backgroundManager.getTasksByParentSession(sessionID)) : false;
         if (hadNonExplorerBgTasks) {
-          log(`[${HOOK_NAME14}] No tasks \u2014 bootstrap (hadNonExplorerBgTasks)`, { sessionID });
+          log(`[${HOOK_NAME15}] No tasks \u2014 bootstrap (hadNonExplorerBgTasks)`, { sessionID });
           isBootstrap = true;
           incompleteCount = 1;
         } else {
-          log(`[${HOOK_NAME14}] No tasks`, { sessionID });
+          log(`[${HOOK_NAME15}] No tasks`, { sessionID });
           return;
         }
       } else {
@@ -65317,7 +65391,7 @@ async function handleSessionIdle(args) {
         const staleIncompleteCount = incompleteTasks.filter((t) => isTaskStale(join52(taskDir, `${t.id}.json`), staleAfterMs)).length;
         const activeIncompleteCount = incompleteCount - staleIncompleteCount;
         if (activeIncompleteCount === 0 && staleIncompleteCount > 0) {
-          log(`[${HOOK_NAME14}] Skipped: only stale tasks remain`, {
+          log(`[${HOOK_NAME15}] Skipped: only stale tasks remain`, {
             sessionID,
             staleIncompleteCount,
             staleAfterMs
@@ -65327,11 +65401,11 @@ async function handleSessionIdle(args) {
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME14}] Task fetch failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME15}] Task fetch failed`, { sessionID, error: String(error51) });
     return;
   }
   if (!isBootstrap && incompleteCount === 0) {
-    log(`[${HOOK_NAME14}] All tasks complete`, { sessionID, total });
+    log(`[${HOOK_NAME15}] All tasks complete`, { sessionID, total });
     return;
   }
   if (isBootstrap) {
@@ -65339,18 +65413,18 @@ async function handleSessionIdle(args) {
     s._bootstrap = true;
   }
   if (state3.inFlight) {
-    log(`[${HOOK_NAME14}] Skipped: injection in flight`, { sessionID });
+    log(`[${HOOK_NAME15}] 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_NAME14}] Reset consecutive failures after recovery window`, {
+    log(`[${HOOK_NAME15}] Reset consecutive failures after recovery window`, {
       sessionID,
       failureResetWindowMs: FAILURE_RESET_WINDOW_MS
     });
   }
   if ((state3.consecutiveFailures ?? 0) >= MAX_CONSECUTIVE_FAILURES) {
-    log(`[${HOOK_NAME14}] Skipped: max consecutive failures reached`, {
+    log(`[${HOOK_NAME15}] Skipped: max consecutive failures reached`, {
       sessionID,
       consecutiveFailures: state3.consecutiveFailures ?? 0,
       maxConsecutiveFailures: MAX_CONSECUTIVE_FAILURES
@@ -65359,7 +65433,7 @@ async function handleSessionIdle(args) {
   }
   const effectiveCooldown = CONTINUATION_COOLDOWN_MS3 * 2 ** Math.min(state3.consecutiveFailures ?? 0, 5);
   if (state3.lastInjectedAt && Date.now() - state3.lastInjectedAt < effectiveCooldown) {
-    log(`[${HOOK_NAME14}] Skipped: cooldown active`, {
+    log(`[${HOOK_NAME15}] Skipped: cooldown active`, {
       sessionID,
       effectiveCooldown,
       consecutiveFailures: state3.consecutiveFailures ?? 0
@@ -65389,24 +65463,24 @@ async function handleSessionIdle(args) {
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME14}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME15}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
   }
-  log(`[${HOOK_NAME14}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
+  log(`[${HOOK_NAME15}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
   const resolvedAgentName = resolvedInfo?.agent;
   if (resolvedAgentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(resolvedAgentName))) {
-    log(`[${HOOK_NAME14}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
+    log(`[${HOOK_NAME15}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
     return;
   }
   if (hasCompactionMessage && !resolvedInfo?.agent) {
-    log(`[${HOOK_NAME14}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
     return;
   }
   if (isContinuationStopped?.(sessionID)) {
-    log(`[${HOOK_NAME14}] Skipped: continuation stopped for session`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: continuation stopped for session`, { sessionID });
     return;
   }
   if (isAwaitingUser(state3)) {
-    log(`[${HOOK_NAME14}] Skipped: awaiting user (race)`, { sessionID });
+    log(`[${HOOK_NAME15}] Skipped: awaiting user (race)`, { sessionID });
     return;
   }
   startCountdown({
@@ -65439,7 +65513,7 @@ function handleNonIdleEvent(args) {
       if (state3?.countdownStartedAt) {
         const elapsed = Date.now() - state3.countdownStartedAt;
         if (elapsed < COUNTDOWN_GRACE_PERIOD_MS) {
-          log(`[${HOOK_NAME14}] Ignoring user message in grace period`, { sessionID, elapsed });
+          log(`[${HOOK_NAME15}] Ignoring user message in grace period`, { sessionID, elapsed });
           return;
         }
       }
@@ -65485,7 +65559,7 @@ function handleNonIdleEvent(args) {
     const sessionInfo = properties?.info;
     if (sessionInfo?.id) {
       sessionStateStore.cleanup(sessionInfo.id);
-      log(`[${HOOK_NAME14}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
+      log(`[${HOOK_NAME15}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
     }
     return;
   }
@@ -65511,10 +65585,10 @@ function createTaskContinuationHandler(args) {
       if (error51?.name === "MessageAbortedError" || error51?.name === "AbortError") {
         const state3 = sessionStateStore.getState(sessionID);
         state3.abortDetectedAt = Date.now();
-        log(`[${HOOK_NAME14}] Abort detected via session.error`, { sessionID, errorName: error51.name });
+        log(`[${HOOK_NAME15}] Abort detected via session.error`, { sessionID, errorName: error51.name });
       }
       sessionStateStore.cancelCountdown(sessionID);
-      log(`[${HOOK_NAME14}] session.error`, { sessionID });
+      log(`[${HOOK_NAME15}] session.error`, { sessionID });
       return;
     }
     if (event.type === "session.idle") {
@@ -65634,13 +65708,13 @@ function createTaskContinuationEnforcer(ctx, options = {}) {
     const state3 = sessionStateStore.getState(sessionID);
     state3.isRecovering = true;
     sessionStateStore.cancelCountdown(sessionID);
-    log(`[${HOOK_NAME14}] Session marked as recovering`, { sessionID });
+    log(`[${HOOK_NAME15}] Session marked as recovering`, { sessionID });
   };
   const markRecoveryComplete = (sessionID) => {
     const state3 = sessionStateStore.getExistingState(sessionID);
     if (state3) {
       state3.isRecovering = false;
-      log(`[${HOOK_NAME14}] Session recovery complete`, { sessionID });
+      log(`[${HOOK_NAME15}] Session recovery complete`, { sessionID });
     }
   };
   const handler = createTaskContinuationHandler({
@@ -65653,7 +65727,7 @@ function createTaskContinuationEnforcer(ctx, options = {}) {
   });
   const cancelAllCountdowns = () => {
     sessionStateStore.cancelAllCountdowns();
-    log(`[${HOOK_NAME14}] All countdowns cancelled`);
+    log(`[${HOOK_NAME15}] All countdowns cancelled`);
   };
   return {
     handler,
@@ -65664,8 +65738,8 @@ function createTaskContinuationEnforcer(ctx, options = {}) {
   };
 }
 // src/hooks/task-edit-guard/constants.ts
-var HOOK_NAME15 = "task-edit-guard";
-var BLOCKED_PATTERNS = [
+var HOOK_NAME16 = "task-edit-guard";
+var BLOCKED_PATTERNS2 = [
   /sed\s+.*\.matrixx\/plans/,
   /sed\s+.*\.matrixx\/tasks/,
   /python3?\s+.*\.matrixx\/plans/,
@@ -65698,7 +65772,7 @@ function createTaskEditGuardHook(ctx) {
         if (filePath) {
           const normalized = filePath.toLowerCase().replace(/\\/g, "/");
           if (normalized.includes(".matrixx/plans")) {
-            log(`[${HOOK_NAME15}] BLOCKED generic Write/Edit to .matrixx/plans \u2014 use plan_*`, {
+            log(`[${HOOK_NAME16}] BLOCKED generic Write/Edit to .matrixx/plans \u2014 use plan_*`, {
               sessionID: input.sessionID,
               tool: input.tool,
               filePath
@@ -65714,7 +65788,7 @@ function createTaskEditGuardHook(ctx) {
         if (filePath) {
           const normalized = filePath.toLowerCase().replace(/\\/g, "/");
           if (normalized.includes(".matrixx/plans")) {
-            log(`[${HOOK_NAME15}] BLOCKED generic Read to .matrixx/plans \u2014 use plan_read`, {
+            log(`[${HOOK_NAME16}] BLOCKED generic Read to .matrixx/plans \u2014 use plan_read`, {
               sessionID: input.sessionID,
               tool: input.tool,
               filePath
@@ -65732,15 +65806,15 @@ function createTaskEditGuardHook(ctx) {
         return;
       const lower = cmd.toLowerCase();
       if (lower.includes("grep") && !lower.includes("sed") && !lower.includes("python")) {
-        const isOnlyGrep = BLOCKED_PATTERNS.every((rx) => !rx.test(cmd));
+        const isOnlyGrep = BLOCKED_PATTERNS2.every((rx) => !rx.test(cmd));
         if (isOnlyGrep)
           return;
       }
-      const hit = BLOCKED_PATTERNS.some((rx) => rx.test(cmd));
+      const hit = BLOCKED_PATTERNS2.some((rx) => rx.test(cmd));
       if (!hit)
         return;
       ctx.directory;
-      log(`[${HOOK_NAME15}] BLOCKED raw bash edit`, {
+      log(`[${HOOK_NAME16}] BLOCKED raw bash edit`, {
         sessionID: input.sessionID,
         command: cmd.slice(0, 120)
       });
@@ -65749,7 +65823,7 @@ function createTaskEditGuardHook(ctx) {
   };
 }
 // src/hooks/task-notepad/constants.ts
-var HOOK_NAME16 = "task-notepad";
+var HOOK_NAME17 = "task-notepad";
 var PLAN_DIR_NAME = ".matrixx";
 var PLANS_SUBDIR = "plans";
 var NOTEPAD_DIR_NAME = "notepads";
@@ -65778,7 +65852,7 @@ function createTaskNotepadHook(ctx) {
       const plan = resolveActivePlan(ctx.directory);
       if (inProgress) {
         if (!plan) {
-          log(`[${HOOK_NAME16}] No active plan, skipping notepad creation`, {
+          log(`[${HOOK_NAME17}] No active plan, skipping notepad creation`, {
             sessionID: input.sessionID
           });
         } else {
@@ -65805,7 +65879,7 @@ async function fetchTodos(ctx, sessionID) {
     }
     return [];
   } catch (err) {
-    log(`[${HOOK_NAME16}] ${TODO_FETCH_ERROR_FRAGMENT}`, {
+    log(`[${HOOK_NAME17}] ${TODO_FETCH_ERROR_FRAGMENT}`, {
       sessionID,
       error: String(err)
     });
@@ -65850,7 +65924,7 @@ function ensureNotepad(directory, planName, todo) {
   mkdirSync16(dirname11(notepadPath), { recursive: true });
   const content = renderNotepad(todo);
   writeFileSync18(notepadPath, content, "utf-8");
-  log(`[${HOOK_NAME16}] Created task notepad`, { plan: planName, taskID: todo.id });
+  log(`[${HOOK_NAME17}] Created task notepad`, { plan: planName, taskID: todo.id });
 }
 function appendCompletion(directory, planName, todo) {
   const notepadPath = notepadPathFor(directory, planName, todo.id);
@@ -65866,7 +65940,7 @@ function appendCompletion(directory, planName, todo) {
 - status: completed
 `;
   writeFileSync18(notepadPath, updated, "utf-8");
-  log(`[${HOOK_NAME16}] Appended completion to notepad`, { plan: planName, taskID: todo.id });
+  log(`[${HOOK_NAME17}] Appended completion to notepad`, { plan: planName, taskID: todo.id });
 }
 function notepadPathFor(directory, planName, taskID) {
   return join53(directory, PLAN_DIR_NAME, NOTEPAD_DIR_NAME, planName, TASKS_SUBDIR, `${taskID}${NOTEPAD_EXTENSION}`);
@@ -66453,7 +66527,7 @@ function createThinkingBlockValidatorHook() {
 init_logger();
 
 // src/hooks/todo-continuation-enforcer/constants.ts
-var HOOK_NAME17 = "todo-continuation-enforcer";
+var HOOK_NAME18 = "todo-continuation-enforcer";
 var DEFAULT_SKIP_AGENTS2 = ["oracle", "compaction"];
 var CONTINUATION_PROMPT3 = `${createSystemDirective(SystemDirectiveTypes.TODO_CONTINUATION)}
 
@@ -66518,21 +66592,21 @@ async function injectContinuation2(args) {
     sessionStateStore
   } = args;
   if (subagentSessions.has(sessionID)) {
-    log(`[${HOOK_NAME17}] Skipped injection: subagent session`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped injection: subagent session`, { sessionID });
     return;
   }
   const state3 = sessionStateStore.getExistingState(sessionID);
   if (state3?.isRecovering) {
-    log(`[${HOOK_NAME17}] Skipped injection: in recovery`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped injection: in recovery`, { sessionID });
     return;
   }
   if (isAwaitingUser(state3)) {
-    log(`[${HOOK_NAME17}] Skipped injection: awaiting user`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped injection: awaiting user`, { sessionID });
     return;
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME17}] Skipped injection: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped injection: background tasks running`, { sessionID });
     return;
   }
   let todos = [];
@@ -66540,12 +66614,12 @@ async function injectContinuation2(args) {
     const response = await ctx.client.session.todo({ path: { id: sessionID } });
     todos = normalizeSDKResponse(response, [], { preferResponseOnMissingData: true });
   } catch (error51) {
-    log(`[${HOOK_NAME17}] Failed to fetch todos`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME18}] Failed to fetch todos`, { sessionID, error: String(error51) });
     return;
   }
   const freshIncompleteCount = getIncompleteCount(todos);
   if (freshIncompleteCount === 0) {
-    log(`[${HOOK_NAME17}] Skipped injection: no incomplete todos`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped injection: no incomplete todos`, { sessionID });
     return;
   }
   let agentName = resolvedInfo?.agent;
@@ -66568,11 +66642,11 @@ async function injectContinuation2(args) {
     tools = tools ?? previousMessage?.tools;
   }
   if (agentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(agentName))) {
-    log(`[${HOOK_NAME17}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME18}] Skipped: agent in skipAgents list`, { sessionID, agent: agentName });
     return;
   }
   if (!hasWritePermission2(tools)) {
-    log(`[${HOOK_NAME17}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
+    log(`[${HOOK_NAME18}] Skipped: agent lacks write permission`, { sessionID, agent: agentName });
     return;
   }
   const incompleteTodos = todos.filter((todo) => todo.status !== "completed" && todo.status !== "cancelled");
@@ -66589,11 +66663,11 @@ ${todoList}`;
     injectionState.inFlight = true;
   }
   if (isAwaitingUser(sessionStateStore.getExistingState(sessionID))) {
-    log(`[${HOOK_NAME17}] Skipped injection: awaiting user (race)`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped injection: awaiting user (race)`, { sessionID });
     return;
   }
   try {
-    log(`[${HOOK_NAME17}] Injecting continuation`, {
+    log(`[${HOOK_NAME18}] Injecting continuation`, {
       sessionID,
       agent: agentName,
       model,
@@ -66608,14 +66682,14 @@ ${todoList}`;
       },
       query: { directory: ctx.directory }
     });
-    log(`[${HOOK_NAME17}] Injection successful`, { sessionID });
+    log(`[${HOOK_NAME18}] Injection successful`, { sessionID });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
       injectionState.consecutiveFailures = 0;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME17}] Injection failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME18}] Injection failed`, { sessionID, error: String(error51) });
     if (injectionState) {
       injectionState.inFlight = false;
       injectionState.lastInjectedAt = Date.now();
@@ -66649,7 +66723,7 @@ function startCountdown2(args) {
   } = args;
   const state3 = sessionStateStore.getState(sessionID);
   if (state3.countdownTimer || state3.countdownInterval) {
-    log(`[${HOOK_NAME17}] Skipped: countdown already active`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: countdown already active`, { sessionID });
     return;
   }
   let secondsRemaining = COUNTDOWN_SECONDS2;
@@ -66672,7 +66746,7 @@ function startCountdown2(args) {
       sessionStateStore
     });
   }, COUNTDOWN_SECONDS2 * 1000);
-  log(`[${HOOK_NAME17}] Countdown started`, {
+  log(`[${HOOK_NAME18}] Countdown started`, {
     sessionID,
     seconds: COUNTDOWN_SECONDS2,
     incompleteCount
@@ -66689,36 +66763,36 @@ async function handleSessionIdle2(args) {
     skipAgents = DEFAULT_SKIP_AGENTS2,
     isContinuationStopped
   } = args;
-  log(`[${HOOK_NAME17}] session.idle`, { sessionID });
+  log(`[${HOOK_NAME18}] session.idle`, { sessionID });
   if (subagentSessions.has(sessionID)) {
-    log(`[${HOOK_NAME17}] Skipped: subagent session`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: subagent session`, { sessionID });
     return;
   }
   const state3 = sessionStateStore.getState(sessionID);
   if (state3.countdownTimer || state3.countdownInterval) {
-    log(`[${HOOK_NAME17}] Skipped: countdown already active`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: countdown already active`, { sessionID });
     return;
   }
   if (state3.isRecovering) {
-    log(`[${HOOK_NAME17}] Skipped: in recovery`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: in recovery`, { sessionID });
     return;
   }
   if (state3.abortDetectedAt) {
     const timeSinceAbort = Date.now() - state3.abortDetectedAt;
     if (timeSinceAbort < ABORT_WINDOW_MS2) {
-      log(`[${HOOK_NAME17}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
+      log(`[${HOOK_NAME18}] Skipped: abort detected via event ${timeSinceAbort}ms ago`, { sessionID });
       state3.abortDetectedAt = undefined;
       return;
     }
     state3.abortDetectedAt = undefined;
   }
   if (isAwaitingUser(state3)) {
-    log(`[${HOOK_NAME17}] Skipped: awaiting user`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: awaiting user`, { sessionID });
     return;
   }
   const hasRunningBgTasks = backgroundManager ? backgroundManager.getTasksByParentSession(sessionID).some((task) => task.status === "running") : false;
   if (hasRunningBgTasks) {
-    log(`[${HOOK_NAME17}] Skipped: background tasks running`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: background tasks running`, { sessionID });
     return;
   }
   try {
@@ -66728,46 +66802,46 @@ async function handleSessionIdle2(args) {
     });
     const messages = normalizeSDKResponse(messagesResp, []);
     if (isLastAssistantMessageAborted2(messages)) {
-      log(`[${HOOK_NAME17}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
+      log(`[${HOOK_NAME18}] Skipped: last assistant message was aborted (API fallback)`, { sessionID });
       return;
     }
     if (isAwaitingUser(state3, messages)) {
-      log(`[${HOOK_NAME17}] Skipped: awaiting user (pending question)`, { sessionID });
+      log(`[${HOOK_NAME18}] Skipped: awaiting user (pending question)`, { sessionID });
       return;
     }
   } catch (error51) {
-    log(`[${HOOK_NAME17}] Messages fetch failed, continuing`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME18}] 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_NAME17}] Todo fetch failed`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME18}] Todo fetch failed`, { sessionID, error: String(error51) });
     return;
   }
   if (!todos || todos.length === 0) {
-    log(`[${HOOK_NAME17}] No todos`, { sessionID });
+    log(`[${HOOK_NAME18}] No todos`, { sessionID });
     return;
   }
   const incompleteCount = getIncompleteCount(todos);
   if (incompleteCount === 0) {
-    log(`[${HOOK_NAME17}] All todos complete`, { sessionID, total: todos.length });
+    log(`[${HOOK_NAME18}] All todos complete`, { sessionID, total: todos.length });
     return;
   }
   if (state3.inFlight) {
-    log(`[${HOOK_NAME17}] Skipped: injection in flight`, { sessionID });
+    log(`[${HOOK_NAME18}] 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_NAME17}] Reset consecutive failures after recovery window`, {
+    log(`[${HOOK_NAME18}] Reset consecutive failures after recovery window`, {
       sessionID,
       failureResetWindowMs: FAILURE_RESET_WINDOW_MS2
     });
   }
   if (state3.consecutiveFailures >= MAX_CONSECUTIVE_FAILURES2) {
-    log(`[${HOOK_NAME17}] Skipped: max consecutive failures reached`, {
+    log(`[${HOOK_NAME18}] Skipped: max consecutive failures reached`, {
       sessionID,
       consecutiveFailures: state3.consecutiveFailures,
       maxConsecutiveFailures: MAX_CONSECUTIVE_FAILURES2
@@ -66776,7 +66850,7 @@ async function handleSessionIdle2(args) {
   }
   const effectiveCooldown = CONTINUATION_COOLDOWN_MS4 * 2 ** Math.min(state3.consecutiveFailures, 5);
   if (state3.lastInjectedAt && Date.now() - state3.lastInjectedAt < effectiveCooldown) {
-    log(`[${HOOK_NAME17}] Skipped: cooldown active`, {
+    log(`[${HOOK_NAME18}] Skipped: cooldown active`, {
       sessionID,
       effectiveCooldown,
       consecutiveFailures: state3.consecutiveFailures
@@ -66806,24 +66880,24 @@ async function handleSessionIdle2(args) {
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME17}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME18}] Failed to fetch messages for agent check`, { sessionID, error: String(error51) });
   }
-  log(`[${HOOK_NAME17}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
+  log(`[${HOOK_NAME18}] Agent check`, { sessionID, agentName: resolvedInfo?.agent, skipAgents, hasCompactionMessage });
   const resolvedAgentName = resolvedInfo?.agent;
   if (resolvedAgentName && skipAgents.some((s) => getAgentConfigKey(s) === getAgentConfigKey(resolvedAgentName))) {
-    log(`[${HOOK_NAME17}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
+    log(`[${HOOK_NAME18}] Skipped: agent in skipAgents list`, { sessionID, agent: resolvedAgentName });
     return;
   }
   if (hasCompactionMessage && !resolvedInfo?.agent) {
-    log(`[${HOOK_NAME17}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: compaction occurred but no agent info resolved`, { sessionID });
     return;
   }
   if (isContinuationStopped?.(sessionID)) {
-    log(`[${HOOK_NAME17}] Skipped: continuation stopped for session`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: continuation stopped for session`, { sessionID });
     return;
   }
   if (isAwaitingUser(state3)) {
-    log(`[${HOOK_NAME17}] Skipped: awaiting user (race)`, { sessionID });
+    log(`[${HOOK_NAME18}] Skipped: awaiting user (race)`, { sessionID });
     return;
   }
   startCountdown2({
@@ -66855,7 +66929,7 @@ function handleNonIdleEvent2(args) {
       if (state3?.countdownStartedAt) {
         const elapsed = Date.now() - state3.countdownStartedAt;
         if (elapsed < COUNTDOWN_GRACE_PERIOD_MS2) {
-          log(`[${HOOK_NAME17}] Ignoring user message in grace period`, { sessionID, elapsed });
+          log(`[${HOOK_NAME18}] Ignoring user message in grace period`, { sessionID, elapsed });
           return;
         }
       }
@@ -66901,7 +66975,7 @@ function handleNonIdleEvent2(args) {
     const sessionInfo = properties?.info;
     if (sessionInfo?.id) {
       sessionStateStore.cleanup(sessionInfo.id);
-      log(`[${HOOK_NAME17}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
+      log(`[${HOOK_NAME18}] Session deleted: cleaned up`, { sessionID: sessionInfo.id });
     }
     return;
   }
@@ -66926,10 +67000,10 @@ function createTodoContinuationHandler(args) {
       if (error51?.name === "MessageAbortedError" || error51?.name === "AbortError") {
         const state3 = sessionStateStore.getState(sessionID);
         state3.abortDetectedAt = Date.now();
-        log(`[${HOOK_NAME17}] Abort detected via session.error`, { sessionID, errorName: error51.name });
+        log(`[${HOOK_NAME18}] Abort detected via session.error`, { sessionID, errorName: error51.name });
       }
       sessionStateStore.cancelCountdown(sessionID);
-      log(`[${HOOK_NAME17}] session.error`, { sessionID });
+      log(`[${HOOK_NAME18}] session.error`, { sessionID });
       return;
     }
     if (event.type === "session.idle") {
@@ -67047,13 +67121,13 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
     const state3 = sessionStateStore.getState(sessionID);
     state3.isRecovering = true;
     sessionStateStore.cancelCountdown(sessionID);
-    log(`[${HOOK_NAME17}] Session marked as recovering`, { sessionID });
+    log(`[${HOOK_NAME18}] Session marked as recovering`, { sessionID });
   };
   const markRecoveryComplete = (sessionID) => {
     const state3 = sessionStateStore.getExistingState(sessionID);
     if (state3) {
       state3.isRecovering = false;
-      log(`[${HOOK_NAME17}] Session recovery complete`, { sessionID });
+      log(`[${HOOK_NAME18}] Session recovery complete`, { sessionID });
     }
   };
   const handler = createTodoContinuationHandler({
@@ -67065,7 +67139,7 @@ function createTodoContinuationEnforcer(ctx, options = {}) {
   });
   const cancelAllCountdowns = () => {
     sessionStateStore.cancelAllCountdowns();
-    log(`[${HOOK_NAME17}] All countdowns cancelled`);
+    log(`[${HOOK_NAME18}] All countdowns cancelled`);
   };
   return {
     handler,
@@ -67299,7 +67373,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_NAME18 = "unstable-agent-babysitter";
+var HOOK_NAME19 = "unstable-agent-babysitter";
 var DEFAULT_TIMEOUT_MS = 120000;
 var COOLDOWN_MS = 5 * 60 * 1000;
 async function resolveMainSessionTarget(ctx, sessionID) {
@@ -67319,7 +67393,7 @@ async function resolveMainSessionTarget(ctx, sessionID) {
       }
     }
   } catch (error51) {
-    log(`[${HOOK_NAME18}] Failed to resolve main session agent`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME19}] Failed to resolve main session agent`, { sessionID, error: String(error51) });
   }
   return { agent, model };
 }
@@ -67352,7 +67426,7 @@ async function getThinkingSummary(ctx, sessionID) {
       return combined;
     return `${combined.slice(0, THINKING_SUMMARY_MAX_CHARS)}...`;
   } catch (error51) {
-    log(`[${HOOK_NAME18}] Failed to fetch thinking summary`, { sessionID, error: String(error51) });
+    log(`[${HOOK_NAME19}] Failed to fetch thinking summary`, { sessionID, error: String(error51) });
     return null;
   }
 }
@@ -67401,9 +67475,9 @@ function createUnstableAgentBabysitterHook(ctx, options) {
           query: { directory: ctx.directory }
         });
         reminderCooldowns.set(task.id, now);
-        log(`[${HOOK_NAME18}] Reminder injected`, { taskId: task.id, sessionID: mainSessionID });
+        log(`[${HOOK_NAME19}] Reminder injected`, { taskId: task.id, sessionID: mainSessionID });
       } catch (error51) {
-        log(`[${HOOK_NAME18}] Reminder injection failed`, { taskId: task.id, error: String(error51) });
+        log(`[${HOOK_NAME19}] Reminder injection failed`, { taskId: task.id, error: String(error51) });
       }
     }
   };
@@ -84356,8 +84430,13 @@ function createBddValidateContractTool() {
     }
   });
 }
-// src/tools/glob/cli.ts
-import { stat } from "fs/promises";
+// src/tools/github-search/cli.ts
+import { spawn as spawn11, spawnSync as spawnSync3 } from "child_process";
+import { existsSync as existsSync59, mkdirSync as mkdirSync17 } from "fs";
+import { tmpdir as tmpdir5 } from "os";
+import { join as join62 } from "path";
+
+// src/tools/grep/cli.ts
 var {spawn: spawn10 } = globalThis.Bun;
 
 // src/tools/grep/constants.ts
@@ -84552,8 +84631,367 @@ var RG_SAFETY_FLAGS = [
 ];
 var GREP_SAFETY_FLAGS = ["-n", "-H", "--color=never"];
 
-// src/tools/glob/constants.ts
+// src/tools/grep/cli.ts
+function buildRgArgs(options) {
+  const args = [
+    ...RG_SAFETY_FLAGS,
+    `--max-depth=${Math.min(options.maxDepth ?? DEFAULT_MAX_DEPTH, DEFAULT_MAX_DEPTH)}`,
+    `--max-filesize=${options.maxFilesize ?? DEFAULT_MAX_FILESIZE}`,
+    `--max-count=${Math.min(options.maxCount ?? DEFAULT_MAX_COUNT, DEFAULT_MAX_COUNT)}`,
+    `--max-columns=${Math.min(options.maxColumns ?? DEFAULT_MAX_COLUMNS, DEFAULT_MAX_COLUMNS)}`
+  ];
+  if (options.context !== undefined && options.context > 0) {
+    args.push(`-C${Math.min(options.context, 10)}`);
+  }
+  if (options.caseSensitive)
+    args.push("--case-sensitive");
+  if (options.wholeWord)
+    args.push("-w");
+  if (options.fixedStrings)
+    args.push("-F");
+  if (options.multiline)
+    args.push("-U");
+  if (options.hidden)
+    args.push("--hidden");
+  if (options.noIgnore)
+    args.push("--no-ignore");
+  if (options.fileType?.length) {
+    for (const type of options.fileType) {
+      args.push(`--type=${type}`);
+    }
+  }
+  if (options.globs) {
+    for (const glob of options.globs) {
+      args.push(`--glob=${glob}`);
+    }
+  }
+  if (options.excludeGlobs) {
+    for (const glob of options.excludeGlobs) {
+      args.push(`--glob=!${glob}`);
+    }
+  }
+  return args;
+}
+function buildGrepArgs(options) {
+  const args = [...GREP_SAFETY_FLAGS, "-r"];
+  if (options.context !== undefined && options.context > 0) {
+    args.push(`-C${Math.min(options.context, 10)}`);
+  }
+  if (!options.caseSensitive)
+    args.push("-i");
+  if (options.wholeWord)
+    args.push("-w");
+  if (options.fixedStrings)
+    args.push("-F");
+  if (options.globs?.length) {
+    for (const glob of options.globs) {
+      args.push(`--include=${glob}`);
+    }
+  }
+  if (options.excludeGlobs?.length) {
+    for (const glob of options.excludeGlobs) {
+      args.push(`--exclude=${glob}`);
+    }
+  }
+  args.push("--exclude-dir=.git", "--exclude-dir=node_modules");
+  return args;
+}
+function buildArgs(options, backend) {
+  return backend === "rg" ? buildRgArgs(options) : buildGrepArgs(options);
+}
+function parseOutput(output) {
+  if (!output.trim())
+    return [];
+  const matches = [];
+  const lines = output.split(`
+`);
+  for (const line of lines) {
+    if (!line.trim())
+      continue;
+    const match = line.match(/^(.+?):(\d+):(.*)$/);
+    if (match) {
+      matches.push({
+        file: match[1],
+        line: parseInt(match[2], 10),
+        text: match[3]
+      });
+    }
+  }
+  return matches;
+}
+async function runRg(options) {
+  const cli = resolveGrepCli();
+  const args = buildArgs(options, cli.backend);
+  const timeout = Math.min(options.timeout ?? DEFAULT_TIMEOUT_MS3, DEFAULT_TIMEOUT_MS3);
+  if (cli.backend === "rg") {
+    args.push("--", options.pattern);
+  } else {
+    args.push("-e", options.pattern);
+  }
+  const paths = options.paths?.length ? options.paths : ["."];
+  args.push(...paths);
+  const proc = spawn10([cli.path, ...args], {
+    stdout: "pipe",
+    stderr: "pipe"
+  });
+  const timeoutPromise = new Promise((_, reject) => {
+    const id = setTimeout(() => {
+      proc.kill();
+      reject(new Error(`Search timeout after ${timeout}ms`));
+    }, timeout);
+    proc.exited.then(() => clearTimeout(id));
+  });
+  try {
+    const stdout = await Promise.race([new Response(proc.stdout).text(), timeoutPromise]);
+    const stderr = await new Response(proc.stderr).text();
+    const exitCode = await proc.exited;
+    const truncated = stdout.length >= DEFAULT_MAX_OUTPUT_BYTES2;
+    const outputToProcess = truncated ? stdout.substring(0, DEFAULT_MAX_OUTPUT_BYTES2) : stdout;
+    if (exitCode > 1 && stderr.trim()) {
+      return {
+        matches: [],
+        totalMatches: 0,
+        filesSearched: 0,
+        truncated: false,
+        error: stderr.trim()
+      };
+    }
+    const matches = parseOutput(outputToProcess);
+    const filesSearched = new Set(matches.map((m) => m.file)).size;
+    return {
+      matches,
+      totalMatches: matches.length,
+      filesSearched,
+      truncated
+    };
+  } catch (e) {
+    return {
+      matches: [],
+      totalMatches: 0,
+      filesSearched: 0,
+      truncated: false,
+      error: e instanceof Error ? e.message : String(e)
+    };
+  }
+}
+
+// src/tools/github-search/constants.ts
 var DEFAULT_TIMEOUT_MS4 = 60000;
+var DEFAULT_MAX_OUTPUT_CHARS = 20000;
+var MAX_LIMIT = 30;
+var CLONE_DEPTH = 1;
+var TMP_PREFIX = "matrixx-gh-";
+
+// src/tools/github-search/cli.ts
+function findExecutable2(name) {
+  const cmd = process.platform === "win32" ? "where" : "which";
+  try {
+    const result = spawnSync3(cmd, [name], { encoding: "utf-8", timeout: 5000 });
+    if (result.status === 0 && result.stdout.trim()) {
+      return result.stdout.trim().split(`
+`)[0]?.trim() ?? null;
+    }
+  } catch {}
+  return null;
+}
+async function runCmd(cmd, args, cwd, timeout) {
+  const proc = spawn11(cmd, args, { cwd, timeout });
+  let stdout = "";
+  let stderr = "";
+  proc.stdout?.on("data", (d) => {
+    stdout += d.toString();
+  });
+  proc.stderr?.on("data", (d) => {
+    stderr += d.toString();
+  });
+  const exitCode = await new Promise((resolve8) => {
+    const timer = setTimeout(() => {
+      try {
+        proc.kill();
+      } catch {}
+      resolve8(124);
+    }, timeout);
+    proc.on("close", (code) => {
+      clearTimeout(timer);
+      resolve8(code ?? 0);
+    });
+    proc.on("error", () => {
+      clearTimeout(timer);
+      resolve8(127);
+    });
+  });
+  return { stdout, stderr, exitCode };
+}
+function sanitizeRepo(repo) {
+  return repo.replace(/[^a-zA-Z0-9-_]/g, "-").slice(0, 80);
+}
+function parseGhSearchOutput(stdout, fallbackRepo) {
+  const trimmed = stdout.trim();
+  if (!trimmed)
+    return [];
+  try {
+    const parsed = JSON.parse(trimmed);
+    const items = Array.isArray(parsed) ? parsed : [];
+    return items.map((item) => ({
+      repo: item.repository?.nameWithOwner ?? fallbackRepo,
+      path: item.path ?? "",
+      sha: item.sha,
+      url: item.url
+    }));
+  } catch {
+    return [];
+  }
+}
+async function codeSearch(query, repo, language, limit) {
+  const gh = findExecutable2("gh");
+  if (!gh) {
+    return {
+      hits: [],
+      truncated: false,
+      mode: "code-search",
+      error: "gh CLI not found in PATH. Install from https://cli.github.com and authenticate with `gh auth login`."
+    };
+  }
+  const parts = [query];
+  if (language)
+    parts.push(`language:${language}`);
+  if (repo)
+    parts.push(`repo:${repo}`);
+  const searchQuery = parts.join(" ");
+  const capped = Math.min(Math.max(limit, 1), MAX_LIMIT);
+  const args = ["search", "code", searchQuery, "--limit", String(capped), "--json", "repository,path,sha,url"];
+  const { stdout, stderr, exitCode } = await runCmd(gh, args, process.cwd(), DEFAULT_TIMEOUT_MS4);
+  if (exitCode !== 0) {
+    const hint = /auth|login|token/i.test(stderr) ? " Run `gh auth login` and retry." : "";
+    return {
+      hits: [],
+      truncated: false,
+      mode: "code-search",
+      error: `gh search code failed: ${stderr.trim() || `exit ${exitCode}`}.${hint}`
+    };
+  }
+  const hits = parseGhSearchOutput(stdout, repo ?? "").slice(0, capped);
+  return { hits, truncated: false, mode: "code-search" };
+}
+async function cloneAndSearch(query, repo) {
+  const gh = findExecutable2("gh");
+  const git = findExecutable2("git");
+  const cloneBin = gh ?? git;
+  if (!cloneBin) {
+    return {
+      hits: [],
+      truncated: false,
+      mode: "clone-search",
+      error: "Neither gh nor git found in PATH. Install GitHub CLI (https://cli.github.com) or git."
+    };
+  }
+  const dest = join62(tmpdir5(), `${TMP_PREFIX}${sanitizeRepo(repo)}`);
+  if (!existsSync59(dest)) {
+    mkdirSync17(dest, { recursive: true });
+    const cloneArgs = gh ? ["repo", "clone", repo, dest, "--", "--depth", String(CLONE_DEPTH)] : ["clone", "--depth", String(CLONE_DEPTH), `https://github.com/${repo}.git`, dest];
+    const cloned = await runCmd(cloneBin, cloneArgs, process.cwd(), DEFAULT_TIMEOUT_MS4);
+    if (cloned.exitCode !== 0) {
+      return {
+        hits: [],
+        truncated: false,
+        mode: "clone-search",
+        error: `Clone failed for ${repo}: ${cloned.stderr.trim() || `exit ${cloned.exitCode}`}`
+      };
+    }
+  }
+  const shaRes = await runCmd("git", ["rev-parse", "HEAD"], dest, 15000);
+  const sha = shaRes.exitCode === 0 ? shaRes.stdout.trim() : undefined;
+  const rgResult = await runRg({ pattern: query, paths: [dest], context: 0 });
+  if (rgResult.error) {
+    return { hits: [], truncated: false, mode: "clone-search", error: rgResult.error };
+  }
+  const hits = rgResult.matches.map((m) => {
+    const rel = m.file.startsWith(dest) ? m.file.slice(dest.length + 1) : m.file;
+    return {
+      repo,
+      path: rel,
+      sha,
+      line: m.line,
+      text: m.text,
+      url: sha ? `https://github.com/${repo}/blob/${sha}/${rel}#L${m.line}` : undefined
+    };
+  });
+  return { hits, truncated: rgResult.truncated, mode: "clone-search" };
+}
+async function githubSearch(opts) {
+  const query = opts.query.trim();
+  if (!query) {
+    return { hits: [], truncated: false, mode: "code-search", error: "query must not be empty" };
+  }
+  if (opts.repo) {
+    return cloneAndSearch(query, opts.repo.trim());
+  }
+  return codeSearch(query, undefined, opts.language?.trim() || undefined, opts.limit ?? 10);
+}
+
+// src/tools/github-search/result-formatter.ts
+function formatGithubSearchResult(result) {
+  if (result.error) {
+    return `Error: ${result.error}`;
+  }
+  if (result.hits.length === 0) {
+    return "No matches found";
+  }
+  const lines = [];
+  lines.push(`Found ${result.hits.length} match(es) [${result.mode}]`);
+  lines.push("");
+  for (const hit of result.hits) {
+    const loc = hit.line ? `${hit.path}#L${hit.line}` : hit.path;
+    lines.push(`${hit.repo} ${loc}`);
+    if (hit.url)
+      lines.push(`  ${hit.url}`);
+    if (hit.text?.trim())
+      lines.push(`  ${hit.text.trim().slice(0, 300)}`);
+    lines.push("");
+  }
+  let out = lines.join(`
+`);
+  if (out.length > DEFAULT_MAX_OUTPUT_CHARS) {
+    out = `${out.slice(0, DEFAULT_MAX_OUTPUT_CHARS)}
+[Output truncated due to size limit]`;
+  } else if (result.truncated) {
+    out += "[Output truncated due to size limit]";
+  }
+  return out;
+}
+
+// src/tools/github-search/tools.ts
+function createGithubSearchTools(_ctx) {
+  const github_search = tool({
+    description: "Search public GitHub code using local CLIs only (gh, git, rg). " + "No third-party remote services. " + "Without repo: runs `gh search code` for discovery. " + "With repo (owner/name): clones shallow to TMPDIR and searches locally with permalinks. " + "Requires gh CLI + auth for discovery (`gh auth login`).",
+    args: {
+      query: tool.schema.string().describe('Code pattern to search for (e.g. "useQuery(", "staleTime:")'),
+      repo: tool.schema.string().optional().describe('Repository in owner/name format for deep local search (e.g. "tanstack/query")'),
+      language: tool.schema.string().optional().describe('Language filter for discovery mode (e.g. "TypeScript")'),
+      limit: tool.schema.number().optional().describe(`Max results for discovery mode (1-${MAX_LIMIT}, default 10)`)
+    },
+    execute: async (args) => {
+      try {
+        const result = await githubSearch({
+          query: args.query,
+          repo: args.repo,
+          language: args.language,
+          limit: args.limit
+        });
+        return formatGithubSearchResult(result);
+      } catch (e) {
+        return `Error: ${e instanceof Error ? e.message : String(e)}`;
+      }
+    }
+  });
+  return { github_search };
+}
+// src/tools/glob/cli.ts
+import { stat } from "fs/promises";
+var {spawn: spawn12 } = globalThis.Bun;
+
+// src/tools/glob/constants.ts
+var DEFAULT_TIMEOUT_MS5 = 60000;
 var DEFAULT_LIMIT = 100;
 var DEFAULT_MAX_DEPTH2 = 20;
 var DEFAULT_MAX_OUTPUT_BYTES3 = 10 * 1024 * 1024;
@@ -84564,7 +85002,7 @@ var RG_FILES_FLAGS = [
 ];
 
 // src/tools/glob/cli.ts
-function buildRgArgs(options) {
+function buildRgArgs2(options) {
   const args = [
     ...RG_FILES_FLAGS,
     `--max-depth=${Math.min(options.maxDepth ?? DEFAULT_MAX_DEPTH2, DEFAULT_MAX_DEPTH2)}`
@@ -84616,14 +85054,14 @@ async function getFileMtime(filePath) {
 }
 async function runRgFiles(options, resolvedCli) {
   const cli = resolvedCli ?? resolveGrepCli();
-  const timeout = Math.min(options.timeout ?? DEFAULT_TIMEOUT_MS4, DEFAULT_TIMEOUT_MS4);
+  const timeout = Math.min(options.timeout ?? DEFAULT_TIMEOUT_MS5, DEFAULT_TIMEOUT_MS5);
   const limit = Math.min(options.limit ?? DEFAULT_LIMIT, DEFAULT_LIMIT);
   const isRg = cli.backend === "rg";
   const isWindows = process.platform === "win32";
   let command;
   let cwd;
   if (isRg) {
-    const args = buildRgArgs(options);
+    const args = buildRgArgs2(options);
     const paths = options.paths?.length ? options.paths : ["."];
     args.push(...paths);
     command = [cli.path, ...args];
@@ -84637,7 +85075,7 @@ async function runRgFiles(options, resolvedCli) {
     cwd = paths[0] || ".";
     command = [cli.path, ...args];
   }
-  const proc = spawn10(command, {
+  const proc = spawn12(command, {
     stdout: "pipe",
     stderr: "pipe",
     cwd
@@ -84746,151 +85184,6 @@ function createGlobTools(ctx) {
   });
   return { glob };
 }
-// src/tools/grep/cli.ts
-var {spawn: spawn11 } = globalThis.Bun;
-function buildRgArgs2(options) {
-  const args = [
-    ...RG_SAFETY_FLAGS,
-    `--max-depth=${Math.min(options.maxDepth ?? DEFAULT_MAX_DEPTH, DEFAULT_MAX_DEPTH)}`,
-    `--max-filesize=${options.maxFilesize ?? DEFAULT_MAX_FILESIZE}`,
-    `--max-count=${Math.min(options.maxCount ?? DEFAULT_MAX_COUNT, DEFAULT_MAX_COUNT)}`,
-    `--max-columns=${Math.min(options.maxColumns ?? DEFAULT_MAX_COLUMNS, DEFAULT_MAX_COLUMNS)}`
-  ];
-  if (options.context !== undefined && options.context > 0) {
-    args.push(`-C${Math.min(options.context, 10)}`);
-  }
-  if (options.caseSensitive)
-    args.push("--case-sensitive");
-  if (options.wholeWord)
-    args.push("-w");
-  if (options.fixedStrings)
-    args.push("-F");
-  if (options.multiline)
-    args.push("-U");
-  if (options.hidden)
-    args.push("--hidden");
-  if (options.noIgnore)
-    args.push("--no-ignore");
-  if (options.fileType?.length) {
-    for (const type of options.fileType) {
-      args.push(`--type=${type}`);
-    }
-  }
-  if (options.globs) {
-    for (const glob of options.globs) {
-      args.push(`--glob=${glob}`);
-    }
-  }
-  if (options.excludeGlobs) {
-    for (const glob of options.excludeGlobs) {
-      args.push(`--glob=!${glob}`);
-    }
-  }
-  return args;
-}
-function buildGrepArgs(options) {
-  const args = [...GREP_SAFETY_FLAGS, "-r"];
-  if (options.context !== undefined && options.context > 0) {
-    args.push(`-C${Math.min(options.context, 10)}`);
-  }
-  if (!options.caseSensitive)
-    args.push("-i");
-  if (options.wholeWord)
-    args.push("-w");
-  if (options.fixedStrings)
-    args.push("-F");
-  if (options.globs?.length) {
-    for (const glob of options.globs) {
-      args.push(`--include=${glob}`);
-    }
-  }
-  if (options.excludeGlobs?.length) {
-    for (const glob of options.excludeGlobs) {
-      args.push(`--exclude=${glob}`);
-    }
-  }
-  args.push("--exclude-dir=.git", "--exclude-dir=node_modules");
-  return args;
-}
-function buildArgs(options, backend) {
-  return backend === "rg" ? buildRgArgs2(options) : buildGrepArgs(options);
-}
-function parseOutput(output) {
-  if (!output.trim())
-    return [];
-  const matches = [];
-  const lines = output.split(`
-`);
-  for (const line of lines) {
-    if (!line.trim())
-      continue;
-    const match = line.match(/^(.+?):(\d+):(.*)$/);
-    if (match) {
-      matches.push({
-        file: match[1],
-        line: parseInt(match[2], 10),
-        text: match[3]
-      });
-    }
-  }
-  return matches;
-}
-async function runRg(options) {
-  const cli = resolveGrepCli();
-  const args = buildArgs(options, cli.backend);
-  const timeout = Math.min(options.timeout ?? DEFAULT_TIMEOUT_MS3, DEFAULT_TIMEOUT_MS3);
-  if (cli.backend === "rg") {
-    args.push("--", options.pattern);
-  } else {
-    args.push("-e", options.pattern);
-  }
-  const paths = options.paths?.length ? options.paths : ["."];
-  args.push(...paths);
-  const proc = spawn11([cli.path, ...args], {
-    stdout: "pipe",
-    stderr: "pipe"
-  });
-  const timeoutPromise = new Promise((_, reject) => {
-    const id = setTimeout(() => {
-      proc.kill();
-      reject(new Error(`Search timeout after ${timeout}ms`));
-    }, timeout);
-    proc.exited.then(() => clearTimeout(id));
-  });
-  try {
-    const stdout = await Promise.race([new Response(proc.stdout).text(), timeoutPromise]);
-    const stderr = await new Response(proc.stderr).text();
-    const exitCode = await proc.exited;
-    const truncated = stdout.length >= DEFAULT_MAX_OUTPUT_BYTES2;
-    const outputToProcess = truncated ? stdout.substring(0, DEFAULT_MAX_OUTPUT_BYTES2) : stdout;
-    if (exitCode > 1 && stderr.trim()) {
-      return {
-        matches: [],
-        totalMatches: 0,
-        filesSearched: 0,
-        truncated: false,
-        error: stderr.trim()
-      };
-    }
-    const matches = parseOutput(outputToProcess);
-    const filesSearched = new Set(matches.map((m) => m.file)).size;
-    return {
-      matches,
-      totalMatches: matches.length,
-      filesSearched,
-      truncated
-    };
-  } catch (e) {
-    return {
-      matches: [],
-      totalMatches: 0,
-      filesSearched: 0,
-      truncated: false,
-      error: e instanceof Error ? e.message : String(e)
-    };
-  }
-}
-
 // src/tools/grep/result-formatter.ts
 function formatGrepResult(result) {
   if (result.error) {
@@ -84992,17 +85285,17 @@ var HandoffSchema = exports_external.object({
   sections: HandoffSectionSchema
 });
 // src/features/handoff/storage.ts
-import { existsSync as existsSync59, mkdirSync as mkdirSync17, readFileSync as readFileSync40, renameSync as renameSync4, writeFileSync as writeFileSync22 } from "fs";
-import { join as join62 } from "path";
+import { existsSync as existsSync60, mkdirSync as mkdirSync18, readFileSync as readFileSync40, renameSync as renameSync4, writeFileSync as writeFileSync22 } from "fs";
+import { join as join63 } from "path";
 function getHandoffFilePath(directory) {
-  return join62(directory, HANDOFF_FILE_PATH);
+  return join63(directory, HANDOFF_FILE_PATH);
 }
 function getHandoffConsumedFilePath(directory) {
-  return join62(directory, HANDOFF_CONSUMED_FILE_PATH);
+  return join63(directory, HANDOFF_CONSUMED_FILE_PATH);
 }
 function handoffFileExists(directory) {
   try {
-    return existsSync59(getHandoffFilePath(directory));
+    return existsSync60(getHandoffFilePath(directory));
   } catch {
     return false;
   }
@@ -85010,7 +85303,7 @@ function handoffFileExists(directory) {
 function readHandoffFile(directory) {
   const filePath = getHandoffFilePath(directory);
   try {
-    if (!existsSync59(filePath))
+    if (!existsSync60(filePath))
       return null;
     return readFileSync40(filePath, "utf-8");
   } catch {
@@ -85036,7 +85329,7 @@ function writeHandoffFile(directory, content) {
 }
 function ensureHandoffDir(directory) {
   try {
-    mkdirSync17(join62(directory, ".matrixx"), { recursive: true });
+    mkdirSync18(join63(directory, ".matrixx"), { recursive: true });
     return true;
   } catch {
     return false;
@@ -85191,15 +85484,15 @@ ${body}
 }
 
 // src/tools/handoff/list-handler.ts
-import { existsSync as existsSync60, readdirSync as readdirSync19, statSync as statSync12 } from "fs";
-import { join as join63 } from "path";
+import { existsSync as existsSync61, readdirSync as readdirSync19, statSync as statSync12 } from "fs";
+import { join as join64 } from "path";
 var MATRIX_DIR = ".matrixx";
 function isHandoffFile(name) {
   return name === "handoff.md" || name.startsWith("handoff.consumed");
 }
 function handleList(directory) {
-  const matrixxDir = join63(directory, MATRIX_DIR);
-  if (!existsSync60(matrixxDir)) {
+  const matrixxDir = join64(directory, MATRIX_DIR);
+  if (!existsSync61(matrixxDir)) {
     return "No handoffs found in .matrixx/";
   }
   let entries;
@@ -85216,7 +85509,7 @@ function handleList(directory) {
   lines.push(`Handoff files in ${matrixxDir}:`);
   lines.push("");
   for (const name of handoffs) {
-    const fullPath = join63(matrixxDir, name);
+    const fullPath = join64(matrixxDir, name);
     let size = "?";
     let mtime = "?";
     try {
@@ -85313,7 +85606,7 @@ function createHandoffTools(ctx) {
 init_logger();
 
 // src/tools/interactive-bash/constants.ts
-var DEFAULT_TIMEOUT_MS5 = 60000;
+var DEFAULT_TIMEOUT_MS6 = 60000;
 var BLOCKED_TMUX_SUBCOMMANDS = [
   "capture-pane",
   "capturep",
@@ -85410,7 +85703,7 @@ The Bash tool can execute these commands directly. Do NOT retry with interactive
       });
       const timeoutPromise = new Promise((_, reject) => {
         const id = setTimeout(() => {
-          const timeoutError = new Error(`Timeout after ${DEFAULT_TIMEOUT_MS5}ms`);
+          const timeoutError = new Error(`Timeout after ${DEFAULT_TIMEOUT_MS6}ms`);
           try {
             proc.kill();
             proc.exited.catch((err) => {
@@ -85418,7 +85711,7 @@ The Bash tool can execute these commands directly. Do NOT retry with interactive
             });
           } catch {}
           reject(timeoutError);
-        }, DEFAULT_TIMEOUT_MS5);
+        }, DEFAULT_TIMEOUT_MS6);
         proc.exited.then(() => clearTimeout(id)).catch(() => clearTimeout(id));
       });
       const [stdout, stderr, exitCode] = await Promise.race([
@@ -85440,9 +85733,9 @@ The Bash tool can execute these commands directly. Do NOT retry with interactive
   }
 });
 // src/tools/pdf-extract-figures/tools.ts
-import { existsSync as existsSync61, mkdtempSync, writeFileSync as writeFileSync23 } from "fs";
-import { tmpdir as tmpdir5 } from "os";
-import { join as join64 } from "path";
+import { existsSync as existsSync62, mkdtempSync, writeFileSync as writeFileSync23 } from "fs";
+import { tmpdir as tmpdir6 } from "os";
+import { join as join65 } from "path";
 var PYTHON_SCRIPT = `#!/usr/bin/env python3
 import sys
 import json
@@ -85544,7 +85837,7 @@ function validateArgs(args) {
   if (!args.file_path) {
     return "Error: 'file_path' is required.";
   }
-  if (!existsSync61(args.file_path)) {
+  if (!existsSync62(args.file_path)) {
     return `Error: File not found: ${args.file_path}`;
   }
   if (!args.file_path.toLowerCase().endsWith(".pdf")) {
@@ -85593,11 +85886,11 @@ async function runExtraction(args) {
   }
   let tmpDir;
   try {
-    tmpDir = mkdtempSync(join64(tmpdir5(), "matrixx-pdf-extract-"));
+    tmpDir = mkdtempSync(join65(tmpdir6(), "matrixx-pdf-extract-"));
   } catch {
     return "Error: Could not create temporary directory.";
   }
-  const scriptPath = join64(tmpDir, "extract_pdf_figures.py");
+  const scriptPath = join65(tmpDir, "extract_pdf_figures.py");
   writeFileSync23(scriptPath, PYTHON_SCRIPT);
   const payload = buildArgsPayload(args);
   log("[pdf_extract_figures] Running extraction", { file_path: args.file_path, payload });
@@ -85645,11 +85938,11 @@ function createPdfExtractFiguresTool() {
   return { pdf_extract_figures };
 }
 // src/tools/plan/plan-create.ts
-import { existsSync as existsSync62 } from "fs";
+import { existsSync as existsSync63 } from "fs";
 import { basename as basename7 } from "path";
 
 // src/tools/plan/types.ts
-import { basename as basename6, isAbsolute as isAbsolute5, join as join65, relative as relative4, resolve as resolve8 } from "path";
+import { basename as basename6, isAbsolute as isAbsolute5, join as join66, relative as relative4, resolve as resolve8 } from "path";
 
 // src/tools/plan/constants.ts
 var PLANS_DIR3 = ".matrixx/plans";
@@ -85675,8 +85968,8 @@ function validatePlanFilePath(filePath, directory) {
   if (!PLAN_FILENAME_KEBAB_REGEX.test(base)) {
     return { error: `fileName must match kebab-case ^[a-z0-9-]+\\.md$: ${base}` };
   }
-  const resolved = isAbsolute5(filePath) ? resolve8(filePath) : resolve8(join65(directory, filePath));
-  const plansDir = resolve8(join65(directory, PLANS_DIR3));
+  const resolved = isAbsolute5(filePath) ? resolve8(filePath) : resolve8(join66(directory, filePath));
+  const plansDir = resolve8(join66(directory, PLANS_DIR3));
   const relToPlans = relative4(plansDir, resolved);
   if (relToPlans.startsWith("..") || isAbsolute5(relToPlans)) {
     return { error: `filePath must be inside ${PLANS_DIR3}: ${filePath}` };
@@ -85719,7 +86012,7 @@ Uses atomicWrite (.tmp.pid+rename) + upsertMetadataComment. Warns if file alread
         }
         const resolved = validation.resolved;
         ensurePlanDir(directory);
-        if (existsSync62(resolved)) {
+        if (existsSync63(resolved)) {
           return JSON.stringify({
             error: "file_exists",
             message: `Plan file already exists: ${resolved}. Use plan_read + plan_update to modify.`,
@@ -85750,7 +86043,7 @@ Uses atomicWrite (.tmp.pid+rename) + upsertMetadataComment. Warns if file alread
   });
 }
 // src/tools/plan/plan-delete.ts
-import { existsSync as existsSync63, unlinkSync as unlinkSync10 } from "fs";
+import { existsSync as existsSync64, unlinkSync as unlinkSync10 } from "fs";
 function createPlanDeleteTool(ctx) {
   return tool({
     description: `Delete a plan file under .matrixx/plans/*.md. Scoped unlink inside PLANS_DIR, refuses outside paths.`,
@@ -85766,7 +86059,7 @@ function createPlanDeleteTool(ctx) {
           return JSON.stringify({ error: "invalid_file_path", message: validation.error });
         }
         const resolved = validation.resolved;
-        if (!existsSync63(resolved)) {
+        if (!existsSync64(resolved)) {
           return JSON.stringify({ error: "file_not_found", message: `File not found: ${resolved}` });
         }
         unlinkSync10(resolved);
@@ -85779,8 +86072,8 @@ function createPlanDeleteTool(ctx) {
   });
 }
 // src/tools/plan/plan-list.ts
-import { existsSync as existsSync64, readdirSync as readdirSync20, statSync as statSync13 } from "fs";
-import { join as join66 } from "path";
+import { existsSync as existsSync65, readdirSync as readdirSync20, statSync as statSync13 } from "fs";
+import { join as join67 } from "path";
 function createPlanListTool(ctx) {
   return tool({
     description: `List plan files under .matrixx/plans/*.md. Filters *.md with kebab-case, sorts by mtime.`,
@@ -85788,13 +86081,13 @@ function createPlanListTool(ctx) {
     execute: async (_args, context) => {
       try {
         const directory = resolveDirectory(context?.directory, ctx?.directory);
-        const plansDir = join66(directory, PLANS_DIR3);
-        if (!existsSync64(plansDir)) {
+        const plansDir = join67(directory, PLANS_DIR3);
+        if (!existsSync65(plansDir)) {
           return JSON.stringify({ plans: [] });
         }
         const entries = readdirSync20(plansDir).filter((f) => f.endsWith(".md") && PLAN_FILENAME_KEBAB_REGEX.test(f));
         const plans = entries.map((fileName) => {
-          const filePath = join66(plansDir, fileName);
+          const filePath = join67(plansDir, fileName);
           try {
             const stat2 = statSync13(filePath);
             return {
@@ -85817,7 +86110,7 @@ function createPlanListTool(ctx) {
   });
 }
 // src/tools/plan/plan-read.ts
-import { existsSync as existsSync65, statSync as statSync14 } from "fs";
+import { existsSync as existsSync66, statSync as statSync14 } from "fs";
 function createPlanReadTool(ctx) {
   return tool({
     description: `Read a plan file from .matrixx/plans/*.md with hashline-tagged output (1#AB|content) + lsp-style. Enforces scoping and ${MAX_PLAN_FILE_BYTES2} byte cap.`,
@@ -85833,7 +86126,7 @@ function createPlanReadTool(ctx) {
           return JSON.stringify({ error: "invalid_file_path", message: validation.error });
         }
         const resolved = validation.resolved;
-        if (!existsSync65(resolved)) {
+        if (!existsSync66(resolved)) {
           return JSON.stringify({ error: "file_not_found", message: `File not found: ${resolved}` });
         }
         try {
@@ -85865,7 +86158,7 @@ function createPlanReadTool(ctx) {
   });
 }
 // src/tools/plan/plan-update.ts
-import { existsSync as existsSync66 } from "fs";
+import { existsSync as existsSync67 } from "fs";
 
 // src/features/tool-metadata-store/store.ts
 var pendingStore = new Map;
@@ -86928,7 +87221,7 @@ function createPlanUpdateTool(ctx) {
           return JSON.stringify({ error: "invalid_file_path", message: validation.error });
         }
         const resolved = validation.resolved;
-        if (!existsSync66(resolved)) {
+        if (!existsSync67(resolved)) {
           return JSON.stringify({ error: "file_not_found", message: `File not found: ${resolved}` });
         }
         const result = await executeHashlineEditTool({ filePath: resolved, edits }, context, ctx);
@@ -86941,17 +87234,17 @@ function createPlanUpdateTool(ctx) {
   });
 }
 // src/tools/preset/tools.ts
-import { existsSync as existsSync67, mkdirSync as mkdirSync18, readFileSync as readFileSync41, writeFileSync as writeFileSync24 } from "fs";
+import { existsSync as existsSync68, mkdirSync as mkdirSync19, readFileSync as readFileSync41, writeFileSync as writeFileSync24 } from "fs";
 import { homedir as homedir10 } from "os";
-import { dirname as dirname15, join as join67 } from "path";
+import { dirname as dirname15, join as join68 } from "path";
 
 // src/features/preset-state/manager.ts
 init_logger();
-var HOOK_NAME19 = "preset-state";
+var HOOK_NAME20 = "preset-state";
 var presetBySession = new Map;
 function setSessionPreset(sessionID, presetName) {
   presetBySession.set(sessionID, presetName);
-  log(`[${HOOK_NAME19}] Preset set for session`, { sessionID, presetName });
+  log(`[${HOOK_NAME20}] Preset set for session`, { sessionID, presetName });
 }
 function getSessionPreset(sessionID) {
   return presetBySession.get(sessionID);
@@ -86962,14 +87255,14 @@ var ACTIONS = ["list", "show", "set"];
 var SCOPES = ["global", "project"];
 function resolveConfigPath(scope, directory) {
   if (scope === "global") {
-    return join67(homedir10(), ".config", "opencode", "matrixx.jsonc");
+    return join68(homedir10(), ".config", "opencode", "matrixx.jsonc");
   }
-  return join67(directory ?? process.cwd(), ".opencode", "matrixx.jsonc");
+  return join68(directory ?? process.cwd(), ".opencode", "matrixx.jsonc");
 }
 function persistActivePreset(presetName, scope, directory) {
   const configPath = resolveConfigPath(scope, directory);
   let raw = {};
-  if (existsSync67(configPath)) {
+  if (existsSync68(configPath)) {
     const content = readFileSync41(configPath, "utf-8");
     const parsed = parseJsoncSafe(content);
     if (parsed.errors.length > 0) {
@@ -86980,7 +87273,7 @@ function persistActivePreset(presetName, scope, directory) {
     }
     raw = parsed.data ?? {};
   } else {
-    mkdirSync18(dirname15(configPath), { recursive: true });
+    mkdirSync19(dirname15(configPath), { recursive: true });
   }
   raw.active_preset = presetName;
   writeFileSync24(configPath, `${JSON.stringify(raw, null, 2)}
@@ -87083,9 +87376,9 @@ function createPresetTool(options) {
   return { preset };
 }
 // src/tools/session-manager/constants.ts
-import { join as join68 } from "path";
-var TODO_DIR = join68(getOpenCodeConfigDir({ binary: "opencode" }), "todos");
-var TRANSCRIPT_DIR2 = join68(getOpenCodeConfigDir({ binary: "opencode" }), "transcripts");
+import { join as join69 } from "path";
+var TODO_DIR = join69(getOpenCodeConfigDir({ binary: "opencode" }), "todos");
+var TRANSCRIPT_DIR2 = join69(getOpenCodeConfigDir({ binary: "opencode" }), "transcripts");
 var SESSION_LIST_DESCRIPTION = `List all OpenCode sessions with optional filtering.
 
 Returns a list of available session IDs with metadata including message count, date range, and agents used.
@@ -87157,9 +87450,9 @@ Agents Used: build, oracle, librarian
 Has Todos: Yes (12 items, 8 completed)
 Has Transcript: Yes (234 entries)`;
 // src/tools/session-manager/storage.ts
-import { existsSync as existsSync68 } from "fs";
+import { existsSync as existsSync69 } from "fs";
 import { readdir, readFile as readFile3 } from "fs/promises";
-import { join as join69 } from "path";
+import { join as join70 } from "path";
 var sdkClient = null;
 function setStorageClient(client2) {
   sdkClient = client2;
@@ -87178,7 +87471,7 @@ async function getMainSessions(options) {
       return [];
     }
   }
-  if (!existsSync68(SESSION_STORAGE))
+  if (!existsSync69(SESSION_STORAGE))
     return [];
   const sessions = [];
   try {
@@ -87186,13 +87479,13 @@ async function getMainSessions(options) {
     for (const projectDir of projectDirs) {
       if (!projectDir.isDirectory())
         continue;
-      const projectPath = join69(SESSION_STORAGE, projectDir.name);
+      const projectPath = join70(SESSION_STORAGE, projectDir.name);
       const sessionFiles = await readdir(projectPath);
       for (const file3 of sessionFiles) {
         if (!file3.endsWith(".json"))
           continue;
         try {
-          const content = await readFile3(join69(projectPath, file3), "utf-8");
+          const content = await readFile3(join70(projectPath, file3), "utf-8");
           const meta3 = JSON.parse(content);
           if (meta3.parentID)
             continue;
@@ -87217,7 +87510,7 @@ async function getAllSessions() {
       return [];
     }
   }
-  if (!existsSync68(MESSAGE_STORAGE))
+  if (!existsSync69(MESSAGE_STORAGE))
     return [];
   const sessions = [];
   async function scanDirectory(dir) {
@@ -87225,7 +87518,7 @@ async function getAllSessions() {
       const entries = await readdir(dir, { withFileTypes: true });
       for (const entry of entries) {
         if (entry.isDirectory()) {
-          const sessionPath = join69(dir, entry.name);
+          const sessionPath = join70(dir, entry.name);
           const files = await readdir(sessionPath);
           if (files.some((f) => f.endsWith(".json"))) {
             sessions.push(entry.name);
@@ -87286,7 +87579,7 @@ async function readSessionMessages(sessionID) {
     }
   }
   const messageDir = getMessageDir(sessionID);
-  if (!messageDir || !existsSync68(messageDir))
+  if (!messageDir || !existsSync69(messageDir))
     return [];
   const messages2 = [];
   try {
@@ -87295,7 +87588,7 @@ async function readSessionMessages(sessionID) {
       if (!file3.endsWith(".json"))
         continue;
       try {
-        const content = await readFile3(join69(messageDir, file3), "utf-8");
+        const content = await readFile3(join70(messageDir, file3), "utf-8");
         const meta3 = JSON.parse(content);
         const parts = await readParts2(meta3.id);
         messages2.push({
@@ -87319,8 +87612,8 @@ async function readSessionMessages(sessionID) {
   });
 }
 async function readParts2(messageID) {
-  const partDir = join69(PART_STORAGE, messageID);
-  if (!existsSync68(partDir))
+  const partDir = join70(PART_STORAGE, messageID);
+  if (!existsSync69(partDir))
     return [];
   const parts = [];
   try {
@@ -87329,7 +87622,7 @@ async function readParts2(messageID) {
       if (!file3.endsWith(".json"))
         continue;
       try {
-        const content = await readFile3(join69(partDir, file3), "utf-8");
+        const content = await readFile3(join70(partDir, file3), "utf-8");
         parts.push(JSON.parse(content));
       } catch {}
     }
@@ -87353,14 +87646,14 @@ async function readSessionTodos(sessionID) {
       return [];
     }
   }
-  if (!existsSync68(TODO_DIR))
+  if (!existsSync69(TODO_DIR))
     return [];
   try {
     const allFiles = await readdir(TODO_DIR);
     const todoFiles = allFiles.filter((f) => f.includes(sessionID) && f.endsWith(".json"));
     for (const file3 of todoFiles) {
       try {
-        const content = await readFile3(join69(TODO_DIR, file3), "utf-8");
+        const content = await readFile3(join70(TODO_DIR, file3), "utf-8");
         const data = JSON.parse(content);
         if (Array.isArray(data)) {
           return data.map((item) => ({
@@ -87378,10 +87671,10 @@ async function readSessionTodos(sessionID) {
   return [];
 }
 async function readSessionTranscript(sessionID) {
-  if (!existsSync68(TRANSCRIPT_DIR2))
+  if (!existsSync69(TRANSCRIPT_DIR2))
     return 0;
-  const transcriptFile = join69(TRANSCRIPT_DIR2, `${sessionID}.jsonl`);
-  if (!existsSync68(transcriptFile))
+  const transcriptFile = join70(TRANSCRIPT_DIR2, `${sessionID}.jsonl`);
+  if (!existsSync69(transcriptFile))
     return 0;
   try {
     const content = await readFile3(transcriptFile, "utf-8");
@@ -87881,17 +88174,17 @@ function createSkillTool(options = {}) {
 }
 var skill = createSkillTool();
 // src/tools/slashcommand/command-discovery.ts
-import { existsSync as existsSync69, readdirSync as readdirSync21, readFileSync as readFileSync42 } from "fs";
-import { basename as basename8, join as join70 } from "path";
+import { existsSync as existsSync70, readdirSync as readdirSync21, readFileSync as readFileSync42 } from "fs";
+import { basename as basename8, join as join71 } from "path";
 function discoverCommandsFromDir2(commandsDir, scope) {
-  if (!existsSync69(commandsDir))
+  if (!existsSync70(commandsDir))
     return [];
   const entries = readdirSync21(commandsDir, { withFileTypes: true });
   const commands2 = [];
   for (const entry of entries) {
     if (!isMarkdownFile(entry))
       continue;
-    const commandPath = join70(commandsDir, entry.name);
+    const commandPath = join71(commandsDir, entry.name);
     const commandName = basename8(entry.name, ".md");
     try {
       const content = readFileSync42(commandPath, "utf-8");
@@ -87918,8 +88211,8 @@ function discoverCommandsFromDir2(commandsDir, scope) {
 }
 function discoverCommandsSync(directory) {
   const configDir = getOpenCodeConfigDir({ binary: "opencode" });
-  const opencodeGlobalDir = join70(configDir, "command");
-  const opencodeProjectDir = join70(directory ?? process.cwd(), ".opencode", "command");
+  const opencodeGlobalDir = join71(configDir, "command");
+  const opencodeProjectDir = join71(directory ?? process.cwd(), ".opencode", "command");
   const opencodeGlobalCommands = discoverCommandsFromDir2(opencodeGlobalDir, "opencode");
   const opencodeProjectCommands = discoverCommandsFromDir2(opencodeProjectDir, "opencode-project");
   const builtinCommandsMap = loadBuiltinCommands();
@@ -88723,11 +89016,11 @@ function createBackgroundOutput(manager, client2) {
   });
 }
 // src/tools/background-task/create-background-revive.ts
-import { existsSync as existsSync71 } from "fs";
+import { existsSync as existsSync72 } from "fs";
 
 // src/features/background-agent/handle-index.ts
-import { existsSync as existsSync70, mkdirSync as mkdirSync19, readdirSync as readdirSync22, readFileSync as readFileSync43, renameSync as renameSync5, unlinkSync as unlinkSync11, writeFileSync as writeFileSync25 } from "fs";
-import { dirname as dirname17, join as join71 } from "path";
+import { existsSync as existsSync71, mkdirSync as mkdirSync20, readdirSync as readdirSync22, readFileSync as readFileSync43, renameSync as renameSync5, unlinkSync as unlinkSync11, writeFileSync as writeFileSync25 } from "fs";
+import { dirname as dirname17, join as join72 } from "path";
 
 // src/features/background-agent/constants.ts
 var TASK_TTL_MS = 30 * 60 * 1000;
@@ -88778,14 +89071,14 @@ var BgHandleSchema = exports_external.object({
   completedAt: exports_external.number().optional()
 }).strict();
 function getBgHandleDir(directory) {
-  return join71(directory, ".matrixx", BG_HANDLE_DIR_NAME);
+  return join72(directory, ".matrixx", BG_HANDLE_DIR_NAME);
 }
 function getHandlePath(directory, taskId) {
-  return join71(getBgHandleDir(directory), `${taskId}.json`);
+  return join72(getBgHandleDir(directory), `${taskId}.json`);
 }
 function ensureDir3(dirPath) {
-  if (!existsSync70(dirPath)) {
-    mkdirSync19(dirPath, { recursive: true });
+  if (!existsSync71(dirPath)) {
+    mkdirSync20(dirPath, { recursive: true });
   }
 }
 function toHandle(task) {
@@ -88815,7 +89108,7 @@ function writeHandle(directory, task) {
     renameSync5(tempPath, filePath);
   } catch (error95) {
     try {
-      if (existsSync70(tempPath)) {
+      if (existsSync71(tempPath)) {
         unlinkSync11(tempPath);
       }
     } catch {}
@@ -88824,7 +89117,7 @@ function writeHandle(directory, task) {
 }
 function readHandleFile(filePath) {
   try {
-    if (!existsSync70(filePath)) {
+    if (!existsSync71(filePath)) {
       return null;
     }
     const parsed = JSON.parse(readFileSync43(filePath, "utf-8"));
@@ -88836,7 +89129,7 @@ function readHandleFile(filePath) {
 }
 function readHandles(directory) {
   const dir = getBgHandleDir(directory);
-  if (!existsSync70(dir)) {
+  if (!existsSync71(dir)) {
     return [];
   }
   const handles = [];
@@ -88844,7 +89137,7 @@ function readHandles(directory) {
     if (!name.startsWith(BG_HANDLE_FILE_PREFIX) || !name.endsWith(".json")) {
       continue;
     }
-    const handle = readHandleFile(join71(dir, name));
+    const handle = readHandleFile(join72(dir, name));
     if (handle) {
       handles.push(handle);
     }
@@ -88853,7 +89146,7 @@ function readHandles(directory) {
 }
 function sweepStaleHandles(directory, ttlMs = TASK_TTL_MS, now = Date.now()) {
   const dir = getBgHandleDir(directory);
-  if (!existsSync70(dir)) {
+  if (!existsSync71(dir)) {
     return 0;
   }
   let removed = 0;
@@ -88861,7 +89154,7 @@ function sweepStaleHandles(directory, ttlMs = TASK_TTL_MS, now = Date.now()) {
     if (!name.startsWith(BG_HANDLE_FILE_PREFIX) || !name.endsWith(".json")) {
       continue;
     }
-    const filePath = join71(dir, name);
+    const filePath = join72(dir, name);
     const handle = readHandleFile(filePath);
     const timestamp = handle?.completedAt ?? handle?.startedAt ?? handle?.queuedAt;
     if (handle && timestamp !== undefined && now - timestamp <= ttlMs) {
@@ -88929,7 +89222,7 @@ Revive one with background_revive(taskId="<id>", prompt="<new instruction>").`;
 }
 function resolveFailure(identifier, message, directory) {
   if (message.includes("not found for revive")) {
-    const handleOnDisk = existsSync71(getHandlePath(directory, identifier));
+    const handleOnDisk = existsSync72(getHandlePath(directory, identifier));
     return { reason: handleOnDisk ? "unknown-task" : "expired", detail: message };
   }
   if (message.includes("still active"))
@@ -89344,9 +89637,9 @@ function createAssemblyTool(options) {
   });
 }
 // src/tools/dcp-switch-profile/tools.ts
-import { existsSync as existsSync72, writeFileSync as writeFileSync26 } from "fs";
+import { existsSync as existsSync73, writeFileSync as writeFileSync26 } from "fs";
 import { homedir as homedir11 } from "os";
-import { join as join72 } from "path";
+import { join as join73 } from "path";
 
 // src/config/schema/dcp.ts
 var DcpCompressOverrideSchema = exports_external.object({
@@ -89546,11 +89839,11 @@ var DcpConfigSchema = exports_external.object({
 });
 
 // src/tools/dcp-switch-profile/tools.ts
-var DCP_PLUGIN_DIR = join72(homedir11(), ".config", "opencode", "node_modules", "@tarquinen", "opencode-dcp");
-var DCP_SYMLINK = join72(homedir11(), ".config", "opencode", "dcp.jsonc");
+var DCP_PLUGIN_DIR = join73(homedir11(), ".config", "opencode", "node_modules", "@tarquinen", "opencode-dcp");
+var DCP_SYMLINK = join73(homedir11(), ".config", "opencode", "dcp.jsonc");
 var VALID_PROFILES = ["economy", "balanced", "performance", "ultimate", "brutal"];
 function checkDcpInstalled() {
-  if (!existsSync72(DCP_PLUGIN_DIR)) {
+  if (!existsSync73(DCP_PLUGIN_DIR)) {
     return `DCP is not installed at ${DCP_PLUGIN_DIR}. Install it with: npm install --prefix ~/.config/opencode @tarquinen/opencode-dcp`;
   }
   return null;
@@ -92671,8 +92964,8 @@ Original error: ${createResult.error}`;
   });
 }
 // src/tools/task/task-cleanup.ts
-import { existsSync as existsSync73, readdirSync as readdirSync23, readFileSync as readFileSync44, unlinkSync as unlinkSync12 } from "fs";
-import { join as join73 } from "path";
+import { existsSync as existsSync74, readdirSync as readdirSync23, readFileSync as readFileSync44, unlinkSync as unlinkSync12 } from "fs";
+import { join as join74 } from "path";
 init_logger();
 function parseOlderThan(value) {
   const match = value.trim().match(/^(\d+)(d|h|m)$/);
@@ -92732,14 +93025,14 @@ Returns counts: {deleted, remaining, deletedIds}`,
         }
         const directory = context?.directory ?? ctx?.directory ?? process.cwd();
         const taskDir = getTaskDir(config4, directory);
-        if (!existsSync73(taskDir)) {
+        if (!existsSync74(taskDir)) {
           return JSON.stringify({ deleted: 0, remaining: 0, deletedIds: [] });
         }
         const files = readdirSync23(taskDir).filter((f) => f.endsWith(".json") && f.startsWith("T-"));
         const total = files.length;
         const deletedIds = [];
         for (const file3 of files) {
-          const filePath = join73(taskDir, file3);
+          const filePath = join74(taskDir, file3);
           let raw;
           try {
             const content = readFileSync44(filePath, "utf-8");
@@ -92776,7 +93069,7 @@ Returns counts: {deleted, remaining, deletedIds}`,
 }
 // src/tools/task/task-create.ts
 import { readdirSync as readdirSync24, statSync as statSync15 } from "fs";
-import { join as join74 } from "path";
+import { join as join75 } from "path";
 init_logger();
 function createTaskCreateTool(config4, ctx) {
   return tool({
@@ -92845,7 +93138,7 @@ async function handleCreate2(args, config4, ctx, context) {
         projectRoot: directory
       };
       const validatedTask = TaskObjectSchema.parse(task);
-      writeJsonAtomic(join74(taskDir, `${taskId}.json`), validatedTask);
+      writeJsonAtomic(join75(taskDir, `${taskId}.json`), validatedTask);
       return JSON.stringify({
         task: {
           id: validatedTask.id,
@@ -92874,7 +93167,7 @@ function findDuplicateTask(taskDir, subject, directory) {
     return null;
   }
   for (const file3 of files) {
-    const filePath = join74(taskDir, file3);
+    const filePath = join75(taskDir, file3);
     let existing;
     try {
       existing = readJsonSafe(filePath, TaskObjectSchema);
@@ -92905,7 +93198,7 @@ function findDuplicateTask(taskDir, subject, directory) {
   return null;
 }
 // src/tools/task/task-get.ts
-import { join as join75 } from "path";
+import { join as join76 } from "path";
 function parseTaskId(id) {
   if (!TASK_ID_PATTERN.test(id))
     return null;
@@ -92931,7 +93224,7 @@ Returns null if the task does not exist or the file is invalid.`,
         }
         const directory = context?.directory ?? ctx?.directory ?? process.cwd();
         const taskDir = getTaskDir(config4, directory);
-        const taskPath = join75(taskDir, `${taskId}.json`);
+        const taskPath = join76(taskDir, `${taskId}.json`);
         const task = readJsonSafe(taskPath, TaskObjectSchema);
         return JSON.stringify({ task: task ?? null });
       } catch (error95) {
@@ -92944,8 +93237,8 @@ Returns null if the task does not exist or the file is invalid.`,
   });
 }
 // src/tools/task/task-list.ts
-import { existsSync as existsSync74, readdirSync as readdirSync25 } from "fs";
-import { join as join76 } from "path";
+import { existsSync as existsSync75, readdirSync as readdirSync25 } from "fs";
+import { join as join77 } from "path";
 function createTaskList(config4, ctx) {
   return tool({
     description: `[TRACKING \u2014 local progress records only. Spawns nothing, executes nothing.]
@@ -92964,7 +93257,7 @@ Optional \`parentID\` filter: when provided, returns only tasks whose parentID m
       const parentID = args.parentID;
       const directory = context?.directory ?? ctx?.directory ?? process.cwd();
       const taskDir = getTaskDir(config4, directory);
-      if (!existsSync74(taskDir)) {
+      if (!existsSync75(taskDir)) {
         return JSON.stringify({ tasks: [] });
       }
       const files = readdirSync25(taskDir).filter((f) => f.endsWith(".json") && f.startsWith("T-")).map((f) => f.replace(".json", ""));
@@ -92973,7 +93266,7 @@ Optional \`parentID\` filter: when provided, returns only tasks whose parentID m
       }
       const allTasks = [];
       for (const fileId of files) {
-        const task = readJsonSafe(join76(taskDir, `${fileId}.json`), TaskObjectSchema);
+        const task = readJsonSafe(join77(taskDir, `${fileId}.json`), TaskObjectSchema);
         if (task) {
           allTasks.push(task);
         }
@@ -93002,7 +93295,7 @@ Optional \`parentID\` filter: when provided, returns only tasks whose parentID m
   });
 }
 // src/tools/task/task-update.ts
-import { join as join77 } from "path";
+import { join as join78 } from "path";
 function parseTaskId2(id) {
   if (!TASK_ID_PATTERN.test(id))
     return null;
@@ -93049,7 +93342,7 @@ async function handleUpdate(args, config4, ctx, context) {
       return JSON.stringify({ error: "task_lock_unavailable" });
     }
     try {
-      const taskPath = join77(taskDir, `${taskId}.json`);
+      const taskPath = join78(taskDir, `${taskId}.json`);
       const task = readJsonSafe(taskPath, TaskObjectSchema);
       if (!task) {
         return JSON.stringify({ error: "task_not_found" });
@@ -93227,6 +93520,7 @@ function createToolGuardHooks(args) {
   const qualityGate = isHookEnabled("quality-gate") ? safeHook("quality-gate", () => createQualityGateHook()) : null;
   const taskNotepad = isHookEnabled("task-notepad") ? safeHook("task-notepad", () => createTaskNotepadHook(ctx)) : null;
   const taskEditGuard = isHookEnabled("task-edit-guard") ? safeHook("task-edit-guard", () => createTaskEditGuardHook(ctx)) : null;
+  const documentReaderGuard = isHookEnabled("document-reader-guard") ? safeHook("document-reader-guard", () => createDocumentReaderGuardHook(ctx)) : null;
   const evolutionWatcher = evolutionEnabled && isHookEnabled("evolution-watcher") ? safeHook("evolution-watcher", () => createEvolutionWatcherHook(ctx, pluginConfig.evolution)) : null;
   return {
     backgroundTaskBlocker,
@@ -93249,6 +93543,7 @@ function createToolGuardHooks(args) {
     qualityGate,
     taskNotepad,
     taskEditGuard,
+    documentReaderGuard,
     evolutionWatcher
   };
 }
@@ -93813,19 +94108,19 @@ function detectRepetitiveToolUse(window2) {
 }
 
 // src/features/background-agent/message-dir.ts
-import { existsSync as existsSync75, readdirSync as readdirSync26, readFileSync as readFileSync45 } from "fs";
-import { join as join78 } from "path";
+import { existsSync as existsSync76, readdirSync as readdirSync26, readFileSync as readFileSync45 } from "fs";
+import { join as join79 } from "path";
 var MESSAGE_DIR_CACHE_CAP = 1000;
 var messageDirCache = new Map;
 function computeMessageDir(sessionID) {
-  if (!existsSync75(MESSAGE_STORAGE))
+  if (!existsSync76(MESSAGE_STORAGE))
     return null;
-  const directPath = join78(MESSAGE_STORAGE, sessionID);
-  if (existsSync75(directPath))
+  const directPath = join79(MESSAGE_STORAGE, sessionID);
+  if (existsSync76(directPath))
     return directPath;
   for (const dir of readdirSync26(MESSAGE_STORAGE)) {
-    const sessionPath = join78(MESSAGE_STORAGE, dir, sessionID);
-    if (existsSync75(sessionPath))
+    const sessionPath = join79(MESSAGE_STORAGE, dir, sessionID);
+    if (existsSync76(sessionPath))
       return sessionPath;
   }
   return null;
@@ -93863,7 +94158,7 @@ function findNearestMessageExcludingCompaction(messageDir) {
     const parsedByFile = new Map;
     for (const file3 of files) {
       try {
-        const content = readFileSync45(join78(messageDir, file3), "utf-8");
+        const content = readFileSync45(join79(messageDir, file3), "utf-8");
         const parsed = JSON.parse(content);
         parsedByFile.set(file3, parsed);
         if (hasFullAgentAndModel(parsed)) {
@@ -96505,12 +96800,12 @@ function decideCloseAction(state3, sessionId, sessionMappings) {
   return { type: "close", paneId: mapping.paneId, sessionId };
 }
 // src/features/tmux-subagent/pane-state-querier.ts
-var {spawn: spawn12 } = globalThis.Bun;
+var {spawn: spawn13 } = globalThis.Bun;
 async function queryWindowState(sourcePaneId) {
   const tmux2 = await getTmuxPath();
   if (!tmux2)
     return null;
-  const proc = spawn12([
+  const proc = spawn13([
     tmux2,
     "list-panes",
     "-t",
@@ -98418,7 +98713,7 @@ function createBddContractAgent(model) {
 createBddContractAgent.mode = MODE2;
 
 // src/agents/builtin-agents/resolve-file-uri.ts
-import { existsSync as existsSync76, readFileSync as readFileSync47 } from "fs";
+import { existsSync as existsSync77, readFileSync as readFileSync47 } from "fs";
 import { homedir as homedir12 } from "os";
 import { isAbsolute as isAbsolute6, resolve as resolve9 } from "path";
 function resolvePromptAppend(promptAppend, configDir) {
@@ -98433,7 +98728,7 @@ function resolvePromptAppend(promptAppend, configDir) {
   } catch {
     return `[WARNING: Malformed file URI (invalid percent-encoding): ${promptAppend}]`;
   }
-  if (!existsSync76(filePath)) {
+  if (!existsSync77(filePath)) {
     return `[WARNING: Could not resolve file URI: ${promptAppend}]`;
   }
   try {
@@ -100054,7 +100349,7 @@ var CONSTRUCT_PROMPT_METADATA = {
   triggers: []
 };
 function createConstructAgent(model) {
-  const restrictions = createAgentToolAllowlist(["read"]);
+  const restrictions = createAgentToolAllowlist(["read", "document_reader__convert_to_markdown"]);
   return {
     description: "Analyze media files (PDFs, images, diagrams) that require interpretation beyond raw text. Extracts specific information or summaries from documents, describes visual content. Use when you need analyzed/extracted data rather than literal file contents. (Multimodal-Looker - Matrixx)",
     mode: MODE6,
@@ -100078,7 +100373,7 @@ When NOT to use you:
 
 How you work:
 1. Receive a file path and a goal describing what to extract
-2. Read and analyze the file deeply
+2. For PDF/DOCX/XLSX/PPTX/media call document_reader__convert_to_markdown with file:///absolute/path, otherwise use Read
 3. Return ONLY the relevant extracted information
 4. The main agent never processes the raw file - you save context tokens
 
@@ -100444,7 +100739,7 @@ context7_query-docs(libraryId: id, query: "specific topic")
 Tool 1: context7_resolve-library-id("library-name")
         \u2192 then context7_query-docs(libraryId: id, query: "specific-topic")
 Tool 2: webfetch(relevant_pages_from_sitemap)  // Targeted, not random
-Tool 3: white_rabbit_searchGitHub(query: "usage pattern", language: ["TypeScript"])
+Tool 3: github_search(query: "usage pattern", language: "TypeScript")
 \`\`\`
 
 **Output**: Summarize findings with links to official docs (versioned if applicable) and real-world examples.
@@ -100474,7 +100769,7 @@ Step 4: Construct permalink
 **Parallel acceleration (4+ calls)**:
 \`\`\`
 Tool 1: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
-Tool 2: white_rabbit_searchGitHub(query: "function_name", repo: "owner/repo")
+Tool 2: github_search(query: "function_name", repo: "owner/repo")
 Tool 3: gh api repos/owner/repo/commits/HEAD --jq '.sha'
 Tool 4: context7_get-library-docs(id, topic: "relevant-api")
 \`\`\`
@@ -100513,8 +100808,8 @@ Tool 1: context7_resolve-library-id \u2192 context7_query-docs
 Tool 2: webfetch(targeted_doc_pages_from_sitemap)
 
 // Code Search
-Tool 3: white_rabbit_searchGitHub(query: "pattern1", language: [...])
-Tool 4: white_rabbit_searchGitHub(query: "pattern2", useRegexp: true)
+Tool 3: github_search(query: "pattern1", language: "TypeScript")
+Tool 4: github_search(query: "pattern2", repo: "owner/repo")
 
 // Source Analysis
 Tool 5: gh repo clone owner/repo \${TMPDIR:-/tmp}/repo -- --depth 1
@@ -100570,7 +100865,7 @@ https://github.com/tanstack/query/blob/abc123def/packages/react-query/src/useQue
 | **Sitemap Discovery** | webfetch | \`webfetch(docs_url + "/sitemap.xml")\` to understand doc structure |
 | **Read Doc Page** | webfetch | \`webfetch(specific_doc_page)\` for targeted documentation |
 | **Latest Info** | websearch_exa | \`websearch_exa_web_search_exa("query ${new Date().getFullYear()}")\` |
-| **Fast Code Search** | white_rabbit | \`white_rabbit_searchGitHub(query, language, useRegexp)\` |
+| **Fast Code Search** | github_search | \`github_search(query, language, repo, limit)\` |
 | **Deep Code Search** | gh CLI | \`gh search code "query" --repo owner/repo\` |
 | **Clone Repo** | gh CLI | \`gh repo clone owner/repo \${TMPDIR:-/tmp}/name -- --depth 1\` |
 | **Issues/PRs** | gh CLI | \`gh search issues/prs "query" --repo owner/repo\` |
@@ -100606,16 +100901,16 @@ Use OS-appropriate temp directory:
 **Doc Discovery is SEQUENTIAL** (websearch \u2192 version check \u2192 sitemap \u2192 investigate).
 **Main phase is PARALLEL** once you know where to look.
 
-**Always vary queries** when using white_rabbit:
+**Always vary queries** when using github_search:
 \`\`\`
 // GOOD: Different angles
-white_rabbit_searchGitHub(query: "useQuery(", language: ["TypeScript"])
-white_rabbit_searchGitHub(query: "queryOptions", language: ["TypeScript"])
-white_rabbit_searchGitHub(query: "staleTime:", language: ["TypeScript"])
+github_search(query: "useQuery(", language: "TypeScript")
+github_search(query: "queryOptions", language: "TypeScript")
+github_search(query: "staleTime:", language: "TypeScript")
 
 // BAD: Same pattern
-white_rabbit_searchGitHub(query: "useQuery")
-white_rabbit_searchGitHub(query: "useQuery")
+github_search(query: "useQuery")
+github_search(query: "useQuery")
 \`\`\`
 
 ---
@@ -100625,7 +100920,7 @@ white_rabbit_searchGitHub(query: "useQuery")
 | Failure | Recovery Action |
 |---------|-----------------|
 | context7 not found | Clone repo, read source + README directly |
-| white_rabbit no results | Broaden query, try concept instead of exact name |
+| github_search no results | Broaden query, try concept instead of exact name |
 | gh API rate limit | Use cloned repo in temp directory |
 | Repo not found | Search for forks or mirrors |
 | Sitemap not found | Try \`/sitemap-0.xml\`, \`/sitemap_index.xml\`, or fetch docs index page and parse navigation |
@@ -100636,7 +100931,7 @@ white_rabbit_searchGitHub(query: "useQuery")
 
 ## COMMUNICATION RULES
 
-1. **NO TOOL NAMES**: Say "I'll search the codebase" not "I'll use white_rabbit"
+1. **NO TOOL NAMES**: Say "I'll search the codebase" not "I'll use github_search"
 2. **NO PREAMBLE**: Answer directly, skip "I'll help you with..."
 3. **ALWAYS CITE**: Every code claim needs a permalink
 4. **USE MARKDOWN**: Code blocks with language identifiers
@@ -101613,6 +101908,7 @@ Use the right tool for the job:
 - **Text patterns** (strings, comments, logs): ctx_search (indexed KB) -> ctx_batch_execute / ctx_execute for multi-file analysis. ast_grep_search for structural patterns. grep/glob only as fallback when ctx_* unavailable.
 - **File patterns** (find by name/extension): ctx_search (indexed KB) -> LSP / ast_grep_search. glob only as fallback when ctx_* unavailable.
 - **History/evolution** (when added, who changed): git commands
+- **OSS reference** (how others implement X in public repos): github_search (local gh/git/rg CLIs, no third-party services)
 
 Flood with parallel calls. Cross-validate findings across multiple tools.`
   };
@@ -104052,16 +104348,8 @@ function createWebsearchConfig(config4) {
 }
 var websearch = createWebsearchConfig();
 
-// src/mcp/white-rabbit.ts
-var white_rabbit = {
-  type: "remote",
-  url: "https://mcp.grep.app",
-  enabled: true,
-  oauth: false
-};
-
 // src/mcp/types.ts
-var McpNameSchema = exports_external.enum(["websearch", "context7", "white_rabbit", "document_reader"]);
+var McpNameSchema = exports_external.enum(["websearch", "context7", "document_reader"]);
 var AnyMcpNameSchema = exports_external.string().min(1);
 
 // src/mcp/index.ts
@@ -104110,9 +104398,6 @@ function createBuiltinMcps(disabledMcps = [], config4, options = {}) {
   if (!disabledMcps.includes("context7")) {
     mcps.context7 = context7;
   }
-  if (!disabledMcps.includes("white_rabbit")) {
-    mcps.white_rabbit = white_rabbit;
-  }
   if (!disabledMcps.includes("document_reader")) {
     if (commandAvailable("uvx")) {
       mcps.document_reader = document_reader;
@@ -104213,7 +104498,7 @@ function applyToolConfig(params) {
   const denyTaskTools = !isTaskSystem ? { "task_*": "deny", task: "deny" } : {};
   params.config.tools = {
     ...params.config.tools,
-    "white_rabbit_*": false,
+    github_search: false,
     LspHover: false,
     LspCodeActions: false,
     LspCodeActionResolve: false,
@@ -104225,7 +104510,11 @@ function applyToolConfig(params) {
   const questionPermission = isCliRunMode ? "deny" : "allow";
   const operator = agentByKey(params.agentResult, "operator");
   if (operator) {
-    operator.permission = { ...operator.permission, "white_rabbit_*": "allow" };
+    operator.permission = { ...operator.permission, github_search: "allow" };
+  }
+  const trinity = agentByKey(params.agentResult, "trinity");
+  if (trinity) {
+    trinity.permission = { ...trinity.permission, github_search: "allow" };
   }
   const construct = agentByKey(params.agentResult, "construct");
   if (construct) {
@@ -104476,6 +104765,7 @@ function createToolRegistry(args) {
   const allTools = {
     ...builtinTools,
     ...createGrepTools(ctx),
+    ...createGithubSearchTools(ctx),
     ...createGlobTools(ctx),
     ...createAstGrepTools(ctx),
     ...createSessionManagerTools(ctx),
@@ -104942,6 +105232,7 @@ var HookNameEnum = exports_external.enum([
   "context-mode-enforcer",
   "context-mode-enforcer",
   "task-edit-guard",
+  "document-reader-guard",
   "failure-counter"
 ]);
 var HookNameSchema = exports_external.union([
@@ -105776,22 +106067,22 @@ function createToolExecuteAfterHandler2(args) {
 
 // src/features/assembly-state/manager.ts
 init_logger();
-var HOOK_NAME20 = "assembly-state";
+var HOOK_NAME21 = "assembly-state";
 var disabledSessions = new Set;
 function isAssemblyDisabled(sessionID) {
   return disabledSessions.has(sessionID);
 }
 function disableAssembly(sessionID) {
   disabledSessions.add(sessionID);
-  log(`[${HOOK_NAME20}] Assembly disabled for session`, { sessionID });
+  log(`[${HOOK_NAME21}] Assembly disabled for session`, { sessionID });
   disabledSessions.add(sessionID);
-  log(`[${HOOK_NAME20}] Consensus disabled for session`, { sessionID });
+  log(`[${HOOK_NAME21}] Consensus disabled for session`, { sessionID });
 }
 function enableAssembly(sessionID) {
   disabledSessions.delete(sessionID);
-  log(`[${HOOK_NAME20}] Assembly enabled for session`, { sessionID });
+  log(`[${HOOK_NAME21}] Assembly enabled for session`, { sessionID });
   disabledSessions.delete(sessionID);
-  log(`[${HOOK_NAME20}] Consensus enabled for session`, { sessionID });
+  log(`[${HOOK_NAME21}] Consensus enabled for session`, { sessionID });
 }
 // src/plugin/session-agent-resolver.ts
 async function resolveSessionAgent(client2, sessionId, timeoutMs = 5000) {