@liangjie559567/ultrapower 5.5.20 → 5.5.21

package/dist/features/background-tasks.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Background Task Management
+ *
+ * Provides utilities for managing background task execution,
+ * similar to oh-my-opencode's Background Task Manager.
+ *
+ * In Claude Code, background execution is controlled via:
+ * - Bash tool's `run_in_background` parameter
+ * - Task tool's `run_in_background` parameter
+ * - TaskOutput tool for retrieving results
+ *
+ * This module provides:
+ * - Decision heuristics for when to use background execution
+ * - Task lifecycle management
+ * - Concurrency limit enforcement
+ * - System prompt guidance for agents
+ */
+import type { BackgroundTask, SessionState, PluginConfig } from '../shared/types.js';
+/**
+ * Default maximum concurrent background tasks
+ */
+export declare const DEFAULT_MAX_BACKGROUND_TASKS = 5;
+/**
+ * Patterns that indicate long-running operations
+ * These should typically run in background
+ */
+export declare const LONG_RUNNING_PATTERNS: RegExp[];
+/**
+ * Patterns that should always run blocking (foreground)
+ * These are quick operations or need immediate feedback
+ */
+export declare const BLOCKING_PATTERNS: RegExp[];
+/**
+ * Result of background execution decision
+ */
+export interface TaskExecutionDecision {
+    /** Whether to run in background */
+    runInBackground: boolean;
+    /** Human-readable reason for the decision */
+    reason: string;
+    /** Estimated duration category */
+    estimatedDuration: 'quick' | 'medium' | 'long' | 'unknown';
+    /** Confidence level of the decision */
+    confidence: 'high' | 'medium' | 'low';
+}
+/**
+ * Determine if a command should run in background
+ *
+ * This is the core heuristic function that decides whether a command
+ * should be executed with `run_in_background: true`.
+ *
+ * @param command - The command to analyze
+ * @param currentBackgroundCount - Number of currently running background tasks
+ * @param maxBackgroundTasks - Maximum allowed concurrent background tasks
+ * @returns Decision object with recommendation and reasoning
+ */
+export declare function shouldRunInBackground(command: string, currentBackgroundCount?: number, maxBackgroundTasks?: number): TaskExecutionDecision;
+/**
+ * BackgroundTaskManager interface
+ *
+ * Manages background task lifecycle, enforces concurrency limits,
+ * and provides utilities for tracking task status.
+ */
+export interface BackgroundTaskManager {
+    /** Register a new background task */
+    registerTask(agentName: string, prompt: string): BackgroundTask;
+    /** Get all background tasks */
+    getTasks(): BackgroundTask[];
+    /** Get tasks by status */
+    getTasksByStatus(status: BackgroundTask['status']): BackgroundTask[];
+    /** Get count of running tasks */
+    getRunningCount(): number;
+    /** Check if we can start a new background task */
+    canStartNewTask(): boolean;
+    /** Update task status */
+    updateTaskStatus(taskId: string, status: BackgroundTask['status'], result?: string, error?: string): void;
+    /** Mark task as completed */
+    completeTask(taskId: string, result: string): void;
+    /** Mark task as failed */
+    failTask(taskId: string, error: string): void;
+    /** Remove completed tasks older than specified age (ms) */
+    pruneCompletedTasks(maxAge?: number): number;
+    /** Get the maximum allowed background tasks */
+    getMaxTasks(): number;
+    /** Check if a command should run in background */
+    shouldRunInBackground(command: string): TaskExecutionDecision;
+}
+/**
+ * Create a BackgroundTaskManager instance
+ */
+export declare function createBackgroundTaskManager(state: SessionState, config: PluginConfig): BackgroundTaskManager;
+/**
+ * System prompt guidance for background task execution
+ *
+ * This text should be appended to the system prompt to guide agents
+ * on when and how to use background execution.
+ */
+export declare function getBackgroundTaskGuidance(maxBackgroundTasks?: number): string;
+//# sourceMappingURL=background-tasks.d.ts.map

