@cortexkit/aft-opencode 0.26.0 → 0.26.2

package/dist/lsp-github-install.d.ts

@@ -68,7 +68,7 @@ export declare function validateExtraction(stagingRoot: string): void;
  *   4. Atomic rename: `staging → destDir`. Any prior `destDir` is removed first.
  *   5. Always cleanup staging on any failure.
  */
-declare function precheckArchiveSize(archivePath: string, archiveType: string): void;
+export declare function precheckArchiveContents(archivePath: string, archiveType: string): void;
 export interface GithubAutoInstallResult {
     cachedBinDirs: string[];
     installsStarted: number;
@@ -108,5 +108,5 @@ export declare function discoverRelevantGithubServers(projectRoot: string): Set<
  * of `downloadFile`. We expose it here so the test suite can verify the
  * allowlist independently of full network mocking.
  */
-export { type Arch, assertAllowedDownloadUrl as _assertAllowedDownloadUrlForTesting, detectHostPlatform, downloadFile as _downloadFileForTesting, findGithubServerById, GITHUB_LSP_TABLE, type GithubServerSpec, type Platform, precheckArchiveSize as _precheckArchiveSizeForTesting, };
+export { type Arch, assertAllowedDownloadUrl as _assertAllowedDownloadUrlForTesting, detectHostPlatform, downloadFile as _downloadFileForTesting, findGithubServerById, GITHUB_LSP_TABLE, type GithubServerSpec, type Platform, precheckArchiveContents as _precheckArchiveSizeForTesting, };
 //# sourceMappingURL=lsp-github-install.d.ts.map

package/dist/lsp-github-install.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"lsp-github-install.d.ts","sourceRoot":"","sources":["../src/lsp-github-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAuCH,OAAO,EACL,KAAK,IAAI,EACT,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAC;AAqB/B,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAG/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CASrF;AASD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAoVD,iBAAS,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAgBrD;AAED,iBAAe,YAAY,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,KAAK,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAuDf;AA6BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA0E5D;AAED;;;;;;;;GAQG;AACH,iBAAS,mBAAmB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CAqB3E;AAmVD,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAsBD,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,EACpC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,GAAE,OAAO,KAAa,GAC9B,uBAAuB,CAwFzB;AAID;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAyC9E;AAID;;;;;;;GAOG;AACH,OAAO,EACL,KAAK,IAAI,EACT,wBAAwB,IAAI,mCAAmC,EAC/D,kBAAkB,EAClB,YAAY,IAAI,uBAAuB,EACvC,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,mBAAmB,IAAI,8BAA8B,GACtD,CAAC"}
+{"version":3,"file":"lsp-github-install.d.ts","sourceRoot":"","sources":["../src/lsp-github-install.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAuCH,OAAO,EACL,KAAK,IAAI,EACT,kBAAkB,EAClB,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACd,MAAM,uBAAuB,CAAC;AAiC/B,yCAAyC;AACzC,wBAAgB,YAAY,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAG/E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CASrF;AAsDD,MAAM,WAAW,mBAAmB;IAClC,WAAW,EAAE,OAAO,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAC3C,QAAQ,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;CAC/B;AAoVD,iBAAS,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,GAAG,CAgBrD;AAED,iBAAe,YAAY,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,OAAO,KAAK,EACvB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAuDf;AA6BD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI,CA0E5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI,CA4BtF;AA6WD,MAAM,WAAW,uBAAuB;IACtC,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,EAAE,MAAM,CAAC;IACxB,yEAAyE;IACzE,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,OAAO,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC/C;;;;OAIG;IACH,gBAAgB,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;CACjC;AAsBD,wBAAsB,2BAA2B,IAAI,OAAO,CAAC,IAAI,CAAC,CAMjE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,EACpC,MAAM,EAAE,mBAAmB,EAC3B,SAAS,GAAE,OAAO,KAAa,GAC9B,uBAAuB,CAwFzB;AAID;;;;GAIG;AACH,wBAAgB,6BAA6B,CAAC,WAAW,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAyC9E;AAID;;;;;;;GAOG;AACH,OAAO,EACL,KAAK,IAAI,EACT,wBAAwB,IAAI,mCAAmC,EAC/D,kBAAkB,EAClB,YAAY,IAAI,uBAAuB,EACvC,oBAAoB,EACpB,gBAAgB,EAChB,KAAK,gBAAgB,EACrB,KAAK,QAAQ,EACb,uBAAuB,IAAI,8BAA8B,GAC1D,CAAC"}

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.0",
+  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.0",
+    "@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.0",
-    "@cortexkit/aft-darwin-x64": "0.26.0",
-    "@cortexkit/aft-linux-arm64": "0.26.0",
-    "@cortexkit/aft-linux-x64": "0.26.0",
-    "@cortexkit/aft-win32-x64": "0.26.0"
+    "@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.0",
+  "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.0",
+    "@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.0",
-    "@cortexkit/aft-darwin-x64": "0.26.0",
-    "@cortexkit/aft-linux-arm64": "0.26.0",
-    "@cortexkit/aft-linux-x64": "0.26.0",
-    "@cortexkit/aft-win32-x64": "0.26.0"
+    "@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