claude-code-history 0.2.2

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

@@ -0,0 +1,62 @@
+/**
+ * CLI Configuration utilities
+ *
+ * Handles global options, environment variables, and configuration resolution.
+ */
+import { LibraryConfig } from '../../lib/index.js';
+/**
+ * Environment variable names used by the CLI
+ */
+export declare const ENV_VARS: {
+    readonly DATA_PATH: "CCH_DATA_PATH";
+    readonly NO_COLOR: "NO_COLOR";
+    readonly PAGER: "PAGER";
+};
+/**
+ * Global CLI options available to all commands
+ */
+export interface GlobalOptions {
+    /** Custom Claude Code data directory */
+    dataPath?: string;
+    /** Output in JSON format instead of human-readable */
+    json: boolean;
+    /** Bypass pagination, output full content */
+    full: boolean;
+}
+/**
+ * Resolved configuration combining global options, env vars, and defaults
+ */
+export interface ResolvedCliConfig {
+    dataPath: string;
+    outputFormat: 'human' | 'json';
+    paginate: boolean;
+}
+/**
+ * Resolve CLI configuration from global options, environment variables, and defaults.
+ *
+ * Priority order (highest to lowest):
+ * 1. Command-line option (--data-path)
+ * 2. Environment variable (CCH_DATA_PATH)
+ * 3. Platform default (~/.claude/projects/)
+ *
+ * @param opts - Global options from command line
+ * @returns Resolved configuration
+ */
+export declare function resolveConfig(opts: GlobalOptions): ResolvedCliConfig;
+/**
+ * Convert resolved CLI config to LibraryConfig for lib layer calls
+ *
+ * @param config - Resolved CLI configuration
+ * @param overrides - Optional overrides for specific lib calls
+ * @returns LibraryConfig compatible with lib layer functions
+ */
+export declare function toLibraryConfig(config: ResolvedCliConfig, overrides?: Partial<LibraryConfig>): LibraryConfig;
+/**
+ * Parse session reference from user input.
+ * Accepts: numeric index (0, 1, 2...) or UUID string (partial or full)
+ *
+ * @param input - User-provided session identifier
+ * @returns Numeric index if valid number >= 0, otherwise the string (treated as UUID)
+ */
+export declare function parseSessionRef(input: string): number | string;
+//# sourceMappingURL=config.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAsB,MAAM,oBAAoB,CAAC;AAEvE;;GAEG;AACH,eAAO,MAAM,QAAQ;;;;CAIX,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,sDAAsD;IACtD,IAAI,EAAE,OAAO,CAAC;IACd,6CAA6C;IAC7C,IAAI,EAAE,OAAO,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,OAAO,GAAG,MAAM,CAAC;IAC/B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,iBAAiB,CASpE;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAC7B,MAAM,EAAE,iBAAiB,EACzB,SAAS,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,GACjC,aAAa,CAKf;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAY9D"}

package/dist/cli/utils/config.js

@@ -0,0 +1,65 @@
+/**
+ * CLI Configuration utilities
+ *
+ * Handles global options, environment variables, and configuration resolution.
+ */
+import { getDefaultDataPath } from '../../lib/index.js';
+/**
+ * Environment variable names used by the CLI
+ */
+export const ENV_VARS = {
+    DATA_PATH: 'CCH_DATA_PATH',
+    NO_COLOR: 'NO_COLOR',
+    PAGER: 'PAGER',
+};
+/**
+ * Resolve CLI configuration from global options, environment variables, and defaults.
+ *
+ * Priority order (highest to lowest):
+ * 1. Command-line option (--data-path)
+ * 2. Environment variable (CCH_DATA_PATH)
+ * 3. Platform default (~/.claude/projects/)
+ *
+ * @param opts - Global options from command line
+ * @returns Resolved configuration
+ */
+export function resolveConfig(opts) {
+    const dataPath = opts.dataPath ?? process.env[ENV_VARS.DATA_PATH] ?? getDefaultDataPath();
+    return {
+        dataPath,
+        outputFormat: opts.json ? 'json' : 'human',
+        paginate: !opts.full,
+    };
+}
+/**
+ * Convert resolved CLI config to LibraryConfig for lib layer calls
+ *
+ * @param config - Resolved CLI configuration
+ * @param overrides - Optional overrides for specific lib calls
+ * @returns LibraryConfig compatible with lib layer functions
+ */
+export function toLibraryConfig(config, overrides) {
+    return {
+        dataPath: config.dataPath,
+        ...overrides,
+    };
+}
+/**
+ * Parse session reference from user input.
+ * Accepts: numeric index (0, 1, 2...) or UUID string (partial or full)
+ *
+ * @param input - User-provided session identifier
+ * @returns Numeric index if valid number >= 0, otherwise the string (treated as UUID)
+ */
+export function parseSessionRef(input) {
+    const trimmed = input.trim();
+    const numericIndex = parseInt(trimmed, 10);
+    // Only treat as numeric if it's a valid non-negative integer
+    // and the entire string is numeric (not "123abc")
+    if (!isNaN(numericIndex) && numericIndex >= 0 && /^\d+$/.test(trimmed)) {
+        return numericIndex;
+    }
+    // Treat as UUID (lib layer will validate)
+    return trimmed;
+}
+//# sourceMappingURL=config.js.map

