@huanlin/dsh-plugin-codegraph-service 0.1.8 → 0.1.10

package/lib/index.d.ts

@@ -64,6 +64,13 @@ export declare class Codegraph extends Service implements CodegraphService {
     registerIndexer(provider: CodegraphIndexer): () => void;
     available(projectRoot: string, signal?: AbortSignal): Promise<boolean>;
     index(projectRoot: string, signal?: AbortSignal): Promise<CodegraphIndexReport>;
+    /**
+     * Close every open connection the registered stores keep for `projectRoot`. A store that keeps
+     * none — or none for this root — contributes nothing; the seam never fails a caller because one
+     * store had nothing to release.
+     * @param projectRoot - absolute path of the project root whose readers to release.
+     */
+    release(projectRoot: string): void;
     query<R extends CodegraphRequest>(request: R, signal?: AbortSignal): Promise<CodegraphResultFor<R>>;
     /**
      * The one store that indexes `projectRoot`. Every registered store is asked concurrently, so the

package/lib/index.js

@@ -161,9 +161,25 @@ export class Codegraph extends Service {
         return claims.some(Boolean);
     }
     async index(projectRoot, signal) {
+        // The run replaces the graph file by renaming the rebuilt one over it, and Windows refuses
+        // that rename while any reader in this process still holds the old file open — so every
+        // store's connections for this root are closed before the indexer starts. On POSIX the close
+        // is unobservable; on Windows it is the difference between a rebuild that lands and one that
+        // fails EPERM on every attempt for as long as the process lives.
+        this.release(projectRoot);
         const indexer = await this.selectIndexer(projectRoot, signal);
         return indexer.index(projectRoot, signal);
     }
+    /**
+     * Close every open connection the registered stores keep for `projectRoot`. A store that keeps
+     * none — or none for this root — contributes nothing; the seam never fails a caller because one
+     * store had nothing to release.
+     * @param projectRoot - absolute path of the project root whose readers to release.
+     */
+    release(projectRoot) {
+        for (const store of this.stores.values())
+            store.release?.(projectRoot);
+    }
     async query(request, signal) {
         return (await this.select(request.projectRoot, signal)).query(request, signal);
     }

package/lib/types.d.ts

@@ -352,6 +352,17 @@ export interface CodegraphStoreProvider {
      * @returns the result member matching `request.operation`.
      */
     query<R extends CodegraphRequest>(request: R, signal?: AbortSignal): Promise<CodegraphResultFor<R>>;
+    /**
+     * Close every open connection this store keeps for `projectRoot`. An indexing run replaces the
+     * graph file by renaming the rebuilt one over it, and Windows refuses that rename while any
+     * handle in this process still holds the old file open — an open read-only connection is exactly
+     * such a handle — so {@link CodegraphService.index} asks every store to release the root's
+     * readers before the indexer runs. On POSIX the rename succeeds regardless, and releasing early
+     * merely makes the next query reopen promptly. Optional: a store that keeps no connections has
+     * nothing to release.
+     * @param projectRoot - absolute path of the project root whose connections to close.
+     */
+    release?(projectRoot: string): void;
 }
 /** What one indexing run produced, returned to the caller that requested it. */
 export interface CodegraphIndexReport {
@@ -438,6 +449,14 @@ export interface CodegraphService {
      * @returns the report the indexer produced.
      */
     index(projectRoot: string, signal?: AbortSignal): Promise<CodegraphIndexReport>;
+    /**
+     * Close every open connection the registered stores keep for `projectRoot`. This is the step an
+     * indexing run needs before replacing the graph file — Windows refuses the replace while any
+     * reader in this process holds the old file open — and it is the seam's job, not an indexer's,
+     * because which stores hold readers is a registry fact an indexer must not need to know.
+     * @param projectRoot - absolute path of the project root whose readers to release.
+     */
+    release(projectRoot: string): void;
     /**
      * Route one query to the store that indexes `request.projectRoot`.
      * @param request - the normalized query.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@huanlin/dsh-plugin-codegraph-service",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Service Definition for the DeepSeek Harness code-graph capability seam (ctx.codegraph): a graph-store and graph-indexer provider registry with per-query, order-independent selection over eight normalized structural queries",
   "keywords": [
     "dsh",
@@ -43,11 +43,11 @@
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",
     "@deepseek-ai/dsh-brand": ">=0.1.0-rc.6",
-    "@deepseek-ai/dsh-llm": ">=0.1.2-rc.1"
+    "@deepseek-ai/dsh-llm": ">=0.1.5-rc.1"
   },
   "devDependencies": {
     "@deepseek-ai/cordis": "^4.0.1",
-    "@deepseek-ai/dsh-brand": "0.1.2-rc.1",
-    "@deepseek-ai/dsh-llm": "0.1.2-rc.1"
+    "@deepseek-ai/dsh-brand": "0.1.5-rc.1",
+    "@deepseek-ai/dsh-llm": "0.1.5-rc.1"
   }
 }