@proletariat/cli 0.3.55 → 0.3.57

package/dist/commands/session/prune.js

@@ -0,0 +1,327 @@
+import { Flags } from '@oclif/core';
+import * as path from 'node:path';
+import Database from 'better-sqlite3';
+import { styles } from '../../lib/styles.js';
+import { getWorkspaceInfo, cleanupAgent, getCleanableAgents, killTmuxSession, } from '../../lib/agents/commands.js';
+import { ExecutionStorage } from '../../lib/execution/index.js';
+import { parseSessionName, getHostTmuxSessionNames, getContainerTmuxSessionMap, flattenContainerSessions, findContainerSessionsByPrefix, findSessionForExecution, } from '../../lib/execution/session-utils.js';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+export default class SessionPrune extends PMOCommand {
+    static description = 'Clean up stale sessions, orphan tmux sessions, and idle ephemeral agents';
+    static examples = [
+        '<%= config.bin %> session prune',
+        '<%= config.bin %> session prune --dry-run',
+        '<%= config.bin %> session prune --force',
+        '<%= config.bin %> session prune --age 24',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        'dry-run': Flags.boolean({
+            char: 'd',
+            description: 'Show what would be pruned without actually doing it',
+            default: false,
+        }),
+        force: Flags.boolean({
+            char: 'f',
+            description: 'Force cleanup even if agents have uncommitted/unpushed work',
+            default: false,
+        }),
+        yes: Flags.boolean({
+            char: 'y',
+            description: 'Skip confirmation prompt',
+            default: false,
+        }),
+        age: Flags.integer({
+            description: 'Only prune sessions/agents idle for more than N hours (default: 0 = all idle)',
+            default: 0,
+        }),
+    };
+    getPMOOptions() {
+        return { promptIfMultiple: false };
+    }
+    async execute() {
+        const { flags } = await this.parse(SessionPrune);
+        const jsonMode = shouldOutputJson(flags);
+        const dryRun = flags['dry-run'];
+        const forceCleanup = flags.force;
+        const skipConfirm = flags.yes;
+        const ageHours = flags.age;
+        // Get workspace info
+        let workspaceInfo;
+        try {
+            workspaceInfo = getWorkspaceInfo();
+        }
+        catch {
+            if (jsonMode) {
+                outputErrorAsJson('NOT_IN_WORKSPACE', 'Not in a workspace. Run from a proletariat HQ directory.', createMetadata('session prune', flags));
+                return;
+            }
+            this.log(styles.error('Not in a workspace. Run from a proletariat HQ directory.'));
+            return;
+        }
+        // Open database
+        const dbPath = path.join(workspaceInfo.path, '.proletariat', 'workspace.db');
+        const db = new Database(dbPath);
+        const executionStorage = new ExecutionStorage(db);
+        try {
+            const result = {
+                staleExecutionsCleaned: 0,
+                orphanSessionsKilled: [],
+                ephemeralAgentsCleaned: [],
+                errors: [],
+            };
+            // =====================================================================
+            // Step 1: Clean up stale execution records
+            // =====================================================================
+            const staleCount = executionStorage.cleanupStaleExecutions();
+            result.staleExecutionsCleaned = staleCount;
+            // =====================================================================
+            // Step 2: Find and kill orphan tmux sessions
+            // =====================================================================
+            const hostTmuxSessions = getHostTmuxSessionNames();
+            const containerTmuxSessions = getContainerTmuxSessionMap();
+            const allContainerSessions = flattenContainerSessions(containerTmuxSessions);
+            // Get DB-tracked active executions to know which sessions are accounted for
+            const runningExecutions = executionStorage.listExecutions({ status: 'running' });
+            const startingExecutions = executionStorage.listExecutions({ status: 'starting' });
+            const activeExecutions = [...runningExecutions, ...startingExecutions];
+            const matchedHostSessions = new Set();
+            const matchedContainerSessions = new Set();
+            for (const exec of activeExecutions) {
+                const isContainer = exec.environment === 'devcontainer';
+                let actualSessionId = exec.sessionId;
+                if (!exec.sessionId) {
+                    if (isContainer && exec.containerId) {
+                        const containerSessions = findContainerSessionsByPrefix(containerTmuxSessions, exec.containerId);
+                        const match = findSessionForExecution(exec.ticketId, exec.agentName, containerSessions);
+                        if (match)
+                            actualSessionId = match;
+                    }
+                    else {
+                        const match = findSessionForExecution(exec.ticketId, exec.agentName, hostTmuxSessions);
+                        if (match)
+                            actualSessionId = match;
+                    }
+                }
+                if (actualSessionId) {
+                    if (isContainer && exec.containerId) {
+                        matchedContainerSessions.add(`${exec.containerId}:${actualSessionId}`);
+                    }
+                    else {
+                        matchedHostSessions.add(actualSessionId);
+                    }
+                }
+            }
+            // Find orphan host sessions (match prlt pattern but not tracked in DB)
+            const orphanHostSessions = [];
+            for (const sessionName of hostTmuxSessions) {
+                if (matchedHostSessions.has(sessionName))
+                    continue;
+                const parsed = parseSessionName(sessionName);
+                if (parsed) {
+                    orphanHostSessions.push(sessionName);
+                }
+            }
+            // Find orphan container sessions
+            const orphanContainerSessions = [];
+            for (const { sessionName, containerId } of allContainerSessions) {
+                if (matchedContainerSessions.has(`${containerId}:${sessionName}`))
+                    continue;
+                const parsed = parseSessionName(sessionName);
+                if (parsed) {
+                    orphanContainerSessions.push({ sessionName, containerId });
+                }
+            }
+            // Kill orphan sessions
+            for (const sessionName of orphanHostSessions) {
+                if (dryRun) {
+                    result.orphanSessionsKilled.push(sessionName);
+                }
+                else {
+                    if (killTmuxSession(sessionName)) {
+                        result.orphanSessionsKilled.push(sessionName);
+                    }
+                    else {
+                        result.errors.push(`Failed to kill orphan session: ${sessionName}`);
+                    }
+                }
+            }
+            for (const { sessionName, containerId } of orphanContainerSessions) {
+                if (dryRun) {
+                    result.orphanSessionsKilled.push(`${containerId}:${sessionName}`);
+                }
+                else {
+                    try {
+                        const { execSync } = await import('node:child_process');
+                        execSync(`docker exec ${containerId} tmux kill-session -t "${sessionName}"`, { stdio: 'pipe', timeout: 10000 });
+                        result.orphanSessionsKilled.push(`${containerId}:${sessionName}`);
+                    }
+                    catch {
+                        result.errors.push(`Failed to kill container orphan session: ${containerId}:${sessionName}`);
+                    }
+                }
+            }
+            // =====================================================================
+            // Step 3: Clean up idle ephemeral agents
+            // =====================================================================
+            // Refresh workspace info after stale cleanup
+            const freshWorkspaceInfo = getWorkspaceInfo();
+            let cleanableAgents = getCleanableAgents(freshWorkspaceInfo, true);
+            // Apply age filter if specified
+            if (ageHours > 0) {
+                const cutoffMs = ageHours * 60 * 60 * 1000;
+                cleanableAgents = cleanableAgents.filter(agent => {
+                    const agentCreated = agent.created_at ? new Date(agent.created_at).getTime() : 0;
+                    return agentCreated > 0 && (Date.now() - agentCreated) > cutoffMs;
+                });
+            }
+            // Determine total work to be done
+            const totalOrphans = orphanHostSessions.length + orphanContainerSessions.length;
+            const totalWork = staleCount + totalOrphans + cleanableAgents.length;
+            if (totalWork === 0) {
+                if (jsonMode) {
+                    outputSuccessAsJson({
+                        message: 'Nothing to prune. All sessions and agents are clean.',
+                        ...result,
+                    }, createMetadata('session prune', flags));
+                    return;
+                }
+                this.log('');
+                this.log(styles.success('Nothing to prune. All sessions and agents are clean.'));
+                this.log('');
+                return;
+            }
+            // Show summary of what will be pruned
+            if (!jsonMode) {
+                this.log('');
+                this.log(styles.header(`${dryRun ? '[DRY RUN] ' : ''}Session Prune`));
+                this.log('═'.repeat(60));
+                if (staleCount > 0) {
+                    this.log(styles.info(`  ${staleCount} stale execution record(s) ${dryRun ? 'would be ' : ''}cleaned`));
+                }
+                if (totalOrphans > 0) {
+                    this.log(styles.info(`  ${totalOrphans} orphan tmux session(s) ${dryRun ? 'would be ' : ''}killed:`));
+                    for (const s of orphanHostSessions) {
+                        this.log(styles.muted(`    - ${s} (host)`));
+                    }
+                    for (const { sessionName, containerId } of orphanContainerSessions) {
+                        this.log(styles.muted(`    - ${sessionName} (container: ${containerId.substring(0, 12)})`));
+                    }
+                }
+                if (cleanableAgents.length > 0) {
+                    this.log(styles.info(`  ${cleanableAgents.length} idle ephemeral agent(s) ${dryRun ? 'would be ' : ''}cleaned up:`));
+                    for (const agent of cleanableAgents) {
+                        this.log(styles.muted(`    - ${agent.name}`));
+                    }
+                }
+                this.log('');
+            }
+            // Confirm unless --yes or --dry-run
+            if (!skipConfirm && !dryRun && cleanableAgents.length > 0) {
+                if (jsonMode) {
+                    outputSuccessAsJson({
+                        message: 'Confirmation required',
+                        preview: {
+                            staleExecutions: staleCount,
+                            orphanSessions: totalOrphans,
+                            ephemeralAgents: cleanableAgents.map(a => a.name),
+                        },
+                    }, createMetadata('session prune', flags));
+                    return;
+                }
+                const { confirm } = await this.prompt([
+                    {
+                        type: 'list',
+                        name: 'confirm',
+                        message: `Prune ${cleanableAgents.length} ephemeral agent(s) and ${totalOrphans} orphan session(s)?`,
+                        choices: [
+                            { name: 'No, cancel', value: false },
+                            { name: 'Yes, prune', value: true },
+                        ],
+                        default: 0,
+                    },
+                ], null);
+                if (!confirm) {
+                    this.log(styles.muted('Operation cancelled.'));
+                    return;
+                }
+            }
+            // Clean up ephemeral agents
+            if (!dryRun) {
+                for (const agent of cleanableAgents) {
+                    if (!jsonMode) {
+                        this.log(styles.info(`  Cleaning up agent: ${agent.name}`));
+                    }
+                    // eslint-disable-next-line no-await-in-loop -- Sequential cleanup
+                    const cleanupResult = await cleanupAgent(freshWorkspaceInfo, agent.name, {
+                        log: jsonMode ? undefined : (msg) => this.log(styles.muted(`    ${msg}`)),
+                        dryRun: false,
+                        force: forceCleanup,
+                        pushFirst: !forceCleanup, // Try to push work before cleanup unless forcing
+                    });
+                    result.ephemeralAgentsCleaned.push(cleanupResult);
+                    if (!cleanupResult.success && cleanupResult.blockedByGit && !jsonMode) {
+                        this.log(styles.warning(`    Skipped ${agent.name}: has unsaved work (use --force to override)`));
+                    }
+                }
+            }
+            else {
+                // Dry run: just report what would happen
+                for (const agent of cleanableAgents) {
+                    result.ephemeralAgentsCleaned.push({
+                        agent: agent.name,
+                        success: true,
+                        tmuxSessionsKilled: [],
+                        containersRemoved: [],
+                        directoriesRemoved: [],
+                        errors: [],
+                    });
+                }
+            }
+            // Output results
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    message: `${dryRun ? 'Would prune' : 'Pruned'} ${totalWork} item(s)`,
+                    dryRun,
+                    ...result,
+                    summary: {
+                        staleExecutionsCleaned: result.staleExecutionsCleaned,
+                        orphanSessionsKilled: result.orphanSessionsKilled.length,
+                        ephemeralAgentsCleaned: result.ephemeralAgentsCleaned.filter(r => r.success).length,
+                        ephemeralAgentsFailed: result.ephemeralAgentsCleaned.filter(r => !r.success).length,
+                    },
+                }, createMetadata('session prune', flags));
+                return;
+            }
+            // Summary
+            this.log('');
+            this.log(styles.header(`${dryRun ? '[DRY RUN] ' : ''}Prune Summary`));
+            this.log('─'.repeat(40));
+            if (result.staleExecutionsCleaned > 0) {
+                this.log(styles.success(`  ${result.staleExecutionsCleaned} stale execution(s) ${dryRun ? 'would be ' : ''}cleaned`));
+            }
+            if (result.orphanSessionsKilled.length > 0) {
+                this.log(styles.success(`  ${result.orphanSessionsKilled.length} orphan session(s) ${dryRun ? 'would be ' : ''}killed`));
+            }
+            const successfulCleanups = result.ephemeralAgentsCleaned.filter(r => r.success);
+            const failedCleanups = result.ephemeralAgentsCleaned.filter(r => !r.success);
+            if (successfulCleanups.length > 0) {
+                this.log(styles.success(`  ${successfulCleanups.length} ephemeral agent(s) ${dryRun ? 'would be ' : ''}cleaned up`));
+            }
+            if (failedCleanups.length > 0) {
+                this.log(styles.warning(`  ${failedCleanups.length} agent(s) skipped (unsaved work)`));
+            }
+            if (result.errors.length > 0) {
+                for (const err of result.errors) {
+                    this.log(styles.error(`  ${err}`));
+                }
+            }
+            this.log('');
+        }
+        finally {
+            db.close();
+        }
+    }
+}
+//# sourceMappingURL=prune.js.map