package/dist/cli/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../../src/cli/utils/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAiB,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAEvE;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,SAAS,EAAE,eAAe;IAC1B,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;CACN,CAAC;AAuBX;;;;;;;;;;GAUG;AACH,MAAM,UAAU,aAAa,CAAC,IAAmB;IAC/C,MAAM,QAAQ,GACZ,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,kBAAkB,EAAE,CAAC;IAE3E,OAAO;QACL,QAAQ;QACR,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO;QAC1C,QAAQ,EAAE,CAAC,IAAI,CAAC,IAAI;KACrB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAyB,EACzB,SAAkC;IAElC,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,GAAG,SAAS;KACb,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC3C,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAE3C,6DAA6D;IAC7D,kDAAkD;IAClD,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,OAAO,YAAY,CAAC;IACtB,CAAC;IAED,0CAA0C;IAC1C,OAAO,OAAO,CAAC;AACjB,CAAC"}

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

@@ -0,0 +1,86 @@
+/**
+ * CLI Error handling utilities
+ *
+ * Provides exit codes, error formatting, and error type guards.
+ */
+/**
+ * CLI exit codes following Unix conventions
+ */
+export declare enum ExitCode {
+    /** Command completed successfully */
+    SUCCESS = 0,
+    /** General/unexpected error */
+    GENERAL_ERROR = 1,
+    /** Invalid arguments or usage error */
+    USAGE_ERROR = 2,
+    /** Requested resource not found (session, workspace) */
+    NOT_FOUND = 3,
+    /** I/O error (file system, permissions) */
+    IO_ERROR = 4
+}
+/**
+ * Error codes for structured error responses
+ */
+export type ErrorCode = 'USAGE_ERROR' | 'NOT_FOUND' | 'IO_ERROR' | 'INTERNAL_ERROR';
+/**
+ * Structured command error for JSON output
+ */
+export interface CommandError {
+    code: ErrorCode;
+    message: string;
+    details?: string;
+}
+/**
+ * CLI-specific error class with exit code
+ */
+export declare class CliError extends Error {
+    readonly exitCode: ExitCode;
+    readonly errorCode: ErrorCode;
+    readonly details?: string | undefined;
+    constructor(message: string, exitCode: ExitCode, errorCode: ErrorCode, details?: string | undefined);
+    /**
+     * Convert to CommandError for JSON output
+     */
+    toCommandError(): CommandError;
+}
+/**
+ * Create a usage error (invalid arguments)
+ */
+export declare function usageError(message: string, details?: string): CliError;
+/**
+ * Create a not found error (session, workspace not found)
+ */
+export declare function notFoundError(message: string, details?: string): CliError;
+/**
+ * Create an I/O error (file system issues)
+ */
+export declare function ioError(message: string, details?: string): CliError;
+/**
+ * Create an internal error (unexpected issues)
+ */
+export declare function internalError(message: string, details?: string): CliError;
+/**
+ * Type guard for CliError
+ */
+export declare function isCliError(error: unknown): error is CliError;
+/**
+ * Format error for human-readable output
+ */
+export declare function formatErrorHuman(error: CliError): string;
+/**
+ * Get exit code from an error, defaulting to GENERAL_ERROR for unknown errors
+ */
+export declare function getExitCode(error: unknown): ExitCode;
+/**
+ * Convert any error to a CliError
+ */
+export declare function toCliError(error: unknown): CliError;
+/**
+ * Handle command error with appropriate output format
+ *
+ * @param error - The error that occurred
+ * @param json - Whether to output as JSON
+ * @returns Exit code for the error
+ */
+export declare function handleError(error: unknown, json: boolean): ExitCode;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,oBAAY,QAAQ;IAClB,qCAAqC;IACrC,OAAO,IAAI;IACX,+BAA+B;IAC/B,aAAa,IAAI;IACjB,uCAAuC;IACvC,WAAW,IAAI;IACf,wDAAwD;IACxD,SAAS,IAAI;IACb,2CAA2C;IAC3C,QAAQ,IAAI;CACb;AAED;;GAEG;AACH,MAAM,MAAM,SAAS,GACjB,aAAa,GACb,WAAW,GACX,UAAU,GACV,gBAAgB,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,QAAS,SAAQ,KAAK;aAGf,QAAQ,EAAE,QAAQ;aAClB,SAAS,EAAE,SAAS;aACpB,OAAO,CAAC,EAAE,MAAM;gBAHhC,OAAO,EAAE,MAAM,EACC,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,SAAS,EACpB,OAAO,CAAC,EAAE,MAAM,YAAA;IAMlC;;OAEG;IACH,cAAc,IAAI,YAAY;CAO/B;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAEtE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAEzE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAEnE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,QAAQ,CAOzE;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,CAMxD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAKpD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,CAUnD;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAcnE"}

