skilld 1.5.4 → 1.6.2

package/dist/_chunks/prompts.mjs

@@ -4,40 +4,21 @@ import { d as getFilePatterns, f as getPackageRules, i as resolveSkilldCommand }
 import { a as targets, t as detectInstalledAgents } from "./detect.mjs";
 import { dirname, join, relative } from "pathe";
 import { existsSync, lstatSync, mkdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
-//#region src/agent/prompts/optional/budget.ts
-/**
-* Dynamic budget allocation for skill sections.
-*
-* Total SKILL.md target is ~500 lines. Overhead (frontmatter, header, search, footer)
-* is subtracted to get the available body budget, which is divided among enabled sections.
-* When a package has many releases, budgets scale up.
-*/
 const TOTAL_TARGET = 500;
 const DEFAULT_OVERHEAD = 30;
-/** Available body lines after overhead is subtracted */
 function remainingLines(overheadLines) {
 	return TOTAL_TARGET - (overheadLines ?? DEFAULT_OVERHEAD);
 }
-/** Scale max lines based on enabled section count and available remaining space. */
 function maxLines(min, max, sectionCount, overheadLines) {
 	const remaining = remainingLines(overheadLines);
-	const sections = Math.max(1, sectionCount ?? 1);
-	const perSection = Math.floor(remaining / sections);
+	const perSection = Math.floor(remaining / Math.max(1, sectionCount ?? 1));
 	const scale = budgetScale(sectionCount);
 	return Math.max(min, Math.min(Math.round(max * scale), perSection));
 }
-/** Scale item count based on enabled section count. */
 function maxItems(min, max, sectionCount) {
 	const scale = budgetScale(sectionCount);
 	return Math.max(min, Math.round(max * scale));
 }
-/**
-* Boost budget for high-churn packages based on API-level release density.
-* Combines major/minor release count with current minor version as a churn signal.
-*
-* @param significantReleases - Count of major/minor releases (patch releases excluded)
-* @param minorVersion - Current minor version number (e.g., 15 for v3.15.0)
-*/
 function releaseBoost(significantReleases, minorVersion) {
 	const combined = (!significantReleases ? 0 : significantReleases <= 5 ? 0 : significantReleases <= 15 ? 1 : 2) + (!minorVersion ? 0 : minorVersion <= 3 ? 0 : minorVersion <= 10 ? 1 : 2);
 	if (combined <= 0) return 1;
@@ -50,41 +31,32 @@ function budgetScale(sectionCount) {
 	if (sectionCount === 3) return .7;
 	return .6;
 }
-//#endregion
-//#region src/agent/prompts/optional/validate.ts
-/** Warns if content exceeds 150% of max lines */
 function checkLineCount(content, max) {
 	const lines = content.split("\n").length;
 	if (lines > Math.round(max * 1.5)) return [{ warning: `Output ${lines} lines exceeds ${max} max by >50%` }];
 	return [];
 }
-/** Warns if content is fewer than 3 lines */
 function checkSparseness(content) {
 	const lines = content.split("\n").length;
 	if (lines < 3) return [{ warning: `Output only ${lines} lines — likely too sparse` }];
 	return [];
 }
-/** Warns if sourced/bullets ratio is below minRatio */
 function checkSourceCoverage(content, minRatio = .8) {
 	const bullets = (content.match(/^- /gm) || []).length;
 	const sourced = (content.match(/\[source\]/g) || []).length;
 	if (bullets > 2 && sourced / bullets < minRatio) return [{ warning: `Only ${sourced}/${bullets} items have source citations (need ${Math.round(minRatio * 100)}% coverage)` }];
 	return [];
 }
-/** Warns if source links are missing .skilld/ prefix */
 function checkSourcePaths(content) {
 	const badPaths = content.match(/\[source\]\(\.\/(docs|issues|discussions|releases|pkg|guide)\//g);
 	if (badPaths?.length) return [{ warning: `${badPaths.length} source links missing .skilld/ prefix` }];
 	return [];
 }
-/** Warns if source links use absolute filesystem paths instead of relative ./.skilld/ paths */
 function checkAbsolutePaths(content) {
 	const absPaths = content.match(/\[source\]\(\/[^)]+\)/g);
 	if (absPaths?.length) return [{ warning: `${absPaths.length} source links use absolute paths — must use relative ./.skilld/ paths` }];
 	return [];
 }
-//#endregion
-//#region src/agent/prompts/optional/api-changes.ts
 function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasDocs, hasIssues, hasDiscussions, pkgFiles, features, enabledSectionCount, releaseCount, overheadLines }) {
 	const [, major, minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
 	const boost = releaseBoost(releaseCount, minor ? Number(minor) : void 0);
@@ -207,8 +179,6 @@ Each item: BREAKING/DEPRECATED/NEW label + API name + what changed + source link
 		].filter(Boolean)
 	};
 }
