@cortexkit/aft 0.17.0 → 0.17.2

package/dist/commands/lsp.d.ts

@@ -0,0 +1,53 @@
+import type { sendAftRequest } from "../lib/aft-bridge.js";
+import { sendAftRequests } from "../lib/aft-bridge.js";
+import { findAftBinary } from "../lib/binary-probe.js";
+import { resolveAdaptersForCommand } from "../lib/harness-select.js";
+export interface LspDoctorOptions {
+    argv: string[];
+    sendRequest?: typeof sendAftRequest;
+    sendRequests?: typeof sendAftRequests;
+    findBinary?: typeof findAftBinary;
+    resolveAdapters?: typeof resolveAdaptersForCommand;
+}
+export interface LspInspectResponse {
+    success: boolean;
+    code?: string;
+    message?: string;
+    file?: string;
+    extension?: string;
+    project_root?: string | null;
+    experimental_lsp_ty?: boolean;
+    disabled_lsp?: string[];
+    lsp_paths_extra?: string[];
+    matching_servers?: LspServerInspection[];
+    diagnostics_count?: number;
+    diagnostics?: LspDiagnostic[];
+}
+export interface LspServerInspection {
+    id: string;
+    name: string;
+    kind: string;
+    extensions: string[];
+    root_markers: string[];
+    binary_name: string;
+    binary_path: string | null;
+    binary_source: "path" | "lsp_paths_extra" | "project_node_modules" | "not_found" | string;
+    workspace_root: string | null;
+    spawn_status: string;
+    args: string[];
+}
+export interface LspDiagnostic {
+    file: string;
+    line: number;
+    column: number;
+    end_line?: number;
+    end_column?: number;
+    severity: string;
+    message: string;
+    code?: string | null;
+    source?: string | null;
+}
+export declare function printLspDoctorHelp(): void;
+export declare function runLspDoctor(options: LspDoctorOptions): Promise<number>;
+export declare function renderLspInspection(inputFile: string, response: LspInspectResponse): string;
+//# sourceMappingURL=lsp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lsp.d.ts","sourceRoot":"","sources":["../../src/commands/lsp.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAc,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAMrE,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,WAAW,CAAC,EAAE,OAAO,cAAc,CAAC;IACpC,YAAY,CAAC,EAAE,OAAO,eAAe,CAAC;IACtC,UAAU,CAAC,EAAE,OAAO,aAAa,CAAC;IAClC,eAAe,CAAC,EAAE,OAAO,yBAAyB,CAAC;CACpD;AAED,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,gBAAgB,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACzC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,aAAa,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,aAAa,EAAE,MAAM,GAAG,iBAAiB,GAAG,sBAAsB,GAAG,WAAW,GAAG,MAAM,CAAC;IAC1F,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAIzC;AAED,wBAAsB,YAAY,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CA0D7E;AAED,wBAAgB,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,kBAAkB,GAAG,MAAM,CAmD3F"}

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,CAsBzB;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAcrC"}
+{"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,CAwBzB;AAED,iBAAe,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAkBrC"}

package/dist/index.js

@@ -9781,44 +9781,79 @@ var init_setup = __esm(() => {
   init_prompts();
 });
 