package/dist/cli/utils/errors.js

@@ -0,0 +1,129 @@
+/**
+ * CLI Error handling utilities
+ *
+ * Provides exit codes, error formatting, and error type guards.
+ */
+/**
+ * CLI exit codes following Unix conventions
+ */
+export var ExitCode;
+(function (ExitCode) {
+    /** Command completed successfully */
+    ExitCode[ExitCode["SUCCESS"] = 0] = "SUCCESS";
+    /** General/unexpected error */
+    ExitCode[ExitCode["GENERAL_ERROR"] = 1] = "GENERAL_ERROR";
+    /** Invalid arguments or usage error */
+    ExitCode[ExitCode["USAGE_ERROR"] = 2] = "USAGE_ERROR";
+    /** Requested resource not found (session, workspace) */
+    ExitCode[ExitCode["NOT_FOUND"] = 3] = "NOT_FOUND";
+    /** I/O error (file system, permissions) */
+    ExitCode[ExitCode["IO_ERROR"] = 4] = "IO_ERROR";
+})(ExitCode || (ExitCode = {}));
+/**
+ * CLI-specific error class with exit code
+ */
+export class CliError extends Error {
+    exitCode;
+    errorCode;
+    details;
+    constructor(message, exitCode, errorCode, details) {
+        super(message);
+        this.exitCode = exitCode;
+        this.errorCode = errorCode;
+        this.details = details;
+        this.name = 'CliError';
+    }
+    /**
+     * Convert to CommandError for JSON output
+     */
+    toCommandError() {
+        return {
+            code: this.errorCode,
+            message: this.message,
+            ...(this.details && { details: this.details }),
+        };
+    }
+}
+/**
+ * Create a usage error (invalid arguments)
+ */
+export function usageError(message, details) {
+    return new CliError(message, ExitCode.USAGE_ERROR, 'USAGE_ERROR', details);
+}
+/**
+ * Create a not found error (session, workspace not found)
+ */
+export function notFoundError(message, details) {
+    return new CliError(message, ExitCode.NOT_FOUND, 'NOT_FOUND', details);
+}
+/**
+ * Create an I/O error (file system issues)
+ */
+export function ioError(message, details) {
+    return new CliError(message, ExitCode.IO_ERROR, 'IO_ERROR', details);
+}
+/**
+ * Create an internal error (unexpected issues)
+ */
+export function internalError(message, details) {
+    return new CliError(message, ExitCode.GENERAL_ERROR, 'INTERNAL_ERROR', details);
+}
+/**
+ * Type guard for CliError
+ */
+export function isCliError(error) {
+    return error instanceof CliError;
+}
+/**
+ * Format error for human-readable output
+ */
+export function formatErrorHuman(error) {
+    let output = `Error: ${error.message}`;
+    if (error.details) {
+        output += `\n\n${error.details}`;
+    }
+    return output;
+}
+/**
+ * Get exit code from an error, defaulting to GENERAL_ERROR for unknown errors
+ */
+export function getExitCode(error) {
+    if (isCliError(error)) {
+        return error.exitCode;
+    }
+    return ExitCode.GENERAL_ERROR;
+}
+/**
+ * Convert any error to a CliError
+ */
+export function toCliError(error) {
+    if (isCliError(error)) {
+        return error;
+    }
+    if (error instanceof Error) {
+        return internalError(error.message);
+    }
+    return internalError(String(error));
+}
+/**
+ * Handle command error with appropriate output format
+ *
+ * @param error - The error that occurred
+ * @param json - Whether to output as JSON
+ * @returns Exit code for the error
+ */
+export function handleError(error, json) {
+    const cliError = toCliError(error);
+    if (json) {
+        const result = {
+            success: false,
+            error: cliError.toCommandError(),
+        };
+        process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    }
+    else {
+        process.stderr.write(formatErrorHuman(cliError) + '\n');
+    }
+    return cliError.exitCode;
+}
+//# sourceMappingURL=errors.js.map

