@cursor/july 0.1.18 → 0.1.19

package/dist/internal/install-cursor-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,uBAAuB,aAAa,CAAC;AAElD,MAAM,WAAW,YAAY;IAC3B,uDAAuD;IACvD,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,OAAO,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,gBAAgB,CAC9B,IAAI,GAAE,MAAsC,GAC3C,MAAM,CAGR;AAED,wEAAwE;AACxE,wBAAgB,uBAAuB,CACrC,UAAU,GAAE,MAA2B,GACtC,MAAM,CAER;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,SAAS,CAAC,EACpC,UAAU,GAAE,MAA2B,GACtC,MAAM,CAER;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAC5C,WAAW,GAAE,MAAyB,GACrC,OAAO,CAAC,YAAY,EAAE,CAAC,CA2BzB;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,CAAC,OAAO,CAAC,EAAE;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAY1B;AAED;;;;GAIG;AACH,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,SAAS,YAAY,EAAE,EAC/B,UAAU,GAAE,MAA2B,GACtC,OAAO,CAAC,MAAM,EAAE,CAAC,CAiCnB;AAED,oFAAoF;AACpF,wBAAgB,oCAAoC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAY5E;AAoBD,MAAM,WAAW,+BAA+B;IAC9C,4CAA4C;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iCAAiC;IACjC,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,OAAO,GAAE,+BAAoC,GAC5C,OAAO,CAAC;IAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA+CpD"}
+{"version":3,"file":"install-cursor-skills.d.ts","sourceRoot":"","sources":["../../src/internal/install-cursor-skills.ts"],"names":[],"mappings":"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"}

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

@@ -18,12 +18,14 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { access, cp, mkdir, readdir, readFile, rm, writeFile, } from "node:fs/promises";
 import { homedir } from "node:os";
 import { join } from "node:path";
