sk-claudecode 1.0.0

package/dist/hooks/todo-continuation/index.d.ts

@@ -0,0 +1,186 @@
+/**
+ * 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.
+ */
+/**
+ * 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 declare function isValidSessionId(sessionId: string): boolean;
+export interface Todo {
+    content: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'cancelled';
+    priority?: string;
+    id?: string;
+}
+/**
+ * Claude Code Task system task
+ *
+ * IMPORTANT: This interface is based on observed behavior and the TaskCreate/TaskUpdate
+ * tool schema. The file structure ~/.claude/tasks/{sessionId}/{taskId}.json is inferred
+ * from Claude Code's implementation and may change in future versions.
+ *
+ * As of 2025-01, Anthropic has not published official documentation for the Task system
+ * file format. This implementation should be verified empirically when issues arise.
+ *
+ * @see https://docs.anthropic.com/en/docs/claude-code (check for updates)
+ */
+export interface Task {
+    id: string;
+    subject: string;
+    description?: string;
+    activeForm?: string;
+    status: 'pending' | 'in_progress' | 'completed' | 'deleted';
+    blocks?: string[];
+    blockedBy?: string[];
+}
+/** Internal result for Task checking */
+export interface TaskCheckResult {
+    count: number;
+    tasks: Task[];
+    total: number;
+}
+export interface IncompleteTodosResult {
+    count: number;
+    todos: Todo[];
+    total: number;
+    source: 'task' | 'todo' | 'both' | 'none';
+}
+/**
+ * Context from Stop hook event
+ *
+ * NOTE: Field names support both camelCase and snake_case variants
+ * for compatibility with different Claude Code versions.
+ *
+ * IMPORTANT: The abort detection patterns below are assumed. Verify
+ * actual stop_reason values from Claude Code before finalizing.
+ */
+export interface StopContext {
+    /** Reason for stop (from Claude Code) - snake_case variant */
+    stop_reason?: string;
+    /** Reason for stop (from Claude Code) - camelCase variant */
+    stopReason?: string;
+    /** End turn reason (from API) - snake_case variant */
+    end_turn_reason?: string;
+    /** End turn reason (from API) - camelCase variant */
+    endTurnReason?: string;
+    /** Whether user explicitly requested stop - snake_case variant */
+    user_requested?: boolean;
+    /** Whether user explicitly requested stop - camelCase variant */
+    userRequested?: boolean;
+}
+export interface TodoContinuationHook {
+    checkIncomplete: (sessionId?: string) => Promise<IncompleteTodosResult>;
+}
+/**
+ * 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 declare function isUserAbort(context?: StopContext): boolean;
+/**
+ * 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/Yeachan-Heo/sk-claudecode/issues/213
+ */
+export declare function isContextLimitStop(context?: StopContext): boolean;
+/**
+ * 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 declare function getTaskDirectory(sessionId: string): string;
+/**
+ * Validates that a parsed JSON object is a valid Task.
+ * Required fields: id (string), subject (string), status (string).
+ */
+export declare function isValidTask(data: unknown): data is Task;
+/**
+ * Read all Task files from a session's task directory
+ */
+export declare function readTaskFiles(sessionId: string): Task[];
+/**
+ * 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 declare function isTaskIncomplete(task: Task): boolean;
+/**
+ * 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 declare function checkIncompleteTasks(sessionId: string): TaskCheckResult;
+/**
+ * Check for incomplete todos in the legacy system
+ */
+export declare function checkLegacyTodos(sessionId?: string, directory?: string): IncompleteTodosResult;
+/**
+ * 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 declare function checkIncompleteTodos(sessionId?: string, directory?: string, stopContext?: StopContext): Promise<IncompleteTodosResult>;
+/**
+ * Create a Todo Continuation hook instance
+ */
+export declare function createTodoContinuationHook(directory: string): TodoContinuationHook;
+/**
+ * Get formatted status string for todos
+ */
+export declare function formatTodoStatus(result: IncompleteTodosResult): string;
+/**
+ * Get the next pending todo
+ */
+export declare function getNextPendingTodo(result: IncompleteTodosResult): Todo | null;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/todo-continuation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/hooks/todo-continuation/index.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,358 @@
+/**
+ * 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 SKC_DEBUG=1 or SKC_DEBUG=todo-continuation for verbose output.
+ */
+function debugLog(message, ...args) {
+    const debug = process.env.SKC_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 { homedir } from 'os';
+/**
+ * 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/Yeachan-Heo/sk-claudecode/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 = join(homedir(), '.claude');
+    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, '.skc', '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 data = JSON.parse(content);
+        // 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.todos && 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(homedir(), '.claude', '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 parsed = JSON.parse(content);
+                if (isValidTask(parsed))
+                    tasks.push(parsed);
+            }
+            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":"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"}