attocode 0.1.0

package/dist/src/paths.d.ts

@@ -0,0 +1,101 @@
+/**
+ * XDG Base Directory compliant paths for attocode.
+ *
+ * This module follows the XDG Base Directory Specification for storing
+ * application files in appropriate locations:
+ *
+ * - Config: ~/.config/attocode/ (or $XDG_CONFIG_HOME/attocode/)
+ *   User-specific configuration files
+ *
+ * - Data: ~/.local/share/attocode/ (or $XDG_DATA_HOME/attocode/)
+ *   User-specific data files (databases, persistent storage)
+ *
+ * - State: ~/.local/state/attocode/ (or $XDG_STATE_HOME/attocode/)
+ *   User-specific state files (history, logs, runtime state)
+ *
+ * - Cache: ~/.cache/attocode/ (or $XDG_CACHE_HOME/attocode/)
+ *   User-specific non-essential cached data
+ *
+ * - Project: .attocode/
+ *   Project-specific files in the current working directory
+ *
+ * @see https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
+ */
+/**
+ * Get the configuration directory path.
+ * Uses $XDG_CONFIG_HOME if set, otherwise defaults to ~/.config/attocode/
+ *
+ * @returns Absolute path to the configuration directory
+ */
+export declare function getConfigDir(): string;
+/**
+ * Get the data directory path.
+ * Uses $XDG_DATA_HOME if set, otherwise defaults to ~/.local/share/attocode/
+ *
+ * @returns Absolute path to the data directory
+ */
+export declare function getDataDir(): string;
+/**
+ * Get the state directory path.
+ * Uses $XDG_STATE_HOME if set, otherwise defaults to ~/.local/state/attocode/
+ *
+ * @returns Absolute path to the state directory
+ */
+export declare function getStateDir(): string;
+/**
+ * Get the cache directory path.
+ * Uses $XDG_CACHE_HOME if set, otherwise defaults to ~/.cache/attocode/
+ *
+ * @returns Absolute path to the cache directory
+ */
+export declare function getCacheDir(): string;
+/**
+ * Get the project-specific directory path.
+ * This is always .attocode/ within the specified working directory.
+ *
+ * @param cwd - The working directory (defaults to process.cwd())
+ * @returns Absolute path to the project directory
+ */
+export declare function getProjectDir(cwd?: string): string;
+/**
+ * Get the path to the main configuration file.
+ *
+ * @returns Absolute path to config.json
+ */
+export declare function getConfigPath(): string;
+/**
+ * Get the path to the sessions database.
+ *
+ * @returns Absolute path to sessions.db
+ */
+export declare function getSessionsDbPath(): string;
+/**
+ * Get the path to the command history file.
+ *
+ * @returns Absolute path to history file
+ */
+export declare function getHistoryPath(): string;
+/**
+ * Get the path to the global rules file.
+ *
+ * @returns Absolute path to rules.md
+ */
+export declare function getGlobalRulesPath(): string;
+/**
+ * Get the hierarchical MCP config paths.
+ * Returns paths in order of precedence (later overrides earlier):
+ * 1. Global user config: ~/.config/attocode/mcp.json
+ * 2. Workspace config: ./.mcp.json
+ *
+ * @param cwd - The working directory (defaults to process.cwd())
+ * @returns Array of config paths to check (in order of precedence)
+ */
+export declare function getMCPConfigPaths(cwd?: string): string[];
+/**
+ * Ensure all XDG directories exist.
+ * Creates config, data, state, and cache directories if they don't exist.
+ *
+ * @returns Promise that resolves when all directories are created
+ */
+export declare function ensureDirectories(): Promise<void>;
+//# sourceMappingURL=paths.d.ts.map

package/dist/src/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;GAKG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAGrC;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAKpC;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,IAAI,MAAM,CAGpC;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,CAEjE;AAMD;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAE3C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,GAAE,MAAsB,GAAG,MAAM,EAAE,CAKvE;AAMD;;;;;GAKG;AACH,wBAAsB,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC,CAQvD"}

package/dist/src/paths.js