package/dist/commands/session/prune.js.map

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

package/dist/commands/shortcut/connect.d.ts

@@ -0,0 +1,15 @@
+import { PMOCommand } from '../../lib/pmo/index.js';
+export default class ShortcutConnect extends PMOCommand {
+    static description: string;
+    static examples: string[];
+    static flags: {
+        check: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        force: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        disconnect: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        project: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    execute(): Promise<void>;
+    private handleCheck;
+}

package/dist/commands/shortcut/connect.js

@@ -0,0 +1,210 @@
+import { Flags } from '@oclif/core';
+import inquirer from 'inquirer';
+import { PMOCommand, pmoBaseFlags } from '../../lib/pmo/index.js';
+import { colors } from '../../lib/colors.js';
+import { shouldOutputJson, outputSuccessAsJson, outputErrorAsJson, createMetadata, } from '../../lib/prompt-json.js';
+import { isShortcutConfigured, loadShortcutConfig, saveShortcutApiToken, clearShortcutConfig, getShortcutApiToken, } from '../../lib/shortcut/index.js';
+const SHORTCUT_API_URL = 'https://api.app.shortcut.com/api/v3';
+async function verifyShortcutToken(apiToken, fetchImpl = fetch) {
+    const response = await fetchImpl(`${SHORTCUT_API_URL}/member`, {
+        method: 'GET',
+        headers: {
+            'Content-Type': 'application/json',
+            'Shortcut-Token': apiToken,
+        },
+    });
+    if (response.status === 401 || response.status === 403) {
+        throw new Error('Invalid or expired Shortcut API token.');
+    }
+    if (!response.ok) {
+        throw new Error(`Shortcut API request failed with status ${response.status}.`);
+    }
+    const data = await response.json();
+    return {
+        userName: data.profile?.name || 'Unknown',
+        email: data.profile?.email_address || '',
+        mentionName: data.profile?.mention_name || '',
+    };
+}
+export default class ShortcutConnect extends PMOCommand {
+    static description = 'Connect to Shortcut workspace and configure authentication';
+    static examples = [
+        '<%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --check',
+        '<%= config.bin %> <%= command.id %> --force',
+        '<%= config.bin %> <%= command.id %> --disconnect',
+        'SHORTCUT_API_TOKEN=... <%= config.bin %> <%= command.id %>',
+        '<%= config.bin %> <%= command.id %> --json',
+    ];
+    static flags = {
+        ...pmoBaseFlags,
+        check: Flags.boolean({
+            description: 'Only check if Shortcut credentials are valid (do not prompt)',
+            default: false,
+        }),
+        force: Flags.boolean({
+            description: 'Force re-authentication even if credentials exist',
+            default: false,
+        }),
+        disconnect: Flags.boolean({
+            description: 'Remove stored Shortcut credentials and configuration',
+            default: false,
+        }),
+    };
+    async execute() {
+        const { flags } = await this.parse(ShortcutConnect);
+        const jsonMode = shouldOutputJson(flags);
+        const db = this.storage.getDatabase();
+        // Handle --disconnect
+        if (flags.disconnect) {
+            clearShortcutConfig(db);
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    disconnected: true,
+                    message: 'Shortcut credentials and configuration removed.',
+                }, createMetadata('shortcut connect', flags));
+                return;
+            }
+            this.log(colors.success('Shortcut credentials and configuration removed.'));
+            return;
+        }
+        // Handle --check (health check)
+        if (flags.check) {
+            return this.handleCheck(flags, jsonMode, db);
+        }
+        // Check for existing config
+        const existingConfig = loadShortcutConfig(db);
+        if (existingConfig && !flags.force) {
+            try {
+                const info = await verifyShortcutToken(existingConfig.apiToken);
+                if (jsonMode) {
+                    outputSuccessAsJson({
+                        authenticated: true,
+                        user: info.userName,
+                        email: info.email,
+                        mentionName: info.mentionName,
+                        workspaceSlug: existingConfig.workspaceSlug ?? null,
+                        message: 'Already connected. Use --force to re-authenticate.',
+                    }, createMetadata('shortcut connect', flags));
+                    return;
+                }
+                this.log(colors.success('Already connected to Shortcut'));
+                this.log(colors.textMuted(`  User: ${info.userName} (${info.email})`));
+                if (existingConfig.workspaceSlug) {
+                    this.log(colors.textMuted(`  Workspace: ${existingConfig.workspaceSlug}`));
+                }
+                this.log('');
+                this.log(colors.textMuted('Use --force to re-authenticate.'));
+                return;
+            }
+            catch {
+                // Stored token is bad, proceed with re-auth
+            }
+        }
+        // Try environment variable first
+        let apiToken = getShortcutApiToken(db);
+        if (!apiToken) {
+            if (jsonMode) {
+                outputErrorAsJson('API_TOKEN_REQUIRED', 'Shortcut API token required. Set SHORTCUT_API_TOKEN or PRLT_SHORTCUT_API_TOKEN environment variable, or run interactively.', createMetadata('shortcut connect', flags));
+                this.exit(1);
+            }
+            this.log('');
+            this.log(colors.primary('Shortcut Authentication'));
+            this.log('');
+            this.log('Create an API token at:');
+            this.log(colors.textSecondary('  https://app.shortcut.com/settings/account/api-tokens'));
+            this.log('');
+            const { inputToken } = await inquirer.prompt([{
+                    type: 'password',
+                    name: 'inputToken',
+                    message: 'Enter your Shortcut API token:',
+                    mask: '*',
+                    validate: (input) => {
+                        if (!input.trim())
+                            return 'API token is required';
+                        return true;
+                    },
+                }]);
+            apiToken = inputToken;
+        }
+        // Verify the API token
+        if (!jsonMode) {
+            this.log('');
+            this.log(colors.textMuted('Verifying API token...'));
+        }
+        try {
+            const info = await verifyShortcutToken(apiToken);
+            // Save API token
+            saveShortcutApiToken(db, apiToken);
+            if (!jsonMode) {
+                this.log(colors.success('Connected to Shortcut'));
+                this.log(colors.textMuted(`  Signed in as ${info.userName} (${info.email})`));
+            }
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    authenticated: true,
+                    user: info.userName,
+                    email: info.email,
+                    mentionName: info.mentionName,
+                }, createMetadata('shortcut connect', flags));
+                return;
+            }
+            this.log('');
+            this.log(colors.success('Shortcut integration configured!'));
+            this.log(colors.textMuted('  Run "prlt work shortcut" to pull stories and spawn agents'));
+            this.log(colors.textMuted('  Run "prlt work spawn --from shortcut" to use as default source'));
+        }
+        catch (error) {
+            const message = `Authentication failed: ${error instanceof Error ? error.message : String(error)}`;
+            if (jsonMode) {
+                outputErrorAsJson('SHORTCUT_CONNECT_FAILED', message, createMetadata('shortcut connect', flags));
+                this.exit(1);
+            }
+            this.error(message);
+        }
+    }
+    async handleCheck(flags, jsonMode, db) {
+        if (!isShortcutConfigured(db)) {
+            if (jsonMode) {
+                outputErrorAsJson('SHORTCUT_NOT_CONFIGURED', 'Shortcut is not configured. Run "prlt shortcut connect" to authenticate.', createMetadata('shortcut connect', flags));
+                this.exit(1);
+            }
+            this.log(colors.warning('Shortcut is not configured.'));
+            this.log(colors.textMuted('Run "prlt shortcut connect" to authenticate.'));
+            this.exit(1);
+            return;
+        }
+        const config = loadShortcutConfig(db);
+        try {
+            const info = await verifyShortcutToken(config.apiToken);
+            if (jsonMode) {
+                outputSuccessAsJson({
+                    authenticated: true,
+                    connected: true,
+                    user: info.userName,
+                    email: info.email,
+                    mentionName: info.mentionName,
+                    workspaceSlug: config.workspaceSlug ?? null,
+                }, createMetadata('shortcut connect', flags));
+                return;
+            }
+            this.log(colors.success('Shortcut connection is active'));
+            this.log(colors.textMuted(`  User: ${info.userName} (${info.email})`));
+            if (config.workspaceSlug) {
+                this.log(colors.textMuted(`  Workspace: ${config.workspaceSlug}`));
+            }
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            if (jsonMode) {
+                outputErrorAsJson('SHORTCUT_AUTH_INVALID', `Stored Shortcut API token is invalid or expired: ${message}`, createMetadata('shortcut connect', flags));
+                this.exit(1);
+            }
+            this.log(colors.error('Stored Shortcut API token is invalid or expired.'));
+            this.log(colors.textMuted(`  Error: ${message}`));
+            this.log(colors.textMuted('Run "prlt shortcut connect --force" to re-authenticate.'));
+            this.exit(1);
+        }
+    }
+}
+//# sourceMappingURL=connect.js.map

package/dist/commands/shortcut/connect.js.map

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

package/dist/commands/stop.d.ts

@@ -0,0 +1,19 @@
+/**
+ * prlt stop <agent> — stop an agent
+ *
+ * Sends SIGTERM and kills the tmux session.
+ * Works without HQ / PMO.
+ */
+import { PromptCommand } from '../lib/prompt-command.js';
+export default class Stop extends PromptCommand {
+    static description: string;
+    static examples: string[];
+    static args: {
+        agent: import("@oclif/core/interfaces").Arg<string, Record<string, unknown>>;
+    };
+    static flags: {
+        json: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        machine: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+    };
+    run(): Promise<void>;
+}