package/dist/features/background-tasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-tasks.d.ts","sourceRoot":"","sources":["../../src/features/background-tasks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAErF;;GAEG;AACH,eAAO,MAAM,4BAA4B,IAAI,CAAC;AAE9C;;;GAGG;AACH,eAAO,MAAM,qBAAqB,UAuCjC,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,UA0B7B,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,eAAe,EAAE,OAAO,CAAC;IACzB,6CAA6C;IAC7C,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,iBAAiB,EAAE,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC;IAC3D,uCAAuC;IACvC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;CACvC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,sBAAsB,GAAE,MAAU,EAClC,kBAAkB,GAAE,MAAqC,GACxD,qBAAqB,CAoDvB;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,qCAAqC;IACrC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,cAAc,CAAC;IAEhE,+BAA+B;IAC/B,QAAQ,IAAI,cAAc,EAAE,CAAC;IAE7B,0BAA0B;IAC1B,gBAAgB,CAAC,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,GAAG,cAAc,EAAE,CAAC;IAErE,iCAAiC;IACjC,eAAe,IAAI,MAAM,CAAC;IAE1B,kDAAkD;IAClD,eAAe,IAAI,OAAO,CAAC;IAE3B,yBAAyB;IACzB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1G,6BAA6B;IAC7B,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAEnD,0BAA0B;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9C,2DAA2D;IAC3D,mBAAmB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IAE7C,+CAA+C;IAC/C,WAAW,IAAI,MAAM,CAAC;IAEtB,kDAAkD;IAClD,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,qBAAqB,CAAC;CAC/D;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,YAAY,GACnB,qBAAqB,CAkEvB;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,kBAAkB,GAAE,MAAqC,GAAG,MAAM,CAkD3G"}

package/dist/features/background-tasks.js