@@ -0,0 +1,148 @@
+/**
+ * XDG Base Directory compliant paths for attocode.
+ *
+ * This module follows the XDG Base Directory Specification for storing
+ * application files in appropriate locations:
+ *
+ * - Config: ~/.config/attocode/ (or $XDG_CONFIG_HOME/attocode/)
+ *   User-specific configuration files
+ *
+ * - Data: ~/.local/share/attocode/ (or $XDG_DATA_HOME/attocode/)
+ *   User-specific data files (databases, persistent storage)
+ *
+ * - State: ~/.local/state/attocode/ (or $XDG_STATE_HOME/attocode/)
+ *   User-specific state files (history, logs, runtime state)
+ *
+ * - Cache: ~/.cache/attocode/ (or $XDG_CACHE_HOME/attocode/)
+ *   User-specific non-essential cached data
+ *
+ * - Project: .attocode/
+ *   Project-specific files in the current working directory
+ *
+ * @see https://specifications.freedesktop.org/basedir-spec/basedir-spec-latest.html
+ */
+import { homedir } from 'os';
+import { join } from 'path';
+/**
+ * Get the configuration directory path.
+ * Uses $XDG_CONFIG_HOME if set, otherwise defaults to ~/.config/attocode/
+ *
+ * @returns Absolute path to the configuration directory
+ */
+export function getConfigDir() {
+    const xdg = process.env.XDG_CONFIG_HOME;
+    return xdg ? join(xdg, 'attocode') : join(homedir(), '.config', 'attocode');
+}
+/**
+ * Get the data directory path.
+ * Uses $XDG_DATA_HOME if set, otherwise defaults to ~/.local/share/attocode/
+ *
+ * @returns Absolute path to the data directory
+ */
+export function getDataDir() {
+    const xdg = process.env.XDG_DATA_HOME;
+    return xdg
+        ? join(xdg, 'attocode')
+        : join(homedir(), '.local', 'share', 'attocode');
+}
+/**
+ * Get the state directory path.
+ * Uses $XDG_STATE_HOME if set, otherwise defaults to ~/.local/state/attocode/
+ *
+ * @returns Absolute path to the state directory
+ */
+export function getStateDir() {
+    const xdg = process.env.XDG_STATE_HOME;
+    return xdg
+        ? join(xdg, 'attocode')
+        : join(homedir(), '.local', 'state', 'attocode');
+}
+/**
+ * Get the cache directory path.
+ * Uses $XDG_CACHE_HOME if set, otherwise defaults to ~/.cache/attocode/
+ *
+ * @returns Absolute path to the cache directory
+ */
+export function getCacheDir() {
+    const xdg = process.env.XDG_CACHE_HOME;
+    return xdg ? join(xdg, 'attocode') : join(homedir(), '.cache', 'attocode');
+}
+/**
+ * Get the project-specific directory path.
+ * This is always .attocode/ within the specified working directory.
+ *
+ * @param cwd - The working directory (defaults to process.cwd())
+ * @returns Absolute path to the project directory
+ */
+export function getProjectDir(cwd = process.cwd()) {
+    return join(cwd, '.attocode');
+}
+// ============================================================================
+// Specific file paths
+// ============================================================================
+/**
+ * Get the path to the main configuration file.
+ *
+ * @returns Absolute path to config.json
+ */
+export function getConfigPath() {
+    return join(getConfigDir(), 'config.json');
+}
+/**
+ * Get the path to the sessions database.
+ *
+ * @returns Absolute path to sessions.db
+ */
+export function getSessionsDbPath() {
+    return join(getDataDir(), 'sessions.db');
+}
+/**
+ * Get the path to the command history file.
+ *
+ * @returns Absolute path to history file
+ */
+export function getHistoryPath() {
+    return join(getStateDir(), 'history');
+}
+/**
+ * Get the path to the global rules file.
+ *
+ * @returns Absolute path to rules.md
+ */
+export function getGlobalRulesPath() {
+    return join(getConfigDir(), 'rules.md');
+}
+/**
+ * Get the hierarchical MCP config paths.
+ * Returns paths in order of precedence (later overrides earlier):
+ * 1. Global user config: ~/.config/attocode/mcp.json
+ * 2. Workspace config: ./.mcp.json
+ *
+ * @param cwd - The working directory (defaults to process.cwd())
+ * @returns Array of config paths to check (in order of precedence)
+ */
+export function getMCPConfigPaths(cwd = process.cwd()) {
+    return [
+        join(getConfigDir(), 'mcp.json'), // Global user config
+        join(cwd, '.mcp.json'), // Workspace-specific
+    ];
+}
+// ============================================================================
+// Directory management
+// ============================================================================
+/**
+ * Ensure all XDG directories exist.
+ * Creates config, data, state, and cache directories if they don't exist.
+ *
+ * @returns Promise that resolves when all directories are created
+ */
+export async function ensureDirectories() {
+    const { mkdir } = await import('fs/promises');
+    await Promise.all([
+        mkdir(getConfigDir(), { recursive: true }),
+        mkdir(getDataDir(), { recursive: true }),
+        mkdir(getStateDir(), { recursive: true }),
+        mkdir(getCacheDir(), { recursive: true }),
+    ]);
+}
+//# sourceMappingURL=paths.js.map