package/dist/cli/utils/errors.js.map

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

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

@@ -0,0 +1,74 @@
+/**
+ * CLI Output utilities
+ *
+ * Handles stdout/stderr output, JSON formatting, and command result structure.
+ */
+import type { Pagination } from '../../lib/index.js';
+import { type CommandError, type CliError, ExitCode } from './errors.js';
+/**
+ * Pagination info for command results
+ */
+export interface PaginationInfo {
+    total: number;
+    offset: number;
+    limit: number;
+    hasMore: boolean;
+}
+/**
+ * Standardized command result for JSON output
+ */
+export interface CommandResult<T> {
+    success: boolean;
+    data?: T;
+    error?: CommandError;
+    pagination?: PaginationInfo;
+}
+/**
+ * Convert lib Pagination to CLI PaginationInfo
+ */
+export declare function toPaginationInfo(pagination: Pagination): PaginationInfo;
+/**
+ * Create a successful command result
+ */
+export declare function successResult<T>(data: T, pagination?: Pagination): CommandResult<T>;
+/**
+ * Create a failed command result from an error
+ */
+export declare function errorResult(error: CliError): CommandResult<never>;
+/**
+ * Output content to stdout
+ */
+export declare function stdout(content: string): void;
+/**
+ * Output error to stderr
+ */
+export declare function stderr(content: string): void;
+/**
+ * Output JSON to stdout
+ */
+export declare function outputJson<T>(result: CommandResult<T>): void;
+/**
+ * Output result based on format preference
+ *
+ * @param result - Command result or formatted string
+ * @param json - Whether to output as JSON
+ * @param humanOutput - Human-readable string (used when json=false)
+ */
+export declare function output<T>(result: CommandResult<T>, json: boolean, humanOutput?: string): void;
+/**
+ * Handle command error with appropriate output format
+ *
+ * @param error - The error that occurred
+ * @param json - Whether to output as JSON
+ * @returns Exit code for the error
+ */
+export declare function handleError(error: unknown, json: boolean): ExitCode;
+/**
+ * Format pagination hint for human output
+ *
+ * @param pagination - Pagination info
+ * @param itemName - Name of items being paginated (e.g., "sessions", "matches")
+ * @returns Human-readable pagination hint or empty string if not needed
+ */
+export declare function formatPaginationHint(pagination: PaginationInfo, itemName: string): string;
+//# sourceMappingURL=output.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../../src/cli/utils/output.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,QAAQ,EAGT,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,CAAC,CAAC;IACT,KAAK,CAAC,EAAE,YAAY,CAAC;IACrB,UAAU,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,GAAG,cAAc,CAOvE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAC7B,IAAI,EAAE,CAAC,EACP,UAAU,CAAC,EAAE,UAAU,GACtB,aAAa,CAAC,CAAC,CAAC,CAMlB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG,aAAa,CAAC,KAAK,CAAC,CAKjE;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAM5C;AAED;;GAEG;AACH,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAK5C;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,IAAI,CAE5D;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,CAAC,EACtB,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EACxB,IAAI,EAAE,OAAO,EACb,WAAW,CAAC,EAAE,MAAM,GACnB,IAAI,CASN;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,GAAG,QAAQ,CAUnE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,cAAc,EAC1B,QAAQ,EAAE,MAAM,GACf,MAAM,CASR"}

