@cortexkit/aft-opencode 0.26.1 → 0.26.2

package/dist/index.js

@@ -9382,15 +9382,6 @@ import { homedir as homedir3 } from "os";
 var DEFAULT_IDLE_TIMEOUT_MS = Infinity;
 var DEFAULT_MAX_POOL_SIZE = 8;
 var CLEANUP_INTERVAL_MS = 60 * 1000;
-
-class HomeProjectRootError extends Error {
-  projectRoot;
-  constructor(projectRoot) {
-    super(`aft refuses to spawn a bridge with project_root=${projectRoot} (user home directory). ` + `Open OpenCode/Pi from a project subdirectory instead, or set the session's ` + `directory to a real project root.`);
-    this.projectRoot = projectRoot;
-    this.name = "HomeProjectRootError";
-  }
-}
 function canonicalHomeDir() {
   try {
     const home = homedir3();
@@ -9453,9 +9444,6 @@ class BridgePool {
   }
   getBridge(projectRoot) {
     const key = normalizeKey(projectRoot);
-    if (isHomeDirectoryRoot(key)) {
-      throw new HomeProjectRootError(key);
-    }
     const existing = this.bridges.get(key);
     if (existing) {
       existing.lastUsed = Date.now();
@@ -9613,6 +9601,21 @@ function copyToVersionedCache(npmBinaryPath, knownVersion) {
 function normalizeBareVersion(version) {
   return version.startsWith("v") ? version.slice(1) : version;
 }
+function homeDirFromEnv(env) {
+  return (process.platform === "win32" ? env.USERPROFILE || env.HOME : env.HOME) || homedir4();
+}
+function cacheDirFromEnv(env) {
+  if (process.platform === "win32") {
+    const base2 = env.LOCALAPPDATA || env.APPDATA || join4(homeDirFromEnv(env), "AppData", "Local");
+    return join4(base2, "aft", "bin");
+  }
+  const base = env.XDG_CACHE_HOME || join4(homeDirFromEnv(env), ".cache");
+  return join4(base, "aft", "bin");
+}
+function cachedBinaryPathFromEnv(version, env, ext) {
+  const binaryPath = join4(cacheDirFromEnv(env), version, `aft${ext}`);
+  return existsSync3(binaryPath) ? binaryPath : null;
+}
 function isExpectedCachedBinary(binaryPath, expectedVersion) {
   const expected = normalizeBareVersion(expectedVersion);
   const actual = readBinaryVersion(binaryPath);
@@ -9634,6 +9637,7 @@ function platformKey(platform = process.platform, arch = process.arch) {
 }
 function findBinarySync(expectedVersion) {
   const ext = process.platform === "win32" ? ".exe" : "";
+  const env = { ...process.env };
   const pluginVersion = expectedVersion ?? (() => {
     try {
       const req = createRequire(import.meta.url);
@@ -9644,7 +9648,7 @@ function findBinarySync(expectedVersion) {
   })();
   if (pluginVersion) {
     const tag = pluginVersion.startsWith("v") ? pluginVersion : `v${pluginVersion}`;
-    const versionCached = getCachedBinaryPath(tag);
+    const versionCached = cachedBinaryPathFromEnv(tag, env, ext);
     if (versionCached && isExpectedCachedBinary(versionCached, pluginVersion))
       return versionCached;
   }
@@ -9669,12 +9673,13 @@ function findBinarySync(expectedVersion) {
     const whichCmd = process.platform === "win32" ? "where aft" : "which aft";
     const result = execSync(whichCmd, {
       encoding: "utf-8",
+      env,
       stdio: ["pipe", "pipe", "pipe"]
     }).trim();
     if (result)
       return result;
   } catch {}
-  const cargoPath = join4(homedir4(), ".cargo", "bin", `aft${ext}`);
+  const cargoPath = join4(homeDirFromEnv(env), ".cargo", "bin", `aft${ext}`);
   if (existsSync3(cargoPath))
     return cargoPath;
   return null;
@@ -27490,6 +27495,8 @@ function coerceAftStatus(response) {
     project_root: readNullableString(response.project_root),
     canonical_root: readNullableString(response.canonical_root),
     cache_role: readString(response.cache_role, "not_initialized"),
+    degraded: readBoolean(response.degraded),
+    degraded_reasons: Array.isArray(response.degraded_reasons) ? response.degraded_reasons.filter((r) => typeof r === "string") : [],
     features: {
       format_on_edit: readBoolean(features.format_on_edit),
       validate_on_edit: readString(features.validate_on_edit, "off"),

package/dist/shared/status.d.ts

@@ -3,6 +3,17 @@ export interface AftStatusSnapshot {
     project_root: string | null;
     canonical_root: string | null;
     cache_role: string;
+    /**
+     * True when at least one heavy AFT subsystem has been auto-disabled for
+     * the current project root. `degraded_reasons` enumerates why (e.g.
+     * `["home_root"]`, `["search_too_many_files:20000"]`). The sidebar / TUI
+     * dialog surface this so users know `aft_search`, `aft_navigate` etc.
+     * won't return results from this session and can choose to open a
+     * project subdirectory instead.
+     */
+    degraded: boolean;
+    /** Machine-readable degraded-mode reasons. Empty when `degraded === false`. */
+    degraded_reasons: string[];
     features: {
         format_on_edit: boolean;
         validate_on_edit: string;

package/dist/shared/status.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/shared/status.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE;QACR,cAAc,EAAE,OAAO,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,wBAAwB,EAAE,OAAO,CAAC;QAClC,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,cAAc,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAkCD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CA6DpF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAuE3E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA0EtE"}
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../src/shared/status.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB;;;;;;;OAOG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB,+EAA+E;IAC/E,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,QAAQ,EAAE;QACR,cAAc,EAAE,OAAO,CAAC;QACxB,gBAAgB,EAAE,MAAM,CAAC;QACzB,wBAAwB,EAAE,OAAO,CAAC;QAClC,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,YAAY,EAAE;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,CAAC;IACF,cAAc,EAAE;QACd,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;QACvB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;QACzB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KACvB,CAAC;IACF,IAAI,EAAE;QACJ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,kBAAkB,EAAE,MAAM,CAAC;QAC3B,mBAAmB,EAAE,MAAM,CAAC;KAC7B,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE;QACZ,aAAa,EAAE,MAAM,CAAC;QACtB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;IACF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,iEAAiE;IACjE,iBAAiB,EAAE,MAAM,CAAC;IAC1B,4DAA4D;IAC5D,OAAO,EAAE;QACP,EAAE,EAAE,MAAM,CAAC;QACX,aAAa,EAAE,MAAM,CAAC;QACtB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;CACH;AAkCD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAajD;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAiEpF;AAED;;;;;;GAMG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CAuE3E;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA0EtE"}

package/dist/tui.js

@@ -4,7 +4,7 @@ import { createMemo as createMemo2, createSignal as createSignal2, onCleanup as
 // package.json
 var package_default = {
   name: "@cortexkit/aft-opencode",
-  version: "0.26.1",
+  version: "0.26.2",
   type: "module",
   description: "OpenCode plugin for Agent File Tools (AFT) \u2014 tree-sitter and lsp powered code analysis",
   main: "dist/index.js",
@@ -32,7 +32,7 @@ var package_default = {
   },
   dependencies: {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.26.1",
+    "@cortexkit/aft-bridge": "0.26.2",
     "@opencode-ai/plugin": "^1.14.39",
     "@opencode-ai/sdk": "^1.14.39",
     "comment-json": "^4.6.2",
@@ -40,11 +40,11 @@ var package_default = {
     zod: "^4.1.8"
   },
   optionalDependencies: {
-    "@cortexkit/aft-darwin-arm64": "0.26.1",
-    "@cortexkit/aft-darwin-x64": "0.26.1",
-    "@cortexkit/aft-linux-arm64": "0.26.1",
-    "@cortexkit/aft-linux-x64": "0.26.1",
-    "@cortexkit/aft-win32-x64": "0.26.1"
+    "@cortexkit/aft-darwin-arm64": "0.26.2",
+    "@cortexkit/aft-darwin-x64": "0.26.2",
+    "@cortexkit/aft-linux-arm64": "0.26.2",
+    "@cortexkit/aft-linux-x64": "0.26.2",
+    "@cortexkit/aft-win32-x64": "0.26.2"
   },
   devDependencies: {
     "@types/node": "^22.0.0",
@@ -334,6 +334,8 @@ function coerceAftStatus(response) {
     project_root: readNullableString(response.project_root),
     canonical_root: readNullableString(response.canonical_root),
     cache_role: readString(response.cache_role, "not_initialized"),
+    degraded: readBoolean(response.degraded),
+    degraded_reasons: Array.isArray(response.degraded_reasons) ? response.degraded_reasons.filter((r) => typeof r === "string") : [],
     features: {
       format_on_edit: readBoolean(features.format_on_edit),
       validate_on_edit: readString(features.validate_on_edit, "off"),
@@ -560,6 +562,25 @@ var SidebarContent = (props) => {
   const semanticStatus = () => statusDisplay(s()?.semantic_index?.status ?? "disabled");
   const trigramBytes = () => s()?.disk?.trigram_disk_bytes ?? 0;
   const semanticBytes = () => s()?.disk?.semantic_disk_bytes ?? 0;
+  const degradedReasonLabel = (reason) => {
+    if (reason === "home_root") {
+      return "project root is your home directory";
+    }
+    if (reason.startsWith("search_too_many_files:")) {
+      const threshold = reason.split(":")[1] ?? "20000";
+      return `project exceeds ${threshold} files`;
+    }
+    return reason;
+  };
+  const degradedSummary = () => {
+    const snap = s();
+    if (!snap?.degraded)
+      return null;
+    const reasons = snap.degraded_reasons ?? [];
+    if (reasons.length === 0)
+      return null;
+    return reasons.map(degradedReasonLabel).join("; ");
+  };
   return /* @__PURE__ */ jsxDEV("box", {
     width: "100%",
     flexDirection: "column",
@@ -576,16 +597,34 @@ var SidebarContent = (props) => {
         alignItems: "center",
         children: [
           /* @__PURE__ */ jsxDEV("box", {
-            paddingLeft: 1,
-            paddingRight: 1,
-            backgroundColor: props.theme.accent,
-            children: /* @__PURE__ */ jsxDEV("text", {
-              fg: props.theme.background,
-              children: /* @__PURE__ */ jsxDEV("b", {
-                children: "AFT"
+            flexDirection: "row",
+            alignItems: "center",
+            children: [
+              /* @__PURE__ */ jsxDEV("box", {
+                paddingLeft: 1,
+                paddingRight: 1,
+                backgroundColor: props.theme.accent,
+                children: /* @__PURE__ */ jsxDEV("text", {
+                  fg: props.theme.background,
+                  children: /* @__PURE__ */ jsxDEV("b", {
+                    children: "AFT"
+                  }, undefined, false, undefined, this)
+                }, undefined, false, undefined, this)
+              }, undefined, false, undefined, this),
+              s()?.degraded && /* @__PURE__ */ jsxDEV("box", {
+                paddingLeft: 1,
+                paddingRight: 1,
+                marginLeft: 1,
+                backgroundColor: props.theme.warning,
+                children: /* @__PURE__ */ jsxDEV("text", {
+                  fg: props.theme.background,
+                  children: /* @__PURE__ */ jsxDEV("b", {
+                    children: "DEGRADED"
+                  }, undefined, false, undefined, this)
+                }, undefined, false, undefined, this)
               }, undefined, false, undefined, this)
-            }, undefined, false, undefined, this)
-          }, undefined, false, undefined, this),
+            ]
+          }, undefined, true, undefined, this),
           /* @__PURE__ */ jsxDEV("text", {
             fg: props.theme.textMuted,
             children: [
@@ -595,6 +634,17 @@ var SidebarContent = (props) => {
           }, undefined, true, undefined, this)
         ]
       }, undefined, true, undefined, this),
+      s()?.degraded && degradedSummary() && /* @__PURE__ */ jsxDEV("box", {
+        marginTop: 1,
+        width: "100%",
+        children: /* @__PURE__ */ jsxDEV("text", {
+          fg: props.theme.warning,
+          children: [
+            "\u26A0 ",
+            degradedSummary()
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this),
       /* @__PURE__ */ jsxDEV(SectionHeader, {
         theme: props.theme,
         title: "Search Index"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft-opencode",
-  "version": "0.26.1",
+  "version": "0.26.2",
   "type": "module",
   "description": "OpenCode plugin for Agent File Tools (AFT) — tree-sitter and lsp powered code analysis",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.2.0",
-    "@cortexkit/aft-bridge": "0.26.1",
+    "@cortexkit/aft-bridge": "0.26.2",
     "@opencode-ai/plugin": "^1.14.39",
     "@opencode-ai/sdk": "^1.14.39",
     "comment-json": "^4.6.2",
@@ -36,11 +36,11 @@
     "zod": "^4.1.8"
   },
   "optionalDependencies": {
-    "@cortexkit/aft-darwin-arm64": "0.26.1",
-    "@cortexkit/aft-darwin-x64": "0.26.1",
-    "@cortexkit/aft-linux-arm64": "0.26.1",
-    "@cortexkit/aft-linux-x64": "0.26.1",
-    "@cortexkit/aft-win32-x64": "0.26.1"
+    "@cortexkit/aft-darwin-arm64": "0.26.2",
+    "@cortexkit/aft-darwin-x64": "0.26.2",
+    "@cortexkit/aft-linux-arm64": "0.26.2",
+    "@cortexkit/aft-linux-x64": "0.26.2",
+    "@cortexkit/aft-win32-x64": "0.26.2"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/shared/status.ts

@@ -3,6 +3,17 @@ export interface AftStatusSnapshot {
   project_root: string | null;
   canonical_root: string | null;
   cache_role: string;
+  /**
+   * True when at least one heavy AFT subsystem has been auto-disabled for
+   * the current project root. `degraded_reasons` enumerates why (e.g.
+   * `["home_root"]`, `["search_too_many_files:20000"]`). The sidebar / TUI
+   * dialog surface this so users know `aft_search`, `aft_navigate` etc.
+   * won't return results from this session and can choose to open a
+   * project subdirectory instead.
+   */
+  degraded: boolean;
+  /** Machine-readable degraded-mode reasons. Empty when `degraded === false`. */
+  degraded_reasons: string[];
   features: {
     format_on_edit: boolean;
     validate_on_edit: string;
@@ -112,6 +123,10 @@ export function coerceAftStatus(response: Record<string, unknown>): AftStatusSna
     project_root: readNullableString(response.project_root),
     canonical_root: readNullableString(response.canonical_root),
     cache_role: readString(response.cache_role, "not_initialized"),
+    degraded: readBoolean(response.degraded),
+    degraded_reasons: Array.isArray(response.degraded_reasons)
+      ? response.degraded_reasons.filter((r): r is string => typeof r === "string")
+      : [],
     features: {
       format_on_edit: readBoolean(features.format_on_edit),
       validate_on_edit: readString(features.validate_on_edit, "off"),

package/src/tui/sidebar.tsx

@@ -226,6 +226,28 @@ const SidebarContent = (props: {
   const trigramBytes = () => s()?.disk?.trigram_disk_bytes ?? 0;
   const semanticBytes = () => s()?.disk?.semantic_disk_bytes ?? 0;
 
+  // Degraded-mode reason → human-readable hint. Distinct strings per reason
+  // because the UX direction is different: "home_root" tells the user to
+  // open a real project subdirectory, "search_too_many_files" tells them the
+  // tree is too big for full indexing.
+  const degradedReasonLabel = (reason: string): string => {
+    if (reason === "home_root") {
+      return "project root is your home directory";
+    }
+    if (reason.startsWith("search_too_many_files:")) {
+      const threshold = reason.split(":")[1] ?? "20000";
+      return `project exceeds ${threshold} files`;
+    }
+    return reason; // unknown reason — surface verbatim so users can grep logs
+  };
+  const degradedSummary = () => {
+    const snap = s();
+    if (!snap?.degraded) return null;
+    const reasons = snap.degraded_reasons ?? [];
+    if (reasons.length === 0) return null;
+    return reasons.map(degradedReasonLabel).join("; ");
+  };
+
   return (
     <box
       width="100%"
@@ -237,16 +259,39 @@ const SidebarContent = (props: {
       paddingLeft={1}
       paddingRight={1}
     >
-      {/* Header: AFT badge + binary version */}
+      {/* Header: AFT badge + binary version + degraded badge (when active) */}
       <box flexDirection="row" justifyContent="space-between" alignItems="center">
-        <box paddingLeft={1} paddingRight={1} backgroundColor={props.theme.accent}>
-          <text fg={props.theme.background}>
-            <b>AFT</b>
-          </text>
+        <box flexDirection="row" alignItems="center">
+          <box paddingLeft={1} paddingRight={1} backgroundColor={props.theme.accent}>
+            <text fg={props.theme.background}>
+              <b>AFT</b>
+            </text>
+          </box>
+          {s()?.degraded && (
+            <box
+              paddingLeft={1}
+              paddingRight={1}
+              marginLeft={1}
+              backgroundColor={props.theme.warning}
+            >
+              <text fg={props.theme.background}>
+                <b>DEGRADED</b>
+              </text>
+            </box>
+          )}
         </box>
         <text fg={props.theme.textMuted}>v{s()?.version ?? props.pluginVersion}</text>
       </box>
 
+      {/* Degraded reason — explains why heavy tools (aft_search, aft_navigate)
+          are disabled. Surface this prominently so users know to open a real
+          project subdirectory if they want full features. */}
+      {s()?.degraded && degradedSummary() && (
+        <box marginTop={1} width="100%">
+          <text fg={props.theme.warning}>⚠ {degradedSummary()}</text>
+        </box>
+      )}
+
       {/* Search index */}
       <SectionHeader theme={props.theme} title="Search Index" />
       <StatRow