@cortexkit/aft 0.16.0 → 0.17.0

package/dist/commands/doctor.d.ts

@@ -1,7 +1,34 @@
+import type { HarnessAdapter } from "../adapters/types.js";
+import { type ClearResult } from "../lib/lsp-cache.js";
+export type DoctorClearTarget = "plugin-cache" | "lsp-cache";
+export declare const DOCTOR_CLEAR_TARGET_OPTIONS: {
+    label: string;
+    value: DoctorClearTarget;
+}[];
+export declare const DOCTOR_FORCE_CLEAR_TARGETS: DoctorClearTarget[];
 export interface DoctorOptions {
+    clear: boolean;
     force: boolean;
     issue: boolean;
     argv: string[];
 }
+export interface CacheClearSummary {
+    hadErrors: boolean;
+    pluginCache?: {
+        cleared: number;
+        totalBytes: number;
+        errors: number;
+    };
+    lspCache?: {
+        cleared: number;
+        totalBytes: number;
+        errors: number;
+    };
+}
+export interface CacheClearOptions {
+    clearLspCaches?: () => ClearResult;
+    includePluginBytes?: boolean;
+}
 export declare function runDoctor(options: DoctorOptions): Promise<number>;
+export declare function clearDoctorCaches(adapters: HarnessAdapter[], targets: readonly DoctorClearTarget[], options?: CacheClearOptions): Promise<CacheClearSummary>;
 //# sourceMappingURL=doctor.d.ts.map

package/dist/commands/doctor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgFvE"}
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAK3D,OAAO,EAAE,KAAK,WAAW,EAAkB,MAAM,qBAAqB,CAAC;AAIvE,MAAM,MAAM,iBAAiB,GAAG,cAAc,GAAG,WAAW,CAAC;AAE7D,eAAO,MAAM,2BAA2B,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,iBAAiB,CAAA;CAAE,EASpF,CAAC;AAEF,eAAO,MAAM,0BAA0B,EAAE,iBAAiB,EAAqB,CAAC;AAEhF,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,CAAC,EAAE;QACT,OAAO,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,MAAM,WAAW,iBAAiB;IAChC,cAAc,CAAC,EAAE,MAAM,WAAW,CAAC;IACnC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CAC9B;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAgGvE;AA4BD,wBAAsB,iBAAiB,CACrC,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,EAAE,SAAS,iBAAiB,EAAE,EACrC,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,iBAAiB,CAAC,CAoC5B"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,QAAA,MAAM,OAAO,QAAkB,CAAC;AAChC,QAAA,MAAM,IAAI,UAAwB,CAAC;AAEnC,iBAAS,SAAS,IAAI,IAAI,CAqBzB;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAarC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;GAMG;AAEH,QAAA,MAAM,OAAO,QAAkB,CAAC;AAChC,QAAA,MAAM,IAAI,UAAwB,CAAC;AAEnC,iBAAS,SAAS,IAAI,IAAI,CAsBzB;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAcrC"}

package/dist/index.js

