skilld 0.9.3 → 0.9.5

package/dist/_chunks/detect-imports.mjs

@@ -1,6 +1,6 @@
 import { t as __exportAll } from "./chunk.mjs";
 import { _ as writeSections, b as sanitizeMarkdown, h as readCachedSection, y as repairMarkdown } from "./storage.mjs";
-import { l as getFilePatterns, o as mapInsert, t as yamlEscape } from "./yaml.mjs";
+import { d as getPackageRules, o as mapInsert, t as yamlEscape, u as getFilePatterns } from "./yaml.mjs";
 import { homedir } from "node:os";
 import { dirname, join, relative } from "pathe";
 import { existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, realpathSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
@@ -558,7 +558,7 @@ function budgetScale(sectionCount) {
 	if (sectionCount === 3) return .7;
 	return .6;
 }
-function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasIssues, hasDiscussions, features, enabledSectionCount }) {
+function apiChangesSection({ packageName, version, hasReleases, hasChangelog, hasDocs, hasIssues, hasDiscussions, features, enabledSectionCount }) {
 	const [, major, minor] = version?.match(/^(\d+)\.(\d+)/) ?? [];
 	const searchHints = [];
 	if (features?.search !== false) {
@@ -587,11 +587,11 @@ function apiChangesSection({ packageName, version, hasReleases, hasChangelog, ha
 	});
 	if (hasChangelog) referenceWeights.push({
 		name: "Changelog",
-		path: `./.skilld/pkg/${hasChangelog}`,
+		path: `./.skilld/${hasChangelog}`,
 		score: 9,
 		useFor: "Features/Breaking Changes sections per version"
 	});
-	referenceWeights.push({
+	if (hasDocs) referenceWeights.push({
 		name: "Docs",
 		path: "./.skilld/docs/",
 		score: 4,
@@ -646,15 +646,16 @@ Each item: ⚠️ (breaking/deprecated) or ✨ (new) + API name + what changed +
 		].filter(Boolean)
 	};
 }
-function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, features, enabledSectionCount }) {
+function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasReleases, hasChangelog, hasDocs, features, enabledSectionCount }) {
 	const searchHints = [];
 	if (features?.search !== false) searchHints.push(`\`npx -y skilld search "recommended" -p ${packageName}\``, `\`npx -y skilld search "avoid" -p ${packageName}\``);
-	const referenceWeights = [{
+	const referenceWeights = [];
+	if (hasDocs) referenceWeights.push({
 		name: "Docs",
 		path: "./.skilld/docs/",
 		score: 9,
 		useFor: "Primary source — recommended patterns, configuration, idiomatic usage"
-	}];
+	});
 	if (hasDiscussions) referenceWeights.push({
 		name: "Discussions",
 		path: "./.skilld/discussions/_INDEX.md",
@@ -675,7 +676,7 @@ function bestPracticesSection({ packageName, hasIssues, hasDiscussions, hasRelea
 	});
 	if (hasChangelog) referenceWeights.push({
 		name: "Changelog",
-		path: `./.skilld/pkg/${hasChangelog}`,
+		path: `./.skilld/${hasChangelog}`,
 		score: 3,
 		useFor: "Only for new patterns introduced in recent versions"
 	});
@@ -723,13 +724,14 @@ Content addressing the user's instructions above, using concise examples and sou
 		rules: [`- **Custom section "${heading}":** MAX ${maxLines(50, 80, enabledSectionCount)} lines, use \`## ${heading}\` heading`]
 	};
 }
-function apiSection({ hasReleases, hasChangelog, hasIssues, hasDiscussions, enabledSectionCount }) {
-	const referenceWeights = [{
+function apiSection({ hasReleases, hasChangelog, hasDocs, hasIssues, hasDiscussions, enabledSectionCount }) {
+	const referenceWeights = [];
+	if (hasDocs) referenceWeights.push({
 		name: "Docs",
 		path: "./.skilld/docs/",
 		score: 10,
 		useFor: "Primary source — scan all doc pages for export names"
-	}];
+	});
 	if (hasReleases) referenceWeights.push({
 		name: "Releases",
 		path: "./.skilld/releases/_INDEX.md",
@@ -738,7 +740,7 @@ function apiSection({ hasReleases, hasChangelog, hasIssues, hasDiscussions, enab
 	});
 	if (hasChangelog) referenceWeights.push({
 		name: "Changelog",
-		path: `./.skilld/pkg/${hasChangelog}`,
+		path: `./.skilld/${hasChangelog}`,
 		score: 5,
 		useFor: "New APIs added in recent versions"
 	});
@@ -815,7 +817,7 @@ function generateImportantBlock({ packageName, hasIssues, hasDiscussions, hasRel
 	const rows = [["Docs", hasShippedDocs ? `\`${skillDir}/.skilld/pkg/docs/\` or \`${skillDir}/.skilld/pkg/README.md\`` : docsType === "llms.txt" ? `\`${skillDir}/.skilld/docs/llms.txt\`` : docsType === "readme" ? `\`${skillDir}/.skilld/pkg/README.md\`` : `\`${skillDir}/.skilld/docs/\``], ["Package", `\`${skillDir}/.skilld/pkg/\``]];
 	if (hasIssues) rows.push(["Issues", `\`${skillDir}/.skilld/issues/\``]);
 	if (hasDiscussions) rows.push(["Discussions", `\`${skillDir}/.skilld/discussions/\``]);
-	if (hasChangelog) rows.push(["Changelog", `\`${skillDir}/.skilld/pkg/${hasChangelog}\``]);
+	if (hasChangelog) rows.push(["Changelog", `\`${skillDir}/.skilld/${hasChangelog}\``]);
 	if (hasReleases) rows.push(["Releases", `\`${skillDir}/.skilld/releases/\``]);
 	const table = [
 		"| Resource | Path |",
@@ -890,15 +892,18 @@ function buildSectionPrompt(opts) {
 		hasDiscussions,
 		hasReleases,
 		hasChangelog,
+		hasDocs: !!opts.docFiles?.some((f) => f.includes("/docs/")),
 		features: opts.features,
 		enabledSectionCount: opts.enabledSectionCount
 	}, customPrompt);
 	if (!sectionDef) return "";
 	const outputFile = SECTION_OUTPUT_FILES[section];
+	const packageRules = getPackageRules(packageName);
 	const rules = [
 		...sectionDef.rules ?? [],
 		"- Link to exact source file where you found info",
-		"- TypeScript only, Vue uses `<script setup lang=\"ts\">`",
+		"- TypeScript only",
+		...packageRules.map((r) => `- ${r}`),
 		"- Imperative voice (\"Use X\" not \"You should use X\")",
 		`- **NEVER fetch external URLs.** All information is in the local \`./.skilld/\` directory. Use Read, Glob${opts.features?.search !== false ? ", and `skilld search`" : ""} only.`,
 		"- **Do NOT use Task tool or spawn subagents.** Work directly.",
@@ -1342,7 +1347,7 @@ function buildArgs(model, skillDir, symlinkDirs) {
 		"-m",
 		model,
 		"--allowed-tools",
-		"read_file,write_file,glob_tool",
+		"read_file,write_file,glob_tool,list_directory,search_file_content",
 		"--include-directories",
 		skillDir,
 		...symlinkDirs.flatMap((d) => ["--include-directories", d])
@@ -1382,7 +1387,9 @@ const TOOL_VERBS = {
 	Bash: "Running",
 	read_file: "Reading",
 	glob_tool: "Searching",
-	write_file: "Writing"
+	write_file: "Writing",
+	list_directory: "Listing",
+	search_file_content: "Searching"
 };
 function createToolProgress(log) {
 	const pending = /* @__PURE__ */ new Map();