@@ -0,0 +1,265 @@
+/**
+ * Background Task Management
+ *
+ * Provides utilities for managing background task execution,
+ * similar to oh-my-opencode's Background Task Manager.
+ *
+ * In Claude Code, background execution is controlled via:
+ * - Bash tool's `run_in_background` parameter
+ * - Task tool's `run_in_background` parameter
+ * - TaskOutput tool for retrieving results
+ *
+ * This module provides:
+ * - Decision heuristics for when to use background execution
+ * - Task lifecycle management
+ * - Concurrency limit enforcement
+ * - System prompt guidance for agents
+ */
+/**
+ * Default maximum concurrent background tasks
+ */
+export const DEFAULT_MAX_BACKGROUND_TASKS = 5;
+/**
+ * Patterns that indicate long-running operations
+ * These should typically run in background
+ */
+export const LONG_RUNNING_PATTERNS = [
+    // Package managers
+    /\b(npm|yarn|pnpm|bun)\s+(install|ci|update|upgrade)\b/i,
+    /\b(pip|pip3)\s+install\b/i,
+    /\bcargo\s+(build|install|test)\b/i,
+    /\bgo\s+(build|install|test)\b/i,
+    /\brustup\s+(update|install)\b/i,
+    /\bgem\s+install\b/i,
+    /\bcomposer\s+install\b/i,
+    /\bmaven|mvn\s+(install|package|test)\b/i,
+    /\bgradle\s+(build|test)\b/i,
+    // Build commands
+    /\b(npm|yarn|pnpm|bun)\s+run\s+(build|compile|bundle)\b/i,
+    /\bmake\s*(all|build|install)?\s*$/i,
+    /\bcmake\s+--build\b/i,
+    /\btsc\s+(--build|-b)?\b/i,
+    /\bwebpack\b/i,
+    /\brollup\b/i,
+    /\besbuild\b/i,
+    /\bvite\s+build\b/i,
+    // Test suites
+    /\b(npm|yarn|pnpm|bun)\s+run\s+test\b/i,
+    /\b(jest|mocha|vitest|pytest|cargo\s+test)\b/i,
+    /\bgo\s+test\b/i,
+    // Docker operations
+    /\bdocker\s+(build|pull|push)\b/i,
+    /\bdocker-compose\s+(up|build)\b/i,
+    // Database operations
+    /\b(prisma|typeorm|sequelize)\s+(migrate|generate|push)\b/i,
+    // Linting large codebases
+    /\b(eslint|prettier)\s+[^|]*\.\s*$/i,
+    // Git operations on large repos
+    /\bgit\s+(clone|fetch|pull)\b/i,
+];
+/**
+ * Patterns that should always run blocking (foreground)
+ * These are quick operations or need immediate feedback
+ */
+export const BLOCKING_PATTERNS = [
+    // Quick status checks
+    /\bgit\s+(status|diff|log|branch)\b/i,
+    /\bls\b/i,
+    /\bpwd\b/i,
+    /\bcat\b/i,
+    /\becho\b/i,
+    /\bhead\b/i,
+    /\btail\b/i,
+    /\bwc\b/i,
+    /\bwhich\b/i,
+    /\btype\b/i,
+    // File operations
+    /\bcp\b/i,
+    /\bmv\b/i,
+    /\brm\b/i,
+    /\bmkdir\b/i,
+    /\btouch\b/i,
+    // Environment checks
+    /\benv\b/i,
+    /\bprintenv\b/i,
+    /\bnode\s+-[vpe]\b/i,
+    /\bnpm\s+-v\b/i,
+    /\bpython\s+--version\b/i,
+];
+/**
+ * Determine if a command should run in background
+ *
+ * This is the core heuristic function that decides whether a command
+ * should be executed with `run_in_background: true`.
+ *
+ * @param command - The command to analyze
+ * @param currentBackgroundCount - Number of currently running background tasks
+ * @param maxBackgroundTasks - Maximum allowed concurrent background tasks
+ * @returns Decision object with recommendation and reasoning
+ */
+export function shouldRunInBackground(command, currentBackgroundCount = 0, maxBackgroundTasks = DEFAULT_MAX_BACKGROUND_TASKS) {
+    // Check if at capacity
+    if (currentBackgroundCount >= maxBackgroundTasks) {
+        return {
+            runInBackground: false,
+            reason: `At background task limit (${currentBackgroundCount}/${maxBackgroundTasks}). Wait for existing tasks or run blocking.`,
+            estimatedDuration: 'unknown',
+            confidence: 'high'
+        };
+    }
+    // Check for explicit blocking patterns first
+    for (const pattern of BLOCKING_PATTERNS) {
+        if (pattern.test(command)) {
+            return {
+                runInBackground: false,
+                reason: 'Quick operation that should complete immediately.',
+                estimatedDuration: 'quick',
+                confidence: 'high'
+            };
+        }
+    }
+    // Check for long-running patterns
+    for (const pattern of LONG_RUNNING_PATTERNS) {
+        if (pattern.test(command)) {
+            return {
+                runInBackground: true,
+                reason: 'Long-running operation detected. Run in background to continue other work.',
+                estimatedDuration: 'long',
+                confidence: 'high'
+            };
+        }
+    }
+    // Heuristic: commands with multiple operations (piped or chained)
+    if ((command.match(/\|/g) || []).length > 2 || (command.match(/&&/g) || []).length > 2) {
+        return {
+            runInBackground: true,
+            reason: 'Complex command chain that may take time.',
+            estimatedDuration: 'medium',
+            confidence: 'medium'
+        };
+    }
+    // Default: run blocking for unknown commands
+    return {
+        runInBackground: false,
+        reason: 'Unknown command type. Running blocking for immediate feedback.',
+        estimatedDuration: 'unknown',
+        confidence: 'low'
+    };
+}
+/**
+ * Create a BackgroundTaskManager instance
+ */
+export function createBackgroundTaskManager(state, config) {
+    const maxBackgroundTasks = config.permissions?.maxBackgroundTasks ?? DEFAULT_MAX_BACKGROUND_TASKS;
+    return {
+        registerTask(agentName, prompt) {
+            const task = {
+                id: `task_${Date.now()}_${Math.random().toString(36).slice(2, 11)}`,
+                agentName,
+                prompt,
+                status: 'pending'
+            };
+            state.backgroundTasks.push(task);
+            return task;
+        },
+        getTasks() {
+            return [...state.backgroundTasks];
+        },
+        getTasksByStatus(status) {
+            return state.backgroundTasks.filter(t => t.status === status);
+        },
+        getRunningCount() {
+            return state.backgroundTasks.filter(t => t.status === 'running' || t.status === 'pending').length;
+        },
+        canStartNewTask() {
+            return this.getRunningCount() < maxBackgroundTasks;
+        },
+        updateTaskStatus(taskId, status, result, error) {
+            const task = state.backgroundTasks.find(t => t.id === taskId);
+            if (task) {
+                task.status = status;
+                if (result !== undefined)
+                    task.result = result;
+                if (error !== undefined)
+                    task.error = error;
+            }
+        },
+        completeTask(taskId, result) {
+            this.updateTaskStatus(taskId, 'completed', result);
+        },
+        failTask(taskId, error) {
+            this.updateTaskStatus(taskId, 'error', undefined, error);
+        },
+        pruneCompletedTasks(_maxAge = 5 * 60 * 1000) {
+            // Note: maxAge-based pruning would require tracking task completion timestamps
+            // For now, just prune all completed/errored tasks
+            const before = state.backgroundTasks.length;
+            state.backgroundTasks = state.backgroundTasks.filter(t => t.status !== 'completed' && t.status !== 'error');
+            return before - state.backgroundTasks.length;
+        },
+        getMaxTasks() {
+            return maxBackgroundTasks;
+        },
+        shouldRunInBackground(command) {
+            return shouldRunInBackground(command, this.getRunningCount(), maxBackgroundTasks);
+        }
+    };
+}
+/**
+ * System prompt guidance for background task execution
+ *
+ * This text should be appended to the system prompt to guide agents
+ * on when and how to use background execution.
+ */
+export function getBackgroundTaskGuidance(maxBackgroundTasks = DEFAULT_MAX_BACKGROUND_TASKS) {
+    return `
+## Background Task Execution
+
+For long-running operations, use the \`run_in_background\` parameter to avoid blocking.
+
+### When to Use Background Execution
+
+**Run in Background** (set \`run_in_background: true\`):
+- Package installation (\`npm install\`, \`pip install\`, \`cargo build\`, etc.)
+- Build processes (project build command, \`make\`, etc.)
+- Test suites (project test command, etc.)
+- Docker operations: \`docker build\`, \`docker pull\`
+- Git operations on large repos: \`git clone\`, \`git fetch\`
+- Database migrations: \`prisma migrate\`, \`typeorm migration:run\`
+
+**Run Blocking** (foreground, immediate):
+- Quick status checks: \`git status\`, \`ls\`, \`pwd\`
+- File operations: \`cat\`, \`head\`, \`tail\`
+- Simple commands: \`echo\`, \`which\`, \`env\`
+- Operations needing immediate feedback
+
+### How to Use Background Execution
+
+1. **Start in background:**
+   \`\`\`
+   Bash(command: "project build command", run_in_background: true)
+   \`\`\`
+
+2. **Continue with other work** while the task runs
+
+3. **Check results later:**
+   \`\`\`
+   TaskOutput(task_id: "<task_id_from_step_1>", block: false)
+   \`\`\`
+
+### Concurrency Limits
+
+- Maximum **${maxBackgroundTasks}** concurrent background tasks
+- If at limit, wait for existing tasks to complete or run the new task blocking
+- Use \`TaskOutput\` to check if background tasks have finished
+
+### Decision Checklist
+
+Before running a command, ask:
+1. Will this take more than 5 seconds? → Consider background
+2. Do I need the result immediately? → Run blocking
+3. Can I do other useful work while waiting? → Use background
+4. Am I at the background task limit? → Run blocking or wait
+`;
+}
+//# sourceMappingURL=background-tasks.js.map