-// src/lib/binary-cache.ts
-import { existsSync as existsSync5, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
-import { join as join5 } from "node:path";
-function getBinaryCacheInfo(activeVersion) {
-  const path = getAftBinaryCacheDir();
-  if (!existsSync5(path)) {
-    return {
-      versions: [],
-      activeVersion: null,
-      totalSize: 0,
-      path
+// src/lib/aft-bridge.ts
+import { spawn } from "node:child_process";
+async function sendAftRequests(binaryPath, requests) {
+  return new Promise((resolve2, reject) => {
+    const child = spawn(binaryPath, [], {
+      stdio: ["pipe", "pipe", "pipe"]
+    });
+    const responses = [];
+    let stdout = "";
+    let stderr = "";
+    let settled = false;
+    const finish = (fn) => {
+      if (settled)
+        return;
+      settled = true;
+      child.kill();
+      fn();
     };
-  }
-  const versions = readdirSync2(path).filter((entry) => {
-    try {
-      return statSync2(join5(path, entry)).isDirectory();
-    } catch {
-      return false;
+    const handleLine = (line) => {
+      if (!line)
+        return;
+      try {
+        responses.push(JSON.parse(line));
+      } catch (error) {
+        finish(() => reject(error));
+        return;
+      }
+      if (responses.length === requests.length) {
+        finish(() => resolve2(responses));
+      }
+    };
+    child.stdout.setEncoding("utf-8");
+    child.stdout.on("data", (chunk) => {
+      stdout += chunk;
+      while (true) {
+        const newline = stdout.indexOf(`
+`);
+        if (newline === -1)
+          break;
+        const line = stdout.slice(0, newline).trim();
+        stdout = stdout.slice(newline + 1);
+        handleLine(line);
+        if (settled)
+          break;
+      }
+    });
+    child.stderr.setEncoding("utf-8");
+    child.stderr.on("data", (chunk) => {
+      stderr += chunk;
+    });
+    child.on("error", (error) => {
+      finish(() => reject(error));
+    });
+    child.on("exit", (code) => {
+      if (settled)
+        return;
+      finish(() => reject(new Error(`aft exited before responding (code ${code}): ${stderr.trim()}`)));
+    });
+    for (const request of requests) {
+      child.stdin.write(`${JSON.stringify(request)}
+`);
     }
-  }).sort(compareVersionLabels);
-  const tag = activeVersion ? activeVersion.startsWith("v") ? activeVersion : `v${activeVersion}` : null;
-  const resolvedActive = tag && versions.includes(tag) ? tag : null;
-  return {
-    versions,
-    activeVersion: resolvedActive,
-    totalSize: dirSize(path),
-    path
-  };
+    child.stdin.end();
+  });
 }
-var init_binary_cache = __esm(() => {
-  init_fs_util();
-  init_paths();
-});
+var init_aft_bridge = () => {};
 
 // src/lib/binary-probe.ts
 import { execSync as execSync3 } from "node:child_process";
-import { existsSync as existsSync6 } from "node:fs";
-import { join as join6 } from "node:path";
+import { existsSync as existsSync5 } from "node:fs";
+import { createRequire as createRequire2 } from "node:module";
+import { homedir as homedir4 } from "node:os";
+import { join as join5 } from "node:path";
 function normalizeVersion(output) {
   const trimmed = output.trim();
   if (!trimmed)
@@ -9829,7 +9864,7 @@ function probeBinaryVersion(preferredVersion) {
   const candidates = [];
   if (preferredVersion) {
     const tag = preferredVersion.startsWith("v") ? preferredVersion : `v${preferredVersion}`;
-    candidates.push(join6(getAftBinaryCacheDir(), tag, getAftBinaryName()));
+    candidates.push(join5(getAftBinaryCacheDir(), tag, getAftBinaryName()));
   }
   try {
     const lookup = process.platform === "win32" ? "where aft" : "which aft";
@@ -9840,7 +9875,7 @@ function probeBinaryVersion(preferredVersion) {
   } catch {}
   for (const candidate of candidates) {
     try {
-      if (!existsSync6(candidate))
+      if (!existsSync5(candidate))
         continue;
       const output = execSync3(`"${candidate}" --version`, {
         stdio: "pipe",
@@ -9853,29 +9888,369 @@ function probeBinaryVersion(preferredVersion) {
   }
   return null;
 }
+function platformKey(platform = process.platform, arch = process.arch) {
+  const table = {
+    darwin: { arm64: "darwin-arm64", x64: "darwin-x64" },
+    linux: { arm64: "linux-arm64", x64: "linux-x64" },
+    win32: { x64: "win32-x64" }
+  };
+  return table[platform]?.[arch] ?? null;
+}
+function findAftBinary(preferredVersion) {
+  const candidates = [];
+  if (preferredVersion) {
+    const tag = preferredVersion.startsWith("v") ? preferredVersion : `v${preferredVersion}`;
+    candidates.push(join5(getAftBinaryCacheDir(), tag, getAftBinaryName()));
+  }
+  const key = platformKey();
+  if (key) {
+    try {
+      const require2 = createRequire2(import.meta.url);
+      candidates.push(require2.resolve(`@cortexkit/aft-${key}/bin/${getAftBinaryName()}`));
+    } catch {}
+  }
+  try {
+    const lookup = process.platform === "win32" ? "where aft" : "which aft";
+    const resolved = execSync3(lookup, { stdio: "pipe", encoding: "utf-8" }).trim();
+    if (resolved) {
+      candidates.push(resolved.split(/\r?\n/)[0]);
+    }
+  } catch {}
+  candidates.push(join5(homedir4(), ".cargo", "bin", getAftBinaryName()));
+  for (const candidate of candidates) {
+    if (existsSync5(candidate))
+      return candidate;
+  }
+  return null;
+}
 var init_binary_probe = __esm(() => {
   init_paths();
 });
 
-// src/lib/lsp-cache.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, rmSync as rmSync2, statSync as statSync3 } from "node:fs";
+// src/commands/lsp.ts
+var exports_lsp = {};
+__export(exports_lsp, {
+  runLspDoctor: () => runLspDoctor,
+  renderLspInspection: () => renderLspInspection,
+  printLspDoctorHelp: () => printLspDoctorHelp
+});
+import { existsSync as existsSync6, readdirSync as readdirSync2, statSync as statSync2 } from "node:fs";
+import { join as join6, resolve as resolve2 } from "node:path";
+function printLspDoctorHelp() {
+  console.log("Usage: aft doctor lsp <file> [--harness opencode|pi]");
+  console.log("");
+  console.log("Inspect what AFT's LSP layer would do for a file.");
+}
+async function runLspDoctor(options) {
+  const file = parseFileArg(options.argv);
+  if (!file) {
+    printLspDoctorHelp();
+    return 1;
+  }
+  const resolveAdapters = options.resolveAdapters ?? resolveAdaptersForCommand;
+  const adapters = await resolveAdapters(options.argv, {
+    allowMulti: false,
+    verb: "inspect LSP for"
+  });
+  const adapter = adapters[0];
+  if (!adapter) {
+    O2.error("No harness selected.");
+    return 1;
+  }
+  const findBinary = options.findBinary ?? findAftBinary;
+  const binary = findBinary(getSelfVersion());
+  if (!binary) {
+    O2.error("Could not find the aft binary in the cache, platform package, PATH, or ~/.cargo/bin.");
+    return 1;
+  }
+  const projectRoot = resolve2(process.cwd());
+  const config = buildConfigureParams(adapter, projectRoot);
+  const inspectRequest = {
+    id: "doctor-lsp-inspect",
+    command: "lsp_inspect",
+    file: resolve2(file)
+  };
+  const responses = options.sendRequests ? await options.sendRequests(binary, [config, inspectRequest]) : options.sendRequest ? [await options.sendRequest(binary, inspectRequest)] : await sendAftRequests(binary, [config, inspectRequest]);
+  const configure = responses.length > 1 ? responses[0] : undefined;
+  if (configure && !configure.success) {
+    O2.error(configure.message ?? configure.code ?? "configure failed");
+    return 1;
+  }
+  const inspect = responses[responses.length - 1];
+  if (!inspect) {
+    O2.error("aft exited before returning lsp_inspect response");
+    return 1;
+  }
+  if (!inspect.success) {
+    O2.error(inspect.message ?? inspect.code ?? "lsp_inspect failed");
+    return 1;
+  }
+  console.log(renderLspInspection(file, inspect));
+  return 0;
+}
+function renderLspInspection(inputFile, response) {
+  const lines = [];
+  lines.push(`LSP inspection — ${inputFile}`);
+  lines.push("");
+  lines.push(`Resolved file: ${response.file ?? "(unknown)"}`);
+  lines.push(`File extension: ${response.extension ? `.${response.extension}` : "(none)"}`);
+  lines.push(`Project root: ${response.project_root ?? "(not configured)"}`);
+  lines.push("");
+  lines.push(`Active config: experimental_lsp_ty=${response.experimental_lsp_ty === true ? "true" : "false"}, disabled_lsp=${formatList(response.disabled_lsp ?? [])}`);
+  lines.push(`lsp_paths_extra: ${formatList(response.lsp_paths_extra ?? [])}`);
+  lines.push("");
+  lines.push("Server attempts:");
+  const active = new Set(response.matching_servers?.map((server) => server.id) ?? []);
+  for (const id of response.disabled_lsp ?? []) {
+    if (!active.has(id)) {
+      lines.push(`  • ${id}: disabled by config`);
+    }
+  }
+  const servers = response.matching_servers ?? [];
+  if (servers.length === 0) {
+    lines.push("  (no registered LSP servers match this file extension)");
+  }
+  for (const server of servers) {
+    const ok = server.spawn_status === "ok";
+    lines.push(`  ${ok ? "✓" : "✗"} ${server.id}`);
+    lines.push(`    Binary: ${formatBinary(server)}`);
+    lines.push(`    Workspace root: ${formatWorkspaceRoot(server)}`);
+    lines.push(`    Args: ${JSON.stringify(server.args)}`);
+    lines.push(`    Status: ${formatSpawnStatus(server)}`);
+    if (server.binary_source === "not_found") {
+      lines.push(`    Action: ${installHint(server.binary_name)}`);
+    }
+  }
+  const diagnostics = response.diagnostics ?? [];
+  lines.push("");
+  lines.push(`Diagnostics (${response.diagnostics_count ?? diagnostics.length} found):`);
+  if (diagnostics.length === 0) {
+    lines.push("  (none)");
+  }
+  for (const diagnostic of diagnostics) {
+    lines.push(`  ${diagnostic.file}:${diagnostic.line}:${diagnostic.column} [${diagnostic.severity}] ${diagnostic.message}`);
+  }
+  return lines.join(`
+`);
+}
+function parseFileArg(argv) {
+  for (let i = 0;i < argv.length; i += 1) {
+    const arg = argv[i];
+    if (arg === "--harness") {
+      i += 1;
+      continue;
+    }
+    if (arg.startsWith("--"))
+      continue;
+    return arg;
+  }
+  return null;
+}
+function buildConfigureParams(adapter, projectRoot) {
+  const paths = adapter.detectConfigPaths();
+  const userConfig = readJsoncFile(paths.aftConfig).value ?? {};
+  const projectConfig = readProjectConfig(adapter.kind, projectRoot);
+  const merged = mergeConfig(userConfig, projectConfig);
+  const lsp = isRecord(merged.lsp) ? merged.lsp : {};
+  const lspConfig = resolveLspConfig(merged);
+  return {
+    id: "doctor-lsp-configure",
+    command: "configure",
+    project_root: projectRoot,
+    ...lspConfig,
+    lsp_paths_extra: inferLspPathsExtra(lsp)
+  };
+}
+function readProjectConfig(kind, projectRoot) {
+  const dir = kind === "pi" ? ".pi" : ".opencode";
+  const jsonc = join6(projectRoot, dir, "aft.jsonc");
+  const json = join6(projectRoot, dir, "aft.json");
+  if (existsSync6(jsonc))
+    return readJsoncFile(jsonc).value ?? {};
+  if (existsSync6(json))
+    return readJsoncFile(json).value ?? {};
+  return {};
+}
+function mergeConfig(userConfig, projectConfig) {
+  const userLsp = isRecord(userConfig.lsp) ? userConfig.lsp : {};
+  const projectLsp = isRecord(projectConfig.lsp) ? projectConfig.lsp : {};
+  return {
+    ...userConfig,
+    ...projectConfig,
+    lsp: {
+      ...userLsp,
+      ...projectLsp,
+      ...isRecord(userLsp.servers) ? { servers: userLsp.servers } : {},
+      ...Array.isArray(userLsp.disabled) ? { disabled: userLsp.disabled } : {}
+    }
+  };
+}
+function resolveLspConfig(config) {
+  const lsp = isRecord(config.lsp) ? config.lsp : {};
+  const disabled = new Set;
+  for (const entry of Array.isArray(lsp.disabled) ? lsp.disabled : []) {
+    if (typeof entry === "string")
+      disabled.add(entry.toLowerCase());
+  }
+  let experimentalTy = typeof config.experimental_lsp_ty === "boolean" ? config.experimental_lsp_ty : undefined;
+  if (lsp.python === "ty") {
+    experimentalTy = true;
+    disabled.add("python");
+  } else if (lsp.python === "pyright") {
+    experimentalTy = false;
+    disabled.add("ty");
+  }
+  const result = {};
+  if (experimentalTy !== undefined)
+    result.experimental_lsp_ty = experimentalTy;
+  if (disabled.size > 0)
+    result.disabled_lsp = [...disabled];
+  const servers = resolveCustomServers(lsp.servers);
+  if (servers.length > 0)
+    result.lsp_servers = servers;
+  return result;
+}
+function resolveCustomServers(servers) {
+  if (!isRecord(servers))
+    return [];
+  return Object.entries(servers).filter(([, server]) => isRecord(server)).map(([id, server]) => {
+    const entry = server;
+    return {
+      id,
+      extensions: Array.isArray(entry.extensions) ? entry.extensions : [],
+      binary: typeof entry.binary === "string" ? entry.binary : "",
+      args: Array.isArray(entry.args) ? entry.args : [],
+      root_markers: Array.isArray(entry.root_markers) ? entry.root_markers : [".git"],
+      disabled: entry.disabled === true,
+      ...isRecord(entry.env) ? { env: entry.env } : {},
+      ...entry.initialization_options !== undefined ? { initialization_options: entry.initialization_options } : {}
+    };
+  }).filter((server) => typeof server.binary === "string" && server.binary.length > 0);
+}
+function inferLspPathsExtra(lsp) {
+  if (lsp.auto_install === false)
+    return [];
+  const paths = new Set;
+  for (const entry of childDirs(getAftLspPackagesDir())) {
+    paths.add(join6(entry, "node_modules", ".bin"));
+  }
+  for (const entry of childDirs(getAftLspBinariesDir())) {
+    paths.add(join6(entry, "bin"));
+  }
+  return [...paths];
+}
+function childDirs(path) {
+  if (!existsSync6(path))
+    return [];
+  try {
+    return readdirSync2(path).map((entry) => join6(path, entry)).filter((entry) => {
+      try {
+        return statSync2(entry).isDirectory();
+      } catch {
+        return false;
+      }
+    });
+  } catch {
+    return [];
+  }
+}
+function formatBinary(server) {
+  if (!server.binary_path) {
+    return `${server.binary_name} (NOT FOUND on PATH or in lsp_paths_extra)`;
+  }
+  return `${server.binary_path} (found via ${server.binary_source})`;
+}
+function formatWorkspaceRoot(server) {
+  if (!server.workspace_root) {
+    return `(not found; markers: ${server.root_markers.join(", ") || "none"})`;
+  }
+  return `${server.workspace_root} (markers: ${server.root_markers.join(", ") || "none"})`;
+}
+function formatSpawnStatus(server) {
+  if (server.spawn_status === "ok")
+    return "spawned successfully";
+  if (server.spawn_status === "binary_not_installed")
+    return "binary not installed";
+  if (server.spawn_status === "no_root_marker")
+    return "no workspace root marker found";
+  return server.spawn_status;
+}
+function formatList(values) {
+  return values.length === 0 ? "(none)" : values.join(", ");
+}
+function installHint(binaryName) {
+  if (binaryName === "ty")
+    return "Install with `uv tool install ty` or `pip install ty`.";
+  if (binaryName === "pyright-langserver")
+    return "Install with `npm install -g pyright`.";
+  return `Install ${binaryName} and ensure it is on PATH or in lsp_paths_extra.`;
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+var init_lsp = __esm(() => {
+  init_aft_bridge();
+  init_binary_probe();
+  init_harness_select();
+  init_jsonc();
+  init_paths();
+  init_prompts();
+  init_self_version();
+});
+
+// src/lib/binary-cache.ts
+import { existsSync as existsSync7, readdirSync as readdirSync3, statSync as statSync3 } from "node:fs";
 import { join as join7 } from "node:path";
-function inspectDir(path) {
+function getBinaryCacheInfo(activeVersion) {
+  const path = getAftBinaryCacheDir();
   if (!existsSync7(path)) {
+    return {
+      versions: [],
+      activeVersion: null,
+      totalSize: 0,
+      path
+    };
+  }
+  const versions = readdirSync3(path).filter((entry) => {
+    try {
+      return statSync3(join7(path, entry)).isDirectory();
+    } catch {
+      return false;
+    }
+  }).sort(compareVersionLabels);
+  const tag = activeVersion ? activeVersion.startsWith("v") ? activeVersion : `v${activeVersion}` : null;
+  const resolvedActive = tag && versions.includes(tag) ? tag : null;
+  return {
+    versions,
+    activeVersion: resolvedActive,
+    totalSize: dirSize(path),
+    path
+  };
+}
+var init_binary_cache = __esm(() => {
+  init_fs_util();
+  init_paths();
+});
+
+// src/lib/lsp-cache.ts
+import { existsSync as existsSync8, readdirSync as readdirSync4, rmSync as rmSync2, statSync as statSync4 } from "node:fs";
+import { join as join8 } from "node:path";
+function inspectDir(path) {
+  if (!existsSync8(path)) {
     return { entries: [], totalSize: 0 };
   }
   const entries = [];
   let totalSize = 0;
   let names;
   try {
-    names = readdirSync3(path);
+    names = readdirSync4(path);
   } catch {
     return { entries: [], totalSize: 0 };
   }
   for (const name of names) {
-    const full = join7(path, name);
+    const full = join8(path, name);
     try {
-      if (!statSync3(full).isDirectory())
+      if (!statSync4(full).isDirectory())
         continue;
       const size = dirSize(full);
       entries.push({
@@ -9931,8 +10306,8 @@ var init_lsp_cache = __esm(() => {
 });
 
 // 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";
+import { existsSync as existsSync9, readdirSync as readdirSync5, readlinkSync, realpathSync, statSync as statSync5 } from "node:fs";
+import { join as join9 } from "node:path";
 function getOnnxLibraryName() {
   if (process.platform === "darwin")
     return "libonnxruntime.dylib";
@@ -9965,21 +10340,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 (existsSync8(join8(path, libName)))
+    if (existsSync9(join9(path, libName)))
       return path;
   }
   return null;
 }
 function findCachedOnnxRuntime(storageDir) {
-  const ortDir = join8(storageDir, "onnxruntime", ONNX_RUNTIME_VERSION);
-  return existsSync8(join8(ortDir, getOnnxLibraryName())) ? ortDir : null;
+  const ortDir = join9(storageDir, "onnxruntime", ONNX_RUNTIME_VERSION);
+  return existsSync9(join9(ortDir, getOnnxLibraryName())) ? ortDir : null;
 }
 function detectOrtVersion(libDir) {
-  if (!existsSync8(libDir))
+  if (!existsSync9(libDir))
     return null;
   const libName = getOnnxLibraryName();
   try {
-    const entries = readdirSync4(libDir);
+    const entries = readdirSync5(libDir);
     for (const entry of entries) {
       if (!entry.startsWith(libName))
         continue;
@@ -9987,8 +10362,8 @@ function detectOrtVersion(libDir) {
       if (match)
         return match[1];
     }
-    const base = join8(libDir, libName);
-    if (existsSync8(base)) {
+    const base = join9(libDir, libName);
+    if (existsSync9(base)) {
       try {
         const real = realpathSync(base);
         const suffix = real.match(/\.(\d+\.\d+\.\d+)$/);
@@ -10018,13 +10393,13 @@ var ONNX_RUNTIME_VERSION = "1.24.4", REQUIRED_ORT_MAJOR = 1, REQUIRED_ORT_MIN_MI
 var init_onnx = () => {};
 
 // src/lib/sanitize.ts
-import { homedir as homedir4, userInfo } from "node:os";
+import { homedir as homedir5, userInfo } from "node:os";
 function escapeRegex(value) {
   return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 function sanitizeContent(content) {
   const username = userInfo().username;
-  const home = homedir4();
+  const home = homedir5();
   let sanitized = content;
   if (home) {
     sanitized = sanitized.replace(new RegExp(escapeRegex(home), "g"), "~");
@@ -10053,7 +10428,7 @@ function sanitizeValue(value) {
 var init_sanitize = () => {};
 
 // src/lib/diagnostics.ts
-import { existsSync as existsSync9, readFileSync as readFileSync4, statSync as statSync5 } from "node:fs";
+import { existsSync as existsSync10, readFileSync as readFileSync4, statSync as statSync6 } from "node:fs";
 async function collectDiagnostics(adapters) {
   const cliVersion = getSelfVersion();
   const binaryVersion = probeBinaryVersion(cliVersion);
@@ -10093,14 +10468,14 @@ async function diagnoseHarness(adapter) {
     pluginRegistered: adapter.hasPluginEntry(),
     configPaths,
     aftConfig: {
-      exists: existsSync9(configPaths.aftConfig),
+      exists: existsSync10(configPaths.aftConfig),
       ...aftConfigRead.error ? { parseError: aftConfigRead.error } : {},
       flags: aftFlags
     },
     pluginCache: adapter.getPluginCacheInfo(),
     storageDir: {
       path: storage,
-      exists: existsSync9(storage),
+      exists: existsSync10(storage),
       sizesByKey: describeStorage
     },
     onnxRuntime: {
@@ -10117,8 +10492,8 @@ async function diagnoseHarness(adapter) {
     },
     logFile: {
       path: logPath,
-      exists: existsSync9(logPath),
-      sizeKb: existsSync9(logPath) ? Math.round(statSync5(logPath).size / 1024) : 0
+      exists: existsSync10(logPath),
+      sizeKb: existsSync10(logPath) ? Math.round(statSync6(logPath).size / 1024) : 0
     }
   };
 }
@@ -10178,7 +10553,7 @@ function renderDiagnosticsMarkdown(report) {
 `);
 }
 function tailLogFile(path, lines) {
-  if (!existsSync9(path))
+  if (!existsSync10(path))
     return "";
   try {
     const raw = readFileSync4(path, "utf-8");
@@ -10244,7 +10619,7 @@ __export(exports_doctor, {
   DOCTOR_CLEAR_TARGET_OPTIONS: () => DOCTOR_CLEAR_TARGET_OPTIONS
 });
 import { writeFileSync as writeFileSync2 } from "node:fs";
-import { join as join9 } from "node:path";
+import { join as join10 } from "node:path";
 async function runDoctor(options) {
   if (options.issue) {
     return runIssueFlow(options.argv);
@@ -10458,7 +10833,7 @@ ${tail || "<no log output>"}
 `);
   const body = sanitizeContent(rawBody);
   const title = `AFT issue: ${description.slice(0, 72)}`;
-  const outPath = join9(process.cwd(), `aft-issue-${Date.now()}.md`);
+  const outPath = join10(process.cwd(), `aft-issue-${Date.now()}.md`);
   writeFileSync2(outPath, `${body}
 `);
   O2.success(`Wrote sanitized issue body to ${outPath}`);
@@ -10513,6 +10888,7 @@ function printHelp() {
   console.log("  Commands:");
   console.log("    setup            Interactive setup wizard");
   console.log("    doctor           Check and fix configuration issues");
+  console.log("    doctor lsp <file> Inspect LSP setup for one file");
   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("");
@@ -10524,6 +10900,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 lsp ./src/main.py");
   console.log("    bunx --bun @cortexkit/aft doctor --clear");
   console.log("    bunx --bun @cortexkit/aft doctor --issue");
   console.log("");
@@ -10534,6 +10911,10 @@ async function main() {
     return runSetup2(args);
   }
   if (command === "doctor") {
+    if (args[0] === "lsp") {
+      const { runLspDoctor: runLspDoctor2 } = await Promise.resolve().then(() => (init_lsp(), exports_lsp));
+      return runLspDoctor2({ argv: args.slice(1) });
+    }
     const { runDoctor: runDoctor2 } = await Promise.resolve().then(() => (init_doctor(), exports_doctor));
     const force = args.includes("--force");
     const clear = args.includes("--clear");

package/dist/lib/aft-bridge.d.ts

@@ -0,0 +1,15 @@
+export interface AftRequest {
+    id: string;
+    command: string;
+    [key: string]: unknown;
+}
+export interface AftResponse {
+    id: string;
+    success: boolean;
+    code?: string;
+    message?: string;
+    [key: string]: unknown;
+}
+export declare function sendAftRequest(binaryPath: string, request: AftRequest): Promise<AftResponse>;
+export declare function sendAftRequests(binaryPath: string, requests: AftRequest[]): Promise<AftResponse[]>;
+//# sourceMappingURL=aft-bridge.d.ts.map

package/dist/lib/aft-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"aft-bridge.d.ts","sourceRoot":"","sources":["../../src/lib/aft-bridge.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,wBAAsB,cAAc,CAClC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,WAAW,CAAC,CAKtB;AAED,wBAAsB,eAAe,CACnC,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,UAAU,EAAE,GACrB,OAAO,CAAC,WAAW,EAAE,CAAC,CAgExB"}

package/dist/lib/binary-probe.d.ts

@@ -8,4 +8,6 @@
  * not an exception.
  */
 export declare function probeBinaryVersion(preferredVersion?: string): string | null;
+export declare function platformKey(platform?: string, arch?: string): string | null;
+export declare function findAftBinary(preferredVersion?: string): string | null;
 //# sourceMappingURL=binary-probe.d.ts.map

package/dist/lib/binary-probe.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"binary-probe.d.ts","sourceRoot":"","sources":["../../src/lib/binary-probe.ts"],"names":[],"mappings":"AAWA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgC3E"}
+{"version":3,"file":"binary-probe.d.ts","sourceRoot":"","sources":["../../src/lib/binary-probe.ts"],"names":[],"mappings":"AAaA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAgC3E;AAED,wBAAgB,WAAW,CACzB,QAAQ,GAAE,MAAyB,EACnC,IAAI,GAAE,MAAqB,GAC1B,MAAM,GAAG,IAAI,CAOf;AAED,wBAAgB,aAAa,CAAC,gBAAgB,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAkCtE"}

package/package.json

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