evil-omo 3.12.0 → 3.12.3

package/dist/cli/index.js

@@ -5903,6 +5903,12 @@ var init_snake_case = __esm(() => {
 
 // src/shared/tool-name.ts
 var init_tool_name = () => {};
+
+// src/shared/pattern-matcher.ts
+var regexCache;
+var init_pattern_matcher = __esm(() => {
+  regexCache = new Map;
+});
 // src/shared/file-utils.ts
 var init_file_utils = () => {};
 
@@ -6660,85 +6666,160 @@ var init_agent_tool_restrictions = () => {};
 // src/shared/connected-providers-cache.ts
 import { existsSync as existsSync3, readFileSync as readFileSync2, writeFileSync as writeFileSync2, mkdirSync } from "fs";
 import { join as join5 } from "path";
-function getCacheFilePath(filename) {
-  return join5(getOmoOpenCodeCacheDir(), filename);
-}
-function ensureCacheDir() {
-  const cacheDir = getOmoOpenCodeCacheDir();
-  if (!existsSync3(cacheDir)) {
-    mkdirSync(cacheDir, { recursive: true });
+function createConnectedProvidersCacheStore(getCacheDir2 = getOmoOpenCodeCacheDir) {
+  function getCacheFilePath(filename) {
+    return join5(getCacheDir2(), filename);
+  }
+  let memConnected;
+  let memProviderModels;
+  function ensureCacheDir() {
+    const cacheDir = getCacheDir2();
+    if (!existsSync3(cacheDir)) {
+      mkdirSync(cacheDir, { recursive: true });
+    }
+  }
+  function readConnectedProvidersCache() {
+    if (memConnected !== undefined)
+      return memConnected;
+    const cacheFile = getCacheFilePath(CONNECTED_PROVIDERS_CACHE_FILE);
+    if (!existsSync3(cacheFile)) {
+      log("[connected-providers-cache] Cache file not found", { cacheFile });
+      memConnected = null;
+      return null;
+    }
+    try {
+      const content = readFileSync2(cacheFile, "utf-8");
+      const data = JSON.parse(content);
+      log("[connected-providers-cache] Read cache", { count: data.connected.length, updatedAt: data.updatedAt });
+      memConnected = data.connected;
+      return data.connected;
+    } catch (err) {
+      log("[connected-providers-cache] Error reading cache", { error: String(err) });
+      memConnected = null;
+      return null;
+    }
   }
-}
-function writeConnectedProvidersCache(connected) {
-  ensureCacheDir();
-  const cacheFile = getCacheFilePath(CONNECTED_PROVIDERS_CACHE_FILE);
-  const data = {
-    connected,
-    updatedAt: new Date().toISOString()
-  };
-  try {
-    writeFileSync2(cacheFile, JSON.stringify(data, null, 2));
-    log("[connected-providers-cache] Cache written", { count: connected.length });
-  } catch (err) {
-    log("[connected-providers-cache] Error writing cache", { error: String(err) });
+  function hasConnectedProvidersCache() {
+    const cacheFile = getCacheFilePath(CONNECTED_PROVIDERS_CACHE_FILE);
+    return existsSync3(cacheFile);
   }
-}
-function hasProviderModelsCache() {
-  const cacheFile = getCacheFilePath(PROVIDER_MODELS_CACHE_FILE);
-  return existsSync3(cacheFile);
-}
-function writeProviderModelsCache(data) {
-  ensureCacheDir();
-  const cacheFile = getCacheFilePath(PROVIDER_MODELS_CACHE_FILE);
-  const cacheData = {
-    ...data,
-    updatedAt: new Date().toISOString()
-  };
-  try {
-    writeFileSync2(cacheFile, JSON.stringify(cacheData, null, 2));
-    log("[connected-providers-cache] Provider-models cache written", {
-      providerCount: Object.keys(data.models).length
-    });
-  } catch (err) {
-    log("[connected-providers-cache] Error writing provider-models cache", { error: String(err) });
+  function writeConnectedProvidersCache(connected) {
+    ensureCacheDir();
+    const cacheFile = getCacheFilePath(CONNECTED_PROVIDERS_CACHE_FILE);
+    const data = {
+      connected,
+      updatedAt: new Date().toISOString()
+    };
+    try {
+      writeFileSync2(cacheFile, JSON.stringify(data, null, 2));
+      memConnected = connected;
+      log("[connected-providers-cache] Cache written", { count: connected.length });
+    } catch (err) {
+      log("[connected-providers-cache] Error writing cache", { error: String(err) });
+    }
   }
-}
-async function updateConnectedProvidersCache(client) {
-  if (!client?.provider?.list) {
-    log("[connected-providers-cache] client.provider.list not available");
-    return;
+  function readProviderModelsCache() {
+    if (memProviderModels !== undefined)
+      return memProviderModels;
+    const cacheFile = getCacheFilePath(PROVIDER_MODELS_CACHE_FILE);
+    if (!existsSync3(cacheFile)) {
+      log("[connected-providers-cache] Provider-models cache file not found", { cacheFile });
+      memProviderModels = null;
+      return null;
+    }
+    try {
+      const content = readFileSync2(cacheFile, "utf-8");
+      const data = JSON.parse(content);
+      log("[connected-providers-cache] Read provider-models cache", {
+        providerCount: Object.keys(data.models).length,
+        updatedAt: data.updatedAt
+      });
+      memProviderModels = data;
+      return data;
+    } catch (err) {
+      log("[connected-providers-cache] Error reading provider-models cache", { error: String(err) });
+      memProviderModels = null;
+      return null;
+    }
   }
-  try {
-    const result = await client.provider.list();
-    const connected = result.data?.connected ?? [];
-    log("[connected-providers-cache] Fetched connected providers", { count: connected.length, providers: connected });
-    writeConnectedProvidersCache(connected);
-    const modelsByProvider = {};
-    const allProviders = result.data?.all ?? [];
-    for (const provider of allProviders) {
-      if (provider.models) {
-        const modelIds = Object.keys(provider.models);
-        if (modelIds.length > 0) {
-          modelsByProvider[provider.id] = modelIds;
-        }
-      }
-    }
-    log("[connected-providers-cache] Extracted models from provider list", {
-      providerCount: Object.keys(modelsByProvider).length,
-      totalModels: Object.values(modelsByProvider).reduce((sum, ids) => sum + ids.length, 0)
-    });
-    writeProviderModelsCache({
-      models: modelsByProvider,
-      connected
-    });
-  } catch (err) {
-    log("[connected-providers-cache] Error updating cache", { error: String(err) });
+  function hasProviderModelsCache() {
+    const cacheFile = getCacheFilePath(PROVIDER_MODELS_CACHE_FILE);
+    return existsSync3(cacheFile);
+  }
+  function writeProviderModelsCache(data) {
+    ensureCacheDir();
+    const cacheFile = getCacheFilePath(PROVIDER_MODELS_CACHE_FILE);
+    const cacheData = {
+      ...data,
+      updatedAt: new Date().toISOString()
+    };
+    try {
+      writeFileSync2(cacheFile, JSON.stringify(cacheData, null, 2));
+      memProviderModels = cacheData;
+      log("[connected-providers-cache] Provider-models cache written", {
+        providerCount: Object.keys(data.models).length
+      });
+    } catch (err) {
+      log("[connected-providers-cache] Error writing provider-models cache", { error: String(err) });
+    }
+  }
+  async function updateConnectedProvidersCache(client) {
+    if (!client?.provider?.list) {
+      log("[connected-providers-cache] client.provider.list not available");
+      return;
+    }
+    try {
+      const result = await client.provider.list();
+      const connected = result.data?.connected ?? [];
+      log("[connected-providers-cache] Fetched connected providers", {
+        count: connected.length,
+        providers: connected
+      });
+      writeConnectedProvidersCache(connected);
+      const modelsByProvider = {};
+      const allProviders = result.data?.all ?? [];
+      for (const provider of allProviders) {
+        if (provider.models) {
+          const modelIds = Object.keys(provider.models);
+          if (modelIds.length > 0) {
+            modelsByProvider[provider.id] = modelIds;
+          }
+        }
+      }
+      log("[connected-providers-cache] Extracted models from provider list", {
+        providerCount: Object.keys(modelsByProvider).length,
+        totalModels: Object.values(modelsByProvider).reduce((sum, ids) => sum + ids.length, 0)
+      });
+      writeProviderModelsCache({
+        models: modelsByProvider,
+        connected
+      });
+    } catch (err) {
+      log("[connected-providers-cache] Error updating cache", { error: String(err) });
+    }
   }
+  return {
+    readConnectedProvidersCache,
+    hasConnectedProvidersCache,
+    readProviderModelsCache,
+    hasProviderModelsCache,
+    writeProviderModelsCache,
+    updateConnectedProvidersCache
+  };
 }
-var CONNECTED_PROVIDERS_CACHE_FILE = "connected-providers.json", PROVIDER_MODELS_CACHE_FILE = "provider-models.json";
+var CONNECTED_PROVIDERS_CACHE_FILE = "connected-providers.json", PROVIDER_MODELS_CACHE_FILE = "provider-models.json", defaultConnectedProvidersCacheStore, readConnectedProvidersCache, hasConnectedProvidersCache, readProviderModelsCache, hasProviderModelsCache, writeProviderModelsCache, updateConnectedProvidersCache;
 var init_connected_providers_cache = __esm(() => {
   init_logger();
   init_data_path();
+  defaultConnectedProvidersCacheStore = createConnectedProvidersCacheStore(() => getOmoOpenCodeCacheDir());
+  ({
+    readConnectedProvidersCache,
+    hasConnectedProvidersCache,
+    readProviderModelsCache,
+    hasProviderModelsCache,
+    writeProviderModelsCache,
+    updateConnectedProvidersCache
+  } = defaultConnectedProvidersCacheStore);
 });
 
 // src/shared/model-availability.ts
@@ -7104,6 +7185,7 @@ var init_shared = __esm(() => {
   init_logger();
   init_snake_case();
   init_tool_name();
+  init_pattern_matcher();
   init_deep_merge();
   init_file_utils();
   init_dynamic_truncator();
@@ -8885,7 +8967,7 @@ var {
 // package.json
 var package_default = {
   name: "evil-omo",
-  version: "3.12.0",
+  version: "3.12.3",
   description: "The Best AI Agent Harness - Batteries-Included OpenCode Plugin with Multi-Model Orchestration, Parallel Background Agents, and Crafted LSP/AST Tools",
   main: "dist/index.js",
   types: "dist/index.d.ts",
@@ -8961,17 +9043,17 @@ var package_default = {
     typescript: "^5.7.3"
   },
   optionalDependencies: {
-    "evil-omo-darwin-arm64": "3.12.0",
-    "evil-omo-darwin-x64": "3.12.0",
-    "evil-omo-darwin-x64-baseline": "3.12.0",
-    "evil-omo-linux-x64": "3.12.0",
-    "evil-omo-linux-x64-baseline": "3.12.0",
-    "evil-omo-linux-arm64": "3.12.0",
-    "evil-omo-linux-x64-musl": "3.12.0",
-    "evil-omo-linux-x64-musl-baseline": "3.12.0",
-    "evil-omo-linux-arm64-musl": "3.12.0",
-    "evil-omo-windows-x64": "3.12.0",
-    "evil-omo-windows-x64-baseline": "3.12.0"
+    "evil-omo-darwin-arm64": "3.12.3",
+    "evil-omo-darwin-x64": "3.12.3",
+    "evil-omo-darwin-x64-baseline": "3.12.3",
+    "evil-omo-linux-x64": "3.12.3",
+    "evil-omo-linux-x64-baseline": "3.12.3",
+    "evil-omo-linux-arm64": "3.12.3",
+    "evil-omo-linux-x64-musl": "3.12.3",
+    "evil-omo-linux-x64-musl-baseline": "3.12.3",
+    "evil-omo-linux-arm64-musl": "3.12.3",
+    "evil-omo-windows-x64": "3.12.3",
+    "evil-omo-windows-x64-baseline": "3.12.3"
   },
   overrides: {
     "@opencode-ai/sdk": "^1.2.24"
@@ -10340,24 +10422,24 @@ function writePaddedText(text, atLineStart) {
     return { output: text, atLineStart: text.endsWith(`
 `) };
   }
-  let output = "";
+  const parts = [];
   let lineStart = atLineStart;
   for (let i2 = 0;i2 < text.length; i2++) {
     const ch = text[i2];
     if (lineStart) {
-      output += "  ";
+      parts.push("  ");
       lineStart = false;
     }
     if (ch === `
 `) {
-      output += `  
-`;
+      parts.push(`  
+`);
       lineStart = true;
       continue;
     }
-    output += ch;
+    parts.push(ch);
   }
-  return { output, atLineStart: lineStart };
+  return { output: parts.join(""), atLineStart: lineStart };
 }
 function colorizeWithProfileColor(text, hexColor) {
   if (!hexColor)
@@ -24350,9 +24432,9 @@ var BabysittingConfigSchema = exports_external.object({
 });
 // src/config/schema/background-task.ts
 var CircuitBreakerConfigSchema = exports_external.object({
+  enabled: exports_external.boolean().optional(),
   maxToolCalls: exports_external.number().int().min(10).optional(),
-  windowSize: exports_external.number().int().min(5).optional(),
-  repetitionThresholdPercent: exports_external.number().gt(0).max(100).optional()
+  consecutiveThreshold: exports_external.number().int().min(5).optional()
 });
 var BackgroundTaskConfigSchema = exports_external.object({
   defaultConcurrency: exports_external.number().min(1).optional(),
@@ -24542,7 +24624,8 @@ var HookNameSchema = exports_external.enum([
   "write-existing-file-guard",
   "anthropic-effort",
   "hashline-read-enhancer",
-  "read-image-resizer"
+  "read-image-resizer",
+  "todo-description-override"
 ]);
 // src/config/schema/notification.ts
 var NotificationConfigSchema = exports_external.object({

package/dist/config/schema/background-task.d.ts

@@ -10,9 +10,9 @@ export declare const BackgroundTaskConfigSchema: z.ZodObject<{
     syncPollTimeoutMs: z.ZodOptional<z.ZodNumber>;
     maxToolCalls: z.ZodOptional<z.ZodNumber>;
     circuitBreaker: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodOptional<z.ZodBoolean>;
         maxToolCalls: z.ZodOptional<z.ZodNumber>;
-        windowSize: z.ZodOptional<z.ZodNumber>;
-        repetitionThresholdPercent: z.ZodOptional<z.ZodNumber>;
+        consecutiveThreshold: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>;
 }, z.core.$strip>;
 export type BackgroundTaskConfig = z.infer<typeof BackgroundTaskConfigSchema>;

package/dist/config/schema/evil-omo-config.d.ts

@@ -1343,9 +1343,9 @@ export declare const OhMyOpenCodeConfigSchema: z.ZodObject<{
         syncPollTimeoutMs: z.ZodOptional<z.ZodNumber>;
         maxToolCalls: z.ZodOptional<z.ZodNumber>;
         circuitBreaker: z.ZodOptional<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodBoolean>;
             maxToolCalls: z.ZodOptional<z.ZodNumber>;
-            windowSize: z.ZodOptional<z.ZodNumber>;
-            repetitionThresholdPercent: z.ZodOptional<z.ZodNumber>;
+            consecutiveThreshold: z.ZodOptional<z.ZodNumber>;
         }, z.core.$strip>>;
     }, z.core.$strip>>;
     notification: z.ZodOptional<z.ZodObject<{

package/dist/config/schema/hooks.d.ts

@@ -48,5 +48,6 @@ export declare const HookNameSchema: z.ZodEnum<{
     "anthropic-effort": "anthropic-effort";
     "hashline-read-enhancer": "hashline-read-enhancer";
     "read-image-resizer": "read-image-resizer";
+    "todo-description-override": "todo-description-override";
 }>;
 export type HookName = z.infer<typeof HookNameSchema>;

package/dist/create-hooks.d.ts

@@ -50,6 +50,7 @@ export declare function createHooks(args: {
     hashlineReadEnhancer: ReturnType<typeof import("./hooks").createHashlineReadEnhancerHook> | null;
     jsonErrorRecovery: ReturnType<typeof import("./hooks").createJsonErrorRecoveryHook> | null;
     readImageResizer: ReturnType<typeof import("./hooks").createReadImageResizerHook> | null;
+    todoDescriptionOverride: ReturnType<typeof import("./hooks").createTodoDescriptionOverrideHook> | null;
     contextWindowMonitor: ReturnType<typeof import("./hooks").createContextWindowMonitorHook> | null;
     preemptiveCompaction: ReturnType<typeof import("./hooks").createPreemptiveCompactionHook> | null;
     sessionRecovery: ReturnType<typeof import("./hooks").createSessionRecoveryHook> | null;

package/dist/evil-omo.schema.json

@@ -3708,20 +3708,18 @@
         "circuitBreaker": {
           "type": "object",
           "properties": {
+            "enabled": {
+              "type": "boolean"
+            },
             "maxToolCalls": {
               "type": "integer",
               "minimum": 10,
               "maximum": 9007199254740991
             },
-            "windowSize": {
+            "consecutiveThreshold": {
               "type": "integer",
               "minimum": 5,
               "maximum": 9007199254740991
-            },
-            "repetitionThresholdPercent": {
-              "type": "number",
-              "exclusiveMinimum": 0,
-              "maximum": 100
             }
           },
           "additionalProperties": false

package/dist/features/background-agent/constants.d.ts

@@ -6,8 +6,8 @@ export declare const MIN_STABILITY_TIME_MS: number;
 export declare const DEFAULT_STALE_TIMEOUT_MS = 1200000;
 export declare const DEFAULT_MESSAGE_STALENESS_TIMEOUT_MS = 1800000;
 export declare const DEFAULT_MAX_TOOL_CALLS = 200;
-export declare const DEFAULT_CIRCUIT_BREAKER_WINDOW_SIZE = 20;
-export declare const DEFAULT_CIRCUIT_BREAKER_REPETITION_THRESHOLD_PERCENT = 80;
+export declare const DEFAULT_CIRCUIT_BREAKER_CONSECUTIVE_THRESHOLD = 20;
+export declare const DEFAULT_CIRCUIT_BREAKER_ENABLED = true;
 export declare const MIN_RUNTIME_BEFORE_STALE_MS = 30000;
 export declare const MIN_IDLE_TIME_MS = 5000;
 export declare const POLLING_INTERVAL_MS = 3000;

package/dist/features/background-agent/loop-detector.d.ts

@@ -1,17 +1,16 @@
 import type { BackgroundTaskConfig } from "../../config/schema";
 import type { ToolCallWindow } from "./types";
 export interface CircuitBreakerSettings {
+    enabled: boolean;
     maxToolCalls: number;
-    windowSize: number;
-    repetitionThresholdPercent: number;
+    consecutiveThreshold: number;
 }
 export interface ToolLoopDetectionResult {
     triggered: boolean;
     toolName?: string;
     repeatedCount?: number;
-    sampleSize?: number;
-    thresholdPercent?: number;
 }
 export declare function resolveCircuitBreakerSettings(config?: BackgroundTaskConfig): CircuitBreakerSettings;
-export declare function recordToolCall(window: ToolCallWindow | undefined, toolName: string, settings: CircuitBreakerSettings): ToolCallWindow;
+export declare function recordToolCall(window: ToolCallWindow | undefined, toolName: string, settings: CircuitBreakerSettings, toolInput?: Record<string, unknown> | null): ToolCallWindow;
+export declare function createToolCallSignature(toolName: string, toolInput?: Record<string, unknown> | null): string;
 export declare function detectRepetitiveToolUse(window: ToolCallWindow | undefined): ToolLoopDetectionResult;

package/dist/features/background-agent/manager.d.ts

@@ -45,6 +45,7 @@ export declare class BackgroundManager {
     private preStartDescendantReservations;
     private enableParentSessionNotifications;
     readonly taskHistory: TaskHistory;
+    private cachedCircuitBreakerSettings?;
     constructor(ctx: PluginInput, config?: BackgroundTaskConfig, options?: {
         tmuxConfig?: TmuxConfig;
         onSubagentSessionCreated?: OnSubagentSessionCreated;

package/dist/features/background-agent/session-status-classifier.d.ts

@@ -0,0 +1,2 @@
+export declare function isActiveSessionStatus(type: string): boolean;
+export declare function isTerminalSessionStatus(type: string): boolean;

package/dist/features/background-agent/types.d.ts

@@ -2,15 +2,15 @@ import type { FallbackEntry } from "../../shared/model-requirements";
 import type { SessionPermissionRule } from "../../shared/question-denied-session-permission";
 export type BackgroundTaskStatus = "pending" | "running" | "completed" | "error" | "cancelled" | "interrupt";
 export interface ToolCallWindow {
-    toolNames: string[];
-    windowSize: number;
-    thresholdPercent: number;
+    lastSignature: string;
+    consecutiveCount: number;
+    threshold: number;
 }
 export interface TaskProgress {
     toolCalls: number;
     lastTool?: string;
     toolCallWindow?: ToolCallWindow;
-    countedToolPartIDs?: string[];
+    countedToolPartIDs?: Set<string>;
     lastUpdate: Date;
     lastMessage?: string;
     lastMessageAt?: Date;

package/dist/features/builtin-commands/templates/start-work.d.ts

@@ -1 +1 @@
-export declare const START_WORK_TEMPLATE = "You are starting a Sisyphus work session.\n\n## ARGUMENTS\n\n- `/start-work [plan-name] [--worktree <path>]`\n  - `plan-name` (optional): name or partial match of the plan to start\n  - `--worktree <path>` (optional): absolute path to an existing git worktree to work in\n    - If specified and valid: hook pre-sets worktree_path in boulder.json\n    - If specified but invalid: you must run `git worktree add <path> <branch>` first\n    - If omitted: you MUST choose or create a worktree (see Worktree Setup below)\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Prometheus-generated plan files at `.sisyphus/plans/`\n\n2. **Check for active boulder state**: Read `.sisyphus/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.sisyphus/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Worktree Setup** (when `worktree_path` not already set in boulder.json):\n   1. `git worktree list --porcelain` \u2014 see available worktrees\n   2. Create: `git worktree add <absolute-path> <branch-or-HEAD>`\n   3. Update boulder.json to add `\"worktree_path\": \"<absolute-path>\"`\n   4. All work happens inside that worktree directory\n\n5. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\",\n     \"worktree_path\": \"/absolute/path/to/git/worktree\"\n   }\n   ```\n\n6. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\nWorktree: {worktree_path}\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\nWorktree: {worktree_path}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- Always set worktree_path in boulder.json before executing any tasks\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)";
+export declare const START_WORK_TEMPLATE = "You are starting a Sisyphus work session.\n\n## ARGUMENTS\n\n- `/start-work [plan-name] [--worktree <path>]`\n  - `plan-name` (optional): name or partial match of the plan to start\n  - `--worktree <path>` (optional): absolute path to an existing git worktree to work in\n    - If specified and valid: hook pre-sets worktree_path in boulder.json\n    - If specified but invalid: you must run `git worktree add <path> <branch>` first\n    - If omitted: work directly in the current project directory (no worktree)\n\n## WHAT TO DO\n\n1. **Find available plans**: Search for Prometheus-generated plan files at `.sisyphus/plans/`\n\n2. **Check for active boulder state**: Read `.sisyphus/boulder.json` if it exists\n\n3. **Decision logic**:\n   - If `.sisyphus/boulder.json` exists AND plan is NOT complete (has unchecked boxes):\n     - **APPEND** current session to session_ids\n     - Continue work on existing plan\n   - If no active plan OR plan is complete:\n     - List available plan files\n     - If ONE plan: auto-select it\n     - If MULTIPLE plans: show list with timestamps, ask user to select\n\n4. **Worktree Setup** (ONLY when `--worktree` was explicitly specified and `worktree_path` not already set in boulder.json):\n   1. `git worktree list --porcelain` \u2014 see available worktrees\n   2. Create: `git worktree add <absolute-path> <branch-or-HEAD>`\n   3. Update boulder.json to add `\"worktree_path\": \"<absolute-path>\"`\n   4. All work happens inside that worktree directory\n\n5. **Create/Update boulder.json**:\n   ```json\n   {\n     \"active_plan\": \"/absolute/path/to/plan.md\",\n     \"started_at\": \"ISO_TIMESTAMP\",\n     \"session_ids\": [\"session_id_1\", \"session_id_2\"],\n     \"plan_name\": \"plan-name\",\n     \"worktree_path\": \"/absolute/path/to/git/worktree\"\n   }\n   ```\n\n6. **Read the plan file** and start executing tasks according to atlas workflow\n\n## OUTPUT FORMAT\n\nWhen listing plans for selection:\n```\nAvailable Work Plans\n\nCurrent Time: {ISO timestamp}\nSession ID: {current session id}\n\n1. [plan-name-1.md] - Modified: {date} - Progress: 3/10 tasks\n2. [plan-name-2.md] - Modified: {date} - Progress: 0/5 tasks\n\nWhich plan would you like to work on? (Enter number or plan name)\n```\n\nWhen resuming existing work:\n```\nResuming Work Session\n\nActive Plan: {plan-name}\nProgress: {completed}/{total} tasks\nSessions: {count} (appending current session)\nWorktree: {worktree_path}\n\nReading plan and continuing from last incomplete task...\n```\n\nWhen auto-selecting single plan:\n```\nStarting Work Session\n\nPlan: {plan-name}\nSession ID: {session_id}\nStarted: {timestamp}\nWorktree: {worktree_path}\n\nReading plan and beginning execution...\n```\n\n## CRITICAL\n\n- The session_id is injected by the hook - use it directly\n- Always update boulder.json BEFORE starting work\n- If worktree_path is set in boulder.json, all work happens inside that worktree directory\n- Read the FULL plan file before delegating any tasks\n- Follow atlas delegation protocols (7-section format)\n\n## TASK BREAKDOWN (MANDATORY)\n\nAfter reading the plan file, you MUST decompose every plan task into granular, implementation-level sub-steps and register ALL of them as task/todo items BEFORE starting any work.\n\n**How to break down**:\n- Each plan checkbox item (e.g., `- [ ] Add user authentication`) must be split into concrete, actionable sub-tasks\n- Sub-tasks should be specific enough that each one touches a clear set of files/functions\n- Include: file to modify, what to change, expected behavior, and how to verify\n- Do NOT leave any task vague \u2014 \"implement feature X\" is NOT acceptable; \"add validateToken() to src/auth/middleware.ts that checks JWT expiry and returns 401\" IS acceptable\n\n**Example breakdown**:\nPlan task: `- [ ] Add rate limiting to API`\n\u2192 Todo items:\n  1. Create `src/middleware/rate-limiter.ts` with sliding window algorithm (max 100 req/min per IP)\n  2. Add RateLimiter middleware to `src/app.ts` router chain, before auth middleware\n  3. Add rate limit headers (X-RateLimit-Limit, X-RateLimit-Remaining) to response in `rate-limiter.ts`\n  4. Add test: verify 429 response after exceeding limit in `src/middleware/rate-limiter.test.ts`\n  5. Add test: verify headers are present on normal responses\n\nRegister these as task/todo items so progress is tracked and visible throughout the session.\n\n## WORKTREE COMPLETION\n\nWhen working in a worktree (`worktree_path` is set in boulder.json) and ALL plan tasks are complete:\n1. Commit all remaining changes in the worktree\n2. Switch to the main working directory (the original repo, NOT the worktree)\n3. Merge the worktree branch into the current branch: `git merge <worktree-branch>`\n4. If merge succeeds, clean up: `git worktree remove <worktree-path>`\n5. Remove the boulder.json state\n\nThis is the DEFAULT behavior when `--worktree` was used. Skip merge only if the user explicitly instructs otherwise (e.g., asks to create a PR instead).";

package/dist/hooks/index.d.ts

@@ -48,3 +48,4 @@ export { createWriteExistingFileGuardHook } from "./write-existing-file-guard";
 export { createHashlineReadEnhancerHook } from "./hashline-read-enhancer";
 export { createJsonErrorRecoveryHook, JSON_ERROR_TOOL_EXCLUDE_LIST, JSON_ERROR_PATTERNS, JSON_ERROR_REMINDER } from "./json-error-recovery";
 export { createReadImageResizerHook } from "./read-image-resizer";
+export { createTodoDescriptionOverrideHook } from "./todo-description-override";

package/dist/hooks/todo-description-override/description.d.ts

@@ -0,0 +1 @@
+export declare const TODOWRITE_DESCRIPTION = "Use this tool to create and manage a structured task list for tracking progress on multi-step work.\n\n## Todo Format (MANDATORY)\n\nEach todo title MUST encode four elements: WHERE, WHY, HOW, and EXPECTED RESULT.\n\nFormat: \"[WHERE] [HOW] to [WHY] \u2014 expect [RESULT]\"\n\nGOOD:\n- \"src/utils/validation.ts: Add validateEmail() for input sanitization \u2014 returns boolean\"\n- \"UserService.create(): Call validateEmail() before DB insert \u2014 rejects invalid emails with 400\"\n- \"validation.test.ts: Add test for missing @ sign \u2014 expect validateEmail('foo') to return false\"\n\nBAD:\n- \"Implement email validation\" (where? how? what result?)\n- \"Add dark mode\" (this is a feature, not a todo)\n- \"Fix auth\" (what file? what changes? what's expected?)\n\n## Granularity Rules\n\nEach todo MUST be a single atomic action completable in 1-3 tool calls. If it needs more, split it.\n\n**Size test**: Can you complete this todo by editing one file or running one command? If not, it's too big.\n\n## Task Management\n- One in_progress at a time. Complete it before starting the next.\n- Mark completed immediately after finishing each item.\n- Skip this tool for single trivial tasks (one-step, obvious action).";

package/dist/hooks/todo-description-override/hook.d.ts

@@ -0,0 +1,8 @@
+export declare function createTodoDescriptionOverrideHook(): {
+    "tool.definition": (input: {
+        toolID: string;
+    }, output: {
+        description: string;
+        parameters: unknown;
+    }) => Promise<void>;
+};

package/dist/hooks/todo-description-override/index.d.ts

@@ -0,0 +1 @@
+export { createTodoDescriptionOverrideHook } from "./hook";