package/dist/features/background-tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"background-tasks.js","sourceRoot":"","sources":["../../src/features/background-tasks.ts"],"names":[],"mappings":"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"}

package/dist/features/boulder-state/constants.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Boulder State Constants
+ *
+ * Ported from oh-my-opencode's boulder-state.
+ */
+/** Sisyphus state directory */
+export declare const BOULDER_DIR: ".omc";
+/** Boulder state file name */
+export declare const BOULDER_FILE = "boulder.json";
+/** Full path pattern for boulder state */
+export declare const BOULDER_STATE_PATH: string;
+/** Notepad directory for learnings */
+export declare const NOTEPAD_DIR = "notepads";
+/** Full path for notepads */
+export declare const NOTEPAD_BASE_PATH: string;
+/** Planner plan directory */
+export declare const PLANNER_PLANS_DIR: ".omc/plans";
+/** Plan file extension */
+export declare const PLAN_EXTENSION = ".md";
+//# sourceMappingURL=constants.d.ts.map

package/dist/features/boulder-state/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/features/boulder-state/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,+BAA+B;AAC/B,eAAO,MAAM,WAAW,QAAgB,CAAC;AAEzC,8BAA8B;AAC9B,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,0CAA0C;AAC1C,eAAO,MAAM,kBAAkB,QAAmC,CAAC;AAEnE,sCAAsC;AACtC,eAAO,MAAM,WAAW,aAAa,CAAC;AAEtC,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,QAAkC,CAAC;AAEjE,6BAA6B;AAC7B,eAAO,MAAM,iBAAiB,cAAiB,CAAC;AAEhD,0BAA0B;AAC1B,eAAO,MAAM,cAAc,QAAQ,CAAC"}

