oh-my-claude-sisyphus 1.1.1 → 1.2.1

package/dist/features/auto-update.js

@@ -0,0 +1,326 @@
+/**
+ * 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.status === 404) {
+        // No releases found - try to get version from package.json in repo
+        const pkgResponse = await fetch(`${GITHUB_RAW_URL}/main/package.json`, {
+            headers: {
+                'User-Agent': 'oh-my-claude-sisyphus-updater'
+            }
+        });
+        if (pkgResponse.ok) {
+            const pkg = await pkgResponse.json();
+            return {
+                tag_name: `v${pkg.version}`,
+                name: `Version ${pkg.version}`,
+                published_at: new Date().toISOString(),
+                html_url: `https://github.com/${REPO_OWNER}/${REPO_NAME}`,
+                body: 'No release notes available (fetched from package.json)',
+                prerelease: false,
+                draft: false
+            };
+        }
+        throw new Error('No releases found and could not fetch package.json');
+    }
+    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 {
+            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"}