vskill 1.0.13 → 1.0.15

package/dist/eval-server/api-routes.js

@@ -2,8 +2,8 @@
 // api-routes.ts -- REST API route handlers for the eval UI
 // ---------------------------------------------------------------------------
 import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, statSync } from "node:fs";
-import { execSync, execFileSync } from "node:child_process";
-import { join, resolve, dirname } from "node:path";
+import { execFileSync, spawn } from "node:child_process";
+import { join, resolve, dirname, basename } from "node:path";
 import { homedir } from "node:os";
 import { sendJson, readBody } from "./router.js";
 import { initSSE, sendSSE, sendSSEDone, withHeartbeat, startDynamicHeartbeat } from "./sse-helpers.js";
@@ -11,9 +11,13 @@ import { dataEventBus, emitDataEvent } from "./data-events.js";
 import { classifyError } from "./error-classifier.js";
 import { readLockfile, writeLockfile } from "../lockfile/lockfile.js";
 import { resolveSkillApiName as resolveSkillApiNameImpl } from "./skill-name-resolver.js";
+import { resolveSkillOrigin } from "./origin-resolver.js";
 import { runBenchmarkSSE, runSingleCaseSSE } from "./benchmark-runner.js";
 import { getSkillSemaphore } from "./concurrency.js";
 import { resolveSkillDir, resolveAllowedSkillDir } from "./skill-resolver.js";
+import { scanSkillInstallLocations, pickHighestPrecedenceLocation } from "./utils/scan-install-locations.js";
+import { whichSync } from "./utils/which.js";
+import { resolveEditorCommand, NoEditorError } from "./utils/resolve-editor.js";
 import { setSkillDirEntry, ensurePluginCacheEntry } from "./skill-dir-registry.js";
 import { pickInstalledVersion, readSkillMd, sha256Hex, } from "./installed-version.js";
 import { extractFrontmatterVersion } from "../utils/version.js";