-//#endregion
-//#region src/agent/prompts/optional/best-practices.ts
 function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, hasDocs, pkgFiles, features, enabledSectionCount, releaseCount, version, overheadLines }) {
 	const [, , minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
 	const boost = 1 + (releaseBoost(releaseCount, minor ? Number(minor) : void 0) - 1) * .5;
@@ -300,8 +270,6 @@ Each item: markdown list item (-) + ${packageName}-specific pattern + why it's p
 		]
 	};
 }
-//#endregion
-//#region src/agent/prompts/optional/custom.ts
 function customSection({ heading, body }, enabledSectionCount, overheadLines) {
 	const customMaxLines = maxLines(50, 80, enabledSectionCount, overheadLines);
 	return {
@@ -324,25 +292,19 @@ Content addressing the user's instructions above, using concise examples and sou
 		rules: [`- **Custom section "${heading}":** MAX ${customMaxLines} lines, use \`## ${heading}\` heading`]
 	};
 }
-//#endregion
-//#region src/agent/prompts/prompt.ts
-/** Output file per section (inside .skilld/) */
 const SECTION_OUTPUT_FILES = {
 	"best-practices": "_BEST_PRACTICES.md",
 	"api-changes": "_API_CHANGES.md",
 	"custom": "_CUSTOM.md"
 };
-/** Merge order for final SKILL.md body */
 const SECTION_MERGE_ORDER = [
 	"api-changes",
 	"best-practices",
 	"custom"
 ];
-/** Wrap section content with HTML comment markers for targeted re-assembly */
 function wrapSection(section, content) {
 	return `<!-- skilld:${section} -->\n${content}\n<!-- /skilld:${section} -->`;
 }
