ds4-context-engine 0.1.1 → 0.1.2

package/README.md

@@ -16,7 +16,7 @@ bounded active context with provenance
 Pi provider
 ```
 
-> **Project status:** M0–M13 are implemented. The Pi adapter and standalone `ds4-context-core` package are version `0.1.0`; the adapter targets Pi `0.84.3`.
+> **Project status:** M0–M13 are implemented. The Pi adapter and standalone `ds4-context-core` package are version `0.1.2`; the adapter targets Pi `0.84.3`.
 
 ## Why DS4
 

package/docs/PROJECT_KNOWLEDGE.md

@@ -16,7 +16,9 @@ This is independent of global `project.enabled`: a global setting cannot overrid
 
 ## Discovery and exclusions
 
-When Git is available, discovery combines tracked and non-ignored untracked files under `ctx.cwd`. Outside Git, DS4 walks the project tree deterministically. It never follows symbolic links and rejects paths outside the canonical project root.
+When Git is available, discovery combines tracked and non-ignored untracked files under `ctx.cwd`. Outside Git, DS4 walks the project tree deterministically. Discovery stops as soon as the configured file bound is reached and also bounds visited directories. It never follows symbolic links and rejects paths outside the canonical project root.
+
+DS4 skips project indexing when `ctx.cwd` is the filesystem root or the user's home directory. This prevents a normal Pi launch from recursively scanning an entire drive or user profile; start Pi inside the intended project directory to enable project knowledge.
 
 Default bounds:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ds4-context-engine",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Non-destructive, provider-independent context management for Pi.",
   "type": "module",
   "license": "MIT",
@@ -50,7 +50,7 @@
     ]
   },
   "dependencies": {
-    "ds4-context-core": "0.1.1"
+    "ds4-context-core": "0.1.2"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "0.84.3",

package/src/extension/runtime.ts

@@ -1,6 +1,7 @@
 import { randomUUID } from "node:crypto";
 import { existsSync, realpathSync } from "node:fs";
-import { join, resolve } from "node:path";
+import { homedir } from "node:os";
+import { join, parse, resolve } from "node:path";
 import type {
   Api,
   AssistantMessage,
@@ -118,6 +119,23 @@ export type RuntimePhase = "idle" | "initializing" | "disabled" | "observer" | "
 
 const READ_ONLY_PROJECT_TOOLS = new Set(["read", "grep", "find", "ls"]);
 
+function comparablePath(path: string): string {
+  let canonical: string;
+  try {
+    canonical = realpathSync(path);
+  } catch {
+    canonical = resolve(path);
+  }
+  return process.platform === "win32" ? canonical.toLowerCase() : canonical;
+}
+
+export function isBroadProjectRoot(projectPath: string, homePath = homedir()): boolean {
+  const project = comparablePath(projectPath);
+  const home = comparablePath(homePath);
+  const filesystemRoot = comparablePath(parse(project).root);
+  return project === home || project === filesystemRoot;
+}
+
 export interface RuntimeDependencies {
   agentDir: string;
   configDirName: string;
@@ -1713,6 +1731,23 @@ export class Ds4ContextRuntime {
       );
       return;
     }
+    if (isBroadProjectRoot(ctx.cwd, this.dependencies.homeDir ?? homedir())) {
+      this.lastProject = {
+        ...emptyProjectDiagnostics(
+          "disabled",
+          true,
+          this.config.context.maxProjectTokens,
+          this.config.project.maxResults,
+        ),
+        projectPath: resolve(ctx.cwd),
+        fallbackReason: "Project indexing is skipped for filesystem roots and the user home directory",
+      };
+      this.logger.warn("project_index.skipped", {
+        reason: "broad-root",
+        projectPath: resolve(ctx.cwd),
+      });
+      return;
+    }
     if (!this.database) return;
 
     try {

package/src/pi-adapter/version.ts

@@ -1,4 +1,4 @@
-export const EXTENSION_VERSION = "0.1.0";
+export const EXTENSION_VERSION = "0.1.2";
 export const SUPPORTED_PI_VERSION = "0.84.3";
 export const OBSERVER_PLANNER_VERSION = "observer-model-aware-v1";
 export const PLANNER_VERSION = "managed-native-continuation-v1";