package/dist/features/boulder-state/constants.js

@@ -0,0 +1,21 @@
+/**
+ * Boulder State Constants
+ *
+ * Ported from oh-my-opencode's boulder-state.
+ */
+import { OmcPaths } from '../../lib/worktree-paths.js';
+/** Sisyphus state directory */
+export const BOULDER_DIR = OmcPaths.ROOT;
+/** Boulder state file name */
+export const BOULDER_FILE = 'boulder.json';
+/** Full path pattern for boulder state */
+export const BOULDER_STATE_PATH = `${BOULDER_DIR}/${BOULDER_FILE}`;
+/** Notepad directory for learnings */
+export const NOTEPAD_DIR = 'notepads';
+/** Full path for notepads */
+export const NOTEPAD_BASE_PATH = `${BOULDER_DIR}/${NOTEPAD_DIR}`;
+/** Planner plan directory */
+export const PLANNER_PLANS_DIR = OmcPaths.PLANS;
+/** Plan file extension */
+export const PLAN_EXTENSION = '.md';
+//# sourceMappingURL=constants.js.map

package/dist/features/boulder-state/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/features/boulder-state/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAEvD,+BAA+B;AAC/B,MAAM,CAAC,MAAM,WAAW,GAAG,QAAQ,CAAC,IAAI,CAAC;AAEzC,8BAA8B;AAC9B,MAAM,CAAC,MAAM,YAAY,GAAG,cAAc,CAAC;AAE3C,0CAA0C;AAC1C,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,WAAW,IAAI,YAAY,EAAE,CAAC;AAEnE,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC;AAEtC,6BAA6B;AAC7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,WAAW,IAAI,WAAW,EAAE,CAAC;AAEjE,6BAA6B;AAC7B,MAAM,CAAC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,KAAK,CAAC;AAEhD,0BAA0B;AAC1B,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,CAAC"}

package/dist/features/boulder-state/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Boulder State Module
+ *
+ * Manages the active work plan state for Sisyphus orchestrator.
+ * Named after Sisyphus's boulder - the eternal task that must be rolled.
+ *
+ * Ported from oh-my-opencode's boulder-state.
+ */
+export type { BoulderState, PlanProgress, PlanSummary } from './types.js';
+export { BOULDER_DIR, BOULDER_FILE, BOULDER_STATE_PATH, NOTEPAD_DIR, NOTEPAD_BASE_PATH, PLANNER_PLANS_DIR, PLAN_EXTENSION } from './constants.js';
+export { getBoulderFilePath, readBoulderState, writeBoulderState, appendSessionId, clearBoulderState, findPlannerPlans, getPlanProgress, getPlanName, createBoulderState, getPlanSummaries, hasBoulder, getActivePlanPath } from './storage.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/boulder-state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/boulder-state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EAClB,MAAM,cAAc,CAAC"}

