skilld 1.7.3 → 2.0.0

package/dist/_chunks/prompts.mjs

@@ -1,6 +1,474 @@
-import { f as getPackageRules, i as resolveSkilldCommand } from "./shared.mjs";
-import "./skill.mjs";
-import { dirname } from "pathe";
+import { a as targets } from "./detect.mjs";
+import "./paths.mjs";
+import { c as NPM_SCOPE_PREFIX_RE, f as SEMVER_MAJOR_MINOR_RE } from "./regex.mjs";
+import { n as sanitizeMarkdown, t as repairMarkdown } from "./sanitize.mjs";
+import { t as yamlEscape } from "./yaml.mjs";
+import { existsSync, lstatSync, mkdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { styleText } from "node:util";
+import * as p from "@clack/prompts";
+import { dirname, join, relative } from "pathe";
+import { execSync } from "node:child_process";
+import { isWindows } from "std-env";
+let cached;
+function resolveSkilldCommand() {
+	if (cached !== void 0) return cached;
+	try {
+		execSync(`${isWindows ? "where" : "which"} skilld`, { stdio: "ignore" });
+		cached = "skilld";
+	} catch {
+		cached = "npx -y skilld";
+	}
+	return cached;
+}
+const REPO_REGISTRY = {
+	"vuejs/core": {
+		owner: "vuejs",
+		repo: "core",
+		docsRepo: "docs",
+		docsPath: "src",
+		homepage: "https://vuejs.org",
+		prereleaseChangelogRef: "minor",
+		packages: {
+			"vue": {
+				primary: true,
+				filePatterns: ["*.vue"],
+				rules: ["ALWAYS use `<script setup lang=\"ts\">`", "Use ```vue code fences for SFC examples containing `<script>` or `<template>` tags, ```ts for plain TypeScript"]
+			},
+			"@vue/compiler-core": {},
+			"@vue/compiler-dom": {},
+			"@vue/reactivity": {},
+			"@vue/runtime-core": {},
+			"@vue/runtime-dom": {},
+			"@vue/shared": {}
+		},
+		blogReleases: [
+			{
+				version: "3.5",
+				url: "https://blog.vuejs.org/posts/vue-3-5",
+				date: "2024-09-01"
+			},
+			{
+				version: "3.4",
+				url: "https://blog.vuejs.org/posts/vue-3-4",
+				date: "2023-12-28"
+			},
+			{
+				version: "3.3",
+				url: "https://blog.vuejs.org/posts/vue-3-3",
+				date: "2023-05-11"
+			},
+			{
+				version: "3.2",
+				url: "https://blog.vuejs.org/posts/vue-3-2",
+				date: "2021-08-05"
+			},
+			{
+				version: "3.1",
+				url: "https://blog.vuejs.org/posts/vue-3-1",
+				date: "2021-06-07"
+			},
+			{
+				version: "3.0",
+				url: "https://blog.vuejs.org/posts/vue-3-0",
+				date: "2020-09-18"
+			}
+		]
+	},
+	"tailwindlabs/tailwindcss": {
+		owner: "tailwindlabs",
+		repo: "tailwindcss",
+		docsRepo: "tailwindcss.com",
+		docsPath: "src/docs",
+		homepage: "https://tailwindcss.com",
+		packages: { tailwindcss: { primary: true } }
+	},
+	"withastro/astro": {
+		owner: "withastro",
+		repo: "astro",
+		docsRepo: "docs",
+		docsPath: "src/content/docs/en",
+		homepage: "https://docs.astro.build",
+		packages: { astro: {
+			primary: true,
+			filePatterns: ["*.astro"]
+		} }
+	},
+	"vueuse/vueuse": {
+		owner: "vueuse",
+		repo: "vueuse",
+		docsPath: "packages",
+		packages: { "@vueuse/core": { primary: true } }
+	},
+	"sveltejs/svelte": {
+		owner: "sveltejs",
+		repo: "svelte",
+		packages: { svelte: {
+			primary: true,
+			filePatterns: ["*.svelte"],
+			rules: ["ALWAYS use runes syntax ($state, $derived, $effect, $props)"]
+		} }
+	},
+	"solidjs/solid": {
+		owner: "solidjs",
+		repo: "solid",
+		packages: { "solid-js": {
+			primary: true,
+			filePatterns: ["*.jsx", "*.tsx"]
+		} }
+	},
+	"QwikDev/qwik": {
+		owner: "QwikDev",
+		repo: "qwik",
+		packages: { qwik: {
+			primary: true,
+			filePatterns: ["*.tsx"]
+		} }
+	},
+	"marko-js/marko": {
+		owner: "marko-js",
+		repo: "marko",
+		packages: { marko: {
+			primary: true,
+			filePatterns: ["*.marko"]
+		} }
+	},
+	"riot/riot": {
+		owner: "riot",
+		repo: "riot",
+		packages: { riot: {
+			primary: true,
+			filePatterns: ["*.riot"]
+		} }
+	},
+	"microsoft/TypeScript": {
+		owner: "microsoft",
+		repo: "TypeScript",
+		packages: { typescript: {
+			primary: true,
+			filePatterns: [
+				"*.ts",
+				"*.tsx",
+				"*.mts",
+				"*.cts"
+			]
+		} },
+		blogReleases: [
+			{
+				version: "6.0",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-6-0-beta/",
+				date: "2026-02-11",
+				title: "Announcing TypeScript 6.0 Beta"
+			},
+			{
+				version: "5.9",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-9/",
+				date: "2025-08-01",
+				title: "Announcing TypeScript 5.9"
+			},
+			{
+				version: "5.8",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-8/",
+				date: "2025-02-28",
+				title: "Announcing TypeScript 5.8"
+			},
+			{
+				version: "5.7",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-7/",
+				date: "2024-11-22",
+				title: "Announcing TypeScript 5.7"
+			},
+			{
+				version: "5.6",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-6/",
+				date: "2024-09-09",
+				title: "Announcing TypeScript 5.6"
+			},
+			{
+				version: "5.5",
+				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/",
+				date: "2024-06-20",
+				title: "Announcing TypeScript 5.5"
+			}
+		]
+	},
+	"jashkenas/coffeescript": {
+		owner: "jashkenas",
+		repo: "coffeescript",
+		packages: { coffeescript: {
+			primary: true,
+			filePatterns: ["*.coffee"]
+		} }
+	},
+	"gkz/LiveScript": {
+		owner: "gkz",
+		repo: "LiveScript",
+		packages: { livescript: {
+			primary: true,
+			filePatterns: ["*.ls"]
+		} }
+	},
+	"elm/compiler": {
+		owner: "elm",
+		repo: "compiler",
+		packages: { elm: {
+			primary: true,
+			filePatterns: ["*.elm"]
+		} }
+	},
+	"sass/dart-sass": {
+		owner: "sass",
+		repo: "dart-sass",
+		packages: { sass: {
+			primary: true,
+			filePatterns: ["*.scss", "*.sass"]
+		} }
+	},
+	"less/less.js": {
+		owner: "less",
+		repo: "less.js",
+		packages: { less: {
+			primary: true,
+			filePatterns: ["*.less"]
+		} }
+	},
+	"stylus/stylus": {
+		owner: "stylus",
+		repo: "stylus",
+		packages: { stylus: {
+			primary: true,
+			filePatterns: ["*.styl"]
+		} }
+	},
+	"postcss/postcss": {
+		owner: "postcss",
+		repo: "postcss",
+		packages: { postcss: {
+			primary: true,
+			filePatterns: ["*.css", "*.pcss"]
+		} }
+	},
+	"pugjs/pug": {
+		owner: "pugjs",
+		repo: "pug",
+		packages: { pug: {
+			primary: true,
+			filePatterns: ["*.pug"]
+		} }
+	},
+	"mde/ejs": {
+		owner: "mde",
+		repo: "ejs",
+		packages: { ejs: {
+			primary: true,
+			filePatterns: ["*.ejs"]
+		} }
+	},
+	"handlebars-lang/handlebars.js": {
+		owner: "handlebars-lang",
+		repo: "handlebars.js",
+		packages: { handlebars: {
+			primary: true,
+			filePatterns: ["*.hbs", "*.handlebars"]
+		} }
+	},
+	"janl/mustache.js": {
+		owner: "janl",
+		repo: "mustache.js",
+		packages: { mustache: {
+			primary: true,
+			filePatterns: ["*.mustache"]
+		} }
+	},
+	"mozilla/nunjucks": {
+		owner: "mozilla",
+		repo: "nunjucks",
+		packages: { nunjucks: {
+			primary: true,
+			filePatterns: ["*.njk"]
+		} }
+	},
+	"Shopify/liquid": {
+		owner: "Shopify",
+		repo: "liquid",
+		packages: { liquid: {
+			primary: true,
+			filePatterns: ["*.liquid"]
+		} }
+	},
+	"eemeli/yaml": {
+		owner: "eemeli",
+		repo: "yaml",
+		packages: { yaml: {
+			primary: true,
+			filePatterns: ["*.yaml", "*.yml"]
+		} }
+	},
+	"nodeca/js-yaml": {
+		owner: "nodeca",
+		repo: "js-yaml",
+		packages: { "js-yaml": {
+			primary: true,
+			filePatterns: ["*.yaml", "*.yml"]
+		} }
+	},
+	"BinaryMuse/toml-node": {
+		owner: "BinaryMuse",
+		repo: "toml-node",
+		packages: {
+			"toml": {
+				primary: true,
+				filePatterns: ["*.toml"]
+			},
+			"@iarna/toml": { filePatterns: ["*.toml"] }
+		}
+	},
+	"json5/json5": {
+		owner: "json5",
+		repo: "json5",
+		packages: { json5: {
+			primary: true,
+			filePatterns: ["*.json5"]
+		} }
+	},
+	"microsoft/node-jsonc-parser": {
+		owner: "microsoft",
+		repo: "node-jsonc-parser",
+		packages: { "jsonc-parser": {
+			primary: true,
+			filePatterns: ["*.jsonc"]
+		} }
+	},
+	"markdown-it/markdown-it": {
+		owner: "markdown-it",
+		repo: "markdown-it",
+		packages: { "markdown-it": {
+			primary: true,
+			filePatterns: ["*.md"]
+		} }
+	},
+	"markedjs/marked": {
+		owner: "markedjs",
+		repo: "marked",
+		packages: { marked: {
+			primary: true,
+			filePatterns: ["*.md"]
+		} }
+	},
+	"remarkjs/remark": {
+		owner: "remarkjs",
+		repo: "remark",
+		packages: { remark: {
+			primary: true,
+			filePatterns: ["*.md", "*.mdx"]
+		} }
+	},
+	"mdx-js/mdx": {
+		owner: "mdx-js",
+		repo: "mdx",
+		packages: { "@mdx-js/mdx": {
+			primary: true,
+			filePatterns: ["*.mdx"]
+		} }
+	},
+	"graphql/graphql-js": {
+		owner: "graphql",
+		repo: "graphql-js",
+		packages: {
+			"graphql": {
+				primary: true,
+				filePatterns: ["*.graphql", "*.gql"]
+			},
+			"graphql-tag": { filePatterns: ["*.graphql", "*.gql"] }
+		}
+	},
+	"dotansimha/graphql-code-generator": {
+		owner: "dotansimha",
+		repo: "graphql-code-generator",
+		packages: { "@graphql-codegen/cli": {
+			primary: true,
+			filePatterns: ["*.graphql", "*.gql"]
+		} }
+	},
+	"quasarframework/quasar": {
+		owner: "quasarframework",
+		repo: "quasar",
+		docsPath: "docs/src/pages",
+		docsRef: "dev",
+		homepage: "https://quasar.dev",
+		packages: { quasar: { primary: true } }
+	},
+	"motiondivision/motion-vue": {
+		owner: "motiondivision",
+		repo: "motion-vue",
+		homepage: "https://motion.dev",
+		crawlUrl: "https://motion.dev/docs/vue**",
+		packages: { "motion-v": { primary: true } }
+	},
+	"prisma/prisma": {
+		owner: "prisma",
+		repo: "prisma",
+		packages: {
+			"prisma": {
+				primary: true,
+				filePatterns: ["*.prisma"]
+			},
+			"@prisma/client": { filePatterns: ["*.prisma"] }
+		}
+	},
+	"nicolo-ribaudo/tc39-proposal-wasm-esm-integration": {
+		owner: "nicolo-ribaudo",
+		repo: "tc39-proposal-wasm-esm-integration",
+		packages: { "wasm-pack": {
+			primary: true,
+			filePatterns: ["*.wasm"]
+		} }
+	}
+};
+const PACKAGE_TO_REPO_MAP = {};
+for (const [repoKey, entry] of Object.entries(REPO_REGISTRY)) for (const packageName of Object.keys(entry.packages)) PACKAGE_TO_REPO_MAP[packageName] = repoKey;
+function getDocOverride(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	const entry = REPO_REGISTRY[repoKey];
+	if (!entry?.docsRepo && !entry?.docsPath) return void 0;
+	return {
+		owner: entry.owner,
+		repo: entry.docsRepo || entry.repo,
+		path: entry.docsPath || "",
+		ref: entry.docsRef,
+		homepage: entry.homepage
+	};
+}
+function getBlogPreset(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	const entry = REPO_REGISTRY[repoKey];
+	if (!entry?.blogReleases) return void 0;
+	return {
+		packageName,
+		releases: entry.blogReleases
+	};
+}
+function getFilePatterns(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	return REPO_REGISTRY[repoKey]?.packages[packageName]?.filePatterns;
+}
+function getPackageRules(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return [];
+	return REPO_REGISTRY[repoKey]?.packages[packageName]?.rules ?? [];
+}
+function getPrereleaseChangelogRef(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	return REPO_REGISTRY[repoKey]?.prereleaseChangelogRef;
+}
+function getCrawlUrl(packageName) {
+	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
+	if (!repoKey) return void 0;
+	return REPO_REGISTRY[repoKey]?.crawlUrl;
+}
 const TOTAL_TARGET = 500;
 const DEFAULT_OVERHEAD = 30;
 function remainingLines(overheadLines) {
@@ -54,8 +522,9 @@ function checkAbsolutePaths(content) {
 	if (absPaths?.length) return [{ warning: `${absPaths.length} source links use absolute paths — must use relative ./.skilld/ paths` }];
 	return [];
 }
+const STATIC_REGEX_2$4 = /^## API Changes/im;
 function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasDocs, hasIssues, hasDiscussions, pkgFiles, features, enabledSectionCount, releaseCount, overheadLines }) {
-	const [, major, minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
+	const [, major, minor] = version?.match(SEMVER_MAJOR_MINOR_RE) ?? [];
 	const boost = releaseBoost(releaseCount, minor ? Number(minor) : void 0);
 	const cmd = resolveSkilldCommand();
 	const searchHints = [];
@@ -134,7 +603,7 @@ The "Older" column means ≤ v${Number(major) - 2}.x — these changes are NOT u
 			const labeledBullets = (content.match(/^- (?:\*\*)?(?:BREAKING|DEPRECATED|NEW):(?:\*\*)? /gm) || []).length;
 			const alsoChangedItems = (content.match(/\*\*Also changed:\*\*/g) || []).length;
 			if (detailedBullets > 2 && labeledBullets / (detailedBullets - alsoChangedItems || 1) < .8) warnings.push({ warning: `Only ${labeledBullets}/${detailedBullets} items have BREAKING/DEPRECATED/NEW labels` });
-			if (!/^## API Changes/im.test(content)) warnings.push({ warning: "Missing required \"## API Changes\" heading" });
+			if (!STATIC_REGEX_2$4.test(content)) warnings.push({ warning: "Missing required \"## API Changes\" heading" });
 			return warnings;
 		},
 		task: `**Find new, deprecated, and renamed APIs from version history.** Focus exclusively on APIs that changed between versions — LLMs trained on older data will use the wrong names, wrong signatures, or non-existent functions.
@@ -176,8 +645,9 @@ Each item: BREAKING/DEPRECATED/NEW label + API name + what changed + source link
 		].filter(Boolean)
 	};
 }
+const STATIC_REGEX_2$3 = /^## Best Practices/im;
 function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, hasDocs, pkgFiles, features, enabledSectionCount, releaseCount, version, overheadLines }) {
-	const [, , minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
+	const [, , minor] = version?.match(SEMVER_MAJOR_MINOR_RE) ?? [];
 	const boost = 1 + (releaseBoost(releaseCount, minor ? Number(minor) : void 0) - 1) * .5;
 	const cmd = resolveSkilldCommand();
 	const searchHints = [];
@@ -227,7 +697,7 @@ function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasRelea
 			const bullets = (content.match(/^- /gm) || []).length;
 			const codeBlocks = (content.match(/^```/gm) || []).length / 2;
 			if (bullets > 2 && codeBlocks / bullets > .5) warnings.push({ warning: `${Math.round(codeBlocks)}/${bullets} items have code blocks — prefer concise descriptions with source links` });
