@nathanvale/chatline 0.0.1

package/dist/cli/commands/clean.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Clean Command
+ *
+ * Remove temporary files and checkpoints.
+ * CLI-T05-AC03: clean command to remove checkpoints and temp files
+ */
+import type { Command } from 'commander';
+import type { CleanOptions, GlobalOptions } from '../types.js';
+/**
+ * Execute the clean command logic
+ */
+export declare function executeClean(options: CleanOptions, globalOptions: GlobalOptions): Promise<void>;
+/**
+ * Register the clean command with Commander
+ */
+export declare function registerCleanCommand(program: Command, getGlobalOptions: () => GlobalOptions): void;
+//# sourceMappingURL=clean.d.ts.map

package/dist/cli/commands/clean.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"clean.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/clean.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG9D;;GAEG;AACH,wBAAsB,YAAY,CACjC,OAAO,EAAE,YAAY,EACrB,aAAa,EAAE,aAAa,GAC1B,OAAO,CAAC,IAAI,CAAC,CAwGf;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CACnC,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,MAAM,aAAa,GACnC,IAAI,CAuCN"}

package/dist/cli/commands/clean.js

@@ -0,0 +1,142 @@
+/**
+ * Clean Command
+ *
+ * Remove temporary files and checkpoints.
+ * CLI-T05-AC03: clean command to remove checkpoints and temp files
+ */
+import { humanError, humanInfo, humanWarn } from '#utils/human';
+import { applyLogLevel, logEvent } from '../utils.js';
+/**
+ * Execute the clean command logic
+ */
+export async function executeClean(options, globalOptions) {
+    const { checkpointDir, force, all } = options;
+    const { verbose, quiet } = globalOptions;
+    applyLogLevel(verbose, quiet);
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    // Check if checkpoint dir exists
+    if (!fs.existsSync(checkpointDir)) {
+        if (verbose) {
+            humanInfo(`ℹ️  Checkpoint directory not found: ${checkpointDir}`);
+        }
+        logEvent('clean-missing-dir', {
+            command: 'clean',
+            phase: 'progress',
+            options: { checkpointDir },
+        });
+        process.exit(0);
+    }
+    if (!fs.statSync(checkpointDir).isDirectory()) {
+        humanError(`❌ Not a directory: ${checkpointDir}`);
+        process.exit(1);
+    }
+    // List files to be removed
+    const files = fs.readdirSync(checkpointDir);
+    const toRemove = files.filter((f) => f.startsWith('enrich-checkpoint-') ||
+        (all && (f.endsWith('.backup') || f.endsWith('.old'))));
+    if (toRemove.length === 0) {
+        humanInfo('ℹ️  No checkpoint files to clean');
+        logEvent('clean-none', {
+            command: 'clean',
+            phase: 'summary',
+            metrics: { removed: 0 },
+            options: { checkpointDir },
+            exitCode: 0,
+        });
+        process.exit(0);
+    }
+    // Show what will be removed
+    humanInfo('♻️  Files to be removed:');
+    toRemove.forEach((f) => {
+        const filepath = path.join(checkpointDir, f);
+        const size = fs.statSync(filepath).size;
+        humanInfo(`    ${f} (${(size / 1024).toFixed(1)} KB)`);
+    });
+    logEvent('clean-list', {
+        command: 'clean',
+        phase: 'progress',
+        metrics: { count: toRemove.length },
+        options: { checkpointDir, all },
+    });
+    if (!force) {
+        humanInfo('\nRun with --force to remove these files');
+        logEvent('clean-requires-force', {
+            command: 'clean',
+            phase: 'progress',
+            options: { checkpointDir, all },
+        });
+        process.exit(0);
+    }
+    // Remove files
+    let removed = 0;
+    toRemove.forEach((f) => {
+        const filepath = path.join(checkpointDir, f);
+        try {
+            fs.unlinkSync(filepath);
+            removed++;
+            if (verbose) {
+                humanInfo(`✓ Removed ${f}`);
+                logEvent('clean-file-removed', {
+                    command: 'clean',
+                    phase: 'progress',
+                    context: { file: f },
+                });
+            }
+        }
+        catch {
+            humanWarn(`⚠️  Failed to remove ${f}`);
+            logEvent('clean-file-remove-failed', {
+                command: 'clean',
+                phase: 'warning',
+                context: { file: f },
+            });
+        }
+    });
+    humanInfo(`✅ Cleaned ${removed} checkpoint file(s)`);
+    logEvent('clean-summary', {
+        command: 'clean',
+        phase: 'summary',
+        metrics: { removed },
+        options: { checkpointDir, all },
+        exitCode: 0,
+    });
+}
+/**
+ * Register the clean command with Commander
+ */
+export function registerCleanCommand(program, getGlobalOptions) {
+    program
+        .command('clean')
+        .description('Remove temporary files and checkpoints')
+        .option('-c, --checkpoint-dir <path>', 'checkpoint directory to clean', './.checkpoints')
+        .option('-f, --force', 'remove without confirmation', false)
+        .option('--all', 'also remove backup files (.backup, .old)', false)
+        .action(async (options) => {
+        try {
+            await executeClean(options, getGlobalOptions());
+            process.exit(0);
+        }
+        catch (error) {
+            humanError('❌ Clean failed:', error instanceof Error ? error.message : String(error));
+            if (getGlobalOptions().verbose && error instanceof Error) {
+                humanError(error.stack);
+            }
+            logEvent('clean-error', {
+                command: 'clean',
+                phase: 'error',
+                error: {
+                    type: error instanceof Error ? error.name : 'Unknown',
+                    message: error instanceof Error ? error.message : String(error),
+                    ...(error instanceof Error && error.stack
+                        ? { stack: error.stack }
+                        : {}),
+                },
+                options: { checkpointDir: options.checkpointDir, all: options.all },
+                exitCode: 2,
+            });
+            process.exit(2);
+        }
+    });
+}
+//# sourceMappingURL=clean.js.map

