skilld 0.14.1 → 0.14.2

package/dist/_chunks/prompts.mjs

@@ -1,6 +1,6 @@
 import { n as sanitizeMarkdown, t as repairMarkdown } from "./sanitize.mjs";
 import { t as yamlEscape } from "./yaml.mjs";
-import { a as getPackageRules, i as getFilePatterns } from "./package-registry.mjs";
+import { i as resolveSkilldCommand, l as getFilePatterns, u as getPackageRules } from "./shared.mjs";
 import { homedir } from "node:os";
 import { dirname, join, relative } from "pathe";
 import { existsSync, lstatSync, mkdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
@@ -589,22 +589,23 @@ function checkAbsolutePaths(content) {
 function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasDocs, hasIssues, hasDiscussions, pkgFiles, features, enabledSectionCount, releaseCount }) {
 	const [, major, minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
 	const boost = releaseBoost(releaseCount, minor ? Number(minor) : void 0);
+	const cmd = resolveSkilldCommand();
 	const searchHints = [];
 	if (features?.search !== false) {
-		searchHints.push(`\`npx -y skilld search "deprecated" -p ${packageName}\``, `\`npx -y skilld search "breaking" -p ${packageName}\``);
+		searchHints.push(`\`${cmd} search "deprecated" -p ${packageName}\``, `\`${cmd} search "breaking" -p ${packageName}\``);
 		if (major && minor) {
 			const minorNum = Number(minor);
 			const majorNum = Number(major);
 			if (minorNum <= 2) {
-				searchHints.push(`\`npx -y skilld search "v${majorNum}.${minorNum}" -p ${packageName}\``);
-				if (minorNum > 0) searchHints.push(`\`npx -y skilld search "v${majorNum}.${minorNum - 1}" -p ${packageName}\``);
-				if (majorNum > 0) searchHints.push(`\`npx -y skilld search "v${majorNum - 1}" -p ${packageName}\``);
+				searchHints.push(`\`${cmd} search "v${majorNum}.${minorNum}" -p ${packageName}\``);
+				if (minorNum > 0) searchHints.push(`\`${cmd} search "v${majorNum}.${minorNum - 1}" -p ${packageName}\``);
+				if (majorNum > 0) searchHints.push(`\`${cmd} search "v${majorNum - 1}" -p ${packageName}\``);
 			} else {
-				searchHints.push(`\`npx -y skilld search "v${majorNum}.${minorNum}" -p ${packageName}\``);
-				searchHints.push(`\`npx -y skilld search "v${majorNum}.${minorNum - 1}" -p ${packageName}\``);
-				searchHints.push(`\`npx -y skilld search "v${majorNum}.${minorNum - 2}" -p ${packageName}\``);
+				searchHints.push(`\`${cmd} search "v${majorNum}.${minorNum}" -p ${packageName}\``);
+				searchHints.push(`\`${cmd} search "v${majorNum}.${minorNum - 1}" -p ${packageName}\``);
+				searchHints.push(`\`${cmd} search "v${majorNum}.${minorNum - 2}" -p ${packageName}\``);
 			}
-			searchHints.push(`\`npx -y skilld search "Features" -p ${packageName}\``);
+			searchHints.push(`\`${cmd} search "Features" -p ${packageName}\``);
 		}
 	}
 	const referenceWeights = [];
@@ -710,8 +711,9 @@ Each item: BREAKING/DEPRECATED/NEW label + API name + what changed + source link
 function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, hasDocs, pkgFiles, features, enabledSectionCount, releaseCount, version }) {
 	const [, , minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
 	const boost = 1 + (releaseBoost(releaseCount, minor ? Number(minor) : void 0) - 1) * .5;
+	const cmd = resolveSkilldCommand();
 	const searchHints = [];
-	if (features?.search !== false) searchHints.push(`\`npx -y skilld search "recommended" -p ${packageName}\``, `\`npx -y skilld search "avoid" -p ${packageName}\``);
+	if (features?.search !== false) searchHints.push(`\`${cmd} search "recommended" -p ${packageName}\``, `\`${cmd} search "avoid" -p ${packageName}\``);
 	const referenceWeights = [];
 	if (hasDocs) referenceWeights.push({
 		name: "Docs",
@@ -851,13 +853,15 @@ function generateImportantBlock({ packageName, hasIssues, hasDiscussions, hasRel
 		"|----------|------|",
 		...rows.map(([desc, cmd]) => `| ${desc} | ${cmd} |`)
 	].join("\n");
+	const cmd = resolveSkilldCommand();
+	const fallbackCmd = cmd === "skilld" ? "npx -y skilld" : "skilld";
 	return `**IMPORTANT:** Use these references${features?.search !== false ? `\n\n## Search
 
-Use \`npx -y skilld search\` as your primary research tool — search before manually reading files. Hybrid semantic + keyword search across all indexed docs, issues, and releases.
+Use \`${cmd} search\` as your primary research tool — search before manually reading files. If \`${cmd}\` is unavailable, use \`${fallbackCmd} search\`.
 
 \`\`\`bash
-npx -y skilld search "<query>" -p ${packageName}
-${hasIssues ? `npx -y skilld search "issues:<query>" -p ${packageName}\n` : ""}${hasReleases ? `npx -y skilld search "releases:<query>" -p ${packageName}\n` : ""}\`\`\`
+${cmd} search "<query>" -p ${packageName}
+${hasIssues ? `${cmd} search "issues:<query>" -p ${packageName}\n` : ""}${hasReleases ? `${cmd} search "releases:<query>" -p ${packageName}\n` : ""}\`\`\`
 
 Filters: \`docs:\`, \`issues:\`, \`releases:\` prefix narrows by source type.` : ""}
 
@@ -942,7 +946,10 @@ function buildSectionPrompt(opts) {
 		"- **Stop exploring once you have enough high-quality items** to fill the budget. Do not read additional files just to be thorough.",
 		opts.pkgFiles?.some((f) => f.endsWith(".d.ts")) ? "- **To verify API exports:** Read the `.d.ts` file directly (see Types row in references). Package directories are often gitignored — if you search `pkg/`, pass `no_ignore: true` to avoid silent empty results." : ""
 	].filter(Boolean);
-	return `${preamble}${sectionDef.referenceWeights?.length ? `\n\n## Reference Priority\n\n| Reference | Path | Score | Use For |\n|-----------|------|:-----:|--------|\n${sectionDef.referenceWeights.map((w) => `| ${w.name} | [\`${w.path.split("/").pop()}\`](${w.path}) | ${w.score}/10 | ${w.useFor} |`).join("\n")}` : ""}
+	const weightsTable = sectionDef.referenceWeights?.length ? `\n\n## Reference Priority\n\n| Reference | Path | Score | Use For |\n|-----------|------|:-----:|--------|\n${sectionDef.referenceWeights.map((w) => `| ${w.name} | [\`${w.path.split("/").pop()}\`](${w.path}) | ${w.score}/10 | ${w.useFor} |`).join("\n")}` : "";
+	const cmd = resolveSkilldCommand();
+	const fallbackCmd = cmd === "skilld" ? "npx -y skilld" : "skilld";
+	return `${preamble}${weightsTable}
 
 ## Task
 
@@ -960,7 +967,7 @@ ${rules.join("\n")}
 
 Write your final output to the file \`${skillDir}/.skilld/${outputFile}\` using the Write tool. Do NOT write to any other file path.
 
-After writing, run \`npx -y skilld validate ${skillDir}/.skilld/${outputFile}\` and fix any warnings before finishing.
+After writing, run \`${cmd} validate ${skillDir}/.skilld/${outputFile}\` and fix any warnings before finishing. If unavailable, use \`${fallbackCmd} validate ${skillDir}/.skilld/${outputFile}\`.
 `;
 }
 function buildAllSectionPrompts(opts) {
@@ -1166,12 +1173,14 @@ function generateFrontmatter({ name, version, description: pkgDescription, globs
 	return lines.join("\n");
 }
 function generateSearchBlock(name, hasIssues, hasReleases) {
-	const examples = [`npx -y skilld search "query" -p ${name}`];
-	if (hasIssues) examples.push(`npx -y skilld search "issues:error handling" -p ${name}`);
-	if (hasReleases) examples.push(`npx -y skilld search "releases:deprecated" -p ${name}`);
+	const cmd = resolveSkilldCommand();
+	const fallbackCmd = cmd === "skilld" ? "npx -y skilld" : "skilld";
+	const examples = [`${cmd} search "query" -p ${name}`];
+	if (hasIssues) examples.push(`${cmd} search "issues:error handling" -p ${name}`);
+	if (hasReleases) examples.push(`${cmd} search "releases:deprecated" -p ${name}`);
 	return `## Search
 
-Use \`npx -y skilld search\` instead of grepping \`.skilld/\` directories — hybrid semantic + keyword search across all indexed docs, issues, and releases.
+Use \`${cmd} search\` instead of grepping \`.skilld/\` directories — hybrid semantic + keyword search across all indexed docs, issues, and releases. If \`${cmd}\` is unavailable, use \`${fallbackCmd} search\`.
 
 \`\`\`bash
 ${examples.join("\n")}