vskill 1.0.13 → 1.0.15

package/dist/commands/clone-prompts.js

@@ -0,0 +1,67 @@
+// ---------------------------------------------------------------------------
+// vskill clone — interactive prompts (TTY-only, readline-based)
+// ---------------------------------------------------------------------------
+// Mirrors the pattern used in src/commands/remove.ts (createInterface + a
+// promise-wrapped question). Falls back to non-interactive defaults when
+// stdin is not a TTY so the CLI is scriptable in CI.
+// ---------------------------------------------------------------------------
+import { createInterface } from "node:readline";
+export async function confirmPrompt(message, opts = {}) {
+    if (opts.yes)
+        return true;
+    const isTTY = opts.stdinIsTTY ?? process.stdin.isTTY;
+    if (!isTTY) {
+        process.stderr.write("refusing to prompt in non-TTY context — re-run with --yes to confirm\n");
+        return false;
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolveAns) => {
+        rl.question(`${message} (y/N): `, (answer) => {
+            rl.close();
+            resolveAns(answer.trim().toLowerCase() === "y");
+        });
+    });
+}
+export async function promptInput(message) {
+    if (!process.stdin.isTTY)
+        return "";
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolveAns) => {
+        rl.question(`${message} `, (answer) => {
+            rl.close();
+            resolveAns(answer.trim());
+        });
+    });
+}
+/**
+ * Prompt the user to choose one of N labelled options. Returns the chosen
+ * index. Re-prompts on bad input.
+ */
+export async function promptChoice(message, labels) {
+    if (!process.stdin.isTTY)
+        return 0;
+    console.log(message);
+    for (let i = 0; i < labels.length; i++) {
+        console.log(`  [${i + 1}] ${labels[i]}`);
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const askOnce = () => new Promise((resolveAns) => {
+        rl.question(`Pick 1-${labels.length}: `, (answer) => {
+            resolveAns(answer.trim());
+        });
+    });
+    try {
+        while (true) {
+            const raw = await askOnce();
+            const n = Number.parseInt(raw, 10);
+            if (Number.isInteger(n) && n >= 1 && n <= labels.length) {
+                return n - 1;
+            }
+            console.log(`  invalid — enter a number between 1 and ${labels.length}.`);
+        }
+    }
+    finally {
+        rl.close();
+    }
+}
+//# sourceMappingURL=clone-prompts.js.map

package/dist/commands/clone-prompts.js.map

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

package/dist/commands/clone.d.ts

@@ -0,0 +1,70 @@
+import { type RunGh } from "../clone/github-scaffold.js";
+import type { CloneResult, CloneTargetKind, ReferenceMatch, SkillSource, SkillSourceLocation } from "../clone/types.js";
+export interface CloneCommandOptions {
+    target?: CloneTargetKind;
+    path?: string;
+    plugin?: string;
+    pluginName?: string;
+    author?: string;
+    namespace?: string;
+    github?: boolean;
+    force?: boolean;
+    source?: SkillSourceLocation;
+    dryRun?: boolean;
+    /** Auto-confirm all prompts (--yes / -y). */
+    yes?: boolean;
+    /** Override home — used for tests. */
+    home?: string;
+    /** Override cwd — used for tests. */
+    cwd?: string;
+    /** Injectable `gh` adapter for tests. */
+    runGh?: RunGh;
+    /** When true, error messages are thrown instead of printed (used for tests / whole-plugin path). */
+    throwOnError?: boolean;
+}
+declare function slugify(name: string): string;
+/**
+ * Recursively scan a skill directory for cross-skill references and
+ * self-name occurrences across SKILL.md and any .md files in subdirectories
+ * (e.g., agents/*.md). Operates on the staged `.tmp` content so the report
+ * reflects what actually got copied.
+ */
+declare function scanCopiedSkill(stagingDir: string, oldSkillName: string): Promise<{
+    refs: ReferenceMatch[];
+    selfNames: ReferenceMatch[];
+}>;
+/**
+ * Validate the staged clone: SKILL.md must parse and any `agents/*.md`
+ * referenced by frontmatter must exist. Throws on any inconsistency.
+ */
+declare function validateStagedClone(stagingDir: string): Promise<void>;
+interface ResolvedCloneArgs {
+    source: SkillSource;
+    targetKind: CloneTargetKind;
+    newSkillBase: string;
+    newSkillFullName: string;
+    author: string;
+    namespace: string;
+    finalDir: string;
+    pluginRoot?: string;
+    pluginName?: string;
+}
+declare function resolveArgs(positionalSource: string, opts: CloneCommandOptions, homePath: string, cwdPath: string): Promise<ResolvedCloneArgs>;
+/**
+ * Run the clone pipeline. Returns the CloneResult on success. On failure,
+ * cleans up every staged `.tmp` path before propagating the error.
+ *
+ * The function is exported for use by the whole-plugin path (T-010) and unit
+ * tests; the CLI entry point is `cloneCommand` below.
+ */
+export declare function runCloneOnce(resolved: ResolvedCloneArgs, opts: CloneCommandOptions): Promise<CloneResult>;
+/** CLI entry point (Commander action). */
+export declare function cloneCommand(source: string | undefined, opts: CloneCommandOptions): Promise<void>;
+/**
+ * Whole-plugin clone path (T-010). Delegated to its own module is overkill —
+ * the orchestration is small and shares all the same primitives.
+ */
+declare function runWholePluginClone(pluginName: string, opts: CloneCommandOptions, homePath: string, cwdPath: string): Promise<void>;
+/** Re-exports for tests. */
+export { resolveArgs, validateStagedClone, scanCopiedSkill, slugify, runWholePluginClone };
+export type { ResolvedCloneArgs };