@macintacos/caret 0.11.1 → 0.13.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 dirname8, join as join17 } from "path";
 function isUnicodeSupported() {
   if (process$1.platform !== "win32") {
     return process$1.env.TERM !== "linux";
@@ -6518,7 +6518,7 @@ ${n3}
         existsSync11(t2) ? lstatSync(t2).isDirectory() && (!e.directory || t2.endsWith("/")) ? i = t2 : i = dirname8(t2) : i = dirname8(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 };
@@ -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;
@@ -9738,7 +9932,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 +9952,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 +10005,12 @@ var opencodeAdapter = {
   },
   readInstallState() {
     return readOpencodeInstallState();
+  },
+  listSkills() {
+    return readOpencodeCommands();
+  },
+  readSkillDescription(_cwd, skill) {
+    return readOpencodeCommandDescription(skill.name);
   }
 };
 
@@ -24254,7 +24481,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 +24497,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 +24529,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.11.1",
+  version: "0.13.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 +24571,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",
@@ -24366,6 +24594,7 @@ var package_default = {
     "bits-ui": "^2.18.1",
     clsx: "^2.1.1",
     commander: "^15.0.0",
+    cuelume: "^0.2.2",
     "happy-dom": "^20.11.2",
     "jsonc-parser": "^3.3.1",
     listr2: "^11.0.0",
@@ -25200,9 +25429,11 @@ function openDaemonStderr(s) {
     return "ignore";
   }
 }
-function spawnDaemon(s) {
+var DAEMON_CWD = "/";
+function spawnDaemon(s, spawn = Bun.spawn) {
   const out = openDaemonStderr(s);
-  Bun.spawn(daemonCommand(), {
+  spawn(daemonCommand(), {
+    cwd: DAEMON_CWD,
     stdio: ["ignore", out, out],
     detached: true,
     env: process.env
@@ -25235,12 +25466,12 @@ import { renameSync as renameSync3, unlinkSync as unlinkSync3, writeFileSync as
 import { dirname as dirname6 } from "path";
 
 // src/config/prefs.ts
-import { readFile as readFile2, writeFile } from "fs/promises";
+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 readFile2(file2, "utf-8"));
+    const parsed = JSON.parse(await readFile3(file2, "utf-8"));
     if (typeof parsed.approveMode === "string" && set2.valid.includes(parsed.approveMode)) {
       return parsed.approveMode;
     }
@@ -25298,6 +25529,7 @@ 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"),
@@ -25386,13 +25618,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;
@@ -25448,16 +25680,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)
@@ -25473,7 +25705,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;
     }
@@ -25482,9 +25714,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));
       }
     }
   }
@@ -25596,13 +25828,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;
   }
@@ -25616,7 +25848,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)
@@ -25631,6 +25863,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;
@@ -25707,7 +26011,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": {
@@ -25750,14 +26054,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 });
@@ -25784,8 +26088,9 @@ async function installedVersion(bin) {
     return null;
   }
 }