@@ -7892,6 +7892,30 @@ function getAftBinaryCacheDir() {
 function getAftBinaryName() {
   return process.platform === "win32" ? "aft.exe" : "aft";
 }
+function getAftLspPackagesDir() {
+  if (process.env.AFT_CACHE_DIR) {
+    return join2(process.env.AFT_CACHE_DIR, "lsp-packages");
+  }
+  if (process.platform === "win32") {
+    const localAppData = process.env.LOCALAPPDATA || process.env.APPDATA;
+    const base2 = localAppData || join2(homedir(), "AppData", "Local");
+    return join2(base2, "aft", "lsp-packages");
+  }
+  const base = process.env.XDG_CACHE_HOME || join2(homedir(), ".cache");
+  return join2(base, "aft", "lsp-packages");
+}
+function getAftLspBinariesDir() {
+  if (process.env.AFT_CACHE_DIR) {
+    return join2(process.env.AFT_CACHE_DIR, "lsp-binaries");
+  }
+  if (process.platform === "win32") {
+    const localAppData = process.env.LOCALAPPDATA || process.env.APPDATA;
+    const base2 = localAppData || join2(homedir(), "AppData", "Local");
+    return join2(base2, "aft", "lsp-binaries");
+  }
+  const base = process.env.XDG_CACHE_HOME || join2(homedir(), ".cache");
+  return join2(base, "aft", "lsp-binaries");
+}
 function getTmpLogPath(filename) {
   return join2(tmpdir(), filename);
 }
@@ -9607,13 +9631,13 @@ async function selectOne(message, options) {
   handleCancel(result);
   return result;
 }
-async function selectMany(message, options, initialValues) {
+async function selectMany(message, options, initialValues, required = true) {
   const clackOptions = options.map((option) => option.hint === undefined ? { label: option.label, value: option.value } : { label: option.label, value: option.value, hint: option.hint });
   const result = await yt({
     message,
     options: clackOptions,
     ...initialValues ? { initialValues } : {},
-    required: true
+    required
   });
   handleCancel(result);
   return result;
@@ -9833,9 +9857,82 @@ var init_binary_probe = __esm(() => {
   init_paths();
 });
 
-// src/lib/onnx.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, readlinkSync, realpathSync, statSync as statSync3 } from "node:fs";
+// src/lib/lsp-cache.ts
+import { existsSync as existsSync7, readdirSync as readdirSync3, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
 import { join as join7 } from "node:path";
+function inspectDir(path) {
+  if (!existsSync7(path)) {
+    return { entries: [], totalSize: 0 };
+  }
+  const entries = [];
+  let totalSize = 0;
+  let names;
+  try {
+    names = readdirSync3(path);
+  } catch {
+    return { entries: [], totalSize: 0 };
+  }
+  for (const name of names) {
+    const full = join7(path, name);
+    try {
+      if (!statSync3(full).isDirectory())
+        continue;
+      const size = dirSize(full);
+      entries.push({
+        name: decodeURIComponent(name),
+        path: full,
+        size
+      });
+      totalSize += size;
+    } catch {}
+  }
+  entries.sort((a, b) => b.size - a.size);
+  return { entries, totalSize };
+}
+function getLspCacheReport() {
+  const npmPath = getAftLspPackagesDir();
+  const githubPath = getAftLspBinariesDir();
+  const npm = inspectDir(npmPath);
+  const github = inspectDir(githubPath);
+  return {
+    npm: {
+      path: npmPath,
+      entries: npm.entries,
+      totalSize: npm.totalSize
+    },
+    github: {
+      path: githubPath,
+      entries: github.entries,
+      totalSize: github.totalSize
+    },
+    totalSize: npm.totalSize + github.totalSize
+  };
+}
+function clearLspCaches() {
+  const result = { cleared: [], errors: [], totalBytes: 0 };
+  const report = getLspCacheReport();
+  for (const entry of [...report.npm.entries, ...report.github.entries]) {
+    try {
+      rmSync2(entry.path, { recursive: true, force: true });
+      result.cleared.push({ name: entry.name, path: entry.path, size: entry.size });
+      result.totalBytes += entry.size;
+    } catch (err) {
+      result.errors.push({
+        path: entry.path,
+        error: err instanceof Error ? err.message : String(err)
+      });
+    }
+  }
+  return result;
+}
+var init_lsp_cache = __esm(() => {
+  init_fs_util();
+  init_paths();
+});
+
+// src/lib/onnx.ts
+import { existsSync as existsSync8, readdirSync as readdirSync4, readlinkSync, realpathSync, statSync as statSync4 } from "node:fs";
+import { join as join8 } from "node:path";
 function getOnnxLibraryName() {
   if (process.platform === "darwin")
     return "libonnxruntime.dylib";
@@ -9868,21 +9965,21 @@ function findSystemOnnxRuntime() {
   const libName = getOnnxLibraryName();
   const searchPaths = process.platform === "darwin" ? ["/opt/homebrew/lib", "/usr/local/lib"] : process.platform === "linux" ? ["/usr/lib", "/usr/lib/x86_64-linux-gnu", "/usr/lib/aarch64-linux-gnu", "/usr/local/lib"] : [];
   for (const path of searchPaths) {
-    if (existsSync7(join7(path, libName)))
+    if (existsSync8(join8(path, libName)))
       return path;
   }
   return null;
 }
 function findCachedOnnxRuntime(storageDir) {
-  const ortDir = join7(storageDir, "onnxruntime", ONNX_RUNTIME_VERSION);
-  return existsSync7(join7(ortDir, getOnnxLibraryName())) ? ortDir : null;
+  const ortDir = join8(storageDir, "onnxruntime", ONNX_RUNTIME_VERSION);
+  return existsSync8(join8(ortDir, getOnnxLibraryName())) ? ortDir : null;
 }
 function detectOrtVersion(libDir) {
-  if (!existsSync7(libDir))
+  if (!existsSync8(libDir))
     return null;
   const libName = getOnnxLibraryName();
   try {
-    const entries = readdirSync3(libDir);
+    const entries = readdirSync4(libDir);
     for (const entry of entries) {
       if (!entry.startsWith(libName))
         continue;
@@ -9890,8 +9987,8 @@ function detectOrtVersion(libDir) {
       if (match)
         return match[1];
     }
-    const base = join7(libDir, libName);
-    if (existsSync7(base)) {
+    const base = join8(libDir, libName);
+    if (existsSync8(base)) {
       try {
         const real = realpathSync(base);
         const suffix = real.match(/\.(\d+\.\d+\.\d+)$/);
@@ -9956,7 +10053,7 @@ function sanitizeValue(value) {
 var init_sanitize = () => {};
 
 // src/lib/diagnostics.ts
-import { existsSync as existsSync8, readFileSync as readFileSync4, statSync as statSync4 } from "node:fs";
+import { existsSync as existsSync9, readFileSync as readFileSync4, statSync as statSync5 } from "node:fs";
 async function collectDiagnostics(adapters) {
   const cliVersion = getSelfVersion();
   const binaryVersion = probeBinaryVersion(cliVersion);
@@ -9972,7 +10069,8 @@ async function collectDiagnostics(adapters) {
     cliVersion,
     binaryVersion,
     harnesses,
-    binaryCache: getBinaryCacheInfo(cliVersion)
+    binaryCache: getBinaryCacheInfo(cliVersion),
+    lspCache: getLspCacheReport()
   };
 }
 async function diagnoseHarness(adapter) {
@@ -9995,14 +10093,14 @@ async function diagnoseHarness(adapter) {
     pluginRegistered: adapter.hasPluginEntry(),
     configPaths,
     aftConfig: {
-      exists: existsSync8(configPaths.aftConfig),
+      exists: existsSync9(configPaths.aftConfig),
       ...aftConfigRead.error ? { parseError: aftConfigRead.error } : {},
       flags: aftFlags
     },
     pluginCache: adapter.getPluginCacheInfo(),
     storageDir: {
       path: storage,
-      exists: existsSync8(storage),
+      exists: existsSync9(storage),
       sizesByKey: describeStorage
     },
     onnxRuntime: {
@@ -10019,8 +10117,8 @@ async function diagnoseHarness(adapter) {
     },
     logFile: {
       path: logPath,
-      exists: existsSync8(logPath),
-      sizeKb: existsSync8(logPath) ? Math.round(statSync4(logPath).size / 1024) : 0
+      exists: existsSync9(logPath),
+      sizeKb: existsSync9(logPath) ? Math.round(statSync5(logPath).size / 1024) : 0
     }
   };
 }
@@ -10071,11 +10169,16 @@ function renderDiagnosticsMarkdown(report) {
   lines.push("```json");
   lines.push(JSON.stringify(report.binaryCache, null, 2));
   lines.push("```");
+  lines.push("");
+  lines.push("### LSP cache");
+  lines.push("```json");
+  lines.push(JSON.stringify(report.lspCache, null, 2));
+  lines.push("```");
   return lines.join(`
 `);
 }
 function tailLogFile(path, lines) {
-  if (!existsSync8(path))
+  if (!existsSync9(path))
     return "";
   try {
     const raw = readFileSync4(path, "utf-8");
@@ -10089,6 +10192,7 @@ var init_diagnostics = __esm(() => {
   init_binary_cache();
   init_binary_probe();
   init_jsonc();
+  init_lsp_cache();
   init_onnx();
   init_sanitize();
   init_self_version();
@@ -10134,15 +10238,21 @@ var init_github = () => {};
 // src/commands/doctor.ts
 var exports_doctor = {};
 __export(exports_doctor, {
-  runDoctor: () => runDoctor
+  runDoctor: () => runDoctor,
+  clearDoctorCaches: () => clearDoctorCaches,
+  DOCTOR_FORCE_CLEAR_TARGETS: () => DOCTOR_FORCE_CLEAR_TARGETS,
+  DOCTOR_CLEAR_TARGET_OPTIONS: () => DOCTOR_CLEAR_TARGET_OPTIONS
 });
 import { writeFileSync as writeFileSync2 } from "node:fs";
-import { join as join8 } from "node:path";
+import { join as join9 } from "node:path";
 async function runDoctor(options) {
   if (options.issue) {
     return runIssueFlow(options.argv);
   }
   mt("AFT doctor");
+  if (options.clear) {
+    return runClearFlow(options.argv);
+  }
   const adapters = await resolveAdaptersForCommand(options.argv, {
     allowMulti: true,
     verb: "diagnose"
@@ -10150,6 +10260,11 @@ async function runDoctor(options) {
   const report = await collectDiagnostics(adapters);
   O2.info(`CLI v${report.cliVersion}, binary ${report.binaryVersion ?? "unknown"}`);
   O2.info(`Binary cache: ${report.binaryCache.versions.length} version(s), ${formatBytes(report.binaryCache.totalSize)} at ${report.binaryCache.path}`);
+  const npmCount = report.lspCache.npm.entries.length;
+  const ghCount = report.lspCache.github.entries.length;
+  if (npmCount + ghCount > 0) {
+    O2.info(`LSP cache: ${npmCount} npm + ${ghCount} github install(s), ${formatBytes(report.lspCache.totalSize)} total`);
+  }
   let hadProblems = false;
   for (const h of report.harnesses) {
     O2.step(`${h.displayName}`);
@@ -10185,8 +10300,11 @@ async function runDoctor(options) {
     }
     O2.info(`  log: ${h.logFile.exists ? `${h.logFile.path} (${h.logFile.sizeKb} KB)` : "(not written yet)"}`);
   }
+  if (options.force) {
+    await clearDoctorCaches(adapters, DOCTOR_FORCE_CLEAR_TARGETS, { includePluginBytes: false });
+  }
   for (const adapter of adapters) {
-    await maybeFixPlugin(adapter, options.force);
+    await maybeFixPlugin(adapter);
   }
   if (hadProblems) {
     wt("Run `aft setup` to register AFT with any harness showing `plugin registered: no`.", "Tips");
@@ -10196,19 +10314,87 @@ async function runDoctor(options) {
   gt("Everything looks good.");
   return 0;
 }
-async function maybeFixPlugin(adapter, force) {
-  if (force) {
-    const result = await adapter.clearPluginCache(true);
-    if (result.action === "cleared") {
-      O2.success(`${adapter.displayName}: cleared plugin cache at ${result.path}`);
-    } else if (result.action === "not_applicable") {
-      O2.info(`${adapter.displayName}: no user-managed plugin cache to clear`);
-    } else if (result.action === "not_found") {
-      O2.info(`${adapter.displayName}: no plugin cache found at ${result.path}`);
-    } else if (result.action === "error") {
-      O2.error(`${adapter.displayName}: cache clear failed: ${result.error ?? "unknown"}`);
+async function runClearFlow(argv) {
+  const targets = await selectMany("What do you want to clear?", DOCTOR_CLEAR_TARGET_OPTIONS, undefined, false);
+  if (targets.length === 0) {
+    O2.info("No cache categories selected; nothing to clear.");
+    gt("Done.");
+    return 0;
+  }
+  const adapters = targets.includes("plugin-cache") ? await resolveAdaptersForCommand(argv, {
+    allowMulti: true,
+    verb: "clear plugin cache for"
+  }) : [];
+  const summary = await clearDoctorCaches(adapters, targets);
+  gt(summary.hadErrors ? "Done — some cache entries could not be cleared." : "Done.");
+  return summary.hadErrors ? 1 : 0;
+}
+async function clearDoctorCaches(adapters, targets, options = {}) {
+  const summary = { hadErrors: false };
+  if (targets.includes("plugin-cache")) {
+    let cleared = 0;
+    let totalBytes = 0;
+    let errors = 0;
+    for (const adapter of adapters) {
+      const result = await clearPluginCache(adapter, options.includePluginBytes ?? true);
+      if (result.action === "cleared") {
+        cleared += 1;
+        totalBytes += result.bytes;
+      } else if (result.action === "error") {
+        errors += 1;
+        summary.hadErrors = true;
+      }
     }
+    summary.pluginCache = { cleared, totalBytes, errors };
+  }
+  if (targets.includes("lsp-cache")) {
+    const cleanup = (options.clearLspCaches ?? clearLspCaches)();
+    reportLspCacheClear(cleanup);
+    if (cleanup.errors.length > 0) {
+      summary.hadErrors = true;
+    }
+    summary.lspCache = {
+      cleared: cleanup.cleared.length,
+      totalBytes: cleanup.totalBytes,
+      errors: cleanup.errors.length
+    };
+  }
+  return summary;
+}
+async function clearPluginCache(adapter, includeBytes) {
+  const info = adapter.getPluginCacheInfo();
+  const bytes = info.exists ? dirSize(info.path) : 0;
+  const result = await adapter.clearPluginCache(true);
+  if (result.action === "cleared") {
+    const suffix = includeBytes ? `, reclaimed ${formatBytes(bytes)}` : "";
+    O2.success(`${adapter.displayName}: cleared plugin cache at ${result.path}${suffix}`);
+    return { action: "cleared", bytes };
+  }
+  if (result.action === "not_applicable") {
+    O2.info(`${adapter.displayName}: no user-managed plugin cache to clear`);
+    return { action: "not_applicable", bytes: 0 };
+  }
+  if (result.action === "not_found") {
+    O2.info(`${adapter.displayName}: no plugin cache found at ${result.path}`);
+    return { action: "not_found", bytes: 0 };
   }
+  if (result.action === "error") {
+    O2.error(`${adapter.displayName}: cache clear failed: ${result.error ?? "unknown"}`);
+    return { action: "error", bytes: 0 };
+  }
+  return { action: "not_found", bytes: 0 };
+}
+function reportLspCacheClear(cleanup) {
+  if (cleanup.cleared.length === 0) {
+    O2.info("LSP install cache: nothing to clear, reclaimed 0 B");
+  } else {
+    O2.success(`LSP install cache: cleared ${cleanup.cleared.length} install(s), reclaimed ${formatBytes(cleanup.totalBytes)}`);
+  }
+  for (const err of cleanup.errors) {
+    O2.error(`LSP install cache: failed to remove ${err.path}: ${err.error}`);
+  }
+}
+async function maybeFixPlugin(adapter) {
   if (!adapter.hasPluginEntry() && adapter.isInstalled()) {
     O2.info(`${adapter.displayName}: attempting to register plugin…`);
     const r = await adapter.ensurePluginEntry();
@@ -10272,7 +10458,7 @@ ${tail || "<no log output>"}
 `);
   const body = sanitizeContent(rawBody);
   const title = `AFT issue: ${description.slice(0, 72)}`;
-  const outPath = join8(process.cwd(), `aft-issue-${Date.now()}.md`);
+  const outPath = join9(process.cwd(), `aft-issue-${Date.now()}.md`);
   writeFileSync2(outPath, `${body}
 `);
   O2.success(`Wrote sanitized issue body to ${outPath}`);
@@ -10294,13 +10480,26 @@ ${tail || "<no log output>"}
   gt("Done.");
   return 0;
 }
+var DOCTOR_CLEAR_TARGET_OPTIONS, DOCTOR_FORCE_CLEAR_TARGETS;
 var init_doctor = __esm(() => {
   init_diagnostics();
   init_fs_util();
   init_github();
   init_harness_select();
+  init_lsp_cache();
   init_prompts();
   init_sanitize();
+  DOCTOR_CLEAR_TARGET_OPTIONS = [
+    {
+      label: "Plugin npm cache (~/.cache/opencode/packages/@cortexkit/aft-opencode@latest, etc.)",
+      value: "plugin-cache"
+    },
+    {
+      label: "LSP install cache (~/.cache/aft/lsp-packages/, ~/.cache/aft/lsp-binaries/)",
+      value: "lsp-cache"
+    }
+  ];
+  DOCTOR_FORCE_CLEAR_TARGETS = ["plugin-cache"];
 });
 
 // src/index.ts
@@ -10314,7 +10513,7 @@ function printHelp() {
   console.log("  Commands:");
   console.log("    setup            Interactive setup wizard");
   console.log("    doctor           Check and fix configuration issues");
-  console.log("    doctor --force   Force clear plugin cache (fixes stale versions)");
+  console.log("    doctor --clear   Select caches to clear with an interactive prompt");
   console.log("    doctor --issue   Collect diagnostics and open a GitHub issue");
   console.log("");
   console.log("  Harness selection:");
@@ -10325,6 +10524,7 @@ function printHelp() {
   console.log("  Usage:");
   console.log("    bunx --bun @cortexkit/aft setup");
   console.log("    bunx --bun @cortexkit/aft doctor");
+  console.log("    bunx --bun @cortexkit/aft doctor --clear");
   console.log("    bunx --bun @cortexkit/aft doctor --issue");
   console.log("");
 }
@@ -10336,8 +10536,9 @@ async function main() {
   if (command === "doctor") {
     const { runDoctor: runDoctor2 } = await Promise.resolve().then(() => (init_doctor(), exports_doctor));
     const force = args.includes("--force");
+    const clear = args.includes("--clear");
     const issue = args.includes("--issue");
-    return runDoctor2({ force, issue, argv: args });
+    return runDoctor2({ clear, force, issue, argv: args });
   }
   printHelp();
   return command ? 1 : 0;

package/dist/lib/diagnostics.d.ts

@@ -1,5 +1,6 @@
 import type { HarnessAdapter } from "../adapters/types.js";
 import { type BinaryCacheInfo } from "./binary-cache.js";
+import { type LspCacheReport } from "./lsp-cache.js";
 export interface DiagnosticReport {
     timestamp: string;
     platform: string;
@@ -9,6 +10,8 @@ export interface DiagnosticReport {
     binaryVersion: string | null;
     harnesses: HarnessDiagnostic[];
     binaryCache: BinaryCacheInfo;
+    /** LSP package and binary caches populated by plugin auto-install. */
+    lspCache: LspCacheReport;
 }
 export interface HarnessDiagnostic {
     kind: string;

package/dist/lib/diagnostics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,mBAAmB,CAAC;AAe7E,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,WAAW,EAAE,eAAe,CAAC;CAC9B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,UAAU,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC7D,SAAS,EAAE;QACT,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;IACF,WAAW,EAAE,UAAU,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC9D,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;IACF,WAAW,EAAE;QACX,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAmB9F;AAgED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAoD1E;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ/D"}
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../src/lib/diagnostics.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,KAAK,eAAe,EAAsB,MAAM,mBAAmB,CAAC;AAG7E,OAAO,EAAqB,KAAK,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAaxE,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,SAAS,EAAE,iBAAiB,EAAE,CAAC;IAC/B,WAAW,EAAE,eAAe,CAAC;IAC7B,sEAAsE;IACtE,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,OAAO,CAAC;IACvB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,EAAE,OAAO,CAAC;IAC1B,WAAW,EAAE,UAAU,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC,CAAC;IAC7D,SAAS,EAAE;QACT,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KAChC,CAAC;IACF,WAAW,EAAE,UAAU,CAAC,cAAc,CAAC,oBAAoB,CAAC,CAAC,CAAC;IAC9D,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KACpC,CAAC;IACF,WAAW,EAAE;QACX,QAAQ,EAAE,OAAO,CAAC;QAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,gBAAgB,EAAE,OAAO,GAAG,IAAI,CAAC;QACjC,QAAQ,EAAE,MAAM,CAAC;QACjB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED,wBAAsB,kBAAkB,CAAC,QAAQ,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAoB9F;AAgED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CA0D1E;AAED,yDAAyD;AACzD,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAQ/D"}

package/dist/lib/lsp-cache.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Inspection and cleanup helpers for the AFT plugin's LSP cache.
+ *
+ * Two roots are populated by the plugin auto-installer at startup:
+ *
+ *   <aft-cache-root>/lsp-packages/<urlencoded-pkg>/   ← npm installs
+ *   <aft-cache-root>/lsp-binaries/<id>/               ← GitHub-release downloads
+ *
+ * The CLI reports their disk usage in `aft doctor` and can purge them via
+ * `aft doctor --force`. Purging is non-destructive in the sense that the
+ * plugin will simply re-install whatever the project needs on next session;
+ * it does not delete user-installed binaries (those live on PATH).
+ */
+export interface LspCacheEntry {
+    /** Display name (npm package name or GitHub server id). */
+    name: string;
+    /** Absolute path to the entry root. */
+    path: string;
+    /** Total bytes occupied by this entry. */
+    size: number;
+}
+export interface LspCacheReport {
+    /** npm-installed servers (`<root>/lsp-packages/`). */
+    npm: {
+        path: string;
+        entries: LspCacheEntry[];
+        totalSize: number;
+    };
+    /** GitHub-installed servers (`<root>/lsp-binaries/`). */
+    github: {
+        path: string;
+        entries: LspCacheEntry[];
+        totalSize: number;
+    };
+    /** Combined size of both subtrees. Convenience for the doctor display. */
+    totalSize: number;
+}
+/** Build a full inspection report for both LSP cache subtrees. */
+export declare function getLspCacheReport(): LspCacheReport;
+export interface ClearResult {
+    cleared: {
+        name: string;
+        path: string;
+        size: number;
+    }[];
+    errors: {
+        path: string;
+        error: string;
+    }[];
+    totalBytes: number;
+}
+/**
+ * Remove every entry under both LSP cache subtrees.
+ *
+ * Returns metadata for the doctor output (number of entries cleared, bytes
+ * reclaimed, individual failures). Errors don't abort — we want to clean
+ * as much as possible even when some directories are locked or have unusual
+ * permissions.
+ */
+export declare function clearLspCaches(): ClearResult;
+//# sourceMappingURL=lsp-cache.d.ts.map

package/dist/lib/lsp-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lsp-cache.d.ts","sourceRoot":"","sources":["../../src/lib/lsp-cache.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAOH,MAAM,WAAW,aAAa;IAC5B,2DAA2D;IAC3D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,0CAA0C;IAC1C,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,GAAG,EAAE;QACH,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,aAAa,EAAE,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,yDAAyD;IACzD,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,aAAa,EAAE,CAAC;QACzB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;IACF,0EAA0E;IAC1E,SAAS,EAAE,MAAM,CAAC;CACnB;AA0CD,kEAAkE;AAClE,wBAAgB,iBAAiB,IAAI,cAAc,CAkBlD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACxD,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC1C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,WAAW,CAkB5C"}

package/dist/lib/paths.d.ts

@@ -1,6 +1,20 @@
 /** `~/.cache/aft/bin/` (or the platform equivalent) — same as plugin's `getCacheDir`. */
 export declare function getAftBinaryCacheDir(): string;
 export declare function getAftBinaryName(): string;
+/**
+ * Root of the LSP package cache populated by the OpenCode/Pi plugin.
+ *
+ * `~/.cache/aft/lsp-packages/<urlencoded-pkg>/node_modules/.bin/<binary>` for
+ * npm-distributed servers (typescript-language-server, pyright, etc.).
+ */
+export declare function getAftLspPackagesDir(): string;
+/**
+ * Root of the LSP binary cache populated by the OpenCode/Pi plugin.
+ *
+ * `~/.cache/aft/lsp-binaries/<id>/bin/<binary>` for GitHub-distributed
+ * servers (clangd, lua-ls, zls, tinymist, texlab).
+ */
+export declare function getAftLspBinariesDir(): string;
 /** Resolve the plugin log file path. Shared with the plugin's logger. */
 export declare function getTmpLogPath(filename: string): string;
 //# sourceMappingURL=paths.d.ts.map

package/dist/lib/paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD"}
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../src/lib/paths.ts"],"names":[],"mappings":"AAGA,yFAAyF;AACzF,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,IAAI,MAAM,CAW7C;AAED,yEAAyE;AACzE,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEtD"}

package/dist/lib/prompts.d.ts

@@ -13,7 +13,7 @@ interface PromptOption<T extends string> {
     recommended?: boolean;
 }
 export declare function selectOne<T extends string>(message: string, options: PromptOption<T>[]): Promise<T>;
-export declare function selectMany<T extends string>(message: string, options: PromptOption<T>[], initialValues?: T[]): Promise<T[]>;
+export declare function selectMany<T extends string>(message: string, options: PromptOption<T>[], initialValues?: T[], required?: boolean): Promise<T[]>;
 export declare function text(message: string, options?: {
     placeholder?: string;
     defaultValue?: string;

package/dist/lib/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/lib/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,EAEL,GAAG,EAEH,IAAI,EACJ,KAAK,EAEL,OAAO,EACR,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAS5C,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlF;AAED;;;;GAIG;AACH,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,SAAS,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GACzB,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,wBAAsB,UAAU,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,aAAa,CAAC,EAAE,CAAC,EAAE,GAClB,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd;AAED,wBAAsB,IAAI,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CACrD,GACL,OAAO,CAAC,MAAM,CAAC,CAcjB"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/lib/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,EAEL,GAAG,EAEH,IAAI,EACJ,KAAK,EAEL,OAAO,EACR,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAS5C,wBAAsB,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAOlF;AAED;;;;GAIG;AACH,UAAU,YAAY,CAAC,CAAC,SAAS,MAAM;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,CAAC,CAAC;IACT,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB;AAED,wBAAsB,SAAS,CAAC,CAAC,SAAS,MAAM,EAC9C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,GACzB,OAAO,CAAC,CAAC,CAAC,CAWZ;AAED,wBAAsB,UAAU,CAAC,CAAC,SAAS,MAAM,EAC/C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,YAAY,CAAC,CAAC,CAAC,EAAE,EAC1B,aAAa,CAAC,EAAE,CAAC,EAAE,EACnB,QAAQ,UAAO,GACd,OAAO,CAAC,CAAC,EAAE,CAAC,CAcd;AAED,wBAAsB,IAAI,CACxB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;CACrD,GACL,OAAO,CAAC,MAAM,CAAC,CAcjB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cortexkit/aft",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "type": "module",
   "description": "Unified CLI for Agent File Tools (AFT) — setup, doctor, and diagnostics across supported agent harnesses (OpenCode, Pi)",
   "license": "MIT",