@ginkoai/cli 1.6.2 → 1.7.1

package/dist/commands/checkpoint/index.js

@@ -0,0 +1,91 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [checkpoint, cli, epic-004-sprint5, task-1, resilience]
+ * @related: [create.ts, list.ts, show.ts, checkpoint.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk]
+ */
+/**
+ * Checkpoint Commands (EPIC-004 Sprint 5 TASK-1)
+ *
+ * CLI commands for creating, listing, and inspecting checkpoints
+ * Checkpoints enable rollback and recovery for multi-agent task execution
+ */
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { createCheckpointCommand } from './create.js';
+import { listCheckpointsCommand } from './list.js';
+import { showCheckpointCommand } from './show.js';
+/**
+ * Main checkpoint command with subcommands
+ */
+export function checkpointCommand() {
+    const checkpoint = new Command('checkpoint')
+        .description('Manage checkpoints for task rollback and recovery (EPIC-004)')
+        .showHelpAfterError('(use --help for additional information)')
+        .addHelpText('after', `
+${chalk.gray('Quick Start:')}
+  ${chalk.green('ginko checkpoint create')} --task TASK-1 --message "Before refactor"  ${chalk.gray('# Create checkpoint')}
+  ${chalk.green('ginko checkpoint list')} --task TASK-1                               ${chalk.gray('# List task checkpoints')}
+  ${chalk.green('ginko checkpoint show')} cp_xxx                                      ${chalk.gray('# Show checkpoint details')}
+
+${chalk.gray('Usage Examples:')}
+  ${chalk.green('ginko checkpoint create')} --task TASK-1 --message "Completed authentication"
+  ${chalk.green('ginko checkpoint create')} --task TASK-2  ${chalk.dim('# Auto-generated message')}
+  ${chalk.green('ginko checkpoint list')}  ${chalk.dim('# List all checkpoints')}
+  ${chalk.green('ginko checkpoint list')} --task TASK-1  ${chalk.dim('# Filter by task')}
+  ${chalk.green('ginko checkpoint show')} cp_1701234567_a1b2c3d4
+
+${chalk.gray('Features:')}
+  ${chalk.cyan('📸 Lightweight Snapshots')}  - Captures git commit, files, event stream position
+  ${chalk.cyan('🔄 Quick Recovery')}         - Roll back to any checkpoint using git operations
+  ${chalk.cyan('🔍 Task Filtering')}         - List checkpoints for specific tasks
+  ${chalk.cyan('📊 Detailed Inspection')}    - View checkpoint metadata and state
+
+${chalk.gray('Checkpoint Structure:')}
+  ${chalk.dim('Checkpoints store references to work state:')}
+  ${chalk.dim('- Git commit hash (current HEAD)')}
+  ${chalk.dim('- Modified files since task start')}
+  ${chalk.dim('- Event stream position (last event ID)')}
+  ${chalk.dim('- Optional message and metadata')}
+
+${chalk.gray('Learn More:')}
+  ${chalk.dim('https://docs.ginko.ai/checkpoints')}
+`)
+        .action(() => {
+        // When called without subcommand, show help
+        checkpoint.help({ error: false });
+    });
+    // Create command
+    checkpoint
+        .command('create')
+        .description('Create a checkpoint for current work state')
+        .requiredOption('--task <taskId>', 'Task ID for this checkpoint (e.g., TASK-1)')
+        .option('--message <message>', 'Optional description of checkpoint')
+        .option('--agent <agentId>', 'Agent ID (auto-detected if not provided)')
+        .action(async (options) => {
+        await createCheckpointCommand(options);
+    });
+    // List command
+    checkpoint
+        .command('list')
+        .description('List checkpoints with optional task filtering')
+        .option('--task <taskId>', 'Filter by task ID')
+        .action(async (options) => {
+        await listCheckpointsCommand(options);
+    });
+    // Show command
+    checkpoint
+        .command('show <checkpointId>')
+        .description('Show detailed checkpoint information')
+        .action(async (checkpointId) => {
+        await showCheckpointCommand(checkpointId);
+    });
+    return checkpoint;
+}
+// Export for use in main CLI
+export default checkpointCommand;
+//# sourceMappingURL=index.js.map