package/dist/src/paths.js.map

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

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

@@ -0,0 +1,38 @@
+/**
+ * Persistence Module
+ *
+ * Provides schema migration and database management utilities
+ * for SQLite-based session storage.
+ *
+ * ## New Embedded Migration System
+ *
+ * Migrations are now embedded directly in TypeScript code, eliminating
+ * the need for external SQL files and file path resolution issues.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { applyMigrations, needsMigration, getMigrationStatus } from './persistence/index.js';
+ *
+ * const db = new Database('sessions.db');
+ *
+ * // Check and apply pending migrations (no path needed!)
+ * if (needsMigration(db)) {
+ *   const result = applyMigrations(db);
+ *   console.log(`Applied ${result.applied} migrations, now at version ${result.currentVersion}`);
+ * }
+ *
+ * // Get detailed status
+ * const status = getMigrationStatus(db);
+ * console.log(`Current: v${status.currentVersion}, Latest: v${status.latestVersion}`);
+ *
+ * // Check which features are available
+ * const features = detectFeatures(db);
+ * if (features.goals) {
+ *   console.log('Goal tracking is available!');
+ * }
+ * ```
+ */
+export { type Migration, type MigrationResult, type SchemaFeatures, MIGRATIONS, getSchemaVersion, setSchemaVersion, needsMigration, applyMigrations, getMigrationStatus, detectFeatures, } from './schema.js';
+export { type MigrationFile, loadMigrations, getPendingMigrations, applyMigrationsTo, applyMigrations as applyFileMigrations, getMigrationStatus as getFileMigrationStatus, needsMigration as fileNeedsMigration, } from './migrator.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/persistence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAGH,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,eAAe,EACpB,KAAK,cAAc,EAEnB,UAAU,EAEV,gBAAgB,EAChB,gBAAgB,EAEhB,cAAc,EACd,eAAe,EACf,kBAAkB,EAElB,cAAc,GACf,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,KAAK,aAAa,EAClB,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,IAAI,mBAAmB,EACtC,kBAAkB,IAAI,sBAAsB,EAC5C,cAAc,IAAI,kBAAkB,GACrC,MAAM,eAAe,CAAC"}

package/dist/src/persistence/index.js

