agents-reverse-engineer 0.1.1

package/dist/integration/templates.js

@@ -0,0 +1,203 @@
+/**
+ * Template generators for AI coding assistant integration files
+ *
+ * Generates command file templates for Claude Code, OpenCode, and session hooks.
+ */
+/**
+ * Get Claude Code command file templates
+ *
+ * Returns templates for:
+ * - generate.md: Full documentation generation command
+ * - update.md: Incremental documentation update command
+ * - init.md: Initialize agents-reverse-engineer in a project
+ *
+ * @returns Array of Claude Code command templates
+ */
+export function getClaudeTemplates() {
+    return [
+        {
+            filename: 'generate.md',
+            path: '.claude/commands/are/generate.md',
+            content: `---
+name: are:generate
+description: Generate AI-friendly documentation for the entire codebase
+argument-hint: "[--budget N] [--dry-run] [--verbose]"
+---
+
+Generate comprehensive documentation for this codebase using agents-reverse-engineer.
+
+<execution>
+Run the agents-reverse-engineer generate command:
+
+\`\`\`bash
+npx are generate $ARGUMENTS
+\`\`\`
+
+After completion, summarize:
+- Number of files analyzed
+- Token budget used
+- Any files skipped due to budget
+- Location of generated CLAUDE.md and AGENTS.md files
+
+If budget concerns arise, suggest \`--budget N\` to adjust.
+</execution>
+`,
+        },
+        {
+            filename: 'update.md',
+            path: '.claude/commands/are/update.md',
+            content: `---
+name: are:update
+description: Incrementally update documentation for changed files
+argument-hint: "[--uncommitted] [--dry-run] [--verbose]"
+---
+
+Update documentation for files that changed since last run.
+
+<execution>
+Run the agents-reverse-engineer update command:
+
+\`\`\`bash
+npx are update $ARGUMENTS
+\`\`\`
+
+After completion, summarize:
+- Files updated
+- Files unchanged
+- Any orphaned docs cleaned up
+
+Use \`--uncommitted\` to include staged but uncommitted changes.
+</execution>
+`,
+        },
+        {
+            filename: 'init.md',
+            path: '.claude/commands/are/init.md',
+            content: `---
+name: are:init
+description: Initialize agents-reverse-engineer configuration and integration
+argument-hint: "[--integration]"
+---
+
+Initialize agents-reverse-engineer in this project.
+
+<execution>
+Run the agents-reverse-engineer init command:
+
+\`\`\`bash
+npx are init $ARGUMENTS
+\`\`\`
+
+This creates:
+- \`.agents-reverse-engineer.yaml\` configuration file
+- With \`--integration\`: command files for detected AI assistants
+</execution>
+`,
+        },
+    ];
+}
+/**
+ * Get OpenCode command file templates
+ *
+ * Returns templates for:
+ * - are-generate.md: Full documentation generation command
+ * - are-update.md: Incremental documentation update command
+ *
+ * @returns Array of OpenCode command templates
+ */
+export function getOpenCodeTemplates() {
+    return [
+        {
+            filename: 'are-generate.md',
+            path: '.opencode/commands/are-generate.md',
+            content: `---
+description: Generate AI-friendly documentation for the entire codebase
+agent: build
+---
+
+Generate comprehensive documentation for this codebase using agents-reverse-engineer.
+
+Run: \`npx are generate $ARGUMENTS\`
+
+Arguments supported:
+- \`--budget N\` - Override token budget
+- \`--dry-run\` - Show plan without writing files
+- \`--verbose\` - Show detailed output
+`,
+        },
+        {
+            filename: 'are-update.md',
+            path: '.opencode/commands/are-update.md',
+            content: `---
+description: Incrementally update documentation for changed files
+agent: build
+---
+
+Update documentation for files that changed since last run.
+
+Run: \`npx are update $ARGUMENTS\`
+
+Arguments supported:
+- \`--uncommitted\` - Include staged but uncommitted changes
+- \`--dry-run\` - Show plan without writing files
+- \`--verbose\` - Show detailed output
+`,
+        },
+    ];
+}
+/**
+ * Get session-end hook template for automatic documentation updates
+ *
+ * The hook:
+ * - Checks ARE_DISABLE_HOOK env var for temporary disable
+ * - Checks config file for permanent disable (hook_enabled: false)
+ * - Checks git status and exits silently if no changes
+ * - Spawns are update --quiet in background (detached, unref'd)
+ *
+ * Uses CommonJS (require) since hooks run via node directly.
+ *
+ * @returns JavaScript hook code as a string
+ */
+export function getHookTemplate() {
+    return `#!/usr/bin/env node
+// .claude/hooks/are-session-end.js
+// Triggers are update when session ends (if there are uncommitted changes)
+
+const { execSync, spawn } = require('child_process');
+const fs = require('fs');
+
+// Check for disable flag
+if (process.env.ARE_DISABLE_HOOK === '1') {
+  process.exit(0);
+}
+
+// Check config file for permanent disable
+const configPath = '.agents-reverse-engineer.yaml';
+if (fs.existsSync(configPath)) {
+  const config = fs.readFileSync(configPath, 'utf-8');
+  if (config.includes('hook_enabled: false')) {
+    process.exit(0);
+  }
+}
+
+// Check git status - skip if no changes
+try {
+  const status = execSync('git status --porcelain', { encoding: 'utf-8' });
+  if (!status.trim()) {
+    // No changes since last run - exit silently
+    process.exit(0);
+  }
+} catch {
+  // Not a git repo or git not available - exit silently
+  process.exit(0);
+}
+
+// Run update in background (don't block session close)
+const child = spawn('npx', ['are', 'update', '--quiet'], {
+  stdio: 'ignore',
+  detached: true,
+});
+child.unref();
+`;
+}
+//# sourceMappingURL=templates.js.map