package/dist/cli/utils/output.js

@@ -0,0 +1,113 @@
+/**
+ * CLI Output utilities
+ *
+ * Handles stdout/stderr output, JSON formatting, and command result structure.
+ */
+import { toCliError, formatErrorHuman, } from './errors.js';
+/**
+ * Convert lib Pagination to CLI PaginationInfo
+ */
+export function toPaginationInfo(pagination) {
+    return {
+        total: pagination.total,
+        offset: pagination.offset,
+        limit: pagination.limit,
+        hasMore: pagination.hasMore,
+    };
+}
+/**
+ * Create a successful command result
+ */
+export function successResult(data, pagination) {
+    return {
+        success: true,
+        data,
+        ...(pagination && { pagination: toPaginationInfo(pagination) }),
+    };
+}
+/**
+ * Create a failed command result from an error
+ */
+export function errorResult(error) {
+    return {
+        success: false,
+        error: error.toCommandError(),
+    };
+}
+/**
+ * Output content to stdout
+ */
+export function stdout(content) {
+    process.stdout.write(content);
+    // Ensure newline at end if not present
+    if (!content.endsWith('\n')) {
+        process.stdout.write('\n');
+    }
+}
+/**
+ * Output error to stderr
+ */
+export function stderr(content) {
+    process.stderr.write(content);
+    if (!content.endsWith('\n')) {
+        process.stderr.write('\n');
+    }
+}
+/**
+ * Output JSON to stdout
+ */
+export function outputJson(result) {
+    stdout(JSON.stringify(result, null, 2));
+}
+/**
+ * Output result based on format preference
+ *
+ * @param result - Command result or formatted string
+ * @param json - Whether to output as JSON
+ * @param humanOutput - Human-readable string (used when json=false)
+ */
+export function output(result, json, humanOutput) {
+    if (json) {
+        outputJson(result);
+    }
+    else if (humanOutput !== undefined) {
+        stdout(humanOutput);
+    }
+    else if (result.data !== undefined) {
+        // Fallback: stringify data if no human output provided
+        stdout(JSON.stringify(result.data, null, 2));
+    }
+}
+/**
+ * Handle command error with appropriate output format
+ *
+ * @param error - The error that occurred
+ * @param json - Whether to output as JSON
+ * @returns Exit code for the error
+ */
+export function handleError(error, json) {
+    const cliError = toCliError(error);
+    if (json) {
+        outputJson(errorResult(cliError));
+    }
+    else {
+        stderr(formatErrorHuman(cliError));
+    }
+    return cliError.exitCode;
+}
+/**
+ * Format pagination hint for human output
+ *
+ * @param pagination - Pagination info
+ * @param itemName - Name of items being paginated (e.g., "sessions", "matches")
+ * @returns Human-readable pagination hint or empty string if not needed
+ */
+export function formatPaginationHint(pagination, itemName) {
+    if (!pagination.hasMore) {
+        return '';
+    }
+    const start = pagination.offset + 1;
+    const end = Math.min(pagination.offset + pagination.limit, pagination.total);
+    return `\nShowing ${start}-${end} of ${pagination.total} ${itemName}. Use --offset to see more.`;
+}
+//# sourceMappingURL=output.js.map

package/dist/cli/utils/output.js.map

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