package/dist/cli/commands/clean.js.map

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

package/dist/cli/commands/doctor.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Doctor Command
+ *
+ * Diagnose common configuration issues.
+ * CLI-T05-AC04: doctor command to diagnose common issues
+ */
+import type { Command } from 'commander';
+import type { DoctorOptions, GlobalOptions } from '../types.js';
+/**
+ * Execute the doctor command logic
+ */
+export declare function executeDoctor(options: DoctorOptions, globalOptions: GlobalOptions): Promise<void>;
+/**
+ * Register the doctor command with Commander
+ */
+export declare function registerDoctorCommand(program: Command, getGlobalOptions: () => GlobalOptions): void;
+//# sourceMappingURL=doctor.d.ts.map

package/dist/cli/commands/doctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/doctor.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAG/D;;GAEG;AACH,wBAAsB,aAAa,CAClC,OAAO,EAAE,aAAa,EACtB,aAAa,EAAE,aAAa,GAC1B,OAAO,CAAC,IAAI,CAAC,CAoLf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACpC,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,MAAM,aAAa,GACnC,IAAI,CA+BN"}

package/dist/cli/commands/doctor.js

@@ -0,0 +1,202 @@
+/**
+ * Doctor Command
+ *
+ * Diagnose common configuration issues.
+ * CLI-T05-AC04: doctor command to diagnose common issues
+ */
+import { humanError, humanInfo } from '#utils/human';
+import { applyLogLevel, logEvent } from '../utils.js';
+/**
+ * Execute the doctor command logic
+ */
+export async function executeDoctor(options, globalOptions) {
+    const verbose = globalOptions.verbose || options.verbose || false;
+    applyLogLevel(verbose, globalOptions.quiet);
+    const fs = await import('node:fs');
+    const path = await import('node:path');
+    const os = await import('node:os');
+    humanInfo('🔍 iMessage Timeline Diagnostics\n');
+    logEvent('doctor-start', { command: 'doctor', phase: 'start' });
+    const checks = [];
+    // Check 1: Node version
+    const nodeVersion = process.version;
+    const nodeMajor = Number.parseInt(nodeVersion.slice(1).split('.')[0] ?? '0', 10);
+    const nodeOk = nodeMajor >= 18;
+    checks.push({
+        name: 'Node.js version',
+        pass: nodeOk,
+        message: `${nodeVersion} ${nodeOk ? '✓' : '(requires ≥18)'}`,
+    });
+    // Check 2: Current directory
+    const cwd = process.cwd();
+    const packageJsonExists = fs.existsSync(path.join(cwd, 'package.json'));
+    checks.push({
+        name: 'package.json',
+        pass: packageJsonExists,
+        message: packageJsonExists
+            ? `Found in ${cwd}`
+            : 'Not found in current directory',
+    });
+    // Check 3: Config file
+    const configFormats = [
+        'imessage-config.yaml',
+        'imessage-config.yml',
+        'imessage-config.json',
+    ];
+    const foundConfig = configFormats.find((f) => fs.existsSync(path.join(cwd, f)));
+    checks.push({
+        name: 'Config file',
+        pass: Boolean(foundConfig),
+        message: foundConfig
+            ? `Found: ${foundConfig}`
+            : 'Not found (run: imessage-timeline init)',
+    });
+    // Check 4: API Keys
+    const geminiKey = process.env.GEMINI_API_KEY;
+    const firecrawlKey = process.env.FIRECRAWL_API_KEY;
+    checks.push({
+        name: 'GEMINI_API_KEY',
+        pass: Boolean(geminiKey),
+        message: geminiKey
+            ? 'Set'
+            : 'Not set (required for image/audio enrichment)',
+    });
+    checks.push({
+        name: 'FIRECRAWL_API_KEY',
+        pass: Boolean(firecrawlKey),
+        message: firecrawlKey
+            ? 'Set'
+            : 'Not set (optional, improves link enrichment - get from firecrawl.dev)',
+    });
+    // Check 5: Default attachment directory
+    const defaultAttachDir = path.join(os.homedir(), 'Library', 'Messages', 'Attachments');
+    const attachDirExists = fs.existsSync(defaultAttachDir);
+    checks.push({
+        name: 'Messages attachments',
+        pass: attachDirExists,
+        message: attachDirExists
+            ? `Found: ${defaultAttachDir}`
+            : `Not found: ${defaultAttachDir}`,
+    });
+    // Check 6: Output directory permission
+    const canWrite = (() => {
+        try {
+            const testFile = path.join(cwd, '.test-write');
+            fs.writeFileSync(testFile, 'test');
+            fs.unlinkSync(testFile);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    })();
+    checks.push({
+        name: 'Write permission',
+        pass: canWrite,
+        message: canWrite
+            ? `Can write to ${cwd}`
+            : `Cannot write to ${cwd} (check permissions)`,
+    });
+    // Print results
+    let passCount = 0;
+    checks.forEach((check) => {
+        const icon = check.pass ? '✅' : '⚠️ ';
+        humanInfo(`${icon} ${check.name.padEnd(25)} ${check.message}`);
+        if (check.pass)
+            passCount++;
+        logEvent('doctor-check', {
+            command: 'doctor',
+            phase: 'progress',
+            context: { name: check.name },
+            metrics: { pass: check.pass },
+            message: check.message,
+        });
+    });
+    humanInfo(`\n📊 Summary: ${passCount}/${checks.length} checks passed`);
+    logEvent('doctor-summary', {
+        command: 'doctor',
+        phase: 'summary',
+        metrics: { passed: passCount, total: checks.length },
+    });
+    // Recommendations
+    const failures = checks.filter((c) => !c.pass);
+    if (failures.length > 0) {
+        humanInfo('\n💡 Recommendations:');
+        failures.forEach((check) => {
+            if (check.name === 'Config file') {
+                humanInfo('   • Run: imessage-timeline init');
+            }
+            else if (check.name === 'GEMINI_API_KEY') {
+                humanInfo('   • Get API key from: https://ai.google.dev/tutorials/setup');
+                humanInfo('   • Set: export GEMINI_API_KEY=your_key');
+            }
+            else if (check.name === 'FIRECRAWL_API_KEY') {
+                humanInfo('   • (Optional) Get from: https://www.firecrawl.dev');
+            }
+            logEvent('doctor-recommendation', {
+                command: 'doctor',
+                phase: 'progress',
+                context: { name: check.name },
+                message: check.message,
+            });
+        });
+    }
+    if (verbose) {
+        humanInfo('\n📝 Environment:');
+        humanInfo(`   Platform: ${os.platform()}`);
+        humanInfo(`   Arch: ${os.arch()}`);
+        humanInfo(`   Home: ${os.homedir()}`);
+        humanInfo(`   CWD: ${cwd}`);
+        logEvent('doctor-environment', {
+            command: 'doctor',
+            phase: 'progress',
+            context: {
+                platform: os.platform(),
+                arch: os.arch(),
+                home: os.homedir(),
+                cwd,
+            },
+        });
+    }
+    logEvent('doctor-exit', {
+        command: 'doctor',
+        phase: 'summary',
+        metrics: { failures: failures.length },
+        exitCode: failures.length > 0 ? 1 : 0,
+    });
+    process.exit(failures.length > 0 ? 1 : 0);
+}
+/**
+ * Register the doctor command with Commander
+ */
+export function registerDoctorCommand(program, getGlobalOptions) {
+    program
+        .command('doctor')
+        .description('Diagnose common configuration issues')
+        .option('-v, --verbose', 'show detailed diagnostics', false)
+        .action(async (options) => {
+        try {
+            await executeDoctor(options, getGlobalOptions());
+        }
+        catch (error) {
+            humanError('❌ Doctor failed:', error instanceof Error ? error.message : String(error));
+            if (getGlobalOptions().verbose && error instanceof Error) {
+                humanError(error.stack);
+            }
+            logEvent('doctor-error', {
+                command: 'doctor',
+                phase: 'error',
+                error: {
+                    type: error instanceof Error ? error.name : 'Unknown',
+                    message: error instanceof Error ? error.message : String(error),
+                    ...(error instanceof Error && error.stack
+                        ? { stack: error.stack }
+                        : {}),
+                },
+                exitCode: 2,
+            });
+            process.exit(2);
+        }
+    });
+}
+//# sourceMappingURL=doctor.js.map

package/dist/cli/commands/doctor.js.map

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

package/dist/cli/commands/enrich-ai.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Enrich AI Command
+ *
+ * Add AI-powered enrichment to media messages.
+ * CLI-T03-AC02, AC03, AC04, AC05: Enrich with checkpoints, incremental, rate limiting
+ */
+import type { Command } from 'commander';
+import type { EnrichAIOptions, GlobalOptions } from '../types.js';
+/**
+ * Execute the enrich-ai command logic
+ */
+export declare function executeEnrichAI(options: EnrichAIOptions, globalOptions: GlobalOptions): Promise<void>;
+/**
+ * Register the enrich-ai command with Commander
+ */
+export declare function registerEnrichAICommand(program: Command, getGlobalOptions: () => GlobalOptions): void;
+//# sourceMappingURL=enrich-ai.d.ts.map

package/dist/cli/commands/enrich-ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enrich-ai.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/enrich-ai.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAGxC,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAA;AAGjE;;GAEG;AACH,wBAAsB,eAAe,CACpC,OAAO,EAAE,eAAe,EACxB,aAAa,EAAE,aAAa,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Yf;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACtC,OAAO,EAAE,OAAO,EAChB,gBAAgB,EAAE,MAAM,aAAa,GACnC,IAAI,CAgFN"}