@macintacos/caret 0.12.0 → 0.14.0

package/dist/cli.js

@@ -1994,7 +1994,7 @@ var require_thread_stream = __commonJS((exports, module) => {
   var { version: version2 } = require_package();
   var { EventEmitter } = __require("events");
   var { Worker } = __require("worker_threads");
-  var { join: join7 } = __require("path");
+  var { join: join9 } = __require("path");
   var { pathToFileURL } = __require("url");
   var { wait } = require_wait();
   var {
@@ -2044,7 +2044,7 @@ var require_thread_stream = __commonJS((exports, module) => {
   function createWorker(stream, opts) {
     const { filename, workerData } = opts;
     const bundlerOverrides = "__bundlerPathsOverrides" in globalThis ? globalThis.__bundlerPathsOverrides : {};
-    const toExecute = bundlerOverrides["thread-stream-worker"] || join7(__dirname, "lib", "worker.js");
+    const toExecute = bundlerOverrides["thread-stream-worker"] || join9(__dirname, "lib", "worker.js");
     const worker = new Worker(toExecute, {
       ...opts.workerOpts,
       name: opts.workerOpts?.name || "thread-stream",
@@ -2510,7 +2510,7 @@ var require_transport = __commonJS((exports, module) => {
   var { createRequire } = __require("module");
   var { existsSync: existsSync5 } = __require("fs");
   var getCallers = require_caller();
-  var { join: join7, isAbsolute, sep } = __require("path");
+  var { join: join9, isAbsolute, sep: sep3 } = __require("path");
   var { fileURLToPath: fileURLToPath2 } = __require("url");
   var sleep = require_atomic_sleep();
   var onExit = require_on_exit_leak_free();
@@ -2663,7 +2663,7 @@ var require_transport = __commonJS((exports, module) => {
       throw new Error("only one of target or targets can be specified");
     }
     if (targets) {
-      target = bundlerOverrides["pino-worker"] || join7(__dirname, "worker.js");
+      target = bundlerOverrides["pino-worker"] || join9(__dirname, "worker.js");
       options.targets = targets.filter((dest) => dest.target).map((dest) => {
         return {
           ...dest,
@@ -2680,7 +2680,7 @@ var require_transport = __commonJS((exports, module) => {
         });
       });
     } else if (pipeline) {
-      target = bundlerOverrides["pino-worker"] || join7(__dirname, "worker.js");
+      target = bundlerOverrides["pino-worker"] || join9(__dirname, "worker.js");
       options.pipelines = [pipeline.map((dest) => {
         return {
           ...dest,
@@ -2703,12 +2703,12 @@ var require_transport = __commonJS((exports, module) => {
         return origin;
       }
       if (origin === "pino/file") {
-        return join7(__dirname, "..", "file.js");
+        return join9(__dirname, "..", "file.js");
       }
       let fixTarget2;
       for (const filePath of callers) {
         try {
-          const context = filePath === "node:repl" ? process.cwd() + sep : filePath;
+          const context = filePath === "node:repl" ? process.cwd() + sep3 : filePath;
           fixTarget2 = createRequire(context).resolve(origin);
           break;
         } catch (err) {
@@ -3632,7 +3632,7 @@ var require_safe_stable_stringify = __commonJS((exports, module) => {
             return circularValue;
           }
           let res = "";
-          let join7 = ",";
+          let join9 = ",";
           const originalIndentation = indentation;
           if (Array.isArray(value)) {
             if (value.length === 0) {
@@ -3646,7 +3646,7 @@ var require_safe_stable_stringify = __commonJS((exports, module) => {
               indentation += spacer;
               res += `
 ${indentation}`;
-              join7 = `,
+              join9 = `,
 ${indentation}`;
             }
             const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -3654,13 +3654,13 @@ ${indentation}`;
             for (;i < maximumValuesToStringify - 1; i++) {
               const tmp2 = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
               res += tmp2 !== undefined ? tmp2 : "null";
-              res += join7;
+              res += join9;
             }
             const tmp = stringifyFnReplacer(String(i), value, stack, replacer, spacer, indentation);
             res += tmp !== undefined ? tmp : "null";
             if (value.length - 1 > maximumBreadth) {
               const removedKeys = value.length - maximumBreadth - 1;
-              res += `${join7}"... ${getItemCount(removedKeys)} not stringified"`;
+              res += `${join9}"... ${getItemCount(removedKeys)} not stringified"`;
             }
             if (spacer !== "") {
               res += `
@@ -3681,7 +3681,7 @@ ${originalIndentation}`;
           let separator = "";
           if (spacer !== "") {
             indentation += spacer;
-            join7 = `,
+            join9 = `,
 ${indentation}`;
             whitespace = " ";
           }
@@ -3695,13 +3695,13 @@ ${indentation}`;
             const tmp = stringifyFnReplacer(key2, value, stack, replacer, spacer, indentation);
             if (tmp !== undefined) {
               res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-              separator = join7;
+              separator = join9;
             }
           }
           if (keyLength > maximumBreadth) {
             const removedKeys = keyLength - maximumBreadth;
             res += `${separator}"...":${whitespace}"${getItemCount(removedKeys)} not stringified"`;
-            separator = join7;
+            separator = join9;
           }
           if (spacer !== "" && separator.length > 1) {
             res = `
@@ -3741,7 +3741,7 @@ ${originalIndentation}`;
           }
           const originalIndentation = indentation;
           let res = "";
-          let join7 = ",";
+          let join9 = ",";
           if (Array.isArray(value)) {
             if (value.length === 0) {
               return "[]";
@@ -3754,7 +3754,7 @@ ${originalIndentation}`;
               indentation += spacer;
               res += `
 ${indentation}`;
-              join7 = `,
+              join9 = `,
 ${indentation}`;
             }
             const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
@@ -3762,13 +3762,13 @@ ${indentation}`;
             for (;i < maximumValuesToStringify - 1; i++) {
               const tmp2 = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
               res += tmp2 !== undefined ? tmp2 : "null";
-              res += join7;
+              res += join9;
             }
             const tmp = stringifyArrayReplacer(String(i), value[i], stack, replacer, spacer, indentation);
             res += tmp !== undefined ? tmp : "null";
             if (value.length - 1 > maximumBreadth) {
               const removedKeys = value.length - maximumBreadth - 1;
-              res += `${join7}"... ${getItemCount(removedKeys)} not stringified"`;
+              res += `${join9}"... ${getItemCount(removedKeys)} not stringified"`;
             }
             if (spacer !== "") {
               res += `
@@ -3781,7 +3781,7 @@ ${originalIndentation}`;
           let whitespace = "";
           if (spacer !== "") {
             indentation += spacer;
-            join7 = `,
+            join9 = `,
 ${indentation}`;
             whitespace = " ";
           }
@@ -3790,7 +3790,7 @@ ${indentation}`;
             const tmp = stringifyArrayReplacer(key2, value[key2], stack, replacer, spacer, indentation);
             if (tmp !== undefined) {
               res += `${separator}${strEscape(key2)}:${whitespace}${tmp}`;
-              separator = join7;
+              separator = join9;
             }
           }
           if (spacer !== "" && separator.length > 1) {
@@ -3847,20 +3847,20 @@ ${originalIndentation}`;
             indentation += spacer;
             let res2 = `
 ${indentation}`;
-            const join8 = `,
+            const join10 = `,
 ${indentation}`;
             const maximumValuesToStringify = Math.min(value.length, maximumBreadth);
             let i = 0;
             for (;i < maximumValuesToStringify - 1; i++) {
               const tmp2 = stringifyIndent(String(i), value[i], stack, spacer, indentation);
               res2 += tmp2 !== undefined ? tmp2 : "null";
-              res2 += join8;
+              res2 += join10;
             }
             const tmp = stringifyIndent(String(i), value[i], stack, spacer, indentation);
             res2 += tmp !== undefined ? tmp : "null";
             if (value.length - 1 > maximumBreadth) {
               const removedKeys = value.length - maximumBreadth - 1;
-              res2 += `${join8}"... ${getItemCount(removedKeys)} not stringified"`;
+              res2 += `${join10}"... ${getItemCount(removedKeys)} not stringified"`;
             }
             res2 += `
 ${originalIndentation}`;
@@ -3876,16 +3876,16 @@ ${originalIndentation}`;
             return '"[Object]"';
           }
           indentation += spacer;
-          const join7 = `,
+          const join9 = `,
 ${indentation}`;
           let res = "";
           let separator = "";
           let maximumPropertiesToStringify = Math.min(keyLength, maximumBreadth);
           if (isTypedArrayWithEntries(value)) {
-            res += stringifyTypedArray(value, join7, maximumBreadth);
+            res += stringifyTypedArray(value, join9, maximumBreadth);
             keys = keys.slice(value.length);
             maximumPropertiesToStringify -= value.length;
-            separator = join7;
+            separator = join9;
           }
           if (deterministic) {
             keys = sort(keys, comparator);
@@ -3896,13 +3896,13 @@ ${indentation}`;
             const tmp = stringifyIndent(key2, value[key2], stack, spacer, indentation);
             if (tmp !== undefined) {
               res += `${separator}${strEscape(key2)}: ${tmp}`;
-              separator = join7;
+              separator = join9;
             }
           }
           if (keyLength > maximumBreadth) {
             const removedKeys = keyLength - maximumBreadth;
             res += `${separator}"...": "${getItemCount(removedKeys)} not stringified"`;
-            separator = join7;
+            separator = join9;
           }
           if (separator !== "") {
             res = `
@@ -5804,7 +5804,7 @@ __export(exports_dist, {
 import { styleText as styleText2, stripVTControlCharacters } from "util";
 import process$1 from "process";
 import { existsSync as existsSync11, lstatSync, readdirSync as readdirSync6 } from "fs";
-import { dirname as dirname8, join as join14 } from "path";
+import { dirname as dirname9, join as join17 } from "path";
 function isUnicodeSupported() {
   if (process$1.platform !== "win32") {
     return process$1.env.TERM !== "linux";
@@ -6515,10 +6515,10 @@ ${n3}
         return [];
       try {
         let i;
-        existsSync11(t2) ? lstatSync(t2).isDirectory() && (!e.directory || t2.endsWith("/")) ? i = t2 : i = dirname8(t2) : i = dirname8(t2);
+        existsSync11(t2) ? lstatSync(t2).isDirectory() && (!e.directory || t2.endsWith("/")) ? i = t2 : i = dirname9(t2) : i = dirname9(t2);
         const c2 = t2.length > 1 && t2.endsWith("/") ? t2.slice(0, -1) : t2;
         return readdirSync6(i).map((r2) => {
-          const n3 = join14(i, r2), m3 = lstatSync(n3);
+          const n3 = join17(i, r2), m3 = lstatSync(n3);
           return {
             name: r2,
             path: n3,
@@ -7066,9 +7066,18 @@ function fatalDenyLine(reason) {
   });
 }
 
-// src/adapters/claude/install.ts
+// src/adapters/claude/paths.ts
 import { homedir } from "os";
 import { join } from "path";
+function claudeConfigDir() {
+  return process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
+}
+function installedPluginsFile() {
+  return join(claudeConfigDir(), "plugins", "installed_plugins.json");
+}
+function userSettingsFile() {
+  return join(claudeConfigDir(), "settings.json");
+}
 
 // src/lib/json-file.ts
 import { readFileSync } from "fs";
@@ -7089,16 +7098,12 @@ async function readJsonFile(path) {
 }
 
 // src/adapters/claude/install.ts
-function claudeConfigDir() {
-  return process.env.CLAUDE_CONFIG_DIR || join(homedir(), ".claude");
-}
 var PLUGIN_ID = "caret@caret";
 function readClaudeInstallState() {
-  const dir = claudeConfigDir();
   return {
-    pluginVersion: readPluginVersion(join(dir, "plugins", "installed_plugins.json")),
-    pluginEnabled: readPluginEnabled(join(dir, "settings.json")),
-    hookInUserSettings: readHookInUserSettings(join(dir, "settings.json"))
+    pluginVersion: readPluginVersion(installedPluginsFile()),
+    pluginEnabled: readPluginEnabled(userSettingsFile()),
+    hookInUserSettings: readHookInUserSettings(userSettingsFile())
   };
 }
 function readPluginVersion(path) {
@@ -7141,6 +7146,180 @@ function readHookInUserSettings(path) {
   return false;
 }
 
+// src/adapters/claude/skills.ts
+import { access, readdir } from "fs/promises";
+import { join as join3 } from "path";
+
+// src/lib/skill-doc.ts
+import { readFile as readFile2, realpath, stat } from "fs/promises";
+import { join as join2, sep } from "path";
+var FENCE = "---";
+var MAX_DOC_BYTES = 1024 * 1024;
+var DESCRIPTION_LINE = /^description:[ \t]*(.*)$/;
+var BLOCK_INTRODUCER = /^([|>])[-+]?\d*$/;
+function blockJoiner(value) {
+  const introducer = BLOCK_INTRODUCER.exec(value)?.[1];
+  if (introducer === undefined)
+    return;
+  return introducer === "|" ? `
+` : " ";
+}
+async function containedFile(root, relative) {
+  const [rootReal, real] = await Promise.all([
+    realpath(root).catch(() => null),
+    realpath(join2(root, relative)).catch(() => null)
+  ]);
+  if (rootReal === null || real === null)
+    return null;
+  return real === rootReal || real.startsWith(rootReal + sep) ? real : null;
+}
+function frontmatterLines(content) {
+  const lines = content.split(`
+`).map((line) => line.replace(/\r$/, ""));
+  if (lines[0]?.trimEnd() !== FENCE)
+    return null;
+  const close = lines.findIndex((line, i) => i > 0 && line.trimEnd() === FENCE);
+  return close === -1 ? null : lines.slice(1, close);
+}
+function unquote(value) {
+  const quote = value[0];
+  if ((quote === '"' || quote === "'") && value.length > 1 && value.endsWith(quote)) {
+    return value.slice(1, -1);
+  }
+  return value;
+}
+function blockScalar(rest, joiner) {
+  const taken = [];
+  for (const line of rest) {
+    if (line.trim() !== "" && !/^[ \t]/.test(line))
+      break;
+    taken.push(line.trim());
+  }
+  const kept = joiner === `
+` ? taken : taken.filter((line) => line !== "");
+  return kept.join(joiner).trim();
+}
+function descriptionIn(block) {
+  const at = block.findIndex((line) => DESCRIPTION_LINE.test(line));
+  if (at === -1)
+    return null;
+  const value = (block[at]?.match(DESCRIPTION_LINE)?.[1] ?? "").trimEnd();
+  const joiner = blockJoiner(value);
+  const text = joiner === undefined ? unquote(value).trim() : blockScalar(block.slice(at + 1), joiner);
+  return text === "" ? null : text;
+}
+async function descriptionOf(abs) {
+  const size = await stat(abs).then((s) => s.size, () => null);
+  if (size === null || size > MAX_DOC_BYTES)
+    return null;
+  let content;
+  try {
+    content = await readFile2(abs, "utf-8");
+  } catch {
+    return null;
+  }
+  const block = frontmatterLines(content);
+  return block === null ? null : descriptionIn(block);
+}
+async function readDescriptionUnder(root, relative) {
+  const abs = await containedFile(root, relative);
+  return abs === null ? null : descriptionOf(abs);
+}
+
+// src/adapters/claude/skills.ts
+var SKILL_FILE = "SKILL.md";
+async function skillNamesUnder(root) {
+  let names;
+  try {
+    names = await readdir(root);
+  } catch {
+    return [];
+  }
+  const found = await Promise.all(names.map((name) => hasSkillFile(join3(root, name))));
+  return names.filter((_, i) => found[i]).sort();
+}
+async function hasSkillFile(dir) {
+  try {
+    await access(join3(dir, SKILL_FILE));
+    return true;
+  } catch {
+    return false;
+  }
+}
+function settingsLayers(cwd) {
+  const userDir = claudeConfigDir();
+  return [
+    userSettingsFile(),
+    join3(userDir, "settings.local.json"),
+    join3(cwd, ".claude", "settings.json"),
+    join3(cwd, ".claude", "settings.local.json")
+  ];
+}
+var userSkillsRoot = () => join3(claudeConfigDir(), "skills");
+var projectSkillsRoot = (cwd) => join3(cwd, ".claude", "skills");
+var pluginSkillsRoot = (install) => join3(install, "skills");
+async function enabledPluginKeys(cwd) {
+  const layers = await Promise.all(settingsLayers(cwd).map((path) => readJsonFile(path)));
+  const merged = {};
+  for (const layer of layers)
+    Object.assign(merged, layer?.enabledPlugins ?? {});
+  return new Set(Object.keys(merged).filter((key) => merged[key] === true));
+}
+function pickInstallPath(installs, cwd) {
+  const usable = installs.filter((install) => typeof install.installPath === "string");
+  const here = usable.find((install) => install.projectPath === cwd);
+  const anywhere = usable.find((install) => install.scope === "user" || install.scope === "managed");
+  return (here ?? anywhere ?? usable[0])?.installPath;
+}
+async function enabledPlugins(cwd) {
+  const [registry, enabled] = await Promise.all([
+    readJsonFile(installedPluginsFile()),
+    enabledPluginKeys(cwd)
+  ]);
+  const out = [];
+  for (const [key, installs] of Object.entries(registry?.plugins ?? {})) {
+    if (!enabled.has(key))
+      continue;
+    const installPath = pickInstallPath(installs ?? [], cwd);
+    if (installPath === undefined)
+      continue;
+    out.push([key.split("@")[0] ?? key, installPath]);
+  }
+  return out.sort(([a], [b]) => a < b ? -1 : a > b ? 1 : 0);
+}
+async function readClaudeSkills(cwd) {
+  const [user, project, plugins] = await Promise.all([
+    skillNamesUnder(userSkillsRoot()),
+    skillNamesUnder(projectSkillsRoot(cwd)),
+    enabledPlugins(cwd)
+  ]);
+  const pluginSkills = await Promise.all(plugins.map(async ([plugin, dir]) => (await skillNamesUnder(pluginSkillsRoot(dir))).map((name) => ({ name: `${plugin}:${name}`, origin: "plugin" }))));
+  return [
+    ...user.map((name) => ({ name, origin: "user" })),
+    ...project.map((name) => ({ name, origin: "project" })),
+    ...pluginSkills.flat()
+  ];
+}
+async function skillDocLocation(cwd, skill) {
+  const under = (root, name) => ({ root, relative: join3(name, SKILL_FILE) });
+  if (skill.origin === "user")
+    return under(userSkillsRoot(), skill.name);
+  if (skill.origin === "project")
+    return under(projectSkillsRoot(cwd), skill.name);
+  if (skill.origin !== "plugin")
+    return null;
+  const at = skill.name.indexOf(":");
+  if (at === -1)
+    return null;
+  const plugin = skill.name.slice(0, at);
+  const hit = (await enabledPlugins(cwd)).find(([key]) => key === plugin);
+  return hit === undefined ? null : under(pluginSkillsRoot(hit[1]), skill.name.slice(at + 1));
+}
+async function readClaudeSkillDescription(cwd, skill) {
+  const at = await skillDocLocation(cwd, skill);
+  return at === null ? null : readDescriptionUnder(at.root, at.relative);
+}
+
 // src/adapters/claude/index.ts
 function toolInputEcho(input) {
   if (!input)
@@ -7177,6 +7356,12 @@ var claudeAdapter = {
   },
   readInstallState() {
     return readClaudeInstallState();
+  },
+  listSkills(cwd) {
+    return readClaudeSkills(cwd);
+  },
+  readSkillDescription(cwd, skill) {
+    return readClaudeSkillDescription(cwd, skill);
   }
 };
 
@@ -7214,7 +7399,7 @@ function fatalDenyLine2(reason) {
 // src/adapters/codex/install.ts
 import { readFileSync as readFileSync2 } from "fs";
 import { homedir as homedir2 } from "os";
-import { join as join2 } from "path";
+import { join as join4 } from "path";
 
 // node_modules/.bun/smol-toml@1.8.0/node_modules/smol-toml/dist/date.js
 /*!
@@ -7468,7 +7653,7 @@ function skipVoid(ctx, banNewLines, banComments) {
     skipComment(ctx);
   }
 }
-function skipUntil(ctx, sep, end) {
+function skipUntil(ctx, sep2, end) {
   let ptr = ctx.p;
   if (!end) {
     ptr = indexOfNewline(ctx.s, ptr);
@@ -7479,7 +7664,7 @@ function skipUntil(ctx, sep, end) {
     let c = ctx.s.charCodeAt(ctx.p);
     if (c === 35) {
       skipComment(ctx);
-    } else if (c === end || c === sep) {
+    } else if (c === end || c === sep2) {
       return;
     }
   }
@@ -8095,14 +8280,14 @@ function parse(toml, { maxDepth = 1000, integersAsBigInt } = {}) {
 
 // src/adapters/codex/install.ts
 function codexConfigDir() {
-  return process.env.CODEX_HOME || join2(homedir2(), ".codex");
+  return process.env.CODEX_HOME || join4(homedir2(), ".codex");
 }
 function readCodexInstallState() {
   const dir = codexConfigDir();
   return {
     pluginVersion: "unknown",
-    pluginEnabled: readCodexHooksFeature(join2(dir, "config.toml")),
-    hookInUserSettings: readHookInUserSettings2(join2(dir, "hooks.json"))
+    pluginEnabled: readCodexHooksFeature(join4(dir, "config.toml")),
+    hookInUserSettings: readHookInUserSettings2(join4(dir, "hooks.json"))
   };
 }
 function readCodexHooksFeature(path) {
@@ -8158,6 +8343,12 @@ var codexAdapter = {
   },
   readInstallState() {
     return readCodexInstallState();
+  },
+  listSkills() {
+    return Promise.resolve([]);
+  },
+  readSkillDescription() {
+    return Promise.resolve(null);
   }
 };
 
@@ -8180,7 +8371,7 @@ function fatalDenyLine3(reason) {
 
 // src/adapters/opencode/install.ts
 import { existsSync as existsSync3, readFileSync as readFileSync4 } from "fs";
-import { join as join5 } from "path";
+import { join as join7 } from "path";
 
 // node_modules/.bun/jsonc-parser@3.3.1/node_modules/jsonc-parser/lib/esm/impl/scanner.js
 function createScanner(text, ignoreTrivia = false) {
@@ -8962,11 +9153,11 @@ function parseTree(text, errors = [], options = ParseOptions.DEFAULT) {
       onValue({ type: getNodeType(value), offset, length, parent: currentParent, value });
       ensurePropertyComplete(offset + length);
     },
-    onSeparator: (sep, offset, length) => {
+    onSeparator: (sep2, offset, length) => {
       if (currentParent.type === "property") {
-        if (sep === ":") {
+        if (sep2 === ":") {
           currentParent.colonOffset = offset;
-        } else if (sep === ",") {
+        } else if (sep2 === ",") {
           ensurePropertyComplete(offset);
         }
       }
@@ -9508,7 +9699,7 @@ function applyEdits(text, edits) {
 // src/adapters/opencode/paths.ts
 import { existsSync, readdirSync } from "fs";
 import { homedir as homedir3 } from "os";
-import { basename, dirname, join as join3 } from "path";
+import { basename, dirname, join as join5 } from "path";
 var CARET_PACKAGE = "@macintacos/caret";
 function localPluginSpecifier(repoDir) {
   return `file:${repoDir}`;
@@ -9530,39 +9721,42 @@ function opencodeConfigDir() {
   if (override)
     return override;
   const xdg = process.env.XDG_CONFIG_HOME?.trim();
-  return join3(xdg || join3(homedir3(), ".config"), "opencode");
+  return join5(xdg || join5(homedir3(), ".config"), "opencode");
 }
 function resolveConfigFile(configDir) {
   for (const name of CONFIG_FILENAMES) {
-    const p = join3(configDir, name);
+    const p = join5(configDir, name);
     if (existsSync(p))
       return p;
   }
-  return join3(configDir, "opencode.json");
+  return join5(configDir, "opencode.json");
 }
 function commandDir(configDir) {
-  return join3(configDir, COMMAND_DIRNAME);
+  return join5(configDir, COMMAND_DIRNAME);
+}
+function commandDirs(configDir) {
+  return [commandDir(configDir), join5(configDir, LEGACY_COMMAND_DIRNAME)];
 }
 var LEGACY_PLUGIN_FILENAME = "caret.ts";
 var LEGACY_PLUGIN_DIRNAMES = ["plugins", "plugin"];
 var LEGACY_COMMAND_DIRNAME = "command";
 function existingLegacyInstallFiles(configDir) {
-  const plugins = LEGACY_PLUGIN_DIRNAMES.map((d) => join3(configDir, d, LEGACY_PLUGIN_FILENAME));
+  const plugins = LEGACY_PLUGIN_DIRNAMES.map((d) => join5(configDir, d, LEGACY_PLUGIN_FILENAME));
   let entries;
   try {
-    entries = readdirSync(join3(configDir, LEGACY_COMMAND_DIRNAME), { withFileTypes: true });
+    entries = readdirSync(join5(configDir, LEGACY_COMMAND_DIRNAME), { withFileTypes: true });
   } catch {
     entries = [];
   }
-  const commands = entries.filter((e) => !e.isDirectory() && e.name.startsWith(COMMAND_NAMESPACE)).filter((e) => e.name.endsWith(".md")).map((e) => join3(configDir, LEGACY_COMMAND_DIRNAME, e.name)).sort();
+  const commands = entries.filter((e) => !e.isDirectory() && e.name.startsWith(COMMAND_NAMESPACE)).filter((e) => e.name.endsWith(".md")).map((e) => join5(configDir, LEGACY_COMMAND_DIRNAME, e.name)).sort();
   return [...plugins, ...commands].filter((p) => existsSync(p));
 }
 function opencodeCachePackagesDir() {
   const xdg = process.env.XDG_CACHE_HOME?.trim();
-  return join3(xdg || join3(homedir3(), ".cache"), "opencode", "packages");
+  return join5(xdg || join5(homedir3(), ".cache"), "opencode", "packages");
 }
 function opencodeCachePackageDir(pkg = CARET_PACKAGE) {
-  return join3(opencodeCachePackagesDir(), pkg);
+  return join5(opencodeCachePackagesDir(), pkg);
 }
 function existingOpencodeCachePackageDirs(pkg = CARET_PACKAGE) {
   const bare = opencodeCachePackageDir(pkg);
@@ -9575,12 +9769,12 @@ function existingOpencodeCachePackageDirs(pkg = CARET_PACKAGE) {
     return [];
   }
   const pinned = names.filter((n) => n.startsWith(`${leaf}@`)).sort();
-  return [...names.includes(leaf) ? [bare] : [], ...pinned.map((n) => join3(parent, n))];
+  return [...names.includes(leaf) ? [bare] : [], ...pinned.map((n) => join5(parent, n))];
 }
 
 // src/adapters/opencode/upgrade.ts
 import { existsSync as existsSync2, readFileSync as readFileSync3, rmSync } from "fs";
-import { join as join4 } from "path";
+import { join as join6 } from "path";
 
 // src/adapters/opencode/config-plugin.ts
 var FORMATTING = { insertSpaces: true, tabSize: 2 };
@@ -9647,9 +9841,7 @@ function removePluginFromConfigText(existing, pkg) {
   return applyEdits(existing, edits);
 }
 
-// src/adapters/opencode/upgrade.ts
-var NPM_LATEST_URL = `https://registry.npmjs.org/${CARET_PACKAGE}/latest`;
-var NPM_TIMEOUT_MS = 3000;
+// src/lib/semver.ts
 function parseVersionTriple(v) {
   const m = v.trim().replace(/^v/, "").match(/^(\d+)\.(\d+)\.(\d+)/);
   return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : null;
@@ -9667,6 +9859,8 @@ function isNewer(latest, current) {
     return a1 > b1;
   return a2 > b2;
 }
+
+// src/adapters/opencode/upgrade.ts
 function upgradeVerdict(input) {
   const { entry, cached, published } = input;
   if (published === null) {
@@ -9691,7 +9885,7 @@ function upgradeVerdict(input) {
 function readCachedCaretVersion(dirs = existingOpencodeCachePackageDirs()) {
   for (const d of dirs) {
     try {
-      const deps = JSON.parse(readFileSync3(join4(d, "package.json"), "utf-8")).dependencies;
+      const deps = JSON.parse(readFileSync3(join6(d, "package.json"), "utf-8")).dependencies;
       const v = deps?.[CARET_PACKAGE];
       if (typeof v === "string" && v.length > 0)
         return v;
@@ -9709,18 +9903,6 @@ function clearCachedCaret(dirs = existingOpencodeCachePackageDirs()) {
   }
   return cleared;
 }
-async function publishedCaretVersion(fetchImpl = fetch) {
-  try {
-    const res = await fetchImpl(NPM_LATEST_URL, { signal: AbortSignal.timeout(NPM_TIMEOUT_MS) });
-    if (!res.ok)
-      return null;
-    const body = await res.json();
-    const v = body?.version;
-    return typeof v === "string" && v.length > 0 ? v : null;
-  } catch {
-    return null;
-  }
-}
 
 // src/adapters/opencode/install.ts
 function readOpencodeInstallState() {
@@ -9738,7 +9920,7 @@ function readOpencodeInstallState() {
 function readCaretInPluginArray(dir) {
   let sawConfig = false;
   for (const name of CONFIG_FILENAMES) {
-    const path = join5(dir, name);
+    const path = join7(dir, name);
     if (!existsSync3(path))
       continue;
     let cfg;
@@ -9758,6 +9940,33 @@ function readCaretInPluginArray(dir) {
   return sawConfig ? false : "unknown";
 }
 
+// src/adapters/opencode/skills.ts
+import { readdir as readdir2 } from "fs/promises";
+import { sep as sep2 } from "path";
+async function commandNamesUnder(dir) {
+  let entries;
+  try {
+    entries = await readdir2(dir, { recursive: true });
+  } catch {
+    return [];
+  }
+  return entries.filter((rel) => rel.endsWith(".md")).map((rel) => rel.slice(0, -".md".length).split(sep2).join("/"));
+}
+async function readOpencodeCommands() {
+  const perDir = await Promise.all(commandDirs(opencodeConfigDir()).map(commandNamesUnder));
+  const names = new Set(perDir.flat());
+  return [...names].sort().map((name) => ({ name, origin: "command" }));
+}
+async function readOpencodeCommandDescription(name) {
+  const relative = `${name}.md`;
+  for (const dir of commandDirs(opencodeConfigDir())) {
+    const abs = await containedFile(dir, relative);
+    if (abs !== null)
+      return descriptionOf(abs);
+  }
+  return null;
+}
+
 // src/adapters/opencode/index.ts
 var opencodeAdapter = {
   id: "opencode",
@@ -9784,6 +9993,12 @@ var opencodeAdapter = {
   },
   readInstallState() {
     return readOpencodeInstallState();
+  },
+  listSkills() {
+    return readOpencodeCommands();
+  },
+  readSkillDescription(_cwd, skill) {
+    return readOpencodeCommandDescription(skill.name);
   }
 };
 
@@ -9824,7 +10039,7 @@ function fatalDeny(reason) {
 
 // src/commands/daemon.ts
 import { randomUUID } from "crypto";
-import { existsSync as existsSync7, unlinkSync as unlinkSync4 } from "fs";
+import { existsSync as existsSync7 } from "fs";
 
 // src/config/settings.ts
 import { readFileSync as readFileSync7, statSync as statSync2 } from "fs";
@@ -24208,6 +24423,9 @@ function configFile() {
 function prefsFile() {
   return `${stateDir()}/prefs.json`;
 }
+function updateCheckFile() {
+  return `${stateDir()}/update-check.json`;
+}
 function logsDir() {
   return `${stateDir()}/logs`;
 }
@@ -24254,7 +24472,7 @@ import { createHash } from "crypto";
 
 // src/ui/assets.ts
 import { readdirSync as readdirSync2 } from "fs";
-import { dirname as dirname2, join as join6, relative } from "path";
+import { dirname as dirname2, join as join8, relative } from "path";
 import { fileURLToPath } from "url";
 function fromPathMap(map2) {
   const paths = Object.keys(map2).sort();
@@ -24270,7 +24488,7 @@ function assetsFromDist(distDir) {
   const map2 = {};
   const walk = (dir) => {
     for (const ent of readdirSync2(dir, { withFileTypes: true })) {
-      const full = join6(dir, ent.name);
+      const full = join8(dir, ent.name);
       if (ent.isDirectory())
         walk(full);
       else if (ent.isFile())
@@ -24302,13 +24520,13 @@ async function loadUiAssets() {
     if (fromDist)
       return fromDist;
   }
-  const besideDist = join6(dirname2(process.execPath), "ui");
+  const besideDist = join8(dirname2(process.execPath), "ui");
   return assetsFromDist(besideDist);
 }
 // package.json
 var package_default = {
   name: "@macintacos/caret",
-  version: "0.12.0",
+  version: "0.14.0",
   license: "MIT",
   type: "module",
   description: "A Claude Code plugin that replaces the terminal plan-approval prompt with a local web UI for inline review, annotation, and approval.",
@@ -24344,6 +24562,7 @@ var package_default = {
   },
   devDependencies: {
     "@clack/prompts": "^1.7.0",
+    "@codemirror/autocomplete": "^6.20.3",
     "@codemirror/commands": "^6.10.3",
     "@codemirror/lang-markdown": "^6.5.0",
     "@codemirror/language": "^6.12.3",
@@ -25013,6 +25232,53 @@ function warnInvalidEnvVars(warn) {
     warn(`${name} invalid; using config/default`);
 }
 
+// src/config/prefs.ts
+import { readFile as readFile3, writeFile } from "fs/promises";
+import { dirname as dirname4 } from "path";
+var DEFAULT_SET = { valid: ["default"], fallback: "default" };
+async function readApproveMode(file2 = prefsFile(), log = noopLogger, set2 = DEFAULT_SET) {
+  try {
+    const parsed = JSON.parse(await readFile3(file2, "utf-8"));
+    if (typeof parsed.approveMode === "string" && set2.valid.includes(parsed.approveMode)) {
+      return parsed.approveMode;
+    }
+    log.debug("prefs", "unrecognized approve mode; using default");
+    return set2.fallback;
+  } catch (err) {
+    const absent = err?.code === "ENOENT";
+    log.debug("prefs", absent ? "no prefs file; using default approve mode" : "prefs unreadable; using default approve mode");
+    return set2.fallback;
+  }
+}
+async function readUpdatesCheck(file2 = prefsFile()) {
+  const parsed = await readJsonFile(file2);
+  return parsed?.updates?.check !== false;
+}
+function createPrefsWriter(file2 = prefsFile()) {
+  let tail = Promise.resolve();
+  return {
+    merge(patch) {
+      const next = tail.then(async () => {
+        ensureStateDir(dirname4(file2));
+        const existing = await readJsonFile(file2) ?? {};
+        await writeFile(file2, JSON.stringify({ ...existing, ...patch }, null, 2), {
+          mode: 384
+        });
+      });
+      tail = next.catch(() => {});
+      return next;
+    }
+  };
+}
+async function writeApproveMode(mode, writer, log = noopLogger, set2 = DEFAULT_SET) {
+  if (!set2.valid.includes(mode)) {
+    log.warn("prefs", "ignoring invalid approve mode");
+    return;
+  }
+  await writer.merge({ approveMode: mode });
+  log.debug("prefs", `approve mode saved: ${mode}`);
+}
+
 // src/daemon/diagnostics.ts
 function buildDiagnostics(deps) {
   return {
@@ -25165,6 +25431,10 @@ function removeDaemonLock() {
     unlinkSync2(daemonLock());
   } catch {}
 }
+function removeOwnDaemonLock() {
+  if (readDaemonLock()?.pid === process.pid)
+    removeDaemonLock();
+}
 async function retireDaemon(baseUrl, lock, currentStateDir, kill = (pid, sig) => process.kill(pid, sig)) {
   try {
     const res = await fetch(`${baseUrl}/api/retire`, {
@@ -25237,34 +25507,6 @@ async function prodEnsureDeps(s) {
 import { renameSync as renameSync3, unlinkSync as unlinkSync3, writeFileSync as writeFileSync5 } from "fs";
 import { dirname as dirname6 } from "path";
 
-// src/config/prefs.ts
-import { readFile as readFile2, writeFile } from "fs/promises";
-import { dirname as dirname4 } from "path";
-var DEFAULT_SET = { valid: ["default"], fallback: "default" };
-async function readApproveMode(file2 = prefsFile(), log = noopLogger, set2 = DEFAULT_SET) {
-  try {
-    const parsed = JSON.parse(await readFile2(file2, "utf-8"));
-    if (typeof parsed.approveMode === "string" && set2.valid.includes(parsed.approveMode)) {
-      return parsed.approveMode;
-    }
-    log.debug("prefs", "unrecognized approve mode; using default");
-    return set2.fallback;
-  } catch (err) {
-    const absent = err?.code === "ENOENT";
-    log.debug("prefs", absent ? "no prefs file; using default approve mode" : "prefs unreadable; using default approve mode");
-    return set2.fallback;
-  }
-}
-async function writeApproveMode(mode, file2 = prefsFile(), log = noopLogger, set2 = DEFAULT_SET) {
-  if (!set2.valid.includes(mode)) {
-    log.warn("prefs", "ignoring invalid approve mode");
-    return;
-  }
-  ensureStateDir(dirname4(file2));
-  await writeFile(file2, JSON.stringify({ approveMode: mode }, null, 2), { mode: 384 });
-  log.debug("prefs", `approve mode saved: ${mode}`);
-}
-
 // src/daemon/guards.ts
 var LIVE_CLIENT_WINDOW_MS = 120000;
 function isClientLive(lastPollAt, now, windowMs) {
@@ -25273,17 +25515,33 @@ function isClientLive(lastPollAt, now, windowMs) {
 function isSafeMethod(method) {
   return method === "GET" || method === "HEAD";
 }
-function isCrossOrigin(req) {
-  const origin = req.headers.get("origin");
-  if (origin) {
-    try {
-      const host = new URL(origin).hostname;
-      if (host !== "127.0.0.1" && host !== "localhost" && host !== VANITY_HOST)
-        return true;
-    } catch {
-      return true;
-    }
+var OWN_HOSTNAMES = new Set(["127.0.0.1", "localhost", VANITY_HOST]);
+function isOwnAuthority(authority, port) {
+  try {
+    const u = new URL(`http://${authority}`);
+    if (u.href !== `http://${u.host}/`)
+      return false;
+    return OWN_HOSTNAMES.has(u.hostname) && (u.port || "80") === String(port);
+  } catch {
+    return false;
   }
+}
+function isForeignHost(req, port) {
+  const host = req.headers.get("host");
+  return host === null || !isOwnAuthority(host, port);
+}
+function isOwnOrigin(origin, port) {
+  try {
+    const u = new URL(origin);
+    return u.protocol === "http:" && isOwnAuthority(u.host, port);
+  } catch {
+    return false;
+  }
+}
+function isCrossOrigin(req, port) {
+  const origin = req.headers.get("origin");
+  if (origin && !isOwnOrigin(origin, port))
+    return true;
   const site = req.headers.get("sec-fetch-site");
   if (site && site !== "same-origin" && site !== "none")
     return true;
@@ -25301,12 +25559,14 @@ var PlanInputSchema = exports_external.object({
 }).catch({});
 var MAX_FILE_REFS = 1000;
 var FileRefsBodySchema = exports_external.object({ paths: exports_external.array(exports_external.string()).catch([]) }).catch({ paths: [] });
+var FileSearchBodySchema = exports_external.object({ query: exports_external.string().catch("") }).catch({ query: "" });
 var BehaviorSchema = exports_external.enum(["allow", "deny"]);
 var ResolveBodySchema = exports_external.object({
   behavior: BehaviorSchema.catch("allow"),
   feedback: exports_external.string().optional(),
   acceptMode: exports_external.string().optional().catch(undefined)
 }).catch({ behavior: "allow" });
+var PrefsPatchSchema = exports_external.object({ updates: exports_external.object({ check: exports_external.boolean() }).strict().optional() }).strict();
 var LineAnnotationSchema = exports_external.object({
   id: exports_external.string(),
   startLine: exports_external.number().int().min(1),
@@ -25389,13 +25649,13 @@ function markPaneRead(pane, deps = {}) {
 }
 
 // src/plan/directory.ts
-import { readdir as readdir2 } from "fs/promises";
-import { join as join8, relative as relative3, sep as sep2 } from "path";
+import { readdir as readdir4 } from "fs/promises";
+import { join as join10, relative as relative3, sep as sep4 } from "path";
 
 // src/plan/excerpt.ts
 import { readFileSync as readFileSync8 } from "fs";
-import { readdir, realpath, stat } from "fs/promises";
-import { extname, isAbsolute, join as join7, relative as relative2, resolve, sep } from "path";
+import { readdir as readdir3, realpath as realpath2, stat as stat2 } from "fs/promises";
+import { extname, isAbsolute, join as join9, relative as relative2, resolve, sep as sep3 } from "path";
 var EXCERPT_HEAD_LINES = 60;
 var MAX_EXCERPT_BYTES = 10 * 1024 * 1024;
 var MAX_SCAN_ENTRIES = 5000;
@@ -25451,16 +25711,16 @@ function languageForPath(path) {
   return EXT_LANGUAGE[extname(path).toLowerCase()] ?? "text";
 }
 function safeRealpath(path) {
-  return realpath(path).catch(() => null);
+  return realpath2(path).catch(() => null);
 }
 function safeStat(path) {
-  return stat(path).catch(() => null);
+  return stat2(path).catch(() => null);
 }
 async function contained(cwdReal, abs) {
   const real = await safeRealpath(abs);
   if (real === null)
     return null;
-  if (real !== cwdReal && !real.startsWith(cwdReal + sep))
+  if (real !== cwdReal && !real.startsWith(cwdReal + sep3))
     return null;
   const stats = await safeStat(real);
   if (stats === null)
@@ -25476,7 +25736,7 @@ async function basenameSearch(cwdReal, name) {
     const currentDir = queue.shift();
     let entries;
     try {
-      entries = await readdir(currentDir, { withFileTypes: true });
+      entries = await readdir3(currentDir, { withFileTypes: true });
     } catch {
       continue;
     }
@@ -25485,9 +25745,9 @@ async function basenameSearch(cwdReal, name) {
         return null;
       if (entry.isFile()) {
         if (entry.name === name)
-          return join7(currentDir, entry.name);
+          return join9(currentDir, entry.name);
       } else if (entry.isDirectory() && !SKIP_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
-        queue.push(join7(currentDir, entry.name));
+        queue.push(join9(currentDir, entry.name));
       }
     }
   }
@@ -25599,13 +25859,13 @@ async function listDirectory(cwd, root, path) {
   if (target === null || target.kind !== "directory")
     return null;
   const rel = relative3(rootHit.path, target.path);
-  if (rel === ".." || rel.startsWith(`..${sep2}`))
+  if (rel === ".." || rel.startsWith(`..${sep4}`))
     return null;
-  if (rel !== "" && rel.split(sep2).length > MAX_DIR_DEPTH)
+  if (rel !== "" && rel.split(sep4).length > MAX_DIR_DEPTH)
     return null;
   let dirents;
   try {
-    dirents = await readdir2(target.path, { withFileTypes: true });
+    dirents = await readdir4(target.path, { withFileTypes: true });
   } catch {
     return null;
   }
@@ -25619,7 +25879,7 @@ async function listDirectory(cwd, root, path) {
     else if (d.isSymbolicLink())
       links.push(d);
   }
-  const targets = await Promise.all(links.map((d) => resolveInCwd(cwd, join8(target.path, d.name))));
+  const targets = await Promise.all(links.map((d) => resolveInCwd(cwd, join10(target.path, d.name))));
   targets.forEach((hit, i) => {
     const link = links[i];
     if (hit !== null && link !== undefined)
@@ -25634,6 +25894,78 @@ async function listDirectory(cwd, root, path) {
   };
 }
 
+// src/plan/file-search.ts
+import { readdir as readdir5 } from "fs/promises";
+import { isAbsolute as isAbsolute2, join as join11 } from "path";
+var SEARCH_BUDGET = { dirents: 20000, results: 50 };
+var MAX_SEARCH_QUERY_CHARS = 128;
+function subsequence(haystack, needle) {
+  let i = 0;
+  for (let h = 0;h < haystack.length && i < needle.length; h++) {
+    if (haystack[h] === needle[i])
+      i++;
+  }
+  return i === needle.length;
+}
+function relPath(dir, name) {
+  return dir === "" ? name : `${dir}/${name}`;
+}
+function partition(dirents, allowance) {
+  const files = [];
+  const dirs = [];
+  let scanned = 0;
+  for (const entry of dirents) {
+    if (scanned >= allowance)
+      return { files, dirs, scanned, cut: true };
+    scanned++;
+    if (entry.name === ".git")
+      continue;
+    if (entry.isFile())
+      files.push(entry.name);
+    else if (entry.isDirectory() && !SKIP_DIRS.has(entry.name) && !entry.name.startsWith(".")) {
+      dirs.push(entry.name);
+    }
+  }
+  files.sort();
+  dirs.sort();
+  return { files, dirs, scanned, cut: false };
+}
+async function searchFiles(cwd, query, budget = SEARCH_BUDGET) {
+  if (cwd === "" || !isAbsolute2(cwd))
+    return null;
+  const cwdReal = await safeRealpath(cwd);
+  if (cwdReal === null)
+    return null;
+  const needle = query.slice(0, MAX_SEARCH_QUERY_CHARS).toLowerCase();
+  const paths = [];
+  const queue = [""];
+  let scanned = 0;
+  while (queue.length > 0) {
+    const rel = queue.shift();
+    let dirents;
+    try {
+      dirents = await readdir5(join11(cwdReal, rel), { withFileTypes: true });
+    } catch {
+      continue;
+    }
+    const level = partition(dirents, budget.dirents - scanned);
+    scanned += level.scanned;
+    if (level.cut)
+      return { paths, stoppedAt: "scan" };
+    for (const name of level.files) {
+      const path = relPath(rel, name);
+      if (!subsequence(path.toLowerCase(), needle))
+        continue;
+      if (paths.length === budget.results)
+        return { paths, stoppedAt: "results" };
+      paths.push(path);
+    }
+    for (const name of level.dirs)
+      queue.push(relPath(rel, name));
+  }
+  return { paths, stoppedAt: null };
+}
+
 // src/review/decisions.ts
 function createDecisions(log = noopLogger) {
   const pending = new Map;
@@ -25710,7 +26042,7 @@ import { createHash as createHash2 } from "crypto";
 import { chmodSync as chmodSync3, existsSync as existsSync6, mkdirSync as mkdirSync2, renameSync as renameSync2, writeFileSync as writeFileSync4 } from "fs";
 import { mkdtemp, rm } from "fs/promises";
 import { tmpdir } from "os";
-import { dirname as dirname5, join as join9 } from "path";
+import { dirname as dirname5, join as join12 } from "path";
 var RUMDL_VERSION = "0.2.54";
 var ASSETS = {
   "darwin-arm64": {
@@ -25753,14 +26085,14 @@ async function downloadRumdl(binPath, asset, fetchImpl = fetch) {
   if (actual !== asset.sha256) {
     throw new Error(`rumdl: checksum mismatch for ${asset.url} (expected ${asset.sha256}, got ${actual})`);
   }
-  const work = await mkdtemp(join9(tmpdir(), "caret-rumdl-"));
+  const work = await mkdtemp(join12(tmpdir(), "caret-rumdl-"));
   try {
-    const archive = join9(work, "rumdl.tar.gz");
+    const archive = join12(work, "rumdl.tar.gz");
     await Bun.write(archive, bytes);
     const tar = Bun.spawn(["tar", "-xzf", archive, "-C", work], { stderr: "pipe" });
     if (await tar.exited !== 0)
       throw new Error(`rumdl: failed to extract ${asset.url}`);
-    const extracted = join9(work, "rumdl");
+    const extracted = join12(work, "rumdl");
     if (!existsSync6(extracted))
       throw new Error(`rumdl: binary not found in ${asset.url}`);
     mkdirSync2(dirname5(binPath), { recursive: true });
@@ -25992,6 +26324,7 @@ var PLACEHOLDER_HTML = `<!doctype html><html lang="en"><head><meta charset="utf-
 var INDEX_CACHE_CONTROL = "no-cache";
 var ASSET_CACHE_CONTROL = "public, max-age=31536000, immutable";
 var INDEX_PATH = "/index.html";
+var FILE_REF_BATCH = 64;
 function resolveOptions(opts) {
   return {
     store: opts.store,
@@ -26008,12 +26341,16 @@ function resolveOptions(opts) {
     instanceId: opts.instanceId,
     approveVariants: opts.approveVariants,
     source: opts.source,
+    listSkills: opts.listSkills,
+    readSkillDescription: opts.readSkillDescription,
     diagnostics: opts.diagnostics,
+    updateReport: opts.updateReport,
+    onUpdatesEnabled: opts.onUpdatesEnabled,
     markPaneRead: opts.markPaneRead ?? ((pane) => markPaneRead(pane, { log: opts.log })),
     log: opts.log ?? noopLogger
   };
 }
-var ID_ROUTE_RE = /^\/api\/reviews\/([^/]+)(\/decision|\/resolve|\/draft|\/expire|\/seen|\/file-refs|\/file|\/dir)?$/;
+var ID_ROUTE_RE = /^\/api\/reviews\/([^/]+)(\/decision|\/resolve|\/draft|\/expire|\/seen|\/file-refs|\/file-search|\/file|\/dir|\/skills|\/skill-description)?$/;
 function matchIdRoute(path) {
   const m = path.match(ID_ROUTE_RE);
   if (!m)
@@ -26026,6 +26363,7 @@ function createServer(opts) {
   const { buildId, commit, stateDir: stateDir2, instanceId, approveVariants, source, lockPath } = cfg;
   const { awaitDecision, resolveDecision, clearDecision, openDecisionCount } = createDecisions(log);
   const approveModeSet = approveVariants && approveVariants.length > 0 ? { valid: approveVariants.map((v) => v.id), fallback: approveVariants[0]?.id ?? "default" } : { valid: ["default"], fallback: "default" };
+  const prefsWriter = createPrefsWriter(prefsPath);
   function raceDecision(id, ms) {
     return new Promise((resolve2) => {
       const t = setTimeout(() => resolve2(null), ms);
@@ -26094,6 +26432,11 @@ function createServer(opts) {
       return notFound();
     return Response.json(cfg.diagnostics());
   }
+  async function handleUpdate() {
+    if (!cfg.updateReport)
+      return notFound();
+    return Response.json(await cfg.updateReport());
+  }
   function handleRetire() {
     log.info("retire", "retire requested");
     setTimeout(() => {
@@ -26167,7 +26510,23 @@ function createServer(opts) {
     return new Response(null, { status: 204 });
   }
   async function handlePrefs() {
-    return Response.json({ approveMode: await readApproveMode(prefsPath, log, approveModeSet) });
+    const body = {
+      approveMode: await readApproveMode(prefsPath, log, approveModeSet)
+    };
+    return Response.json(body);
+  }
+  async function handleSetPrefs(req) {
+    const parsed = PrefsPatchSchema.safeParse(await req.json().catch(() => null));
+    if (!parsed.success) {
+      const error51 = parsed.error.issues[0]?.message ?? "invalid prefs patch";
+      log.warn("prefs", "prefs patch rejected", { reason: error51 });
+      return Response.json({ error: error51 }, { status: 400 });
+    }
+    await prefsWriter.merge(parsed.data);
+    log.debug("prefs", "prefs saved");
+    if (parsed.data.updates?.check === true)
+      cfg.onUpdatesEnabled?.();
+    return Response.json({ ok: true });
   }
   function handleGetReview(id) {
     const r = store.get(id);
@@ -26187,10 +26546,13 @@ function createServer(opts) {
       if (unique.push(p) === MAX_FILE_REFS)
         break;
     }
-    const entries = await Promise.all(unique.map(async (p) => {
-      const hit = await resolveInCwd(r.cwd, p);
-      return hit === null ? null : [p, hit.kind];
-    }));
+    const entries = [];
+    for (let i = 0;i < unique.length; i += FILE_REF_BATCH) {
+      entries.push(...await Promise.all(unique.slice(i, i + FILE_REF_BATCH).map(async (p) => {
+        const hit = await resolveInCwd(r.cwd, p);
+        return hit === null ? null : [p, hit.kind];
+      })));
+    }
     const resolved = Object.fromEntries(entries.filter((e) => e !== null));
     log.debug("request", `file-refs resolved: ${Object.keys(resolved).length}/${unique.length}`, {
       reviewId: id,
@@ -26233,6 +26595,45 @@ function createServer(opts) {
     });
     return Response.json(listing);
   }
+  async function handleSkills(id) {
+    if (!cfg.listSkills)
+      return notFound();
+    const r = store.get(id);
+    if (!r)
+      return notFound();
+    const skills = await cfg.listSkills(r.cwd);
+    log.debug("request", "skills listed", { reviewId: id, count: skills.length });
+    return Response.json(skills);
+  }
+  async function handleSkillDescription(req, id) {
+    if (!cfg.readSkillDescription)
+      return notFound();
+    const r = store.get(id);
+    if (!r)
+      return notFound();
+    const params = new URL(req.url).searchParams;
+    const description = await cfg.readSkillDescription(r.cwd, {
+      name: params.get("name") ?? "",
+      origin: params.get("origin") ?? ""
+    });
+    log.debug("request", "skill description read", { reviewId: id, found: description !== null });
+    return Response.json({ description });
+  }
+  async function handleFileSearch(req, id) {
+    const r = store.get(id);
+    if (!r)
+      return notFound();
+    const { query } = await parseBody(req, FileSearchBodySchema);
+    const result = await searchFiles(r.cwd, query);
+    if (result === null)
+      return notFound();
+    log.debug("request", "file search answered", {
+      reviewId: id,
+      returned: result.paths.length,
+      stoppedAt: result.stoppedAt
+    });
+    return Response.json(result);
+  }
   async function handleDecision(id) {
     const inMem = store.get(id);
     if (inMem?.decision) {
@@ -26300,7 +26701,7 @@ function createServer(opts) {
       store.bumpEpoch(existing.sessionId);
       await store.remove(id);
       if (decision.acceptMode !== undefined && approveModeSet.valid.includes(decision.acceptMode)) {
-        writeApproveMode(decision.acceptMode, prefsPath, log, approveModeSet).catch(() => {
+        writeApproveMode(decision.acceptMode, prefsWriter, log, approveModeSet).catch(() => {
           log.warn("prefs", "approve mode write failed");
         });
       }
@@ -26340,6 +26741,8 @@ function createServer(opts) {
       return handleHealth();
     if (method === "GET" && path === "/api/diagnostics")
       return handleDiagnostics();
+    if (method === "GET" && path === "/api/update")
+      return handleUpdate();
     if (method === "POST" && path === "/api/retire")
       return handleRetire();
     if (method === "GET" && (path === "/" || path === INDEX_PATH))
@@ -26354,6 +26757,8 @@ function createServer(opts) {
       return handleListReviews();
     if (method === "GET" && path === "/api/prefs")
       return handlePrefs();
+    if (method === "POST" && path === "/api/prefs")
+      return handleSetPrefs(req);
     const route = matchIdRoute(path);
     if (route) {
       const { id, sub } = route;
@@ -26363,8 +26768,15 @@ function createServer(opts) {
         return handleFileExcerpt(req, id);
       if (method === "GET" && sub === "/dir")
         return handleDirListing(req, id);
+      if (method === "GET" && sub === "/skills")
+        return handleSkills(id);
+      if (method === "GET" && sub === "/skill-description") {
+        return handleSkillDescription(req, id);
+      }
       if (method === "POST" && sub === "/file-refs")
         return handleFileRefs(req, id);
+      if (method === "POST" && sub === "/file-search")
+        return handleFileSearch(req, id);
       if (method === "GET" && sub === "/decision")
         return handleDecision(id);
       if (method === "PUT" && sub === "/draft")
@@ -26383,14 +26795,18 @@ function createServer(opts) {
     }
     return notFound();
   }
-  async function handle(req) {
+  async function handle(req, self) {
     inFlight++;
     cancelIdle();
     try {
+      const port = self.port ?? -1;
+      if (isForeignHost(req, port)) {
+        return new Response("host not recognized", { status: 403 });
+      }
       const url2 = new URL(req.url);
       const path = url2.pathname;
       const method = req.method;
-      if (!isSafeMethod(method) && isCrossOrigin(req)) {
+      if (!isSafeMethod(method) && isCrossOrigin(req, port)) {
         return new Response("cross-origin request blocked", { status: 403 });
       }
       return await dispatch(req, method, path);
@@ -26455,9 +26871,153 @@ function createServer(opts) {
   return { port: server.port ?? 0, stop };
 }
 
+// src/daemon/update-check.ts
+import { writeFileSync as writeFileSync6 } from "fs";
+import { dirname as dirname7 } from "path";
+var CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000;
+var REFRESH_COMMAND = "bunx --no-cache @macintacos/caret@latest install --refresh";
+var REBUILD_COMMAND = "mise run build --install";
+var NEEDS_COMPARE = "could not compare this build against trunk";
+var NEVER_CHECKED = {
+  kind: "unknown",
+  reason: "no update check has run for this build yet"
+};
+var DISABLED = { kind: "unavailable", reason: "disabled" };
+function updateStatusFor(facts) {
+  if (facts.kind === "dev")
+    return { kind: "unavailable", reason: "dev" };
+  if (facts.kind === "bundle") {
+    if (facts.npmLatest === null)
+      return unknown2("could not reach npm for the published version");
+    return isNewer(facts.npmLatest, facts.version) ? { kind: "behind-release", available: facts.npmLatest, command: REFRESH_COMMAND } : { kind: "current" };
+  }
+  if (facts.release === null)
+    return unknown2("could not reach GitHub for the newest release");
+  if (isNewer(facts.release, facts.version)) {
+    return { kind: "behind-release", available: facts.release, command: REFRESH_COMMAND };
+  }
+  if (facts.commit === "unknown")
+    return { kind: "current" };
+  if (facts.aheadBy === null)
+    return unknown2(NEEDS_COMPARE);
+  return facts.aheadBy > 0 ? { kind: "behind-commit", aheadBy: facts.aheadBy, command: REBUILD_COMMAND } : { kind: "current" };
+}
+function updateReportFor(identity, status, checkEnabled) {
+  const devBuild = status.kind === "unavailable" && status.reason === "dev";
+  return { ...identity, checkEnabled, status: checkEnabled || devBuild ? status : DISABLED };
+}
+function readCachedStatus(cache, version2, commit) {
+  const rec = cache.read();
+  if (!rec || rec.version !== version2 || rec.commit !== commit)
+    return NEVER_CHECKED;
+  return rec.status;
+}
+async function runUpdateCheck(deps) {
+  if (deps.kind === "dev")
+    return { kind: "unavailable", reason: "dev" };
+  try {
+    if (!await deps.enabled())
+      return null;
+    const now = deps.now();
+    const prev = deps.cache.read();
+    const sameBuild = prev?.version === deps.version && prev?.commit === deps.commit;
+    if (prev && sameBuild && Math.abs(now - prev.checkedAt) < CHECK_INTERVAL_MS)
+      return null;
+    const record2 = (status2) => {
+      deps.cache.write({ checkedAt: now, version: deps.version, commit: deps.commit, status: status2 });
+    };
+    record2(prev && sameBuild ? prev.status : NEVER_CHECKED);
+    const status = await gather(deps);
+    record2(status);
+    deps.log.info("update", `update check: ${status.kind}`, status.kind === "unknown" ? { detail: status.reason } : undefined);
+    return status;
+  } catch (err) {
+    deps.log.warn("update", "update check failed", { detail: errorMessage(err) });
+    return unknown2("the update check failed");
+  }
+}
+function fileUpdateCache(path) {
+  return {
+    read: () => asRecord(readJsonFileSync(path)),
+    write: (entry) => {
+      try {
+        ensureStateDir(dirname7(path));
+        writeFileSync6(path, JSON.stringify(entry, null, 2), { mode: 384 });
+      } catch {}
+    }
+  };
+}
+async function gather(deps) {
+  const base = { kind: deps.kind, version: deps.version, commit: deps.commit };
+  if (deps.kind === "bundle") {
+    return updateStatusFor({
+      ...base,
+      npmLatest: await deps.npmLatest(),
+      release: null,
+      aheadBy: null
+    });
+  }
+  const release = await deps.release();
+  const first = updateStatusFor({ ...base, npmLatest: null, release, aheadBy: null });
+  if (first.kind !== "unknown" || first.reason !== NEEDS_COMPARE)
+    return first;
+  const aheadBy = await deps.aheadBy(deps.commit);
+  return updateStatusFor({ ...base, npmLatest: null, release, aheadBy });
+}
+function asRecord(value) {
+  const r = value;
+  if (typeof r?.checkedAt !== "number")
+    return null;
+  if (typeof r.version !== "string" || typeof r.commit !== "string")
+    return null;
+  if (typeof r.status?.kind !== "string")
+    return null;
+  return r;
+}
+function unknown2(reason) {
+  return { kind: "unknown", reason };
+}
+
+// src/lib/upstream.ts
+var NPM_LATEST_URL = `https://registry.npmjs.org/${package_default.name}/latest`;
+var LATEST_RELEASE_URL = "https://api.github.com/repos/macintacos/caret/releases/latest";
+var COMPARE_URL = "https://api.github.com/repos/macintacos/caret/compare";
+var UPSTREAM_TIMEOUT_MS = 3000;
+var GITHUB_HEADERS = { "user-agent": "caret" };
+async function readJson(url2, fetchImpl, headers) {
+  try {
+    const res = await fetchImpl(url2, {
+      signal: AbortSignal.timeout(UPSTREAM_TIMEOUT_MS),
+      ...headers ? { headers } : {}
+    });
+    return res.ok ? await res.json() : null;
+  } catch {
+    return null;
+  }
+}
+async function publishedCaretVersion(fetchImpl = fetch) {
+  const body = await readJson(NPM_LATEST_URL, fetchImpl);
+  const v = body?.version;
+  return typeof v === "string" && v.length > 0 ? v : null;
+}
+async function latestReleaseTag(fetchImpl = fetch) {
+  const body = await readJson(LATEST_RELEASE_URL, fetchImpl, GITHUB_HEADERS);
+  const tag = body?.tag_name;
+  if (typeof tag !== "string" || tag.length === 0)
+    return null;
+  const stripped = tag.replace(/^v/, "");
+  return stripped.length > 0 ? stripped : null;
+}
+async function commitsAheadOfTrunk(commit, fetchImpl = fetch) {
+  const url2 = `${COMPARE_URL}/${encodeURIComponent(commit)}...trunk`;
+  const body = await readJson(url2, fetchImpl, GITHUB_HEADERS);
+  const ahead = body?.ahead_by;
+  return typeof ahead === "number" && Number.isFinite(ahead) ? ahead : null;
+}
+
 // src/review/store.ts
-import { readdir as readdir3, readFile as readFile3, writeFile as writeFile2 } from "fs/promises";
-import { join as join10 } from "path";
+import { readdir as readdir6, readFile as readFile4, writeFile as writeFile2 } from "fs/promises";
+import { join as join13 } from "path";
 function createStore(dir, log = noopLogger) {
   const reviews = new Map;
   const epochs = new Map;
@@ -26466,7 +27026,7 @@ function createStore(dir, log = noopLogger) {
     const prev = writeChains.get(review.id) ?? Promise.resolve();
     const next = prev.catch(() => {}).then(async () => {
       ensureStateDir(dir);
-      await writeFile2(join10(dir, `${review.id}.json`), JSON.stringify(review, null, 2), {
+      await writeFile2(join13(dir, `${review.id}.json`), JSON.stringify(review, null, 2), {
         mode: 384
       });
       log.debug("store", `review persisted: ${shortId(review.id)}`, { reviewId: review.id });
@@ -26516,7 +27076,7 @@ function createStore(dir, log = noopLogger) {
       return review;
     },
     async persisted(id) {
-      return await readJsonFile(join10(dir, `${id}.json`)) ?? undefined;
+      return await readJsonFile(join13(dir, `${id}.json`)) ?? undefined;
     },
     size() {
       return reviews.size;
@@ -26533,7 +27093,7 @@ function createStore(dir, log = noopLogger) {
     async rehydrate() {
       let files;
       try {
-        files = await readdir3(dir);
+        files = await readdir6(dir);
       } catch {
         log.debug("store", "no reviews dir; nothing to rehydrate");
         return;
@@ -26543,7 +27103,7 @@ function createStore(dir, log = noopLogger) {
         if (!file2.endsWith(".json"))
           continue;
         try {
-          const review = JSON.parse(await readFile3(join10(dir, file2), "utf-8"));
+          const review = JSON.parse(await readFile4(join13(dir, file2), "utf-8"));
           if (isUnresolved(review.status)) {
             reviews.set(review.id, review);
             loaded++;
@@ -26568,6 +27128,28 @@ async function runDaemon(opts) {
   log.info("settings", existsSync7(cfg) ? `settings: reading ${cfg}` : `settings: no config at ${cfg}; using defaults`, { settings: boot });
   warnInvalidEnvVars((msg) => log.warn("env", msg));
   const adapter = selectAdapter();
+  const install = buildKind();
+  const version2 = VERSION;
+  const commit = currentCommit();
+  const updateCache = fileUpdateCache(updateCheckFile());
+  let updateStatus = readCachedStatus(updateCache, version2, commit);
+  function refreshUpdate() {
+    runUpdateCheck({
+      kind: install,
+      version: version2,
+      commit,
+      enabled: () => readUpdatesCheck(),
+      now: Date.now,
+      cache: updateCache,
+      npmLatest: publishedCaretVersion,
+      release: latestReleaseTag,
+      aheadBy: commitsAheadOfTrunk,
+      log
+    }).then((status) => {
+      if (status)
+        updateStatus = status;
+    }, (err) => log.error("update", err));
+  }
   const store = createStore(reviewsDir(), log);
   await store.rehydrate();
   const assets = await loadUiAssets();
@@ -26575,6 +27157,19 @@ async function runDaemon(opts) {
     log.info("ui", "no embedded ui; serving placeholder");
   const ephemeral = opts.ephemeral;
   let server;
+  const shutdown = (code) => {
+    server?.stop();
+    process.exit(code);
+  };
+  process.once("SIGTERM", () => {
+    log.info("signal", "sigterm: shutting down");
+    shutdown(0);
+  });
+  process.once("SIGINT", () => {
+    log.info("signal", "sigint: shutting down");
+    shutdown(0);
+  });
+  process.once("exit", removeOwnDaemonLock);
   try {
     server = createServer({
       store,
@@ -26584,11 +27179,13 @@ async function runDaemon(opts) {
       assets,
       lockPath: daemonLock(),
       buildId: await currentBuildId(),
-      commit: currentCommit(),
+      commit,
       stateDir: stateDir(),
       instanceId: randomUUID().slice(0, 8),
       approveVariants: adapter.approveVariants,
       source: adapter.id,
+      listSkills: (cwd) => adapter.listSkills(cwd),
+      readSkillDescription: (cwd, skill) => adapter.readSkillDescription(cwd, skill),
       diagnostics: () => buildDiagnostics({
         now: Date.now,
         startedAt,
@@ -26602,6 +27199,8 @@ async function runDaemon(opts) {
         configExists: () => existsSync7(cfg),
         envOverrides
       }),
+      updateReport: async () => updateReportFor({ install, version: version2, commit }, updateStatus, await readUpdatesCheck()),
+      onUpdatesEnabled: refreshUpdate,
       log
     });
   } catch (e) {
@@ -26612,29 +27211,13 @@ async function runDaemon(opts) {
     }
     throw e;
   }
-  const shutdown = (code) => {
-    server.stop();
-    process.exit(code);
-  };
-  process.once("SIGTERM", () => {
-    log.info("signal", "sigterm: shutting down");
-    shutdown(0);
-  });
-  process.once("SIGINT", () => {
-    log.info("signal", "sigint: shutting down");
-    shutdown(0);
-  });
   const onFatal = (label) => (err) => {
     log.error(label, err);
     shutdown(1);
   };
   process.once("uncaughtException", onFatal("uncaughtException"));
   process.once("unhandledRejection", onFatal("unhandledRejection"));
-  process.once("exit", () => {
-    try {
-      unlinkSync4(daemonLock());
-    } catch {}
-  });
+  refreshUpdate();
 }
 
 // src/commands/discovery.ts
@@ -26643,7 +27226,7 @@ import { release } from "os";
 
 // src/discovery.ts
 import { readdirSync as readdirSync4, statSync as statSync4 } from "fs";
-import { basename as basename3, join as join11 } from "path";
+import { basename as basename3, join as join14 } from "path";
 var CARET_BIN = "caret-native";
 async function safe(build) {
   try {
@@ -26854,7 +27437,7 @@ function listReviewFiles() {
       continue;
     if (out.length >= 5000)
       break;
-    const raw = readJsonFileSync(join11(dir, file2));
+    const raw = readJsonFileSync(join14(dir, file2));
     if (raw && typeof raw.id === "string" && typeof raw.status === "string") {
       out.push({ id: raw.id, status: raw.status });
     }
@@ -26964,31 +27547,31 @@ import {
   rmSync as rmSync2,
   statSync as statSync5,
   symlinkSync,
-  writeFileSync as writeFileSync6
+  writeFileSync as writeFileSync7
 } from "fs";
-import { join as join13, resolve as resolve2 } from "path";
+import { join as join16, resolve as resolve2 } from "path";
 
 // src/adapters/opencode/packaging.ts
 import { existsSync as existsSync9, readdirSync as readdirSync5, readFileSync as readFileSync9 } from "fs";
-import { dirname as dirname7, join as join12 } from "path";
+import { dirname as dirname8, join as join15 } from "path";
 function resolveCaretRoot() {
   const candidates = [];
   const script = process.argv[1];
   if (script)
-    candidates.push(join12(dirname7(script), ".."));
-  candidates.push(join12(dirname7(process.execPath), ".."));
+    candidates.push(join15(dirname8(script), ".."));
+  candidates.push(join15(dirname8(process.execPath), ".."));
   for (const root of candidates) {
-    if (existsSync9(join12(root, "opencode", "caret.plugin.ts")))
+    if (existsSync9(join15(root, "opencode", "caret.plugin.ts")))
       return root;
   }
   throw new Error(`caret OpenCode packaging not found (no opencode/caret.plugin.ts under: ${candidates.join(", ") || "(none)"}). The OpenCode plugin source must ship with caret.`);
 }
 function loadOpencodePackaging(root = resolveCaretRoot()) {
-  const binPath = join12(root, "bin", "caret");
-  const commandsDir = join12(root, "opencode", "commands");
+  const binPath = join15(root, "bin", "caret");
+  const commandsDir = join15(root, "opencode", "commands");
   let commands = [];
   try {
-    commands = readdirSync5(commandsDir).filter((f) => f.endsWith(".md")).sort().map((f) => ({ name: f, contents: readFileSync9(join12(commandsDir, f), "utf-8") }));
+    commands = readdirSync5(commandsDir).filter((f) => f.endsWith(".md")).sort().map((f) => ({ name: f, contents: readFileSync9(join15(commandsDir, f), "utf-8") }));
   } catch {
     commands = [];
   }
@@ -26997,17 +27580,17 @@ function loadOpencodePackaging(root = resolveCaretRoot()) {
 
 // src/commands/install/local.ts
 function devMarketplaceDir() {
-  return join13(stateDir(), "dev-marketplace");
+  return join16(stateDir(), "dev-marketplace");
 }
 function resolveLocalCheckout(opts = {}, deps = {}) {
   const repoDir = resolve2(caretRoot(deps));
-  if (!existsSync10(join13(repoDir, ".claude-plugin", "marketplace.json"))) {
+  if (!existsSync10(join16(repoDir, ".claude-plugin", "marketplace.json"))) {
     throw new Error(`--from-local must run from a caret checkout (no .claude-plugin/marketplace.json at ${repoDir}). A published caret installs with a plain \`caret install\`.`);
   }
   if (opts.requireArtifacts !== false) {
     const missing = [
-      isExecutable(join13(repoDir, "bin", "caret-native")) ? null : "bin/caret-native",
-      isDirectory(join13(repoDir, "bin", "ui")) ? null : "bin/ui"
+      isExecutable(join16(repoDir, "bin", "caret-native")) ? null : "bin/caret-native",
+      isDirectory(join16(repoDir, "bin", "ui")) ? null : "bin/ui"
     ].filter((m) => m !== null);
     if (missing.length > 0) {
       throw new Error(`--from-local reuses the build artifacts bin/caret-native + bin/ui, and ${repoDir} is missing ${missing.join(" + ")} \u2014 run \`mise run build\` first.`);
@@ -27026,9 +27609,9 @@ function caretRoot(deps) {
 }
 function writeDevMarketplace(repoDir, outDir) {
   rmSync2(outDir, { recursive: true, force: true });
-  mkdirSync3(join13(outDir, ".claude-plugin"), { recursive: true });
-  symlinkSync(resolve2(repoDir), join13(outDir, "caret"));
-  writeFileSync6(join13(outDir, ".claude-plugin", "marketplace.json"), `${JSON.stringify({
+  mkdirSync3(join16(outDir, ".claude-plugin"), { recursive: true });
+  symlinkSync(resolve2(repoDir), join16(outDir, "caret"));
+  writeFileSync7(join16(outDir, ".claude-plugin", "marketplace.json"), `${JSON.stringify({
     name: "caret",
     description: "Local caret dev build (generated by caret install --from-local).",
     owner: { name: "macintacos" },
@@ -27039,7 +27622,7 @@ function writeDevMarketplace(repoDir, outDir) {
 async function prewarmLocalBuild(repoDir, deps = {}) {
   const spawn = deps.spawn ?? runCaptured;
   try {
-    await spawn([join13(repoDir, "bin", "caret-native"), "prewarm"]);
+    await spawn([join16(repoDir, "bin", "caret-native"), "prewarm"]);
   } catch {}
 }
 function isExecutable(path) {
@@ -27313,12 +27896,12 @@ async function runInstallClaudeTarget(opts, deps = {}) {
 }
 
 // src/commands/install/opencode.ts
-import { existsSync as existsSync14, readFileSync as readFileSync10, writeFileSync as writeFileSync8 } from "fs";
-import { basename as basename4, join as join15 } from "path";
+import { existsSync as existsSync14, readFileSync as readFileSync10, writeFileSync as writeFileSync9 } from "fs";
+import { basename as basename4, join as join18 } from "path";
 
 // src/adapters/opencode/deploy.ts
-import { existsSync as existsSync12, mkdirSync as mkdirSync4, rmSync as rmSync3, writeFileSync as writeFileSync7 } from "fs";
-import { dirname as dirname9 } from "path";
+import { existsSync as existsSync12, mkdirSync as mkdirSync4, rmSync as rmSync3, writeFileSync as writeFileSync8 } from "fs";
+import { dirname as dirname10 } from "path";
 function renderPlugin(source, opts) {
   return source.replaceAll("__CARET_VERSION__", () => opts.version).replaceAll("__CARET_BIN__", () => opts.binPath);
 }
@@ -27326,8 +27909,8 @@ function deployFiles(files, opts) {
   const paths = [];
   for (const f2 of files) {
     if (!opts.dryRun) {
-      mkdirSync4(dirname9(f2.path), { recursive: true });
-      writeFileSync7(f2.path, f2.contents);
+      mkdirSync4(dirname10(f2.path), { recursive: true });
+      writeFileSync8(f2.path, f2.contents);
     }
     paths.push(f2.path);
   }
@@ -27417,7 +28000,7 @@ async function promptUpgrade(verdict, clack) {
 
 // src/commands/install/opencode.ts
 function isCaretCheckout(dir) {
-  return existsSync14(join15(dir, "opencode", "caret.plugin.ts"));
+  return existsSync14(join18(dir, "opencode", "caret.plugin.ts"));
 }
 function caretEntries(text2, isCheckout) {
   return pluginEntries(text2).filter((entry) => {
@@ -27443,7 +28026,7 @@ async function runInstallOpencodeTarget(opts, deps = {}) {
   const ui = deps.ui ?? silentUI;
   const isCheckout = deps.isCheckout ?? isCaretCheckout;
   const configFile2 = resolveConfigFile(dir);
-  const commandPaths = pkg.commands.map((c3) => join15(commandDir(dir), namespacedCommandFilename(c3.name)));
+  const commandPaths = pkg.commands.map((c3) => join18(commandDir(dir), namespacedCommandFilename(c3.name)));
   const legacy = existingLegacyInstallFiles(dir);
   const specifier = opts.local ? localPluginSpecifier(opts.local.repoDir) : CARET_PACKAGE;
   if (opts.dryRun) {
@@ -27466,7 +28049,7 @@ async function runInstallOpencodeTarget(opts, deps = {}) {
     await upgradeStep(configFile2, opts, deps, ui);
   await sweepLegacy(legacy, dir, ui);
   const files = pkg.commands.map((c3) => ({
-    path: join15(commandDir(dir), namespacedCommandFilename(c3.name)),
+    path: join18(commandDir(dir), namespacedCommandFilename(c3.name)),
     contents: renderPlugin(c3.contents, { version: VERSION, binPath: pkg.binPath })
   }));
   await ui.step("Deploying the /caret:* command files", async () => deployFiles(files, { dryRun: false }), (deployed) => `Deployed ${deployed.paths.length} command file(s) to ${dir}`);
@@ -27522,7 +28105,7 @@ function editConfig(path2, transform2) {
   const next = transform2(existing);
   if (next === null || next === existing)
     return [];
-  writeFileSync8(path2, next);
+  writeFileSync9(path2, next);
   return [path2];
 }
 
@@ -27534,10 +28117,10 @@ function parseTargets(raw) {
       error: `--target names no agent (it takes a comma-separated list of: ${INSTALL_TARGET_IDS.join(", ")}) \u2014 omit it entirely to choose interactively.`
     };
   }
-  const unknown2 = parts.filter((p3) => !INSTALL_TARGET_IDS.includes(p3));
-  if (unknown2.length > 0) {
+  const unknown3 = parts.filter((p3) => !INSTALL_TARGET_IDS.includes(p3));
+  if (unknown3.length > 0) {
     return {
-      error: `unknown --target value(s): ${unknown2.join(", ")}. Valid: ${INSTALL_TARGET_IDS.join(", ")}.`
+      error: `unknown --target value(s): ${unknown3.join(", ")}. Valid: ${INSTALL_TARGET_IDS.join(", ")}.`
     };
   }
   const targets = [];
@@ -30591,7 +31174,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
     });
     this.runningCommand = proc;
   }
-  _dispatchSubcommand(commandName, operands, unknown2) {
+  _dispatchSubcommand(commandName, operands, unknown3) {
     const subCommand = this._findCommand(commandName);
     if (!subCommand)
       this.help({ error: true });
@@ -30600,9 +31183,9 @@ Expecting one of '${allowedValues.join("', '")}'`);
     promiseChain = this._chainOrCallSubCommandHook(promiseChain, subCommand, "preSubcommand");
     promiseChain = this._chainOrCall(promiseChain, () => {
       if (subCommand._executableHandler) {
-        this._executeSubCommand(subCommand, operands.concat(unknown2));
+        this._executeSubCommand(subCommand, operands.concat(unknown3));
       } else {
-        return subCommand._parseCommand(operands, unknown2);
+        return subCommand._parseCommand(operands, unknown3);
       }
     });
     return promiseChain;
@@ -30699,22 +31282,22 @@ Expecting one of '${allowedValues.join("', '")}'`);
     }
     return result;
   }
-  _parseCommand(operands, unknown2) {
-    const parsed = this.parseOptions(unknown2);
+  _parseCommand(operands, unknown3) {
+    const parsed = this.parseOptions(unknown3);
     this._parseOptionsEnv();
     this._parseOptionsImplied();
     operands = operands.concat(parsed.operands);
-    unknown2 = parsed.unknown;
-    this.args = operands.concat(unknown2);
+    unknown3 = parsed.unknown;
+    this.args = operands.concat(unknown3);
     if (operands && this._findCommand(operands[0])) {
-      return this._dispatchSubcommand(operands[0], operands.slice(1), unknown2);
+      return this._dispatchSubcommand(operands[0], operands.slice(1), unknown3);
     }
     if (this._getHelpCommand() && operands[0] === this._getHelpCommand().name()) {
       return this._dispatchHelpCommand(operands[1]);
     }
     if (this._defaultCommandName) {
-      this._outputHelpIfRequested(unknown2);
-      return this._dispatchSubcommand(this._defaultCommandName, operands, unknown2);
+      this._outputHelpIfRequested(unknown3);
+      return this._dispatchSubcommand(this._defaultCommandName, operands, unknown3);
     }
     if (this.commands.length && this.args.length === 0 && !this._actionHandler && !this._defaultCommandName) {
       this.help({ error: true });
@@ -30736,7 +31319,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       promiseChain = this._chainOrCall(promiseChain, () => this._actionHandler(this.processedArgs));
       if (this.parent) {
         promiseChain = this._chainOrCall(promiseChain, () => {
-          this.parent.emit(commandEvent, operands, unknown2);
+          this.parent.emit(commandEvent, operands, unknown3);
         });
       }
       promiseChain = this._chainOrCallHooks(promiseChain, "postAction");
@@ -30745,13 +31328,13 @@ Expecting one of '${allowedValues.join("', '")}'`);
     if (this.parent?.listenerCount(commandEvent)) {
       checkForUnknownOptions();
       this._processArguments();
-      this.parent.emit(commandEvent, operands, unknown2);
+      this.parent.emit(commandEvent, operands, unknown3);
     } else if (operands.length) {
       if (this._findCommand("*")) {
-        return this._dispatchSubcommand("*", operands, unknown2);
+        return this._dispatchSubcommand("*", operands, unknown3);
       }
       if (this.listenerCount("command:*")) {
-        this.emit("command:*", operands, unknown2);
+        this.emit("command:*", operands, unknown3);
       } else if (this.commands.length) {
         this.unknownCommand();
       } else {
@@ -30806,7 +31389,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
   }
   parseOptions(args) {
     const operands = [];
-    const unknown2 = [];
+    const unknown3 = [];
     let dest = operands;
     function maybeOption(arg) {
       return arg.length > 1 && arg[0] === "-";
@@ -30823,7 +31406,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       const arg = activeGroup ?? args[i2++];
       activeGroup = null;
       if (arg === "--") {
-        if (dest === unknown2)
+        if (dest === unknown3)
           dest.push(arg);
         dest.push(...args.slice(i2));
         break;
@@ -30875,18 +31458,18 @@ Expecting one of '${allowedValues.join("', '")}'`);
         }
       }
       if (dest === operands && maybeOption(arg) && !(this.commands.length === 0 && negativeNumberArg(arg))) {
-        dest = unknown2;
+        dest = unknown3;
       }
-      if ((this._enablePositionalOptions || this._passThroughOptions) && operands.length === 0 && unknown2.length === 0) {
+      if ((this._enablePositionalOptions || this._passThroughOptions) && operands.length === 0 && unknown3.length === 0) {
         if (this._findCommand(arg)) {
           operands.push(arg);
-          unknown2.push(...args.slice(i2));
+          unknown3.push(...args.slice(i2));
           break;
         } else if (this._getHelpCommand() && arg === this._getHelpCommand().name()) {
           operands.push(arg, ...args.slice(i2));
           break;
         } else if (this._defaultCommandName) {
-          unknown2.push(arg, ...args.slice(i2));
+          unknown3.push(arg, ...args.slice(i2));
           break;
         }
       }
@@ -30896,7 +31479,7 @@ Expecting one of '${allowedValues.join("', '")}'`);
       }
       dest.push(arg);
     }
-    return { operands, unknown: unknown2 };
+    return { operands, unknown: unknown3 };
   }
   opts() {
     if (this._storeOptionsAsProperties) {