package/dist/integration/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/integration/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO;QACL;YACE,QAAQ,EAAE,aAAa;YACvB,IAAI,EAAE,kCAAkC;YACxC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;;CAuBd;SACI;QACD;YACE,QAAQ,EAAE,WAAW;YACrB,IAAI,EAAE,gCAAgC;YACtC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;;;;CAsBd;SACI;QACD;YACE,QAAQ,EAAE,SAAS;YACnB,IAAI,EAAE,8BAA8B;YACpC,OAAO,EAAE;;;;;;;;;;;;;;;;;;;CAmBd;SACI;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,oBAAoB;IAClC,OAAO;QACL;YACE,QAAQ,EAAE,iBAAiB;YAC3B,IAAI,EAAE,oCAAoC;YAC1C,OAAO,EAAE;;;;;;;;;;;;;CAad;SACI;QACD;YACE,QAAQ,EAAE,eAAe;YACzB,IAAI,EAAE,kCAAkC;YACxC,OAAO,EAAE;;;;;;;;;;;;;CAad;SACI;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe;IAC7B,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAuCR,CAAC;AACF,CAAC"}

package/dist/integration/types.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Integration types for AI coding assistant environments
+ *
+ * Defines types for detecting AI assistant environments (Claude Code, OpenCode, etc.)
+ * and generating appropriate integration templates (command files, hooks).
+ */
+/**
+ * Supported AI coding assistant environment types
+ */
+export type EnvironmentType = 'claude' | 'opencode' | 'aider';
+/**
+ * Result of detecting an AI coding assistant environment
+ */
+export interface DetectedEnvironment {
+    /** Type of AI assistant detected */
+    type: EnvironmentType;
+    /** Configuration directory for this environment (e.g., '.claude', '.opencode') */
+    configDir: string;
+    /** Whether this environment was detected in the project */
+    detected: boolean;
+}
+/**
+ * Template for integration files (command files, hooks, etc.)
+ */
+export interface IntegrationTemplate {
+    /** File name (e.g., 'generate.md') */
+    filename: string;
+    /** Relative path from project root (e.g., '.claude/commands/ar/generate.md') */
+    path: string;
+    /** Template content to write to the file */
+    content: string;
+}
+/**
+ * Result of generating integration files for an environment
+ */
+export interface IntegrationResult {
+    /** Environment type that was configured */
+    environment: EnvironmentType;
+    /** Files that were successfully created */
+    filesCreated: string[];
+    /** Files that were skipped (already exist) */
+    filesSkipped: string[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/integration/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/integration/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,UAAU,GAAG,OAAO,CAAC;AAE9D;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,oCAAoC;IACpC,IAAI,EAAE,eAAe,CAAC;IACtB,kFAAkF;IAClF,SAAS,EAAE,MAAM,CAAC;IAClB,2DAA2D;IAC3D,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,gFAAgF;IAChF,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,WAAW,EAAE,eAAe,CAAC;IAC7B,2CAA2C;IAC3C,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB"}

package/dist/integration/types.js

@@ -0,0 +1,8 @@
+/**
+ * Integration types for AI coding assistant environments
+ *
+ * Defines types for detecting AI assistant environments (Claude Code, OpenCode, etc.)
+ * and generating appropriate integration templates (command files, hooks).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/integration/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/integration/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/output/logger.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Terminal logger for agents-reverse
+ *
+ * Provides colored output with verbose/quiet modes.
+ * Output format follows CONTEXT.md human-readable specification.
+ */
+/**
+ * Logger interface for discovery output.
+ *
+ * All methods respect the configured verbosity levels.
+ */
+export interface Logger {
+    /** Log an informational message */
+    info(message: string): void;
+    /** Log a discovered file (verbose mode only) */
+    file(path: string): void;
+    /** Log an excluded file (--show-excluded mode only) */
+    excluded(path: string, reason: string, filter: string): void;
+    /** Log discovery summary (always shown unless quiet) */
+    summary(included: number, excluded: number): void;
+    /** Log a warning message */
+    warn(message: string): void;
+    /** Log an error message (always shown) */
+    error(message: string): void;
+}
+/**
+ * Options for creating a logger instance.
+ */
+export interface LoggerOptions {
+    /**
+     * Show verbose output (each file as discovered).
+     * @default true per CONTEXT.md
+     */
+    verbose: boolean;
+    /**
+     * Suppress all output except errors.
+     * @default false
+     */
+    quiet: boolean;
+    /**
+     * Use colors in terminal output.
+     * @default true
+     */
+    colors: boolean;
+    /**
+     * Show each excluded file (with --show-excluded flag).
+     * @default false
+     */
+    showExcluded: boolean;
+}
+/**
+ * Create a logger instance with the given options.
+ *
+ * Output format per CONTEXT.md (human-readable):
+ * - file: green "  +" prefix + relative path
+ * - excluded: dim "  -" prefix + path + reason (when shown)
+ * - summary: bold count + dim excluded count
+ * - warn: yellow "Warning:" prefix
+ * - error: red "Error:" prefix
+ *
+ * @param options - Logger configuration
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const log = createLogger({
+ *   verbose: true,
+ *   quiet: false,
+ *   colors: true,
+ *   showExcluded: false,
+ * });
+ *
+ * log.file('src/index.ts');
+ * log.summary(42, 10);
+ * ```
+ */
+export declare function createLogger(options: LoggerOptions): Logger;
+/**
+ * Create a silent logger that produces no output.
+ *
+ * Useful for testing or programmatic usage.
+ *
+ * @returns Logger instance with all no-op methods
+ */
+export declare function createSilentLogger(): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/output/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/output/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH;;;;GAIG;AACH,MAAM,WAAW,MAAM;IACrB,mCAAmC;IACnC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,gDAAgD;IAChD,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB,uDAAuD;IACvD,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAE7D,wDAAwD;IACxD,OAAO,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAElD,4BAA4B;IAC5B,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAE5B,0CAA0C;IAC1C,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;;OAGG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AA6BD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CA0C3D;AAED;;;;;;GAMG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAU3C"}

package/dist/output/logger.js

@@ -0,0 +1,107 @@
+/**
+ * Terminal logger for agents-reverse
+ *
+ * Provides colored output with verbose/quiet modes.
+ * Output format follows CONTEXT.md human-readable specification.
+ */
+import pc from 'picocolors';
+/**
+ * Identity function for no-color mode
+ */
+const identity = (s) => s;
+/**
+ * No-color formatter that returns strings unchanged
+ */
+const noColor = {
+    green: identity,
+    dim: identity,
+    red: identity,
+    bold: identity,
+    yellow: identity,
+};
+/**
+ * Create a logger instance with the given options.
+ *
+ * Output format per CONTEXT.md (human-readable):
+ * - file: green "  +" prefix + relative path
+ * - excluded: dim "  -" prefix + path + reason (when shown)
+ * - summary: bold count + dim excluded count
+ * - warn: yellow "Warning:" prefix
+ * - error: red "Error:" prefix
+ *
+ * @param options - Logger configuration
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const log = createLogger({
+ *   verbose: true,
+ *   quiet: false,
+ *   colors: true,
+ *   showExcluded: false,
+ * });
+ *
+ * log.file('src/index.ts');
+ * log.summary(42, 10);
+ * ```
+ */
+export function createLogger(options) {
+    const { verbose, quiet, colors, showExcluded } = options;
+    // Select color functions based on colors option
+    const c = colors ? pc : noColor;
+    return {
+        info(message) {
+            if (quiet)
+                return;
+            console.log(message);
+        },
+        file(path) {
+            if (quiet)
+                return;
+            if (!verbose)
+                return;
+            console.log(c.green('  +') + ' ' + path);
+        },
+        excluded(path, reason, filter) {
+            if (quiet)
+                return;
+            if (!showExcluded)
+                return;
+            console.log(c.dim('  -') + ' ' + path + c.dim(` (${reason}: ${filter})`));
+        },
+        summary(included, excluded) {
+            if (quiet)
+                return;
+            console.log(c.bold(`\nDiscovered ${included} files`) +
+                c.dim(` (${excluded} excluded)`));
+        },
+        warn(message) {
+            if (quiet)
+                return;
+            console.warn(c.yellow('Warning: ') + message);
+        },
+        error(message) {
+            // Error is always shown, even in quiet mode
+            console.error(c.red('Error: ') + message);
+        },
+    };
+}
+/**
+ * Create a silent logger that produces no output.
+ *
+ * Useful for testing or programmatic usage.
+ *
+ * @returns Logger instance with all no-op methods
+ */
+export function createSilentLogger() {
+    const noop = () => { };
+    return {
+        info: noop,
+        file: noop,
+        excluded: noop,
+        summary: noop,
+        warn: noop,
+        error: noop,
+    };
+}
+//# sourceMappingURL=logger.js.map

package/dist/output/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/output/logger.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAmE5B;;GAEG;AACH,MAAM,QAAQ,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC;AAE1C;;GAEG;AACH,MAAM,OAAO,GAAmB;IAC9B,KAAK,EAAE,QAAQ;IACf,GAAG,EAAE,QAAQ;IACb,GAAG,EAAE,QAAQ;IACb,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE,QAAQ;CACjB,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,YAAY,CAAC,OAAsB;IACjD,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,OAAO,CAAC;IAEzD,gDAAgD;IAChD,MAAM,CAAC,GAAmB,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC;IAEhD,OAAO;QACL,IAAI,CAAC,OAAe;YAClB,IAAI,KAAK;gBAAE,OAAO;YAClB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvB,CAAC;QAED,IAAI,CAAC,IAAY;YACf,IAAI,KAAK;gBAAE,OAAO;YAClB,IAAI,CAAC,OAAO;gBAAE,OAAO;YACrB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC;QAC3C,CAAC;QAED,QAAQ,CAAC,IAAY,EAAE,MAAc,EAAE,MAAc;YACnD,IAAI,KAAK;gBAAE,OAAO;YAClB,IAAI,CAAC,YAAY;gBAAE,OAAO;YAC1B,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,CAAC,KAAK,MAAM,KAAK,MAAM,GAAG,CAAC,CAAC,CAAC;QAC5E,CAAC;QAED,OAAO,CAAC,QAAgB,EAAE,QAAgB;YACxC,IAAI,KAAK;gBAAE,OAAO;YAClB,OAAO,CAAC,GAAG,CACT,CAAC,CAAC,IAAI,CAAC,gBAAgB,QAAQ,QAAQ,CAAC;gBACtC,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,YAAY,CAAC,CACnC,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,OAAe;YAClB,IAAI,KAAK;gBAAE,OAAO;YAClB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,GAAG,OAAO,CAAC,CAAC;QAChD,CAAC;QAED,KAAK,CAAC,OAAe;YACnB,4CAA4C;YAC5C,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,CAAC;QAC5C,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,kBAAkB;IAChC,MAAM,IAAI,GAAG,GAAS,EAAE,GAAE,CAAC,CAAC;IAC5B,OAAO;QACL,IAAI,EAAE,IAAI;QACV,IAAI,EAAE,IAAI;QACV,QAAQ,EAAE,IAAI;QACd,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,IAAI;QACV,KAAK,EAAE,IAAI;KACZ,CAAC;AACJ,CAAC"}

package/dist/state/database.d.ts

@@ -0,0 +1,9 @@
+import type { StateDatabase } from './types.js';
+/**
+ * Opens the state database, applying migrations if needed.
+ * Uses WAL mode for performance.
+ *
+ * @param dbPath - Path to the SQLite database file
+ */
+export declare function openDatabase(dbPath: string): StateDatabase;
+//# sourceMappingURL=database.d.ts.map

package/dist/state/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../../src/state/database.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAyB,aAAa,EAAE,MAAM,YAAY,CAAC;AAGvE;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CAuF1D"}

package/dist/state/database.js

@@ -0,0 +1,66 @@
+/**
+ * SQLite state database with prepared statements
+ */
+import Database from 'better-sqlite3';
+import { CURRENT_SCHEMA_VERSION, migrateSchema } from './migrations.js';
+/**
+ * Opens the state database, applying migrations if needed.
+ * Uses WAL mode for performance.
+ *
+ * @param dbPath - Path to the SQLite database file
+ */
+export function openDatabase(dbPath) {
+    const db = new Database(dbPath);
+    // Enable WAL mode for better concurrent read performance
+    db.pragma('journal_mode = WAL');
+    // Check and apply migrations
+    const version = db.pragma('user_version', { simple: true });
+    if (version < CURRENT_SCHEMA_VERSION) {
+        migrateSchema(db, version, CURRENT_SCHEMA_VERSION);
+    }
+    // Prepared statements for performance
+    const getFileStmt = db.prepare('SELECT path, content_hash, sum_generated_at, last_analyzed_commit FROM files WHERE path = ?');
+    const upsertFileStmt = db.prepare(`
+    INSERT INTO files (path, content_hash, sum_generated_at, last_analyzed_commit)
+    VALUES (?, ?, ?, ?)
+    ON CONFLICT(path) DO UPDATE SET
+      content_hash = excluded.content_hash,
+      sum_generated_at = excluded.sum_generated_at,
+      last_analyzed_commit = excluded.last_analyzed_commit
+  `);
+    const deleteFileStmt = db.prepare('DELETE FROM files WHERE path = ?');
+    const getAllFilesStmt = db.prepare('SELECT path, content_hash, sum_generated_at, last_analyzed_commit FROM files');
+    const getLastRunStmt = db.prepare('SELECT id, commit_hash, completed_at, files_analyzed, files_skipped FROM runs ORDER BY id DESC LIMIT 1');
+    const insertRunStmt = db.prepare(`
+    INSERT INTO runs (commit_hash, completed_at, files_analyzed, files_skipped)
+    VALUES (?, ?, ?, ?)
+  `);
+    return {
+        getFile(path) {
+            return getFileStmt.get(path);
+        },
+        upsertFile(record) {
+            upsertFileStmt.run(record.path, record.content_hash, record.sum_generated_at, record.last_analyzed_commit);
+        },
+        deleteFile(path) {
+            deleteFileStmt.run(path);
+        },
+        getAllFiles() {
+            return getAllFilesStmt.all();
+        },
+        getLastRun() {
+            return getLastRunStmt.get();
+        },
+        insertRun(run) {
+            const result = insertRunStmt.run(run.commit_hash, run.completed_at, run.files_analyzed, run.files_skipped);
+            return Number(result.lastInsertRowid);
+        },
+        close() {
+            db.close();
+        },
+        getDb() {
+            return db;
+        },
+    };
+}
+//# sourceMappingURL=database.js.map

package/dist/state/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../../src/state/database.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAEtC,OAAO,EAAE,sBAAsB,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAExE;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,MAAM,EAAE,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,CAAC;IAEhC,yDAAyD;IACzD,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC,CAAC;IAEhC,6BAA6B;IAC7B,MAAM,OAAO,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAW,CAAC;IACtE,IAAI,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACrC,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE,sBAAsB,CAAC,CAAC;IACrD,CAAC;IAED,sCAAsC;IACtC,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAC5B,6FAA6F,CAC9F,CAAC;IAEF,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAAiD;;;;;;;GAOjF,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAC/B,kCAAkC,CACnC,CAAC;IAEF,MAAM,eAAe,GAAG,EAAE,CAAC,OAAO,CAChC,8EAA8E,CAC/E,CAAC;IAEF,MAAM,cAAc,GAAG,EAAE,CAAC,OAAO,CAC/B,wGAAwG,CACzG,CAAC;IAEF,MAAM,aAAa,GAAG,EAAE,CAAC,OAAO,CAAmC;;;GAGlE,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,CAAC,IAAY;YAClB,OAAO,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC/B,CAAC;QAED,UAAU,CAAC,MAAkB;YAC3B,cAAc,CAAC,GAAG,CAChB,MAAM,CAAC,IAAI,EACX,MAAM,CAAC,YAAY,EACnB,MAAM,CAAC,gBAAgB,EACvB,MAAM,CAAC,oBAAoB,CAC5B,CAAC;QACJ,CAAC;QAED,UAAU,CAAC,IAAY;YACrB,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,WAAW;YACT,OAAO,eAAe,CAAC,GAAG,EAAE,CAAC;QAC/B,CAAC;QAED,UAAU;YACR,OAAO,cAAc,CAAC,GAAG,EAAE,CAAC;QAC9B,CAAC;QAED,SAAS,CAAC,GAA0B;YAClC,MAAM,MAAM,GAAG,aAAa,CAAC,GAAG,CAC9B,GAAG,CAAC,WAAW,EACf,GAAG,CAAC,YAAY,EAChB,GAAG,CAAC,cAAc,EAClB,GAAG,CAAC,aAAa,CAClB,CAAC;YACF,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,CAAC,CAAC;QACxC,CAAC;QAED,KAAK;YACH,EAAE,CAAC,KAAK,EAAE,CAAC;QACb,CAAC;QAED,KAAK;YACH,OAAO,EAAE,CAAC;QACZ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/state/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * State management module
+ *
+ * Provides SQLite-based state persistence for tracking file generation.
+ */
+export { openDatabase } from './database.js';
+export type { FileRecord, RunRecord, StateDatabase } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/state/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAC7C,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/state/index.js

@@ -0,0 +1,7 @@
+/**
+ * State management module
+ *
+ * Provides SQLite-based state persistence for tracking file generation.
+ */
+export { openDatabase } from './database.js';
+//# sourceMappingURL=index.js.map

package/dist/state/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/state/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC"}

package/dist/state/migrations.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Schema migrations using SQLite user_version pragma
+ */
+import type Database from 'better-sqlite3';
+/** Current schema version */
+export declare const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Apply schema migrations from `fromVersion` to `toVersion`.
+ * Uses transaction for atomicity.
+ */
+export declare function migrateSchema(db: Database.Database, fromVersion: number, toVersion: number): void;
+//# sourceMappingURL=migrations.d.ts.map

package/dist/state/migrations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.d.ts","sourceRoot":"","sources":["../../src/state/migrations.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAE3C,6BAA6B;AAC7B,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;GAGG;AACH,wBAAgB,aAAa,CAC3B,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,IAAI,CAoCN"}

package/dist/state/migrations.js

@@ -0,0 +1,39 @@
+/** Current schema version */
+export const CURRENT_SCHEMA_VERSION = 1;
+/**
+ * Apply schema migrations from `fromVersion` to `toVersion`.
+ * Uses transaction for atomicity.
+ */
+export function migrateSchema(db, fromVersion, toVersion) {
+    const migrate = db.transaction(() => {
+        if (fromVersion < 1) {
+            // Initial schema
+            db.exec(`
+        CREATE TABLE files (
+          path TEXT PRIMARY KEY,
+          content_hash TEXT NOT NULL,
+          sum_generated_at TEXT,
+          last_analyzed_commit TEXT
+        )
+      `);
+            db.exec(`
+        CREATE TABLE runs (
+          id INTEGER PRIMARY KEY AUTOINCREMENT,
+          commit_hash TEXT NOT NULL,
+          completed_at TEXT NOT NULL,
+          files_analyzed INTEGER NOT NULL,
+          files_skipped INTEGER NOT NULL
+        )
+      `);
+            // Index for faster queries by commit
+            db.exec(`
+        CREATE INDEX idx_runs_commit ON runs(commit_hash)
+      `);
+        }
+        // Future migrations would go here:
+        // if (fromVersion < 2) { ... }
+        db.pragma(`user_version = ${toVersion}`);
+    });
+    migrate();
+}
+//# sourceMappingURL=migrations.js.map

package/dist/state/migrations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrations.js","sourceRoot":"","sources":["../../src/state/migrations.ts"],"names":[],"mappings":"AAKA,6BAA6B;AAC7B,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,CAAC;AAExC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAC3B,EAAqB,EACrB,WAAmB,EACnB,SAAiB;IAEjB,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE;QAClC,IAAI,WAAW,GAAG,CAAC,EAAE,CAAC;YACpB,iBAAiB;YACjB,EAAE,CAAC,IAAI,CAAC;;;;;;;OAOP,CAAC,CAAC;YAEH,EAAE,CAAC,IAAI,CAAC;;;;;;;;OAQP,CAAC,CAAC;YAEH,qCAAqC;YACrC,EAAE,CAAC,IAAI,CAAC;;OAEP,CAAC,CAAC;QACL,CAAC;QAED,mCAAmC;QACnC,+BAA+B;QAE/B,EAAE,CAAC,MAAM,CAAC,kBAAkB,SAAS,EAAE,CAAC,CAAC;IAC3C,CAAC,CAAC,CAAC;IAEH,OAAO,EAAE,CAAC;AACZ,CAAC"}