waterplane 0.1.24 → 0.1.26

package/packages/host/dist/skills/skillinventory.js

@@ -0,0 +1,275 @@
+/**
+ * The skills and plugins this desktop's claude would list, with the state at each settings level and
+ * what each costs (docs/analysis/skills-switch/PLAN.md, P2). Read-only. Counts are P4's (`usage` here
+ * is absent until then); bundled skills are not enumerated (no file names them).
+ *
+ * A plugin skill is `switchable:false`: the CLI ignores `skillOverrides` for it (fact 3), only the
+ * plugin's own switch works. Plugin ids and installs come from `claude plugin list --json` (cached
+ * 60 s); a failure falls back to `installed_plugins.json` + the synced dir and SAYS so in `hostNote`.
+ */
+import { execFile } from "node:child_process";
+import { existsSync, readdirSync, readFileSync, realpathSync, statSync } from "node:fs";
+import { join } from "node:path";
+import { addLocalDays, lineCost, resolvePluginEnabled, resolveSkillState, } from "@waterplane/shared";
+import { claudeBin } from "../backends/claude.js";
+import { claudeConfigDir } from "../claudeconfig.js";
+import { disablesModelInvocation, weightOf } from "./skillweight.js";
+import { readSkillLayers } from "./skilllayers.js";
+export const PLUGIN_SKILLS_SWITCHABLE = false;
+const PLUGIN_SKILL_WHY = "The CLI ignores per-skill switches for plugin skills; switch the whole plugin.";
+const LIST_TTL_MS = 60_000;
+const cache = new Map();
+function runPluginList(cwd, timeoutMs = 10_000) {
+    return new Promise((resolve, reject) => {
+        execFile(claudeBin(), ["plugin", "list", "--json"], { timeout: timeoutMs, maxBuffer: 4 * 1024 * 1024, env: process.env, ...(cwd ? { cwd } : {}) }, (err, stdout) => {
+            if (err)
+                return reject(err);
+            try {
+                const j = JSON.parse(stdout);
+                if (!Array.isArray(j))
+                    throw new Error("not a list");
+                resolve(j.filter((p) => p && typeof p.id === "string" && typeof p.installPath === "string").map((p) => ({
+                    id: p.id, version: typeof p.version === "string" ? p.version : undefined, scope: String(p.scope ?? ""),
+                    enabled: p.enabled !== false, installPath: p.installPath,
+                })));
+            }
+            catch (e) {
+                reject(e);
+            }
+        });
+    });
+}
+/** installed_plugins.json (v2: plugins[id] = [{scope, installPath, version}]) + the synced dir. */
+export function fallbackPlugins() {
+    const out = [];
+    const root = join(claudeConfigDir(), "plugins");
+    try {
+        const j = JSON.parse(readFileSync(join(root, "installed_plugins.json"), "utf8"));
+        for (const [id, arr] of Object.entries(j?.plugins ?? {})) {
+            const e = Array.isArray(arr) ? arr[0] : null;
+            if (e && typeof e.installPath === "string")
+                out.push({ id, version: e.version, scope: String(e.scope ?? ""), enabled: true, installPath: e.installPath });
+        }
+    }
+    catch { /* none */ }
+    try {
+        for (const acct of readdirSync(join(root, "synced"))) {
+            const dir = join(root, "synced", acct);
+            if (!statSync(dir).isDirectory())
+                continue;
+            for (const d of readdirSync(dir)) {
+                if (d.endsWith(".json") || !statSync(join(dir, d)).isDirectory())
+                    continue;
+                const name = d.replace(/~g\d+$/, "");
+                const id = `${name}@synced`;
+                if (!out.some((p) => p.id === id))
+                    out.push({ id, scope: "synced", enabled: true, installPath: join(dir, d) });
+            }
+        }
+    }
+    catch { /* none */ }
+    return out;
+}
+/** Asked from the repo's own folder, so its on/off default folds in THAT repo's settings and no other's. */
+async function pluginList(worktree) {
+    const key = worktree ?? "";
+    const hit = cache.get(key);
+    if (hit && Date.now() - hit.at < LIST_TTL_MS)
+        return hit.list;
+    let list;
+    try {
+        list = { plugins: await runPluginList(worktree) };
+    }
+    catch {
+        list = { plugins: fallbackPlugins(), note: "claude plugin list could not be run, so plugins are read from the files on disk and a plugin's on/off default is assumed on." };
+    }
+    cache.set(key, { at: Date.now(), list });
+    return list;
+}
+/** Dropped after a write (a settings file just changed) and by tests. */
+export function resetPluginListCache() { cache.clear(); }
+const isDir = (p) => { try {
+    return statSync(p).isDirectory();
+}
+catch {
+    return false;
+} };
+/** `<dir>/*\/SKILL.md`, symlinks followed. */
+function skillFiles(dir) {
+    const out = [];
+    let names = [];
+    try {
+        names = readdirSync(dir).sort();
+    }
+    catch {
+        return out;
+    }
+    for (const n of names) {
+        const file = join(dir, n, "SKILL.md");
+        if (existsSync(file))
+            out.push({ dir: n, file });
+    }
+    return out;
+}
+function mcpCount(installPath) {
+    try {
+        const j = JSON.parse(readFileSync(join(installPath, ".mcp.json"), "utf8"));
+        const m = j && typeof j === "object" ? (j.mcpServers ?? j) : null;
+        return m && typeof m === "object" && !Array.isArray(m) ? Object.keys(m).length : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export async function buildInventory(opts = {}) {
+    const L = readSkillLayers(opts.worktree);
+    const byLevel = (lvl) => L.reads.find((r) => r.layer.level === lvl);
+    const user = byLevel("global"), shared = byLevel("repo-shared"), local = byLevel("repo-local");
+    const layers = { user: user?.skillOverrides, project: shared?.skillOverrides, local: local?.skillOverrides };
+    const pLayers = { user: user?.enabledPlugins, project: shared?.enabledPlugins, local: local?.enabledPlugins };
+    const files = {};
+    const rows = [];
+    let unmeasured = 0;
+    const seen = new Set();
+    // The CLI reserves a bare name for the personal / project skill that holds it: a synced skill's bare key is then ignored.
+    const heldNames = new Set();
+    for (const s of skillFiles(join(claudeConfigDir(), "skills")))
+        if (s.dir !== "synced")
+            heldNames.add(s.dir);
+    if (opts.worktree)
+        for (const s of skillFiles(join(opts.worktree, ".claude", "skills")))
+            heldNames.add(s.dir);
+    const setOf = (id, bare) => {
+        const set = {};
+        for (const r of L.reads) {
+            const v = r.skillOverrides[id] ?? (bare ? r.skillOverrides[bare] : undefined);
+            if (typeof v === "string" && ["on", "name-only", "user-invocable-only", "off"].includes(v))
+                set[r.layer.level] = v;
+        }
+        return set;
+    };
+    const addSkill = (id, source, file, plugin, bareName) => {
+        if (seen.has(id))
+            return;
+        const bare = bareName !== undefined && !heldNames.has(bareName) ? bareName : undefined;
+        seen.add(id);
+        let text = null;
+        try {
+            text = readFileSync(file, "utf8");
+        }
+        catch { /* unreadable */ }
+        const switchable = source === "plugin" ? PLUGIN_SKILLS_SWITCHABLE : true;
+        const locks = { policy: L.policy.skillOverrides };
+        // The CLI reads the prefixed key at every level first, then the bare name of a synced skill.
+        let res = resolveSkillState(id, layers, locks);
+        if (bare && res.from === "default")
+            res = resolveSkillState(bare, layers, locks);
+        const authorLocked = text !== null && disablesModelInvocation(text);
+        const row = {
+            kind: "skill", id, source, set: setOf(id, bare), effective: res.state, from: res.from, switchable,
+        };
+        if (plugin)
+            row.plugin = plugin;
+        // The CLI fixes a skill with `disable-model-invocation: true` at user-invocable-only (never in the
+        // model's listing) before it looks at any skillOverrides; only a managed "off" is stronger.
+        // Any non-plugin "off" beats it (read from the CLI 2.1.322 resolver: overrides across all sources
+        // return off first); a plugin skill ignores skillOverrides, so only a managed value counts there.
+        if (authorLocked && !(res.state === "off" && (source !== "plugin" || res.from === "locked"))) {
+            row.effective = "user-invocable-only";
+            row.from = "locked";
+            row.lockedBy = "author";
+            row.locked = "The skill's own file says only you may run it (disable-model-invocation), so the model never lists it and no setting changes that.";
+        }
+        else if (res.from === "locked")
+            row.locked = "A managed setting fixes this value; it cannot be changed here.";
+        if (text !== null) {
+            const w = weightOf(id, text, L.maxDesc);
+            row.listingChars = w.listingChars;
+            row.bodyChars = w.bodyChars;
+            if (w.capped)
+                row.capped = true;
+        }
+        else {
+            unmeasured++;
+            row.why = "Its SKILL.md could not be read, so its weight is not measured.";
+        }
+        if (!switchable)
+            row.why = row.why ? `${row.why} ${PLUGIN_SKILL_WHY}` : PLUGIN_SKILL_WHY;
+        files[id] = file;
+        rows.push(row);
+    };
+    // Personal (and the claude.ai standalone skills under skills/synced/<account>/).
+    const personal = join(claudeConfigDir(), "skills");
+    for (const s of skillFiles(personal))
+        if (s.dir !== "synced")
+            addSkill(s.dir, "personal", s.file);
+    try {
+        for (const acct of readdirSync(join(personal, "synced"))) {
+            for (const s of skillFiles(join(personal, "synced", acct)))
+                addSkill(`anthropic-skills:${s.dir}`, "synced-skill", s.file, undefined, s.dir);
+        }
+    }
+    catch { /* none */ }
+    // Project.
+    if (opts.worktree)
+        for (const s of skillFiles(join(opts.worktree, ".claude", "skills")))
+            addSkill(s.dir, "project", s.file);
+    // Plugins.
+    const pl = await pluginList(opts.worktree);
+    for (const p of pl.plugins) {
+        const name = p.id.split("@")[0] || p.id;
+        let installPath = p.installPath;
+        try {
+            installPath = realpathSync(installPath);
+        }
+        catch { /* keep as given */ }
+        const skillIds = [];
+        if (isDir(installPath)) {
+            for (const s of skillFiles(join(installPath, "skills"))) {
+                // The CLI names a skills/<dir>/SKILL.md `<plugin>:<dir>` (odd characters become "-"); the frontmatter name is ignored.
+                const id = `${name}:${s.dir.replace(/[^a-zA-Z0-9_-]/g, "-")}`;
+                addSkill(id, "plugin", s.file, p.id);
+                skillIds.push(id);
+            }
+        }
+        const res = resolvePluginEnabled(p.id, pLayers, { policy: L.policy.enabledPlugins }, p.enabled);
+        const set = {};
+        for (const r of L.reads)
+            if (typeof r.enabledPlugins[p.id] === "boolean")
+                set[r.layer.level] = r.enabledPlugins[p.id];
+        const mine = rows.filter((r) => r.kind === "skill" && skillIds.includes(r.id));
+        const measured = mine.length > 0 && mine.every((r) => r.listingChars !== undefined);
+        const prow = { kind: "plugin", id: p.id, name, scope: p.scope, set, enabled: res.enabled, from: res.from, skills: skillIds };
+        if (p.version)
+            prow.version = p.version;
+        if (measured)
+            prow.listingChars = mine.reduce((n, r) => n + (r.lockedBy === "author" ? 0 : r.listingChars ?? 0), 0); // an author-locked skill is never listed
+        else
+            prow.why = mine.length === 0 ? "No skills found in this plugin's folder, so its weight is not measured." : "Some of its skills could not be read, so its weight is not measured.";
+        const mcp = isDir(installPath) ? mcpCount(installPath) : undefined;
+        if (mcp !== undefined)
+            prow.mcpServers = mcp;
+        rows.push(prow);
+    }
+    // What the listing carries NOW: a skill counts at its effective state (name-only is its name line,
+    // off is nothing) and a plugin's skills only while the plugin is on, so a save lowers the total.
+    const pluginOn = new Map(rows.filter((r) => r.kind === "plugin").map((p) => [p.id, p.enabled]));
+    const carried = (r) => (r.plugin && pluginOn.get(r.plugin) === false ? 0 : lineCost(r, r.effective) ?? 0);
+    const sum = (pred) => {
+        const m = rows.filter((r) => r.kind === "skill" && pred(r) && r.listingChars !== undefined);
+        return m.length ? m.reduce((n, r) => n + carried(r), 0) : undefined;
+    };
+    const doc = {
+        v: 1, at: opts.now ?? Date.now(),
+        layers: L.reads.map((r) => r.layer),
+        rows,
+        totals: { skillChars: sum((r) => r.source !== "plugin"), pluginChars: sum((r) => r.source === "plugin"), unmeasured },
+        usage: { state: "absent", why: "Use counts are not read yet.", since30: addLocalDays(opts.now ?? Date.now(), -30) },
+    };
+    if (opts.repoId)
+        doc.repoId = opts.repoId;
+    const notes = [pl.note, "Bundled skills are not listed: no file names them."].filter(Boolean);
+    doc.hostNote = notes.join(" ");
+    return { doc, files };
+}
+//# sourceMappingURL=skillinventory.js.map

package/packages/host/dist/skills/skillinventory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skillinventory.js","sourceRoot":"","sources":["../../src/skills/skillinventory.ts"],"names":[],"mappings":"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"}

package/packages/host/dist/skills/skilllayers.d.ts

@@ -0,0 +1,28 @@
+import type { SkillLayer, SwitchLevel } from "@waterplane/shared";
+export type JsonMap = Record<string, unknown>;
+export interface LayerRead {
+    layer: SkillLayer;
+    /** The two switch maps of this file (empty when absent or unreadable). */
+    skillOverrides: JsonMap;
+    enabledPlugins: JsonMap;
+    /** `skillListingMaxDescChars` when this file sets it. */
+    maxDesc?: number;
+    /** The absolute file. */
+    file: string;
+}
+export interface SkillLayers {
+    reads: LayerRead[];
+    /** Managed (policy) settings: read-only locks. */
+    policy: {
+        skillOverrides: JsonMap;
+        enabledPlugins: JsonMap;
+    };
+    maxDesc?: number;
+}
+/** `~/…` for a path under the home dir, else the path as is. */
+export declare function displayPath(abs: string): string;
+export declare function readLayer(level: SwitchLevel, file: string, display: string): LayerRead;
+/** Where managed settings live (best effort, read-only). */
+export declare function managedSettingsPath(platform?: NodeJS.Platform): string | null;
+/** The global layer, and with a worktree the two repo layers. Order: global, repo-shared, repo-local. */
+export declare function readSkillLayers(worktree?: string): SkillLayers;

package/packages/host/dist/skills/skilllayers.js

@@ -0,0 +1,73 @@
+/**
+ * The settings files the skills and plugins switch reads (docs/analysis/skills-switch/PLAN.md, P2).
+ *
+ * Read with `readFileSync` + `JSON.parse`, NEVER `readJsonGuarded`: that MOVES an unparseable file
+ * aside, and a settings file is the person's. An unreadable file is a layer saying so, and its
+ * maps count as empty (the write path refuses it, P3). Read-only here.
+ */
+import { createHash } from "node:crypto";
+import { readFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { claudeConfigDir } from "../claudeconfig.js";
+const isObj = (v) => !!v && typeof v === "object" && !Array.isArray(v);
+/** `~/…` for a path under the home dir, else the path as is. */
+export function displayPath(abs) {
+    const h = homedir();
+    return abs === h ? "~" : abs.startsWith(h + "/") ? "~" + abs.slice(h.length) : abs;
+}
+export function readLayer(level, file, display) {
+    const empty = { skillOverrides: {}, enabledPlugins: {}, file };
+    let text;
+    try {
+        text = readFileSync(file, "utf8");
+    }
+    catch (e) {
+        if (e.code === "ENOENT")
+            return { layer: { level, path: display, rev: "absent", readable: true }, ...empty };
+        return { layer: { level, path: display, rev: "absent", readable: false, why: `${display} could not be read (${e.code ?? "error"}).` }, ...empty };
+    }
+    const rev = createHash("sha1").update(text).digest("hex");
+    let json;
+    try {
+        json = JSON.parse(text);
+    }
+    catch {
+        return { layer: { level, path: display, rev, readable: false, why: `${display} is not valid JSON, so nothing here reads or writes it.` }, ...empty };
+    }
+    if (!isObj(json))
+        return { layer: { level, path: display, rev, readable: false, why: `${display} is not a JSON object.` }, ...empty };
+    for (const k of ["skillOverrides", "enabledPlugins"]) {
+        if (k in json && !isObj(json[k]))
+            return { layer: { level, path: display, rev, readable: false, why: `${display} has a "${k}" that is not an object.` }, ...empty };
+    }
+    const md = json.skillListingMaxDescChars;
+    return {
+        layer: { level, path: display, rev, readable: true },
+        skillOverrides: json.skillOverrides ?? {},
+        enabledPlugins: json.enabledPlugins ?? {},
+        maxDesc: typeof md === "number" && md > 0 ? md : undefined,
+        file,
+    };
+}
+/** Where managed settings live (best effort, read-only). */
+export function managedSettingsPath(platform = process.platform) {
+    if (platform === "darwin")
+        return "/Library/Application Support/ClaudeCode/managed-settings.json";
+    if (platform === "linux")
+        return "/etc/claude-code/managed-settings.json";
+    return null;
+}
+/** The global layer, and with a worktree the two repo layers. Order: global, repo-shared, repo-local. */
+export function readSkillLayers(worktree) {
+    const reads = [readLayer("global", join(claudeConfigDir(), "settings.json"), displayPath(join(claudeConfigDir(), "settings.json")))];
+    if (worktree) {
+        reads.push(readLayer("repo-shared", join(worktree, ".claude", "settings.json"), ".claude/settings.json"));
+        reads.push(readLayer("repo-local", join(worktree, ".claude", "settings.local.json"), ".claude/settings.local.json"));
+    }
+    const mp = managedSettingsPath();
+    const m = mp ? readLayer("global", mp, mp) : null;
+    const maxDesc = [...reads, ...(m ? [m] : [])].map((r) => r.maxDesc).filter((n) => n !== undefined).pop(); // merged settings: the highest-precedence source wins (managed > local > shared > global)
+    return { reads, policy: { skillOverrides: m?.skillOverrides ?? {}, enabledPlugins: m?.enabledPlugins ?? {} }, maxDesc };
+}
+//# sourceMappingURL=skilllayers.js.map

package/packages/host/dist/skills/skilllayers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skilllayers.js","sourceRoot":"","sources":["../../src/skills/skilllayers.ts"],"names":[],"mappings":"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"}

package/packages/host/dist/skills/skillrecommend.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Skills Recommend (P5, docs/analysis/skills-switch/PLAN.md): ONE cheap unattended call that
+ * suggests which skills and plugins to switch off for one repo. Spender rules (host-spenders):
+ * the single sidecar seam (`runSkillsTask`, claude flags none dropped, `--thinking disabled`,
+ * `--no-session-persistence`), the halt gate, and NOTHING APPLIES ITSELF - the answer is a list a
+ * person ticks. The model's text is DATA: this file validates every suggestion against the
+ * inventory and fills savings and counts itself.
+ */
+import type { SkillInventoryDoc, SkillSuggestion, SkillRecommendResponse } from "@waterplane/shared";
+import { type NameRequest, type NameRun } from "../sidecar.js";
+export declare const MAX_SUGGESTIONS = 30;
+export declare const SKILLS_SYSTEM_DEFAULT: string;
+export interface RecommendDeps {
+    run?: (req: NameRequest) => Promise<NameRun>;
+    /** Overrides the sidecar plan lookup (tests). */
+    refused?: () => string | null;
+}
+interface InRow {
+    id: string;
+    kind: "skill" | "plugin";
+    source?: string;
+    state: string;
+    chars?: number;
+    tok?: number;
+    uses30?: number;
+    usesAll?: number;
+    typed30?: number;
+    typedAll?: number;
+    referencedBy: string[];
+    desc?: string;
+}
+/** Build the model's input rows. Exported for tests. */
+export declare function recommendRows(doc: SkillInventoryDoc, files: Record<string, string>, wt: string): InRow[];
+/** Validate the model's text against the inventory. Exported for tests. */
+export declare function validateSuggestions(text: string, doc: SkillInventoryDoc, rows: InRow[]): {
+    suggestions: SkillSuggestion[];
+    note?: string;
+    dropped: number;
+} | null;
+/** `doc` is the repo inventory with usage filled in by the route; `files` maps skill id -> SKILL.md. */
+export declare function recommendSkills(wt: string, doc: SkillInventoryDoc, files: Record<string, string>, deps?: RecommendDeps): Promise<SkillRecommendResponse>;
+export {};

package/packages/host/dist/skills/skillrecommend.js

@@ -0,0 +1,171 @@
+import { savingsOf } from "@waterplane/shared";
+import { readFileSync } from "node:fs";
+import { basename } from "node:path";
+import { env } from "../env.js";
+import { haltRefusal } from "../halt.js";
+import { promptText } from "../prompts.js";
+import { runSkillsTask, sidecarPlan } from "../sidecar.js";
+import { repoReferences } from "./skillrefs.js";
+const MODEL = env("SKILLS_MODEL") || env("SUMMARY_MODEL") || "haiku";
+const TIMEOUT_MS = Number(env("SKILLS_TIMEOUT_MS") || 60_000);
+const INPUT_CAP = 24_000;
+export const MAX_SUGGESTIONS = 30;
+const MAX_REASON = 140;
+const RANK = { on: 0, "name-only": 1, "user-invocable-only": 2, off: 3 };
+const TO_SET = new Set(["name-only", "user-invocable-only", "off"]);
+export const SKILLS_SYSTEM_DEFAULT = "You help a person trim the skills and plugins their coding agent lists on every turn. You get rows " +
+    "with weight and use counts for ONE repo. Suggest only items that cost context and that this repo " +
+    "does not use: weigh chars, uses in the last 30 days, uses all time, and referencedBy. Never suggest an " +
+    "item with a non-empty referencedBy. Prefer `name-only` for something occasionally useful, `off` for " +
+    "something unused or irrelevant to this repo, `user-invocable-only` for something the person types " +
+    "but the model should not pick. For a plugin only `off`. Counts are for this repo only: say so in the " +
+    "reason, never claim a skill is useless in general. At most 30 suggestions, reasons under 140 " +
+    "characters, plain words. Output one JSON object and nothing else. Shape: " +
+    '{"suggestions":[{"kind":"skill|plugin","id":"...","to":"name-only|user-invocable-only|off","reason":"..."}],"note":"optional one sentence"}';
+function descOf(file) {
+    if (!file)
+        return undefined;
+    try {
+        const m = /^---\r?\n([\s\S]*?)\r?\n---/.exec(readFileSync(file, "utf8"));
+        const d = m && /^description:(.*)$/m.exec(m[1]);
+        const t = d?.[1]?.trim().replace(/^["'>|-]/, "").trim();
+        return t ? t.slice(0, 120) : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+/** Build the model's input rows. Exported for tests. */
+export function recommendRows(doc, files, wt) {
+    const skills = doc.rows.filter((r) => r.kind === "skill");
+    const plugins = doc.rows.filter((r) => r.kind === "plugin");
+    const names = [...new Set([...skills.filter((s) => s.source !== "plugin").map((s) => s.id), ...plugins.map((p) => p.name)])];
+    const own = {};
+    for (const s of skills)
+        if (files[s.id])
+            own[s.id] = files[s.id];
+    const refs = repoReferences(wt, names, own);
+    const rows = [];
+    for (const s of skills) {
+        if (s.source === "plugin" || !s.switchable || s.from === "locked")
+            continue;
+        rows.push({
+            id: s.id, kind: "skill", source: s.source, state: s.effective, chars: s.listingChars,
+            tok: s.listingChars === undefined ? undefined : Math.round(s.listingChars / 4),
+            uses30: s.uses?.d30, usesAll: s.uses?.all, typed30: s.uses?.typed30, typedAll: s.uses?.typedAll,
+            referencedBy: (refs[s.id] ?? []).map((f) => basename(f)), desc: descOf(files[s.id]),
+        });
+    }
+    for (const p of plugins) {
+        if (p.from === "locked")
+            continue;
+        const mine = skills.filter((s) => s.plugin === p.id);
+        const sum = (f) => mine.some((s) => s.uses) ? mine.reduce((a, s) => a + (f(s) ?? 0), 0) : undefined;
+        rows.push({
+            id: p.id, kind: "plugin", state: p.enabled ? "on" : "off", chars: p.listingChars,
+            tok: p.listingChars === undefined ? undefined : Math.round(p.listingChars / 4),
+            uses30: sum((s) => s.uses?.d30), usesAll: sum((s) => s.uses?.all),
+            typed30: sum((s) => s.uses?.typed30), typedAll: sum((s) => s.uses?.typedAll),
+            referencedBy: (refs[p.name] ?? []).map((f) => basename(f)),
+        });
+    }
+    return rows;
+}
+function parseJson(text) {
+    const t = text.trim();
+    const fenced = /^```(?:json)?[ \t]*\r?\n([\s\S]*?)\n```$/.exec(t);
+    try {
+        return JSON.parse(fenced ? fenced[1] : t);
+    }
+    catch {
+        return null;
+    }
+}
+/** Validate the model's text against the inventory. Exported for tests. */
+export function validateSuggestions(text, doc, rows) {
+    const j = parseJson(text);
+    if (!j || typeof j !== "object" || !Array.isArray(j.suggestions))
+        return null;
+    const byKey = new Map(doc.rows.map((r) => [`${r.kind}:${r.id}`, r]));
+    const inRow = new Map(rows.map((r) => [`${r.kind}:${r.id}`, r]));
+    const seen = new Set();
+    const out = [];
+    let dropped = 0;
+    for (const raw of j.suggestions) {
+        const s = raw;
+        const key = `${String(s?.kind)}:${String(s?.id)}`;
+        const row = byKey.get(key);
+        const given = inRow.get(key);
+        const to = String(s?.to);
+        if (out.length >= MAX_SUGGESTIONS || !row || !given || seen.has(key) || !TO_SET.has(to) || typeof s.reason !== "string") {
+            dropped++;
+            continue;
+        }
+        if (given.referencedBy.length) {
+            dropped++;
+            continue;
+        }
+        if (row.kind === "plugin") {
+            if (to !== "off" || !row.enabled) {
+                dropped++;
+                continue;
+            }
+        }
+        else if (!row.switchable || RANK[row.effective] >= RANK[to]) {
+            dropped++;
+            continue;
+        }
+        seen.add(key);
+        const change = { kind: row.kind, id: row.id, to: row.kind === "plugin" ? false : to };
+        const sv = savingsOf([row], [change]);
+        out.push({
+            kind: row.kind, id: row.id, to: to, reason: s.reason.trim().slice(0, MAX_REASON),
+            ...(sv.unmeasured ? {} : { savedChars: sv.chars }),
+            ...(given.uses30 !== undefined ? { uses30: given.uses30 } : {}),
+            ...(given.usesAll !== undefined ? { usesAll: given.usesAll } : {}),
+        });
+    }
+    const note = typeof j.note === "string" && j.note.trim() ? j.note.trim().slice(0, 300) : undefined;
+    return { suggestions: out, ...(note ? { note } : {}), dropped };
+}
+const none = (error, extra = {}) => ({ ok: false, suggestions: [], dropped: 0, error, ...extra });
+/** `doc` is the repo inventory with usage filled in by the route; `files` maps skill id -> SKILL.md. */
+export async function recommendSkills(wt, doc, files, deps = {}) {
+    const halted = haltRefusal();
+    if (halted)
+        return none(halted);
+    if (doc.usage.state === "absent")
+        return none(`Cannot recommend: there are no use counts to go on. ${doc.usage.why ?? "The usage scan found nothing."}`);
+    if (doc.usage.state !== "ready" || doc.usage.refreshing)
+        return none("Counting uses is still running. Try again in a moment.");
+    const plan = deps.refused ? deps.refused() : (() => { const p = sidecarPlan("skills"); return p.engine === "refused" ? p.reason : null; })();
+    if (plan)
+        return none(plan);
+    let rows = recommendRows(doc, files, wt);
+    if (!rows.length)
+        return { ok: true, suggestions: [], dropped: 0, note: "Nothing here can be switched." };
+    const wrap = (r) => JSON.stringify({
+        repo: basename(wt), window: { d30: "last 30 days", all: "all time" }, rows: r,
+    });
+    // Heaviest first, then cut to the input cap: the rows that cost most are the ones worth a call.
+    rows = [...rows].sort((a, b) => (b.chars ?? 0) - (a.chars ?? 0));
+    while (rows.length > 1 && wrap(rows).length > INPUT_CAP)
+        rows.pop();
+    const run = await (deps.run ?? runSkillsTask)({
+        cwd: wt, prompt: wrap(rows), system: promptText("skills-recommend", SKILLS_SYSTEM_DEFAULT),
+        model: MODEL, timeoutMs: TIMEOUT_MS, persist: false,
+    });
+    const u = run.usage;
+    const spend = { model: MODEL, costUsd: run.usd, inputTokens: u ? u.inTok + u.cacheRead + u.cacheWrite : undefined, outputTokens: u?.outTok };
+    if (run.limited)
+        return none(run.detail || "The account is out of quota. Nothing was suggested.", { limited: true, spend });
+    if (run.signedOut)
+        return none(run.detail || "Claude is signed out on this desktop.", { spend });
+    if (run.failed)
+        return none(run.detail || "No suggestions came back.", { spend });
+    const v = validateSuggestions(run.text, doc, rows);
+    if (!v)
+        return none("The answer was not in a shape this screen can use. Nothing was changed.", { spend });
+    return { ok: true, ...v, spend };
+}
+//# sourceMappingURL=skillrecommend.js.map