vskill 1.0.13 → 1.0.15

package/dist/clone/skill-locator.js

@@ -0,0 +1,248 @@
+// ---------------------------------------------------------------------------
+// vskill clone — skill-locator
+// ---------------------------------------------------------------------------
+// Discover a source skill across the three supported locations, in deterministic
+// order. The caller (orchestrator in src/commands/clone.ts) decides what to do
+// with multiple matches (interactive disambiguation or honor --source override).
+//
+// Search order:
+//   1. project   → <cwd>/.claude/skills/<skill>/SKILL.md
+//   2. personal  → <home>/.claude/skills/<skill>/SKILL.md
+//   3. cache     → <home>/.claude/plugins/cache/<org>/<plugin>/<version>/skills/<skill>/SKILL.md
+//
+// Source identifiers may be passed as:
+//   - "ado-mapper"     (bare skill name)
+//   - "sw/ado-mapper"  (namespace/skill — namespace is treated informationally)
+//
+// See spec.md AC-US1-01 and plan.md §4.
+// ---------------------------------------------------------------------------
+import { promises as fs } from "node:fs";
+import { join, basename } from "node:path";
+import { readProvenance } from "../studio/lib/provenance.js";
+const FRONTMATTER_RE = /^---\n([\s\S]*?)\n---/;
+const NAME_LINE_RE = /^name:\s*(.+?)\s*$/m;
+const VERSION_LINE_RE = /^version:\s*(.+?)\s*$/m;
+function unquote(value) {
+    const trimmed = value.trim();
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+async function parseSkillMd(skillMdPath) {
+    try {
+        const raw = await fs.readFile(skillMdPath, "utf-8");
+        const normalized = raw.replace(/^/, "").replace(/\r\n/g, "\n");
+        const fmMatch = normalized.match(FRONTMATTER_RE);
+        if (!fmMatch)
+            return {};
+        const block = fmMatch[1];
+        const nameMatch = block.match(NAME_LINE_RE);
+        const versionMatch = block.match(VERSION_LINE_RE);
+        return {
+            name: nameMatch ? unquote(nameMatch[1]) : undefined,
+            version: versionMatch ? unquote(versionMatch[1]) : undefined,
+        };
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * Split a source identifier like "sw/ado-mapper" into namespace + skill, or
+ * return only the skill when no namespace is present.
+ */
+export function parseSourceIdent(source) {
+    const idx = source.indexOf("/");
+    if (idx === -1)
+        return { skill: source };
+    return { namespace: source.slice(0, idx), skill: source.slice(idx + 1) };
+}
+async function exists(path) {
+    try {
+        await fs.access(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function dirExists(path) {
+    try {
+        const st = await fs.stat(path);
+        return st.isDirectory();
+    }
+    catch {
+        return false;
+    }
+}
+async function buildSource(location, skillDir, fallbackSkillName, pluginCtx) {
+    const skillMd = join(skillDir, "SKILL.md");
+    if (!(await exists(skillMd)))
+        return null;
+    const fm = await parseSkillMd(skillMd);
+    const fullName = fm.name ?? fallbackSkillName;
+    const slashIdx = fullName.indexOf("/");
+    const namespace = slashIdx >= 0 ? fullName.slice(0, slashIdx) : undefined;
+    let existingProvenance = null;
+    try {
+        existingProvenance = await readProvenance(skillDir);
+    }
+    catch {
+        existingProvenance = null;
+    }
+    return {
+        location,
+        skillDir,
+        skillName: fullName,
+        namespace,
+        version: fm.version ?? "0.0.0",
+        plugin: pluginCtx,
+        existingProvenance,
+    };
+}
+async function locateInProject(cwd, skill) {
+    const dir = join(cwd, ".claude", "skills", skill);
+    if (!(await dirExists(dir)))
+        return null;
+    return buildSource("project", dir, skill);
+}
+async function locateInPersonal(home, skill) {
+    const dir = join(home, ".claude", "skills", skill);
+    if (!(await dirExists(dir)))
+        return null;
+    return buildSource("personal", dir, skill);
+}
+async function locateInCache(home, skill, preferredNamespace) {
+    const cacheRoot = join(home, ".claude", "plugins", "cache");
+    if (!(await dirExists(cacheRoot)))
+        return [];
+    const matches = [];
+    let orgs;
+    try {
+        orgs = await fs.readdir(cacheRoot);
+    }
+    catch {
+        return [];
+    }
+    for (const org of orgs) {
+        const orgDir = join(cacheRoot, org);
+        if (!(await dirExists(orgDir)))
+            continue;
+        let plugins;
+        try {
+            plugins = await fs.readdir(orgDir);
+        }
+        catch {
+            continue;
+        }
+        for (const pluginName of plugins) {
+            const pluginRoot = join(orgDir, pluginName);
+            if (!(await dirExists(pluginRoot)))
+                continue;
+            let versions;
+            try {
+                versions = await fs.readdir(pluginRoot);
+            }
+            catch {
+                continue;
+            }
+            for (const version of versions) {
+                const skillDir = join(pluginRoot, version, "skills", skill);
+                if (!(await dirExists(skillDir)))
+                    continue;
+                const built = await buildSource("cache", skillDir, skill, {
+                    pluginNamespace: org,
+                    pluginName,
+                    pluginVersion: version,
+                    pluginRoot: join(pluginRoot, version),
+                });
+                if (!built)
+                    continue;
+                if (preferredNamespace && built.namespace && built.namespace !== preferredNamespace) {
+                    continue;
+                }
+                matches.push(built);
+            }
+        }
+    }
+    return matches;
+}
+/**
+ * Discover a skill across project / personal / cache. Returns every match in
+ * search order — the orchestrator handles disambiguation when there is more
+ * than one and `--source` was not explicitly provided.
+ */
+export async function locateSkill(source, opts) {
+    const { skill, namespace } = parseSourceIdent(source);
+    const cwd = opts.cwd ?? process.cwd();
+    const matches = [];
+    const project = await locateInProject(cwd, skill);
+    if (project && (!namespace || project.namespace === namespace || !project.namespace)) {
+        matches.push(project);
+    }
+    const personal = await locateInPersonal(opts.home, skill);
+    if (personal && (!namespace || personal.namespace === namespace || !personal.namespace)) {
+        matches.push(personal);
+    }
+    const cache = await locateInCache(opts.home, skill, namespace);
+    matches.push(...cache);
+    return matches;
+}
+/**
+ * Enumerate every skill inside a cached plugin. Used by the whole-plugin
+ * clone path (T-010). Returns a list of SkillSource entries (one per skill).
+ */
+export async function enumeratePluginSkills(pluginName, opts) {
+    const cacheRoot = join(opts.home, ".claude", "plugins", "cache");
+    if (!(await dirExists(cacheRoot)))
+        return [];
+    const results = [];
+    let orgs;
+    try {
+        orgs = await fs.readdir(cacheRoot);
+    }
+    catch {
+        return [];
+    }
+    for (const org of orgs) {
+        const pluginRoot = join(cacheRoot, org, pluginName);
+        if (!(await dirExists(pluginRoot)))
+            continue;
+        let versions;
+        try {
+            versions = await fs.readdir(pluginRoot);
+        }
+        catch {
+            continue;
+        }
+        for (const version of versions) {
+            const skillsDir = join(pluginRoot, version, "skills");
+            if (!(await dirExists(skillsDir)))
+                continue;
+            let skillEntries;
+            try {
+                skillEntries = await fs.readdir(skillsDir);
+            }
+            catch {
+                continue;
+            }
+            for (const skillEntry of skillEntries) {
+                const skillDir = join(skillsDir, skillEntry);
+                if (!(await dirExists(skillDir)))
+                    continue;
+                const built = await buildSource("cache", skillDir, basename(skillDir), {
+                    pluginNamespace: org,
+                    pluginName,
+                    pluginVersion: version,
+                    pluginRoot: join(pluginRoot, version),
+                });
+                if (built)
+                    results.push(built);
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=skill-locator.js.map

package/dist/clone/skill-locator.js.map

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

package/dist/clone/target-router.d.ts

@@ -0,0 +1,73 @@
+import { basename } from "node:path";
+export interface CopyResult {
+    /** Absolute path of the `.tmp` staging directory. Caller renames into place. */
+    stagingDir: string;
+    /** Number of files written under `stagingDir`. */
+    filesCopied: number;
+    /** Final destination path (where `stagingDir` should be renamed to). */
+    finalDir: string;
+}
+export interface PluginCopyResult extends CopyResult {
+    /** Absolute path of the `.tmp` staged plugin manifest (sibling of the live manifest). */
+    manifestTmpPath: string;
+    /** Absolute path of the live plugin manifest (final rename target). */
+    manifestFinalPath: string;
+}
+/** Compute the `.tmp` sibling of a final destination path. */
+export declare function tmpSibling(finalPath: string): string;
+/**
+ * Best-effort cleanup of a `.tmp` path. Mirrors the rollback shape used by
+ * src/commands/add.ts:rollbackInstall — swallows per-call errors so a partial
+ * filesystem state doesn't suppress the underlying diagnostic the orchestrator
+ * is about to surface to the user.
+ */
+export declare function bestEffortRm(path: string): void;
+/**
+ * Copy a source skill into a fresh standalone target dir, staged at
+ * `<finalDir>.tmp`. The orchestrator is responsible for the atomic
+ * rename and any pre-checks for collisions / `--force`.
+ */
+export declare function writeStandalone(args: {
+    sourceSkillDir: string;
+    finalDir: string;
+}): Promise<CopyResult>;
+/**
+ * Copy a source skill into an existing user-owned plugin's skills/ directory
+ * AND stage an updated `plugin.json` at `<plugin.json>.tmp` so the
+ * orchestrator can rename both in sequence (two-phase commit).
+ *
+ * Pre-flight: detects malformed plugin.json BEFORE any copy is staged
+ * (AC-US2-03). Caller aborts on the thrown error; no skill files are written.
+ */
+export declare function writeToPlugin(args: {
+    sourceSkillDir: string;
+    pluginRoot: string;
+    newSkillName: string;
+}): Promise<PluginCopyResult>;
+/**
+ * Scaffold a fresh new plugin at `<pluginRoot>` containing
+ * `.claude-plugin/plugin.json` (with the requested name) plus
+ * `skills/<skill>/` subtree containing the cloned skill.
+ *
+ * The whole plugin tree is staged at `<pluginRoot>.tmp` and atomically
+ * renamed by the caller — there is no two-phase commit because the manifest
+ * and the skill files live under a common root (one `rename` is enough).
+ */
+export declare function writeNewPlugin(args: {
+    sourceSkillDir: string;
+    pluginRoot: string;
+    pluginName: string;
+    newSkillName: string;
+    /** Optional plugin description; defaults to a generic forked-skills line. */
+    description?: string;
+    /** Optional plugin author; recorded in plugin.json. */
+    author?: string;
+}): Promise<CopyResult>;
+/**
+ * The `bareSkillName` helper extracts the unqualified skill name from a
+ * fully-qualified name like `anton/ado-mapper` → `ado-mapper`. Used by the
+ * orchestrator and by callers that need the directory-safe segment.
+ */
+export declare function bareSkillName(fullyQualified: string): string;
+/** Re-export for callers that want to validate basenames. */
+export { basename };

package/dist/clone/target-router.js

@@ -0,0 +1,200 @@
+// ---------------------------------------------------------------------------
+// vskill clone — target-router
+// ---------------------------------------------------------------------------
+// Three target writers, all `.tmp`-staged so the orchestrator can atomically
+// rename the staged copy into place once every other step (frontmatter
+// rewrite, provenance write, validation) has succeeded.
+//
+//   writeStandalone  → drop the cloned skill at <dir>
+//   writeToPlugin    → drop into <plugin>/skills/<skill> and append to manifest
+//   writeNewPlugin   → scaffold a fresh plugin with .claude-plugin/plugin.json + skills/<skill>
+//
+// All three return the absolute path of the *staging* `.tmp` directory so the
+// orchestrator can run subsequent in-place edits (frontmatter, sidecar) before
+// committing with `fs.rename`. The ONLY exception is `writeToPlugin` which
+// also returns a separate `manifestTmpPath` so the orchestrator can rename
+// both `.tmp` paths in sequence (two-phase commit).
+//
+// Filtering: the recursive copy reuses the public `shouldSkipFromCommands`
+// helper from src/shared/copy-plugin-filtered.ts plus a root-level filter for
+// the vskill-internal sidecars `.vskill-meta.json` and `.vskill-source.json`
+// (matching the OWN-scope copy semantics in src/studio/lib/scope-transfer.ts).
+//
+// See spec.md AC-US1-03 / AC-US2-01..03 / AC-US3-01, plan.md §5–§6.
+// ---------------------------------------------------------------------------
+import { promises as fs, existsSync, readdirSync, statSync, copyFileSync, mkdirSync, rmSync, } from "node:fs";
+import { join, dirname, basename } from "node:path";
+import { shouldSkipFromCommands } from "../shared/copy-plugin-filtered.js";
+/**
+ * Recursive skill-dir copy with sidecar filtering at the root and
+ * shouldSkipFromCommands filtering at every depth. Mirrors the OWN-scope
+ * helper in src/studio/lib/scope-transfer.ts (lines 101–119) — that helper is
+ * not exported, so we re-implement the same behavior rather than duplicate
+ * its file.
+ */
+function copySkillDirFiltered(sourceDir, targetDir, relBase = "") {
+    mkdirSync(targetDir, { recursive: true });
+    let filesCopied = 0;
+    for (const entry of readdirSync(sourceDir)) {
+        // Filter vskill internal sidecars at the skill root only — same asymmetric
+        // contract as scope-transfer.ts: OWN scope is a single skill dir, so
+        // sidecars only ever exist at the root.
+        if (!relBase && (entry === ".vskill-meta.json" || entry === ".vskill-source.json"))
+            continue;
+        const relPath = relBase ? `${relBase}/${entry}` : entry;
+        const sourcePath = join(sourceDir, entry);
+        const st = statSync(sourcePath);
+        if (st.isDirectory()) {
+            filesCopied += copySkillDirFiltered(sourcePath, join(targetDir, entry), relPath);
+        }
+        else if (st.isFile() && !shouldSkipFromCommands(relPath)) {
+            copyFileSync(sourcePath, join(targetDir, entry));
+            filesCopied += 1;
+        }
+    }
+    return filesCopied;
+}
+/** Compute the `.tmp` sibling of a final destination path. */
+export function tmpSibling(finalPath) {
+    return `${finalPath}.tmp`;
+}
+/**
+ * Best-effort cleanup of a `.tmp` path. Mirrors the rollback shape used by
+ * src/commands/add.ts:rollbackInstall — swallows per-call errors so a partial
+ * filesystem state doesn't suppress the underlying diagnostic the orchestrator
+ * is about to surface to the user.
+ */
+export function bestEffortRm(path) {
+    try {
+        if (existsSync(path))
+            rmSync(path, { recursive: true, force: true });
+    }
+    catch {
+        // best-effort
+    }
+}
+/**
+ * Copy a source skill into a fresh standalone target dir, staged at
+ * `<finalDir>.tmp`. The orchestrator is responsible for the atomic
+ * rename and any pre-checks for collisions / `--force`.
+ */
+export async function writeStandalone(args) {
+    const stagingDir = tmpSibling(args.finalDir);
+    // Clear any leftover staging directory from a prior failed run before copying.
+    bestEffortRm(stagingDir);
+    await fs.mkdir(dirname(args.finalDir), { recursive: true });
+    const filesCopied = copySkillDirFiltered(args.sourceSkillDir, stagingDir);
+    return { stagingDir, filesCopied, finalDir: args.finalDir };
+}
+/**
+ * Copy a source skill into an existing user-owned plugin's skills/ directory
+ * AND stage an updated `plugin.json` at `<plugin.json>.tmp` so the
+ * orchestrator can rename both in sequence (two-phase commit).
+ *
+ * Pre-flight: detects malformed plugin.json BEFORE any copy is staged
+ * (AC-US2-03). Caller aborts on the thrown error; no skill files are written.
+ */
+export async function writeToPlugin(args) {
+    const manifestFinalPath = join(args.pluginRoot, ".claude-plugin", "plugin.json");
+    if (!existsSync(manifestFinalPath)) {
+        throw new Error(`target plugin manifest not found at ${manifestFinalPath} — pass a plugin root that contains .claude-plugin/plugin.json`);
+    }
+    // Pre-flight: parse the manifest BEFORE any copy is staged.
+    let manifestRaw;
+    try {
+        manifestRaw = await fs.readFile(manifestFinalPath, "utf-8");
+    }
+    catch (err) {
+        throw new Error(`failed to read plugin manifest: ${err.message}`);
+    }
+    let manifest;
+    try {
+        manifest = JSON.parse(manifestRaw);
+    }
+    catch (err) {
+        throw new Error(`target plugin manifest is malformed JSON (${err.message}) — refusing to clone into ${args.pluginRoot}`);
+    }
+    // The "register the new skill" step appends to a `skills` array (creating
+    // one if absent). Existing entries are preserved; duplicate entries are
+    // collapsed.
+    const skills = Array.isArray(manifest.skills) ? [...manifest.skills] : [];
+    if (!skills.includes(args.newSkillName))
+        skills.push(args.newSkillName);
+    const updatedManifest = { ...manifest, skills };
+    const finalDir = join(args.pluginRoot, "skills", args.newSkillName);
+    const stagingDir = tmpSibling(finalDir);
+    bestEffortRm(stagingDir);
+    await fs.mkdir(dirname(finalDir), { recursive: true });
+    let filesCopied = 0;
+    try {
+        filesCopied = copySkillDirFiltered(args.sourceSkillDir, stagingDir);
+    }
+    catch (err) {
+        bestEffortRm(stagingDir);
+        throw err;
+    }
+    // Stage the updated manifest. The orchestrator commits both renames.
+    const manifestTmpPath = `${manifestFinalPath}.tmp`;
+    try {
+        await fs.writeFile(manifestTmpPath, JSON.stringify(updatedManifest, null, 2) + "\n", "utf-8");
+    }
+    catch (err) {
+        bestEffortRm(stagingDir);
+        bestEffortRm(manifestTmpPath);
+        throw err;
+    }
+    return {
+        stagingDir,
+        filesCopied,
+        finalDir,
+        manifestTmpPath,
+        manifestFinalPath,
+    };
+}
+/**
+ * Scaffold a fresh new plugin at `<pluginRoot>` containing
+ * `.claude-plugin/plugin.json` (with the requested name) plus
+ * `skills/<skill>/` subtree containing the cloned skill.
+ *
+ * The whole plugin tree is staged at `<pluginRoot>.tmp` and atomically
+ * renamed by the caller — there is no two-phase commit because the manifest
+ * and the skill files live under a common root (one `rename` is enough).
+ */
+export async function writeNewPlugin(args) {
+    const stagingDir = tmpSibling(args.pluginRoot);
+    bestEffortRm(stagingDir);
+    // Build the new plugin's manifest.
+    await fs.mkdir(join(stagingDir, ".claude-plugin"), { recursive: true });
+    const manifest = {
+        name: args.pluginName,
+        description: args.description ?? `Plugin scaffolded by 'vskill clone' containing forked skills.`,
+        skills: [args.newSkillName],
+    };
+    if (args.author) {
+        manifest.author = { name: args.author };
+    }
+    await fs.writeFile(join(stagingDir, ".claude-plugin", "plugin.json"), JSON.stringify(manifest, null, 2) + "\n", "utf-8");
+    // Copy the skill into <stagingDir>/skills/<newSkillName>/.
+    const skillTargetDir = join(stagingDir, "skills", args.newSkillName);
+    let filesCopied = 0;
+    try {
+        filesCopied = copySkillDirFiltered(args.sourceSkillDir, skillTargetDir);
+    }
+    catch (err) {
+        bestEffortRm(stagingDir);
+        throw err;
+    }
+    return { stagingDir, filesCopied, finalDir: args.pluginRoot };
+}
+/**
+ * The `bareSkillName` helper extracts the unqualified skill name from a
+ * fully-qualified name like `anton/ado-mapper` → `ado-mapper`. Used by the
+ * orchestrator and by callers that need the directory-safe segment.
+ */
+export function bareSkillName(fullyQualified) {
+    const idx = fullyQualified.indexOf("/");
+    return idx >= 0 ? fullyQualified.slice(idx + 1) : fullyQualified;
+}
+/** Re-export for callers that want to validate basenames. */
+export { basename };
+//# sourceMappingURL=target-router.js.map

package/dist/clone/target-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"target-router.js","sourceRoot":"","sources":["../../src/clone/target-router.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,+BAA+B;AAC/B,8EAA8E;AAC9E,6EAA6E;AAC7E,uEAAuE;AACvE,wDAAwD;AACxD,EAAE;AACF,sDAAsD;AACtD,gFAAgF;AAChF,gGAAgG;AAChG,EAAE;AACF,8EAA8E;AAC9E,+EAA+E;AAC/E,2EAA2E;AAC3E,2EAA2E;AAC3E,oDAAoD;AACpD,EAAE;AACF,2EAA2E;AAC3E,8EAA8E;AAC9E,6EAA6E;AAC7E,+EAA+E;AAC/E,EAAE;AACF,oEAAoE;AACpE,8EAA8E;AAE9E,OAAO,EACL,QAAQ,IAAI,EAAE,EACd,UAAU,EACV,WAAW,EACX,QAAQ,EACR,YAAY,EACZ,SAAS,EACT,MAAM,GACP,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAEpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AAkB3E;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,SAAiB,EAAE,SAAiB,EAAE,OAAO,GAAG,EAAE;IAC9E,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1C,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,WAAW,CAAC,SAAS,CAAC,EAAE,CAAC;QAC3C,2EAA2E;QAC3E,qEAAqE;QACrE,wCAAwC;QACxC,IAAI,CAAC,OAAO,IAAI,CAAC,KAAK,KAAK,mBAAmB,IAAI,KAAK,KAAK,qBAAqB,CAAC;YAAE,SAAS;QAC7F,MAAM,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC;QACxD,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC1C,MAAM,EAAE,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;QAChC,IAAI,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;YACrB,WAAW,IAAI,oBAAoB,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC;QACnF,CAAC;aAAM,IAAI,EAAE,CAAC,MAAM,EAAE,IAAI,CAAC,sBAAsB,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3D,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC;YACjD,WAAW,IAAI,CAAC,CAAC;QACnB,CAAC;IACH,CAAC;IACD,OAAO,WAAW,CAAC;AACrB,CAAC;AAED,8DAA8D;AAC9D,MAAM,UAAU,UAAU,CAAC,SAAiB;IAC1C,OAAO,GAAG,SAAS,MAAM,CAAC;AAC5B,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,IAAI,CAAC;QACH,IAAI,UAAU,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAGrC;IACC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC7C,+EAA+E;IAC/E,YAAY,CAAC,UAAU,CAAC,CAAC;IACzB,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IAC1E,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;AAC9D,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAInC;IACC,MAAM,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,aAAa,CAAC,CAAC;IACjF,IAAI,CAAC,UAAU,CAAC,iBAAiB,CAAC,EAAE,CAAC;QACnC,MAAM,IAAI,KAAK,CACb,uCAAuC,iBAAiB,gEAAgE,CACzH,CAAC;IACJ,CAAC;IAED,4DAA4D;IAC5D,IAAI,WAAmB,CAAC;IACxB,IAAI,CAAC;QACH,WAAW,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC9D,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,mCAAoC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAC/E,CAAC;IACD,IAAI,QAAiC,CAAC;IACtC,IAAI,CAAC;QACH,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IACrC,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,6CAA8C,GAAa,CAAC,OAAO,8BAA8B,IAAI,CAAC,UAAU,EAAE,CACnH,CAAC;IACJ,CAAC;IAED,0EAA0E;IAC1E,wEAAwE;IACxE,aAAa;IACb,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,GAAI,QAAQ,CAAC,MAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACzF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,YAAY,CAAC;QAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACxE,MAAM,eAAe,GAAG,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEhD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACpE,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IACxC,YAAY,CAAC,UAAU,CAAC,CAAC;IAEzB,MAAM,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACvD,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACtE,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,qEAAqE;IACrE,MAAM,eAAe,GAAG,GAAG,iBAAiB,MAAM,CAAC;IACnD,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,SAAS,CAChB,eAAe,EACf,IAAI,CAAC,SAAS,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAC/C,OAAO,CACR,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,YAAY,CAAC,eAAe,CAAC,CAAC;QAC9B,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO;QACL,UAAU;QACV,WAAW;QACX,QAAQ;QACR,eAAe;QACf,iBAAiB;KAClB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IASpC;IACC,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAC/C,YAAY,CAAC,UAAU,CAAC,CAAC;IAEzB,mCAAmC;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,EAAE,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACxE,MAAM,QAAQ,GAA4B;QACxC,IAAI,EAAE,IAAI,CAAC,UAAU;QACrB,WAAW,EACT,IAAI,CAAC,WAAW,IAAI,+DAA+D;QACrF,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC;KAC5B,CAAC;IACF,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,QAAQ,CAAC,MAAM,GAAG,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;IAC1C,CAAC;IACD,MAAM,EAAE,CAAC,SAAS,CAChB,IAAI,CAAC,UAAU,EAAE,gBAAgB,EAAE,aAAa,CAAC,EACjD,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EACxC,OAAO,CACR,CAAC;IAEF,2DAA2D;IAC3D,MAAM,cAAc,GAAG,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACrE,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,WAAW,GAAG,oBAAoB,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;IAC1E,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,YAAY,CAAC,UAAU,CAAC,CAAC;QACzB,MAAM,GAAG,CAAC;IACZ,CAAC;IAED,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;AAChE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,aAAa,CAAC,cAAsB;IAClD,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IACxC,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC;AACnE,CAAC;AAED,6DAA6D;AAC7D,OAAO,EAAE,QAAQ,EAAE,CAAC"}

package/dist/clone/types.d.ts

@@ -0,0 +1,82 @@
+import type { Provenance } from "../studio/types.js";
+/** Where a skill lives on disk. */
+export type SkillSourceLocation = "project" | "personal" | "cache";
+/** A discovered source skill, with absolute path and parsed identity. */
+export interface SkillSource {
+    location: SkillSourceLocation;
+    /** Absolute path to the skill directory (the dir containing SKILL.md). */
+    skillDir: string;
+    /** Skill name as parsed from frontmatter (or directory basename if frontmatter lacks `name`). */
+    skillName: string;
+    /** Original namespace if discoverable (e.g., "sw" for plugin-cache sources). undefined for personal/project. */
+    namespace?: string;
+    /** Original version from frontmatter (or "0.0.0" if absent). */
+    version: string;
+    /** Plugin context — present only for cache-located skills. */
+    plugin?: {
+        pluginNamespace: string;
+        pluginName: string;
+        pluginVersion: string;
+        pluginRoot: string;
+    };
+    /** Existing provenance read from .vskill-meta.json (null if no sidecar). */
+    existingProvenance: Provenance | null;
+}
+/** Where the cloned skill should be written. */
+export type CloneTargetKind = "standalone" | "plugin" | "new-plugin";
+export interface CloneTarget {
+    kind: CloneTargetKind;
+    /** Absolute path to the final skill directory (where files end up after atomic rename). */
+    targetSkillDir: string;
+    /** For "plugin" kind: absolute path to the existing plugin's .claude-plugin/plugin.json. */
+    existingPluginManifestPath?: string;
+    /** For "new-plugin" kind: absolute path to the plugin root being scaffolded. */
+    newPluginRoot?: string;
+    /** For "new-plugin" kind: name to use in the new plugin manifest. */
+    newPluginName?: string;
+}
+export interface CloneOptions {
+    /** New namespace for the cloned skill (e.g., "anton"). Required. */
+    namespace: string;
+    /** New author name. Required. */
+    author: string;
+    /** When true, overwrite existing target without confirmation. */
+    force: boolean;
+    /** When true, after files land, scaffold a GitHub repo via gh. */
+    github: boolean;
+    /** When true, do not write any files — just print the planned actions. */
+    dryRun: boolean;
+}
+/** Result returned by the clone orchestrator. */
+export interface CloneResult {
+    source: SkillSource;
+    target: CloneTarget;
+    /** Final skill name written (e.g., "anton/ado-mapper"). */
+    finalSkillName: string;
+    /** Number of files copied. */
+    filesCopied: number;
+    /** Cross-skill references found in the body (informational, not auto-rewritten). */
+    referenceReport: ReferenceMatch[];
+    /** Self-name occurrences in prose (informational). */
+    selfNameMatches: ReferenceMatch[];
+    /** GitHub repo URL if --github was used and succeeded; null if skipped. */
+    githubRepoUrl: string | null;
+    /** Provenance written to the cloned skill. */
+    provenance: Provenance;
+}
+export interface ReferenceMatch {
+    /** Path of the file the match was found in (relative to skill root). */
+    file: string;
+    /** Line number (1-indexed). */
+    line: number;
+    /** The matched text (e.g., "sw:ado-mapper"). */
+    match: string;
+    /** Pattern category. */
+    kind: "backtick" | "skill-call" | "slash-command" | "self-name";
+}
+/** Fork provenance metadata written to the cloned skill's .vskill-meta.json. */
+export interface ForkProvenance {
+    source: string;
+    version: string;
+    clonedAt: string;
+}

package/dist/clone/types.js

@@ -0,0 +1,11 @@
+// ---------------------------------------------------------------------------
+// vskill clone — shared type contracts
+// ---------------------------------------------------------------------------
+// Source of truth for the `vskill clone` command. Consumed by skill-locator,
+// frontmatter rewriter, provenance-fork, target-router, github-scaffold, and
+// the orchestrator in src/commands/clone.ts.
+//
+// See .specweave/increments/0822-vskill-clone-skill-fork/spec.md and plan.md.
+// ---------------------------------------------------------------------------
+export {};
+//# sourceMappingURL=types.js.map

package/dist/clone/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/clone/types.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,uCAAuC;AACvC,8EAA8E;AAC9E,6EAA6E;AAC7E,6EAA6E;AAC7E,6CAA6C;AAC7C,EAAE;AACF,8EAA8E;AAC9E,8EAA8E"}