@comfanion/workflow 4.10.0 → 4.11.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@comfanion/workflow",
-  "version": "4.10.0",
+  "version": "4.11.0",
   "description": "Initialize OpenCode Workflow system for AI-assisted development with semantic code search",
   "type": "module",
   "bin": {

package/src/build-info.json

@@ -1,6 +1,6 @@
 {
   "version": "3.0.0",
-  "buildDate": "2026-01-24T09:51:33.276Z",
+  "buildDate": "2026-01-24T10:06:05.371Z",
   "files": [
     "config.yaml",
     "FLOW.yaml",

package/src/opencode/tools/codesearch.ts

@@ -43,6 +43,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
     index: tool.schema.string().optional().default("code").describe("Index to search: code, docs, config, or custom name"),
     limit: tool.schema.number().optional().default(5).describe("Number of results to return (default: 5)"),
     searchAll: tool.schema.boolean().optional().default(false).describe("Search all indexes instead of just one"),
+    freshen: tool.schema.boolean().optional().default(true).describe("Auto-update stale files before searching (default: true)"),
   },
 
   async execute(args, context) {
@@ -65,6 +66,14 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
       const limit = args.limit || 5
       const indexName = args.index || "code"
 
+      // Auto-freshen stale files before searching
+      let freshenStats = { updated: 0 }
+      if (args.freshen !== false) {
+        const tempIndexer = await new CodebaseIndexer(projectRoot, args.index || "code").init()
+        freshenStats = await tempIndexer.freshen()
+        await tempIndexer.unloadModel() // Free memory after freshen
+      }
+
       if (args.searchAll) {
         // Search all indexes
         const tempIndexer = await new CodebaseIndexer(projectRoot, "code").init()
@@ -76,8 +85,12 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
 
         for (const idx of indexes) {
           const indexer = await new CodebaseIndexer(projectRoot, idx).init()
+          if (args.freshen !== false) {
+            await indexer.freshen()
+          }
           const results = await indexer.search(args.query, limit)
           allResults.push(...results.map((r: any) => ({ ...r, _index: idx })))
+          await indexer.unloadModel() // Free memory after each index search
         }
 
         // Sort by distance and take top N
@@ -96,6 +109,7 @@ Prerequisites: Run 'npx @comfanion/workflow index --index <name>' first.`,
         const indexer = await new CodebaseIndexer(projectRoot, indexName).init()
         const results = await indexer.search(args.query, limit)
         allResults = results.map((r: any) => ({ ...r, _index: indexName }))
+        await indexer.unloadModel() // Free memory after search
       }
 
       if (allResults.length === 0) {

package/src/vectorizer/index.js

@@ -196,6 +196,54 @@ class CodebaseIndexer {
     return results;
   }
 
+  /**
+   * Freshen index - check for stale files and reindex only changed ones
+   * Returns { checked, updated, deleted } counts
+   */
+  async freshen() {
+    let checked = 0;
+    let updated = 0;
+    let deleted = 0;
+
+    const indexedFiles = Object.keys(this.hashes);
+    
+    for (const relPath of indexedFiles) {
+      checked++;
+      const filePath = path.join(this.root, relPath);
+      
+      try {
+        const content = await fs.readFile(filePath, 'utf8');
+        const currentHash = this.fileHash(content);
+        
+        if (this.hashes[relPath] !== currentHash) {
+          // File changed - reindex it
+          await this.indexFile(filePath);
+          updated++;
+        }
+      } catch (e) {
+        // File deleted or unreadable - remove from index
+        delete this.hashes[relPath];
+        deleted++;
+      }
+    }
+    
+    if (deleted > 0) {
+      await this.saveHashes();
+    }
+    
+    return { checked, updated, deleted };
+  }
+
+  /**
+   * Index a single file by path (convenience method)
+   */
+  async indexSingleFile(filePath) {
+    const absPath = path.isAbsolute(filePath) 
+      ? filePath 
+      : path.join(this.root, filePath);
+    return await this.indexFile(absPath);
+  }
+
   /**
    * Get indexing statistics for this index
    */