@liangjie559567/ultrapower 5.5.20 → 5.5.21

package/dist/hooks/todo-continuation/index.js

@@ -0,0 +1,364 @@
+/**
+ * Todo Continuation Enforcer Hook
+ *
+ * Prevents stopping when incomplete tasks remain in the todo list.
+ * Forces the agent to continue until all tasks are marked complete.
+ *
+ * Ported from oh-my-opencode's todo-continuation-enforcer hook.
+ */
+/**
+ * TERMINOLOGY:
+ * - "Task" (capitalized): New Claude Code Task system (~/.claude/tasks/)
+ * - "todo" (lowercase): Legacy todo system (~/.claude/todos/)
+ * - "item": Generic term for either Task or todo
+ */
+/**
+ * Debug logging for task/todo operations.
+ * Set OMC_DEBUG=1 or OMC_DEBUG=todo-continuation for verbose output.
+ */
+function debugLog(message, ...args) {
+    const debug = process.env.OMC_DEBUG;
+    if (debug === '1' || debug === 'todo-continuation' || debug === 'true') {
+        console.error('[todo-continuation]', message, ...args);
+    }
+}
+import { existsSync, readFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { getClaudeConfigDir } from '../../utils/paths.js';
+import { safeJsonParse } from '../../lib/safe-json.js';
+/**
+ * Validates that a session ID is safe to use in file paths.
+ * Session IDs should be alphanumeric with optional hyphens and underscores.
+ * This prevents path traversal attacks (e.g., "../../../etc").
+ *
+ * @param sessionId - The session ID to validate
+ * @returns true if the session ID is safe, false otherwise
+ */
+export function isValidSessionId(sessionId) {
+    if (!sessionId || typeof sessionId !== 'string') {
+        return false;
+    }
+    // Allow alphanumeric, hyphens, and underscores only
+    // Must be 1-256 characters (reasonable length limit)
+    // Must not start with a dot (hidden files) or hyphen
+    const SAFE_SESSION_ID_PATTERN = /^[a-zA-Z0-9][a-zA-Z0-9_-]{0,255}$/;
+    return SAFE_SESSION_ID_PATTERN.test(sessionId);
+}
+/**
+ * Detect if stop was due to user abort (not natural completion)
+ *
+ * WARNING: These patterns are ASSUMED based on common conventions.
+ * As of 2025-01, Anthropic's Stop hook input schema does not document
+ * the exact stop_reason values. The patterns below are educated guesses:
+ *
+ * - user_cancel, user_interrupt: Likely user-initiated via UI
+ * - ctrl_c: Terminal interrupt (Ctrl+C)
+ * - manual_stop: Explicit stop button
+ * - abort, cancel, interrupt: Generic abort patterns
+ *
+ * NOTE: Per official Anthropic docs, the Stop hook "Does not run if
+ * the stoppage occurred due to a user interrupt." This means this
+ * function may never receive user-abort contexts in practice.
+ * It is kept as defensive code in case the behavior changes.
+ *
+ * If the hook fails to detect user aborts correctly, these patterns
+ * should be updated based on observed Claude Code behavior.
+ */
+export function isUserAbort(context) {
+    if (!context)
+        return false;
+    // User explicitly requested stop (supports both camelCase and snake_case)
+    if (context.user_requested || context.userRequested)
+        return true;
+    // Check stop_reason patterns indicating user abort
+    // Exact-match patterns: short generic words that cause false positives with .includes()
+    const exactPatterns = ['aborted', 'abort', 'cancel', 'interrupt'];
+    // Substring patterns: compound words safe for .includes() matching
+    const substringPatterns = ['user_cancel', 'user_interrupt', 'ctrl_c', 'manual_stop'];
+    // Support both snake_case and camelCase field names
+    const reason = (context.stop_reason ?? context.stopReason ?? '').toLowerCase();
+    return exactPatterns.some(p => reason === p) ||
+        substringPatterns.some(p => reason.includes(p));
+}
+/**
+ * Detect if stop was triggered by context-limit related reasons.
+ * When context is exhausted, Claude Code needs to stop so it can compact.
+ * Blocking these stops causes a deadlock: can't compact because can't stop,
+ * can't continue because context is full.
+ *
+ * See: https://github.com/liangjie559567/ultrapower/issues/213
+ */
+export function isContextLimitStop(context) {
+    if (!context)
+        return false;
+    const reason = (context.stop_reason ?? context.stopReason ?? '').toLowerCase();
+    const endTurnReason = (context.end_turn_reason ?? context.endTurnReason ?? '').toLowerCase();
+    const contextPatterns = [
+        'context_limit', 'context_window', 'context_exceeded', 'context_full',
+        'max_context', 'token_limit', 'max_tokens', 'conversation_too_long', 'input_too_long'
+    ];
+    return contextPatterns.some(p => reason.includes(p) || endTurnReason.includes(p));
+}
+/**
+ * Get possible todo file locations
+ */
+function getTodoFilePaths(sessionId, directory) {
+    const claudeDir = getClaudeConfigDir();
+    const paths = [];
+    // Session-specific todos
+    if (sessionId) {
+        paths.push(join(claudeDir, 'sessions', sessionId, 'todos.json'));
+        paths.push(join(claudeDir, 'todos', `${sessionId}.json`));
+    }
+    // Project-specific todos
+    if (directory) {
+        paths.push(join(directory, '.omc', 'todos.json'));
+        paths.push(join(directory, '.claude', 'todos.json'));
+    }
+    // NOTE: Global todos directory scan removed to prevent false positives.
+    // Only session-specific and project-local todos are now checked.
+    return paths;
+}
+/**
+ * Parse todo file content
+ */
+function parseTodoFile(filePath) {
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const result = safeJsonParse(content, filePath);
+        if (!result.success) {
+            return [];
+        }
+        const data = result.data;
+        // Handle array format
+        if (Array.isArray(data)) {
+            return data.filter(item => item &&
+                typeof item.content === 'string' &&
+                typeof item.status === 'string');
+        }
+        // Handle object format with todos array
+        if (data && typeof data === 'object' && 'todos' in data && Array.isArray(data.todos)) {
+            return data.todos.filter((item) => {
+                const todo = item;
+                return (todo &&
+                    typeof todo.content === 'string' &&
+                    typeof todo.status === 'string');
+            });
+        }
+        return [];
+    }
+    catch (err) {
+        debugLog('Failed to parse todo file:', filePath, err);
+        return [];
+    }
+}
+/**
+ * Check if a todo is incomplete
+ */
+function isIncomplete(todo) {
+    return todo.status !== 'completed' && todo.status !== 'cancelled';
+}
+/**
+ * Get the Task directory for a session
+ *
+ * NOTE: This path (~/.claude/tasks/{sessionId}/) is inferred from Claude Code's
+ * implementation. Anthropic has not officially documented this structure.
+ * The Task files are created by Claude Code's TaskCreate tool.
+ */
+export function getTaskDirectory(sessionId) {
+    // Security: validate sessionId before constructing path
+    if (!isValidSessionId(sessionId)) {
+        return ''; // Return empty string for invalid sessions
+    }
+    return join(getClaudeConfigDir(), 'tasks', sessionId);
+}
+/**
+ * Validates that a parsed JSON object is a valid Task.
+ * Required fields: id (string), subject (string), status (string).
+ */
+export function isValidTask(data) {
+    if (data === null || typeof data !== 'object')
+        return false;
+    const obj = data;
+    return (typeof obj.id === 'string' && obj.id.length > 0 &&
+        typeof obj.subject === 'string' && obj.subject.length > 0 &&
+        typeof obj.status === 'string' &&
+        // Accept 'deleted' as valid - matches Task interface status union type
+        ['pending', 'in_progress', 'completed', 'deleted'].includes(obj.status));
+}
+/**
+ * Read all Task files from a session's task directory
+ */
+export function readTaskFiles(sessionId) {
+    if (!isValidSessionId(sessionId)) {
+        return [];
+    }
+    const taskDir = getTaskDirectory(sessionId);
+    if (!taskDir || !existsSync(taskDir))
+        return [];
+    const tasks = [];
+    try {
+        for (const file of readdirSync(taskDir)) {
+            // Skip non-JSON files and .lock file (used by Claude Code for atomic writes)
+            // The .lock file prevents concurrent modifications to task files
+            if (!file.endsWith('.json') || file === '.lock')
+                continue;
+            try {
+                const content = readFileSync(join(taskDir, file), 'utf-8');
+                const result = safeJsonParse(content, file);
+                if (result.success && isValidTask(result.data)) {
+                    tasks.push(result.data);
+                }
+            }
+            catch (err) {
+                debugLog('Failed to parse task file:', file, err);
+            }
+        }
+    }
+    catch (err) {
+        debugLog('Failed to read task directory:', sessionId, err);
+    }
+    return tasks;
+}
+/**
+ * Check if a Task is incomplete.
+ *
+ * NOTE: Task system has 3 statuses (pending, in_progress, completed).
+ * The TaskUpdate tool also supports 'deleted' status, but deleted task files
+ * may be removed rather than marked. If a 'deleted' status is encountered,
+ * we treat it as complete (not requiring continuation).
+ *
+ * Unlike legacy todos, Tasks do not have a 'cancelled' status. The Task system
+ * uses 'deleted' for removal, which is handled by file deletion rather than
+ * status change.
+ */
+export function isTaskIncomplete(task) {
+    // Treat 'completed' and any unknown/deleted status as complete
+    return task.status === 'pending' || task.status === 'in_progress';
+}
+/**
+ * Check for incomplete tasks in the new Task system
+ *
+ * SYNC NOTICE: This function is intentionally duplicated across:
+ * - templates/hooks/persistent-mode.mjs
+ * - templates/hooks/stop-continuation.mjs
+ * - src/hooks/todo-continuation/index.ts (as checkIncompleteTasks)
+ *
+ * Templates cannot import shared modules (they're standalone scripts).
+ * When modifying this logic, update ALL THREE files to maintain consistency.
+ */
+export function checkIncompleteTasks(sessionId) {
+    if (!isValidSessionId(sessionId)) {
+        return { count: 0, tasks: [], total: 0 };
+    }
+    const tasks = readTaskFiles(sessionId);
+    const incomplete = tasks.filter(isTaskIncomplete);
+    return {
+        count: incomplete.length,
+        tasks: incomplete,
+        total: tasks.length
+    };
+}
+/**
+ * Check for incomplete todos in the legacy system
+ */
+export function checkLegacyTodos(sessionId, directory) {
+    const paths = getTodoFilePaths(sessionId, directory);
+    const seenContents = new Set();
+    const allTodos = [];
+    const incompleteTodos = [];
+    for (const p of paths) {
+        if (!existsSync(p))
+            continue;
+        const todos = parseTodoFile(p);
+        for (const todo of todos) {
+            const key = `${todo.content}:${todo.status}`;
+            if (seenContents.has(key))
+                continue;
+            seenContents.add(key);
+            allTodos.push(todo);
+            if (isIncomplete(todo)) {
+                incompleteTodos.push(todo);
+            }
+        }
+    }
+    return {
+        count: incompleteTodos.length,
+        todos: incompleteTodos,
+        total: allTodos.length,
+        source: incompleteTodos.length > 0 ? 'todo' : 'none'
+    };
+}
+/**
+ * Check for incomplete todos/tasks across all possible locations.
+ * Checks new Task system first, then falls back to legacy todos.
+ *
+ * Priority Logic:
+ * - If Task system has incomplete items, returns Task count only (source: 'task' or 'both')
+ * - The returned count reflects Tasks only because Tasks are the authoritative source
+ * - Legacy todos are checked to set source='both' for informational purposes
+ * - If no incomplete Tasks exist, returns legacy todo count (source: 'todo')
+ *
+ * NOTE ON COUNTING: Shell templates use a combined Task + Todo count for the
+ * "should continue?" boolean check, which may differ from the count returned here.
+ * The boolean decision (continue or not) is equivalent; only the displayed count differs.
+ */
+export async function checkIncompleteTodos(sessionId, directory, stopContext) {
+    // If user aborted, don't force continuation
+    if (isUserAbort(stopContext)) {
+        return { count: 0, todos: [], total: 0, source: 'none' };
+    }
+    let taskResult = null;
+    // Priority 1: Check new Task system (if sessionId provided)
+    if (sessionId) {
+        taskResult = checkIncompleteTasks(sessionId);
+    }
+    // Priority 2: Check legacy todo system
+    const todoResult = checkLegacyTodos(sessionId, directory);
+    // Combine results (prefer Tasks if available)
+    if (taskResult && taskResult.count > 0) {
+        return {
+            count: taskResult.count,
+            // taskResult.tasks only contains incomplete tasks (pending/in_progress)
+            // so status is safe to cast to Todo['status'] (no 'deleted' will appear)
+            todos: taskResult.tasks.map(t => ({
+                content: t.subject,
+                status: t.status,
+                id: t.id
+            })),
+            total: taskResult.total,
+            source: todoResult.count > 0 ? 'both' : 'task'
+        };
+    }
+    return todoResult;
+}
+/**
+ * Create a Todo Continuation hook instance
+ */
+export function createTodoContinuationHook(directory) {
+    return {
+        checkIncomplete: (sessionId) => checkIncompleteTodos(sessionId, directory)
+    };
+}
+/**
+ * Get formatted status string for todos
+ */
+export function formatTodoStatus(result) {
+    if (result.count === 0) {
+        return `All tasks complete (${result.total} total)`;
+    }
+    return `${result.total - result.count}/${result.total} completed, ${result.count} remaining`;
+}
+/**
+ * Get the next pending todo
+ */
+export function getNextPendingTodo(result) {
+    // First try to find one that's in_progress
+    const inProgress = result.todos.find(t => t.status === 'in_progress');
+    if (inProgress) {
+        return inProgress;
+    }
+    // Otherwise return first pending
+    return result.todos.find(t => t.status === 'pending') ?? null;
+}
+//# sourceMappingURL=index.js.map