-import { packageRootDir } from "./distribution.js";
+import { CLI_COMMAND_NAME, packageRootDir } from "./distribution.js";
 import { stdoutPalette } from "./terminal-style.js";
 /** Monorepo-only skill; excluded from the published package. */
 const SKIP_SKILL_DIRS = new Set(["operate"]);
 /** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
 export const CURSOR_SKILLS_NAMESPACE = "agentkit";
+/** How long the `init` offer waits for an answer before skipping the install. */
+export const SKILL_PROMPT_TIMEOUT_MS = 45000;
 export function cursorSkillsHome(home) {
     var _a;
     if (home === void 0) { home = (_a = process.env.HOME) !== null && _a !== void 0 ? _a : homedir(); }
@@ -105,21 +107,9 @@ export function installCursorSkills(skills_1) {
     return __awaiter(this, arguments, void 0, function* (skills, skillsHome = cursorSkillsHome()) {
         const namespaceDir = agentkitCursorSkillsDir(skillsHome);
         yield mkdir(namespaceDir, { recursive: true });
-        const shippedLeaves = new Set(skills.map((skill) => skill.leafDir));
-        let existingLeaves = [];
-        try {
-            const entries = yield readdir(namespaceDir, { withFileTypes: true });
-            existingLeaves = entries
-                .filter((entry) => entry.isDirectory())
-                .map((entry) => entry.name);
-        }
-        catch (_a) {
-            existingLeaves = [];
-        }
-        for (const leaf of existingLeaves) {
-            if (!shippedLeaves.has(leaf)) {
-                yield rm(join(namespaceDir, leaf), { recursive: true, force: 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) {
@@ -133,7 +123,23 @@ export function installCursorSkills(skills_1) {
             }
             installed.push(skill.leafDir);
         }
-        return installed;
+        return { installed, removed };
+    });
+}
+/** 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);
     });
 }
 /** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
@@ -166,48 +172,88 @@ function stripPathsFromFrontmatter(frontmatter) {
     }
     return out.join("\n");
 }
+/** 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 = agentkitCursorSkillsDir(skillsHome);
+        const shipped = yield listShippedPackageSkills(options === null || options === void 0 ? void 0 : options.packageRoot);
+        const missing = yield findMissingCursorSkills({
+            packageRoot: options === null || options === void 0 ? void 0 : options.packageRoot,
+            skillsHome,
+        });
+        return {
+            shipped,
+            skillsHome,
+            directory,
+            leaves: shipped.map((skill) => skill.leafDir),
+            firstInstall: missing.length === shipped.length,
+            orphans: yield orphanLeaves(directory, shipped),
+        };
+    });
+}
+/** `Installed 9 agentkit skills`, what it dropped, and where it went. */
+export function formatSkillInstall(plan, result) {
+    const noun = result.installed.length === 1 ? "skill" : "skills";
+    const verb = plan.firstInstall ? "Installed" : "Updated";
+    const lines = [`${verb} ${result.installed.length} agentkit ${noun}`];
+    if (result.removed.length > 0) {
+        lines.push(`  removed:  ${result.removed.join(", ")}`);
+    }
+    lines.push(`  location: ${plan.directory}`);
+    return `${lines.join("\n")}\n`;
+}
 /**
  * On a TTY, offer to install/update every shipped package skill into
  * ~/.cursor/skills/agentkit (always overwriting). No-op when non-interactive
- * or the package ships no skills.
+ * 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, _d;
+        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);
-        const shipped = yield listShippedPackageSkills(options.packageRoot);
-        if (shipped.length === 0) {
+        if (!interactive) {
             return { installed: [], skipped: true };
         }
-        const home = (_c = options.skillsHome) !== null && _c !== void 0 ? _c : cursorSkillsHome();
-        const targetDir = agentkitCursorSkillsDir(home);
-        const missing = yield findMissingCursorSkills({
+        const plan = yield planSkillInstall({
             packageRoot: options.packageRoot,
-            skillsHome: home,
+            skillsHome: options.skillsHome,
         });
-        const names = shipped.map((skill) => skill.leafDir).join(", ");
-        const noun = shipped.length === 1 ? "skill" : "skills";
-        const verb = missing.length === shipped.length ? "Install" : "Update";
-        const question = `${verb} ${shipped.length} agentkit ${noun} in ${targetDir}?`;
-        if (!interactive) {
+        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(`${question}\n`);
-        out(c.dim(`  ${names}\n`));
-        if (missing.length < shipped.length) {
+        out(`${verb} ${plan.shipped.length} agentkit ${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"));
         }
-        const confirm = (_d = options.confirm) !== null && _d !== void 0 ? _d : ((q) => promptYesNo(q, { defaultYes: true, out }));
-        const accepted = yield confirm(missing.length === shipped.length ? "Install now?" : "Update now?");
-        if (!accepted) {
-            out(c.dim("Skipped skill install.\n\n"));
+        if (plan.orphans.length > 0) {
+            out(c.dim(`  (deletes ${plan.orphans.join(", ")})\n`));
+        }
+        const confirm = (_c = options.confirm) !== null && _c !== void 0 ? _c : ((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 installed = yield installCursorSkills(shipped, home);
-        out(`${verb === "Install" ? "Installed" : "Updated"} ${installed.length} ${noun} in ${targetDir}\n\n`);
-        return { installed, skipped: false };
+        const result = yield installCursorSkills(plan.shipped, plan.skillsHome);
+        out(`${formatSkillInstall(plan, result)}\n`);
+        return { installed: result.installed, skipped: false };
     });
 }
 function parseSkillName(skillMd) {
@@ -228,14 +274,24 @@ function parseSkillName(skillMd) {
     // Strip optional quotes around the YAML scalar.
     return raw.replace(/^["']|["']$/g, "");
 }
-function promptYesNo(question, options) {
+/**
+ * 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}] `);
-        process.stdin.resume();
-        const line = yield readOneLine(process.stdin);
-        process.stdin.pause();
-        if (line === undefined || line.trim() === "") {
+        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();
@@ -248,9 +304,11 @@ function promptYesNo(question, options) {
         return options.defaultYes;
     });
 }
-function readOneLine(stream) {
+/** The line, or `undefined` when the stream ends or the clock runs out first. */
+function readOneLine(stream, timeoutMs) {
     return new Promise((resolve) => {
         let buffer = "";
+        let timer;
         const onData = (chunk) => {
             buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
             const newline = buffer.indexOf("\n");
@@ -260,15 +318,25 @@ function readOneLine(stream) {
             cleanup();
             resolve(buffer.slice(0, newline).replace(/\r$/, ""));
         };
-        const onEnd = () => {
+        // EOF and the timeout both land here. A tty holds a half-typed line until
+        // Enter, so a non-empty buffer only ever happens on piped input.
+        const giveUp = () => {
             cleanup();
             resolve(buffer === "" ? undefined : buffer.replace(/\r$/, ""));
         };
         const cleanup = () => {
+            if (timer !== undefined) {
+                clearTimeout(timer);
+            }
             stream.off("data", onData);
-            stream.off("end", onEnd);
+            stream.off("end", giveUp);
         };
         stream.on("data", onData);
-        stream.on("end", onEnd);
+        stream.on("end", giveUp);
+        if (timeoutMs !== undefined && timeoutMs > 0) {
+            timer = setTimeout(giveUp, timeoutMs);
+            // Never keep the process alive purely to wait for an answer.
+            timer.unref();
+        }
     });
 }