attocode 0.1.0

package/dist/src/persistence/migrator.js

@@ -0,0 +1,303 @@
+/**
+ * Schema Migrator for SQLite Database
+ *
+ * Handles versioned SQL migrations using PRAGMA user_version.
+ * Migrations are applied sequentially and tracked in the database.
+ *
+ * ## Concurrency Warning
+ *
+ * This migrator is NOT safe for concurrent access. If multiple processes
+ * attempt to run migrations simultaneously, race conditions may occur.
+ * **Recommendation:** Run migrations from a single process at startup
+ * before spawning worker processes or subagents.
+ *
+ * ## Partial Failure Recovery
+ *
+ * SQLite requires autocommit mode for ALTER TABLE statements, so each
+ * migration runs outside a transaction. If a migration fails partway:
+ * - The schema version reflects the last successful migration
+ * - The database may have partial changes from the failed migration
+ *
+ * **Recommendation:** Design migrations to be idempotent (re-runnable).
+ * Column additions already handle "duplicate column name" errors gracefully.
+ * After fixing an issue, re-run applyMigrations() to continue.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { applyMigrations, needsMigration } from './migrator.js';
+ *
+ * const db = new Database('sessions.db');
+ * if (needsMigration(db, './migrations')) {
+ *   const result = applyMigrations(db, './migrations');
+ *   console.log(`Applied ${result.applied} migrations`);
+ * }
+ * ```
+ */
+import { readdirSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// =============================================================================
+// SCHEMA VERSION MANAGEMENT
+// =============================================================================
+/**
+ * Get the current schema version from the database.
+ * Uses SQLite's PRAGMA user_version.
+ *
+ * @param db - Database instance
+ * @returns Current schema version (0 if never migrated)
+ */
+export function getSchemaVersion(db) {
+    const result = db.pragma('user_version', { simple: true });
+    return typeof result === 'number' ? result : 0;
+}
+/**
+ * Set the schema version in the database.
+ * Uses SQLite's PRAGMA user_version.
+ *
+ * @param db - Database instance
+ * @param version - Version number to set
+ */
+export function setSchemaVersion(db, version) {
+    db.pragma(`user_version = ${version}`);
+}
+// =============================================================================
+// MIGRATION FILE LOADING
+// =============================================================================
+/**
+ * Parse a migration filename to extract version and name.
+ *
+ * @param filename - Migration filename (e.g., "001_initial.sql")
+ * @returns Parsed version and name, or null if invalid format
+ */
+function parseMigrationFilename(filename) {
+    // Match pattern: NNN_name.sql (e.g., 001_initial.sql, 002_add_costs.sql)
+    const match = filename.match(/^(\d+)_(.+)\.sql$/);
+    if (!match)
+        return null;
+    return {
+        version: parseInt(match[1], 10),
+        name: match[2],
+    };
+}
+/**
+ * Load all migration files from a directory.
+ * Sorts migrations by version number.
+ *
+ * @param dir - Directory containing SQL migration files
+ * @returns Array of migration files sorted by version
+ */
+export function loadMigrations(dir) {
+    const migrations = [];
+    let files;
+    try {
+        files = readdirSync(dir);
+    }
+    catch {
+        // Directory doesn't exist or can't be read
+        return [];
+    }
+    for (const file of files) {
+        // Skip non-SQL files
+        if (!file.endsWith('.sql'))
+            continue;
+        const parsed = parseMigrationFilename(file);
+        if (!parsed)
+            continue;
+        const sql = readFileSync(join(dir, file), 'utf-8');
+        migrations.push({
+            version: parsed.version,
+            name: parsed.name,
+            sql,
+        });
+    }
+    // Sort by version number (ascending)
+    return migrations.sort((a, b) => a.version - b.version);
+}
+// =============================================================================
+// MIGRATION APPLICATION
+// =============================================================================
+/**
+ * Check if the database needs migration.
+ *
+ * @param db - Database instance
+ * @param migrationsDir - Directory containing SQL migration files
+ * @returns True if there are pending migrations
+ */
+export function needsMigration(db, migrationsDir) {
+    const currentVersion = getSchemaVersion(db);
+    const migrations = loadMigrations(migrationsDir);
+    if (migrations.length === 0)
+        return false;
+    const latestVersion = migrations[migrations.length - 1].version;
+    return currentVersion < latestVersion;
+}
+/**
+ * Get the list of pending migrations.
+ *
+ * @param db - Database instance
+ * @param migrationsDir - Directory containing SQL migration files
+ * @returns Array of migrations that need to be applied
+ */
+export function getPendingMigrations(db, migrationsDir) {
+    const currentVersion = getSchemaVersion(db);
+    const migrations = loadMigrations(migrationsDir);
+    return migrations.filter(m => m.version > currentVersion);
+}
+/**
+ * Strip leading comment lines from a SQL statement.
+ * Preserves the actual SQL command after comments.
+ */
+function stripLeadingComments(sql) {
+    const lines = sql.split('\n');
+    let startIndex = 0;
+    // Skip leading blank lines and comment lines
+    while (startIndex < lines.length) {
+        const line = lines[startIndex].trim();
+        if (line === '' || line.startsWith('--')) {
+            startIndex++;
+        }
+        else {
+            break;
+        }
+    }
+    return lines.slice(startIndex).join('\n').trim();
+}
+/**
+ * Check if a statement is only comments (no actual SQL).
+ */
+function isCommentOnly(sql) {
+    const stripped = stripLeadingComments(sql);
+    return stripped === '' || stripped.startsWith('--');
+}
+/**
+ * Execute SQL statements from a migration.
+ * Handles multiple statements and makes column additions idempotent.
+ *
+ * @param db - Database instance
+ * @param sql - SQL content to execute
+ */
+function executeMigrationSql(db, sql) {
+    // Split by semicolons
+    const rawStatements = sql.split(';');
+    // Process each statement: trim, strip leading comments, filter out empty/comment-only
+    const statements = rawStatements
+        .map(s => s.trim())
+        .filter(s => s.length > 0 && !isCommentOnly(s));
+    for (const statement of statements) {
+        try {
+            db.exec(statement);
+        }
+        catch (err) {
+            // Check if it's a "duplicate column" error for ALTER TABLE
+            // This makes migrations idempotent for column additions
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            if (errorMessage.includes('duplicate column name')) {
+                // Column already exists, skip this statement
+                continue;
+            }
+            throw err;
+        }
+    }
+}
+/**
+ * Apply all pending migrations to the database.
+ * Migrations are applied in a transaction for atomicity.
+ *
+ * @param db - Database instance
+ * @param migrationsDir - Directory containing SQL migration files
+ * @returns Result containing number of applied migrations and current version
+ * @throws Error if any migration fails (transaction is rolled back)
+ */
+export function applyMigrations(db, migrationsDir) {
+    const currentVersion = getSchemaVersion(db);
+    const migrations = loadMigrations(migrationsDir);
+    const appliedMigrations = [];
+    // Filter to only pending migrations
+    const pendingMigrations = migrations.filter(m => m.version > currentVersion);
+    if (pendingMigrations.length === 0) {
+        return {
+            applied: 0,
+            currentVersion,
+            appliedMigrations: [],
+        };
+    }
+    // Apply each migration in order
+    // Note: We can't use a single transaction for ALTER TABLE in SQLite
+    // as it requires autocommit mode. We apply each migration separately.
+    for (const migration of pendingMigrations) {
+        try {
+            executeMigrationSql(db, migration.sql);
+            // Update schema version after successful migration
+            setSchemaVersion(db, migration.version);
+            appliedMigrations.push(migration.name);
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            throw new Error(`Migration ${migration.version}_${migration.name} failed: ${errorMessage}`);
+        }
+    }
+    const newVersion = getSchemaVersion(db);
+    return {
+        applied: appliedMigrations.length,
+        currentVersion: newVersion,
+        appliedMigrations,
+    };
+}
+/**
+ * Apply migrations up to a specific version.
+ *
+ * @param db - Database instance
+ * @param migrationsDir - Directory containing SQL migration files
+ * @param targetVersion - Maximum version to apply
+ * @returns Result containing number of applied migrations and current version
+ */
+export function applyMigrationsTo(db, migrationsDir, targetVersion) {
+    const currentVersion = getSchemaVersion(db);
+    const migrations = loadMigrations(migrationsDir);
+    const appliedMigrations = [];
+    // Filter to migrations between current and target version
+    const pendingMigrations = migrations.filter(m => m.version > currentVersion && m.version <= targetVersion);
+    if (pendingMigrations.length === 0) {
+        return {
+            applied: 0,
+            currentVersion,
+            appliedMigrations: [],
+        };
+    }
+    for (const migration of pendingMigrations) {
+        try {
+            executeMigrationSql(db, migration.sql);
+            setSchemaVersion(db, migration.version);
+            appliedMigrations.push(migration.name);
+        }
+        catch (err) {
+            const errorMessage = err instanceof Error ? err.message : String(err);
+            throw new Error(`Migration ${migration.version}_${migration.name} failed: ${errorMessage}`);
+        }
+    }
+    const newVersion = getSchemaVersion(db);
+    return {
+        applied: appliedMigrations.length,
+        currentVersion: newVersion,
+        appliedMigrations,
+    };
+}
+/**
+ * Get migration status for the database.
+ *
+ * @param db - Database instance
+ * @param migrationsDir - Directory containing SQL migration files
+ * @returns Object containing version info and pending migrations
+ */
+export function getMigrationStatus(db, migrationsDir) {
+    const currentVersion = getSchemaVersion(db);
+    const migrations = loadMigrations(migrationsDir);
+    const pending = migrations.filter(m => m.version > currentVersion);
+    return {
+        currentVersion,
+        latestVersion: migrations.length > 0 ? migrations[migrations.length - 1].version : 0,
+        pendingCount: pending.length,
+        pendingMigrations: pending.map(m => ({ version: m.version, name: m.name })),
+    };
+}
+//# sourceMappingURL=migrator.js.map

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

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

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

@@ -0,0 +1,101 @@
+/**
+ * SQLite Schema Definitions
+ *
+ * Embeds all migrations as TypeScript code - no external SQL files needed.
+ * This eliminates file path resolution issues and makes migrations part
+ * of the compiled bundle.
+ *
+ * ## Design Principles
+ *
+ * 1. **Migrations as Code**: Each migration is a TypeScript object with
+ *    version, name, and SQL statements. No file I/O at runtime.
+ *
+ * 2. **Idempotent Statements**: Use IF NOT EXISTS and handle duplicate
+ *    column errors gracefully.
+ *
+ * 3. **Feature Detection**: Tables are grouped by feature, allowing
+ *    the store to detect which features are available.
+ */
+import type Database from 'better-sqlite3';
+/**
+ * A schema migration definition.
+ */
+export interface Migration {
+    /** Version number (must be unique and sequential) */
+    version: number;
+    /** Human-readable name */
+    name: string;
+    /** SQL statements to execute (semicolon-separated) */
+    sql: string;
+}
+/**
+ * Result of applying migrations.
+ */
+export interface MigrationResult {
+    applied: number;
+    currentVersion: number;
+    appliedMigrations: string[];
+}
+/**
+ * All schema migrations, embedded as TypeScript code.
+ *
+ * To add a new migration:
+ * 1. Add a new entry with the next version number
+ * 2. Ensure SQL is idempotent (IF NOT EXISTS, etc.)
+ * 3. Run tests to verify migration applies cleanly
+ */
+export declare const MIGRATIONS: Migration[];
+/**
+ * Feature flags based on which tables exist.
+ */
+export interface SchemaFeatures {
+    /** Core tables: sessions, entries, tool_calls, checkpoints */
+    core: boolean;
+    /** Cost tracking: usage_logs + session columns */
+    costs: boolean;
+    /** Session hierarchy: parent/child relationships */
+    hierarchy: boolean;
+    /** Compaction history tracking */
+    compaction: boolean;
+    /** File change tracking for undo */
+    fileChanges: boolean;
+    /** Goal integrity: goals + junctures */
+    goals: boolean;
+    /** Worker result storage: worker_results */
+    workerResults: boolean;
+    /** Pending plans for plan mode: pending_plans */
+    pendingPlans: boolean;
+}
+/**
+ * Check which tables exist in the database.
+ */
+export declare function detectFeatures(db: Database.Database): SchemaFeatures;
+/**
+ * Get current schema version from database.
+ */
+export declare function getSchemaVersion(db: Database.Database): number;
+/**
+ * Set schema version in database.
+ */
+export declare function setSchemaVersion(db: Database.Database, version: number): void;
+/**
+ * Apply all pending migrations to the database.
+ */
+export declare function applyMigrations(db: Database.Database): MigrationResult;
+/**
+ * Get migration status.
+ */
+export declare function getMigrationStatus(db: Database.Database): {
+    currentVersion: number;
+    latestVersion: number;
+    pendingCount: number;
+    pendingMigrations: Array<{
+        version: number;
+        name: string;
+    }>;
+};
+/**
+ * Check if database needs migration.
+ */
+export declare function needsMigration(db: Database.Database): boolean;
+//# sourceMappingURL=schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/persistence/schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,qDAAqD;IACrD,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,sDAAsD;IACtD,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,EAAE,SAAS,EAiPjC,CAAC;AAMF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,8DAA8D;IAC9D,IAAI,EAAE,OAAO,CAAC;IACd,kDAAkD;IAClD,KAAK,EAAE,OAAO,CAAC;IACf,oDAAoD;IACpD,SAAS,EAAE,OAAO,CAAC;IACnB,kCAAkC;IAClC,UAAU,EAAE,OAAO,CAAC;IACpB,oCAAoC;IACpC,WAAW,EAAE,OAAO,CAAC;IACrB,wCAAwC;IACxC,KAAK,EAAE,OAAO,CAAC;IACf,4CAA4C;IAC5C,aAAa,EAAE,OAAO,CAAC;IACvB,iDAAiD;IACjD,YAAY,EAAE,OAAO,CAAC;CACvB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,cAAc,CAkBpE;AAMD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7E;AA8CD;;GAEG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,eAAe,CAqBtE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG;IACzD,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC7D,CAUA;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,OAAO,CAI7D"}