agents-reverse-engineer 0.2.12 → 0.3.0

package/dist/installer/paths.d.ts

@@ -47,4 +47,30 @@ export declare function resolveInstallPath(runtime: Exclude<Runtime, 'all'>, loc
  * @returns Absolute path to the settings file
  */
 export declare function getSettingsPath(runtime: Exclude<Runtime, 'all'>): string;
+/**
+ * Check if a runtime is installed locally in a project.
+ *
+ * Checks for the presence of the local config directory (e.g., .claude, .opencode, .gemini).
+ *
+ * @param runtime - Target runtime (claude, opencode, or gemini)
+ * @param projectRoot - Project root directory to check
+ * @returns True if the runtime's local config directory exists
+ */
+export declare function isRuntimeInstalledLocally(runtime: Exclude<Runtime, 'all'>, projectRoot: string): Promise<boolean>;
+/**
+ * Check if a runtime is installed globally.
+ *
+ * Checks for the presence of the global config directory.
+ *
+ * @param runtime - Target runtime (claude, opencode, or gemini)
+ * @returns True if the runtime's global config directory exists
+ */
+export declare function isRuntimeInstalledGlobally(runtime: Exclude<Runtime, 'all'>): Promise<boolean>;
+/**
+ * Get list of runtimes installed locally in a project.
+ *
+ * @param projectRoot - Project root directory to check
+ * @returns Array of runtime identifiers that are installed locally
+ */
+export declare function getInstalledRuntimes(projectRoot: string): Promise<Array<Exclude<Runtime, 'all'>>>;
 //# sourceMappingURL=paths.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/installer/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAE/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,YAAY,CAmC9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAChC,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,CAExE"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/installer/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAElE;;;;GAIG;AACH,wBAAgB,cAAc,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAE/D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,YAAY,CAmC9E;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAChC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAChC,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,MAAM,GACnB,MAAM,CAUR;AAED;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,CAExE;AAED;;;;;;;;GAQG;AACH,wBAAsB,yBAAyB,CAC7C,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,EAChC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,OAAO,CAAC,CAUlB;AAED;;;;;;;GAOG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;;;;GAKG;AACH,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC,CAWzC"}

package/dist/installer/paths.js

@@ -6,6 +6,7 @@
  */
 import * as os from 'node:os';
 import * as path from 'node:path';
+import { stat } from 'node:fs/promises';
 /**
  * Get all supported runtime identifiers (excludes 'all' meta-runtime)
  *
@@ -92,4 +93,58 @@ export function resolveInstallPath(runtime, location, projectRoot) {
 export function getSettingsPath(runtime) {
     return getRuntimePaths(runtime).settingsFile;
 }
+/**
+ * Check if a runtime is installed locally in a project.
+ *
+ * Checks for the presence of the local config directory (e.g., .claude, .opencode, .gemini).
+ *
+ * @param runtime - Target runtime (claude, opencode, or gemini)
+ * @param projectRoot - Project root directory to check
+ * @returns True if the runtime's local config directory exists
+ */
+export async function isRuntimeInstalledLocally(runtime, projectRoot) {
+    const paths = getRuntimePaths(runtime);
+    const localPath = path.join(projectRoot, paths.local);
+    try {
+        const stats = await stat(localPath);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if a runtime is installed globally.
+ *
+ * Checks for the presence of the global config directory.
+ *
+ * @param runtime - Target runtime (claude, opencode, or gemini)
+ * @returns True if the runtime's global config directory exists
+ */
+export async function isRuntimeInstalledGlobally(runtime) {
+    const paths = getRuntimePaths(runtime);
+    try {
+        const stats = await stat(paths.global);
+        return stats.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get list of runtimes installed locally in a project.
+ *
+ * @param projectRoot - Project root directory to check
+ * @returns Array of runtime identifiers that are installed locally
+ */
+export async function getInstalledRuntimes(projectRoot) {
+    const runtimes = getAllRuntimes();
+    const installed = [];
+    for (const runtime of runtimes) {
+        if (await isRuntimeInstalledLocally(runtime, projectRoot)) {
+            installed.push(runtime);
+        }
+    }
+    return installed;
+}
 //# sourceMappingURL=paths.js.map

package/dist/installer/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/installer/paths.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAGlC;;;;GAIG;AACH,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAC1C,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAE1B,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,gDAAgD;YAChD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/E,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,SAAS;gBAChB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;aACrD,CAAC;QACJ,CAAC;QAED,KAAK,UAAU,CAAC,CAAC,CAAC;YAChB,sEAAsE;YACtE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC5E,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,IAAI,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YACvF,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,WAAW;gBAClB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;aACrD,CAAC;QACJ,CAAC;QAED,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,gDAAgD;YAChD,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;YAC/E,OAAO;gBACL,MAAM,EAAE,UAAU;gBAClB,KAAK,EAAE,SAAS;gBAChB,YAAY,EAAE,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC;aACrD,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAgC,EAChC,QAAkB,EAClB,WAAoB;IAEpB,MAAM,KAAK,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC;IAEvC,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC,MAAM,CAAC;IACtB,CAAC;IAED,qDAAqD;IACrD,MAAM,IAAI,GAAG,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;AACtC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,OAAgC;IAC9D,OAAO,eAAe,CAAC,OAAO,CAAC,CAAC,YAAY,CAAC;AAC/C,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../src/installer/paths.ts"],"names":[],"mappings":"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"}

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

@@ -1 +1 @@
-{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/integration/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA0WtD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAyCxC"}
+{"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/integration/templates.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAkXtD;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,oBAAoB,IAAI,mBAAmB,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,mBAAmB,EAAE,CAE1D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAyCxC"}

package/dist/integration/templates.js

@@ -46,34 +46,42 @@ Read \`.agents-reverse-engineer/GENERATION-PLAN.md\` and find unchecked tasks (\
 
 \`\`\`
 Analyze and document this file:
-1. Read: <file_path>
-2. Generate .sum content following the format below
-3. Write to: <file_path>.sum
-4. Verify: Read back the .sum file to confirm success
-5. Report: "SUCCESS: <file_path>.sum created" or "FAILED: <reason>"
+1. Compute content hash: sha256sum <file_path> | cut -d' ' -f1
+2. Read: <file_path>
+3. Generate .sum content following the format below (include the content_hash)
+4. Write to: <file_path>.sum
+5. Verify: Read back the .sum file to confirm success
+6. Report: "SUCCESS: <file_path>.sum created" or "FAILED: <reason>"
 \`\`\`
 
 ### .sum File Format
 
-\`\`\`
+\`\`\`yaml
 ---
 file_type: <generic|type|config|test|component|service|api|hook|model|schema>
 generated_at: <ISO timestamp>
+content_hash: <SHA-256 hash - compute with: sha256sum <file> | cut -d' ' -f1>
+purpose: <1-2 sentence description of what this file does>
+public_interface: [func1(), func2(), ClassName]
+dependencies: [express, lodash, ./utils]
+patterns: [singleton, factory, observer]
+related_files: [./types.ts, ./utils.ts]
 ---
 
-## Purpose
-<1-2 sentence description of what this file does>
-
-## Public Interface
-<exported functions, classes, types with brief descriptions>
-
-## Dependencies
-<key imports and what they're used for>
-
-## Implementation Notes
-<important patterns, algorithms, or gotchas>
+<Detailed 300-500 word summary covering:
+- What the code does and how it works
+- Key implementation details
+- Important usage patterns
+- Notable edge cases or gotchas>
 \`\`\`
 
+**Field Guidelines:**
+- \`purpose\`: One-line summary (what + why)
+- \`public_interface\`: Exported functions/classes/types
+- \`dependencies\`: External packages and internal imports
+- \`patterns\`: Design patterns used (singleton, factory, etc.)
+- \`related_files\`: Tightly coupled files (optional)
+
 ### After All Files Complete, Generate AGENTS.md (Post-Order Traversal):
 
 Process directories from **deepest to shallowest** so child AGENTS.md files exist before parent directories are documented.

package/dist/integration/templates.js.map

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

package/dist/update/orchestrator.d.ts

@@ -1,5 +1,4 @@
 import type { Config } from '../config/schema.js';
-import type { StateDatabase, RunRecord } from '../state/index.js';
 import { type FileChange } from '../change-detection/index.js';
 import type { UpdateOptions, CleanupResult } from './types.js';
 /**
@@ -14,31 +13,22 @@ export interface UpdatePlan {
     cleanup: CleanupResult;
     /** Directories that need AGENTS.md regeneration */
     affectedDirs: string[];
-    /** Base commit (from last run or initial) */
+    /** Base commit (not used in frontmatter mode, kept for compatibility) */
     baseCommit: string;
     /** Current commit */
     currentCommit: string;
-    /** Whether this is first run (no prior state) */
+    /** Whether this is first run (no .sum files exist) */
     isFirstRun: boolean;
 }
 /**
- * Orchestrates incremental documentation updates.
+ * Orchestrates incremental documentation updates using frontmatter-based change detection.
  */
 export declare class UpdateOrchestrator {
     private config;
     private projectRoot;
-    private db;
     constructor(config: Config, projectRoot: string);
     /**
-     * Get path to state database.
-     */
-    private getDbPath;
-    /**
-     * Ensure state directory exists and open database.
-     */
-    openState(): Promise<StateDatabase>;
-    /**
-     * Close database connection.
+     * Close resources (no-op in frontmatter mode, kept for API compatibility).
      */
     close(): void;
     /**
@@ -47,40 +37,45 @@ export declare class UpdateOrchestrator {
      * @throws Error if not in a git repository
      */
     checkPrerequisites(): Promise<void>;
+    /**
+     * Discover all source files in the project.
+     */
+    private discoverFiles;
     /**
      * Prepare update plan without executing analysis.
      *
+     * Uses frontmatter-based change detection:
+     * - Reads content_hash from each .sum file
+     * - Compares with current file content hash
+     * - Files with mismatched hashes need re-analysis
+     *
      * @param options - Update options
      * @returns Update plan with files to analyze and cleanup actions
      */
     preparePlan(options?: UpdateOptions): Promise<UpdatePlan>;
     /**
-     * Update state for a successfully analyzed file.
-     *
-     * @param relativePath - Relative path to the file
-     * @param contentHash - SHA-256 hash of file content
-     * @param currentCommit - Current git commit hash
+     * Record file analyzed (no-op in frontmatter mode - hash is stored in .sum file).
+     * Kept for API compatibility.
      */
-    recordFileAnalyzed(relativePath: string, contentHash: string, currentCommit: string): Promise<void>;
+    recordFileAnalyzed(_relativePath: string, _contentHash: string, _currentCommit: string): Promise<void>;
     /**
-     * Remove file from state (for deleted files).
+     * Remove file from state (no-op in frontmatter mode).
+     * Kept for API compatibility.
      */
-    removeFileState(relativePath: string): Promise<void>;
+    removeFileState(_relativePath: string): Promise<void>;
     /**
-     * Record a completed update run.
-     *
-     * @param commitHash - Git commit hash at completion
-     * @param filesAnalyzed - Number of files analyzed
-     * @param filesSkipped - Number of files skipped
-     * @returns Run ID
+     * Record a completed update run (no-op in frontmatter mode).
+     * Kept for API compatibility.
      */
-    recordRun(commitHash: string, filesAnalyzed: number, filesSkipped: number): Promise<number>;
+    recordRun(_commitHash: string, _filesAnalyzed: number, _filesSkipped: number): Promise<number>;
     /**
-     * Get last run information.
+     * Get last run information (not available in frontmatter mode).
+     * Kept for API compatibility.
      */
-    getLastRun(): Promise<RunRecord | undefined>;
+    getLastRun(): Promise<undefined>;
     /**
-     * Check if this is the first run (no prior state).
+     * Check if this is the first run.
+     * In frontmatter mode, checks if any .sum files exist.
      */
     isFirstRun(): Promise<boolean>;
 }

package/dist/update/orchestrator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/update/orchestrator.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,KAAK,EAAE,aAAa,EAAc,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAE9E,OAAO,EAKL,KAAK,UAAU,EAChB,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACd,MAAM,YAAY,CAAC;AAOpB;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,sDAAsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uCAAuC;IACvC,OAAO,EAAE,aAAa,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,6CAA6C;IAC7C,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,iDAAiD;IACjD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,EAAE,CAA8B;gBAE5B,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK/C;;OAEG;IACH,OAAO,CAAC,SAAS;IAIjB;;OAEG;IACG,SAAS,IAAI,OAAO,CAAC,aAAa,CAAC;IAWzC;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUzC;;;;;OAKG;IACG,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAuFnE;;;;;;OAMG;IACG,kBAAkB,CACtB,YAAY,EAAE,MAAM,EACpB,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,IAAI,CAAC;IAUhB;;OAEG;IACG,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAK1D;;;;;;;OAOG;IACG,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,CAAC;IAUlB;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC;IAKlD;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;CAIrC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAEpB"}
+{"version":3,"file":"orchestrator.d.ts","sourceRoot":"","sources":["../../src/update/orchestrator.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAU/D;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,2CAA2C;IAC3C,cAAc,EAAE,UAAU,EAAE,CAAC;IAC7B,sDAAsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,uCAAuC;IACvC,OAAO,EAAE,aAAa,CAAC;IACvB,mDAAmD;IACnD,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,yEAAyE;IACzE,UAAU,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,UAAU,EAAE,OAAO,CAAC;CACrB;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAS;gBAEhB,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAK/C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;IACG,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAUzC;;OAEG;YACW,aAAa;IAsB3B;;;;;;;;;;OAUG;IACG,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAyEnE;;;OAGG;IACG,kBAAkB,CACtB,aAAa,EAAE,MAAM,EACrB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,IAAI,CAAC;IAIhB;;;OAGG;IACG,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D;;;OAGG;IACG,SAAS,CACb,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,MAAM,CAAC;IAKlB;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,SAAS,CAAC;IAKtC;;;OAGG;IACG,UAAU,IAAI,OAAO,CAAC,OAAO,CAAC;CAIrC;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,EAAE,MAAM,EACd,WAAW,EAAE,MAAM,GAClB,kBAAkB,CAEpB"}

package/dist/update/orchestrator.js

@@ -1,61 +1,35 @@
 /**
  * Update orchestrator
  *
- * Coordinates incremental documentation updates:
+ * Coordinates incremental documentation updates using frontmatter-based change detection:
  * 1. Check git repository status
- * 2. Get last run from state database
- * 3. Detect changed files since last run
+ * 2. Scan for existing .sum files
+ * 3. Compare content hashes from frontmatter with current file hashes
  * 4. Clean up orphaned .sum files
  * 5. Prepare analysis tasks for changed files
  * 6. Track affected directories for AGENTS.md regeneration
- * 7. Persist new state after successful completion
  */
 import * as path from 'node:path';
-import { mkdir } from 'node:fs/promises';
-import { openDatabase } from '../state/index.js';
-import { isGitRepo, getCurrentCommit, getChangedFiles, computeContentHash, } from '../change-detection/index.js';
+import { isGitRepo, getCurrentCommit, computeContentHash, } from '../change-detection/index.js';
 import { cleanupOrphans, getAffectedDirectories } from './orphan-cleaner.js';
-/** State directory name (relative to project root) */
-const STATE_DIR = '.agents-reverse-engineer';
-/** State database filename */
-const STATE_DB = 'state.db';
+import { readSumFile, getSumPath } from '../generation/writers/sum.js';
+import { walkDirectory } from '../discovery/walker.js';
+import { applyFilters, createGitignoreFilter, createVendorFilter, createBinaryFilter, createCustomFilter, } from '../discovery/filters/index.js';
 /**
- * Orchestrates incremental documentation updates.
+ * Orchestrates incremental documentation updates using frontmatter-based change detection.
  */
 export class UpdateOrchestrator {
     config;
     projectRoot;
-    db = null;
     constructor(config, projectRoot) {
         this.config = config;
         this.projectRoot = projectRoot;
     }
     /**
-     * Get path to state database.
-     */
-    getDbPath() {
-        return path.join(this.projectRoot, STATE_DIR, STATE_DB);
-    }
-    /**
-     * Ensure state directory exists and open database.
-     */
-    async openState() {
-        if (this.db)
-            return this.db;
-        // Ensure state directory exists
-        const stateDir = path.join(this.projectRoot, STATE_DIR);
-        await mkdir(stateDir, { recursive: true });
-        this.db = openDatabase(this.getDbPath());
-        return this.db;
-    }
-    /**
-     * Close database connection.
+     * Close resources (no-op in frontmatter mode, kept for API compatibility).
      */
     close() {
-        if (this.db) {
-            this.db.close();
-            this.db = null;
-        }
+        // No database to close in frontmatter mode
     }
     /**
      * Check prerequisites for update.
@@ -69,130 +43,133 @@ export class UpdateOrchestrator {
                 'The update command requires a git repository for change detection.');
         }
     }
+    /**
+     * Discover all source files in the project.
+     */
+    async discoverFiles() {
+        // Create filters
+        const gitignoreFilter = await createGitignoreFilter(this.projectRoot);
+        const vendorFilter = createVendorFilter(this.config.exclude.vendorDirs);
+        const binaryFilter = createBinaryFilter({
+            maxFileSize: this.config.options.maxFileSize,
+            additionalExtensions: this.config.exclude.binaryExtensions,
+        });
+        const customFilter = createCustomFilter(this.config.exclude.patterns, this.projectRoot);
+        const filters = [gitignoreFilter, vendorFilter, binaryFilter, customFilter];
+        // Walk directory
+        const files = await walkDirectory({
+            cwd: this.projectRoot,
+            followSymlinks: this.config.options.followSymlinks,
+        });
+        // Apply filters
+        const filterResult = await applyFilters(files, filters);
+        return filterResult.included;
+    }
     /**
      * Prepare update plan without executing analysis.
      *
+     * Uses frontmatter-based change detection:
+     * - Reads content_hash from each .sum file
+     * - Compares with current file content hash
+     * - Files with mismatched hashes need re-analysis
+     *
      * @param options - Update options
      * @returns Update plan with files to analyze and cleanup actions
      */
     async preparePlan(options = {}) {
         await this.checkPrerequisites();
-        const db = await this.openState();
-        // Get current commit
+        // Get current commit for reference
         const currentCommit = await getCurrentCommit(this.projectRoot);
-        // Get last run to determine base commit
-        const lastRun = db.getLastRun();
-        const isFirstRun = !lastRun;
-        const baseCommit = lastRun?.commit_hash ?? currentCommit;
-        // If first run or same commit, no committed changes
-        let changes = [];
-        if (!isFirstRun && baseCommit !== currentCommit) {
-            const result = await getChangedFiles(this.projectRoot, baseCommit, { includeUncommitted: options.includeUncommitted });
-            changes = result.changes;
-        }
-        else if (options.includeUncommitted) {
-            // Even if no committed changes, check uncommitted
-            const result = await getChangedFiles(this.projectRoot, currentCommit, // Use current as base (no committed diff)
-            { includeUncommitted: true });
-            changes = result.changes;
-        }
-        // Separate files by status for different handling
-        const filesToAnalyze = changes.filter(c => c.status === 'added' || c.status === 'modified' || c.status === 'renamed');
-        const deletedOrRenamed = changes.filter(c => c.status === 'deleted' || c.status === 'renamed');
-        // Filter out files that haven't actually changed (content hash match)
-        const actuallyChanged = [];
+        // Discover all source files
+        const allFiles = await this.discoverFiles();
+        const filesToAnalyze = [];
         const filesToSkip = [];
-        for (const change of filesToAnalyze) {
-            if (change.status === 'added') {
-                // New files are always analyzed
-                actuallyChanged.push(change);
-            }
-            else {
-                // For modified/renamed, check content hash
-                const filePath = path.join(this.projectRoot, change.path);
-                try {
-                    const currentHash = await computeContentHash(filePath);
-                    const stored = db.getFile(change.path);
-                    if (!stored || stored.content_hash !== currentHash) {
-                        actuallyChanged.push(change);
-                    }
-                    else {
-                        filesToSkip.push(change.path);
-                    }
+        const deletedOrRenamed = [];
+        // Track which .sum files we've seen (to detect orphans)
+        const seenSumFiles = new Set();
+        // Check each file against its .sum file
+        for (const relativePath of allFiles) {
+            const filePath = path.join(this.projectRoot, relativePath);
+            const sumPath = getSumPath(filePath);
+            seenSumFiles.add(sumPath);
+            try {
+                // Read existing .sum file
+                const sumContent = await readSumFile(sumPath);
+                if (!sumContent) {
+                    // No .sum file exists - file needs analysis
+                    filesToAnalyze.push({ path: relativePath, status: 'added' });
+                    continue;
+                }
+                // Compare content hashes
+                const currentHash = await computeContentHash(filePath);
+                const storedHash = sumContent.contentHash;
+                if (!storedHash || storedHash !== currentHash) {
+                    // Hash mismatch or no hash stored - file needs re-analysis
+                    filesToAnalyze.push({ path: relativePath, status: 'modified' });
                 }
-                catch {
-                    // File can't be read - skip it
-                    filesToSkip.push(change.path);
+                else {
+                    // Hash matches - skip this file
+                    filesToSkip.push(relativePath);
                 }
             }
+            catch {
+                // Error reading file - skip it
+                filesToSkip.push(relativePath);
+            }
         }
-        // Cleanup orphans (deleted and renamed old paths)
+        // Cleanup orphans (deleted files whose .sum files still exist)
         const cleanup = await cleanupOrphans(this.projectRoot, deletedOrRenamed, options.dryRun ?? false);
         // Get directories affected by changes (for AGENTS.md regeneration)
-        const affectedDirs = Array.from(getAffectedDirectories(actuallyChanged));
+        const affectedDirs = Array.from(getAffectedDirectories(filesToAnalyze));
+        // Determine if this is first run (no files to skip means no existing .sum files)
+        const isFirstRun = filesToSkip.length === 0 && filesToAnalyze.length > 0;
         return {
-            filesToAnalyze: actuallyChanged,
+            filesToAnalyze,
             filesToSkip,
             cleanup,
             affectedDirs,
-            baseCommit,
+            baseCommit: currentCommit, // Not used in frontmatter mode
             currentCommit,
             isFirstRun,
         };
     }
     /**
-     * Update state for a successfully analyzed file.
-     *
-     * @param relativePath - Relative path to the file
-     * @param contentHash - SHA-256 hash of file content
-     * @param currentCommit - Current git commit hash
+     * Record file analyzed (no-op in frontmatter mode - hash is stored in .sum file).
+     * Kept for API compatibility.
      */
-    async recordFileAnalyzed(relativePath, contentHash, currentCommit) {
-        const db = await this.openState();
-        db.upsertFile({
-            path: relativePath,
-            content_hash: contentHash,
-            sum_generated_at: new Date().toISOString(),
-            last_analyzed_commit: currentCommit,
-        });
+    async recordFileAnalyzed(_relativePath, _contentHash, _currentCommit) {
+        // No-op: content hash is stored in .sum file frontmatter
     }
     /**
-     * Remove file from state (for deleted files).
+     * Remove file from state (no-op in frontmatter mode).
+     * Kept for API compatibility.
      */
-    async removeFileState(relativePath) {
-        const db = await this.openState();
-        db.deleteFile(relativePath);
+    async removeFileState(_relativePath) {
+        // No-op: .sum file cleanup is handled separately
     }
     /**
-     * Record a completed update run.
-     *
-     * @param commitHash - Git commit hash at completion
-     * @param filesAnalyzed - Number of files analyzed
-     * @param filesSkipped - Number of files skipped
-     * @returns Run ID
+     * Record a completed update run (no-op in frontmatter mode).
+     * Kept for API compatibility.
      */
-    async recordRun(commitHash, filesAnalyzed, filesSkipped) {
-        const db = await this.openState();
-        return db.insertRun({
-            commit_hash: commitHash,
-            completed_at: new Date().toISOString(),
-            files_analyzed: filesAnalyzed,
-            files_skipped: filesSkipped,
-        });
+    async recordRun(_commitHash, _filesAnalyzed, _filesSkipped) {
+        // No-op: no run history in frontmatter mode
+        return 0;
     }
     /**
-     * Get last run information.
+     * Get last run information (not available in frontmatter mode).
+     * Kept for API compatibility.
      */
     async getLastRun() {
-        const db = await this.openState();
-        return db.getLastRun();
+        // No run history in frontmatter mode
+        return undefined;
     }
     /**
-     * Check if this is the first run (no prior state).
+     * Check if this is the first run.
+     * In frontmatter mode, checks if any .sum files exist.
      */
     async isFirstRun() {
-        const db = await this.openState();
-        return !db.getLastRun();
+        const plan = await this.preparePlan({ dryRun: true });
+        return plan.isFirstRun;
     }
 }
 /**