-			if (!/^## Best Practices/im.test(content)) warnings.push({ warning: "Missing required \"## Best Practices\" heading" });
+			if (!STATIC_REGEX_2$3.test(content)) warnings.push({ warning: "Missing required \"## Best Practices\" heading" });
 			return warnings;
 		},
 		task: `**Extract non-obvious best practices from the references.** Focus on recommended patterns the LLM wouldn't already know: idiomatic usage, preferred configurations, performance tips, patterns that differ from what a developer would assume. Surface new patterns from recent minor releases that may post-date training data.
@@ -289,16 +759,32 @@ Content addressing the user's instructions above, using concise examples and sou
 		rules: [`- **Custom section "${heading}":** MAX ${customMaxLines} lines, use \`## ${heading}\` heading`]
 	};
 }
-const SECTION_OUTPUT_FILES = {
-	"best-practices": "_BEST_PRACTICES.md",
-	"api-changes": "_API_CHANGES.md",
-	"custom": "_CUSTOM.md"
-};
-const SECTION_MERGE_ORDER = [
-	"api-changes",
-	"best-practices",
-	"custom"
+const SECTIONS = [
+	{
+		id: "api-changes",
+		outputFile: "_API_CHANGES.md",
+		build: (ctx) => apiChangesSection(ctx)
+	},
+	{
+		id: "best-practices",
+		outputFile: "_BEST_PRACTICES.md",
+		build: (ctx) => bestPracticesSection(ctx)
+	},
+	{
+		id: "custom",
+		outputFile: "_CUSTOM.md",
+		build: (ctx, customPrompt) => customPrompt ? customSection(customPrompt, ctx.enabledSectionCount, ctx.overheadLines) : null
+	}
 ];
+const SECTION_OUTPUT_FILES = Object.fromEntries(SECTIONS.map((s) => [s.id, s.outputFile]));
+const SECTION_MERGE_ORDER = SECTIONS.map((s) => s.id);
+function getSectionModule(id) {
+	return SECTIONS.find((s) => s.id === id);
+}
+const STATIC_REGEX_1$1 = /v\d+\.(\d+)\.(\d+)\.md$/;
+const STATIC_REGEX_2$2 = /[^`]*\/\.skilld\//;
+const STATIC_REGEX_3 = /\n## Output\n[\s\S]*$/;
+const STATIC_REGEX_4 = /\n## Search\n[\s\S]*?(?=\n\n(?:\||## |<|\*\*))/;
 function wrapSection(section, content) {
 	return `<!-- skilld:${section} -->\n${content}\n<!-- /skilld:${section} -->`;
 }
@@ -372,11 +858,7 @@ ${generateImportantBlock({
 ${docsSection ? `${docsSection}\n` : ""}`;
 }
 function getSectionDef(section, ctx, customPrompt) {
-	switch (section) {
-		case "api-changes": return apiChangesSection(ctx);
-		case "best-practices": return bestPracticesSection(ctx);
-		case "custom": return customPrompt ? customSection(customPrompt, ctx.enabledSectionCount, ctx.overheadLines) : null;
-	}
+	return getSectionModule(section)?.build(ctx, customPrompt) ?? null;
 }
 function getSectionValidator(section) {
 	return getSectionDef(section, { packageName: "" }, section === "custom" ? {
@@ -394,7 +876,7 @@ function buildSectionPrompt(opts) {
 	const hasDocs = !!opts.docFiles?.some((f) => f.includes("/docs/"));
 	const releaseCount = opts.docFiles?.filter((f) => {
 		if (!f.includes("/releases/")) return false;
-		const m = f.match(/v\d+\.(\d+)\.(\d+)\.md$/);
+		const m = f.match(STATIC_REGEX_1$1);
 		return m && (m[1] === "0" || m[2] === "0");
 	}).length;
 	const sectionDef = getSectionDef(section, {
@@ -463,12 +945,12 @@ function buildAllSectionPrompts(opts) {
 }
 function portabilizePrompt(prompt, section) {
 	let out = prompt;
-	out = out.replace(/`[^`]*\/\.skilld\//g, (m) => m.replace(/[^`]*\/\.skilld\//, "./references/"));
+	out = out.replace(/`[^`]*\/\.skilld\//g, (m) => m.replace(STATIC_REGEX_2$2, "./references/"));
 	out = out.replace(/\(\.\/\.skilld\//g, "(./references/");
 	out = out.replace(/`\.\/\.skilld\//g, "`./references/");
 	out = out.replace(/\.skilld\//g, "./references/");
-	out = out.replace(/\n## Output\n[\s\S]*$/, "");
-	out = out.replace(/\n## Search\n[\s\S]*?(?=\n\n(?:\||## |<|\*\*))/, "");
+	out = out.replace(STATIC_REGEX_3, "");
+	out = out.replace(STATIC_REGEX_4, "");
 	out = out.replace(/^- .*`skilld search`.*$/gm, "");
 	out = out.replace(/^- .*`skilld validate`.*$/gm, "");
 	out = out.replace(/,? and `skilld search`/g, "");
@@ -487,6 +969,282 @@ function portabilizePrompt(prompt, section) {
 	out = out.replace(/\n{3,}/g, "\n\n");
 	return out;
 }
-export { extractMarkedSections as a, wrapSection as c, buildSectionPrompt as i, maxItems as l, SECTION_OUTPUT_FILES as n, getSectionValidator as o, buildAllSectionPrompts as r, portabilizePrompt as s, SECTION_MERGE_ORDER as t, maxLines as u };
+const STATIC_REGEX_1 = /https?:\/\/github\.com\//;
+const STATIC_REGEX_2$1 = /^#+\s*$/;
+function todayIsoDate() {
+	return (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+}
+function timeAgo(iso) {
+	if (!iso) return "";
+	const diff = Date.now() - new Date(iso).getTime();
+	const days = Math.floor(diff / 864e5);
+	if (days <= 0) return "today";
+	if (days === 1) return "1d ago";
+	if (days < 7) return `${days}d ago`;
+	if (days < 30) return `${Math.floor(days / 7)}w ago`;
+	return `${Math.floor(days / 30)}mo ago`;
+}
+function formatSource(source) {
+	if (!source) return "";
+	if (source === "shipped") return "shipped";
+	if (source.includes("llms.txt")) return "llms.txt";
+	if (source.includes("github.com")) return source.replace(STATIC_REGEX_1, "");
+	return source;
+}
+function formatDuration(ms) {
+	if (ms < 1e3) return `${Math.round(ms)}ms`;
+	return `${(ms / 1e3).toFixed(1)}s`;
+}
+function timedSpinner() {
+	const spin = p.spinner();
+	let startedAt = 0;
+	return {
+		start(msg) {
+			startedAt = Date.now();
+			spin.start(msg);
+		},
+		message(msg) {
+			spin.message(msg);
+		},
+		stop(msg) {
+			const elapsed = startedAt ? formatDuration(Date.now() - startedAt) : "";
+			spin.stop(elapsed ? `${msg} ${styleText("gray", `[${elapsed}]`)}` : msg);
+		}
+	};
+}
+function highlightTerms(content, terms) {
+	if (terms.length === 0) return content;
+	const sorted = terms.toSorted((a, b) => b.length - a.length);
+	const pattern = new RegExp(`(${sorted.map((t) => t.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})`, "gi");
+	return content.replace(pattern, (m) => styleText("yellow", m));
+}
+function scoreLabel(pct) {
+	return styleText(pct >= 70 ? "green" : pct >= 40 ? "yellow" : "gray", `${pct}%`);
+}
+function normalizeScores(results) {
+	const map = /* @__PURE__ */ new Map();
+	const max = results.reduce((m, r) => Math.max(m, r.score), 0);
+	for (const r of results) map.set(r, max > 0 ? Math.round(r.score / max * 100) : 0);
+	return map;
+}
+function formatSnippet(r, versions, pct) {
+	const refPath = `.claude/skills/${r.package}/.skilld/${r.source}`;
+	const lineRange = r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`;
+	const score = pct != null ? scoreLabel(pct) : styleText("gray", r.score.toFixed(2));
+	const version = versions?.get(r.package);
+	const pkgLabel = version ? `${r.package}@${version}` : r.package;
+	const scopeStr = r.scope?.length ? `${r.scope.map((e) => e.name).join(".")} → ` : "";
+	const entityStr = r.entities?.map((e) => e.signature || `${e.type} ${e.name}`).join(", ");
+	const highlighted = highlightTerms(r.content, r.highlights);
+	return [
+		`${pkgLabel} ${score}${entityStr ? `  ${styleText("cyan", `${scopeStr}${entityStr}`)}` : ""}`,
+		styleText("gray", `${refPath}:${lineRange}`),
+		`  ${highlighted.replace(/\n/g, "\n  ")}`
+	].join("\n");
+}
+function formatCompactSnippet(r, cols) {
+	const entityStr = r.entities?.length ? r.entities.map((e) => e.signature || e.name).join(", ") : "";
+	const scopeStr = r.scope?.length ? `${r.scope.map((e) => e.name).join(".")} → ` : "";
+	const title = entityStr ? `${scopeStr}${entityStr}` : r.source.split("/").pop() || r.source;
+	const path = `${`.claude/skills/${r.package}/.skilld/${r.source}`}:${r.lineStart === r.lineEnd ? `L${r.lineStart}` : `L${r.lineStart}-${r.lineEnd}`}`;
+	const maxPreview = cols - 6;
+	const firstLine = r.content.split("\n").find((l) => l.trim() && l.trim() !== "---" && !STATIC_REGEX_2$1.test(l.trim())) || "";
+	return {
+		title,
+		path,
+		preview: firstLine.length > maxPreview ? `${firstLine.slice(0, maxPreview - 1)}…` : firstLine
+	};
+}
+function sanitizeName(name) {
+	return name.toLowerCase().replace(/[^a-z0-9._]+/g, "-").replace(/^[.\-]+|[.\-]+$/g, "").slice(0, 255) || "unnamed-skill";
+}
+function computeSkillDirName(packageName) {
+	return `${sanitizeName(packageName)}-skilld`;
+}
+function linkSkillToAgents(skillName, sharedDir, cwd, agentType) {
+	const targetAgents = agentType ? [[agentType, targets[agentType]]] : Object.entries(targets);
+	const linkedDirs = /* @__PURE__ */ new Set();
+	for (const [type, agent] of targetAgents) {
+		const agentSkillsDir = join(cwd, agent.skillsDir);
+		if (agentType === type) mkdirSync(agentSkillsDir, { recursive: true });
+		else {
+			if (!existsSync(agentSkillsDir)) continue;
+			if (agent.additionalSkillsDirs.map((d) => join(cwd, d)).some((d) => linkedDirs.has(d))) {
+				const staleTarget = join(agentSkillsDir, skillName);
+				try {
+					if (lstatSync(staleTarget).isSymbolicLink() && !existsSync(staleTarget)) unlinkSync(staleTarget);
+				} catch {}
+				continue;
+			}
+		}
+		const target = join(agentSkillsDir, skillName);
+		let isSymlink = false;
+		let targetExists = false;
+		try {
+			const stat = lstatSync(target);
+			targetExists = true;
+			isSymlink = stat.isSymbolicLink();
+		} catch {}
+		if (targetExists && !isSymlink) continue;
+		if (isSymlink) unlinkSync(target);
+		symlinkSync(relative(agentSkillsDir, join(sharedDir, skillName)), target);
+		linkedDirs.add(agentSkillsDir);
+	}
+}
+function unlinkSkillFromAgents(skillName, cwd, agentType) {
+	const targetAgents = agentType ? [[agentType, targets[agentType]]] : Object.entries(targets);
+	for (const [, agent] of targetAgents) {
+		const target = join(cwd, agent.skillsDir, skillName);
+		try {
+			if (lstatSync(target).isSymbolicLink()) unlinkSync(target);
+		} catch {}
+	}
+}
+const STATIC_REGEX_2 = /\.?\s*$/;
+function writeSkillMd(skillDir, content) {
+	writeFileSync(join(skillDir, "SKILL.md"), content);
+}
+function writeGeneratedSkillMd(skillDir, opts) {
+	const content = generateSkillMd(opts);
+	writeSkillMd(skillDir, content);
+	return content;
+}
+function generateSkillMd(opts) {
+	const header = generatePackageHeader(opts);
+	const search = !opts.eject && opts.features?.search !== false ? generateSearchBlock(opts.name) : "";
+	let body = opts.body;
+	if (body && opts.eject) {
+		body = body.replace(/\.\/\.skilld\//g, "./references/");
+		body = body.replace(/\s*\[source\]\(\.\/references\/pkg\/[^)]*\)/gi, "");
+	}
+	const content = body ? search ? `${header}\n\n${search}\n\n${body}` : `${header}\n\n${body}` : search ? `${header}\n\n${search}` : header;
+	const footer = generateFooter(opts.relatedSkills);
+	return sanitizeMarkdown(repairMarkdown(`${generateFrontmatter(opts)}${content}\n${footer}`));
+}
+function formatShortDate(isoDate) {
+	const date = new Date(isoDate);
+	if (Number.isNaN(date.getTime())) return "";
+	return `${[
+		"Jan",
+		"Feb",
+		"Mar",
+		"Apr",
+		"May",
+		"Jun",
+		"Jul",
+		"Aug",
+		"Sep",
+		"Oct",
+		"Nov",
+		"Dec"
+	][date.getUTCMonth()]} ${date.getUTCFullYear()}`;
+}
+function generatePackageHeader({ name, version, distTags, repoUrl, hasIssues, hasDiscussions, hasReleases, docsType, pkgFiles, packages, eject }) {
+	const versionSuffix = version ? `@${version}` : "";
+	let title = `# ${name}${versionSuffix}`;
+	if (repoUrl) {
+		const url = repoUrl.startsWith("http") ? repoUrl : `https://github.com/${repoUrl}`;
+		title = `# [${repoUrl.startsWith("http") ? repoUrl.split("/").slice(-2).join("/") : repoUrl}](${url}) \`${name}${versionSuffix}\``;
+	}
+	const lines = [title];
+	if (distTags && Object.keys(distTags).length > 0) {
+		const tags = Object.entries(distTags).sort(([, a], [, b]) => (b.releasedAt ?? "").localeCompare(a.releasedAt ?? "")).slice(0, 3).map(([tag, info]) => {
+			const relDate = info.releasedAt ? ` (${formatShortDate(info.releasedAt)})` : "";
+			return `${tag}: ${info.version}${relDate}`;
+		}).join(", ");
+		lines.push(`**Tags:** ${tags}`);
+	}
+	lines.push("");
+	const refBase = eject ? "./references" : "./.skilld";
+	const refs = [];
+	if (!eject) {
+		refs.push(`[package.json](${refBase}/pkg/package.json)`);
+		if (packages && packages.length > 1) for (const pkg of packages) {
+			const shortName = pkg.name.split("/").pop().toLowerCase();
+			refs.push(`[pkg-${shortName}](${refBase}/pkg-${shortName}/package.json)`);
+		}
+		if (pkgFiles?.includes("README.md")) refs.push(`[README](${refBase}/pkg/README.md)`);
+	}
+	if (docsType && docsType !== "readme") refs.push(`[Docs](${refBase}/docs/_INDEX.md)`);
+	if (hasIssues) refs.push(`[Issues](${refBase}/issues/_INDEX.md)`);
+	if (hasDiscussions) refs.push(`[Discussions](${refBase}/discussions/_INDEX.md)`);
+	if (hasReleases) refs.push(`[Releases](${refBase}/releases/_INDEX.md)`);
+	if (refs.length > 0) lines.push(`**References:** ${refs.join(" • ")}`);
+	return lines.join("\n");
+}
+function expandPackageName(name) {
+	const variants = /* @__PURE__ */ new Set();
+	const unscoped = name.replace(NPM_SCOPE_PREFIX_RE, "");
+	if (unscoped !== name) {
+		variants.add(unscoped);
+		variants.add(unscoped.replace(/\//g, " "));
+	}
+	if (name.includes("-")) {
+		const spaced = name.replace(NPM_SCOPE_PREFIX_RE, "").replace(/\//g, " ").replace(/-/g, " ");
+		variants.add(spaced);
+	}
+	variants.delete(name);
+	return [...variants];
+}
+function expandRepoName(repoUrl) {
+	const variants = /* @__PURE__ */ new Set();
+	const repoName = repoUrl.startsWith("http") ? repoUrl.split("/").pop() : repoUrl.split("/").pop();
+	if (!repoName) return [];
+	variants.add(repoName);
+	if (repoName.includes("-")) variants.add(repoName.replace(/-/g, " "));
+	return [...variants];
+}
+function generateFrontmatter({ name, version, description: pkgDescription, globs, body, generatedBy, dirName, packages, repoUrl }) {
+	const patterns = globs ?? getFilePatterns(name);
+	const globHint = patterns?.length ? ` or working with ${patterns.join(", ")} files` : "";
+	const rawDesc = pkgDescription?.replace(/[<>]/g, "").replace(STATIC_REGEX_2, "");
+	const cleanDesc = rawDesc && rawDesc.length > 200 ? `${rawDesc.slice(0, 197)}...` : rawDesc;
+	const editHint = globHint ? `editing${globHint} or code importing` : "writing code importing";
+	let desc;
+	if (packages && packages.length > 1) {
+		const importList = packages.map((p) => `"${p.name}"`).join(", ");
+		const allKeywords = /* @__PURE__ */ new Set();
+		for (const pkg of packages) {
+			allKeywords.add(pkg.name);
+			for (const kw of expandPackageName(pkg.name)) allKeywords.add(kw);
+		}
+		const keywordList = [...allKeywords].join(", ");
+		desc = `${cleanDesc ? `${cleanDesc}. ` : ""}ALWAYS use when ${editHint} ${importList}. Consult for debugging, best practices, or modifying ${keywordList}.`;
+	} else {
+		const allKeywords = /* @__PURE__ */ new Set();
+		allKeywords.add(name);
+		for (const kw of expandPackageName(name)) allKeywords.add(kw);
+		if (repoUrl) for (const kw of expandRepoName(repoUrl)) allKeywords.add(kw);
+		const nameList = [...allKeywords].join(", ");
+		desc = `${cleanDesc ? `${cleanDesc}. ` : ""}ALWAYS use when ${editHint} "${name}". Consult for debugging, best practices, or modifying ${nameList}.`;
+	}
+	if (desc.length > 1024) desc = `${desc.slice(0, 1021)}...`;
+	const lines = [
+		"---",
+		`name: ${dirName ?? computeSkillDirName(name)}`,
+		`description: ${yamlEscape(desc)}`
+	];
+	const metaEntries = [];
+	if (version) metaEntries.push(`  version: ${yamlEscape(version)}`);
+	if (body && generatedBy) metaEntries.push(`  generated_by: ${yamlEscape(generatedBy)}`);
+	metaEntries.push(`  generated_at: ${todayIsoDate()}`);
+	if (metaEntries.length) {
+		lines.push("metadata:");
+		lines.push(...metaEntries);
+	}
+	lines.push("---", "", "");
+	return lines.join("\n");
+}
+function generateSearchBlock(name) {
+	const cmd = resolveSkilldCommand();
+	return `## Search
+
+Use \`${cmd} search "query" -p ${name}\` instead of grepping \`.skilld/\` directories. Run \`${cmd} search --guide -p ${name}\` for full syntax, filters, and operators.`;
+}
+function generateFooter(relatedSkills) {
+	if (relatedSkills.length === 0) return "";
+	return `\nRelated: ${relatedSkills.join(", ")}\n`;
+}
+export { resolveSkilldCommand as A, SECTION_OUTPUT_FILES as C, getCrawlUrl as D, getBlogPreset as E, getDocOverride as O, SECTION_MERGE_ORDER as S, maxLines as T, buildAllSectionPrompts as _, sanitizeName as a, portabilizePrompt as b, formatDuration as c, highlightTerms as d, normalizeScores as f, todayIsoDate as g, timedSpinner as h, linkSkillToAgents as i, getPrereleaseChangelogRef as k, formatSnippet as l, timeAgo as m, writeSkillMd as n, unlinkSkillFromAgents as o, scoreLabel as p, computeSkillDirName as r, formatCompactSnippet as s, writeGeneratedSkillMd as t, formatSource as u, extractMarkedSections as v, maxItems as w, wrapSection as x, getSectionValidator as y };
 
 //# sourceMappingURL=prompts.mjs.map