@nathanvale/chatline 0.0.1

package/dist/cli/index.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * iMessage Timeline CLI
+ *
+ * Main CLI entry point that registers all commands and handles execution.
+ * This is the modular replacement for the monolithic cli.ts file.
+ */
+import { readFileSync } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Command } from 'commander';
+import { humanError, setHumanLoggingEnabled } from '#utils/human';
+import { createLogger } from '#utils/logger';
+import { registerCleanCommand, registerDoctorCommand, registerEnrichAICommand, registerIngestCSVCommand, registerIngestDBCommand, registerInitCommand, registerNormalizeLinkCommand, registerRenderMarkdownCommand, registerStatsCommand, registerValidateCommand, } from './commands/index.js';
+// Get package.json for version
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+// Path is relative to the bundled output location (dist/bin/index.js)
+const packageJsonPath = resolve(__dirname, '../../package.json');
+const packageJson = JSON.parse(readFileSync(packageJsonPath, 'utf-8'));
+// Create CLI logger
+const cliLogger = createLogger('cli');
+/**
+ * Creates and configures the main CLI program with all commands.
+ */
+export function createProgram() {
+    const program = new Command();
+    program
+        .name('imessage-timeline')
+        .description('Extract, transform, and analyze iMessage conversations with AI-powered enrichment and timeline rendering')
+        .version(packageJson.version);
+    // Global options
+    program
+        .option('-v, --verbose', 'enable verbose logging', false)
+        .option('-q, --quiet', 'suppress non-error output', false)
+        .option('-c, --config <path>', 'path to config file', 'imessage-config.json')
+        .option('--json', 'emit structured JSON log events only (machine-readable)', false);
+    // Toggle human logging before each command action
+    program.hook('preAction', () => {
+        const opts = program.opts();
+        const envJson = String(process.env.IMESSAGE_JSON || '').toLowerCase();
+        const envJsonOnly = ['1', 'true', 'yes', 'y', 'json', 'json-only'].includes(envJson);
+        const jsonOnly = Boolean(opts.json) || envJsonOnly;
+        setHumanLoggingEnabled(!jsonOnly);
+    });
+    // Custom error handling
+    program.configureOutput({
+        outputError: (str, write) => {
+            const errorMsg = str
+                .replace(/^error: /, '❌ Error: ')
+                .replace(/^Error: /, '❌ Error: ');
+            write(errorMsg);
+            cliLogger.error('Commander output error', { raw: str });
+        },
+    });
+    // Custom error handler for better error messages
+    program.exitOverride((err) => {
+        if (err.code === 'commander.help' ||
+            err.code === 'commander.helpDisplayed') {
+            process.exit(0);
+        }
+        if (err.code === 'commander.version') {
+            process.exit(0);
+        }
+        if (err.code === 'commander.missingArgument') {
+            humanError(`❌ Error: ${err.message}`);
+            humanError(`\nRun 'imessage-timeline ${program.args[0] || ''} --help' for usage information`);
+            process.exit(1);
+        }
+        if (err.code === 'commander.unknownCommand') {
+            humanError(`❌ Error: ${err.message}`);
+            humanError(`\nRun 'imessage-timeline --help' to see available commands`);
+            process.exit(1);
+        }
+        humanError(`❌ Error: ${err.message}`);
+        cliLogger.error('CLI exit override error', {
+            code: err.code,
+            message: err.message,
+        });
+        process.exit(err.exitCode || 1);
+    });
+    // Function to get global options - passed to each command registration
+    const getGlobalOptions = () => program.opts();
+    // Register all commands with the shared global options getter
+    registerIngestCSVCommand(program, getGlobalOptions);
+    registerIngestDBCommand(program, getGlobalOptions);
+    registerNormalizeLinkCommand(program, getGlobalOptions);
+    registerEnrichAICommand(program, getGlobalOptions);
+    registerRenderMarkdownCommand(program, getGlobalOptions);
+    registerValidateCommand(program, getGlobalOptions);
+    registerStatsCommand(program, getGlobalOptions);
+    registerCleanCommand(program, getGlobalOptions);
+    registerDoctorCommand(program, getGlobalOptions);
+    registerInitCommand(program, getGlobalOptions);
+    return program;
+}
+/**
+ * Main CLI entry point.
+ */
+async function main() {
+    const program = createProgram();
+    try {
+        await program.parseAsync(process.argv);
+    }
+    catch (error) {
+        // Commander handles most errors, but catch any uncaught ones
+        if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+            process.exitCode = 1;
+        }
+        else {
+            throw error;
+        }
+    }
+}
+// Run CLI if this is the main module
+main().catch((error) => {
+    console.error('Unexpected error:', error);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/cli/types.d.ts

@@ -0,0 +1,93 @@
+/**
+ * CLI Option Types
+ *
+ * Shared type definitions for all CLI command options.
+ */
+export type RenderMarkdownOptions = {
+    input: string;
+    output?: string;
+    startDate?: string;
+    endDate?: string;
+    groupByTime?: boolean;
+    nestedReplies?: boolean;
+    maxNestingDepth?: string;
+};
+export type ValidateOptions = {
+    input: string;
+    quiet?: boolean;
+};
+export type StatsOptions = {
+    input: string;
+    verbose?: boolean;
+};
+export type CleanOptions = {
+    checkpointDir: string;
+    force?: boolean;
+    all?: boolean;
+};
+export type DoctorOptions = {
+    verbose?: boolean;
+};
+export type InitOptions = {
+    format: 'json' | 'yaml';
+    force: boolean;
+    output?: string;
+};
+export type IngestCSVOptions = {
+    input: string;
+    output: string;
+    attachments?: Array<string>;
+};
+export type IngestDBOptions = {
+    input: string;
+    output: string;
+    attachments?: Array<string>;
+    contact?: string;
+};
+export type NormalizeLinkOptions = {
+    input: Array<string> | string;
+    output: string;
+};
+export type EnrichAIOptions = {
+    input: string;
+    output: string;
+    checkpointDir: string;
+    resume?: boolean;
+    incremental?: boolean;
+    stateFile?: string;
+    resetState?: boolean;
+    forceRefresh?: boolean;
+    rateLimitMs?: string;
+    maxRetries?: string;
+    checkpointInterval?: string;
+    enableVision?: boolean;
+    enableAudio?: boolean;
+    enableLinks?: boolean;
+};
+/**
+ * CLI Log Event Metadata
+ */
+export type CLILogMeta = {
+    command: string;
+    phase: 'start' | 'progress' | 'summary' | 'warning' | 'error';
+    message?: string;
+    options?: Record<string, unknown>;
+    metrics?: Record<string, unknown>;
+    error?: {
+        type?: string;
+        message: string;
+        stack?: string;
+    };
+    context?: Record<string, unknown>;
+    exitCode?: number;
+};
+/**
+ * Global CLI options from Commander program
+ */
+export type GlobalOptions = {
+    verbose: boolean;
+    quiet: boolean;
+    config: string;
+    json?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/cli/types.d.ts.map

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

package/dist/cli/types.js

@@ -0,0 +1,7 @@
+/**
+ * CLI Option Types
+ *
+ * Shared type definitions for all CLI command options.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/cli/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/cli/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/cli/utils.d.ts

@@ -0,0 +1,29 @@
+/**
+ * CLI Utility Functions
+ *
+ * Shared utilities for CLI command handling including logging,
+ * error handling, and common operations.
+ */
+import type { CLILogMeta } from './types.js';
+/**
+ * CLI Logger instance
+ */
+export declare const cliLogger: import("#utils/logger").ComponentLogger;
+/**
+ * Apply log level based on verbose/quiet flags
+ */
+export declare function applyLogLevel(verbose: boolean, quiet: boolean): void;
+/**
+ * Emit structured CLI events for logging
+ */
+export declare function logEvent(event: string, meta: CLILogMeta): void;
+/**
+ * Format an error for CLI logging
+ */
+export declare function formatErrorMeta(error: unknown): CLILogMeta['error'];
+/**
+ * Standard command error handler
+ * Logs error and exits with specified code
+ */
+export declare function handleCommandError(commandName: string, error: unknown, verbose: boolean): never;
+//# sourceMappingURL=utils.d.ts.map

package/dist/cli/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE5C;;GAEG;AACH,eAAO,MAAM,SAAS,yCAAsB,CAAA;AAE5C;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAGpE;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI,CAE9D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAMnE;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CACjC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,OAAO,EACd,OAAO,EAAE,OAAO,GACd,KAAK,CAoBP"}

package/dist/cli/utils.js

@@ -0,0 +1,53 @@
+/**
+ * CLI Utility Functions
+ *
+ * Shared utilities for CLI command handling including logging,
+ * error handling, and common operations.
+ */
+import { createLogger, setLogLevel } from '#utils/logger';
+/**
+ * CLI Logger instance
+ */
+export const cliLogger = createLogger('cli');
+/**
+ * Apply log level based on verbose/quiet flags
+ */
+export function applyLogLevel(verbose, quiet) {
+    const level = quiet ? 'error' : verbose ? 'debug' : 'info';
+    setLogLevel(level);
+}
+/**
+ * Emit structured CLI events for logging
+ */
+export function logEvent(event, meta) {
+    cliLogger.info(event, meta);
+}
+/**
+ * Format an error for CLI logging
+ */
+export function formatErrorMeta(error) {
+    return {
+        type: error instanceof Error ? error.name : 'Unknown',
+        message: error instanceof Error ? error.message : String(error),
+        ...(error instanceof Error && error.stack ? { stack: error.stack } : {}),
+    };
+}
+/**
+ * Standard command error handler
+ * Logs error and exits with specified code
+ */
+export function handleCommandError(commandName, error, verbose) {
+    const { humanError } = require('#utils/human');
+    humanError(`❌ Failed to ${commandName}:`, error instanceof Error ? error.message : String(error));
+    if (verbose && error instanceof Error) {
+        humanError(error.stack);
+    }
+    logEvent(`${commandName}-error`, {
+        command: commandName,
+        phase: 'error',
+        error: formatErrorMeta(error),
+        exitCode: 2,
+    });
+    process.exit(2);
+}
+//# sourceMappingURL=utils.js.map

package/dist/cli/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGzD;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC,KAAK,CAAC,CAAA;AAE5C;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,KAAc;IAC7D,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAA;IAC1D,WAAW,CAAC,KAAK,CAAC,CAAA;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,KAAa,EAAE,IAAgB;IACvD,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,CAAA;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,KAAc;IAC7C,OAAO;QACN,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS;QACrD,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;QAC/D,GAAG,CAAC,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAA;AACF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CACjC,WAAmB,EACnB,KAAc,EACd,OAAgB;IAEhB,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,cAAc,CAAC,CAAA;IAE9C,UAAU,CACT,eAAe,WAAW,GAAG,EAC7B,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CACtD,CAAA;IAED,IAAI,OAAO,IAAI,KAAK,YAAY,KAAK,EAAE,CAAC;QACvC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAA;IACxB,CAAC;IAED,QAAQ,CAAC,GAAG,WAAW,QAAQ,EAAE;QAChC,OAAO,EAAE,WAAW;QACpB,KAAK,EAAE,OAAO;QACd,KAAK,EAAE,eAAe,CAAC,KAAK,CAAC;QAC7B,QAAQ,EAAE,CAAC;KACX,CAAC,CAAA;IAEF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AAChB,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * iMessage Timeline CLI
+ *
+ * Main entry point for the CLI using commander.js.
+ * Implements CLI--T01: Setup Commander.js Structure
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAEA;;;;;GAKG"}