-/** Extract marker-delimited sections from existing SKILL.md */
 function extractMarkedSections(md) {
 	const sections = /* @__PURE__ */ new Map();
 	for (const section of SECTION_MERGE_ORDER) {
@@ -357,10 +319,6 @@ function extractMarkedSections(md) {
 	}
 	return sections;
 }
-/**
-* Group files by parent directory with counts
-* e.g. `/path/to/docs/api/ (15 .md files)`
-*/
 function formatDocTree(files) {
 	const dirs = /* @__PURE__ */ new Map();
 	for (const f of files) {
@@ -390,7 +348,6 @@ Use \`${cmd} search "query" -p ${packageName}\` as your primary research tool
 
 ${table}`;
 }
-/** Shared preamble: Security, references table, Quality Principles, doc tree */
 function buildPreamble(opts) {
 	const { packageName, skillDir, hasIssues, hasDiscussions, hasReleases, hasChangelog, docFiles, docsType = "docs", hasShippedDocs = false, versionContext } = opts;
 	const docsSection = docFiles?.length ? `<external-docs>\n**Documentation** (use Read tool to explore):\n${formatDocTree(docFiles)}\n</external-docs>` : "";
@@ -424,19 +381,12 @@ function getSectionDef(section, ctx, customPrompt) {
 		case "custom": return customPrompt ? customSection(customPrompt, ctx.enabledSectionCount, ctx.overheadLines) : null;
 	}
 }
-/**
-* Get the validate function for a section using default context (validators use fixed thresholds).
-* Returns null if section has no validator.
-*/
 function getSectionValidator(section) {
 	return getSectionDef(section, { packageName: "" }, section === "custom" ? {
 		heading: "Custom",
 		body: ""
 	} : void 0)?.validate ?? null;
 }
-/**
-* Build prompt for a single section
-*/
 function buildSectionPrompt(opts) {
 	const { packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, version, section, customPrompt, skillDir } = opts;
 	const versionContext = version ? ` v${version}` : "";
@@ -502,9 +452,6 @@ Write your final output to the file \`${skillDir}/.skilld/${outputFile}\` using
 After writing, run \`${cmd} validate ${skillDir}/.skilld/${outputFile}\` and fix any warnings before finishing. If unavailable, use \`${fallbackCmd} validate ${skillDir}/.skilld/${outputFile}\`.
 `;
 }
-/**
-* Build prompts for all selected sections, sharing the computed preamble
-*/
 function buildAllSectionPrompts(opts) {
 	const result = /* @__PURE__ */ new Map();
 	for (const section of opts.sections) {
@@ -517,14 +464,6 @@ function buildAllSectionPrompts(opts) {
 	}
 	return result;
 }
-/**
-* Transform an agent-specific prompt into a portable prompt for any LLM.
-* - Rewrites .skilld/ paths → ./references/
-* - Strips ## Output section (file-writing instructions)
-* - Strips skilld search/validate instructions
-* - Replaces tool-specific language with generic equivalents
-* - Strips agent-specific rules
-*/
 function portabilizePrompt(prompt, section) {
 	let out = prompt;
 	out = out.replace(/`[^`]*\/\.skilld\//g, (m) => m.replace(/[^`]*\/\.skilld\//, "./references/"));
@@ -551,31 +490,12 @@ function portabilizePrompt(prompt, section) {
 	out = out.replace(/\n{3,}/g, "\n\n");
 	return out;
 }
-//#endregion
-//#region src/agent/install.ts
-/**
-* Sanitize skill name for filesystem
-*/
 function sanitizeName(name) {
 	return name.toLowerCase().replace(/[^a-z0-9._]+/g, "-").replace(/^[.\-]+|[.\-]+$/g, "").slice(0, 255) || "unnamed-skill";
 }
-/**
-* Compute skill directory name from package name with -skilld suffix.
-* No collisions for monorepo packages (each gets a unique name).
-*
-* Examples:
-*   vue → vue-skilld
-*   @unhead/vue → unhead-vue-skilld
-*   @unhead/react → unhead-react-skilld
-*/
 function computeSkillDirName(packageName) {
 	return `${sanitizeName(packageName)}-skilld`;
 }
-/**
-* Install a skill directly to agent skill directories.
-* When agents are explicitly specified, creates directories as needed.
-* When falling back to auto-detection, only writes to agents whose skills dir already exists.
-*/
 function installSkillForAgents(skillName, skillContent, options = {}) {
 	const isGlobal = options.global ?? false;
 	const cwd = options.cwd || process.cwd();
@@ -625,12 +545,6 @@ function installSkillForAgents(skillName, skillContent, options = {}) {
 		paths
 	};
 }
-/**
-* Create a relative symlink from the target agent's skills dir to the shared .skills/ dir.
-* Only creates directories for the explicit target agent; other agents must already have
-* their skills dir present. This prevents skilld from polluting projects with dirs
-* for agents the user doesn't use (e.g. .gemini/, .agent/).
-*/
 function linkSkillToAgents(skillName, sharedDir, cwd, agentType) {
 	const targetAgents = agentType ? [[agentType, targets[agentType]]] : Object.entries(targets);
 	const linkedDirs = /* @__PURE__ */ new Set();
@@ -661,9 +575,6 @@ function linkSkillToAgents(skillName, sharedDir, cwd, agentType) {
 		linkedDirs.add(agentSkillsDir);
 	}
 }
-/**
-* Remove per-agent symlinks for a skill when removing from shared dir.
-*/
 function unlinkSkillFromAgents(skillName, cwd, agentType) {
 	const targetAgents = agentType ? [[agentType, targets[agentType]]] : Object.entries(targets);
 	for (const [, agent] of targetAgents) {
@@ -673,8 +584,6 @@ function unlinkSkillFromAgents(skillName, cwd, agentType) {
 		} catch {}
 	}
 }
-//#endregion
-//#region src/agent/prompts/skill.ts
 function generateSkillMd(opts) {
 	const header = generatePackageHeader(opts);
 	const search = !opts.eject && opts.features?.search !== false ? generateSearchBlock(opts.name) : "";
@@ -687,7 +596,6 @@ function generateSkillMd(opts) {
 	const footer = generateFooter(opts.relatedSkills);
 	return sanitizeMarkdown(repairMarkdown(`${generateFrontmatter(opts)}${content}\n${footer}`));
 }
-/** Format ISO date as short absolute date: "Jan 2025", "Dec 2024" */
 function formatShortDate(isoDate) {
 	const date = new Date(isoDate);
 	if (Number.isNaN(date.getTime())) return "";
@@ -739,10 +647,6 @@ function generatePackageHeader({ name, version, distTags, repoUrl, hasIssues, ha
 	if (refs.length > 0) lines.push(`**References:** ${refs.join(" • ")}`);
 	return lines.join("\n");
 }
-/**
-* Expand a package name into keyword variants for better trigger matching.
-* e.g. "@nuxt/ui" → ["nuxt ui", "nuxt/ui"], "vue-router" → ["vue router"]
-*/
 function expandPackageName(name) {
 	const variants = /* @__PURE__ */ new Set();
 	const unscoped = name.replace(/^@/, "");
@@ -757,10 +661,6 @@ function expandPackageName(name) {
 	variants.delete(name);
 	return [...variants];
 }
-/**
-* Extract and expand GitHub repo name into keyword variants.
-* e.g. "motion-v" → ["motion-v", "motion v"]
-*/
 function expandRepoName(repoUrl) {
 	const variants = /* @__PURE__ */ new Set();
 	const repoName = repoUrl.startsWith("http") ? repoUrl.split("/").pop() : repoUrl.split("/").pop();
@@ -820,7 +720,6 @@ function generateFooter(relatedSkills) {
 	if (relatedSkills.length === 0) return "";
 	return `\nRelated: ${relatedSkills.join(", ")}\n`;
 }
-//#endregion
 export { sanitizeName as a, SECTION_OUTPUT_FILES as c, extractMarkedSections as d, getSectionValidator as f, maxLines as g, maxItems as h, linkSkillToAgents as i, buildAllSectionPrompts as l, wrapSection as m, computeSkillDirName as n, unlinkSkillFromAgents as o, portabilizePrompt as p, installSkillForAgents as r, SECTION_MERGE_ORDER as s, generateSkillMd as t, buildSectionPrompt as u };
 
 //# sourceMappingURL=prompts.mjs.map