-var inFlightInstall;
-async function ensureRumdl(install = installPinnedRumdl) {
+var RUMDL_RETRY_COOLDOWN_MS = 10 * 60000;
+var acquisition = { cooldownUntil: 0 };
+async function ensureRumdl(install = installPinnedRumdl, now = Date.now, state = acquisition) {
   ensureStateDir(rumdlDir());
   const config2 = rumdlConfig();
   writeFileSync4(config2, RUMDL_CONFIG);
@@ -25796,10 +26101,19 @@ async function ensureRumdl(install = installPinnedRumdl) {
   const bin = rumdlBin();
   if (await installedVersion(bin) === RUMDL_VERSION)
     return { bin, config: config2, installed: false };
-  inFlightInstall ??= install(bin).finally(() => {
-    inFlightInstall = undefined;
-  });
-  return { bin: await inFlightInstall, config: config2, installed: true };
+  if (now() < state.cooldownUntil) {
+    throw new Error("rumdl: install on cooldown after a recent failure");
+  }
+  if (!state.inFlight) {
+    state.inFlight = install(bin).catch((err) => {
+      state.cooldownUntil = now() + RUMDL_RETRY_COOLDOWN_MS;
+      throw err;
+    }).finally(() => {
+      state.inFlight = undefined;
+    });
+  }
+  const pending = state.inFlight;
+  return { bin: await pending, config: config2, installed: true };
 }
 async function rumdlFormatPlan(text) {
   if (text.trim() === "")
@@ -25821,7 +26135,8 @@ async function rumdlFormatPlan(text) {
 
 // src/plan/markdown.ts
 var MAX_FORMAT_BYTES = 1024 * 1024;
-async function formatPlanMarkdown(plan, log = noopLogger, doFormat = rumdlFormatPlan) {
+var FORMAT_BUDGET_MS = 2000;
+async function formatPlanMarkdown(plan, log = noopLogger, doFormat = rumdlFormatPlan, budgetMs = FORMAT_BUDGET_MS) {
   const bytes = Buffer.byteLength(plan, "utf-8");
   if (bytes > MAX_FORMAT_BYTES) {
     log.warn("review", "plan too large to format, storing raw", {
@@ -25830,13 +26145,19 @@ async function formatPlanMarkdown(plan, log = noopLogger, doFormat = rumdlFormat
     });
     return plan;
   }
+  let timer;
   try {
-    return await doFormat(plan);
+    const deadline = new Promise((_, reject) => {
+      timer = setTimeout(() => reject(new Error(`plan format exceeded ${budgetMs}ms`)), budgetMs);
+    });
+    return await Promise.race([doFormat(plan), deadline]);
   } catch (err) {
     const reason = errorMessage(err).split(`
 `, 1)[0] ?? "";
     log.warn("review", "plan format failed, storing raw", { reason });
     return plan;
+  } finally {
+    clearTimeout(timer);
   }
 }
 
@@ -25988,12 +26309,14 @@ function resolveOptions(opts) {
     instanceId: opts.instanceId,
     approveVariants: opts.approveVariants,
     source: opts.source,
+    listSkills: opts.listSkills,
+    readSkillDescription: opts.readSkillDescription,
     diagnostics: opts.diagnostics,
     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)
@@ -26213,6 +26536,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) {
@@ -26343,8 +26705,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")
@@ -26436,8 +26805,8 @@ function createServer(opts) {
 }
 
 // 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;
@@ -26446,7 +26815,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 });
@@ -26496,7 +26865,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;
@@ -26513,7 +26882,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;
@@ -26523,7 +26892,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++;
@@ -26569,6 +26938,8 @@ async function runDaemon(opts) {
       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,
@@ -26623,7 +26994,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 {
@@ -26834,7 +27205,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 });
     }
@@ -26946,29 +27317,29 @@ import {
   symlinkSync,
   writeFileSync as writeFileSync6
 } 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 dirname7, 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(dirname7(script), ".."));
+  candidates.push(join15(dirname7(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 = [];
   }
@@ -26977,17 +27348,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.`);
@@ -27006,9 +27377,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"));
+  writeFileSync6(join16(outDir, ".claude-plugin", "marketplace.json"), `${JSON.stringify({
     name: "caret",
     description: "Local caret dev build (generated by caret install --from-local).",
     owner: { name: "macintacos" },
@@ -27019,7 +27390,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) {
@@ -27294,7 +27665,7 @@ 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 { 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";
@@ -27397,7 +27768,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) => {
@@ -27423,7 +27794,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) {
@@ -27446,7 +27817,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}`);
@@ -27610,7 +27981,7 @@ async function rumdlStep(opts, deps, ui) {
   try {
     await ui.step("Installing the rumdl plan formatter", () => (deps.ensureRumdl ?? ensureRumdl)(), ({ bin, installed }) => `rumdl ${RUMDL_VERSION} ${installed ? "installed" : "already present"} at ${bin}`);
   } catch (e) {
-    ui.warn(`Could not install rumdl (${errorMessage(e)}) \u2014 caret will retry on your first plan.`);
+    ui.warn(`Could not install rumdl (${errorMessage(e)}) \u2014 plans are stored unformatted until it installs.`);
   }
 }
 function closingLine(targets, opts, local = false) {