@captain_z/zsk 0.1.0

package/dist/commands/project-init.d.ts

@@ -0,0 +1,6 @@
+export type ProjectInitOptions = {
+    target?: string;
+    yes?: boolean;
+    overwrite?: boolean;
+};
+export declare function run(opts?: ProjectInitOptions): Promise<void>;

package/dist/commands/project-init.js

@@ -0,0 +1,63 @@
+// `zsk project-init` — scaffold project-config.md + .raws/ + CLAUDE.md into
+// the current (or given) project directory. Non-destructive by default:
+// existing files are skipped.
+//
+// Similar to Claude Code's /init but project-level (creates project-config.md
+// and .raws/ templates; optionally a CLAUDE.md pointer).
+import pc from "picocolors";
+import { intro, outro, confirm, log, spinner, note } from "../ui/prompts.js";
+import { resolvePath } from "../core/targets.js";
+import { scaffoldTemplate, fileExists } from "../core/scaffolder.js";
+import { join } from "node:path";
+export async function run(opts = {}) {
+    const target = opts.target ? resolvePath(opts.target) : process.cwd();
+    const interactive = !opts.yes;
+    if (interactive) {
+        intro(`${pc.bold("zsk")} · 项目 bootstrap`);
+        log.info(`目标：${pc.cyan(target)}`);
+    }
+    const existingConfig = await fileExists(join(target, "project-config.md"));
+    const existingRaws = await fileExists(join(target, ".raws"));
+    const existingClaude = await fileExists(join(target, "CLAUDE.md"));
+    const summaryPre = [
+        `project-config.md: ${existingConfig ? pc.yellow("已存在（跳过）") : pc.green("将创建")}`,
+        `.raws/:             ${existingRaws ? pc.yellow("已存在（跳过内部文件）") : pc.green("将创建")}`,
+        `CLAUDE.md:          ${existingClaude ? pc.yellow("已存在（跳过）") : pc.green("将创建")}`,
+    ].join("\n");
+    if (interactive) {
+        note(summaryPre, "计划");
+        const proceed = await confirm("继续？", true);
+        if (!proceed) {
+            outro("bye");
+            return;
+        }
+    }
+    const s = interactive ? spinner() : null;
+    s?.start("scaffold 项目文件");
+    const result = await scaffoldTemplate("project-init", target, {
+        overwrite: Boolean(opts.overwrite),
+    });
+    s?.stop("scaffold 完成");
+    const summary = [
+        `✓ 写入 ${result.written.length} 文件`,
+        result.skipped.length > 0 ? `○ 跳过 ${result.skipped.length} 既存` : "",
+    ]
+        .filter(Boolean)
+        .join("\n");
+    const nextSteps = [
+        "",
+        `${pc.bold("下一步：")}`,
+        `1. 编辑 ${pc.cyan("project-config.md")}，把 frontmatter 中的 ${pc.yellow("<fill-me>")} 填完`,
+        `2. 填 ${pc.cyan(".raws/SRS.md")} 与 ${pc.cyan(".raws/FIGMA-INDEX.md")}（或按需删除）`,
+        `3. 跑 ${pc.cyan("npx @captain_z/zsk add")} 选 bundle 安装 skill`,
+    ].join("\n");
+    if (interactive) {
+        note(summary + nextSteps, "bootstrap 摘要");
+        outro("完成");
+    }
+    else {
+        console.log(`\n${summary}`);
+        console.log(nextSteps);
+    }
+}
+//# sourceMappingURL=project-init.js.map

package/dist/commands/project-init.js.map

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

package/dist/commands/remove.d.ts

@@ -0,0 +1,11 @@
+export type RemoveOptions = {
+    target?: string;
+    yes?: boolean;
+    skill?: string[];
+    command?: string[];
+    agent?: string[];
+    hook?: string[];
+    mcpServer?: string[];
+    prompt?: string[];
+};
+export declare function run(positional: string[], opts: RemoveOptions, zskVersion: string): Promise<void>;

package/dist/commands/remove.js