@@ -375,6 +379,9 @@ const EMPTY_METADATA = {
     sourceAgent: null,
     repoUrl: null,
     skillPath: null,
+    secrets: null,
+    runtime: null,
+    integrationTests: null,
 };
 /**
  * Allow-list of metadata children that may be surfaced at the top level
@@ -407,6 +414,20 @@ const SURFACED_METADATA_KEYS = new Set([
     // Path / file metadata
     "entryPoint",
     "entry-point",
+    // 0815: multi-file manifest fields (kebab-case canonical, camelCase tolerated).
+    "secrets",
+    "runtime-python",
+    "runtimePython",
+    "runtime-pip",
+    "runtimePip",
+    "runtime-node",
+    "runtimeNode",
+    "integration-runner",
+    "integrationRunner",
+    "integration-file",
+    "integrationFile",
+    "integration-requires",
+    "integrationRequires",
 ]);
 /**
  * Minimal YAML frontmatter parser — handles scalars and arrays (inline [a, b]
@@ -716,6 +737,24 @@ export function buildSkillMetadata(skillDir, origin, root) {
     const deps = toStringArrayOrNull(fm["skill-deps"] ?? fm.skillDeps ?? fm.deps);
     const mcpDeps = toStringArrayOrNull(fm["mcp-deps"] ?? fm.mcpDeps ?? fm.mcpDependencies);
     const tags = toStringArrayOrNull(fm.tags);
+    // 0815: assemble runtime + integrationTests from flat fields. Secrets stays
+    // a string[] (env-var names); purposes live in the skill's `.env.example`.
+    const secrets = toStringArrayOrNull(fm.secrets);
+    const runtimePython = toStringOrNull(fm["runtime-python"] ?? fm.runtimePython);
+    const runtimePip = toStringArrayOrNull(fm["runtime-pip"] ?? fm.runtimePip);
+    const runtimeNode = toStringOrNull(fm["runtime-node"] ?? fm.runtimeNode);
+    const runtime = runtimePython || runtimePip || runtimeNode
+        ? { python: runtimePython, pip: runtimePip, node: runtimeNode }
+        : null;
+    const rawRunner = toStringOrNull(fm["integration-runner"] ?? fm.integrationRunner);
+    const integrationRunner = rawRunner === "vitest" || rawRunner === "pytest" || rawRunner === "none"
+        ? rawRunner
+        : null;
+    const integrationFile = toStringOrNull(fm["integration-file"] ?? fm.integrationFile);
+    const integrationRequires = toStringArrayOrNull(fm["integration-requires"] ?? fm.integrationRequires);
+    const integrationTests = integrationRunner
+        ? { runner: integrationRunner, file: integrationFile, requires: integrationRequires }
+        : null;
     return {
         description: toStringOrNull(fm.description),
         version: toStringOrNull(fm.version),
@@ -732,6 +771,9 @@ export function buildSkillMetadata(skillDir, origin, root) {
         sourceAgent: deriveSourceAgent(skillDir, root, origin),
         repoUrl: sourceLink.repoUrl,
         skillPath: sourceLink.skillPath,
+        secrets,
+        runtime,
+        integrationTests,
     };
 }
 // ---------------------------------------------------------------------------
@@ -1030,14 +1072,9 @@ export function detectProjectAgents(root) {
     return data;
 }
 function isBinaryOnPath(name) {
-    try {
-        const cmd = process.platform === "win32" ? `where ${name}` : `command -v ${name}`;
-        execSync(cmd, { stdio: "ignore", timeout: 1000 });
-        return true;
-    }
-    catch {
-        return false;
-    }
+    // 0820 follow-up: delegate to the shared utils/which.ts helper. Cached
+    // there per-process, so the outer `detectionCache` is now belt-and-braces.
+    return whichSync(name);
 }
 // 0701 — Read the active Claude Code model from ~/.claude/settings.json so the
 // Studio picker can surface "routing to claude-opus-4-7[1m]" under the generic
@@ -1643,9 +1680,7 @@ export function registerRoutes(router, root, projectName) {
                 const localSkill = r.name.split("/").pop();
                 // Highest-precedence install wins for the local fs pair the click
                 // handler reveals: project > personal > plugin.
-                const precedence = { project: 0, personal: 1, plugin: 2 };
-                const winner = [...locations].sort((a, b) => precedence[a.scope] -
-                    precedence[b.scope])[0];
+                const winner = pickHighestPrecedenceLocation(locations);
                 return {
                     ...r,
                     ...(programmatic.pinMap.has(r.name)
@@ -1686,17 +1721,41 @@ export function registerRoutes(router, root, projectName) {
     //                         "no version history" without treating it as an error.
     //
     // Never returns 5xx for the "no VCS surface" case — that is normal empty state.
-    router.get("/api/skills/:plugin/:skill/versions", async (req, res, params) => {
-        // 0765: pass plugin so installed-agent views (.claude/, .cursor/, ...)
-        // resolve via lockfile instead of source-tree probe.
-        const fullName = await resolveSkillApiName(params.skill, params.plugin);
+    // 0823 F-001: shared apiPath builder used by /versions, /versions/diff,
+    // and the rescan endpoint so all three resolve via the same origin chain
+    // (project lockfile → ~/.agents → Anthropic registry → git-remote fallback).
+    // Returns `{ apiPathRoot, origin }` — callers append `/versions` or
+    // `/versions/diff` as needed.
+    async function buildSkillApiPath(skill, plugin) {
+        const origin = await resolveSkillOrigin(skill, plugin, root);
+        if (origin.owner && origin.repo) {
+            return {
+                apiPathRoot: `/api/v1/skills/${encodeURIComponent(origin.owner)}/${encodeURIComponent(origin.repo)}/${encodeURIComponent(skill)}`,
+                origin,
+            };
+        }
+        // 0765 fallback: legacy resolver covers source-tree authored skills
+        // whose origin comes from a git remote, not a lockfile.
+        const fullName = await resolveSkillApiName(skill, plugin);
         const parts = fullName.split("/");
-        const apiPath = parts.length === 3
-            ? `/api/v1/skills/${parts.map(encodeURIComponent).join("/")}/versions`
-            : `/api/v1/skills/${encodeURIComponent(fullName)}/versions`;
+        const apiPathRoot = parts.length === 3
+            ? `/api/v1/skills/${parts.map(encodeURIComponent).join("/")}`
+            : `/api/v1/skills/${encodeURIComponent(fullName)}`;
+        return { apiPathRoot, origin };
+    }
+    router.get("/api/skills/:plugin/:skill/versions", async (req, res, params) => {
+        // 0823: comprehensive origin resolver via shared buildSkillApiPath.
+        const { apiPathRoot, origin } = await buildSkillApiPath(params.skill, params.plugin);
+        const apiPath = `${apiPathRoot}/versions`;
         const emptyEnvelope = () => {
             res.setHeader("X-Skill-VCS", "unavailable");
-            sendJson(res, { versions: [], count: 0, source: "none" }, 200, req);
+            sendJson(res, {
+                versions: [],
+                count: 0,
+                source: "none",
+                provider: origin.provider,
+                trackedForUpdates: false,
+            }, 200, req);
         };
         let fetchResp;
         try {
@@ -1756,7 +1815,23 @@ export function registerRoutes(router, root, projectName) {
             ...v,
             isInstalled: installedVersion ? v.version === installedVersion : false,
         }));
-        sendJson(res, { versions: enriched, count: enriched.length, source: "platform" }, 200, req);
+        // 0823 F-003 (iter 4): runtime-verify Anthropic-registry hits via
+        // trackedForUpdates. If a registry-mapped skill returns no upstream
+        // versions (404 or empty), downgrade the provider chip to "local" so the
+        // UI doesn't claim "Anthropic" for a skill that isn't actually indexed
+        // upstream. Lockfile-derived providers stay regardless of count (the
+        // lockfile entry IS the proof the user installed it from somewhere real).
+        const tracked = origin.trackedForUpdates && enriched.length > 0;
+        const reportedProvider = origin.source === "anthropic-registry" && !tracked ? "local" : origin.provider;
+        sendJson(res, {
+            versions: enriched,
+            count: enriched.length,
+            source: "platform",
+            // 0823: provider classification + tracking flag drive UI chip
+            // and CheckNowButton visibility.
+            provider: reportedProvider,
+            trackedForUpdates: tracked,
+        }, 200, req);
     });
     // T-010: Diff proxy route
     router.get("/api/skills/:plugin/:skill/versions/diff", async (req, res, params) => {
@@ -1767,12 +1842,11 @@ export function registerRoutes(router, root, projectName) {
             sendJson(res, { error: "Missing required query params: from and to" }, 400, req);
             return;
         }
-        // 0765: same plugin-aware resolution as /versions.
-        const fullName = await resolveSkillApiName(params.skill, params.plugin);
-        const parts = fullName.split("/");
-        const basePath = parts.length === 3
-            ? `/api/v1/skills/${parts.map(encodeURIComponent).join("/")}/versions/diff`
-            : `/api/v1/skills/${encodeURIComponent(fullName)}/versions/diff`;
+        // 0823 F-001: use the same origin-resolver-aware path builder as /versions
+        // so Anthropic-shipped skills (slack-messaging, pptx, etc.) get the
+        // matching upstream URL for diff requests, not the legacy bare-name path.
+        const { apiPathRoot } = await buildSkillApiPath(params.skill, params.plugin);
+        const basePath = `${apiPathRoot}/versions/diff`;
         try {
             const resp = await fetch(`${PLATFORM_BASE}${basePath}?from=${encodeURIComponent(from)}&to=${encodeURIComponent(to)}`, { signal: AbortSignal.timeout(10_000) });
             // 0746: pass through upstream status + body. Legitimate 4xx from the
@@ -1817,6 +1891,106 @@ export function registerRoutes(router, root, projectName) {
         s.length <= 200 &&
         !s.startsWith("-") &&
         SKILL_SLUG_RE.test(s);
+    // 0823 — POST /api/v1/skills/:id/rescan — single-skill upstream version
+    // check. The client (CheckNowButton) calls this to verify whether a tracked
+    // installed skill has new versions available. The :id param is URL-encoded
+    // `<plugin>/<skill>` (e.g. `.claude%2Fnanobanana`).
+    //
+    // Flow:
+    //   1. URL-decode :id → (plugin, skill); validate slug.
+    //   2. resolveSkillOrigin → upstream owner/repo (or local fallback).
+    //   3. Fetch upstream versions; emit `skill.updated` via dataEventBus so
+    //      any local listeners (and the SSE stream once bridged) can react.
+    //   4. Return { jobId } synchronously. The actual update install (if any)
+    //      goes through the existing `/update` route — rescan is read-only.
+    //
+    // Idempotent + side-effect free on disk.
+    router.post("/api/v1/skills/:id/rescan", async (req, res, params) => {
+        const rawId = String(params.id ?? "");
+        const decoded = (() => {
+            try {
+                return decodeURIComponent(rawId);
+            }
+            catch {
+                return rawId;
+            }
+        })();
+        const slashIdx = decoded.indexOf("/");
+        if (slashIdx <= 0 || slashIdx === decoded.length - 1) {
+            sendJson(res, { error: `Invalid skill id: ${rawId}` }, 400, req);
+            return;
+        }
+        const plugin = decoded.slice(0, slashIdx);
+        const skill = decoded.slice(slashIdx + 1);
+        if (!isSafeSkillName(skill) || !isSafeSkillName(plugin)) {
+            sendJson(res, { error: `Invalid skill id: ${rawId}` }, 400, req);
+            return;
+        }
+        // 0823 F-002 (security iter 4): isSafeSkillName regex permits `/` (legal
+        // for owner/repo/skill triples) so a doubly-encoded `.claude%2F.claude%2Fx`
+        // would split to plugin=.claude, skill=.claude/x. The skill segment after
+        // the first split MUST be a single slug — reject any embedded slash.
+        if (plugin.includes("/") || skill.includes("/")) {
+            sendJson(res, { error: `Invalid skill id (nested slash): ${rawId}` }, 400, req);
+            return;
+        }
+        // 0823 F-005 (low): use crypto.randomUUID per FR-005 spec — collision-
+        // free + auditable. Falls back to a Math.random suffix if the runtime
+        // is too old to expose the global API (Node 14 / very old browsers).
+        const jobId = (() => {
+            try {
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                const c = globalThis.crypto;
+                if (c?.randomUUID)
+                    return `rescan-${c.randomUUID()}`;
+            }
+            catch { /* fall through */ }
+            return `rescan-${Date.now()}-${Math.random().toString(36).slice(2, 10)}`;
+        })();
+        let versions = [];
+        try {
+            const origin = await resolveSkillOrigin(skill, plugin, root);
+            if (origin.owner && origin.repo) {
+                const apiPath = `/api/v1/skills/${encodeURIComponent(origin.owner)}/${encodeURIComponent(origin.repo)}/${encodeURIComponent(skill)}/versions`;
+                try {
+                    const fetchResp = await fetch(`${PLATFORM_BASE}${apiPath}`, {
+                        signal: AbortSignal.timeout(10_000),
+                    });
+                    if (fetchResp.ok) {
+                        const data = (await fetchResp.json());
+                        versions = Array.isArray(data.versions) ? data.versions : [];
+                    }
+                    else {
+                        // 0823 F-009: surface non-OK responses for ops debugging — the
+                        // user-facing button still treats the rescan as "no change", but
+                        // the operator can see why upstream said no in the studio log.
+                        console.warn(`[rescan] upstream ${PLATFORM_BASE}${apiPath} → ${fetchResp.status} ${fetchResp.statusText}`);
+                    }
+                }
+                catch (fetchErr) {
+                    // 0823 F-009: log network failures instead of silently swallowing.
+                    console.warn(`[rescan] upstream fetch failed for ${plugin}/${skill}:`, fetchErr.message);
+                }
+            }
+        }
+        catch (resolveErr) {
+            // 0823 F-009: resolveSkillOrigin should never throw, but if it does the
+            // operator needs to know — silent failure here would look like "no
+            // upstream changes" to the user forever.
+            console.error(`[rescan] resolveSkillOrigin threw for ${plugin}/${skill}:`, resolveErr.message);
+        }
+        // Emit local event so any in-process listeners (and the SSE bridge once
+        // wired) can push to clients. CheckNowButton's existing 30s timeout
+        // serves as the fallback if no SSE event reaches `updatesById`.
+        emitDataEvent("skill.updated", {
+            plugin,
+            skill,
+            versions,
+            jobId,
+            timestamp: new Date().toISOString(),
+        });
+        sendJson(res, { jobId }, 200, req);
+    });
     router.post("/api/skills/:plugin/:skill/update", async (req, res, params) => {
         initSSE(res, req);
         const skillName = params.skill;
@@ -1950,6 +2124,18 @@ export function registerRoutes(router, root, projectName) {
     // file-read routes need to reach into ~/.claude/plugins/{cache,marketplaces}
     // and ~/.claude/skills. Path traversal is rejected by validateAgainstAllowlist
     // inside resolveAllowedSkillDir.
+    // 0823 simplify: shared trailing-separator-aware containment check used by
+    // /file (read) and /file (PUT/save). Plain `startsWith()` is unsafe because
+    // two skills with shared prefixes (e.g. `foo` + `foo-secret`) collide. This
+    // helper appends the separator and explicitly accepts the exact-match case.
+    // Returns true when `candidate` is at or below `root` after normalization.
+    const isContainedIn = (candidate, root) => {
+        const r = resolve(root);
+        if (candidate === r)
+            return true;
+        const rWithSep = r.endsWith("/") ? r : r + "/";
+        return candidate.startsWith(rWithSep);
+    };
     const skillFsAllowedRoots = () => {
         const home = homedir();
         return [
@@ -1957,6 +2143,10 @@ export function registerRoutes(router, root, projectName) {
             join(home, ".claude/plugins/cache"),
             join(home, ".claude/plugins/marketplaces"),
             join(home, ".claude/skills"),
+            // 0823: vskill install --global writes to ~/.agents/skills, and many
+            // ~/.claude/skills/* entries are symlinks INTO that dir. Without this
+            // allowlist entry the realpath check rejects them as "outside allowlist".
+            join(home, ".agents/skills"),
         ];
     };
     // 0769 F-002: cold-server deep links to /api/skills/:plugin/:skill/files (or
@@ -2059,12 +2249,15 @@ export function registerRoutes(router, root, projectName) {
         }
         const url = new URL(req.url ?? "", "http://localhost");
         const filePath = url.searchParams.get("path") ?? "";
+        const raw = url.searchParams.get("raw") === "1";
         if (!filePath) {
             sendJson(res, { error: "Missing path query parameter" }, 400, req);
             return;
         }
         const fullPath = resolve(join(skillDir, filePath));
-        if (!fullPath.startsWith(resolve(skillDir))) {
+        // 0823 F-002 (security): trailing-separator-aware containment via shared
+        // helper — prevents prefix-confusion (e.g. `foo` vs `foo-secret`).
+        if (!isContainedIn(fullPath, skillDir)) {
             sendJson(res, { error: "Access denied" }, 403, req);
             return;
         }
@@ -2083,7 +2276,6 @@ export function registerRoutes(router, root, projectName) {
             sendJson(res, { error: "File too large", path: filePath, size }, 413, req);
             return;
         }
-        // Binary detection: check first 8KB for null bytes
         let buf;
         try {
             buf = readFileSync(fullPath);
@@ -2092,6 +2284,51 @@ export function registerRoutes(router, root, projectName) {
             sendJson(res, { error: `Unable to read file: ${err.message}` }, 500, req);
             return;
         }
+        // 0823 F-004: raw=1 returns the file bytes with a sniffed Content-Type so
+        // <img src=...&raw=1> works for inline preview. Binary detection still
+        // runs; raw mode only changes how the bytes are delivered, not which
+        // files are accepted.
+        if (raw) {
+            const ext = filePath.toLowerCase().slice(filePath.lastIndexOf(".") + 1);
+            // 0823 F-002 (security): SVG is REFUSED via raw because it can carry
+            // <script> that runs in the studio origin (localhost full-API access)
+            // when a user navigates the URL directly. SVGs still preview as
+            // "binary" placeholder via the JSON path.
+            if (ext === "svg") {
+                sendJson(res, {
+                    error: "SVG raw rendering disabled — script-injection risk. Use the binary placeholder.",
+                }, 415, req);
+                return;
+            }
+            const mime = {
+                png: "image/png",
+                jpg: "image/jpeg",
+                jpeg: "image/jpeg",
+                gif: "image/gif",
+                webp: "image/webp",
+                ico: "image/x-icon",
+                pdf: "application/pdf",
+            };
+            const contentType = mime[ext];
+            if (!contentType) {
+                // Unknown ext + raw=1 — refuse rather than serve as octet-stream
+                // (which the browser may sniff into a script context).
+                sendJson(res, { error: `raw=1 not supported for extension: ${ext || "<none>"}` }, 415, req);
+                return;
+            }
+            res.setHeader("Content-Type", contentType);
+            res.setHeader("Content-Length", String(buf.length));
+            res.setHeader("Cache-Control", "private, max-age=60");
+            // 0823 F-002 (defense in depth): block content-type sniffing AND force
+            // an inline-only Content-Disposition so the browser cannot reinterpret
+            // the response as HTML/script.
+            res.setHeader("X-Content-Type-Options", "nosniff");
+            res.setHeader("Content-Disposition", "inline");
+            res.writeHead(200);
+            res.end(buf);
+            return;
+        }
+        // Binary detection: check first 8KB for null bytes
         const probe = buf.subarray(0, Math.min(8192, buf.length));
         for (let i = 0; i < probe.length; i++) {
             if (probe[i] === 0) {
@@ -2121,7 +2358,9 @@ export function registerRoutes(router, root, projectName) {
             return;
         }
         const fullPath = resolve(join(skillDir, filePath));
-        if (!fullPath.startsWith(resolve(skillDir))) {
+        // 0823 F-002 (security): trailing-separator-aware containment via shared
+        // helper — same guard as /file (read).
+        if (!isContainedIn(fullPath, skillDir)) {
             sendJson(res, { error: "Path traversal denied" }, 403, req);
             return;
         }
@@ -3124,6 +3363,112 @@ Return ONLY the JSON lines, no other text.`;
         const skillDependencies = detectSkillDependencies(content);
         sendJson(res, { mcpDependencies, skillDependencies }, 200, req);
     });
+    // 0820 — Reveal in Editor / Open. Spawns the user's preferred editor on
+    // the skill folder (Open) or its SKILL.md (Reveal/Edit). Path-traversal
+    // hardened: never trusts a client-supplied dir; resolves (plugin, skill)
+    // server-side via scanSkillInstallLocations and rejects any non-basename
+    // `file`. Spawn is detached + unref'd so the response returns immediately.
+    router.post("/api/skills/reveal-in-editor", async (req, res) => {
+        let body;
+        try {
+            body = (await readBody(req));
+        }
+        catch {
+            // Malformed JSON or oversized body — surface as 400 invalid_body
+            // rather than letting the router emit a generic 500.
+            sendJson(res, { error: "invalid_body" }, 400, req);
+            return;
+        }
+        const plugin = typeof body.plugin === "string" ? body.plugin : undefined;
+        const skill = typeof body.skill === "string" ? body.skill : undefined;
+        if (plugin === undefined || skill === undefined || skill.length === 0) {
+            sendJson(res, { error: "invalid_body" }, 400, req);
+            return;
+        }
+        let file;
+        if (body.file !== undefined) {
+            // Reject: non-string, empty, embeds either separator (POSIX `/` or
+            // Windows `\`), `.` / `..` as filename, or any control char. We check
+            // both separators explicitly since path.basename on POSIX doesn't
+            // recognize `\` as a separator, and the eval-server may run on either.
+            const f = body.file;
+            const invalid = typeof f !== "string" ||
+                f.length === 0 ||
+                f === "." ||
+                f === ".." ||
+                f.includes("/") ||
+                f.includes("\\") ||
+                // eslint-disable-next-line no-control-regex
+                /[\x00-\x1f]/.test(f);
+            if (invalid) {
+                sendJson(res, { error: "invalid_file" }, 400, req);
+                return;
+            }
+            file = f;
+        }
+        const canonical = plugin ? `${plugin}/${skill}` : skill;
+        const winner = pickHighestPrecedenceLocation(scanSkillInstallLocations(canonical, root));
+        if (!winner) {
+            sendJson(res, { error: "skill_not_found" }, 404, req);
+            return;
+        }
+        const dir = winner.dir;
+        // Defense in depth: scanSkillInstallLocations already restricts dirs to
+        // known scope roots, but a final basename check rejects anything that
+        // doesn't end in the requested skill slug — protects against a future
+        // scanner regression that returned a parent or sibling dir.
+        if (basename(dir) !== skill) {
+            sendJson(res, { error: "skill_not_found" }, 404, req);
+            return;
+        }
+        if (file) {
+            const finalPath = join(dir, file);
+            // TOCTOU: file may be deleted between this check and spawn. We accept
+            // that — editors handle a vanished path by opening an empty buffer, and
+            // the alternative (no pre-check) would leak filesystem details via
+            // spawn ENOENT for normal "this skill has no SKILL.md" cases.
+            if (!existsSync(finalPath)) {
+                sendJson(res, { error: "file_not_found" }, 404, req);
+                return;
+            }
+        }
+        let launch;
+        try {
+            launch = resolveEditorCommand({ dir, file });
+        }
+        catch (err) {
+            if (err instanceof NoEditorError) {
+                sendJson(res, { error: "no_editor" }, 500, req);
+            }
+            else {
+                // Distinguish "resolver blew up" from "spawn blew up". Same 500
+                // shape, but the error code points to the right phase.
+                sendJson(res, { error: "resolve_failed" }, 500, req);
+            }
+            return;
+        }
+        try {
+            await new Promise((resolvePromise, rejectPromise) => {
+                const child = spawn(launch.command, launch.args, {
+                    detached: true,
+                    stdio: "ignore",
+                });
+                child.once("error", rejectPromise);
+                child.once("spawn", () => {
+                    child.unref();
+                    resolvePromise();
+                });
+            });
+        }
+        catch (err) {
+            // Log so operators can diagnose ENOENT / permission-denied / etc.;
+            // the user-facing toast is the generic 500.
+            console.warn("[reveal-in-editor] spawn failed:", err);
+            sendJson(res, { error: "spawn_failed" }, 500, req);
+            return;
+        }
+        sendJson(res, { ok: true, command: launch.command, args: launch.args }, 200, req);
+    });
     // Handle CORS preflight
     router.options = (req, res) => {
         const origin = req.headers.origin;