attocode 0.2.3 → 0.2.5

package/dist/src/integrations/persistence/history.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Command History Manager
+ *
+ * Provides persistent command history storage and retrieval.
+ * History is stored in a simple line-delimited text file at
+ * ~/.local/state/attocode/history
+ *
+ * Features:
+ * - Persistent storage across sessions
+ * - Configurable max history size
+ * - Deduplication of consecutive commands
+ * - History search
+ */
+export interface HistoryManagerConfig {
+    /** Max number of history entries to keep (default: 1000) */
+    maxEntries?: number;
+    /** Path to history file (default: ~/.local/state/attocode/history) */
+    historyFile?: string;
+    /** Whether to deduplicate consecutive identical commands (default: true) */
+    deduplicateConsecutive?: boolean;
+}
+export declare class HistoryManager {
+    private config;
+    private history;
+    private loaded;
+    constructor(config?: HistoryManagerConfig);
+    /**
+     * Load history from file (lazy loading).
+     */
+    private ensureLoaded;
+    /**
+     * Get all history entries (oldest first).
+     */
+    getHistory(): string[];
+    /**
+     * Get number of history entries.
+     */
+    get length(): number;
+    /**
+     * Get a specific history entry by index.
+     * Index 0 is the oldest, index length-1 is the most recent.
+     * Negative indices count from the end (-1 is most recent).
+     */
+    getEntry(index: number): string | undefined;
+    /**
+     * Add a new entry to history.
+     * Optionally deduplicates consecutive identical commands.
+     */
+    addEntry(command: string): void;
+    /**
+     * Search history for entries matching a query.
+     * Returns matches in reverse order (most recent first).
+     */
+    search(query: string): string[];
+    /**
+     * Save history to file.
+     */
+    save(): void;
+    /**
+     * Clear all history.
+     */
+    clear(): void;
+    /**
+     * Get the path to the history file.
+     */
+    getHistoryPath(): string;
+}
+/**
+ * Create a new history manager.
+ */
+export declare function createHistoryManager(config?: HistoryManagerConfig): HistoryManager;
+//# sourceMappingURL=history.d.ts.map

package/dist/src/integrations/persistence/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../../../../src/integrations/persistence/history.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,MAAM,WAAW,oBAAoB;IACnC,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,4EAA4E;IAC5E,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAMD,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,GAAE,oBAAyB;IAY7C;;OAEG;IACH,OAAO,CAAC,YAAY;IA0BpB;;OAEG;IACH,UAAU,IAAI,MAAM,EAAE;IAKtB;;OAEG;IACH,IAAI,MAAM,IAAI,MAAM,CAGnB;IAED;;;;OAIG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAW3C;;;OAGG;IACH,QAAQ,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAwB/B;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE;IAW/B;;OAEG;IACH,IAAI,IAAI,IAAI;IAeZ;;OAEG;IACH,KAAK,IAAI,IAAI;IAKb;;OAEG;IACH,cAAc,IAAI,MAAM;CAGzB;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,oBAAyB,GAAG,cAAc,CAEtF"}

package/dist/src/integrations/persistence/history.js

