attocode 0.2.4 → 0.2.5

package/dist/src/integrations/persistence/goal-repository.js

@@ -0,0 +1,184 @@
+/**
+ * Goal Repository
+ *
+ * Goal CRUD operations and critical juncture tracking.
+ * Goals persist outside of context and survive compaction.
+ *
+ * Extracted from sqlite-store.ts as part of Phase 3c restructuring.
+ */
+// =============================================================================
+// GOAL CRUD
+// =============================================================================
+/**
+ * Create a new goal for the current session.
+ * Goals persist outside of context and survive compaction.
+ * Returns undefined if goals feature is not available.
+ */
+export function createGoal(deps, goalText, options = {}) {
+    if (!deps.features.goals || !deps.stmts.insertGoal) {
+        return undefined;
+    }
+    if (!deps.getCurrentSessionId()) {
+        // Delegate session creation to the store
+        deps.ensureSession();
+    }
+    const id = `goal-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 6)}`;
+    const now = new Date().toISOString();
+    deps.stmts.insertGoal.run({
+        id,
+        sessionId: deps.getCurrentSessionId(),
+        goalText,
+        status: 'active',
+        priority: options.priority ?? 2,
+        parentGoalId: options.parentGoalId ?? null,
+        progressCurrent: 0,
+        progressTotal: options.progressTotal ?? null,
+        createdAt: now,
+        updatedAt: now,
+        metadata: options.metadata ? JSON.stringify(options.metadata) : null,
+    });
+    return id;
+}
+/**
+ * Update a goal's status or progress.
+ */
+export function updateGoal(deps, goalId, updates) {
+    if (!deps.features.goals || !deps.stmts.updateGoal) {
+        return;
+    }
+    const now = new Date().toISOString();
+    deps.stmts.updateGoal.run({
+        id: goalId,
+        goalText: updates.goalText ?? null,
+        status: updates.status ?? null,
+        priority: updates.priority ?? null,
+        progressCurrent: updates.progressCurrent ?? null,
+        progressTotal: updates.progressTotal ?? null,
+        updatedAt: now,
+        completedAt: updates.status === 'completed' || updates.status === 'abandoned' ? now : null,
+        metadata: updates.metadata ? JSON.stringify(updates.metadata) : null,
+    });
+}
+/**
+ * Mark a goal as completed.
+ */
+export function completeGoal(deps, goalId) {
+    updateGoal(deps, goalId, { status: 'completed' });
+}
+/**
+ * Get a goal by ID.
+ */
+export function getGoal(deps, goalId) {
+    if (!deps.features.goals || !deps.stmts.getGoal) {
+        return undefined;
+    }
+    return deps.stmts.getGoal.get(goalId);
+}
+/**
+ * List all goals for a session.
+ */
+export function listGoals(deps, sessionId) {
+    if (!deps.features.goals || !deps.stmts.listGoals) {
+        return [];
+    }
+    const sid = sessionId ?? deps.getCurrentSessionId();
+    if (!sid)
+        return [];
+    return deps.stmts.listGoals.all(sid);
+}
+/**
+ * List active goals for a session.
+ */
+export function listActiveGoals(deps, sessionId) {
+    if (!deps.features.goals || !deps.stmts.listActiveGoals) {
+        return [];
+    }
+    const sid = sessionId ?? deps.getCurrentSessionId();
+    if (!sid)
+        return [];
+    return deps.stmts.listActiveGoals.all(sid);
+}
+/**
+ * Get a summary of the current goals for context injection.
+ * This is what gets recited to maintain goal awareness.
+ */
+export function getGoalsSummary(deps, sessionId) {
+    if (!deps.features.goals) {
+        return 'Goals feature not available.';
+    }
+    const goals = listActiveGoals(deps, sessionId);
+    if (goals.length === 0) {
+        return 'No active goals.';
+    }
+    const lines = ['Active Goals:'];
+    for (const goal of goals) {
+        const progress = goal.progressTotal
+            ? ` (${goal.progressCurrent}/${goal.progressTotal})`
+            : '';
+        const priority = goal.priority === 1 ? ' [HIGH]' : goal.priority === 3 ? ' [low]' : '';
+        lines.push(`\u2022 ${goal.goalText}${progress}${priority}`);
+    }
+    return lines.join('\n');
+}
+// =============================================================================
+// JUNCTURES (Critical Moments)
+// =============================================================================
+/**
+ * Log a critical juncture (decision, failure, breakthrough, pivot).
+ * Returns -1 if goals feature is not available.
+ */
+export function logJuncture(deps, type, description, options = {}) {
+    if (!deps.features.goals || !deps.stmts.insertJuncture) {
+        return -1;
+    }
+    if (!deps.getCurrentSessionId()) {
+        deps.ensureSession();
+    }
+    const result = deps.stmts.insertJuncture.run({
+        sessionId: deps.getCurrentSessionId(),
+        goalId: options.goalId ?? null,
+        type,
+        description,
+        outcome: options.outcome ?? null,
+        importance: options.importance ?? 2,
+        context: options.context ? JSON.stringify(options.context) : null,
+        createdAt: new Date().toISOString(),
+    });
+    return Number(result.lastInsertRowid);
+}
+/**
+ * List junctures for a session.
+ */
+export function listJunctures(deps, sessionId, limit) {
+    if (!deps.features.goals || !deps.stmts.listJunctures) {
+        return [];
+    }
+    const sid = sessionId ?? deps.getCurrentSessionId();
+    if (!sid)
+        return [];
+    const junctures = deps.stmts.listJunctures.all(sid);
+    return limit ? junctures.slice(0, limit) : junctures;
+}
+/**
+ * Get recent critical junctures for context.
+ */
+export function getJuncturesSummary(deps, sessionId, limit = 5) {
+    if (!deps.features.goals) {
+        return '';
+    }
+    const junctures = listJunctures(deps, sessionId, limit);
+    if (junctures.length === 0) {
+        return '';
+    }
+    const lines = ['Recent Key Moments:'];
+    for (const j of junctures) {
+        const icon = j.type === 'failure' ? '\u2717' : j.type === 'breakthrough' ? '\u2605' :
+            j.type === 'decision' ? '\u2192' : '\u21BB';
+        lines.push(`${icon} [${j.type}] ${j.description}`);
+        if (j.outcome) {
+            lines.push(`  \u2514\u2500 ${j.outcome}`);
+        }
+    }
+    return lines.join('\n');
+}
+//# sourceMappingURL=goal-repository.js.map

package/dist/src/integrations/persistence/goal-repository.js.map

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

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"}