skilld 1.7.2 → 1.7.4

package/dist/_chunks/prompts.mjs

@@ -1,6 +1,24 @@
-import { f as getPackageRules, i as resolveSkilldCommand } from "./shared.mjs";
-import "./skill.mjs";
-import { dirname } from "pathe";
+import { p as skillInternalDir } from "./paths.mjs";
+import { t as yamlEscape } from "./yaml.mjs";
+import { n as sanitizeMarkdown, t as repairMarkdown } from "./sanitize.mjs";
+import { a as getPackageRules, i as getFilePatterns } from "./package-registry.mjs";
+import { a as targets, t as detectInstalledAgents } from "./detect.mjs";
+import { existsSync, lstatSync, mkdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { dirname, join, relative } from "pathe";
+import { execSync } from "node:child_process";
+import * as p from "@clack/prompts";
+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 TOTAL_TARGET = 500;
 const DEFAULT_OVERHEAD = 30;
 function remainingLines(overheadLines) {
@@ -289,16 +307,28 @@ 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);
+}
 function wrapSection(section, content) {
 	return `<!-- skilld:${section} -->\n${content}\n<!-- /skilld:${section} -->`;
 }
@@ -372,11 +402,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" ? {
@@ -487,6 +513,328 @@ 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 };
+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(/https?:\/\/github\.com\//, "");
+	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} \x1B[90m[${elapsed}]\x1B[0m` : 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, "\x1B[33m$1\x1B[0m");
+}
+function scoreLabel(pct) {
+	return `${pct >= 70 ? "\x1B[32m" : pct >= 40 ? "\x1B[33m" : "\x1B[90m"}${pct}%\x1B[0m`;
+}
+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) : `\x1B[90m${r.score.toFixed(2)}\x1B[0m`;
+	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 ? `  \x1B[36m${scopeStr}${entityStr}\x1B[0m` : ""}`,
+		`\x1B[90m${refPath}:${lineRange}\x1B[0m`,
+		`  ${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() !== "---" && !/^#+\s*$/.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 installSkillForAgents(skillName, skillContent, options = {}) {
+	const isGlobal = options.global ?? false;
+	const cwd = options.cwd || process.cwd();
+	const sanitized = sanitizeName(skillName);
+	const explicit = !!options.agents;
+	const targetAgents = options.agents || detectInstalledAgents();
+	const installed = [];
+	const skipped = [];
+	const paths = [];
+	const writtenDirs = /* @__PURE__ */ new Set();
+	for (const agentType of targetAgents) {
+		const agent = targets[agentType];
+		if (isGlobal && !agent.globalSkillsDir) {
+			skipped.push({
+				agent: agentType,
+				reason: "no global support"
+			});
+			continue;
+		}
+		const baseDir = isGlobal ? agent.globalSkillsDir : join(cwd, agent.skillsDir);
+		if (!explicit && !existsSync(baseDir)) {
+			skipped.push({
+				agent: agentType,
+				reason: "skills dir not found"
+			});
+			continue;
+		}
+		if (isGlobal && (writtenDirs.has(baseDir) || agent.additionalSkillsDirs.some((d) => writtenDirs.has(d)))) {
+			skipped.push({
+				agent: agentType,
+				reason: "already covered by another agent dir"
+			});
+			continue;
+		}
+		const skillDir = join(baseDir, sanitized);
+		const skilldDir = skillInternalDir(skillDir);
+		mkdirSync(skilldDir, { recursive: true });
+		writeFileSync(join(skilldDir, "_SKILL.md"), sanitizeMarkdown(repairMarkdown(skillContent)));
+		if (options.files) for (const [filename, content] of Object.entries(options.files)) writeFileSync(join(skillDir, filename), filename.endsWith(".md") ? sanitizeMarkdown(repairMarkdown(content)) : content);
+		installed.push(agentType);
+		paths.push(skillDir);
+		writtenDirs.add(baseDir);
+	}
+	return {
+		installed,
+		skipped,
+		paths
+	};
+}
+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 {}
+	}
+}
+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(/^@/, "");
+	if (unscoped !== name) {
+		variants.add(unscoped);
+		variants.add(unscoped.replace(/\//g, " "));
+	}
+	if (name.includes("-")) {
+		const spaced = name.replace(/^@/, "").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(/\.?\s*$/, "");
+	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 { portabilizePrompt as C, maxItems as D, SECTION_OUTPUT_FILES as E, maxLines as O, getSectionValidator as S, SECTION_MERGE_ORDER as T, timedSpinner as _, installSkillForAgents as a, buildSectionPrompt as b, unlinkSkillFromAgents as c, formatSnippet as d, formatSource as f, timeAgo as g, scoreLabel as h, computeSkillDirName as i, resolveSkilldCommand as k, formatCompactSnippet as l, normalizeScores as m, writeGeneratedSkillMd as n, linkSkillToAgents as o, highlightTerms as p, writeSkillMd as r, sanitizeName as s, generateSkillMd as t, formatDuration as u, todayIsoDate as v, wrapSection as w, extractMarkedSections as x, buildAllSectionPrompts as y };
 
 //# sourceMappingURL=prompts.mjs.map