package/dist/lib/config.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Configuration handling for claude-code-history library.
+ */
+import type { LibraryConfig } from './types.js';
+/** Default configuration values */
+export declare const DEFAULT_CONFIG: Required<Omit<LibraryConfig, 'dataPath' | 'workspace'>> & {
+    dataPath: string;
+    workspace: undefined;
+};
+/**
+ * Internal resolved configuration with all fields required.
+ */
+export interface ResolvedConfig {
+    dataPath: string;
+    workspace: string | undefined;
+    limit: number;
+    offset: number;
+    context: number;
+}
+/**
+ * Merge user config with defaults and validate.
+ * @param config - User-provided configuration
+ * @returns Resolved configuration with all fields
+ */
+export declare function resolveConfig(config?: LibraryConfig): ResolvedConfig;
+/**
+ * Apply pagination to an array of items.
+ * @param items - Full array of items
+ * @param config - Configuration with limit and offset
+ * @returns Paginated slice of items
+ */
+export declare function paginate<T>(items: T[], config: ResolvedConfig): T[];
+/**
+ * Create pagination metadata.
+ * @param total - Total number of items
+ * @param config - Configuration with limit and offset
+ */
+export declare function createPagination(total: number, config: ResolvedConfig): {
+    total: number;
+    limit: number;
+    offset: number;
+    hasMore: boolean;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/lib/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAGhD,mCAAmC;AACnC,eAAO,MAAM,cAAc,EAAE,QAAQ,CAAC,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,WAAW,CAAC,CAAC,GAAG;IACrF,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,SAAS,CAAC;CAOtB,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,aAAa,GAAG,cAAc,CAqBpE;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,cAAc,GAAG,CAAC,EAAE,CAEnE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,cAAc,GACrB;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAOpE"}

package/dist/lib/config.js

@@ -0,0 +1,60 @@
+/**
+ * Configuration handling for claude-code-history library.
+ */
+import { getDefaultDataPath } from './platform.js';
+/** Default configuration values */
+export const DEFAULT_CONFIG = {
+    dataPath: getDefaultDataPath(),
+    workspace: undefined,
+    limit: 50,
+    offset: 0,
+    context: 2,
+};
+/**
+ * Merge user config with defaults and validate.
+ * @param config - User-provided configuration
+ * @returns Resolved configuration with all fields
+ */
+export function resolveConfig(config) {
+    const resolved = {
+        dataPath: config?.dataPath ?? DEFAULT_CONFIG.dataPath,
+        workspace: config?.workspace,
+        limit: config?.limit ?? DEFAULT_CONFIG.limit,
+        offset: config?.offset ?? DEFAULT_CONFIG.offset,
+        context: config?.context ?? DEFAULT_CONFIG.context,
+    };
+    // Validate numeric values
+    if (resolved.limit < 0) {
+        throw new Error('limit must be non-negative');
+    }
+    if (resolved.offset < 0) {
+        throw new Error('offset must be non-negative');
+    }
+    if (resolved.context < 0) {
+        throw new Error('context must be non-negative');
+    }
+    return resolved;
+}
+/**
+ * Apply pagination to an array of items.
+ * @param items - Full array of items
+ * @param config - Configuration with limit and offset
+ * @returns Paginated slice of items
+ */
+export function paginate(items, config) {
+    return items.slice(config.offset, config.offset + config.limit);
+}
+/**
+ * Create pagination metadata.
+ * @param total - Total number of items
+ * @param config - Configuration with limit and offset
+ */
+export function createPagination(total, config) {
+    return {
+        total,
+        limit: config.limit,
+        offset: config.offset,
+        hasMore: config.offset + config.limit < total,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEnD,mCAAmC;AACnC,MAAM,CAAC,MAAM,cAAc,GAGvB;IACF,QAAQ,EAAE,kBAAkB,EAAE;IAC9B,SAAS,EAAE,SAAS;IACpB,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,CAAC;IACT,OAAO,EAAE,CAAC;CACX,CAAC;AAaF;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,MAAsB;IAClD,MAAM,QAAQ,GAAmB;QAC/B,QAAQ,EAAE,MAAM,EAAE,QAAQ,IAAI,cAAc,CAAC,QAAQ;QACrD,SAAS,EAAE,MAAM,EAAE,SAAS;QAC5B,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,cAAc,CAAC,KAAK;QAC5C,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,cAAc,CAAC,MAAM;QAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,IAAI,cAAc,CAAC,OAAO;KACnD,CAAC;IAEF,0BAA0B;IAC1B,IAAI,QAAQ,CAAC,KAAK,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IACD,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,QAAQ,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,QAAQ,CAAI,KAAU,EAAE,MAAsB;IAC5D,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAa,EACb,MAAsB;IAEtB,OAAO;QACL,KAAK;QACL,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,OAAO,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,KAAK,GAAG,KAAK;KAC9C,CAAC;AACJ,CAAC"}