@@ -0,0 +1,165 @@
+/**
+ * Command History Manager
+ *
+ * Provides persistent command history storage and retrieval.
+ * History is stored in a simple line-delimited text file at
+ * ~/.local/state/attocode/history
+ *
+ * Features:
+ * - Persistent storage across sessions
+ * - Configurable max history size
+ * - Deduplication of consecutive commands
+ * - History search
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+// =============================================================================
+// HISTORY MANAGER
+// =============================================================================
+export class HistoryManager {
+    config;
+    history = [];
+    loaded = false;
+    constructor(config = {}) {
+        // Default path: ~/.local/state/attocode/history
+        const defaultHistoryDir = path.join(os.homedir(), '.local', 'state', 'attocode');
+        const defaultHistoryFile = path.join(defaultHistoryDir, 'history');
+        this.config = {
+            maxEntries: config.maxEntries ?? 1000,
+            historyFile: config.historyFile ?? defaultHistoryFile,
+            deduplicateConsecutive: config.deduplicateConsecutive ?? true,
+        };
+    }
+    /**
+     * Load history from file (lazy loading).
+     */
+    ensureLoaded() {
+        if (this.loaded)
+            return;
+        try {
+            // Ensure directory exists
+            const dir = path.dirname(this.config.historyFile);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            // Load history if file exists
+            if (fs.existsSync(this.config.historyFile)) {
+                const content = fs.readFileSync(this.config.historyFile, 'utf8');
+                this.history = content
+                    .split('\n')
+                    .filter(line => line.trim().length > 0)
+                    .slice(-this.config.maxEntries); // Only keep most recent
+            }
+        }
+        catch {
+            // Silently ignore load errors - start with empty history
+            this.history = [];
+        }
+        this.loaded = true;
+    }
+    /**
+     * Get all history entries (oldest first).
+     */
+    getHistory() {
+        this.ensureLoaded();
+        return [...this.history];
+    }
+    /**
+     * Get number of history entries.
+     */
+    get length() {
+        this.ensureLoaded();
+        return this.history.length;
+    }
+    /**
+     * Get a specific history entry by index.
+     * Index 0 is the oldest, index length-1 is the most recent.
+     * Negative indices count from the end (-1 is most recent).
+     */
+    getEntry(index) {
+        this.ensureLoaded();
+        // Handle negative indices
+        if (index < 0) {
+            index = this.history.length + index;
+        }
+        return this.history[index];
+    }
+    /**
+     * Add a new entry to history.
+     * Optionally deduplicates consecutive identical commands.
+     */
+    addEntry(command) {
+        this.ensureLoaded();
+        const trimmed = command.trim();
+        if (!trimmed)
+            return; // Don't add empty commands
+        // Deduplicate consecutive commands if enabled
+        if (this.config.deduplicateConsecutive) {
+            const lastEntry = this.history[this.history.length - 1];
+            if (lastEntry === trimmed)
+                return;
+        }
+        // Add entry
+        this.history.push(trimmed);
+        // Trim if over max
+        if (this.history.length > this.config.maxEntries) {
+            this.history = this.history.slice(-this.config.maxEntries);
+        }
+        // Save immediately
+        this.save();
+    }
+    /**
+     * Search history for entries matching a query.
+     * Returns matches in reverse order (most recent first).
+     */
+    search(query) {
+        this.ensureLoaded();
+        if (!query.trim())
+            return [];
+        const lowerQuery = query.toLowerCase();
+        return this.history
+            .filter(entry => entry.toLowerCase().includes(lowerQuery))
+            .reverse(); // Most recent first
+    }
+    /**
+     * Save history to file.
+     */
+    save() {
+        try {
+            // Ensure directory exists
+            const dir = path.dirname(this.config.historyFile);
+            if (!fs.existsSync(dir)) {
+                fs.mkdirSync(dir, { recursive: true });
+            }
+            // Write history
+            fs.writeFileSync(this.config.historyFile, this.history.join('\n') + '\n', 'utf8');
+        }
+        catch {
+            // Silently ignore save errors
+        }
+    }
+    /**
+     * Clear all history.
+     */
+    clear() {
+        this.history = [];
+        this.save();
+    }
+    /**
+     * Get the path to the history file.
+     */
+    getHistoryPath() {
+        return this.config.historyFile;
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a new history manager.
+ */
+export function createHistoryManager(config = {}) {
+    return new HistoryManager(config);
+}
+//# sourceMappingURL=history.js.map

package/dist/src/integrations/persistence/history.js.map

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

package/dist/src/integrations/persistence/persistence.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Persistence Utilities
+ *
+ * Debug logging and checkpoint management for session persistence.
+ */
+import type { SQLiteStore } from './sqlite-store.js';
+import type { SessionStore } from './session-store.js';
+export type AnySessionStore = SQLiteStore | SessionStore;
+/**
+ * Debug logger for persistence operations.
+ * Enabled via --debug flag. Shows data flow at each layer boundary.
+ * In TUI mode, logs are buffered instead of printed to avoid interfering with Ink.
+ */
+export declare class PersistenceDebugger {
+    private enabled;
+    private tuiMode;
+    private buffer;
+    enable(): void;
+    enableTUIMode(): void;
+    isEnabled(): boolean;
+    getBuffer(): string[];
+    log(message: string, data?: unknown): void;
+    error(message: string, err: unknown): void;
+    storeType(store: AnySessionStore): string;
+}
+export declare const persistenceDebug: PersistenceDebugger;
+/**
+ * Checkpoint data structure for full state restoration.
+ */
+export interface CheckpointData {
+    id: string;
+    label?: string;
+    messages: unknown[];
+    iteration: number;
+    metrics?: unknown;
+    plan?: unknown;
+    memoryContext?: string[];
+}
+/**
+ * Save checkpoint to session store (works with both SQLite and JSONL).
+ * Now includes plan and memoryContext for full state restoration.
+ */
+export declare function saveCheckpointToStore(store: AnySessionStore, checkpoint: CheckpointData): void;
+/**
+ * Load session state (checkpoint or messages) for resuming.
+ * Returns checkpoint data if found, or null.
+ */
+export declare function loadSessionState(sessionStore: AnySessionStore, sessionId: string): Promise<CheckpointData | null>;
+//# sourceMappingURL=persistence.d.ts.map

package/dist/src/integrations/persistence/persistence.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.d.ts","sourceRoot":"","sources":["../../../../src/integrations/persistence/persistence.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAIvD,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,YAAY,CAAC;AAMzD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAgB;IAE9B,MAAM,IAAI,IAAI;IAKd,aAAa,IAAI,IAAI;IAIrB,SAAS,IAAI,OAAO;IAIpB,SAAS,IAAI,MAAM,EAAE;IAMrB,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,IAAI;IAgB1C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI;IAuB1C,SAAS,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM;CAM1C;AAGD,eAAO,MAAM,gBAAgB,qBAA4B,CAAC;AAM1D;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,OAAO,EAAE,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,eAAe,EACtB,UAAU,EAAE,cAAc,GACzB,IAAI,CAgEN;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,YAAY,EAAE,eAAe,EAC7B,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CA8ChC"}

package/dist/src/integrations/persistence/persistence.js

@@ -0,0 +1,197 @@
+/**
+ * Persistence Utilities
+ *
+ * Debug logging and checkpoint management for session persistence.
+ */
+import { logger } from '../utilities/logger.js';
+// =============================================================================
+// DEBUG LOGGER FOR PERSISTENCE OPERATIONS
+// =============================================================================
+/**
+ * Debug logger for persistence operations.
+ * Enabled via --debug flag. Shows data flow at each layer boundary.
+ * In TUI mode, logs are buffered instead of printed to avoid interfering with Ink.
+ */
+export class PersistenceDebugger {
+    enabled = false;
+    tuiMode = false;
+    buffer = [];
+    enable() {
+        this.enabled = true;
+        this.log('Persistence debug mode ENABLED');
+    }
+    enableTUIMode() {
+        this.tuiMode = true;
+    }
+    isEnabled() {
+        return this.enabled;
+    }
+    getBuffer() {
+        const logs = [...this.buffer];
+        this.buffer = [];
+        return logs;
+    }
+    log(message, data) {
+        if (!this.enabled)
+            return;
+        const timestamp = new Date().toISOString().split('T')[1].slice(0, 12);
+        const logLine = `[${timestamp}] ${message}`;
+        const dataLine = data !== undefined ? `    -> ${JSON.stringify(data, null, 2).split('\n').join('\n    ')}` : '';
+        if (this.tuiMode) {
+            // Buffer logs in TUI mode to avoid console interference
+            this.buffer.push(logLine);
+            if (dataLine)
+                this.buffer.push(dataLine);
+        }
+        else {
+            logger.debug(logLine);
+            if (dataLine)
+                logger.debug(dataLine);
+        }
+    }
+    error(message, err) {
+        if (!this.enabled)
+            return;
+        const timestamp = new Date().toISOString().split('T')[1].slice(0, 12);
+        const errLine = `[${timestamp}] ERROR: ${message}`;
+        let details = '';
+        if (err instanceof Error) {
+            details = `    -> ${err.message}`;
+            if (err.stack) {
+                details += `\n    -> Stack: ${err.stack.split('\n').slice(1, 3).join(' -> ')}`;
+            }
+        }
+        else {
+            details = `    -> ${String(err)}`;
+        }
+        if (this.tuiMode) {
+            this.buffer.push(errLine);
+            this.buffer.push(details);
+        }
+        else {
+            logger.error(errLine);
+            logger.error(details);
+        }
+    }
+    storeType(store) {
+        if ('saveCheckpoint' in store && typeof store.saveCheckpoint === 'function') {
+            return 'SQLiteStore';
+        }
+        return 'JSONLStore';
+    }
+}
+// Global debug instance - enabled via --debug flag
+export const persistenceDebug = new PersistenceDebugger();
+/**
+ * Save checkpoint to session store (works with both SQLite and JSONL).
+ * Now includes plan and memoryContext for full state restoration.
+ */
+export function saveCheckpointToStore(store, checkpoint) {
+    const storeType = persistenceDebug.storeType(store);
+    persistenceDebug.log(`saveCheckpointToStore called`, {
+        storeType,
+        checkpointId: checkpoint.id,
+        messageCount: checkpoint.messages?.length ?? 0,
+        hasLabel: !!checkpoint.label,
+        hasPlan: !!checkpoint.plan,
+    });
+    try {
+        if ('saveCheckpoint' in store && typeof store.saveCheckpoint === 'function') {
+            // SQLite store - check currentSessionId
+            const sqliteStore = store;
+            const currentSessionId = sqliteStore.getCurrentSessionId();
+            persistenceDebug.log(`SQLite saveCheckpoint`, {
+                currentSessionId,
+                hasCurrentSession: !!currentSessionId,
+            });
+            if (!currentSessionId) {
+                persistenceDebug.error('SQLite store has no currentSessionId!', new Error('No active session'));
+            }
+            const ckptId = store.saveCheckpoint({
+                id: checkpoint.id,
+                label: checkpoint.label,
+                messages: checkpoint.messages,
+                iteration: checkpoint.iteration,
+                metrics: checkpoint.metrics,
+                plan: checkpoint.plan,
+                memoryContext: checkpoint.memoryContext,
+            }, checkpoint.label || `auto-checkpoint-${checkpoint.id}`);
+            persistenceDebug.log(`SQLite checkpoint saved successfully`, { returnedId: ckptId });
+        }
+        else if ('appendEntry' in store && typeof store.appendEntry === 'function') {
+            // JSONL store - use appendEntry with checkpoint type
+            persistenceDebug.log(`JSONL appendEntry (checkpoint type)`);
+            store.appendEntry({
+                type: 'checkpoint',
+                data: {
+                    id: checkpoint.id,
+                    label: checkpoint.label,
+                    messages: checkpoint.messages,
+                    iteration: checkpoint.iteration,
+                    metrics: checkpoint.metrics,
+                    plan: checkpoint.plan,
+                    memoryContext: checkpoint.memoryContext,
+                    createdAt: new Date().toISOString(),
+                },
+            });
+            persistenceDebug.log(`JSONL checkpoint appended successfully`);
+        }
+        else {
+            persistenceDebug.error('No compatible save method found on store', { storeType });
+        }
+    }
+    catch (err) {
+        persistenceDebug.error(`Failed to save checkpoint`, err);
+        // Re-throw in debug mode so the error is visible
+        if (persistenceDebug.isEnabled()) {
+            throw err;
+        }
+    }
+}
+/**
+ * Load session state (checkpoint or messages) for resuming.
+ * Returns checkpoint data if found, or null.
+ */
+export async function loadSessionState(sessionStore, sessionId) {
+    persistenceDebug.log('Loading session state', { sessionId });
+    // Try SQLite's loadLatestCheckpoint first
+    if ('loadLatestCheckpoint' in sessionStore && typeof sessionStore.loadLatestCheckpoint === 'function') {
+        const sqliteCheckpoint = sessionStore.loadLatestCheckpoint(sessionId);
+        if (sqliteCheckpoint?.state) {
+            persistenceDebug.log('Loaded from SQLite checkpoint', {
+                messageCount: sqliteCheckpoint.state.messages?.length,
+            });
+            return sqliteCheckpoint.state;
+        }
+    }
+    // Fall back to entries-based lookup (for JSONL or if SQLite checkpoint not found)
+    try {
+        const entriesResult = sessionStore.loadSession(sessionId);
+        const entries = Array.isArray(entriesResult) ? entriesResult : await entriesResult;
+        // Try to find a checkpoint entry
+        const checkpoint = [...entries].reverse().find(e => e.type === 'checkpoint');
+        if (checkpoint?.data) {
+            persistenceDebug.log('Loaded from entries checkpoint', {
+                messageCount: checkpoint.data.messages?.length,
+            });
+            return checkpoint.data;
+        }
+        // No checkpoint, try to load messages directly from entries
+        const messages = entries
+            .filter((e) => e.type === 'message')
+            .map((e) => e.data);
+        if (messages.length > 0) {
+            persistenceDebug.log('Loaded messages from entries', { count: messages.length });
+            return {
+                id: `loaded-${sessionId}`,
+                messages,
+                iteration: 0,
+            };
+        }
+    }
+    catch (error) {
+        persistenceDebug.error('Failed to load session entries', error);
+    }
+    return null;
+}
+//# sourceMappingURL=persistence.js.map

package/dist/src/integrations/persistence/persistence.js.map

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