@cleocode/core 2026.9.20 → 2026.9.22

package/dist/skills/prune-bundled.js

@@ -0,0 +1,536 @@
+/**
+ * Prune bundled skills that CLEO no longer installs — quarantining only what
+ * CLEO provably wrote (T12678).
+ *
+ * `initCoreSkills` installs every `@cleocode/skills` manifest entry declared
+ * `metadata.install: harness` but never removed anything, so a skill later
+ * declared `internal` (ct-grade) or retired (ct-docs-lookup, …) stayed in
+ * every harness.
+ *
+ * ## Ownership — never inferred
+ *
+ * The canonical skills root (`resolveSkillsRoot()`) is shared: CAAMP
+ * installs every user skill there too, so "it is in the root" or "a harness
+ * link points into the root" proves only that CAAMP put it there. The ONLY
+ * proof CLEO accepts is its own **bundled-install ledger**
+ * (`<skillsRoot>/.cleo-bundled.json`), written by `initCoreSkills` at install
+ * time with a SHA-256 for every file it wrote. A skill is quarantined only
+ * when:
+ *
+ * - it is a prune candidate (a non-harness manifest entry, or listed in the
+ *   manifest's `retiredSkills`);
+ * - the ledger records it;
+ * - its CAAMP lock entry, if any, has source `library:<name>`, and its
+ *   skills.db row, if any, is `canonical` — anything else means a user
+ *   installed it;
+ * - the files on disk still hash exactly to what the ledger recorded (a
+ *   user-edited copy is kept).
+ *
+ * A harness symlink is taken only when it points exactly at that skill's
+ * canonical path; a harness copy only when it hashes to the ledger. Skills
+ * installed before the ledger existed have no record and are reported, not
+ * pruned.
+ *
+ * ## Reversible
+ *
+ * Nothing is deleted. Owned paths are moved into
+ * `<cleoHome>/skills-quarantine/<id>/` with a `quarantine.json` describing
+ * every move, the lock entry removed and the skills.db state changed;
+ * {@link restoreQuarantine} puts all of it back.
+ *
+ * @task T12678
+ */
+import { createHash, randomBytes } from 'node:crypto';
+import { existsSync, lstatSync, readdirSync, readFileSync, readlinkSync, realpathSync, } from 'node:fs';
+import { appendFile, cp, mkdir, rename, rm, writeFile } from 'node:fs/promises';
+import { dirname, isAbsolute, join, resolve } from 'node:path';
+/** File under the canonical skills root recording what CLEO installed. */
+export const BUNDLED_LEDGER_FILE = '.cleo-bundled.json';
+/** Directory name, beside the skills root, holding quarantined skills. */
+export const QUARANTINE_DIR = 'skills-quarantine';
+/**
+ * Names the bundled manifest says must not be installed to harnesses.
+ *
+ * @param manifest - Parsed `skills/manifest.json`.
+ * @returns Sorted unique candidate names.
+ */
+export function pruneCandidates(manifest) {
+    const names = new Set();
+    for (const s of manifest.skills ?? []) {
+        if (typeof s.name === 'string' && s.install !== 'harness')
+            names.add(s.name);
+    }
+    for (const n of manifest.retiredSkills ?? [])
+        names.add(n);
+    return [...names].sort();
+}
+/**
+ * SHA-256 of every file under `dir` (relative POSIX paths), skipping
+ * `__pycache__`. Empty when `dir` is missing.
+ *
+ * @param dir - Directory to hash.
+ * @returns Relative path → hex digest.
+ */
+export function hashTree(dir) {
+    const out = {};
+    const walk = (abs, rel) => {
+        for (const e of readdirSync(abs, { withFileTypes: true })) {
+            if (e.name === '__pycache__')
+                continue;
+            const childAbs = join(abs, e.name);
+            const childRel = rel ? `${rel}/${e.name}` : e.name;
+            if (e.isDirectory())
+                walk(childAbs, childRel);
+            else if (e.isFile()) {
+                out[childRel] = createHash('sha256').update(readFileSync(childAbs)).digest('hex');
+            }
+        }
+    };
+    try {
+        walk(dir, '');
+    }
+    catch {
+        return {};
+    }
+    return out;
+}
+/**
+ * Whether a directory still holds exactly the files the ledger recorded.
+ *
+ * @param dir - Directory on disk.
+ * @param files - Ledger file hashes.
+ * @returns `true` on an exact match (same paths, same bytes).
+ */
+function matchesLedger(dir, files) {
+    const actual = hashTree(dir);
+    const want = Object.keys(files).sort();
+    const have = Object.keys(actual).sort();
+    if (want.length === 0 || want.join('\n') !== have.join('\n'))
+        return false;
+    return want.every((f) => actual[f] === files[f]);
+}
+/**
+ * Read the bundled-install ledger; an absent, unreadable or older-format
+ * ledger yields an empty one (nothing is then provably CLEO's).
+ *
+ * @param skillsRoot - Canonical skills root.
+ * @returns The ledger.
+ */
+export function readBundledLedger(skillsRoot) {
+    try {
+        const data = JSON.parse(readFileSync(join(skillsRoot, BUNDLED_LEDGER_FILE), 'utf-8'));
+        if (data.version === 2 && data.skills && typeof data.skills === 'object') {
+            const kept = Array.isArray(data.kept)
+                ? data.kept.filter((n) => typeof n === 'string')
+                : [];
+            return { version: 2, skills: data.skills, ...(kept.length > 0 ? { kept } : {}) };
+        }
+    }
+    catch {
+        // absent or unreadable
+    }
+    return { version: 2, skills: {} };
+}
+/**
+ * Write the ledger.
+ *
+ * @param skillsRoot - Canonical skills root.
+ * @param ledger - Ledger to write.
+ */
+async function writeLedger(skillsRoot, ledger) {
+    await mkdir(skillsRoot, { recursive: true });
+    await writeFile(join(skillsRoot, BUNDLED_LEDGER_FILE), `${JSON.stringify(ledger, null, 2)}\n`);
+}
+/**
+ * Record the skills CLEO just installed from the bundle, hashing the files
+ * it wrote into each canonical copy.
+ *
+ * @param skillsRoot - Canonical skills root.
+ * @param names - Skills installed by this run.
+ */
+export async function recordBundledInstalls(skillsRoot, names) {
+    const ledger = readBundledLedger(skillsRoot);
+    const now = new Date().toISOString();
+    for (const name of names) {
+        const files = hashTree(join(skillsRoot, name));
+        if (Object.keys(files).length > 0)
+            ledger.skills[name] = { installedAt: now, files };
+    }
+    await writeLedger(skillsRoot, ledger);
+}
+/**
+ * Where a symlink points, even when the target is gone.
+ *
+ * @param linkPath - Symlink path.
+ * @returns Absolute target.
+ */
+function linkTarget(linkPath) {
+    const raw = readlinkSync(linkPath);
+    return isAbsolute(raw) ? raw : resolve(dirname(linkPath), raw);
+}
+/**
+ * Real path when it exists, otherwise the resolved path.
+ *
+ * @param p - Path.
+ * @returns Canonical path for equality checks.
+ */
+function realOrResolved(p) {
+    try {
+        return realpathSync(p);
+    }
+    catch {
+        return resolve(p);
+    }
+}
+/**
+ * Whether anything (including a dangling symlink) exists at `p`.
+ *
+ * @param p - Path.
+ * @returns `true` when lstat succeeds.
+ */
+function exists(p) {
+    try {
+        lstatSync(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Move a path, falling back to copy + remove across devices.
+ *
+ * @param from - Source.
+ * @param to - Destination (must not exist).
+ */
+async function movePath(from, to) {
+    await mkdir(dirname(to), { recursive: true });
+    try {
+        await rename(from, to);
+    }
+    catch (err) {
+        if (err.code !== 'EXDEV')
+            throw err;
+        await cp(from, to, { recursive: true, verbatimSymlinks: true });
+        await rm(from, { recursive: true, force: true });
+    }
+}
+/**
+ * Quarantine harness entries and canonical copies of skills CLEO no longer
+ * installs, where the ledger proves CLEO wrote them and they are unmodified.
+ * See the module doc.
+ *
+ * @param opts - Paths, registry, dry-run flag.
+ * @returns The receipt.
+ */
+export async function pruneBundledSkills(opts) {
+    const dryRun = opts.dryRun === true;
+    const manifest = JSON.parse(readFileSync(join(opts.bundledSkillsDir, 'manifest.json'), 'utf-8'));
+    const candidates = pruneCandidates(manifest);
+    const ledger = readBundledLedger(opts.skillsRoot);
+    const providerDirs = [...new Set(opts.providerSkillDirs)];
+    const actions = [];
+    const errors = [];
+    const at = new Date().toISOString();
+    const id = `${at.replace(/[:.]/g, '-')}-${randomBytes(3).toString('hex')}`;
+    const qroot = join(opts.quarantineRoot ?? join(dirname(opts.skillsRoot), QUARANTINE_DIR), id);
+    const record = { id, at, moves: [], lockEntries: [], rows: [] };
+    const keep = (name, path, reason) => {
+        actions.push({ name, path, action: 'kept', reason });
+    };
+    /**
+     * Write quarantine.json. Called BEFORE each change it describes, so a crash
+     * mid-run never leaves a moved path, removed lock entry or archived row
+     * without a record; restore skips a recorded move that never happened.
+     */
+    const persist = async () => {
+        await mkdir(qroot, { recursive: true });
+        await writeFile(join(qroot, 'quarantine.json'), `${JSON.stringify(record, null, 2)}\n`);
+    };
+    const take = async (name, path, reason) => {
+        if (dryRun) {
+            actions.push({ name, path, action: 'would-quarantine', reason });
+            return true;
+        }
+        const to = join(qroot, 'files', String(record.moves.length), name);
+        record.moves.push({ name, from: path, to });
+        try {
+            await persist();
+            await movePath(path, to);
+            actions.push({ name, path, action: 'quarantined', reason });
+            return true;
+        }
+        catch (err) {
+            record.moves.pop();
+            await persist().catch(() => undefined);
+            errors.push(`${path}: ${err instanceof Error ? err.message : String(err)}`);
+            return false;
+        }
+    };
+    const keptByUser = new Set(ledger.kept ?? []);
+    for (const name of candidates) {
+        const canonical = join(opts.skillsRoot, name);
+        const harness = providerDirs.map((d) => join(d, name)).filter(exists);
+        const present = [...(existsSync(canonical) ? [canonical] : []), ...harness];
+        if (present.length === 0)
+            continue;
+        if (keptByUser.has(name)) {
+            for (const p of present)
+                keep(name, p, 'restored from quarantine by the user');
+            continue;
+        }
+        const entry = ledger.skills[name];
+        if (!entry) {
+            for (const p of present) {
+                keep(name, p, 'no bundled-install ledger record (installed before the ledger, or by the user)');
+            }
+            continue;
+        }
+        const lock = await opts.registry.lockEntry(name);
+        if (lock && lock.source !== `library:${name}`) {
+            for (const p of present)
+                keep(name, p, `CAAMP lock says it was installed from ${lock.source}`);
+            continue;
+        }
+        const row = await opts.registry.skillRow(name);
+        if (row && row.sourceType !== 'canonical') {
+            for (const p of present)
+                keep(name, p, `skills.db records a ${row.sourceType} install`);
+            continue;
+        }
+        const canonicalReal = realOrResolved(canonical);
+        const canonicalOwned = existsSync(canonical) && matchesLedger(canonical, entry.files);
+        if (existsSync(canonical) && !canonicalOwned) {
+            keep(name, canonical, 'modified since CLEO installed it (hashes differ from the ledger)');
+        }
+        for (const p of harness) {
+            if (lstatSync(p).isSymbolicLink()) {
+                const target = realOrResolved(linkTarget(p));
+                const pointsAtCanonical = target === canonicalReal || target === resolve(canonical);
+                if (pointsAtCanonical && (canonicalOwned || !existsSync(canonical))) {
+                    await take(name, p, 'CLEO link to its unmodified canonical copy');
+                }
+                else {
+                    keep(name, p, pointsAtCanonical
+                        ? 'links to a modified canonical copy'
+                        : `links elsewhere (${target})`);
+                }
+            }
+            else if (realOrResolved(p) === canonicalReal) {
+                // The canonical copy reached through a linked harness dir — handled below.
+            }
+            else if (matchesLedger(p, entry.files)) {
+                await take(name, p, 'copy identical to what CLEO installed');
+            }
+            else {
+                keep(name, p, 'directory differs from what CLEO installed');
+            }
+        }
+        if (!canonicalOwned)
+            continue;
+        const moved = await take(name, canonical, 'unmodified CLEO install (ledger hashes match)');
+        if (!moved || dryRun)
+            continue;
+        delete ledger.skills[name];
+        await writeLedger(opts.skillsRoot, ledger);
+        if (lock) {
+            record.lockEntries.push({ name, entry: lock });
+            await persist();
+            await opts.registry.removeLockEntry(name);
+        }
+        if (row) {
+            record.rows.push({ name, priorState: row.lifecycleState });
+            await persist();
+            await opts.registry.setLifecycleState(name, 'archived', canonical);
+        }
+    }
+    const movedAny = record.moves.length > 0;
+    const receipt = {
+        at,
+        dryRun,
+        candidates,
+        actions,
+        quarantineId: movedAny ? id : null,
+        errors,
+    };
+    if (movedAny && opts.receiptPath) {
+        await mkdir(dirname(opts.receiptPath), { recursive: true });
+        await appendFile(opts.receiptPath, `${JSON.stringify(receipt)}\n`);
+    }
+    return receipt;
+}
+/**
+ * List quarantine ids, newest first.
+ *
+ * @param quarantineRoot - Quarantine root.
+ * @returns Ids that carry a `quarantine.json`.
+ */
+export function listQuarantines(quarantineRoot) {
+    if (!existsSync(quarantineRoot))
+        return [];
+    return readdirSync(quarantineRoot)
+        .filter((d) => existsSync(join(quarantineRoot, d, 'quarantine.json')))
+        .sort()
+        .reverse();
+}
+/**
+ * Put back everything one quarantine run moved: files and links, CAAMP lock
+ * entries and skills.db lifecycle states. A skill whose path is occupied again
+ * (the user reinstalled it) is reported as a conflict, and its lock entry and
+ * row are left alone. Every cleanly restored skill joins the ledger's `kept`
+ * list, so later prunes leave it in place.
+ *
+ * @param opts - Quarantine root and id, skills root, registry.
+ * @returns What was restored and what could not be (destination occupied).
+ */
+export async function restoreQuarantine(opts) {
+    const dir = join(opts.quarantineRoot, opts.id);
+    const record = JSON.parse(readFileSync(join(dir, 'quarantine.json'), 'utf-8'));
+    const restored = [];
+    const conflicts = [];
+    const conflicted = new Set();
+    for (const m of [...record.moves].reverse()) {
+        // Recorded before the move; a crash in between means it never happened.
+        if (!exists(m.to))
+            continue;
+        if (exists(m.from)) {
+            conflicts.push(m.from);
+            conflicted.add(m.name);
+            continue;
+        }
+        await movePath(m.to, m.from);
+        restored.push(m.from);
+    }
+    // A conflict means the user reinstalled the skill since the prune; its
+    // lock entry and skills.db row now describe that install, so leave them.
+    for (const l of record.lockEntries) {
+        if (!conflicted.has(l.name))
+            await opts.registry.restoreLockEntry(l.name, l.entry);
+    }
+    for (const r of record.rows) {
+        if (conflicted.has(r.name))
+            continue;
+        const prior = r.priorState === 'stale' || r.priorState === 'archived' ? r.priorState : 'active';
+        await opts.registry.setLifecycleState(r.name, prior);
+    }
+    // Restoring is the user choosing to keep the skill: mark it kept rather
+    // than re-recording CLEO ownership, or the next prune would take it again.
+    const ledger = readBundledLedger(opts.skillsRoot);
+    const kept = new Set(ledger.kept ?? []);
+    for (const name of new Set(record.moves.map((m) => m.name))) {
+        if (conflicted.has(name))
+            continue;
+        kept.add(name);
+        delete ledger.skills[name];
+    }
+    ledger.kept = [...kept].sort();
+    await writeLedger(opts.skillsRoot, ledger);
+    if (conflicts.length === 0)
+        await rm(dir, { recursive: true, force: true });
+    return { restored, conflicts };
+}
+/**
+ * The real registry: CAAMP's lock file and CLEO's skills.db.
+ *
+ * @returns A {@link PruneRegistry}.
+ */
+export async function defaultPruneRegistry() {
+    const caamp = await import('@cleocode/caamp');
+    const db = await import('../store/skills-db.js');
+    return {
+        async lockEntry(name) {
+            const e = (await caamp.getTrackedSkills())[name];
+            return e ? { ...e } : null;
+        },
+        async removeLockEntry(name) {
+            await caamp.removeSkillFromLock(name);
+        },
+        async restoreLockEntry(name, entry) {
+            await caamp.recordSkillInstall(name, typeof entry['scopedName'] === 'string' ? entry['scopedName'] : name, entry.source, entry['sourceType'], Array.isArray(entry['agents']) ? entry['agents'].filter((a) => typeof a === 'string') : [], typeof entry['canonicalPath'] === 'string' ? entry['canonicalPath'] : '', entry['isGlobal'] !== false, typeof entry['projectDir'] === 'string' ? entry['projectDir'] : undefined, typeof entry['version'] === 'string' ? entry['version'] : undefined);
+        },
+        async skillRow(name) {
+            try {
+                const row = await db.getSkillRow(name);
+                return row ? { sourceType: row.sourceType, lifecycleState: row.lifecycleState } : null;
+            }
+            catch {
+                return null;
+            }
+        },
+        async setLifecycleState(name, state, from) {
+            await db.setSkillLifecycleState(name, state, from);
+        },
+    };
+}
+/**
+ * Real paths for the installed CLEO: bundle dir, canonical root, harness
+ * dirs, quarantine root.
+ *
+ * @returns Resolved context, or `null` when the bundled skills are missing.
+ */
+async function realPruneContext() {
+    const { getInstalledProviders, resolveProviderSkillsDirs } = await import('@cleocode/caamp');
+    const { resolveBundledSkillsDir, resolveSkillsRoot } = await import('./skill-root.js');
+    const bundledSkillsDir = resolveBundledSkillsDir();
+    if (!bundledSkillsDir)
+        return null;
+    const skillsRoot = resolveSkillsRoot();
+    return {
+        bundledSkillsDir,
+        skillsRoot,
+        providerSkillDirs: getInstalledProviders().flatMap((p) => resolveProviderSkillsDirs(p, 'global')),
+        quarantineRoot: join(dirname(skillsRoot), QUARANTINE_DIR),
+    };
+}
+/**
+ * Run the bundled-skill prune against this machine (`cleo skills doctor
+ * prune`).
+ *
+ * @param opts - `dryRun` reports without moving anything.
+ * @returns The receipt, or `null` when the bundled skills cannot be found.
+ */
+export async function runBundledSkillPrune(opts) {
+    const ctx = await realPruneContext();
+    if (!ctx)
+        return null;
+    return pruneBundledSkills({
+        ...ctx,
+        registry: await defaultPruneRegistry(),
+        dryRun: opts.dryRun === true,
+        receiptPath: join(ctx.skillsRoot, '.prune-receipts.jsonl'),
+    });
+}
+/**
+ * List quarantines, or restore one (`cleo skills doctor restore [id]`).
+ *
+ * @param id - Quarantine id; omit to list.
+ * @returns The ids, or the restore outcome.
+ */
+export async function restoreBundledSkillQuarantine(id) {
+    const { resolveSkillsRoot } = await import('./skill-root.js');
+    const skillsRoot = resolveSkillsRoot();
+    const quarantineRoot = join(dirname(skillsRoot), QUARANTINE_DIR);
+    if (!id)
+        return { quarantines: listQuarantines(quarantineRoot) };
+    return restoreQuarantine({
+        quarantineRoot,
+        id,
+        skillsRoot,
+        registry: await defaultPruneRegistry(),
+    });
+}
+/**
+ * Dry-run the prune `initCoreSkills` would perform against the real bundle,
+ * canonical root, harnesses and registries.
+ *
+ * @returns One line per path that would be quarantined or kept.
+ */
+export async function previewBundledSkillPrune() {
+    const receipt = await runBundledSkillPrune({ dryRun: true });
+    if (!receipt)
+        return [];
+    return receipt.actions.map((a) => a.action === 'would-quarantine'
+        ? `skills: would quarantine ${a.path} (${a.reason})`
+        : `skills: would keep ${a.path} (${a.reason})`);
+}
+//# sourceMappingURL=prune-bundled.js.map

package/dist/skills/prune-bundled.js.map

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

package/dist/skills/skill-paths.d.ts

@@ -21,6 +21,18 @@ export interface SkillSearchPath {
     path: string;
     origin: 'override' | 'caamp' | 'embedded';
 }
+/**
+ * A resolved skill directory and where it came from. `bundled` means the
+ * skill is not installed anywhere and was read from `@cleocode/skills`.
+ *
+ * @task T12646
+ */
+export interface ResolvedSkillLocation {
+    /** Real path of the skill directory. */
+    path: string;
+    /** Search-path origin, or `bundled` for the package fallback. */
+    origin: SkillSearchPath['origin'] | 'bundled';
+}
 /**
  * Get ordered skill search paths based on configuration.
  *
@@ -37,11 +49,26 @@ export interface SkillSearchPath {
  */
 export declare function getSkillSearchPaths(projectRoot?: string): SkillSearchPath[];
 /**
- * Resolve a skill directory containing SKILL.md.
- * Searches all paths from getSkillSearchPaths() in priority order.
- * First match wins.
+ * Resolve a skill directory containing SKILL.md, with its origin.
+ * Searches all paths from getSkillSearchPaths() in priority order; first
+ * match wins.
+ *
+ * When no search path holds the skill and `CLEO_SKILL_SOURCE` is `auto` (the
+ * default), falls back to the copy bundled in `@cleocode/skills` with origin
+ * `bundled`, so a spawn prompt can read a protocol it names even when install
+ * selection left it out of the data dir. `caamp` and `embedded` never fall
+ * back (T12646).
+ *
+ * @task T4552
+ * @task T12646
+ */
+export declare function resolveSkillLocation(skillName: string, projectRoot?: string): ResolvedSkillLocation | null;
+/**
+ * Resolve a skill directory containing SKILL.md — the path of
+ * {@link resolveSkillLocation}, including its bundled fallback.
  *
  * @task T4552
+ * @task T12646
  */
 export declare function resolveSkillPath(skillName: string, projectRoot?: string): string | null;
 /**

package/dist/skills/skill-paths.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skill-paths.d.ts","sourceRoot":"","sources":["../../src/skills/skill-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAOH,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,CAAC;AAEpF,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;CAC3C;AA+CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAyC3E;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAWvF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2CjG"}
+{"version":3,"file":"skill-paths.d.ts","sourceRoot":"","sources":["../../src/skills/skill-paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAWH,wDAAwD;AACxD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,OAAO,GAAG,cAAc,GAAG,aAAa,CAAC;AAEpF,yBAAyB;AACzB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,CAAC;AAE5D,yCAAyC;AACzC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,UAAU,CAAC;CAC3C;AAED;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,MAAM,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,SAAS,CAAC;CAC/C;AA+CD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,EAAE,CAyC3E;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,MAAM,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,qBAAqB,GAAG,IAAI,CAW9B;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAEvF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2B7F;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW3F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CA2CjG"}

package/dist/skills/skill-paths.js

@@ -15,7 +15,7 @@
 import { existsSync, lstatSync, readlinkSync, realpathSync } from 'node:fs';
 import { delimiter, join, resolve } from 'node:path';
 import { resolveOrCwd } from '../paths.js';
-import { resolveSkillsRoot } from './skill-root.js';
+import { bundledSkillFallbackEnabled, resolveBundledSkillDir, resolveSkillsRoot, } from './skill-root.js';
 /**
  * Get the canonical skill install root.
  *
@@ -111,21 +111,40 @@ export function getSkillSearchPaths(projectRoot) {
     return paths;
 }
 /**
- * Resolve a skill directory containing SKILL.md.
- * Searches all paths from getSkillSearchPaths() in priority order.
- * First match wins.
+ * Resolve a skill directory containing SKILL.md, with its origin.
+ * Searches all paths from getSkillSearchPaths() in priority order; first
+ * match wins.
+ *
+ * When no search path holds the skill and `CLEO_SKILL_SOURCE` is `auto` (the
+ * default), falls back to the copy bundled in `@cleocode/skills` with origin
+ * `bundled`, so a spawn prompt can read a protocol it names even when install
+ * selection left it out of the data dir. `caamp` and `embedded` never fall
+ * back (T12646).
  *
  * @task T4552
+ * @task T12646
  */
-export function resolveSkillPath(skillName, projectRoot) {
-    const searchPaths = getSkillSearchPaths(projectRoot);
-    for (const { path: searchPath } of searchPaths) {
+export function resolveSkillLocation(skillName, projectRoot) {
+    for (const { path: searchPath, origin } of getSkillSearchPaths(projectRoot)) {
         const candidate = join(searchPath, skillName);
         if (existsSync(join(candidate, 'SKILL.md'))) {
-            return safeRealpath(candidate);
+            return { path: safeRealpath(candidate), origin };
         }
     }
-    return null;
+    if (!bundledSkillFallbackEnabled())
+        return null;
+    const bundled = resolveBundledSkillDir(skillName);
+    return bundled === null ? null : { path: safeRealpath(bundled), origin: 'bundled' };
+}
+/**
+ * Resolve a skill directory containing SKILL.md — the path of
+ * {@link resolveSkillLocation}, including its bundled fallback.
+ *
+ * @task T4552
+ * @task T12646
+ */
+export function resolveSkillPath(skillName, projectRoot) {
+    return resolveSkillLocation(skillName, projectRoot)?.path ?? null;
 }
 /**
  * Resolve a protocol .md file.