package/dist/features/boulder-state/index.js

@@ -0,0 +1,13 @@
+/**
+ * Boulder State Module
+ *
+ * Manages the active work plan state for Sisyphus orchestrator.
+ * Named after Sisyphus's boulder - the eternal task that must be rolled.
+ *
+ * Ported from oh-my-opencode's boulder-state.
+ */
+// Constants
+export { BOULDER_DIR, BOULDER_FILE, BOULDER_STATE_PATH, NOTEPAD_DIR, NOTEPAD_BASE_PATH, PLANNER_PLANS_DIR, PLAN_EXTENSION } from './constants.js';
+// Storage operations
+export { getBoulderFilePath, readBoulderState, writeBoulderState, appendSessionId, clearBoulderState, findPlannerPlans, getPlanProgress, getPlanName, createBoulderState, getPlanSummaries, hasBoulder, getActivePlanPath } from './storage.js';
+//# sourceMappingURL=index.js.map

package/dist/features/boulder-state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/features/boulder-state/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AASH,YAAY;AACZ,OAAO,EACL,WAAW,EACX,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,iBAAiB,EACjB,iBAAiB,EACjB,cAAc,EACf,MAAM,gBAAgB,CAAC;AAExB,qBAAqB;AACrB,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,EACX,kBAAkB,EAClB,gBAAgB,EAChB,UAAU,EACV,iBAAiB,EAClB,MAAM,cAAc,CAAC"}

package/dist/features/boulder-state/storage.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Boulder State Storage
+ *
+ * Handles reading/writing boulder.json for active plan tracking.
+ *
+ * Ported from oh-my-opencode's boulder-state.
+ */
+import type { BoulderState, PlanProgress, PlanSummary } from './types.js';
+/**
+ * Get the full path to the boulder state file
+ */
+export declare function getBoulderFilePath(directory: string): string;
+/**
+ * Read boulder state from disk
+ */
+export declare function readBoulderState(directory: string): BoulderState | null;
+/**
+ * Write boulder state to disk
+ */
+export declare function writeBoulderState(directory: string, state: BoulderState): boolean;
+/**
+ * Append a session ID to the boulder state
+ */
+export declare function appendSessionId(directory: string, sessionId: string): BoulderState | null;
+/**
+ * Clear boulder state (delete the file)
+ */
+export declare function clearBoulderState(directory: string): boolean;
+/**
+ * Find Planner plan files for this project.
+ * Planner stores plans at: {project}/.omc/plans/{name}.md
+ */
+export declare function findPlannerPlans(directory: string): string[];
+/**
+ * Parse a plan file and count checkbox progress.
+ */
+export declare function getPlanProgress(planPath: string): PlanProgress;
+/**
+ * Extract plan name from file path.
+ */
+export declare function getPlanName(planPath: string): string;
+/**
+ * Create a new boulder state for a plan.
+ */
+export declare function createBoulderState(planPath: string, sessionId: string): BoulderState;
+/**
+ * Get summaries of all available plans
+ */
+export declare function getPlanSummaries(directory: string): PlanSummary[];
+/**
+ * Check if a boulder is currently active
+ */
+export declare function hasBoulder(directory: string): boolean;
+/**
+ * Get the active plan path from boulder state
+ */
+export declare function getActivePlanPath(directory: string): string | null;
+//# sourceMappingURL=storage.d.ts.map

package/dist/features/boulder-state/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../../src/features/boulder-state/storage.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAI1E;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAavE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,OAAO,CAcjF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAYzF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAW5D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,CAqB5D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,YAAY,CAuB9D;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,GAChB,YAAY,CAOd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,WAAW,EAAE,CAYjE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGlE"}