@cursor/july 0.1.1 → 0.1.3

package/dist/internal/init-project.js

@@ -10,9 +10,11 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { spawn } from "node:child_process";
 import { mkdir, writeFile } from "node:fs/promises";
-import { basename, dirname, join, resolve } from "node:path";
+import { basename, dirname, join, relative, resolve } from "node:path";
 import { CLI_COMMAND_NAME, PACKAGE_NAME, packageVersion, } from "./distribution.js";
+import { makePalette, stdoutPalette, } from "./terminal-style.js";
 const DEFAULT_MODEL = {
     id: "grok-4.5",
     params: [
@@ -20,6 +22,22 @@ const DEFAULT_MODEL = {
         { id: "fast", value: "true" },
     ],
 };
+/**
+ * Empty capability folders the scaffold creates (each gets a `.gitkeep`).
+ * `agent/tools/` is omitted — the demo `echo.ts` already keeps it in git.
+ */
+const SCAFFOLD_EMPTY_DIRS = [
+    "agent/skills",
+    "agent/mcp-connections",
+    "agent/subagents",
+    "agent/channels",
+    "agent/hooks",
+    "agent/ab",
+    "agent/schedules",
+    "agent/sandbox/workspace",
+    "agent/lib",
+    "evals",
+];
 export function initProject(options) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a, _b;
@@ -28,36 +46,67 @@ export function initProject(options) {
         const model = formatModelLiteral((_b = options.model) !== null && _b !== void 0 ? _b : DEFAULT_MODEL);
         const agentDir = join(rootDir, "agent");
         yield mkdir(agentDir, { recursive: true });
-        const written = [];
+        const files = [];
         const write = (rel, contents) => __awaiter(this, void 0, void 0, function* () {
             const abs = join(rootDir, rel);
             yield mkdir(dirname(abs), { recursive: true });
-            yield writeFile(abs, contents, { flag: "wx" });
-            written.push(rel);
+            try {
+                yield writeFile(abs, contents, { flag: "wx" });
+                files.push({ path: rel, action: "create" });
+            }
+            catch (error) {
+                if (isEexist(error)) {
+                    // Rails generators leave existing files alone (`exist`).
+                    files.push({ path: rel, action: "exist" });
+                    return;
+                }
+                throw error;
+            }
         });
-        try {
-            yield write("package.json", `${JSON.stringify({
-                name,
-                private: true,
-                type: "module",
-                description: `agent project: ${name}`,
-                dependencies: {
-                    [PACKAGE_NAME]: `^${packageVersion()}`,
-                    zod: "^3.25.0",
-                },
-            }, null, 2)}\n`);
-            yield write("agent/agent.ts", `import { defineAgent } from "${PACKAGE_NAME}";
+        yield write("package.json", `${JSON.stringify({
+            name,
+            private: true,
+            type: "module",
+            description: `agent project: ${name}`,
+            scripts: {
+                check: "tsc --noEmit",
+            },
+            dependencies: {
+                [PACKAGE_NAME]: `^${packageVersion()}`,
+                zod: "^3.25.0",
+            },
+            devDependencies: {
+                "@types/node": "^22.14.0",
+                typescript: "^5.8.0",
+            },
+        }, null, 2)}\n`);
+        yield write("tsconfig.json", `{
+  // Type-checking only (npm run check): the framework runs agent/ code
+  // directly through tsx, so nothing is compiled.
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "types": ["node"]
+  },
+  "include": ["agent/**/*", "evals/**/*"]
+}
+`);
+        yield write("agent/agent.ts", `import { defineAgent } from "${PACKAGE_NAME}";
 
 export default defineAgent({
   model: ${model},
 });
 `);
-            yield write("agent/instructions.md", `# ${name}
+        yield write("agent/instructions.md", `# ${name}
 
 You are a helpful agent. Prefer tools when they fit the request.
 Keep answers concise unless the user asks for detail.
 `);
-            yield write("agent/tools/echo.ts", `import { defineTool } from "${PACKAGE_NAME}/tools";
+        yield write("agent/tools/echo.ts", `import { defineTool } from "${PACKAGE_NAME}/tools";
 import { z } from "zod";
 
 export default defineTool({
@@ -68,17 +117,68 @@ export default defineTool({
   },
 });
 `);
+        for (const dir of SCAFFOLD_EMPTY_DIRS) {
+            yield write(`${dir}/.gitkeep`, "");
         }
-        catch (error) {
-            if (error !== null &&
-                typeof error === "object" &&
-                "code" in error &&
-                error.code === "EEXIST") {
-                throw new Error(`Refusing to overwrite existing files under ${rootDir}. Pick an empty directory or remove the conflicting files.`);
+        return {
+            rootDir,
+            files,
+            created: files
+                .filter((entry) => entry.action === "create")
+                .map((entry) => entry.path),
+            skipped: files
+                .filter((entry) => entry.action === "exist")
+                .map((entry) => entry.path),
+        };
+    });
+}
+function isEexist(error) {
+    return (error !== null &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "EEXIST");
+}
+/**
+ * Install the scaffold's npm dependencies so `dev` / `run` can resolve
+ * `@cursor/july` immediately after `init`.
+ */
+export function installScaffoldDependencies(rootDir_1) {
+    return __awaiter(this, arguments, void 0, function* (rootDir, options = {}) {
+        var _a, _b;
+        const stdio = (_a = options.stdio) !== null && _a !== void 0 ? _a : "inherit";
+        const command = process.platform === "win32" ? "npm.cmd" : "npm";
+        const args = ["install", "--no-fund", "--no-audit"];
+        const runner = (_b = options.runner) !== null && _b !== void 0 ? _b : defaultNpmInstallRunner;
+        const result = yield runner({ command, args, cwd: rootDir, stdio });
+        return {
+            ok: result.exitCode === 0,
+            exitCode: result.exitCode,
+            stderr: result.stderr,
+        };
+    });
+}
+function defaultNpmInstallRunner(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        return yield new Promise((resolvePromise, reject) => {
+            var _a, _b, _c;
+            const child = spawn(args.command, args.args, {
+                cwd: args.cwd,
+                stdio: args.stdio === "inherit" ? "inherit" : ["ignore", "pipe", "pipe"],
+                env: process.env,
+            });
+            let stderr = "";
+            if (args.stdio === "pipe") {
+                (_a = child.stderr) === null || _a === void 0 ? void 0 : _a.setEncoding("utf8");
+                (_b = child.stderr) === null || _b === void 0 ? void 0 : _b.on("data", (chunk) => {
+                    stderr += chunk;
+                });
+                (_c = child.stdout) === null || _c === void 0 ? void 0 : _c.resume();
             }
-            throw error;
-        }
-        return { rootDir, files: written };
+            child.on("error", reject);
+            child.on("close", (code) => {
+                resolvePromise({ exitCode: code !== null && code !== void 0 ? code : 1, stderr });
+            });
+        });
     });
 }
 function formatModelLiteral(model) {
@@ -97,6 +197,95 @@ ${model.params
     id: ${JSON.stringify(model.id)}${params},
   }`;
 }
+function initPalette(color) {
+    return color === undefined ? stdoutPalette() : makePalette(color);
+}
+/**
+ * Created/skipped files plus the project path. Printed before an interactive
+ * login so the scaffold is visible while the browser flow runs.
+ */
+export function formatInitScaffoldSummary(options) {
+    const c = initPalette(options.color);
+    const name = basename(options.rootDir);
+    const lines = [];
+    lines.push(`Initialized agent ${name}`);
+    lines.push("");
+    for (const file of options.files) {
+        // Empty-dir placeholders stay on disk but clutter the summary.
+        if (file.path.endsWith("/.gitkeep") || file.path === ".gitkeep") {
+            continue;
+        }
+        // Thor/Rails status column is 12 chars, right-aligned.
+        lines.push(c.dim(`${file.action.padStart(12)}  ${file.path}`));
+    }
+    lines.push("");
+    lines.push(c.dim(`Project: ${options.rootDir}`));
+    lines.push("");
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Numbered next steps after scaffold (and after login when init ran it).
+ * Includes `cd` when init did not already run inside the project.
+ */
+export function formatInitNextSteps(options) {
+    const c = initPalette(options.color);
+    const lines = [];
+    lines.push("Next steps:");
+    lines.push("");
+    const steps = initNextStepEntries(options);
+    const width = Math.max(...steps.map((step) => step.command.length));
+    for (const [index, step] of steps.entries()) {
+        const command = step.note === undefined
+            ? step.command
+            : `${step.command.padEnd(width)}   ${c.dim(`# ${step.note}`)}`;
+        lines.push(`  ${index + 1}. ${command}`);
+    }
+    return `${lines.join("\n")}\n`;
+}
+/**
+ * Full human-readable scaffold summary (scaffold + next steps).
+ */
+export function formatInitSummary(options) {
+    return formatInitScaffoldSummary(options) + formatInitNextSteps(options);
+}
+/**
+ * `cd` into the scaffold when init did not already run inside it. Relative
+ * when the target sits under the invoking directory, absolute otherwise.
+ */
+export function formatCdCommand(cwd, rootDir) {
+    const rel = relative(cwd, rootDir);
+    if (rel === "") {
+        return undefined;
+    }
+    const path = rel.startsWith("..") ? rootDir : rel;
+    const quoted = /\s/.test(path) ? JSON.stringify(path) : path;
+    return `cd ${quoted}`;
+}
+function initNextStepEntries(options) {
+    const steps = [];
+    const cd = formatCdCommand(options.cwd, options.rootDir);
+    if (cd !== undefined) {
+        steps.push({ command: cd });
+    }
+    if (!options.signedIn) {
+        steps.push({
+            command: `${CLI_COMMAND_NAME} login`,
+            note: "connect your Cursor account (powers model turns)",
+        });
+    }
+    steps.push({
+        command: `${CLI_COMMAND_NAME} dev`,
+        note: "start the local playground",
+    });
+    return steps;
+}
+/**
+ * Next-step commands for the `--json` scaffold summary (login omitted when
+ * the host already has a Cursor credential).
+ */
+export function initNextCommands(options) {
+    return initNextStepEntries(options).map((step) => step.command);
+}
 /**
  * Coding-agent setup guide printed by `agent-serve init`
  * with no target directory (does not scaffold).
@@ -104,15 +293,16 @@ ${model.params
 export function printInitGuide() {
     process.stdout.write(`${CLI_COMMAND_NAME} — coding agent setup
 
-Recommended loop:
+Scaffold a project, then open the playground:
+  ${CLI_COMMAND_NAME} init ./my-agent   # installs deps; signs you in when needed
+  cd ./my-agent && ${CLI_COMMAND_NAME} dev
+
+Recommended loop once the project exists:
   1. Edit agent/ + tools under agent/tools/
   2. ${CLI_COMMAND_NAME} info --dir . --json
   3. ${CLI_COMMAND_NAME} run --dir . --message "..."
   4. ${CLI_COMMAND_NAME} eval --dir .
 
-Scaffold a project:
-  ${CLI_COMMAND_NAME} init ./my-agent
-
 Evals:
   Create evals/**/*.eval.ts using defineEval from ${PACKAGE_NAME}/evals
   Case id is the path: evals/weather/nyc.eval.ts → weather/nyc

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

@@ -0,0 +1,64 @@
+/**
+ * Offer to install the package's coding-agent skills into the user's
+ * personal Cursor skills dir under `~/.cursor/skills/agentkit/<skill>/`.
+ *
+ * Cursor walks `~/.cursor/skills` recursively, so the `agentkit/` folder is
+ * only organizational — identity comes from the leaf folder that holds
+ * SKILL.md. Skipped for `--json` / non-TTY hosts.
+ */
+/** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
+export declare const CURSOR_SKILLS_NAMESPACE = "agentkit";
+export interface PackageSkill {
+    /** Frontmatter `name` (e.g. agentkit-create-agent). */
+    name: string;
+    /** Leaf install directory under agentkit/ (e.g. create-agent). */
+    leafDir: string;
+    /** Absolute path to the source skill directory in the package. */
+    sourceDir: string;
+}
+export declare function cursorSkillsHome(home?: string): string;
+/** `~/.cursor/skills/agentkit` — where package skills are installed. */
+export declare function agentkitCursorSkillsDir(skillsHome?: string): string;
+/** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
+export declare function skillInstallPath(skill: Pick<PackageSkill, "leafDir">, skillsHome?: string): string;
+/**
+ * Skills shipped next to the running package. Uses the frontmatter `name`
+ * when present, otherwise `agentkit-<dir>`.
+ */
+export declare function listShippedPackageSkills(packageRoot?: string): Promise<PackageSkill[]>;
+/**
+ * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentkit/.
+ * Install still overwrites every shipped skill when the user confirms — this
+ * helper is for messaging (fresh install vs update).
+ */
+export declare function findMissingCursorSkills(options?: {
+    packageRoot?: string;
+    skillsHome?: string;
+}): Promise<PackageSkill[]>;
+/**
+ * Copy each skill directory into `skillsHome/agentkit/<leafDir>/`.
+ * Always overwrites so a package upgrade refreshes local Cursor skills.
+ * Strips monorepo-only frontmatter and removes leaf dirs no longer shipped.
+ */
+export declare function installCursorSkills(skills: readonly PackageSkill[], skillsHome?: string): Promise<string[]>;
+/** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
+export declare function prepareSkillMarkdownForCursorInstall(content: string): string;
+export interface OfferInstallCursorSkillsOptions {
+    /** Skip when false (non-TTY / `--json`). */
+    interactive?: boolean;
+    packageRoot?: string;
+    skillsHome?: string;
+    /** Injected yes/no for tests. */
+    confirm?: (question: string) => Promise<boolean>;
+    out?: (text: string) => void;
+}
+/**
+ * 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.
+ */
+export declare function offerInstallCursorSkills(options?: OfferInstallCursorSkillsOptions): Promise<{
+    installed: string[];
+    skipped: boolean;
+}>;
+//# sourceMappingURL=install-cursor-skills.d.ts.map

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

@@ -0,0 +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"}

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

@@ -0,0 +1,274 @@
+/**
+ * Offer to install the package's coding-agent skills into the user's
+ * personal Cursor skills dir under `~/.cursor/skills/agentkit/<skill>/`.
+ *
+ * Cursor walks `~/.cursor/skills` recursively, so the `agentkit/` folder is
+ * only organizational — identity comes from the leaf folder that holds
+ * SKILL.md. Skipped for `--json` / non-TTY hosts.
+ */
+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, 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 { 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";
+export function cursorSkillsHome(home) {
+    var _a;
+    if (home === void 0) { home = (_a = process.env.HOME) !== null && _a !== void 0 ? _a : homedir(); }
+    const resolved = home.trim() === "" ? homedir() : home;
+    return join(resolved, ".cursor", "skills");
+}
+/** `~/.cursor/skills/agentkit` — where package skills are installed. */
+export function agentkitCursorSkillsDir(skillsHome = cursorSkillsHome()) {
+    return join(skillsHome, CURSOR_SKILLS_NAMESPACE);
+}
+/** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
+export function skillInstallPath(skill, skillsHome = cursorSkillsHome()) {
+    return join(agentkitCursorSkillsDir(skillsHome), skill.leafDir);
+}
+/**
+ * Skills shipped next to the running package. Uses the frontmatter `name`
+ * when present, otherwise `agentkit-<dir>`.
+ */
+export function listShippedPackageSkills() {
+    return __awaiter(this, arguments, void 0, function* (packageRoot = packageRootDir()) {
+        var _a;
+        const skillsRoot = join(packageRoot, "skills");
+        let entries;
+        try {
+            entries = yield readdir(skillsRoot, { withFileTypes: true });
+        }
+        catch (_b) {
+            return [];
+        }
+        const skills = [];
+        for (const entry of entries) {
+            if (!entry.isDirectory() || SKIP_SKILL_DIRS.has(entry.name)) {
+                continue;
+            }
+            const sourceDir = join(skillsRoot, entry.name);
+            const skillMd = join(sourceDir, "SKILL.md");
+            try {
+                yield access(skillMd);
+            }
+            catch (_c) {
+                continue;
+            }
+            const raw = yield readFile(skillMd, "utf8");
+            const name = (_a = parseSkillName(raw)) !== null && _a !== void 0 ? _a : `agentkit-${entry.name}`;
+            skills.push({ name, leafDir: entry.name, sourceDir });
+        }
+        skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
+        return skills;
+    });
+}
+/**
+ * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentkit/.
+ * 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);
+            }
+        }
+        return missing;
+    });
+}
+/**
+ * Copy each skill directory into `skillsHome/agentkit/<leafDir>/`.
+ * Always overwrites so a package upgrade refreshes local Cursor skills.
+ * Strips monorepo-only frontmatter and removes leaf dirs no longer shipped.
+ */
+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 installed = [];
+        for (const skill of skills) {
+            const target = skillInstallPath(skill, skillsHome);
+            yield cp(skill.sourceDir, target, { recursive: true, force: true });
+            const skillMdPath = join(target, "SKILL.md");
+            const raw = yield readFile(skillMdPath, "utf8");
+            const adjusted = prepareSkillMarkdownForCursorInstall(raw);
+            if (adjusted !== raw) {
+                yield writeFile(skillMdPath, adjusted, "utf8");
+            }
+            installed.push(skill.leafDir);
+        }
+        return installed;
+    });
+}
+/** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
+export function prepareSkillMarkdownForCursorInstall(content) {
+    var _a;
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
+    if (match === null) {
+        return content;
+    }
+    const frontmatter = stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : "");
+    const body = content.slice(match[0].length);
+    const adjustedBody = body.replace(/\[`docs\/([^`]+)`\]\(\.\.\/\.\.\/docs\/[^)]+\)/g, "docs/$1 in the @cursor/july package");
+    return `---\n${frontmatter.trimEnd()}\n---${adjustedBody}`;
+}
+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 : "";
+        if (line.trimStart().startsWith("paths:")) {
+            i++;
+            while (i < lines.length && /^[ \t]*-/.test((_b = lines[i]) !== null && _b !== void 0 ? _b : "")) {
+                i++;
+            }
+            i--;
+            continue;
+        }
+        out.push(line);
+    }
+    return out.join("\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.
+ */
+export function offerInstallCursorSkills() {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
+        var _a, _b, _c, _d;
+        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) {
+            return { installed: [], skipped: true };
+        }
+        const home = (_c = options.skillsHome) !== null && _c !== void 0 ? _c : cursorSkillsHome();
+        const targetDir = agentkitCursorSkillsDir(home);
+        const missing = yield findMissingCursorSkills({
+            packageRoot: options.packageRoot,
+            skillsHome: home,
+        });
+        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) {
+            return { installed: [], skipped: true };
+        }
+        const c = stdoutPalette();
+        out(`${question}\n`);
+        out(c.dim(`  ${names}\n`));
+        if (missing.length < shipped.length) {
+            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"));
+            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 };
+    });
+}
+function parseSkillName(skillMd) {
+    var _a;
+    var _b;
+    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(skillMd);
+    if (match === null) {
+        return undefined;
+    }
+    const nameLine = /^name:\s*(.+)\s*$/m.exec((_b = match[1]) !== null && _b !== void 0 ? _b : "");
+    if (nameLine === null) {
+        return undefined;
+    }
+    const raw = (_a = nameLine[1]) === null || _a === void 0 ? void 0 : _a.trim();
+    if (raw === undefined || raw === "") {
+        return undefined;
+    }
+    // Strip optional quotes around the YAML scalar.
+    return raw.replace(/^["']|["']$/g, "");
+}
+function promptYesNo(question, options) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const hint = options.defaultYes ? "Y/n" : "y/N";
+        options.out(`${question} [${hint}] `);
+        process.stdin.resume();
+        const line = yield readOneLine(process.stdin);
+        process.stdin.pause();
+        if (line === undefined || 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;
+    });
+}
+function readOneLine(stream) {
+    return new Promise((resolve) => {
+        let buffer = "";
+        const onData = (chunk) => {
+            buffer += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            const newline = buffer.indexOf("\n");
+            if (newline === -1) {
+                return;
+            }
+            cleanup();
+            resolve(buffer.slice(0, newline).replace(/\r$/, ""));
+        };
+        const onEnd = () => {
+            cleanup();
+            resolve(buffer === "" ? undefined : buffer.replace(/\r$/, ""));
+        };
+        const cleanup = () => {
+            stream.off("data", onData);
+            stream.off("end", onEnd);
+        };
+        stream.on("data", onData);
+        stream.on("end", onEnd);
+    });
+}