@@ -0,0 +1,48 @@
+/**
+ * Persistence Module
+ *
+ * Provides schema migration and database management utilities
+ * for SQLite-based session storage.
+ *
+ * ## New Embedded Migration System
+ *
+ * Migrations are now embedded directly in TypeScript code, eliminating
+ * the need for external SQL files and file path resolution issues.
+ *
+ * @example
+ * ```typescript
+ * import Database from 'better-sqlite3';
+ * import { applyMigrations, needsMigration, getMigrationStatus } from './persistence/index.js';
+ *
+ * const db = new Database('sessions.db');
+ *
+ * // Check and apply pending migrations (no path needed!)
+ * if (needsMigration(db)) {
+ *   const result = applyMigrations(db);
+ *   console.log(`Applied ${result.applied} migrations, now at version ${result.currentVersion}`);
+ * }
+ *
+ * // Get detailed status
+ * const status = getMigrationStatus(db);
+ * console.log(`Current: v${status.currentVersion}, Latest: v${status.latestVersion}`);
+ *
+ * // Check which features are available
+ * const features = detectFeatures(db);
+ * if (features.goals) {
+ *   console.log('Goal tracking is available!');
+ * }
+ * ```
+ */
+// New embedded migration system
+export { 
+// Embedded migrations
+MIGRATIONS, 
+// Version management
+getSchemaVersion, setSchemaVersion, 
+// Migration execution
+needsMigration, applyMigrations, getMigrationStatus, 
+// Feature detection
+detectFeatures, } from './schema.js';
+// Legacy file-based migrator (for backwards compatibility with external migrations)
+export { loadMigrations, getPendingMigrations, applyMigrationsTo, applyMigrations as applyFileMigrations, getMigrationStatus as getFileMigrationStatus, needsMigration as fileNeedsMigration, } from './migrator.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/persistence/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AAEH,gCAAgC;AAChC,OAAO;AAKL,sBAAsB;AACtB,UAAU;AACV,qBAAqB;AACrB,gBAAgB,EAChB,gBAAgB;AAChB,sBAAsB;AACtB,cAAc,EACd,eAAe,EACf,kBAAkB;AAClB,oBAAoB;AACpB,cAAc,GACf,MAAM,aAAa,CAAC;AAErB,oFAAoF;AACpF,OAAO,EAEL,cAAc,EACd,oBAAoB,EACpB,iBAAiB,EACjB,eAAe,IAAI,mBAAmB,EACtC,kBAAkB,IAAI,sBAAsB,EAC5C,cAAc,IAAI,kBAAkB,GACrC,MAAM,eAAe,CAAC"}

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

@@ -0,0 +1,135 @@
+/**
+ * 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 Database from 'better-sqlite3';
+/**
+ * Represents a parsed migration file.
+ */
+export interface MigrationFile {
+    /** Migration version number (extracted from filename) */
+    version: number;
+    /** Human-readable migration name */
+    name: string;
+    /** SQL content to execute */
+    sql: string;
+}
+/**
+ * Result of applying migrations.
+ */
+export interface MigrationResult {
+    /** Number of migrations applied */
+    applied: number;
+    /** Current schema version after migration */
+    currentVersion: number;
+    /** List of applied migration names */
+    appliedMigrations: string[];
+}
+/**
+ * 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 declare function getSchemaVersion(db: Database.Database): number;
+/**
+ * Set the schema version in the database.
+ * Uses SQLite's PRAGMA user_version.
+ *
+ * @param db - Database instance
+ * @param version - Version number to set
+ */
+export declare function setSchemaVersion(db: Database.Database, version: number): void;
+/**
+ * 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 declare function loadMigrations(dir: string): MigrationFile[];
+/**
+ * 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 declare function needsMigration(db: Database.Database, migrationsDir: string): boolean;
+/**
+ * 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 declare function getPendingMigrations(db: Database.Database, migrationsDir: string): MigrationFile[];
+/**
+ * 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 declare function applyMigrations(db: Database.Database, migrationsDir: string): MigrationResult;
+/**
+ * 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 declare function applyMigrationsTo(db: Database.Database, migrationsDir: string, targetVersion: number): MigrationResult;
+/**
+ * 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 declare function getMigrationStatus(db: Database.Database, migrationsDir: string): {
+    currentVersion: number;
+    latestVersion: number;
+    pendingCount: number;
+    pendingMigrations: Array<{
+        version: number;
+        name: string;
+    }>;
+};
+//# sourceMappingURL=migrator.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"migrator.d.ts","sourceRoot":"","sources":["../../../src/persistence/migrator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAQtC;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,GAAG,EAAE,MAAM,CAAC;CACb;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,6CAA6C;IAC7C,cAAc,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAMD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,GAAG,MAAM,CAG9D;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAE7E;AAuBD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,EAAE,CA6B3D;AAMD;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAQpF;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,aAAa,EAAE,CAKlG;AA+DD;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG,eAAe,CAyC7F;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAC/B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,aAAa,EAAE,MAAM,EACrB,aAAa,EAAE,MAAM,GACpB,eAAe,CAuCjB;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EAAE,aAAa,EAAE,MAAM,GAAG;IAChF,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,CAWA"}