oh-my-claude-sisyphus 1.1.0 → 1.2.0

package/dist/commands/index.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Command Expansion Utilities
+ *
+ * Provides SDK-compatible access to slash commands by reading
+ * command templates and expanding them with arguments.
+ */
+export interface CommandInfo {
+    name: string;
+    description: string;
+    template: string;
+    filePath: string;
+}
+export interface ExpandedCommand {
+    name: string;
+    prompt: string;
+    description: string;
+}
+/**
+ * Get the commands directory path
+ */
+export declare function getCommandsDir(): string;
+/**
+ * Get a specific command by name
+ */
+export declare function getCommand(name: string): CommandInfo | null;
+/**
+ * Get all available commands
+ */
+export declare function getAllCommands(): CommandInfo[];
+/**
+ * List available command names
+ */
+export declare function listCommands(): string[];
+/**
+ * Expand a command template with arguments
+ *
+ * @param name - Command name (without leading slash)
+ * @param args - Arguments to substitute for $ARGUMENTS
+ * @returns Expanded command ready for SDK query
+ *
+ * @example
+ * ```typescript
+ * import { expandCommand } from 'oh-my-claude-sisyphus';
+ *
+ * const prompt = expandCommand('ralph-loop', 'Build a REST API');
+ * // Returns the full ralph-loop template with "Build a REST API" substituted
+ * ```
+ */
+export declare function expandCommand(name: string, args?: string): ExpandedCommand | null;
+/**
+ * Expand a command and return just the prompt string
+ * Convenience function for direct use with SDK query
+ *
+ * @example
+ * ```typescript
+ * import { expandCommandPrompt } from 'oh-my-claude-sisyphus';
+ * import { query } from '@anthropic-ai/claude-agent-sdk';
+ *
+ * const prompt = expandCommandPrompt('ultrawork', 'Refactor the auth module');
+ *
+ * for await (const msg of query({ prompt })) {
+ *   console.log(msg);
+ * }
+ * ```
+ */
+export declare function expandCommandPrompt(name: string, args?: string): string | null;
+/**
+ * Check if a command exists
+ */
+export declare function commandExists(name: string): boolean;
+/**
+ * Batch expand multiple commands
+ */
+export declare function expandCommands(commands: Array<{
+    name: string;
+    args?: string;
+}>): ExpandedCommand[];
+//# sourceMappingURL=index.d.ts.map

package/dist/commands/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAsBD;;GAEG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI,CAsB3D;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,WAAW,EAAE,CAwB9C;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,EAAE,CAEvC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,eAAe,GAAG,IAAI,CAerF;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,MAAW,GAAG,MAAM,GAAG,IAAI,CAGlF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,eAAe,EAAE,CAIlG"}

package/dist/commands/index.js

