dsh-plugin-codegraph-tree-sitter 0.1.0 → 0.1.1

package/lib/index.d.ts

@@ -44,7 +44,11 @@ export declare const inject: string[];
 export declare const DATABASE_RELATIVE_PATH = ".codegraph/codegraph.db";
 /** Default branded identity this indexer reserves on the seam. */
 export declare const DEFAULT_INDEXER_ID = "codegraph-tree-sitter";
-/** Directory segments never descended into by default. */
+/**
+ * Directory segments never descended into by default. Includes this package's own `.codegraph`
+ * output — without it, a watcher would treat its own `writeGraph()` as an in-scope change and
+ * rebuild forever.
+ */
 export declare const DEFAULT_EXCLUDE: string[];
 /** Default ceiling on a single file's size before it is skipped. */
 export declare const DEFAULT_MAX_FILE_BYTES = 2000000;
@@ -84,8 +88,8 @@ export interface Config {
     concurrency?: number;
     /**
      * Watch the workspace for file changes and refresh the index automatically after a successful
-     * `index()` call establishes a baseline (default false). A caller that never sets this sees no
-     * change from before this option existed — indexing stays purely explicit.
+     * `index()` call establishes a baseline (default true). Set `watch: false` to keep indexing purely
+     * explicit instead.
      *
      * Overridden off by default on a WSL2 kernel watching a path mounted in from the Windows host
      * (`/mnt/<drive>/...`), since inotify does not reliably deliver events over that 9P mount — see

package/lib/index.js

@@ -43,8 +43,12 @@ export const inject = ['codegraph'];
 export const DATABASE_RELATIVE_PATH = '.codegraph/codegraph.db';
 /** Default branded identity this indexer reserves on the seam. */
 export const DEFAULT_INDEXER_ID = 'codegraph-tree-sitter';
-/** Directory segments never descended into by default. */
-export const DEFAULT_EXCLUDE = ['node_modules', 'dist', 'build', 'coverage', '.git'];
+/**
+ * Directory segments never descended into by default. Includes this package's own `.codegraph`
+ * output — without it, a watcher would treat its own `writeGraph()` as an in-scope change and
+ * rebuild forever.
+ */
+export const DEFAULT_EXCLUDE = ['node_modules', 'dist', 'build', 'coverage', '.git', '.codegraph'];
 /** Default ceiling on a single file's size before it is skipped. */
 export const DEFAULT_MAX_FILE_BYTES = 2_000_000;
 /** Default ceiling on how many files one run indexes. */
@@ -63,7 +67,7 @@ export const Config = z.object({
     maxFileBytes: z.number().default(DEFAULT_MAX_FILE_BYTES),
     maxFiles: z.number().default(DEFAULT_MAX_FILES),
     concurrency: z.number().default(DEFAULT_CONCURRENCY),
-    watch: z.boolean().default(false),
+    watch: z.boolean().default(true),
     watchDebounceMs: z.number().default(DEFAULT_WATCH_DEBOUNCE_MS),
     maxWatchedDirectories: z.number().default(DEFAULT_MAX_WATCHED_DIRECTORIES),
 });

package/lib/watcher.js

@@ -275,7 +275,19 @@ export function createWatcher(config, primitive = nodeWatch) {
             syncFailureCount = 0;
             pendingPaths.clear();
             if (process.platform === 'darwin' || process.platform === 'win32') {
+                // Started immediately, unlike the per-directory branch below, because the recursive `fs.watch`
+                // call itself must stay synchronous within start() — nothing here should make callers await a
+                // gitignore read just to get a watch installed. `gitignoreRules` starts empty and is filled in
+                // once the read resolves; every event that arrives before then is a startup-window race no
+                // different in kind from the FSEvents kernel-side warm-up delay already documented above, and
+                // resolves in the time to read one small file, not the time a human takes to edit one.
                 startRecursive();
+                if (config.respectGitignore) {
+                    void loadGitignore(config.root).then(rules => {
+                        if (running)
+                            gitignoreRules = rules;
+                    });
+                }
                 return;
             }
             void (async () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-plugin-codegraph-tree-sitter",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Self-built code-graph indexer for DeepSeek Harness — parses a workspace with web-tree-sitter and writes schema version 4 to .codegraph/codegraph.db, the same on-disk format the codegraph CLI writes, so no external indexer is required",
   "keywords": [
     "dsh",
@@ -51,7 +51,7 @@
     "@deepseek-ai/schemastery": "^3.18.1",
     "tree-sitter-wasms": "^0.1.13",
     "web-tree-sitter": "^0.25.10",
-    "dsh-plugin-codegraph-service": "^0.1.0"
+    "dsh-plugin-codegraph-service": "^0.1.1"
   },
   "peerDependencies": {
     "@deepseek-ai/cordis": ">=4.0.1",