package/dist/commands/checkpoint/index.js.map

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

package/dist/commands/checkpoint/list.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [checkpoint, list, cli, epic-004-sprint5, task-1]
+ * @related: [checkpoint.ts, create.ts, show.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk, cli-table3, checkpoint]
+ */
+interface ListCheckpointsOptions {
+    task?: string;
+}
+/**
+ * List checkpoints with optional task filtering
+ *
+ * Displays:
+ * - Checkpoint ID
+ * - Timestamp
+ * - Git commit (short hash)
+ * - Modified file count
+ * - Message (if provided)
+ * - Latest marker
+ */
+export declare function listCheckpointsCommand(options: ListCheckpointsOptions): Promise<void>;
+export {};
+//# sourceMappingURL=list.d.ts.map

package/dist/commands/checkpoint/list.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.d.ts","sourceRoot":"","sources":["../../../src/commands/checkpoint/list.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAMH,UAAU,sBAAsB;IAC9B,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAwG3F"}

package/dist/commands/checkpoint/list.js

@@ -0,0 +1,115 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [checkpoint, list, cli, epic-004-sprint5, task-1]
+ * @related: [checkpoint.ts, create.ts, show.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [chalk, cli-table3, checkpoint]
+ */
+import chalk from 'chalk';
+import Table from 'cli-table3';
+import { listCheckpoints, getLatestCheckpoint } from '../../lib/checkpoint.js';
+/**
+ * List checkpoints with optional task filtering
+ *
+ * Displays:
+ * - Checkpoint ID
+ * - Timestamp
+ * - Git commit (short hash)
+ * - Modified file count
+ * - Message (if provided)
+ * - Latest marker
+ */
+export async function listCheckpointsCommand(options) {
+    try {
+        // Get checkpoints (optionally filtered by task)
+        const checkpoints = await listCheckpoints(options.task);
+        if (checkpoints.length === 0) {
+            if (options.task) {
+                console.log(chalk.yellow(`\n⚠️  No checkpoints found for task ${chalk.bold(options.task)}`));
+                console.log(chalk.dim('Create one with: ginko checkpoint create --task ' + options.task));
+            }
+            else {
+                console.log(chalk.yellow('\n⚠️  No checkpoints found'));
+                console.log(chalk.dim('Create one with: ginko checkpoint create --task TASK-1'));
+            }
+            return;
+        }
+        // Get latest checkpoint for marking
+        const latestCheckpoint = options.task
+            ? await getLatestCheckpoint(options.task)
+            : checkpoints[0]; // Already sorted by timestamp desc
+        // Display header
+        console.log(chalk.green(`\n📸 Checkpoints ${options.task ? `for ${chalk.bold(options.task)}` : ''}`));
+        console.log(chalk.gray('─'.repeat(80)));
+        // Create table
+        const table = new Table({
+            head: ['ID', 'Timestamp', 'Commit', 'Files', 'Message'],
+            style: {
+                head: ['cyan'],
+                border: ['gray']
+            },
+            colWidths: [25, 20, 10, 8, 35],
+            wordWrap: true
+        });
+        // Add checkpoint rows
+        checkpoints.forEach((checkpoint) => {
+            const isLatest = latestCheckpoint?.id === checkpoint.id;
+            // Format ID with latest marker
+            const idText = isLatest
+                ? chalk.cyan(checkpoint.id) + chalk.yellow(' (latest)')
+                : chalk.dim(checkpoint.id);
+            // Format timestamp
+            const timestamp = checkpoint.timestamp.toLocaleString('en-US', {
+                month: 'short',
+                day: 'numeric',
+                hour: '2-digit',
+                minute: '2-digit'
+            });
+            // Format commit hash (short)
+            const commitShort = checkpoint.gitCommit.substring(0, 7);
+            const commitText = isLatest ? chalk.cyan(commitShort) : chalk.dim(commitShort);
+            // Format file count
+            const fileCount = checkpoint.filesModified.length;
+            const fileCountText = fileCount > 0
+                ? chalk.yellow(fileCount.toString())
+                : chalk.dim('0');
+            // Format message
+            const message = checkpoint.message || chalk.dim('(no message)');
+            const messageText = isLatest ? message : chalk.dim(message);
+            table.push([
+                idText,
+                chalk.dim(timestamp),
+                commitText,
+                fileCountText,
+                messageText
+            ]);
+        });
+        console.log(table.toString());
+        // Display summary
+        console.log(chalk.gray('\n' + '─'.repeat(80)));
+        console.log(chalk.dim(`Total: ${chalk.cyan(checkpoints.length)} checkpoint${checkpoints.length === 1 ? '' : 's'}`));
+        if (options.task) {
+            console.log(chalk.dim(`Task: ${chalk.cyan(options.task)}`));
+        }
+        console.log(chalk.dim('\nNext steps:'));
+        console.log(chalk.dim(`  • View details: ${chalk.cyan('ginko checkpoint show <id>')}`));
+        console.log(chalk.dim(`  • Create new: ${chalk.cyan('ginko checkpoint create --task ' + (options.task || 'TASK-ID'))}`));
+        if (latestCheckpoint) {
+            console.log(chalk.dim(`  • Rollback to latest: ${chalk.cyan(`ginko rollback ${latestCheckpoint.id}`)} ${chalk.yellow('(future)')}`));
+        }
+        console.log();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(chalk.red(`\n✗ Error: ${error.message}`));
+        }
+        else {
+            console.error(chalk.red('\n✗ An unexpected error occurred'));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=list.js.map

package/dist/commands/checkpoint/list.js.map

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

package/dist/commands/checkpoint/show.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [checkpoint, show, cli, epic-004-sprint5, task-1]
+ * @related: [checkpoint.ts, create.ts, list.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [chalk, checkpoint]
+ */
+/**
+ * Show detailed checkpoint information
+ *
+ * Displays all checkpoint fields:
+ * - ID, task ID, agent ID
+ * - Timestamp
+ * - Git commit hash
+ * - Modified files list
+ * - Event stream position
+ * - Message and metadata
+ */
+export declare function showCheckpointCommand(checkpointId: string): Promise<void>;
+//# sourceMappingURL=show.d.ts.map

package/dist/commands/checkpoint/show.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"show.d.ts","sourceRoot":"","sources":["../../../src/commands/checkpoint/show.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAKH;;;;;;;;;;GAUG;AACH,wBAAsB,qBAAqB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF/E"}

package/dist/commands/checkpoint/show.js

@@ -0,0 +1,102 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [checkpoint, show, cli, epic-004-sprint5, task-1]
+ * @related: [checkpoint.ts, create.ts, list.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [chalk, checkpoint]
+ */
+import chalk from 'chalk';
+import { getCheckpoint } from '../../lib/checkpoint.js';
+/**
+ * Show detailed checkpoint information
+ *
+ * Displays all checkpoint fields:
+ * - ID, task ID, agent ID
+ * - Timestamp
+ * - Git commit hash
+ * - Modified files list
+ * - Event stream position
+ * - Message and metadata
+ */
+export async function showCheckpointCommand(checkpointId) {
+    try {
+        // Validate checkpoint ID
+        if (!checkpointId) {
+            console.log(chalk.red('\n✗ Checkpoint ID is required'));
+            console.log(chalk.dim('Usage: ginko checkpoint show <checkpointId>'));
+            process.exit(1);
+        }
+        // Get checkpoint
+        const checkpoint = await getCheckpoint(checkpointId);
+        if (!checkpoint) {
+            console.log(chalk.yellow(`\n⚠️  Checkpoint ${chalk.bold(checkpointId)} not found`));
+            console.log(chalk.dim('List checkpoints with: ginko checkpoint list'));
+            return;
+        }
+        // Display checkpoint details
+        console.log(chalk.green(`\n📸 Checkpoint Details`));
+        console.log(chalk.gray('═'.repeat(60)));
+        // Basic info
+        console.log(chalk.bold('\nIdentification:'));
+        console.log(`  ${chalk.dim('ID:')} ${chalk.cyan(checkpoint.id)}`);
+        console.log(`  ${chalk.dim('Task:')} ${chalk.cyan(checkpoint.taskId)}`);
+        console.log(`  ${chalk.dim('Agent:')} ${chalk.dim(checkpoint.agentId)}`);
+        console.log(`  ${chalk.dim('Created:')} ${chalk.dim(checkpoint.timestamp.toLocaleString())}`);
+        // Message
+        if (checkpoint.message) {
+            console.log(chalk.bold('\nMessage:'));
+            console.log(`  ${checkpoint.message}`);
+        }
+        // Git state
+        console.log(chalk.bold('\nGit State:'));
+        console.log(`  ${chalk.dim('Commit:')} ${chalk.cyan(checkpoint.gitCommit)}`);
+        console.log(`  ${chalk.dim('Short:')} ${chalk.cyan(checkpoint.gitCommit.substring(0, 7))}`);
+        // Modified files
+        console.log(chalk.bold('\nModified Files:'));
+        if (checkpoint.filesModified.length === 0) {
+            console.log(chalk.dim('  (no modified files)'));
+        }
+        else {
+            console.log(`  ${chalk.yellow(checkpoint.filesModified.length)} file${checkpoint.filesModified.length === 1 ? '' : 's'} modified:`);
+            checkpoint.filesModified.forEach((file, index) => {
+                // Show first 20 files, then truncate
+                if (index < 20) {
+                    console.log(`    ${chalk.dim(`${index + 1}.`)} ${file}`);
+                }
+                else if (index === 20) {
+                    console.log(chalk.dim(`    ... and ${checkpoint.filesModified.length - 20} more files`));
+                }
+            });
+        }
+        // Event stream position
+        console.log(chalk.bold('\nEvent Stream:'));
+        console.log(`  ${chalk.dim('Last event:')} ${chalk.dim(checkpoint.eventsSince)}`);
+        // Metadata
+        if (checkpoint.metadata && Object.keys(checkpoint.metadata).length > 0) {
+            console.log(chalk.bold('\nMetadata:'));
+            Object.entries(checkpoint.metadata).forEach(([key, value]) => {
+                console.log(`  ${chalk.dim(key + ':')} ${JSON.stringify(value)}`);
+            });
+        }
+        // Next steps
+        console.log(chalk.gray('\n' + '═'.repeat(60)));
+        console.log(chalk.dim('Next steps:'));
+        console.log(chalk.dim(`  • View commit: ${chalk.cyan(`git show ${checkpoint.gitCommit.substring(0, 7)}`)}`));
+        console.log(chalk.dim(`  • List task checkpoints: ${chalk.cyan(`ginko checkpoint list --task ${checkpoint.taskId}`)}`));
+        console.log(chalk.dim(`  • Rollback to this checkpoint: ${chalk.cyan(`ginko rollback ${checkpoint.id}`)} ${chalk.yellow('(future)')}`));
+        console.log();
+    }
+    catch (error) {
+        if (error instanceof Error) {
+            console.error(chalk.red(`\n✗ Error: ${error.message}`));
+        }
+        else {
+            console.error(chalk.red('\n✗ An unexpected error occurred'));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=show.js.map

package/dist/commands/checkpoint/show.js.map

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

package/dist/commands/dlq.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [dead-letter-queue, dlq, cli-command, epic-004]
+ * @related: [../lib/dead-letter-queue.ts, log.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [commander]
+ */
+import { Command } from 'commander';
+/**
+ * ginko dlq - Dead Letter Queue management
+ *
+ * Commands:
+ * - ginko dlq list [--status=pending]
+ * - ginko dlq show <id>
+ * - ginko dlq retry <id>
+ * - ginko dlq retry-all
+ * - ginko dlq stats
+ * - ginko dlq cleanup [--days=30]
+ */
+export declare const dlqCommand: Command;
+//# sourceMappingURL=dlq.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.d.ts","sourceRoot":"","sources":["../../src/commands/dlq.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAUpC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,UAAU,SAwKpB,CAAC"}

package/dist/commands/dlq.js

@@ -0,0 +1,172 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [dead-letter-queue, dlq, cli-command, epic-004]
+ * @related: [../lib/dead-letter-queue.ts, log.ts]
+ * @priority: high
+ * @complexity: low
+ * @dependencies: [commander]
+ */
+import { Command } from 'commander';
+import { getDeadLetterEntries, getDeadLetterEntry, retryDeadLetter, autoRetryDeadLetters, getDeadLetterStats, cleanupDeadLetters } from '../lib/dead-letter-queue.js';
+/**
+ * ginko dlq - Dead Letter Queue management
+ *
+ * Commands:
+ * - ginko dlq list [--status=pending]
+ * - ginko dlq show <id>
+ * - ginko dlq retry <id>
+ * - ginko dlq retry-all
+ * - ginko dlq stats
+ * - ginko dlq cleanup [--days=30]
+ */
+export const dlqCommand = new Command('dlq')
+    .description('Manage Dead Letter Queue (failed events)')
+    .addCommand(new Command('list')
+    .description('List DLQ entries')
+    .option('-s, --status <status>', 'Filter by status (pending|retrying|resolved|abandoned)')
+    .option('-l, --limit <number>', 'Limit number of results', '20')
+    .action(async (options) => {
+    try {
+        const status = options.status;
+        const limit = parseInt(options.limit, 10);
+        const entries = await getDeadLetterEntries(status);
+        const displayEntries = entries.slice(0, limit);
+        if (displayEntries.length === 0) {
+            console.log('No DLQ entries found.');
+            return;
+        }
+        console.log(`\nDead Letter Queue Entries (${displayEntries.length}/${entries.length}):\n`);
+        for (const entry of displayEntries) {
+            const age = Math.floor((Date.now() - entry.failedAt.getTime()) / 1000 / 60);
+            const ageStr = age < 60 ? `${age}m` : `${Math.floor(age / 60)}h`;
+            console.log(`  ${entry.id}`);
+            console.log(`    Status:   ${entry.status}`);
+            console.log(`    Event:    ${entry.originalEvent.id}`);
+            console.log(`    Failed:   ${ageStr} ago (${entry.retryCount} retries)`);
+            console.log(`    Reason:   ${entry.failureReason.split('\n')[0]}`);
+            console.log('');
+        }
+        if (entries.length > limit) {
+            console.log(`  ... and ${entries.length - limit} more entries`);
+        }
+    }
+    catch (error) {
+        console.error('Error listing DLQ entries:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}))
+    .addCommand(new Command('show')
+    .description('Show details of a specific DLQ entry')
+    .argument('<id>', 'DLQ entry ID')
+    .action(async (id) => {
+    try {
+        const entry = await getDeadLetterEntry(id);
+        if (!entry) {
+            console.error(`DLQ entry not found: ${id}`);
+            process.exit(1);
+        }
+        console.log(`\nDLQ Entry: ${entry.id}\n`);
+        console.log(`Status:        ${entry.status}`);
+        console.log(`Failed At:     ${entry.failedAt.toISOString()}`);
+        console.log(`Retry Count:   ${entry.retryCount}`);
+        if (entry.lastRetryAt) {
+            console.log(`Last Retry:    ${entry.lastRetryAt.toISOString()}`);
+        }
+        console.log(`\nFailure Reason:`);
+        console.log(entry.failureReason.split('\n').map(line => `  ${line}`).join('\n'));
+        console.log(`\nOriginal Event:`);
+        console.log(`  ID:          ${entry.originalEvent.id}`);
+        console.log(`  Category:    ${entry.originalEvent.category}`);
+        console.log(`  Description: ${entry.originalEvent.description}`);
+        console.log(`  Timestamp:   ${entry.originalEvent.timestamp}`);
+    }
+    catch (error) {
+        console.error('Error showing DLQ entry:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}))
+    .addCommand(new Command('retry')
+    .description('Retry a specific DLQ entry')
+    .argument('<id>', 'DLQ entry ID')
+    .action(async (id) => {
+    try {
+        console.log(`Retrying DLQ entry: ${id}...`);
+        const result = await retryDeadLetter(id);
+        if (result.success) {
+            console.log(`✓ Entry ${id} successfully retried and resolved`);
+        }
+        else {
+            console.error(`✗ Retry failed: ${result.error}`);
+            console.error(`  Status: ${result.entry.status}`);
+            process.exit(1);
+        }
+    }
+    catch (error) {
+        console.error('Error retrying DLQ entry:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}))
+    .addCommand(new Command('retry-all')
+    .description('Auto-retry all eligible pending entries')
+    .action(async () => {
+    try {
+        console.log('Auto-retrying eligible DLQ entries...');
+        const retriedCount = await autoRetryDeadLetters();
+        if (retriedCount === 0) {
+            console.log('No entries eligible for retry at this time.');
+        }
+        else {
+            console.log(`✓ Successfully retried ${retriedCount} entries`);
+        }
+    }
+    catch (error) {
+        console.error('Error auto-retrying DLQ entries:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}))
+    .addCommand(new Command('stats')
+    .description('Show DLQ statistics')
+    .action(async () => {
+    try {
+        const stats = await getDeadLetterStats();
+        console.log('\nDead Letter Queue Statistics:\n');
+        console.log(`  Total:     ${stats.total}`);
+        console.log(`  Pending:   ${stats.pending}`);
+        console.log(`  Retrying:  ${stats.retrying}`);
+        console.log(`  Resolved:  ${stats.resolved}`);
+        console.log(`  Abandoned: ${stats.abandoned}`);
+        if (stats.oldestPending) {
+            const age = Math.floor((Date.now() - stats.oldestPending.getTime()) / 1000 / 60);
+            const ageStr = age < 60 ? `${age} minutes` : `${Math.floor(age / 60)} hours`;
+            console.log(`\n  Oldest pending: ${ageStr} ago`);
+        }
+        console.log('');
+    }
+    catch (error) {
+        console.error('Error getting DLQ stats:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}))
+    .addCommand(new Command('cleanup')
+    .description('Clean up old resolved/abandoned entries')
+    .option('-d, --days <number>', 'Delete entries older than N days', '30')
+    .action(async (options) => {
+    try {
+        const days = parseInt(options.days, 10);
+        console.log(`Cleaning up DLQ entries older than ${days} days...`);
+        const deletedCount = await cleanupDeadLetters(days);
+        if (deletedCount === 0) {
+            console.log('No old entries to clean up.');
+        }
+        else {
+            console.log(`✓ Deleted ${deletedCount} old entries`);
+        }
+    }
+    catch (error) {
+        console.error('Error cleaning up DLQ:', error instanceof Error ? error.message : String(error));
+        process.exit(1);
+    }
+}));
+//# sourceMappingURL=dlq.js.map

package/dist/commands/dlq.js.map

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

package/dist/commands/escalation/create.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileType: command
+ * @status: current
+ * @updated: 2025-12-07
+ * @tags: [escalation, create, cli, epic-004, human-intervention]
+ * @related: [index.ts, escalation-client.ts]
+ * @priority: high
+ * @complexity: medium
+ * @dependencies: [commander, chalk, ora]
+ */
+interface CreateOptions {
+    task: string;
+    reason: string;
+    severity: 'low' | 'medium' | 'high' | 'critical';
+    agent?: string;
+}
+/**
+ * Create a new escalation
+ */
+export declare function createEscalationCommand(options: CreateOptions): Promise<void>;
+export {};
+//# sourceMappingURL=create.d.ts.map

package/dist/commands/escalation/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/escalation/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAeH,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IACjD,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA4BD;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFnF"}