@@ -0,0 +1,148 @@
+/**
+ * Command Expansion Utilities
+ *
+ * Provides SDK-compatible access to slash commands by reading
+ * command templates and expanding them with arguments.
+ */
+import { readFileSync, existsSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { homedir } from 'os';
+/**
+ * Get the commands directory path
+ */
+export function getCommandsDir() {
+    return join(homedir(), '.claude', 'commands');
+}
+/**
+ * Parse command frontmatter and content
+ */
+function parseCommandFile(content) {
+    const frontmatterMatch = content.match(/^---\n([\s\S]*?)\n---\n([\s\S]*)$/);
+    if (!frontmatterMatch) {
+        return { description: '', template: content };
+    }
+    const frontmatter = frontmatterMatch[1];
+    const template = frontmatterMatch[2];
+    // Extract description from frontmatter
+    const descMatch = frontmatter.match(/description:\s*(.+)/);
+    const description = descMatch ? descMatch[1].trim() : '';
+    return { description, template };
+}
+/**
+ * Get a specific command by name
+ */
+export function getCommand(name) {
+    const commandsDir = getCommandsDir();
+    const filePath = join(commandsDir, `${name}.md`);
+    if (!existsSync(filePath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(filePath, 'utf-8');
+        const { description, template } = parseCommandFile(content);
+        return {
+            name,
+            description,
+            template,
+            filePath
+        };
+    }
+    catch (error) {
+        console.error(`Error reading command ${name}:`, error);
+        return null;
+    }
+}
+/**
+ * Get all available commands
+ */
+export function getAllCommands() {
+    const commandsDir = getCommandsDir();
+    if (!existsSync(commandsDir)) {
+        return [];
+    }
+    try {
+        const files = readdirSync(commandsDir).filter(f => f.endsWith('.md'));
+        const commands = [];
+        for (const file of files) {
+            const name = file.replace('.md', '');
+            const command = getCommand(name);
+            if (command) {
+                commands.push(command);
+            }
+        }
+        return commands;
+    }
+    catch (error) {
+        console.error('Error listing commands:', error);
+        return [];
+    }
+}
+/**
+ * List available command names
+ */
+export function listCommands() {
+    return getAllCommands().map(c => c.name);
+}
+/**
+ * Expand a command template with arguments
+ *
+ * @param name - Command name (without leading slash)
+ * @param args - Arguments to substitute for $ARGUMENTS
+ * @returns Expanded command ready for SDK query
+ *
+ * @example
+ * ```typescript
+ * import { expandCommand } from 'oh-my-claude-sisyphus';
+ *
+ * const prompt = expandCommand('ralph-loop', 'Build a REST API');
+ * // Returns the full ralph-loop template with "Build a REST API" substituted
+ * ```
+ */
+export function expandCommand(name, args = '') {
+    const command = getCommand(name);
+    if (!command) {
+        return null;
+    }
+    // Replace $ARGUMENTS placeholder with actual arguments
+    const prompt = command.template.replace(/\$ARGUMENTS/g, args);
+    return {
+        name,
+        prompt: prompt.trim(),
+        description: command.description
+    };
+}
+/**
+ * Expand a command and return just the prompt string
+ * Convenience function for direct use with SDK query
+ *
+ * @example
+ * ```typescript
+ * import { expandCommandPrompt } from 'oh-my-claude-sisyphus';
+ * import { query } from '@anthropic-ai/claude-agent-sdk';
+ *
+ * const prompt = expandCommandPrompt('ultrawork', 'Refactor the auth module');
+ *
+ * for await (const msg of query({ prompt })) {
+ *   console.log(msg);
+ * }
+ * ```
+ */
+export function expandCommandPrompt(name, args = '') {
+    const expanded = expandCommand(name, args);
+    return expanded ? expanded.prompt : null;
+}
+/**
+ * Check if a command exists
+ */
+export function commandExists(name) {
+    return getCommand(name) !== null;
+}
+/**
+ * Batch expand multiple commands
+ */
+export function expandCommands(commands) {
+    return commands
+        .map(({ name, args }) => expandCommand(name, args))
+        .filter((c) => c !== null);
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAe7B;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,UAAU,CAAC,CAAC;AAChD,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAe;IACvC,MAAM,gBAAgB,GAAG,OAAO,CAAC,KAAK,CAAC,mCAAmC,CAAC,CAAC;IAE5E,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,EAAE,WAAW,EAAE,EAAE,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IAChD,CAAC;IAED,MAAM,WAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC;IAErC,uCAAuC;IACvC,MAAM,SAAS,GAAG,WAAW,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;IAC3D,MAAM,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEzD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,GAAG,IAAI,KAAK,CAAC,CAAC;IAEjD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC1B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,OAAO,CAAC,CAAC;QAE5D,OAAO;YACL,IAAI;YACJ,WAAW;YACX,QAAQ;YACR,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,IAAI,GAAG,EAAE,KAAK,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,WAAW,GAAG,cAAc,EAAE,CAAC;IAErC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,WAAW,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QACtE,MAAM,QAAQ,GAAkB,EAAE,CAAC;QAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;YACjC,IAAI,OAAO,EAAE,CAAC;gBACZ,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;QAED,OAAO,QAAQ,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,yBAAyB,EAAE,KAAK,CAAC,CAAC;QAChD,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY,EAAE,OAAe,EAAE;IAC3D,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;IAEjC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,IAAI,CAAC;IACd,CAAC;IAED,uDAAuD;IACvD,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,IAAI,CAAC,CAAC;IAE9D,OAAO;QACL,IAAI;QACJ,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;QACrB,WAAW,EAAE,OAAO,CAAC,WAAW;KACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAAY,EAAE,OAAe,EAAE;IACjE,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC3C,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC;AAC3C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,IAAY;IACxC,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgD;IAC7E,OAAO,QAAQ;SACZ,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;SAClD,MAAM,CAAC,CAAC,CAAC,EAAwB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;AACrD,CAAC"}

package/dist/features/auto-update.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Auto-Update System
+ *
+ * Provides version checking and auto-update functionality for Oh-My-Claude-Sisyphus.
+ *
+ * Features:
+ * - Check for new versions from GitHub releases
+ * - Download and install updates automatically
+ * - Store version metadata for installed components
+ * - Configurable update notifications
+ */
+/** GitHub repository information */
+export declare const REPO_OWNER = "Yeachan-Heo";
+export declare const REPO_NAME = "oh-my-claude-sisyphus";
+export declare const GITHUB_API_URL = "https://api.github.com/repos/Yeachan-Heo/oh-my-claude-sisyphus";
+export declare const GITHUB_RAW_URL = "https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus";
+/** Installation paths */
+export declare const CLAUDE_CONFIG_DIR: string;
+export declare const VERSION_FILE: string;
+/**
+ * Version metadata stored after installation
+ */
+export interface VersionMetadata {
+    /** Currently installed version */
+    version: string;
+    /** Installation timestamp */
+    installedAt: string;
+    /** Last update check timestamp */
+    lastCheckAt?: string;
+    /** Git commit hash if installed from source */
+    commitHash?: string;
+    /** Installation method: 'script' | 'npm' | 'source' */
+    installMethod: 'script' | 'npm' | 'source';
+}
+/**
+ * GitHub release information
+ */
+export interface ReleaseInfo {
+    tag_name: string;
+    name: string;
+    published_at: string;
+    html_url: string;
+    body: string;
+    prerelease: boolean;
+    draft: boolean;
+}
+/**
+ * Update check result
+ */
+export interface UpdateCheckResult {
+    currentVersion: string | null;
+    latestVersion: string;
+    updateAvailable: boolean;
+    releaseInfo: ReleaseInfo;
+    releaseNotes: string;
+}
+/**
+ * Update result
+ */
+export interface UpdateResult {
+    success: boolean;
+    previousVersion: string | null;
+    newVersion: string;
+    message: string;
+    errors?: string[];
+}
+/**
+ * Read the current version metadata
+ */
+export declare function getInstalledVersion(): VersionMetadata | null;
+/**
+ * Save version metadata after installation/update
+ */
+export declare function saveVersionMetadata(metadata: VersionMetadata): void;
+/**
+ * Update the last check timestamp
+ */
+export declare function updateLastCheckTime(): void;
+/**
+ * Fetch the latest release from GitHub
+ */
+export declare function fetchLatestRelease(): Promise<ReleaseInfo>;
+/**
+ * Compare semantic versions
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ */
+export declare function compareVersions(a: string, b: string): number;
+/**
+ * Check for available updates
+ */
+export declare function checkForUpdates(): Promise<UpdateCheckResult>;
+/**
+ * Download and execute the install script to perform an update
+ */
+export declare function performUpdate(options?: {
+    skipConfirmation?: boolean;
+    verbose?: boolean;
+}): Promise<UpdateResult>;
+/**
+ * Get a formatted update notification message
+ */
+export declare function formatUpdateNotification(checkResult: UpdateCheckResult): string;
+/**
+ * Check if enough time has passed since the last update check
+ */
+export declare function shouldCheckForUpdates(intervalHours?: number): boolean;
+/**
+ * Perform a background update check (non-blocking)
+ */
+export declare function backgroundUpdateCheck(callback?: (result: UpdateCheckResult) => void): void;
+/**
+ * CLI helper: perform interactive update
+ */
+export declare function interactiveUpdate(): Promise<void>;
+//# sourceMappingURL=auto-update.d.ts.map

package/dist/features/auto-update.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-update.d.ts","sourceRoot":"","sources":["../../src/features/auto-update.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAOH,oCAAoC;AACpC,eAAO,MAAM,UAAU,gBAAgB,CAAC;AACxC,eAAO,MAAM,SAAS,0BAA0B,CAAC;AACjD,eAAO,MAAM,cAAc,mEAA4D,CAAC;AACxF,eAAO,MAAM,cAAc,wEAAiE,CAAC;AAE7F,yBAAyB;AACzB,eAAO,MAAM,iBAAiB,QAA6B,CAAC;AAC5D,eAAO,MAAM,YAAY,QAAoD,CAAC;AAE9E;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,6BAA6B;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,uDAAuD;IACvD,aAAa,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;CAC5C;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,OAAO,CAAC;IACpB,KAAK,EAAE,OAAO,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,EAAE,WAAW,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,eAAe,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,eAAe,GAAG,IAAI,CA8B5D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,GAAG,IAAI,CAMnE;AAED;;GAEG;AACH,wBAAgB,mBAAmB,IAAI,IAAI,CAM1C;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,WAAW,CAAC,CAa/D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAmB5D;AAED;;GAEG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,iBAAiB,CAAC,CAmBlE;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,OAAO,CAAC,EAAE;IAC5C,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,GAAG,OAAO,CAAC,YAAY,CAAC,CAyExB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,WAAW,EAAE,iBAAiB,GAAG,MAAM,CA8B/E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAYzE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,GAAG,IAAI,CAqB1F;AAED;;GAEG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CA8BvD"}

package/dist/features/auto-update.js

@@ -0,0 +1,305 @@
+/**
+ * Auto-Update System
+ *
+ * Provides version checking and auto-update functionality for Oh-My-Claude-Sisyphus.
+ *
+ * Features:
+ * - Check for new versions from GitHub releases
+ * - Download and install updates automatically
+ * - Store version metadata for installed components
+ * - Configurable update notifications
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync, unlinkSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir, tmpdir } from 'os';
+import { execSync } from 'child_process';
+/** GitHub repository information */
+export const REPO_OWNER = 'Yeachan-Heo';
+export const REPO_NAME = 'oh-my-claude-sisyphus';
+export const GITHUB_API_URL = `https://api.github.com/repos/${REPO_OWNER}/${REPO_NAME}`;
+export const GITHUB_RAW_URL = `https://raw.githubusercontent.com/${REPO_OWNER}/${REPO_NAME}`;
+/** Installation paths */
+export const CLAUDE_CONFIG_DIR = join(homedir(), '.claude');
+export const VERSION_FILE = join(CLAUDE_CONFIG_DIR, '.sisyphus-version.json');
+/**
+ * Read the current version metadata
+ */
+export function getInstalledVersion() {
+    if (!existsSync(VERSION_FILE)) {
+        // Try to detect version from package.json if installed via npm
+        try {
+            // Check if we can find the package in node_modules
+            const result = execSync('npm list -g oh-my-claude-sisyphus --json 2>/dev/null', {
+                encoding: 'utf-8',
+                timeout: 5000
+            });
+            const data = JSON.parse(result);
+            if (data.dependencies?.['oh-my-claude-sisyphus']?.version) {
+                return {
+                    version: data.dependencies['oh-my-claude-sisyphus'].version,
+                    installedAt: new Date().toISOString(),
+                    installMethod: 'npm'
+                };
+            }
+        }
+        catch {
+            // Not installed via npm or command failed
+        }
+        return null;
+    }
+    try {
+        const content = readFileSync(VERSION_FILE, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error('Error reading version file:', error);
+        return null;
+    }
+}
+/**
+ * Save version metadata after installation/update
+ */
+export function saveVersionMetadata(metadata) {
+    const dir = dirname(VERSION_FILE);
+    if (!existsSync(dir)) {
+        mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(VERSION_FILE, JSON.stringify(metadata, null, 2));
+}
+/**
+ * Update the last check timestamp
+ */
+export function updateLastCheckTime() {
+    const current = getInstalledVersion();
+    if (current) {
+        current.lastCheckAt = new Date().toISOString();
+        saveVersionMetadata(current);
+    }
+}
+/**
+ * Fetch the latest release from GitHub
+ */
+export async function fetchLatestRelease() {
+    const response = await fetch(`${GITHUB_API_URL}/releases/latest`, {
+        headers: {
+            'Accept': 'application/vnd.github.v3+json',
+            'User-Agent': 'oh-my-claude-sisyphus-updater'
+        }
+    });
+    if (!response.ok) {
+        throw new Error(`Failed to fetch release info: ${response.status} ${response.statusText}`);
+    }
+    return await response.json();
+}
+/**
+ * Compare semantic versions
+ * Returns: -1 if a < b, 0 if a == b, 1 if a > b
+ */
+export function compareVersions(a, b) {
+    // Remove 'v' prefix if present
+    const cleanA = a.replace(/^v/, '');
+    const cleanB = b.replace(/^v/, '');
+    const partsA = cleanA.split('.').map(n => parseInt(n, 10) || 0);
+    const partsB = cleanB.split('.').map(n => parseInt(n, 10) || 0);
+    const maxLength = Math.max(partsA.length, partsB.length);
+    for (let i = 0; i < maxLength; i++) {
+        const numA = partsA[i] || 0;
+        const numB = partsB[i] || 0;
+        if (numA < numB)
+            return -1;
+        if (numA > numB)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Check for available updates
+ */
+export async function checkForUpdates() {
+    const installed = getInstalledVersion();
+    const release = await fetchLatestRelease();
+    const currentVersion = installed?.version ?? null;
+    const latestVersion = release.tag_name.replace(/^v/, '');
+    const updateAvailable = currentVersion === null || compareVersions(currentVersion, latestVersion) < 0;
+    // Update last check time
+    updateLastCheckTime();
+    return {
+        currentVersion,
+        latestVersion,
+        updateAvailable,
+        releaseInfo: release,
+        releaseNotes: release.body || 'No release notes available.'
+    };
+}
+/**
+ * Download and execute the install script to perform an update
+ */
+export async function performUpdate(options) {
+    const installed = getInstalledVersion();
+    const previousVersion = installed?.version ?? null;
+    try {
+        // Fetch the latest release to get the version
+        const release = await fetchLatestRelease();
+        const newVersion = release.tag_name.replace(/^v/, '');
+        // Download the install script
+        const installScriptUrl = `${GITHUB_RAW_URL}/main/scripts/install.sh`;
+        const response = await fetch(installScriptUrl);
+        if (!response.ok) {
+            throw new Error(`Failed to download install script: ${response.status}`);
+        }
+        const scriptContent = await response.text();
+        // Save to a temporary file
+        const tempDir = tmpdir();
+        const tempScript = join(tempDir, `sisyphus-update-${Date.now()}.sh`);
+        writeFileSync(tempScript, scriptContent, { mode: 0o755 });
+        // Execute the install script
+        try {
+            const output = execSync(`bash "${tempScript}"`, {
+                encoding: 'utf-8',
+                stdio: options?.verbose ? 'inherit' : 'pipe',
+                timeout: 60000 // 1 minute timeout
+            });
+            // Update version metadata
+            saveVersionMetadata({
+                version: newVersion,
+                installedAt: new Date().toISOString(),
+                installMethod: 'script',
+                lastCheckAt: new Date().toISOString()
+            });
+            // Clean up temp file
+            try {
+                unlinkSync(tempScript);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            return {
+                success: true,
+                previousVersion,
+                newVersion,
+                message: `Successfully updated from ${previousVersion ?? 'unknown'} to ${newVersion}`
+            };
+        }
+        catch (error) {
+            // Clean up temp file on error too
+            try {
+                unlinkSync(tempScript);
+            }
+            catch {
+                // Ignore cleanup errors
+            }
+            throw error;
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            success: false,
+            previousVersion,
+            newVersion: 'unknown',
+            message: `Update failed: ${errorMessage}`,
+            errors: [errorMessage]
+        };
+    }
+}
+/**
+ * Get a formatted update notification message
+ */
+export function formatUpdateNotification(checkResult) {
+    if (!checkResult.updateAvailable) {
+        return `Oh-My-Claude-Sisyphus is up to date (v${checkResult.currentVersion ?? 'unknown'})`;
+    }
+    const lines = [
+        '╔═══════════════════════════════════════════════════════════╗',
+        '║           Oh-My-Claude-Sisyphus Update Available!         ║',
+        '╚═══════════════════════════════════════════════════════════╝',
+        '',
+        `  Current version: ${checkResult.currentVersion ?? 'unknown'}`,
+        `  Latest version:  ${checkResult.latestVersion}`,
+        '',
+        '  To update, run: /update',
+        '  Or run: curl -fsSL https://raw.githubusercontent.com/Yeachan-Heo/oh-my-claude-sisyphus/main/scripts/install.sh | bash',
+        ''
+    ];
+    // Add truncated release notes if available
+    if (checkResult.releaseNotes && checkResult.releaseNotes !== 'No release notes available.') {
+        lines.push('  Release notes:');
+        const notes = checkResult.releaseNotes.split('\n').slice(0, 5);
+        notes.forEach(line => lines.push(`    ${line}`));
+        if (checkResult.releaseNotes.split('\n').length > 5) {
+            lines.push('    ...');
+        }
+        lines.push('');
+    }
+    return lines.join('\n');
+}
+/**
+ * Check if enough time has passed since the last update check
+ */
+export function shouldCheckForUpdates(intervalHours = 24) {
+    const installed = getInstalledVersion();
+    if (!installed?.lastCheckAt) {
+        return true;
+    }
+    const lastCheck = new Date(installed.lastCheckAt).getTime();
+    const now = Date.now();
+    const hoursSinceLastCheck = (now - lastCheck) / (1000 * 60 * 60);
+    return hoursSinceLastCheck >= intervalHours;
+}
+/**
+ * Perform a background update check (non-blocking)
+ */
+export function backgroundUpdateCheck(callback) {
+    if (!shouldCheckForUpdates()) {
+        return;
+    }
+    // Run the check asynchronously without blocking
+    checkForUpdates()
+        .then(result => {
+        if (callback) {
+            callback(result);
+        }
+        else if (result.updateAvailable) {
+            // Default behavior: print notification to console
+            console.log('\n' + formatUpdateNotification(result));
+        }
+    })
+        .catch(error => {
+        // Silently ignore errors in background checks
+        if (process.env.SISYPHUS_DEBUG) {
+            console.error('Background update check failed:', error);
+        }
+    });
+}
+/**
+ * CLI helper: perform interactive update
+ */
+export async function interactiveUpdate() {
+    console.log('Checking for updates...');
+    try {
+        const checkResult = await checkForUpdates();
+        if (!checkResult.updateAvailable) {
+            console.log(`✓ You are running the latest version (${checkResult.currentVersion})`);
+            return;
+        }
+        console.log(formatUpdateNotification(checkResult));
+        console.log('Starting update...\n');
+        const result = await performUpdate({ verbose: true });
+        if (result.success) {
+            console.log(`\n✓ ${result.message}`);
+            console.log('\nPlease restart your Claude Code session to use the new version.');
+        }
+        else {
+            console.error(`\n✗ ${result.message}`);
+            if (result.errors) {
+                result.errors.forEach(err => console.error(`  - ${err}`));
+            }
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Update check failed:', error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=auto-update.js.map

package/dist/features/auto-update.js.map

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

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\`
+- Build processes: \`npm run build\`, \`make\`, \`tsc\`
+- Test suites: \`npm test\`, \`pytest\`, \`cargo test\`
+- 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: "npm run build", 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":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC;AAE9C;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,mBAAmB;IACnB,wDAAwD;IACxD,2BAA2B;IAC3B,mCAAmC;IACnC,gCAAgC;IAChC,gCAAgC;IAChC,oBAAoB;IACpB,yBAAyB;IACzB,yCAAyC;IACzC,4BAA4B;IAE5B,iBAAiB;IACjB,yDAAyD;IACzD,oCAAoC;IACpC,sBAAsB;IACtB,0BAA0B;IAC1B,cAAc;IACd,aAAa;IACb,cAAc;IACd,mBAAmB;IAEnB,cAAc;IACd,uCAAuC;IACvC,8CAA8C;IAC9C,gBAAgB;IAEhB,oBAAoB;IACpB,iCAAiC;IACjC,kCAAkC;IAElC,sBAAsB;IACtB,2DAA2D;IAE3D,0BAA0B;IAC1B,oCAAoC;IAEpC,gCAAgC;IAChC,+BAA+B;CAChC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,sBAAsB;IACtB,qCAAqC;IACrC,SAAS;IACT,UAAU;IACV,UAAU;IACV,WAAW;IACX,WAAW;IACX,WAAW;IACX,SAAS;IACT,YAAY;IACZ,WAAW;IAEX,kBAAkB;IAClB,SAAS;IACT,SAAS;IACT,SAAS;IACT,YAAY;IACZ,YAAY;IAEZ,qBAAqB;IACrB,UAAU;IACV,eAAe;IACf,oBAAoB;IACpB,eAAe;IACf,yBAAyB;CAC1B,CAAC;AAgBF;;;;;;;;;;GAUG;AACH,MAAM,UAAU,qBAAqB,CACnC,OAAe,EACf,yBAAiC,CAAC,EAClC,qBAA6B,4BAA4B;IAEzD,uBAAuB;IACvB,IAAI,sBAAsB,IAAI,kBAAkB,EAAE,CAAC;QACjD,OAAO;YACL,eAAe,EAAE,KAAK;YACtB,MAAM,EAAE,6BAA6B,sBAAsB,IAAI,kBAAkB,6CAA6C;YAC9H,iBAAiB,EAAE,SAAS;YAC5B,UAAU,EAAE,MAAM;SACnB,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,KAAK,MAAM,OAAO,IAAI,iBAAiB,EAAE,CAAC;QACxC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,eAAe,EAAE,KAAK;gBACtB,MAAM,EAAE,mDAAmD;gBAC3D,iBAAiB,EAAE,OAAO;gBAC1B,UAAU,EAAE,MAAM;aACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kCAAkC;IAClC,KAAK,MAAM,OAAO,IAAI,qBAAqB,EAAE,CAAC;QAC5C,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;YAC1B,OAAO;gBACL,eAAe,EAAE,IAAI;gBACrB,MAAM,EAAE,4EAA4E;gBACpF,iBAAiB,EAAE,MAAM;gBACzB,UAAU,EAAE,MAAM;aACnB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvF,OAAO;YACL,eAAe,EAAE,IAAI;YACrB,MAAM,EAAE,2CAA2C;YACnD,iBAAiB,EAAE,QAAQ;YAC3B,UAAU,EAAE,QAAQ;SACrB,CAAC;IACJ,CAAC;IAED,6CAA6C;IAC7C,OAAO;QACL,eAAe,EAAE,KAAK;QACtB,MAAM,EAAE,gEAAgE;QACxE,iBAAiB,EAAE,SAAS;QAC5B,UAAU,EAAE,KAAK;KAClB,CAAC;AACJ,CAAC;AA2CD;;GAEG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAmB,EACnB,MAAoB;IAEpB,MAAM,kBAAkB,GAAG,MAAM,CAAC,WAAW,EAAE,kBAAkB,IAAI,4BAA4B,CAAC;IAElG,OAAO;QACL,YAAY,CAAC,SAAiB,EAAE,MAAc;YAC5C,MAAM,IAAI,GAAmB;gBAC3B,EAAE,EAAE,QAAQ,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;gBACnE,SAAS;gBACT,MAAM;gBACN,MAAM,EAAE,SAAS;aAClB,CAAC;YACF,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACjC,OAAO,IAAI,CAAC;QACd,CAAC;QAED,QAAQ;YACN,OAAO,CAAC,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;QACpC,CAAC;QAED,gBAAgB,CAAC,MAAgC;YAC/C,OAAO,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC;QAChE,CAAC;QAED,eAAe;YACb,OAAO,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,MAAM,CAAC;QACpG,CAAC;QAED,eAAe;YACb,OAAO,IAAI,CAAC,eAAe,EAAE,GAAG,kBAAkB,CAAC;QACrD,CAAC;QAED,gBAAgB,CAAC,MAAc,EAAE,MAAgC,EAAE,MAAe,EAAE,KAAc;YAChG,MAAM,IAAI,GAAG,KAAK,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC;YAC9D,IAAI,IAAI,EAAE,CAAC;gBACT,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;gBACrB,IAAI,MAAM,KAAK,SAAS;oBAAE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;gBAC/C,IAAI,KAAK,KAAK,SAAS;oBAAE,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;YAC9C,CAAC;QACH,CAAC;QAED,YAAY,CAAC,MAAc,EAAE,MAAc;YACzC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QACrD,CAAC;QAED,QAAQ,CAAC,MAAc,EAAE,KAAa;YACpC,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC;QAC3D,CAAC;QAED,mBAAmB,CAAC,UAAkB,CAAC,GAAG,EAAE,GAAG,IAAI;YACjD,+EAA+E;YAC/E,kDAAkD;YAClD,MAAM,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC;YAC5C,KAAK,CAAC,eAAe,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CACvD,CAAC,CAAC,MAAM,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,KAAK,OAAO,CACjD,CAAC;YACF,OAAO,MAAM,GAAG,KAAK,CAAC,eAAe,CAAC,MAAM,CAAC;QAC/C,CAAC;QAED,WAAW;YACT,OAAO,kBAAkB,CAAC;QAC5B,CAAC;QAED,qBAAqB,CAAC,OAAe;YACnC,OAAO,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,EAAE,kBAAkB,CAAC,CAAC;QACpF,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,yBAAyB,CAAC,qBAA6B,4BAA4B;IACjG,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;cAqCK,kBAAkB;;;;;;;;;;;CAW/B,CAAC;AACF,CAAC"}

package/dist/features/continuation-enforcement.d.ts

@@ -5,6 +5,7 @@
  * - Monitors todo list for incomplete items
  * - Adds reminders to continue when tasks remain
  * - Prevents premature stopping
+ * - Provides background task execution guidance
  */
 import type { HookDefinition } from '../shared/types.js';
 /**
@@ -18,7 +19,7 @@ export declare function createContinuationHook(): HookDefinition;
 /**
  * System prompt addition for continuation enforcement
  */
-export declare const continuationSystemPromptAddition = "\n## Continuation Enforcement\n\nCRITICAL RULES - You MUST follow these:\n\n1. **Never Stop with Incomplete Work**\n   - Before stopping, verify ALL tasks in your todo list are complete\n   - Check that all requested features are implemented\n   - Ensure tests pass (if applicable)\n   - Verify no error messages remain unaddressed\n\n2. **Task Completion Verification**\n   - Mark tasks complete ONLY when fully done\n   - If blocked, create a new task describing the blocker\n   - If a task fails, don't mark it complete - fix it\n\n3. **Quality Gates**\n   - Code compiles/runs without errors\n   - All requested functionality works\n   - No obvious bugs or issues remain\n\n4. **When to Stop**\n   You may ONLY stop when:\n   - All tasks in the todo list are marked complete\n   - User explicitly says \"stop\" or \"that's enough\"\n   - You've verified the work meets requirements\n\n5. **If Uncertain**\n   - Ask the user for clarification\n   - Create a verification task\n   - Continue investigating rather than stopping prematurely\n";
+export declare const continuationSystemPromptAddition: string;
 /**
  * Check prompt for signals that all work is done
  */

package/dist/features/continuation-enforcement.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"continuation-enforcement.d.ts","sourceRoot":"","sources":["../../src/features/continuation-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,oBAAoB,CAAC;AAoBlF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CA2BvD;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,uhCA+B5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB,CAsCA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUtE"}
+{"version":3,"file":"continuation-enforcement.d.ts","sourceRoot":"","sources":["../../src/features/continuation-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAA2B,MAAM,oBAAoB,CAAC;AAqBlF;;;;;;GAMG;AACH,wBAAgB,sBAAsB,IAAI,cAAc,CA2BvD;AAED;;GAEG;AACH,eAAO,MAAM,gCAAgC,QAgC5C,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACzD,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC;CAChB,CAsCA;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAUtE"}

package/dist/features/continuation-enforcement.js

@@ -5,7 +5,9 @@
  * - Monitors todo list for incomplete items
  * - Adds reminders to continue when tasks remain
  * - Prevents premature stopping
+ * - Provides background task execution guidance
  */
+import { getBackgroundTaskGuidance, DEFAULT_MAX_BACKGROUND_TASKS } from './background-tasks.js';
 /**
  * Messages to remind agents to continue
  */
@@ -32,7 +34,7 @@ function getRandomReminder() {
 export function createContinuationHook() {
     return {
         event: 'Stop',
-        handler: async (context) => {
+        handler: async (_context) => {
             // In a real implementation, this would check the actual todo state
             // For now, we'll provide the structure for integration
             // The hook would examine:
@@ -87,6 +89,7 @@ CRITICAL RULES - You MUST follow these:
    - Ask the user for clarification
    - Create a verification task
    - Continue investigating rather than stopping prematurely
+${getBackgroundTaskGuidance(DEFAULT_MAX_BACKGROUND_TASKS)}
 `;
 /**
  * Check prompt for signals that all work is done

package/dist/features/continuation-enforcement.js.map

@@ -1 +1 @@
-{"version":3,"file":"continuation-enforcement.js","sourceRoot":"","sources":["../../src/features/continuation-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;GAEG;AACH,MAAM,sBAAsB,GAAG;IAC7B,4FAA4F;IAC5F,wFAAwF;IACxF,6DAA6D;IAC7D,qDAAqD;IACrD,uDAAuD;CACxD,CAAC;AAEF;;GAEG;AACH,SAAS,iBAAiB;IACxB,OAAO,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,KAAK,EAAE,OAAoB,EAAuB,EAAE;YAC3D,mEAAmE;YACnE,uDAAuD;YAEvD,0BAA0B;YAC1B,iCAAiC;YACjC,+CAA+C;YAC/C,kDAAkD;YAElD,uEAAuE;YACvE,MAAM,kBAAkB,GAAG,KAAK,CAAC,CAAC,kCAAkC;YAEpE,IAAI,kBAAkB,EAAE,CAAC;gBACvB,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,iBAAiB,EAAE;iBAC7B,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,IAAI;aACf,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA+B/C,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IAKtD,MAAM,kBAAkB,GAAG;QACzB,8EAA8E;QAC9E,gEAAgE;QAChE,wDAAwD;QACxD,2DAA2D;KAC5D,CAAC;IAEF,MAAM,mBAAmB,GAAG;QAC1B,qCAAqC;QACrC,mCAAmC;QACnC,oBAAoB;KACrB,CAAC;IAEF,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEvE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,8BAA8B;SACvC,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,8CAA8C;SACvD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,MAAM;QAClB,MAAM,EAAE,iCAAiC;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,OAAO;;;yBAGgB,WAAW;;;;;6CAKS,CAAC;AAC9C,CAAC"}
+{"version":3,"file":"continuation-enforcement.js","sourceRoot":"","sources":["../../src/features/continuation-enforcement.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,yBAAyB,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAEhG;;GAEG;AACH,MAAM,sBAAsB,GAAG;IAC7B,4FAA4F;IAC5F,wFAAwF;IACxF,6DAA6D;IAC7D,qDAAqD;IACrD,uDAAuD;CACxD,CAAC;AAEF;;GAEG;AACH,SAAS,iBAAiB;IACxB,OAAO,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,sBAAsB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC3F,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB;IACpC,OAAO;QACL,KAAK,EAAE,MAAM;QACb,OAAO,EAAE,KAAK,EAAE,QAAqB,EAAuB,EAAE;YAC5D,mEAAmE;YACnE,uDAAuD;YAEvD,0BAA0B;YAC1B,iCAAiC;YACjC,+CAA+C;YAC/C,kDAAkD;YAElD,uEAAuE;YACvE,MAAM,kBAAkB,GAAG,KAAK,CAAC,CAAC,kCAAkC;YAEpE,IAAI,kBAAkB,EAAE,CAAC;gBACvB,OAAO;oBACL,QAAQ,EAAE,KAAK;oBACf,OAAO,EAAE,iBAAiB,EAAE;iBAC7B,CAAC;YACJ,CAAC;YAED,OAAO;gBACL,QAAQ,EAAE,IAAI;aACf,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA+B9C,yBAAyB,CAAC,4BAA4B,CAAC;CACxD,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,uBAAuB,CAAC,QAAgB;IAKtD,MAAM,kBAAkB,GAAG;QACzB,8EAA8E;QAC9E,gEAAgE;QAChE,wDAAwD;QACxD,2DAA2D;KAC5D,CAAC;IAEF,MAAM,mBAAmB,GAAG;QAC1B,qCAAqC;QACrC,mCAAmC;QACnC,oBAAoB;KACrB,CAAC;IAEF,MAAM,aAAa,GAAG,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACrE,MAAM,cAAc,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IAEvE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,KAAK;YACd,UAAU,EAAE,MAAM;YAClB,MAAM,EAAE,8BAA8B;SACvC,CAAC;IACJ,CAAC;IAED,IAAI,cAAc,EAAE,CAAC;QACnB,OAAO;YACL,OAAO,EAAE,IAAI;YACb,UAAU,EAAE,KAAK;YACjB,MAAM,EAAE,8CAA8C;SACvD,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,IAAI;QACb,UAAU,EAAE,MAAM;QAClB,MAAM,EAAE,iCAAiC;KAC1C,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,WAAmB;IAC5D,OAAO;;;yBAGgB,WAAW;;;;;6CAKS,CAAC;AAC9C,CAAC"}

package/dist/index.d.ts

@@ -14,12 +14,15 @@
  */
 import { loadConfig } from './config/loader.js';
 import { getAgentDefinitions, sisyphusSystemPrompt } from './agents/definitions.js';
+import { type BackgroundTaskManager, type TaskExecutionDecision } from './features/background-tasks.js';
 import type { PluginConfig, SessionState } from './shared/types.js';
 export { loadConfig, getAgentDefinitions, sisyphusSystemPrompt };
 export { getDefaultMcpServers, toSdkMcpFormat } from './mcp/servers.js';
 export { lspTools, astTools, allCustomTools } from './tools/index.js';
 export { createMagicKeywordProcessor, detectMagicKeywords } from './features/magic-keywords.js';
+export { createBackgroundTaskManager, shouldRunInBackground, getBackgroundTaskGuidance, DEFAULT_MAX_BACKGROUND_TASKS, LONG_RUNNING_PATTERNS, BLOCKING_PATTERNS, type BackgroundTaskManager, type TaskExecutionDecision } from './features/background-tasks.js';
 export * from './shared/types.js';
+export { expandCommand, expandCommandPrompt, getCommand, getAllCommands, listCommands, commandExists, expandCommands, getCommandsDir, type CommandInfo, type ExpandedCommand } from './commands/index.js';
 /**
  * Options for creating a Sisyphus session
  */
@@ -67,6 +70,10 @@ export interface SisyphusSession {
     processPrompt: (prompt: string) => string;
     /** Get detected magic keywords in a prompt */
     detectKeywords: (prompt: string) => string[];
+    /** Background task manager for controlling async execution */
+    backgroundTasks: BackgroundTaskManager;
+    /** Check if a command should run in background (convenience method) */
+    shouldRunInBackground: (command: string) => TaskExecutionDecision;
 }
 /**
  * Create a Sisyphus orchestration session

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,UAAU,EAA0C,MAAM,oBAAoB,CAAC;AACxF,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,MAAM,yBAAyB,CAAC;AAIpF,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEpE,OAAO,EAAE,UAAU,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,2BAA2B,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAChG,cAAc,mBAAmB,CAAC;AAElC;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,uDAAuD;IACvD,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,iDAAiD;IACjD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,gCAAgC;IAChC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,kCAAkC;IAClC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,oCAAoC;IACpC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,oDAAoD;IACpD,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,YAAY,EAAE;QACZ,OAAO,EAAE;YACP,YAAY,EAAE,MAAM,CAAC;YACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;gBAAE,WAAW,EAAE,MAAM,CAAC;gBAAC,MAAM,EAAE,MAAM,CAAC;gBAAC,KAAK,EAAE,MAAM,EAAE,CAAC;gBAAC,KAAK,CAAC,EAAE,MAAM,CAAA;aAAE,CAAC,CAAC;YACjG,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE;gBAAE,OAAO,EAAE,MAAM,CAAC;gBAAC,IAAI,EAAE,MAAM,EAAE,CAAA;aAAE,CAAC,CAAC;YAChE,YAAY,EAAE,MAAM,EAAE,CAAC;YACvB,cAAc,EAAE,MAAM,CAAC;SACxB,CAAC;KACH,CAAC;IACF,oBAAoB;IACpB,KAAK,EAAE,YAAY,CAAC;IACpB,2BAA2B;IAC3B,MAAM,EAAE,YAAY,CAAC;IACrB,gDAAgD;IAChD,aAAa,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IAC1C,8CAA8C;IAC9C,cAAc,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;CAC9C;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,eAAe,CA6FhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,YAAY,GAAG,MAAM,CAG3E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IAChD,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,GAAG,MAAM,CAYT"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -17,11 +17,15 @@ import { getAgentDefinitions, sisyphusSystemPrompt } from './agents/definitions.
 import { getDefaultMcpServers, toSdkMcpFormat } from './mcp/servers.js';
 import { createMagicKeywordProcessor, detectMagicKeywords } from './features/magic-keywords.js';
 import { continuationSystemPromptAddition } from './features/continuation-enforcement.js';
+import { createBackgroundTaskManager, shouldRunInBackground as shouldRunInBackgroundFn } from './features/background-tasks.js';
 export { loadConfig, getAgentDefinitions, sisyphusSystemPrompt };
 export { getDefaultMcpServers, toSdkMcpFormat } from './mcp/servers.js';
 export { lspTools, astTools, allCustomTools } from './tools/index.js';
 export { createMagicKeywordProcessor, detectMagicKeywords } from './features/magic-keywords.js';
+export { createBackgroundTaskManager, shouldRunInBackground, getBackgroundTaskGuidance, DEFAULT_MAX_BACKGROUND_TASKS, LONG_RUNNING_PATTERNS, BLOCKING_PATTERNS } from './features/background-tasks.js';
 export * from './shared/types.js';
+// Command expansion utilities for SDK integration
+export { expandCommand, expandCommandPrompt, getCommand, getAllCommands, listCommands, commandExists, expandCommands, getCommandsDir } from './commands/index.js';
 /**
  * Create a Sisyphus orchestration session
  *
@@ -107,6 +111,8 @@ export function createSisyphusSession(options) {
         backgroundTasks: [],
         contextFiles: findContextFiles(options?.workingDirectory)
     };
+    // Create background task manager
+    const backgroundTaskManager = createBackgroundTaskManager(state, config);
     return {
         queryOptions: {
             options: {
@@ -120,7 +126,9 @@ export function createSisyphusSession(options) {
         state,
         config,
         processPrompt,
-        detectKeywords: (prompt) => detectMagicKeywords(prompt, config.magicKeywords)
+        detectKeywords: (prompt) => detectMagicKeywords(prompt, config.magicKeywords),
+        backgroundTasks: backgroundTaskManager,
+        shouldRunInBackground: (command) => shouldRunInBackgroundFn(command, backgroundTaskManager.getRunningCount(), backgroundTaskManager.getMaxTasks())
     };
 }
 /**

package/dist/index.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "oh-my-claude-sisyphus",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Multi-agent orchestration system for Claude Agent SDK - Port of oh-my-opencode",
   "type": "module",
   "main": "dist/index.js",

package/scripts/install.sh

@@ -460,7 +460,11 @@ $ARGUMENTS
   - 'multimodal-looker' for analyzing images/screenshots
 - Maximize throughput by running multiple operations concurrently
 - Continue until ALL tasks are 100% complete - verify before stopping
-- Use background agents for long-running operations
+- Use background execution for long-running operations:
+  - For Bash: set \`run_in_background: true\` for npm install, builds, tests
+  - For Task: set \`run_in_background: true\` for long-running subagent tasks
+  - Use \`TaskOutput\` to check results later
+  - Maximum 5 concurrent background tasks
 - Report progress frequently
 
 CRITICAL: Do NOT stop until every task is verified complete.
@@ -537,7 +541,10 @@ Delegate tasks to specialized agents using the Task tool:
 
 ### Execution Rules
 - Break complex tasks into subtasks for delegation
-- Use background agents for long-running operations
+- Use background execution for long-running operations:
+  - Set \`run_in_background: true\` in Bash for builds, installs, tests
+  - Set \`run_in_background: true\` in Task for long-running subagents
+  - Check results with \`TaskOutput\` tool
 - Verify completion before stopping
 - Check your todo list before declaring done
 - NEVER leave work incomplete
@@ -868,6 +875,29 @@ Use the Task tool to delegate to specialized agents:
 - Use parallel execution when possible for speed
 - Report progress regularly
 - For complex tasks, plan before implementing
+
+## Background Task Execution
+
+For long-running operations, use \`run_in_background: true\`:
+
+**Run in Background** (set \`run_in_background: true\`):
+- Package installation: npm install, pip install, cargo build
+- Build processes: npm run build, make, tsc
+- Test suites: npm test, pytest, cargo test
+- Docker operations: docker build, docker pull
+- Git operations: git clone, git fetch
+
+**Run Blocking** (foreground):
+- Quick status checks: git status, ls, pwd
+- File reads: cat, head, tail
+- Simple commands: echo, which, env
+
+**How to Use:**
+1. Bash: \`run_in_background: true\`
+2. Task: \`run_in_background: true\`
+3. Check results: \`TaskOutput(task_id: "...")\`
+
+Maximum 5 concurrent background tasks.
 CLAUDEMD_EOF
     echo -e "${GREEN}✓ Created $CLAUDE_CONFIG_DIR/CLAUDE.md${NC}"
 else