package/dist/hooks/todo-continuation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/todo-continuation/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;;;GAKG;AAEH;;;GAGG;AACH,SAAS,QAAQ,CAAC,OAAe,EAAE,GAAG,IAAe;IACnD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC;IACpC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,mBAAmB,IAAI,KAAK,KAAK,MAAM,EAAE,CAAC;QACvE,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IACzD,CAAC;AACH,CAAC;AAED,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,oDAAoD;IACpD,qDAAqD;IACrD,qDAAqD;IACrD,MAAM,uBAAuB,GAAG,mCAAmC,CAAC;IACpE,OAAO,uBAAuB,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AACjD,CAAC;AAyED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAC,OAAqB;IAC/C,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,0EAA0E;IAC1E,IAAI,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,aAAa;QAAE,OAAO,IAAI,CAAC;IAEjE,mDAAmD;IACnD,wFAAwF;IACxF,MAAM,aAAa,GAAG,CAAC,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC;IAClE,mEAAmE;IACnE,MAAM,iBAAiB,GAAG,CAAC,aAAa,EAAE,gBAAgB,EAAE,QAAQ,EAAE,aAAa,CAAC,CAAC;IAErF,oDAAoD;IACpD,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/E,OAAO,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC;QACrC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,kBAAkB,CAAC,OAAqB;IACtD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,MAAM,MAAM,GAAG,CAAC,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/E,MAAM,aAAa,GAAG,CAAC,OAAO,CAAC,eAAe,IAAI,OAAO,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAE7F,MAAM,eAAe,GAAG;QACtB,eAAe,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,cAAc;QACrE,aAAa,EAAE,aAAa,EAAE,YAAY,EAAE,uBAAuB,EAAE,gBAAgB;KACtF,CAAC;IAEF,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;AACpF,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,SAAkB,EAAE,SAAkB;IAC9D,MAAM,SAAS,GAAG,kBAAkB,EAAE,CAAC;IACvC,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,yBAAyB;IACzB,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;QACjE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,OAAO,EAAE,GAAG,SAAS,OAAO,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,yBAAyB;IACzB,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,CAAC,CAAC,CAAC;QAClD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,wEAAwE;IACxE,iEAAiE;IAEjE,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,SAAS,aAAa,CAAC,QAAgB;IACrC,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;QAEhD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC;QAEzB,sBAAsB;QACtB,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACxB,OAAO,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CACxB,IAAI;gBACJ,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;gBAChC,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAChC,CAAC;QACJ,CAAC;QAED,wCAAwC;QACxC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,OAAO,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,CAAE,IAAY,CAAC,KAAK,CAAC,EAAE,CAAC;YAC9F,OAAQ,IAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAa,EAAE,EAAE;gBAClD,MAAM,IAAI,GAAG,IAA+B,CAAC;gBAC7C,OAAO,CACL,IAAI;oBACJ,OAAO,IAAI,CAAC,OAAO,KAAK,QAAQ;oBAChC,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAChC,CAAC;YACJ,CAAC,CAAW,CAAC;QACf,CAAC;QAED,OAAO,EAAE,CAAC;IACZ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,4BAA4B,EAAE,QAAQ,EAAE,GAAG,CAAC,CAAC;QACtD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,SAAS,YAAY,CAAC,IAAU;IAC9B,OAAO,IAAI,CAAC,MAAM,KAAK,WAAW,IAAI,IAAI,CAAC,MAAM,KAAK,WAAW,CAAC;AACpE,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAiB;IAChD,wDAAwD;IACxD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC,CAAC,2CAA2C;IACxD,CAAC;IACD,OAAO,IAAI,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC;AACxD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,IAAa;IACvC,IAAI,IAAI,KAAK,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC5D,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,OAAO,CACL,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,IAAI,GAAG,CAAC,EAAE,CAAC,MAAM,GAAG,CAAC;QAC/C,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC;QACzD,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ;QAC9B,uEAAuE;QACvE,CAAC,SAAS,EAAE,aAAa,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CACxE,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,SAAiB;IAC7C,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,CAAC;IAC5C,IAAI,CAAC,OAAO,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,EAAE,CAAC;IAEhD,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,IAAI,CAAC;QACH,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,OAAO,CAAC,EAAE,CAAC;YACxC,6EAA6E;YAC7E,iEAAiE;YACjE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,KAAK,OAAO;gBAAE,SAAS;YAC1D,IAAI,CAAC;gBACH,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBAC3D,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;gBAC5C,IAAI,MAAM,CAAC,OAAO,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC/C,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,IAAY,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,QAAQ,CAAC,4BAA4B,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;YACpD,CAAC;QACH,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,QAAQ,CAAC,gCAAgC,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAU;IACzC,+DAA+D;IAC/D,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,aAAa,CAAC;AACpE,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,oBAAoB,CAAC,SAAiB;IACpD,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC;QACjC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;IAC3C,CAAC;IACD,MAAM,KAAK,GAAG,aAAa,CAAC,SAAS,CAAC,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC;IAClD,OAAO;QACL,KAAK,EAAE,UAAU,CAAC,MAAM;QACxB,KAAK,EAAE,UAAU;QACjB,KAAK,EAAE,KAAK,CAAC,MAAM;KACpB,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,SAAkB,EAAE,SAAkB;IACrE,MAAM,KAAK,GAAG,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACrD,MAAM,YAAY,GAAG,IAAI,GAAG,EAAU,CAAC;IACvC,MAAM,QAAQ,GAAW,EAAE,CAAC;IAC5B,MAAM,eAAe,GAAW,EAAE,CAAC;IAEnC,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAE7B,MAAM,KAAK,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC;QAC/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,GAAG,GAAG,GAAG,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAC7C,IAAI,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpC,YAAY,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACpB,IAAI,YAAY,CAAC,IAAI,CAAC,EAAE,CAAC;gBACvB,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC7B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,EAAE,eAAe,CAAC,MAAM;QAC7B,KAAK,EAAE,eAAe;QACtB,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,MAAM,EAAE,eAAe,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;KACrD,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,SAAkB,EAClB,SAAkB,EAClB,WAAyB;IAEzB,4CAA4C;IAC5C,IAAI,WAAW,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAC3D,CAAC;IAED,IAAI,UAAU,GAA2B,IAAI,CAAC;IAE9C,4DAA4D;IAC5D,IAAI,SAAS,EAAE,CAAC;QACd,UAAU,GAAG,oBAAoB,CAAC,SAAS,CAAC,CAAC;IAC/C,CAAC;IAED,uCAAuC;IACvC,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAE1D,8CAA8C;IAC9C,IAAI,UAAU,IAAI,UAAU,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvC,OAAO;YACL,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,wEAAwE;YACxE,yEAAyE;YACzE,KAAK,EAAE,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChC,OAAO,EAAE,CAAC,CAAC,OAAO;gBAClB,MAAM,EAAE,CAAC,CAAC,MAAwB;gBAClC,EAAE,EAAE,CAAC,CAAC,EAAE;aACT,CAAC,CAAC;YACH,KAAK,EAAE,UAAU,CAAC,KAAK;YACvB,MAAM,EAAE,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;SAC/C,CAAC;IACJ,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,SAAiB;IAC1D,OAAO;QACL,eAAe,EAAE,CAAC,SAAkB,EAAE,EAAE,CACtC,oBAAoB,CAAC,SAAS,EAAE,SAAS,CAAC;KAC7C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,MAA6B;IAC5D,IAAI,MAAM,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,uBAAuB,MAAM,CAAC,KAAK,SAAS,CAAC;IACtD,CAAC;IAED,OAAO,GAAG,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,KAAK,eAAe,MAAM,CAAC,KAAK,YAAY,CAAC;AAC/F,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA6B;IAC9D,2CAA2C;IAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,aAAa,CAAC,CAAC;IACtE,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,iCAAiC;IACjC,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC;AAChE,CAAC"}

