@huanlin/dsh-plugin-codegraph-sqlite 0.1.8 → 0.1.9

package/lib/database.d.ts

@@ -41,9 +41,9 @@ export declare function databasePath(projectRoot: string): string;
 export declare function openGraph(projectRoot: string): DatabaseSync;
 /**
  * A bounded set of open graph connections keyed by project root, evicting the least recently used
- * one when full. Every connection the pool hands out stays valid until {@link close}: eviction and
- * disposal both close connections, so a caller holds a connection only for the duration of one
- * synchronous query.
+ * one when full. Every connection the pool hands out stays valid until it is closed: eviction,
+ * {@link release}, and disposal all close connections, so a caller holds a connection only for the
+ * duration of one synchronous query.
  *
  * A connection is opened against one specific on-disk file. An indexing run replaces that file
  * wholesale (rename over the old path), and POSIX unlink semantics mean an already-open read-only
@@ -67,6 +67,16 @@ export declare class GraphPool {
      * @returns the open, version-checked connection, current as of this call.
      */
     acquire(projectRoot: string): DatabaseSync;
+    /**
+     * Close and forget the connection cached for `projectRoot`, when one is held. The store calls
+     * this before an indexing run replaces the graph file: Windows refuses that replace while the
+     * pooled read-only connection keeps the old file open — SQLite opens its files without
+     * `FILE_SHARE_DELETE` — and without this step every later rebuild would fail EPERM on a rename
+     * the pool's own connection alone caused. The next {@link acquire} simply opens fresh, which is
+     * also how it picks up the rebuilt graph.
+     * @param projectRoot - absolute path of the project root whose connection to close.
+     */
+    release(projectRoot: string): void;
     /** Close every open connection; further {@link acquire} calls fail as `CODEGRAPH_DISPOSED`. */
     close(): void;
     /** Close least-recently-used connections until the pool fits its capacity. */

package/lib/database.js

@@ -101,9 +101,9 @@ export function openGraph(projectRoot) {
 }
 /**
  * A bounded set of open graph connections keyed by project root, evicting the least recently used
- * one when full. Every connection the pool hands out stays valid until {@link close}: eviction and
- * disposal both close connections, so a caller holds a connection only for the duration of one
- * synchronous query.
+ * one when full. Every connection the pool hands out stays valid until it is closed: eviction,
+ * {@link release}, and disposal all close connections, so a caller holds a connection only for the
+ * duration of one synchronous query.
  *
  * A connection is opened against one specific on-disk file. An indexing run replaces that file
  * wholesale (rename over the old path), and POSIX unlink semantics mean an already-open read-only
@@ -157,6 +157,22 @@ export class GraphPool {
         this.evictOverflow();
         return db;
     }
+    /**
+     * Close and forget the connection cached for `projectRoot`, when one is held. The store calls
+     * this before an indexing run replaces the graph file: Windows refuses that replace while the
+     * pooled read-only connection keeps the old file open — SQLite opens its files without
+     * `FILE_SHARE_DELETE` — and without this step every later rebuild would fail EPERM on a rename
+     * the pool's own connection alone caused. The next {@link acquire} simply opens fresh, which is
+     * also how it picks up the rebuilt graph.
+     * @param projectRoot - absolute path of the project root whose connection to close.
+     */
+    release(projectRoot) {
+        const cached = this.open.get(projectRoot);
+        if (cached === undefined)
+            return;
+        cached.db.close();
+        this.open.delete(projectRoot);
+    }
     /** Close every open connection; further {@link acquire} calls fail as `CODEGRAPH_DISPOSED`. */
     close() {
         this.disposed = true;

package/lib/index.js

@@ -70,6 +70,9 @@ export function apply(ctx, config) {
         query(request) {
             return Promise.resolve(run(pool, resolved, request));
         },
+        release(projectRoot) {
+            pool.release(projectRoot);
+        },
     };
     ctx.effect(function* () {
         // Registered first, so it disposes LAST: the store unregisters before its connections close,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huanlin/dsh-plugin-codegraph-sqlite",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "description": "Read-only SQLite store for the DeepSeek Harness code-graph seam — serves structural queries from the schema-v4 graph at .codegraph/codegraph.db, the same on-disk format the codegraph CLI writes",
   "keywords": [
     "dsh",
@@ -42,7 +42,7 @@
   },
   "dependencies": {
     "@deepseek-ai/schemastery": "^3.18.1",
-    "@huanlin/dsh-plugin-codegraph-service": "^0.1.8"
+    "@huanlin/dsh-plugin-codegraph-service": "^0.1.9"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",