@cursor/bdk 0.2.8 → 0.2.10

package/dist/internal/install-cursor-skills.js

@@ -13,15 +13,6 @@
  * fails the package install. The monorepo source checkout is not a consumer
  * install, so `pnpm install` in everysphere does not overwrite `~/.cursor`.
  */
-var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
-    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
-    return new (P || (P = Promise))(function (resolve, reject) {
-        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
-        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
-        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
-        step((generator = generator.apply(thisArg, _arguments || [])).next());
-    });
-};
 import { access, chmod, cp, mkdir, readdir, readFile, rm, stat, writeFile } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
@@ -36,7 +27,7 @@ export const CURSOR_SKILLS_NAMESPACE = "bdk";
  */
 const LEGACY_CURSOR_SKILLS_NAMESPACES = ["agentsdk", "agentkit"];
 /** How long the `init` offer waits for an answer before skipping the install. */
-export const SKILL_PROMPT_TIMEOUT_MS = 45000;
+export const SKILL_PROMPT_TIMEOUT_MS = 45_000;
 /**
  * Override the resolved `~/.cursor/skills` directory (not the user home).
  * Used by the postinstall hook in tests and publish smoke.
@@ -45,11 +36,10 @@ export const CURSOR_JULY_SKILLS_HOME_ENV = "CURSOR_JULY_SKILLS_HOME";
 /** Set to `1` to skip the postinstall skill copy. */
 export const CURSOR_JULY_SKIP_SKILL_INSTALL_ENV = "CURSOR_JULY_SKIP_SKILL_INSTALL";
 export function cursorSkillsHome(home) {
-    var _a;
     if (home !== undefined) {
         return join(home.trim() === "" ? homedir() : home, ".cursor", "skills");
     }
-    const override = (_a = process.env[CURSOR_JULY_SKILLS_HOME_ENV]) === null || _a === void 0 ? void 0 : _a.trim();
+    const override = process.env[CURSOR_JULY_SKILLS_HOME_ENV]?.trim();
     if (override !== undefined && override !== "") {
         return override;
     }
@@ -79,70 +69,63 @@ export function skillInstallPath(skill, skillsHome = cursorSkillsHome()) {
  * Skills shipped next to the running package. Uses the frontmatter `name`
  * when present, otherwise `bdk-<dir>`.
  */
-export function listShippedPackageSkills() {
-    return __awaiter(this, arguments, void 0, function* (packageRoot = packageRootDir()) {
-        const skillsRoot = join(packageRoot, "skills");
-        let entries;
-        try {
-            entries = yield readdir(skillsRoot, { withFileTypes: true });
+export async function listShippedPackageSkills(packageRoot = packageRootDir()) {
+    const skillsRoot = join(packageRoot, "skills");
+    let entries;
+    try {
+        entries = await readdir(skillsRoot, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    const packageVersion = await readPackageVersion(packageRoot);
+    const skills = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory()) {
+            continue;
         }
-        catch (_a) {
-            return [];
+        const sourceDir = join(skillsRoot, entry.name);
+        const skillMd = join(sourceDir, "SKILL.md");
+        try {
+            await access(skillMd);
         }
-        const packageVersion = yield readPackageVersion(packageRoot);
-        const skills = [];
-        for (const entry of entries) {
-            if (!entry.isDirectory()) {
-                continue;
-            }
-            const sourceDir = join(skillsRoot, entry.name);
-            const skillMd = join(sourceDir, "SKILL.md");
-            try {
-                yield access(skillMd);
-            }
-            catch (_b) {
-                continue;
-            }
-            const raw = yield readFile(skillMd, "utf8");
-            const name = parseFrontmatter(raw).data.name || `${CURSOR_SKILLS_NAMESPACE}-${entry.name}`;
-            skills.push({ name, leafDir: entry.name, sourceDir, packageVersion });
+        catch {
+            continue;
         }
-        skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
-        return skills;
-    });
+        const raw = await readFile(skillMd, "utf8");
+        const name = parseFrontmatter(raw).data.name || `${CURSOR_SKILLS_NAMESPACE}-${entry.name}`;
+        skills.push({ name, leafDir: entry.name, sourceDir, packageVersion });
+    }
+    skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
+    return skills;
 }
 const PACKAGE_VERSION_PLACEHOLDER = "__CURSOR_JULY_VERSION__";
-function readPackageVersion(packageRoot) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const raw = yield readFile(join(packageRoot, "package.json"), "utf8");
-        const manifest = JSON.parse(raw);
-        if (typeof manifest.version !== "string" || manifest.version.trim() === "") {
-            throw new Error("The @cursor/bdk package must declare a version.");
-        }
-        return manifest.version;
-    });
+async function readPackageVersion(packageRoot) {
+    const raw = await readFile(join(packageRoot, "package.json"), "utf8");
+    const manifest = JSON.parse(raw);
+    if (typeof manifest.version !== "string" || manifest.version.trim() === "") {
+        throw new Error("The @cursor/bdk package must declare a version.");
+    }
+    return manifest.version;
 }
 /**
  * Skills that do not yet have a SKILL.md under ~/.cursor/skills/bdk/.
  * Install still overwrites every shipped skill when the user confirms — this
  * helper is for messaging (fresh install vs update).
  */
-export function findMissingCursorSkills(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const shipped = yield listShippedPackageSkills(options === null || options === void 0 ? void 0 : options.packageRoot);
-        const home = (_a = options === null || options === void 0 ? void 0 : options.skillsHome) !== null && _a !== void 0 ? _a : cursorSkillsHome();
-        const missing = [];
-        for (const skill of shipped) {
-            try {
-                yield access(join(skillInstallPath(skill, home), "SKILL.md"));
-            }
-            catch (_b) {
-                missing.push(skill);
-            }
+export async function findMissingCursorSkills(options) {
+    const shipped = await listShippedPackageSkills(options?.packageRoot);
+    const home = options?.skillsHome ?? cursorSkillsHome();
+    const missing = [];
+    for (const skill of shipped) {
+        try {
+            await access(join(skillInstallPath(skill, home), "SKILL.md"));
         }
-        return missing;
-    });
+        catch {
+            missing.push(skill);
+        }
+    }
+    return missing;
 }
 /**
  * Copy each skill directory into `skillsHome/bdk/<leafDir>/`.
@@ -151,99 +134,87 @@ export function findMissingCursorSkills(options) {
  * loads the body into context, and removes leaf dirs no longer shipped.
  * Also deletes leftover `skillsHome/agentsdk/` and `skillsHome/agentkit/`.
  */
-export function installCursorSkills(skills_1) {
-    return __awaiter(this, arguments, void 0, function* (skills, skillsHome = cursorSkillsHome()) {
-        const namespaceDir = bdkCursorSkillsDir(skillsHome);
-        yield mkdir(namespaceDir, { recursive: true });
-        const removed = yield orphanLeaves(namespaceDir, skills);
-        for (const leaf of removed) {
-            yield rm(join(namespaceDir, leaf), { recursive: true, force: true });
-        }
-        const installed = [];
-        for (const skill of skills) {
-            const target = skillInstallPath(skill, skillsHome);
-            yield cp(skill.sourceDir, target, { recursive: true, force: true });
-            // cp() preserves source modes, and installs can come from read-only
-            // stores (Bazel runfiles, pnpm's content-addressed store, nix). Make the
-            // copies writable so the SKILL.md rewrite below and the overwrite on the
-            // next upgrade both work.
-            yield makeTreeWritable(target);
-            const skillMdPath = join(target, "SKILL.md");
-            const raw = yield readFile(skillMdPath, "utf8");
-            const adjusted = prepareSkillMarkdownForCursorInstall(raw, skill.packageVersion);
-            if (adjusted !== raw) {
-                yield writeFile(skillMdPath, adjusted, "utf8");
-            }
-            installed.push(skill.leafDir);
+export async function installCursorSkills(skills, skillsHome = cursorSkillsHome()) {
+    const namespaceDir = bdkCursorSkillsDir(skillsHome);
+    await mkdir(namespaceDir, { recursive: true });
+    const removed = await orphanLeaves(namespaceDir, skills);
+    for (const leaf of removed) {
+        await rm(join(namespaceDir, leaf), { recursive: true, force: true });
+    }
+    const installed = [];
+    for (const skill of skills) {
+        const target = skillInstallPath(skill, skillsHome);
+        await cp(skill.sourceDir, target, { recursive: true, force: true });
+        // cp() preserves source modes, and installs can come from read-only
+        // stores (Bazel runfiles, pnpm's content-addressed store, nix). Make the
+        // copies writable so the SKILL.md rewrite below and the overwrite on the
+        // next upgrade both work.
+        await makeTreeWritable(target);
+        const skillMdPath = join(target, "SKILL.md");
+        const raw = await readFile(skillMdPath, "utf8");
+        const adjusted = prepareSkillMarkdownForCursorInstall(raw, skill.packageVersion);
+        if (adjusted !== raw) {
+            await writeFile(skillMdPath, adjusted, "utf8");
         }
-        const removedLegacyDirs = yield removeLegacyCursorSkillsNamespaces(skillsHome);
-        return { installed, removed, removedLegacyDirs };
-    });
+        installed.push(skill.leafDir);
+    }
+    const removedLegacyDirs = await removeLegacyCursorSkillsNamespaces(skillsHome);
+    return { installed, removed, removedLegacyDirs };
 }
-function makeTreeWritable(root) {
-    return __awaiter(this, void 0, void 0, function* () {
-        yield addOwnerWrite(root);
-        const entries = yield readdir(root, { withFileTypes: true });
-        for (const entry of entries) {
-            const child = join(root, entry.name);
-            if (entry.isDirectory()) {
-                yield makeTreeWritable(child);
-            }
-            else {
-                yield addOwnerWrite(child);
-            }
+async function makeTreeWritable(root) {
+    await addOwnerWrite(root);
+    const entries = await readdir(root, { withFileTypes: true });
+    for (const entry of entries) {
+        const child = join(root, entry.name);
+        if (entry.isDirectory()) {
+            await makeTreeWritable(child);
         }
-    });
+        else {
+            await addOwnerWrite(child);
+        }
+    }
 }
 /** Add owner-write, preserving every other mode bit (e.g. exec on scripts). */
-function addOwnerWrite(path) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const mode = (yield stat(path)).mode & 0o7777;
-        if ((mode & 0o200) === 0) {
-            yield chmod(path, mode | 0o200);
-        }
-    });
+async function addOwnerWrite(path) {
+    const mode = (await stat(path)).mode & 0o7777;
+    if ((mode & 0o200) === 0) {
+        await chmod(path, mode | 0o200);
+    }
 }
 /** Installed leaf dirs the package no longer ships. Installing deletes these. */
-function orphanLeaves(namespaceDir, skills) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const shipped = new Set(skills.map(skill => skill.leafDir));
-        let entries;
-        try {
-            entries = yield readdir(namespaceDir, { withFileTypes: true });
-        }
-        catch (_a) {
-            return [];
-        }
-        return entries
-            .filter(entry => entry.isDirectory() && !shipped.has(entry.name))
-            .map(entry => entry.name);
-    });
+async function orphanLeaves(namespaceDir, skills) {
+    const shipped = new Set(skills.map(skill => skill.leafDir));
+    let entries;
+    try {
+        entries = await readdir(namespaceDir, { withFileTypes: true });
+    }
+    catch {
+        return [];
+    }
+    return entries
+        .filter(entry => entry.isDirectory() && !shipped.has(entry.name))
+        .map(entry => entry.name);
 }
 /** Drop leftover earlier install folders so stale skill ids are not discovered. */
-function removeLegacyCursorSkillsNamespaces(skillsHome) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const present = yield existingLegacyCursorSkillsDirs(skillsHome);
-        for (const dir of present) {
-            yield rm(dir, { recursive: true, force: true });
-        }
-        return present;
-    });
+async function removeLegacyCursorSkillsNamespaces(skillsHome) {
+    const present = await existingLegacyCursorSkillsDirs(skillsHome);
+    for (const dir of present) {
+        await rm(dir, { recursive: true, force: true });
+    }
+    return present;
 }
-function existingLegacyCursorSkillsDirs(skillsHome) {
-    return __awaiter(this, void 0, void 0, function* () {
-        const present = [];
-        for (const dir of legacyCursorSkillsDirs(skillsHome)) {
-            try {
-                yield stat(dir);
-                present.push(dir);
-            }
-            catch (_a) {
-                continue;
-            }
+async function existingLegacyCursorSkillsDirs(skillsHome) {
+    const present = [];
+    for (const dir of legacyCursorSkillsDirs(skillsHome)) {
+        try {
+            await stat(dir);
+            present.push(dir);
         }
-        return present;
-    });
+        catch {
+            continue;
+        }
+    }
+    return present;
 }
 /**
  * Drop monorepo `paths` globs, set `alwaysApply: true` so Cursor injects the
@@ -251,12 +222,11 @@ function existingLegacyCursorSkillsDirs(skillsHome) {
  * fix package doc links for ~/.cursor installs.
  */
 export function prepareSkillMarkdownForCursorInstall(content, packageVersion) {
-    var _a;
     const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
     if (match === null) {
         return content;
     }
-    const frontmatter = withAlwaysApply(stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : ""));
+    const frontmatter = withAlwaysApply(stripPathsFromFrontmatter(match[1] ?? ""));
     const body = content.slice(match[0].length);
     const adjustedBody = body.replace(/\[`docs\/([^`]+)`\]\(\.\.\/\.\.\/docs\/[^)]+\)/g, "docs/$1 in the @cursor/bdk package");
     if (adjustedBody.includes(PACKAGE_VERSION_PLACEHOLDER) &&
@@ -269,14 +239,13 @@ export function prepareSkillMarkdownForCursorInstall(content, packageVersion) {
     return `---\n${frontmatter.trimEnd()}\n---${versionBoundBody}`;
 }
 function stripPathsFromFrontmatter(frontmatter) {
-    var _a, _b;
     const lines = frontmatter.split(/\r?\n/);
     const out = [];
     for (let i = 0; i < lines.length; i++) {
-        const line = (_a = lines[i]) !== null && _a !== void 0 ? _a : "";
+        const line = lines[i] ?? "";
         if (line.trimStart().startsWith("paths:")) {
             i++;
-            while (i < lines.length && /^[ \t]*-/.test((_b = lines[i]) !== null && _b !== void 0 ? _b : "")) {
+            while (i < lines.length && /^[ \t]*-/.test(lines[i] ?? "")) {
                 i++;
             }
             i--;
@@ -286,8 +255,14 @@ function stripPathsFromFrontmatter(frontmatter) {
     }
     return out.join("\n");
 }
-/** Cursor loads `alwaysApply: true` skills as global rules, not catalog rows. */
+/**
+ * Cursor loads `alwaysApply: true` skills as global rules, not catalog rows.
+ * A situational skill opts out with an explicit `alwaysApply: false`.
+ */
 function withAlwaysApply(frontmatter) {
+    if (/^\s*alwaysApply\s*:\s*false\s*$/m.test(frontmatter)) {
+        return frontmatter;
+    }
     const without = frontmatter
         .split(/\r?\n/)
         .filter(line => !/^\s*alwaysApply\s*:/.test(line))
@@ -299,31 +274,28 @@ function withAlwaysApply(frontmatter) {
     return `${without}\nalwaysApply: true`;
 }
 /** What an install would do, for the offer and for `install-skills`. */
-export function planSkillInstall(options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const skillsHome = (_a = options === null || options === void 0 ? void 0 : options.skillsHome) !== null && _a !== void 0 ? _a : cursorSkillsHome();
-        const directory = bdkCursorSkillsDir(skillsHome);
-        const shipped = yield listShippedPackageSkills(options === null || options === void 0 ? void 0 : options.packageRoot);
-        const present = yield Promise.all(shipped.map((skill) => __awaiter(this, void 0, void 0, function* () {
-            try {
-                yield access(join(skillInstallPath(skill, skillsHome), "SKILL.md"));
-                return true;
-            }
-            catch (_a) {
-                return false;
-            }
-        })));
-        return {
-            shipped,
-            skillsHome,
-            directory,
-            leaves: shipped.map(skill => skill.leafDir),
-            firstInstall: present.every(isPresent => !isPresent),
-            orphans: yield orphanLeaves(directory, shipped),
-            legacyDirs: yield existingLegacyCursorSkillsDirs(skillsHome),
-        };
-    });
+export async function planSkillInstall(options) {
+    const skillsHome = options?.skillsHome ?? cursorSkillsHome();
+    const directory = bdkCursorSkillsDir(skillsHome);
+    const shipped = await listShippedPackageSkills(options?.packageRoot);
+    const present = await Promise.all(shipped.map(async (skill) => {
+        try {
+            await access(join(skillInstallPath(skill, skillsHome), "SKILL.md"));
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }));
+    return {
+        shipped,
+        skillsHome,
+        directory,
+        leaves: shipped.map(skill => skill.leafDir),
+        firstInstall: present.every(isPresent => !isPresent),
+        orphans: await orphanLeaves(directory, shipped),
+        legacyDirs: await existingLegacyCursorSkillsDirs(skillsHome),
+    };
 }
 /** `Installed 9 BDK skills`, what it dropped, and where it went. */
 export function formatSkillInstall(plan, result) {
@@ -345,39 +317,36 @@ export function formatSkillInstall(plan, result) {
  * the package install. No-op in the monorepo source tree and when
  * `CURSOR_JULY_SKIP_SKILL_INSTALL=1`.
  */
-export function syncCursorSkillsOnPackageInstall() {
-    return __awaiter(this, arguments, void 0, function* (options = {}) {
-        var _a, _b, _c, _d;
-        try {
-            const env = (_a = options.env) !== null && _a !== void 0 ? _a : process.env;
-            if (env[CURSOR_JULY_SKIP_SKILL_INSTALL_ENV] === "1") {
-                return { status: "skipped", reason: "opt-out" };
-            }
-            const packageRoot = (_b = options.packageRoot) !== null && _b !== void 0 ? _b : packageRootDir();
-            const consumer = (_c = options.consumer) !== null && _c !== void 0 ? _c : isConsumerPackageInstall(packageRoot);
-            if (!consumer) {
-                return { status: "skipped", reason: "not-consumer" };
-            }
-            const plan = yield planSkillInstall({
-                packageRoot,
-                skillsHome: options.skillsHome,
-            });
-            if (plan.shipped.length === 0) {
-                return { status: "skipped", reason: "no-skills" };
-            }
-            const result = yield installCursorSkills(plan.shipped, plan.skillsHome);
-            const out = (_d = options.out) !== null && _d !== void 0 ? _d : (text => process.stderr.write(text));
-            out(formatSkillInstall(plan, result));
-            return {
-                status: "installed",
-                installed: result.installed,
-                removed: result.removed,
-            };
+export async function syncCursorSkillsOnPackageInstall(options = {}) {
+    try {
+        const env = options.env ?? process.env;
+        if (env[CURSOR_JULY_SKIP_SKILL_INSTALL_ENV] === "1") {
+            return { status: "skipped", reason: "opt-out" };
         }
-        catch (_e) {
-            return { status: "skipped", reason: "error" };
+        const packageRoot = options.packageRoot ?? packageRootDir();
+        const consumer = options.consumer ?? isConsumerPackageInstall(packageRoot);
+        if (!consumer) {
+            return { status: "skipped", reason: "not-consumer" };
         }
-    });
+        const plan = await planSkillInstall({
+            packageRoot,
+            skillsHome: options.skillsHome,
+        });
+        if (plan.shipped.length === 0) {
+            return { status: "skipped", reason: "no-skills" };
+        }
+        const result = await installCursorSkills(plan.shipped, plan.skillsHome);
+        const out = options.out ?? (text => process.stderr.write(text));
+        out(formatSkillInstall(plan, result));
+        return {
+            status: "installed",
+            installed: result.installed,
+            removed: result.removed,
+        };
+    }
+    catch {
+        return { status: "skipped", reason: "error" };
+    }
 }
 /**
  * On a TTY, offer to install/update every shipped package skill into
@@ -385,82 +354,77 @@ export function syncCursorSkillsOnPackageInstall() {
  * or the package ships no skills. An unanswered prompt skips the install
  * rather than blocking the caller — see `SKILL_PROMPT_TIMEOUT_MS`.
  */
-export function offerInstallCursorSkills() {
-    return __awaiter(this, arguments, void 0, function* (options = {}) {
-        var _a, _b, _c;
-        const out = (_a = options.out) !== null && _a !== void 0 ? _a : (text => process.stdout.write(text));
-        const interactive = (_b = options.interactive) !== null && _b !== void 0 ? _b : (process.stdin.isTTY === true && process.stdout.isTTY === true);
-        if (!interactive) {
-            return { installed: [], skipped: true };
-        }
-        const plan = yield planSkillInstall({
-            packageRoot: options.packageRoot,
-            skillsHome: options.skillsHome,
-        });
-        if (plan.shipped.length === 0) {
-            return { installed: [], skipped: true };
-        }
-        const noun = plan.shipped.length === 1 ? "skill" : "skills";
-        const verb = plan.firstInstall ? "Install" : "Update";
-        const c = stdoutPalette();
-        out(`${verb} ${plan.shipped.length} BDK ${noun} in ${plan.directory}?\n`);
-        out(c.dim(`  ${plan.leaves.join(", ")}\n`));
-        if (!plan.firstInstall) {
-            out(c.dim("  (overwrites existing copies with the package version)\n"));
-        }
-        if (plan.orphans.length > 0) {
-            out(c.dim(`  (deletes ${plan.orphans.join(", ")})\n`));
-        }
-        for (const dir of plan.legacyDirs) {
-            out(c.dim(`  (deletes leftover ${dir})\n`));
-        }
-        const confirm = (_c = options.confirm) !== null && _c !== void 0 ? _c : (q => promptYesNo(q, {
+export async function offerInstallCursorSkills(options = {}) {
+    const out = options.out ?? (text => process.stdout.write(text));
+    const interactive = options.interactive ?? (process.stdin.isTTY === true && process.stdout.isTTY === true);
+    if (!interactive) {
+        return { installed: [], skipped: true };
+    }
+    const plan = await planSkillInstall({
+        packageRoot: options.packageRoot,
+        skillsHome: options.skillsHome,
+    });
+    if (plan.shipped.length === 0) {
+        return { installed: [], skipped: true };
+    }
+    const noun = plan.shipped.length === 1 ? "skill" : "skills";
+    const verb = plan.firstInstall ? "Install" : "Update";
+    const c = stdoutPalette();
+    out(`${verb} ${plan.shipped.length} BDK ${noun} in ${plan.directory}?\n`);
+    out(c.dim(`  ${plan.leaves.join(", ")}\n`));
+    if (!plan.firstInstall) {
+        out(c.dim("  (overwrites existing copies with the package version)\n"));
+    }
+    if (plan.orphans.length > 0) {
+        out(c.dim(`  (deletes ${plan.orphans.join(", ")})\n`));
+    }
+    for (const dir of plan.legacyDirs) {
+        out(c.dim(`  (deletes leftover ${dir})\n`));
+    }
+    const confirm = options.confirm ??
+        (q => promptYesNo(q, {
             defaultYes: true,
             out,
             timeoutMs: SKILL_PROMPT_TIMEOUT_MS,
         }));
-        const accepted = yield confirm(`${verb} now?`);
-        if (accepted !== true) {
-            // `undefined` is the prompt timing out or stdin closing; both mean nobody
-            // said yes, so do not claim a duration neither case is guaranteed to have.
-            const why = accepted === undefined ? "No answer — skipped the skill install." : "Skipped skill install.";
-            out(c.dim(`${why}\nInstall later: ${CLI_COMMAND_NAME} install-skills (${plan.directory})\n\n`));
-            return { installed: [], skipped: true };
-        }
-        const result = yield installCursorSkills(plan.shipped, plan.skillsHome);
-        out(`${formatSkillInstall(plan, result)}\n`);
-        return { installed: result.installed, skipped: false };
-    });
+    const accepted = await confirm(`${verb} now?`);
+    if (accepted !== true) {
+        // `undefined` is the prompt timing out or stdin closing; both mean nobody
+        // said yes, so do not claim a duration neither case is guaranteed to have.
+        const why = accepted === undefined ? "No answer — skipped the skill install." : "Skipped skill install.";
+        out(c.dim(`${why}\nInstall later: ${CLI_COMMAND_NAME} install-skills (${plan.directory})\n\n`));
+        return { installed: [], skipped: true };
+    }
+    const result = await installCursorSkills(plan.shipped, plan.skillsHome);
+    out(`${formatSkillInstall(plan, result)}\n`);
+    return { installed: result.installed, skipped: false };
 }
 /**
  * Ask a yes/no question. Resolves `undefined` when the answer never comes —
  * the prompt timed out, or stdin closed on an empty line.
  */
-export function promptYesNo(question, options) {
-    return __awaiter(this, void 0, void 0, function* () {
-        var _a;
-        const hint = options.defaultYes ? "Y/n" : "y/N";
-        const input = (_a = options.input) !== null && _a !== void 0 ? _a : process.stdin;
-        options.out(`${question} [${hint}] `);
-        input.resume();
-        const line = yield readOneLine(input, options.timeoutMs);
-        input.pause();
-        if (line === undefined) {
-            options.out("\n");
-            return undefined;
-        }
-        if (line.trim() === "") {
-            return options.defaultYes;
-        }
-        const answer = line.trim().toLowerCase();
-        if (answer === "y" || answer === "yes") {
-            return true;
-        }
-        if (answer === "n" || answer === "no") {
-            return false;
-        }
+export async function promptYesNo(question, options) {
+    const hint = options.defaultYes ? "Y/n" : "y/N";
+    const input = options.input ?? process.stdin;
+    options.out(`${question} [${hint}] `);
+    input.resume();
+    const line = await readOneLine(input, options.timeoutMs);
+    input.pause();
+    if (line === undefined) {
+        options.out("\n");
+        return undefined;
+    }
+    if (line.trim() === "") {
         return options.defaultYes;
-    });
+    }
+    const answer = line.trim().toLowerCase();
+    if (answer === "y" || answer === "yes") {
+        return true;
+    }
+    if (answer === "n" || answer === "no") {
+        return false;
+    }
+    return options.defaultYes;
 }
 /** The line, or `undefined` when the stream ends or the clock runs out first. */
 function readOneLine(stream, timeoutMs) {