package/dist/hooks/ultrapilot/index.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Ultrapilot Coordinator
+ *
+ * Manages parallel worker spawning and coordination for ultrapilot mode.
+ * Decomposes tasks, spawns workers (max 5), tracks progress, and integrates results
+ * while managing file ownership to avoid conflicts.
+ */
+import type { UltrapilotConfig, UltrapilotState, WorkerState, IntegrationResult } from './types.js';
+export { generateDecompositionPrompt, parseDecompositionResult, generateParallelGroups, validateFileOwnership, extractSharedFiles, toSimpleSubtasks, DEFAULT_SHARED_FILE_PATTERNS } from './decomposer.js';
+export type { DecomposedTask, DecompositionResult, DecompositionOptions, AgentType, ModelTier } from './decomposer.js';
+/**
+ * Start ultrapilot coordinator
+ *
+ * Entry point for ultrapilot - decomposes task and spawns parallel workers.
+ *
+ * @param cwd - Current working directory
+ * @param task - Task description to parallelize
+ * @param config - Configuration options
+ * @returns Initialized ultrapilot state
+ */
+export declare function startUltrapilot(cwd: string, task: string, config?: Partial<UltrapilotConfig>, sessionId?: string): Promise<UltrapilotState>;
+/**
+ * Decompose a task into parallelizable subtasks
+ *
+ * Uses heuristics to identify independent work units that can be executed in parallel.
+ * For more intelligent decomposition with file ownership and dependencies, use the
+ * AI-powered decomposition functions:
+ *
+ * @example AI-powered decomposition (recommended for complex tasks):
+ * ```typescript
+ * import {
+ *   generateDecompositionPrompt,
+ *   parseDecompositionResult,
+ *   toSimpleSubtasks
+ * } from './decomposer.js';
+ *
+ * // Generate prompt for Architect agent
+ * const prompt = generateDecompositionPrompt(task, codebaseContext);
+ *
+ * // Call Architect agent (via Task tool in orchestrator)
+ * const response = await Task({
+ *   subagent_type: 'ultrapower:architect',
+ *   model: 'opus',
+ *   prompt
+ * });
+ *
+ * // Parse structured result with file ownership
+ * const result = parseDecompositionResult(response);
+ *
+ * // Use result.subtasks for full DecomposedTask objects with:
+ * // - id, description, files, blockedBy, agentType, model
+ * // Or convert to simple strings for legacy compatibility:
+ * const subtasks = toSimpleSubtasks(result);
+ * ```
+ *
+ * @param task - Task description
+ * @param config - Configuration options
+ * @returns Array of subtask descriptions
+ */
+export declare function decomposeTask(task: string, config: Required<UltrapilotConfig>): Promise<string[]>;
+/**
+ * Spawn parallel workers for subtasks
+ *
+ * Creates Task agents for each subtask with non-overlapping file ownership.
+ *
+ * @param cwd - Current working directory
+ * @param subtasks - Array of subtask descriptions
+ * @param config - Configuration options
+ * @returns Array of spawned worker states
+ */
+export declare function spawnWorkers(cwd: string, subtasks: string[], config?: Partial<UltrapilotConfig>): Promise<WorkerState[]>;
+/**
+ * Track progress of running workers
+ *
+ * Polls TaskOutput to check worker status and updates state accordingly.
+ *
+ * @param cwd - Current working directory
+ * @returns Object with completed, running, and failed worker counts
+ */
+export declare function trackProgress(cwd: string): Promise<{
+    completed: number;
+    running: number;
+    failed: number;
+    total: number;
+}>;
+/**
+ * Integrate results from completed workers
+ *
+ * Merges outputs, detects conflicts, and produces final integration result.
+ *
+ * @param cwd - Current working directory
+ * @returns Integration result with files, conflicts, and summary
+ */
+export declare function integrateResults(cwd: string): Promise<IntegrationResult>;
+/**
+ * Handle shared files that multiple workers might need to access
+ *
+ * Coordinator maintains exclusive ownership of shared files (package.json, etc.)
+ * and provides a mechanism for workers to request changes.
+ *
+ * @param cwd - Current working directory
+ * @param files - List of files to mark as shared
+ * @returns Updated ownership state
+ */
+export declare function handleSharedFiles(cwd: string, files: string[]): Promise<boolean>;
+/**
+ * Check if a file is owned by a specific worker
+ */
+export declare function isFileOwnedByWorker(cwd: string, workerId: string, filePath: string): boolean;
+/**
+ * Check if a file is shared (owned by coordinator)
+ */
+export declare function isSharedFile(cwd: string, filePath: string): boolean;
+/**
+ * Assign file ownership to a worker
+ */
+export declare function assignFileToWorker(cwd: string, workerId: string, filePath: string): boolean;
+export type { UltrapilotConfig, UltrapilotState, WorkerState, IntegrationResult, FileOwnership } from './types.js';
+export { DEFAULT_CONFIG } from './types.js';
+export { readUltrapilotState, writeUltrapilotState, initUltrapilot, addWorker, updateWorkerState, completeWorker, failWorker, completeUltrapilot, getCompletedWorkers, getRunningWorkers, getFailedWorkers, recordConflict } from './state.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/ultrapilot/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/ultrapilot/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAoBpB,OAAO,EACL,2BAA2B,EAC3B,wBAAwB,EACxB,sBAAsB,EACtB,qBAAqB,EACrB,kBAAkB,EAClB,gBAAgB,EAChB,4BAA4B,EAC7B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,SAAS,EACV,MAAM,iBAAiB,CAAC;AAEzB;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,EAClC,SAAS,CAAC,EAAE,MAAM,GACjB,OAAO,CAAC,eAAe,CAAC,CAa1B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AACH,wBAAsB,aAAa,CACjC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC,gBAAgB,CAAC,GACjC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB;AAED;;;;;;;;;GASG;AACH,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAAE,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,gBAAgB,CAAC,GACjC,OAAO,CAAC,WAAW,EAAE,CAAC,CA2BxB;AAED;;;;;;;GAOG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf,CAAC,CAgBD;AAED;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA+C9E;AAsFD;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EAAE,GACd,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAKnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,GACf,OAAO,CA0BT;AAGD,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,iBAAiB,EACjB,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,EACL,mBAAmB,EACnB,oBAAoB,EACpB,cAAc,EACd,SAAS,EACT,iBAAiB,EACjB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACf,MAAM,YAAY,CAAC"}