@@ -0,0 +1,209 @@
+// `zsk remove` — multi-select removal of zsk-installed skills.
+//
+// ARCHITECTURE.md §6.4.2:
+//   - Target list filtered to directories with a manifest (avoids foot-guns).
+//   - Multi-select groupMultiselect by domain; hand-modified files marked `⚠️ 手改`.
+//   - Hand-modified files are backed up before deletion.
+//   - Hard confirm step (--yes required for CI; even then, flags must be complete).
+import pc from "picocolors";
+import { rm, mkdir, rename } from "node:fs/promises";
+import { dirname, join } from "node:path";
+import { intro, outro, select, groupMultiselect, confirm, log, spinner, note, } from "../ui/prompts.js";
+import { TARGET_OPTIONS, resolvePath } from "../core/targets.js";
+import { loadSkill, DOMAINS } from "../core/skills.js";
+import { readManifest, writeManifest, buildManifest, detectDrift, } from "../core/manifest.js";
+import { expandCapabilityFilters, } from "../core/capabilities.js";
+export async function run(positional, opts, zskVersion) {
+    intro(`${pc.bold("zsk")} · remove`);
+    const isTTY = Boolean(process.stdout.isTTY);
+    const nonInteractive = Boolean(opts.yes) && Boolean(opts.target) && positional.length + (opts.skill?.length ?? 0) > 0;
+    if (!isTTY && !nonInteractive) {
+        log.error("非 TTY 环境需完整 flags：--target + 至少一个 pattern/--skill + --yes");
+        outro("bye");
+        process.exit(1);
+    }
+    // Step 1 — target (flag preloads)
+    const targetPath = await selectTarget(opts);
+    const manifest = await readManifest(targetPath);
+    if (!manifest) {
+        log.error(`${targetPath} 不是 zsk 管理目录（缺 zsk-manifest.json）`);
+        outro(`运行 ${pc.cyan("zsk list")} 查看已管理目录`);
+        process.exit(1);
+    }
+    const drift = await detectDrift(targetPath, manifest);
+    const installedNames = manifest.skills.map((s) => s.name);
+    // Step 2 — pick skills (patterns → skip multiselect; else interactive)
+    const patterns = [
+        ...positional,
+        ...(opts.skill ?? []),
+    ];
+    let toRemove;
+    if (patterns.length > 0) {
+        toRemove = expandCapabilityFilters(patterns, installedNames);
+        if (toRemove.length === 0) {
+            log.error(`未匹配到已装 skill：${patterns.join(", ")}`);
+            outro("bye");
+            process.exit(1);
+        }
+    }
+    else {
+        toRemove = await pickRemovals(manifest, drift);
+    }
+    if (toRemove.length === 0) {
+        log.warn("未选任何 skill，退出。");
+        outro("bye");
+        return;
+    }
+    // Step 3 — hard confirm (destructive)
+    const confirmed = await confirmRemoval(toRemove, drift, targetPath, opts);
+    if (!confirmed) {
+        outro("已取消");
+        return;
+    }
+    // Step 4 — execute (backup hand-modified, then delete)
+    const s = spinner();
+    s.start(`移除 ${toRemove.length} skill`);
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const backupDir = join(targetPath, ".zsk-backup", timestamp);
+    const removed = [];
+    const backedUp = [];
+    const errors = [];
+    try {
+        const toRemoveSet = new Set(toRemove);
+        const modifiedSet = new Set(drift.filter((d) => d.kind === "modified").map((d) => d.name));
+        for (const name of toRemove) {
+            const record = manifest.skills.find((r) => r.name === name);
+            if (!record)
+                continue;
+            const abs = join(targetPath, record.relPath);
+            try {
+                if (modifiedSet.has(name)) {
+                    const backupPath = join(backupDir, record.relPath);
+                    await mkdir(dirname(backupPath), { recursive: true });
+                    await rename(abs, backupPath);
+                    backedUp.push(backupPath);
+                }
+                else {
+                    await rm(abs, { force: true });
+                }
+                // clean up empty parent dir (zsk-<slug>/)
+                const parent = dirname(abs);
+                await rm(parent, { recursive: true, force: true }).catch(() => { });
+                removed.push(name);
+            }
+            catch (err) {
+                errors.push({
+                    skill: name,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        // Update manifest (remove entries) or delete it entirely if empty
+        const remaining = manifest.skills.filter((r) => !toRemoveSet.has(r.name));
+        if (remaining.length === 0) {
+            await rm(join(targetPath, "zsk-manifest.json"), { force: true });
+        }
+        else {
+            await writeManifest(targetPath, buildManifest({
+                zskVersion,
+                bundle: manifest.bundle,
+                skills: remaining,
+            }));
+        }
+        s.stop("移除完成");
+    }
+    catch (err) {
+        s.stop("移除失败");
+        throw err;
+    }
+    const summary = [
+        `✓ ${removed.length} skill 已删除`,
+        backedUp.length > 0 ? `↶ 备份 ${backedUp.length} 文件 → ${backupDir}` : "",
+        errors.length > 0 ? `✗ ${errors.length} 错误` : "",
+        `✓ manifest 已更新（${manifest.skills.length} → ${manifest.skills.length - removed.length}）`,
+    ]
+        .filter(Boolean)
+        .join("\n");
+    note(summary, "移除摘要");
+    if (errors.length > 0) {
+        for (const err of errors)
+            log.error(`${err.skill}: ${err.message}`);
+    }
+    outro("完成");
+}
+// ---- helpers ----------------------------------------------------------------
+async function selectTarget(opts) {
+    if (opts.target)
+        return resolvePath(opts.target);
+    const candidates = await Promise.all(TARGET_OPTIONS.filter((t) => t.kind !== "custom").map(async (t) => {
+        const path = t.resolve();
+        const manifest = await readManifest(path).catch(() => null);
+        if (!manifest)
+            return null;
+        const drift = await detectDrift(path, manifest);
+        const modified = drift.filter((d) => d.kind === "modified").length;
+        const hint = [
+            manifest.bundle ?? "custom",
+            `${manifest.skills.length} 颗`,
+            modified > 0 ? pc.yellow(`${modified} 手改`) : "",
+        ]
+            .filter(Boolean)
+            .join(" · ");
+        return {
+            kind: t.kind,
+            label: t.label,
+            hint,
+            path,
+        };
+    }));
+    const managed = candidates.filter((c) => c !== null);
+    if (managed.length === 0) {
+        log.error("没有 zsk 管理的目录（未找到 zsk-manifest.json）");
+        outro(`先跑 ${pc.cyan("zsk add")} 或 ${pc.cyan("zsk list")}`);
+        process.exit(1);
+    }
+    const kind = await select("从哪里移除？", managed.map((c) => ({
+        value: c.kind,
+        label: `${c.label.padEnd(24)} ${pc.dim(c.hint)}`,
+    })));
+    return managed.find((c) => c.kind === kind).path;
+}
+async function pickRemovals(manifest, drift) {
+    const modifiedSet = new Set(drift.filter((d) => d.kind === "modified").map((d) => d.name));
+    const grouped = {};
+    for (const d of DOMAINS)
+        grouped[d] = [];
+    for (const s of manifest.skills) {
+        const marker = modifiedSet.has(s.name) ? pc.yellow(" ⚠️ 手改") : "";
+        try {
+            const meta = await loadSkill(s.name);
+            grouped[meta.domain].push({
+                value: s.name,
+                label: `${s.name}${marker}`,
+            });
+        }
+        catch {
+            (grouped.unknown ??= []).push({
+                value: s.name,
+                label: `${s.name}${marker} (unknown domain)`,
+            });
+        }
+    }
+    for (const k of Object.keys(grouped)) {
+        if (grouped[k].length === 0)
+            delete grouped[k];
+    }
+    return groupMultiselect("选择要移除的 skill（Space 切换 · a 全选 · A 全不选 · Enter 确认）", grouped, []);
+}
+async function confirmRemoval(names, drift, targetPath, opts) {
+    const modifiedSet = new Set(drift.filter((d) => d.kind === "modified").map((d) => d.name));
+    const lines = names.map((n) => {
+        const mark = modifiedSet.has(n) ? pc.yellow(" · 手改 → 备份") : "";
+        return `· ${n}${mark}`;
+    });
+    note(lines.join("\n"), `将从 ${targetPath} 移除 ${names.length} 颗`);
+    if (opts.yes)
+        return true;
+    return confirm("确认移除？", false);
+}
+//# sourceMappingURL=remove.js.map

package/dist/commands/remove.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remove.js","sourceRoot":"","sources":["../../src/commands/remove.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,EAAE;AACF,0BAA0B;AAC1B,8EAA8E;AAC9E,mFAAmF;AACnF,yDAAyD;AACzD,oFAAoF;AAEpF,OAAO,EAAE,MAAM,YAAY,CAAC;AAC5B,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EACL,KAAK,EACL,KAAK,EACL,MAAM,EACN,gBAAgB,EAChB,OAAO,EACP,GAAG,EACH,OAAO,EACP,IAAI,GACL,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,WAAW,EAAmB,MAAM,oBAAoB,CAAC;AAClF,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,GAGZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,uBAAuB,GAExB,MAAM,yBAAyB,CAAC;AAajC,MAAM,CAAC,KAAK,UAAU,GAAG,CACvB,UAAoB,EACpB,IAAmB,EACnB,UAAkB;IAElB,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAEpC,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,cAAc,GAClB,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC;IAEjG,IAAI,CAAC,KAAK,IAAI,CAAC,cAAc,EAAE,CAAC;QAC9B,GAAG,CAAC,KAAK,CACP,2DAA2D,CAC5D,CAAC;QACF,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,kCAAkC;IAClC,MAAM,UAAU,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAChD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,GAAG,CAAC,KAAK,CAAC,GAAG,UAAU,mCAAmC,CAAC,CAAC;QAC5D,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACtD,MAAM,cAAc,GAAG,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAE1D,uEAAuE;IACvE,MAAM,QAAQ,GAAG;QACf,GAAG,UAAU;QACb,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAAC;KACtB,CAAC;IACF,IAAI,QAAkB,CAAC;IAEvB,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,GAAG,uBAAuB,CAAC,QAAQ,EAAE,cAAc,CAAC,CAAC;QAC7D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,GAAG,CAAC,KAAK,CAAC,gBAAgB,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACjD,KAAK,CAAC,KAAK,CAAC,CAAC;YACb,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,QAAQ,GAAG,MAAM,YAAY,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,GAAG,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;QAC3B,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IAED,sCAAsC;IACtC,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,QAAQ,EAAE,KAAK,EAAE,UAAU,EAAE,IAAI,CAAC,CAAC;IAC1E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,OAAO;IACT,CAAC;IAED,uDAAuD;IACvD,MAAM,CAAC,GAAG,OAAO,EAAE,CAAC;IACpB,CAAC,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,MAAM,QAAQ,CAAC,CAAC;IAEvC,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,EAAE,aAAa,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,MAAM,GAA8C,EAAE,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;QACtC,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9D,CAAC;QAEF,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,MAAM,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;YAC5D,IAAI,CAAC,MAAM;gBAAE,SAAS;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC;gBACH,IAAI,WAAW,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC1B,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;oBACnD,MAAM,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBACtD,MAAM,MAAM,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;oBAC9B,QAAQ,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;gBAC5B,CAAC;qBAAM,CAAC;oBACN,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;gBACjC,CAAC;gBACD,0CAA0C;gBAC1C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC5B,MAAM,EAAE,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBACnE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACrB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,MAAM,CAAC,IAAI,CAAC;oBACV,KAAK,EAAE,IAAI;oBACX,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;iBAC1D,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,kEAAkE;QAClE,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QAC1E,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC3B,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,EAAE,mBAAmB,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACnE,CAAC;aAAM,CAAC;YACN,MAAM,aAAa,CACjB,UAAU,EACV,aAAa,CAAC;gBACZ,UAAU;gBACV,MAAM,EAAE,QAAQ,CAAC,MAAM;gBACvB,MAAM,EAAE,SAAS;aAClB,CAAC,CACH,CAAC;QACJ,CAAC;QAED,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACf,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG;QACd,KAAK,OAAO,CAAC,MAAM,YAAY;QAC/B,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,QAAQ,CAAC,MAAM,SAAS,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE;QACtE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,EAAE;QAChD,kBAAkB,QAAQ,CAAC,MAAM,CAAC,MAAM,MAAM,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG;KACzF;SACE,MAAM,CAAC,OAAO,CAAC;SACf,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;IAEtB,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,KAAK,MAAM,GAAG,IAAI,MAAM;YAAE,GAAG,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,CAAC;AACd,CAAC;AAED,gFAAgF;AAEhF,KAAK,UAAU,YAAY,CAAC,IAAmB;IAC7C,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEjD,MAAM,UAAU,GAAG,MAAM,OAAO,CAAC,GAAG,CAClC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE;QAChE,MAAM,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,CAAC;QACzB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QAC5D,IAAI,CAAC,QAAQ;YAAE,OAAO,IAAI,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,MAAM,CAAC;QACnE,MAAM,IAAI,GAAG;YACX,QAAQ,CAAC,MAAM,IAAI,QAAQ;YAC3B,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,IAAI;YAC7B,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE;SAChD;aACE,MAAM,CAAC,OAAO,CAAC;aACf,IAAI,CAAC,KAAK,CAAC,CAAC;QACf,OAAO;YACL,IAAI,EAAE,CAAC,CAAC,IAAI;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,IAAI;YACJ,IAAI;SACL,CAAC;IACJ,CAAC,CAAC,CACH,CAAC;IAEF,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAC/B,CAAC,CAAC,EAA8B,EAAE,CAAC,CAAC,KAAK,IAAI,CAC9C,CAAC;IACF,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,GAAG,CAAC,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACjD,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,MAAM,CACvB,QAAQ,EACR,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAClB,KAAK,EAAE,CAAC,CAAC,IAAI;QACb,KAAK,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE;KACjD,CAAC,CAAC,CACJ,CAAC;IACF,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAE,CAAC,IAAI,CAAC;AACpD,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,QAAkB,EAClB,KAAmB;IAEnB,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9D,CAAC;IACF,MAAM,OAAO,GAA4D,EAAE,CAAC;IAC5E,KAAK,MAAM,CAAC,IAAI,OAAO;QAAE,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;IAEzC,KAAK,MAAM,CAAC,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACrC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC;gBACzB,KAAK,EAAE,CAAC,CAAC,IAAI;gBACb,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,MAAM,EAAE;aAC5B,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,CAAC,OAAO,CAAC,OAAO,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC;gBAC5B,KAAK,EAAE,CAAC,CAAC,IAAI;gBACb,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,GAAG,MAAM,mBAAmB;aAC7C,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,IAAI,OAAO,CAAC,CAAC,CAAE,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,OAAO,gBAAgB,CACrB,kDAAkD,EAClD,OAAO,EACP,EAAE,CACH,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,cAAc,CAC3B,KAAe,EACf,KAAmB,EACnB,UAAkB,EAClB,IAAmB;IAEnB,MAAM,WAAW,GAAG,IAAI,GAAG,CACzB,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAC9D,CAAC;IACF,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;QAC5B,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO,KAAK,CAAC,GAAG,IAAI,EAAE,CAAC;IACzB,CAAC,CAAC,CAAC;IACH,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,UAAU,OAAO,KAAK,CAAC,MAAM,IAAI,CAAC,CAAC;IAEhE,IAAI,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/core/bundles.d.ts

@@ -0,0 +1,7 @@
+export type Bundle = {
+    label: string;
+    hint: string;
+    skills: string[];
+};
+export type Bundles = Record<string, Bundle>;
+export declare function loadBundles(): Promise<Bundles>;

package/dist/core/bundles.js

@@ -0,0 +1,39 @@
+// Load bundles.yaml from @captain_z/zsk-skills.
+//
+// Dev (monorepo via tsx/pnpm workspace): resolves sibling packages/skills/bundles.yaml.
+// Production (installed from npm): resolves via the package's "exports" map.
+import { readFile } from "node:fs/promises";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { createRequire } from "node:module";
+import { parse as parseYaml } from "yaml";
+export async function loadBundles() {
+    const path = await resolveBundlesPath();
+    const raw = await readFile(path, "utf8");
+    const parsed = parseYaml(raw);
+    if (!parsed?.bundles) {
+        throw new Error(`bundles.yaml is missing the "bundles" root key: ${path}`);
+    }
+    return parsed.bundles;
+}
+async function resolveBundlesPath() {
+    // Dev (monorepo): packages/cli/src/core/bundles.ts → packages/skills/bundles.yaml
+    const thisDir = dirname(fileURLToPath(import.meta.url));
+    const devPath = resolve(thisDir, "../../../skills/bundles.yaml");
+    try {
+        await readFile(devPath);
+        return devPath;
+    }
+    catch {
+        // fall through
+    }
+    // Production: resolve via the skills package export
+    const require = createRequire(import.meta.url);
+    try {
+        return require.resolve("@captain_z/zsk-skills/bundles.yaml");
+    }
+    catch {
+        throw new Error("Could not locate bundles.yaml in @captain_z/zsk-skills (is it installed?)");
+    }
+}
+//# sourceMappingURL=bundles.js.map

package/dist/core/bundles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bundles.js","sourceRoot":"","sources":["../../src/core/bundles.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,wFAAwF;AACxF,6EAA6E;AAE7E,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,KAAK,IAAI,SAAS,EAAE,MAAM,MAAM,CAAC;AAU1C,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,MAAM,IAAI,GAAG,MAAM,kBAAkB,EAAE,CAAC;IACxC,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,SAAS,CAAC,GAAG,CAA0B,CAAC;IACvD,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CAAC,mDAAmD,IAAI,EAAE,CAAC,CAAC;IAC7E,CAAC;IACD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED,KAAK,UAAU,kBAAkB;IAC/B,kFAAkF;IAClF,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,8BAA8B,CAAC,CAAC;IACjE,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxB,OAAO,OAAO,CAAC;IACjB,CAAC;IAAC,MAAM,CAAC;QACP,eAAe;IACjB,CAAC;IACD,oDAAoD;IACpD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,IAAI,CAAC;QACH,OAAO,OAAO,CAAC,OAAO,CAAC,oCAAoC,CAAC,CAAC;IAC/D,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CACb,2EAA2E,CAC5E,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/core/capabilities.d.ts

@@ -0,0 +1,25 @@
+export type CapabilityType = "skill" | "command" | "agent" | "hook" | "mcp-server" | "prompt";
+export declare const CAPABILITY_TYPES: readonly CapabilityType[];
+export type CapabilityFilters = Partial<Record<CapabilityType, string[]>>;
+export declare function hasCapabilityFilter(filters: CapabilityFilters): boolean;
+/**
+ * Collect commander-style repeated option values into string[].
+ * Commander passes `string | string[] | undefined` depending on how many times
+ * a flag is seen; normalize to always-an-array.
+ */
+export declare function collectValues(v: string | string[] | undefined): string[];
+/**
+ * Expand capability filters against a candidate pool.
+ * `'*'` matches all; exact names (e.g. `zsk:spec`) match by equality;
+ * globs (e.g. `zsk:a11y-*`) convert to regex.
+ *
+ * Returns a de-duplicated, sorted list of names that matched at least one
+ * filter pattern.
+ */
+export declare function expandCapabilityFilters(patterns: string[], pool: string[]): string[];
+/**
+ * Decide whether a positional `<pattern>` arg is a bundle name, a skill
+ * identifier (`zsk:xxx`), or a glob. Used by `add` to route straight to the
+ * groupMultiselect step (bundle) or skip both pick screens (skill/glob).
+ */
+export declare function classifyPattern(pattern: string, bundleNames: string[]): "bundle" | "skill" | "glob" | "unknown";

package/dist/core/capabilities.js

@@ -0,0 +1,79 @@
+// Capability-type flags: --skill / --command / --agent / --hook / --mcp-server / --prompt.
+// Each value may be `'*'` (all of that type), an exact name, or a glob.
+// MVP: only `skill` resolves to real content; other capability types are
+// grammar-complete but currently expand to an empty set (see ARCHITECTURE §3).
+export const CAPABILITY_TYPES = [
+    "skill",
+    "command",
+    "agent",
+    "hook",
+    "mcp-server",
+    "prompt",
+];
+export function hasCapabilityFilter(filters) {
+    return CAPABILITY_TYPES.some((t) => (filters[t]?.length ?? 0) > 0);
+}
+/**
+ * Collect commander-style repeated option values into string[].
+ * Commander passes `string | string[] | undefined` depending on how many times
+ * a flag is seen; normalize to always-an-array.
+ */
+export function collectValues(v) {
+    if (v === undefined)
+        return [];
+    return Array.isArray(v) ? v : [v];
+}
+/**
+ * Expand capability filters against a candidate pool.
+ * `'*'` matches all; exact names (e.g. `zsk:spec`) match by equality;
+ * globs (e.g. `zsk:a11y-*`) convert to regex.
+ *
+ * Returns a de-duplicated, sorted list of names that matched at least one
+ * filter pattern.
+ */
+export function expandCapabilityFilters(patterns, pool) {
+    if (patterns.length === 0)
+        return [];
+    const hit = new Set();
+    for (const pat of patterns) {
+        if (pat === "*") {
+            for (const p of pool)
+                hit.add(p);
+            continue;
+        }
+        if (hasGlobChar(pat)) {
+            const re = globToRegex(pat);
+            for (const p of pool)
+                if (re.test(p))
+                    hit.add(p);
+            continue;
+        }
+        if (pool.includes(pat))
+            hit.add(pat);
+    }
+    return [...hit].sort();
+}
+function hasGlobChar(s) {
+    return s.includes("*") || s.includes("?");
+}
+function globToRegex(glob) {
+    // Minimal glob: `*` → `.*`, `?` → `.`, other regex metachars escaped.
+    const escaped = glob.replace(/[.+^${}()|[\]\\]/g, "\\$&");
+    const pattern = escaped.replace(/\*/g, ".*").replace(/\?/g, ".");
+    return new RegExp(`^${pattern}$`);
+}
+/**
+ * Decide whether a positional `<pattern>` arg is a bundle name, a skill
+ * identifier (`zsk:xxx`), or a glob. Used by `add` to route straight to the
+ * groupMultiselect step (bundle) or skip both pick screens (skill/glob).
+ */
+export function classifyPattern(pattern, bundleNames) {
+    if (hasGlobChar(pattern))
+        return "glob";
+    if (bundleNames.includes(pattern))
+        return "bundle";
+    if (pattern.startsWith("zsk:"))
+        return "skill";
+    return "unknown";
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/core/capabilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.js","sourceRoot":"","sources":["../../src/core/capabilities.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,wEAAwE;AACxE,yEAAyE;AACzE,+EAA+E;AAU/E,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,OAAO;IACP,SAAS;IACT,OAAO;IACP,MAAM;IACN,YAAY;IACZ,QAAQ;CACA,CAAC;AAIX,MAAM,UAAU,mBAAmB,CAAC,OAA0B;IAC5D,OAAO,gBAAgB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AACrE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,CAAgC;IAC5D,IAAI,CAAC,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IAC/B,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACpC,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAkB,EAClB,IAAc;IAEd,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACrC,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,GAAG,IAAI,QAAQ,EAAE,CAAC;QAC3B,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;YAChB,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjC,SAAS;QACX,CAAC;QACD,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC;YAC5B,KAAK,MAAM,CAAC,IAAI,IAAI;gBAAE,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC;oBAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACjD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC;YAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;AACzB,CAAC;AAED,SAAS,WAAW,CAAC,CAAS;IAC5B,OAAO,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC5C,CAAC;AAED,SAAS,WAAW,CAAC,IAAY;IAC/B,sEAAsE;IACtE,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACjE,OAAO,IAAI,MAAM,CAAC,IAAI,OAAO,GAAG,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAe,EACf,WAAqB;IAErB,IAAI,WAAW,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IACxC,IAAI,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,QAAQ,CAAC;IACnD,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,OAAO,CAAC;IAC/C,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/core/installer.d.ts

@@ -0,0 +1,18 @@
+export type ConflictMode = "skip" | "overwrite" | "backup";
+export type InstallPlan = {
+    skills: string[];
+    target: string;
+    onConflict: ConflictMode;
+    dryRun: boolean;
+};
+export type InstallResult = {
+    written: string[];
+    skipped: string[];
+    backedUp: string[];
+    errors: Array<{
+        skill: string;
+        message: string;
+    }>;
+    backupDir: string | null;
+};
+export declare function install(plan: InstallPlan): Promise<InstallResult>;

package/dist/core/installer.js

@@ -0,0 +1,114 @@
+// Install engine: staging → rename + conflict resolution + backup.
+import { mkdir, copyFile, rm, rename, readdir, access, } from "node:fs/promises";
+import { dirname, join, relative } from "node:path";
+import { loadSkill } from "./skills.js";
+export async function install(plan) {
+    const result = {
+        written: [],
+        skipped: [],
+        backedUp: [],
+        errors: [],
+        backupDir: null,
+    };
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const stagingDir = join(plan.target, `.zsk-staging-${timestamp}`);
+    const backupDir = join(plan.target, ".zsk-backup", timestamp);
+    // Dry-run: enumerate target paths and return without touching disk
+    if (plan.dryRun) {
+        for (const skillName of plan.skills) {
+            try {
+                const skill = await loadSkill(skillName);
+                const dst = skillTargetPath(plan.target, skill);
+                result.written.push(dst);
+            }
+            catch (err) {
+                result.errors.push({
+                    skill: skillName,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        return result;
+    }
+    try {
+        await mkdir(plan.target, { recursive: true });
+        await mkdir(stagingDir, { recursive: true });
+        // Stage all skills
+        for (const skillName of plan.skills) {
+            try {
+                const skill = await loadSkill(skillName);
+                const stagingDst = skillTargetPath(stagingDir, skill);
+                await mkdir(dirname(stagingDst), { recursive: true });
+                await copyFile(skill.file, stagingDst);
+            }
+            catch (err) {
+                result.errors.push({
+                    skill: skillName,
+                    message: err instanceof Error ? err.message : String(err),
+                });
+            }
+        }
+        // Commit staging → target, handling conflicts per skill file
+        await commitStaging(stagingDir, plan.target, plan.onConflict, backupDir, result);
+    }
+    finally {
+        await rm(stagingDir, { recursive: true, force: true });
+    }
+    return result;
+}
+function skillTargetPath(root, skill) {
+    // Flat layout: <target>/zsk-<slug>/SKILL.md
+    // Claude / Codex scan `<root>/<dir>/SKILL.md` one level deep; nested
+    // <domain>/<slug>/ would be skipped. `zsk-` prefix namespaces against
+    // existing flat skills (archive / coding / design / reviewing etc).
+    return join(root, `zsk-${skill.slug}`, "SKILL.md");
+}
+async function commitStaging(stagingDir, target, onConflict, backupDir, result) {
+    const files = await walk(stagingDir);
+    for (const src of files) {
+        const rel = relative(stagingDir, src);
+        const dst = join(target, rel);
+        const exists = await fileExists(dst);
+        if (exists) {
+            if (onConflict === "skip") {
+                result.skipped.push(dst);
+                continue;
+            }
+            if (onConflict === "backup") {
+                const backupPath = join(backupDir, rel);
+                await mkdir(dirname(backupPath), { recursive: true });
+                await rename(dst, backupPath);
+                result.backedUp.push(backupPath);
+                result.backupDir = backupDir;
+            }
+            // overwrite: fall through
+        }
+        await mkdir(dirname(dst), { recursive: true });
+        await copyFile(src, dst);
+        result.written.push(dst);
+    }
+}
+async function fileExists(p) {
+    try {
+        await access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function walk(dir) {
+    const out = [];
+    const entries = await readdir(dir, { withFileTypes: true });
+    for (const e of entries) {
+        const p = join(dir, e.name);
+        if (e.isDirectory()) {
+            out.push(...(await walk(p)));
+        }
+        else {
+            out.push(p);
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=installer.js.map

package/dist/core/installer.js.map

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