skilld 1.6.2 → 1.7.1

package/dist/_chunks/config.mjs

@@ -1,30 +1,122 @@
+import { n as yamlParseKV, r as yamlUnescape, t as yamlEscape } from "./yaml.mjs";
 import { homedir } from "node:os";
-import { join, resolve } from "pathe";
-const VALID_PKG_NAME = /^(?:@[a-z0-9][-a-z0-9._]*\/)?[a-z0-9][-a-z0-9._]*$/;
-const VALID_VERSION = /^[a-z0-9][-\w.+]*$/i;
-function getVersionKey(version) {
-	return version;
-}
-function getCacheKey(name, version) {
-	return `${name}@${getVersionKey(version)}`;
-}
-function getCacheDir(name, version) {
-	if (!VALID_PKG_NAME.test(name)) throw new Error(`Invalid package name: ${name}`);
-	if (!VALID_VERSION.test(version)) throw new Error(`Invalid version: ${version}`);
-	const dir = resolve(REFERENCES_DIR, getCacheKey(name, version));
-	if (!dir.startsWith(REFERENCES_DIR)) throw new Error(`Path traversal detected: ${dir}`);
-	return dir;
-}
-const CACHE_DIR = join(homedir(), ".skilld");
-const REFERENCES_DIR = join(CACHE_DIR, "references");
-const REPOS_DIR = join(CACHE_DIR, "repos");
-function getRepoCacheDir(owner, repo) {
-	if (owner.includes("..") || repo.includes("..") || owner.includes("/") || repo.includes("/")) throw new Error(`Invalid repo path: ${owner}/${repo}`);
-	return join(REPOS_DIR, owner, repo);
-}
-function getPackageDbPath(name, version) {
-	return join(REFERENCES_DIR, getCacheKey(name, version), "search.db");
-}
-export { getRepoCacheDir as a, getVersionKey as c, getPackageDbPath as i, REFERENCES_DIR as n, getCacheDir as o, REPOS_DIR as r, getCacheKey as s, CACHE_DIR as t };
+import { join } from "pathe";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+const defaultFeatures = {
+	search: true,
+	issues: true,
+	discussions: true,
+	releases: true
+};
+const CONFIG_DIR = join(homedir(), ".skilld");
+const CONFIG_PATH = join(CONFIG_DIR, "config.yaml");
+let configCache;
+function hasConfig() {
+	return existsSync(CONFIG_PATH);
+}
+function hasCompletedWizard() {
+	if (!existsSync(CONFIG_PATH)) return false;
+	const config = readConfig();
+	return config.features !== void 0 || config.model !== void 0 || config.skipLlm !== void 0;
+}
+function readConfig() {
+	if (configCache) return {
+		...configCache,
+		features: configCache.features ? { ...configCache.features } : void 0,
+		projects: configCache.projects ? [...configCache.projects] : void 0
+	};
+	if (!existsSync(CONFIG_PATH)) return {};
+	const content = readFileSync(CONFIG_PATH, "utf-8");
+	const config = {};
+	let inBlock = null;
+	const projects = [];
+	const features = {};
+	for (const line of content.split("\n")) {
+		if (line.startsWith("projects:")) {
+			inBlock = "projects";
+			continue;
+		}
+		if (line.startsWith("features:")) {
+			inBlock = "features";
+			continue;
+		}
+		if (inBlock === "projects") {
+			if (line.startsWith("  - ")) {
+				projects.push(yamlUnescape(line.slice(4)));
+				continue;
+			}
+			inBlock = null;
+		}
+		if (inBlock === "features") {
+			const m = line.match(/^ {2}(\w+):\s*(.+)/);
+			if (m) {
+				const key = m[1];
+				if (key in defaultFeatures) features[key] = m[2] === "true";
+				continue;
+			}
+			inBlock = null;
+		}
+		const kv = yamlParseKV(line);
+		if (!kv) continue;
+		const [key, value] = kv;
+		if (key === "model" && value) config.model = value;
+		if (key === "agent" && value) config.agent = value;
+		if (key === "skipLlm") config.skipLlm = value === "true";
+	}
+	if (projects.length > 0) config.projects = projects;
+	if (Object.keys(features).length > 0) config.features = {
+		...defaultFeatures,
+		...features
+	};
+	configCache = config;
+	return config;
+}
+function writeConfig(config) {
+	mkdirSync(CONFIG_DIR, {
+		recursive: true,
+		mode: 448
+	});
+	let yaml = "";
+	if (config.model) yaml += `model: ${config.model}\n`;
+	if (config.agent) yaml += `agent: ${config.agent}\n`;
+	if (config.skipLlm) yaml += `skipLlm: true\n`;
+	if (config.features) {
+		yaml += "features:\n";
+		for (const [k, v] of Object.entries(config.features)) yaml += `  ${k}: ${v}\n`;
+	}
+	if (config.projects?.length) {
+		yaml += "projects:\n";
+		for (const p of config.projects) yaml += `  - ${yamlEscape(p)}\n`;
+	}
+	writeFileSync(CONFIG_PATH, yaml, { mode: 384 });
+	configCache = void 0;
+}
+function updateConfig(updates) {
+	writeConfig({
+		...readConfig(),
+		...updates
+	});
+}
+function registerProject(projectPath) {
+	const config = readConfig();
+	const projects = new Set(config.projects || []);
+	projects.add(projectPath);
+	writeConfig({
+		...config,
+		projects: [...projects]
+	});
+}
+function unregisterProject(projectPath) {
+	const config = readConfig();
+	const projects = (config.projects || []).filter((p) => p !== projectPath);
+	writeConfig({
+		...config,
+		projects
+	});
+}
+function getRegisteredProjects() {
+	return readConfig().projects || [];
+}
+export { readConfig as a, updateConfig as c, hasConfig as i, getRegisteredProjects as n, registerProject as o, hasCompletedWizard as r, unregisterProject as s, defaultFeatures as t };
 
 //# sourceMappingURL=config.mjs.map

package/dist/_chunks/config.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"config.mjs","names":[],"sources":["../../src/cache/version.ts","../../src/cache/config.ts"],"sourcesContent":["/**\n * Version utilities\n */\n\nimport { resolve } from 'pathe'\nimport { REFERENCES_DIR } from './config.ts'\n\n/** Validate npm package name (scoped or unscoped) */\nconst VALID_PKG_NAME = /^(?:@[a-z0-9][-a-z0-9._]*\\/)?[a-z0-9][-a-z0-9._]*$/\n\n/** Validate version string (semver-ish, no path separators) */\nconst VALID_VERSION = /^[a-z0-9][-\\w.+]*$/i\n\n/**\n * Get exact version key for cache keying\n */\nexport function getVersionKey(version: string): string {\n  return version\n}\n\n/**\n * Get cache key for a package: name@version\n */\nexport function getCacheKey(name: string, version: string): string {\n  return `${name}@${getVersionKey(version)}`\n}\n\n/**\n * Get path to cached package references.\n * Validates name/version to prevent path traversal.\n */\nexport function getCacheDir(name: string, version: string): string {\n  if (!VALID_PKG_NAME.test(name))\n    throw new Error(`Invalid package name: ${name}`)\n  if (!VALID_VERSION.test(version))\n    throw new Error(`Invalid version: ${version}`)\n\n  const dir = resolve(REFERENCES_DIR, getCacheKey(name, version))\n  if (!dir.startsWith(REFERENCES_DIR))\n    throw new Error(`Path traversal detected: ${dir}`)\n  return dir\n}\n","/**\n * Cache configuration\n */\n\nimport { homedir } from 'node:os'\nimport { join } from 'pathe'\nimport { getCacheKey } from './version.ts'\n\n/** Global cache directory */\nexport const CACHE_DIR = join(homedir(), '.skilld')\n\n/** References subdirectory */\nexport const REFERENCES_DIR = join(CACHE_DIR, 'references')\n\n/** Repo-level cache (issues, discussions, releases shared across monorepo packages) */\nexport const REPOS_DIR = join(CACHE_DIR, 'repos')\n\n/** Get repo cache dir for owner/repo with path traversal validation */\nexport function getRepoCacheDir(owner: string, repo: string): string {\n  if (owner.includes('..') || repo.includes('..') || owner.includes('/') || repo.includes('/'))\n    throw new Error(`Invalid repo path: ${owner}/${repo}`)\n  return join(REPOS_DIR, owner, repo)\n}\n\n/** Get search DB path for a specific package@version */\nexport function getPackageDbPath(name: string, version: string): string {\n  return join(REFERENCES_DIR, getCacheKey(name, version), 'search.db')\n}\n"],"mappings":";;;AAQA,MAAM,gBAAA;AAGN,SAAM,cAAgB,SAAA;;;AAKtB,SAAgB,YAAA,MAAc,SAAyB;AACrD,QAAO,GAAA,KAAA,GAAA,cAAA,QAAA;;;;AAMT,KAAA,CAAA,cAAgB,KAAY,QAAc,CAAA,OAAyB,IAAA,MAAA,oBAAA,UAAA;CACjE,MAAA,MAAU,QAAQ,gBAAc,YAAQ,MAAA,QAAA,CAAA;;;;AAQxC,MAAK,YAAA,KAAe,SAClB,EAAA,UAAU;MAIZ,iBAAoB,KAAA,WAAgB,aAAY;AAGhD,MAAA,YAAO,KAAA,WAAA,QAAA;;;;;AC/BT,SAAa,iBAAiB,MAAS,SAAE;;;AAMzC,SAAa,mBAAiB,GAAA,iBAAmB,GAAA,oBAAA,GAAA,kBAAA,GAAA,eAAA,GAAA,aAAA,GAAA,eAAA,GAAA,aAAA"}
+{"version":3,"file":"config.mjs","names":[],"sources":["../../src/core/config.ts"],"sourcesContent":["import type { OptimizeModel } from '../agent/index.ts'\nimport { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs'\nimport { homedir } from 'node:os'\nimport { join } from 'pathe'\nimport { yamlEscape, yamlParseKV, yamlUnescape } from './yaml.ts'\n\nexport interface FeaturesConfig {\n  search: boolean\n  issues: boolean\n  discussions: boolean\n  releases: boolean\n}\n\nexport const defaultFeatures: FeaturesConfig = {\n  search: true,\n  issues: true,\n  discussions: true,\n  releases: true,\n}\n\nexport interface SkilldConfig {\n  model?: OptimizeModel\n  agent?: string\n  features?: FeaturesConfig\n  projects?: string[]\n  skipLlm?: boolean\n}\n\nconst CONFIG_DIR = join(homedir(), '.skilld')\nconst CONFIG_PATH = join(CONFIG_DIR, 'config.yaml')\n\nlet configCache: SkilldConfig | undefined\n\nexport function hasConfig(): boolean {\n  return existsSync(CONFIG_PATH)\n}\n\n/** Whether the first-run wizard has been completed (not just agent selection) */\nexport function hasCompletedWizard(): boolean {\n  if (!existsSync(CONFIG_PATH))\n    return false\n  const config = readConfig()\n  return config.features !== undefined || config.model !== undefined || config.skipLlm !== undefined\n}\n\nexport function readConfig(): SkilldConfig {\n  if (configCache) {\n    return {\n      ...configCache,\n      features: configCache.features ? { ...configCache.features } : undefined,\n      projects: configCache.projects ? [...configCache.projects] : undefined,\n    }\n  }\n  if (!existsSync(CONFIG_PATH))\n    return {}\n\n  const content = readFileSync(CONFIG_PATH, 'utf-8')\n  const config: SkilldConfig = {}\n  let inBlock: 'projects' | 'features' | null = null\n  const projects: string[] = []\n  const features: Partial<FeaturesConfig> = {}\n\n  for (const line of content.split('\\n')) {\n    if (line.startsWith('projects:')) {\n      inBlock = 'projects'\n      continue\n    }\n    if (line.startsWith('features:')) {\n      inBlock = 'features'\n      continue\n    }\n    if (inBlock === 'projects') {\n      if (line.startsWith('  - ')) {\n        projects.push(yamlUnescape(line.slice(4)))\n        continue\n      }\n      inBlock = null\n    }\n    if (inBlock === 'features') {\n      const m = line.match(/^ {2}(\\w+):\\s*(.+)/)\n      if (m) {\n        const key = m[1] as keyof FeaturesConfig\n        if (key in defaultFeatures)\n          features[key] = m[2] === 'true'\n        continue\n      }\n      inBlock = null\n    }\n    const kv = yamlParseKV(line)\n    if (!kv)\n      continue\n    const [key, value] = kv\n    if (key === 'model' && value)\n      config.model = value as OptimizeModel\n    if (key === 'agent' && value)\n      config.agent = value\n    if (key === 'skipLlm')\n      config.skipLlm = value === 'true'\n  }\n\n  if (projects.length > 0)\n    config.projects = projects\n  if (Object.keys(features).length > 0)\n    config.features = { ...defaultFeatures, ...features }\n  configCache = config\n  return config\n}\n\nexport function writeConfig(config: SkilldConfig): void {\n  mkdirSync(CONFIG_DIR, { recursive: true, mode: 0o700 })\n\n  let yaml = ''\n  if (config.model)\n    yaml += `model: ${config.model}\\n`\n  if (config.agent)\n    yaml += `agent: ${config.agent}\\n`\n  if (config.skipLlm)\n    yaml += `skipLlm: true\\n`\n  if (config.features) {\n    yaml += 'features:\\n'\n    for (const [k, v] of Object.entries(config.features)) {\n      yaml += `  ${k}: ${v}\\n`\n    }\n  }\n  if (config.projects?.length) {\n    yaml += 'projects:\\n'\n    for (const p of config.projects) {\n      yaml += `  - ${yamlEscape(p)}\\n`\n    }\n  }\n\n  writeFileSync(CONFIG_PATH, yaml, { mode: 0o600 })\n  configCache = undefined\n}\n\nexport function updateConfig(updates: Partial<SkilldConfig>): void {\n  const config = readConfig()\n  writeConfig({ ...config, ...updates })\n}\n\nexport function registerProject(projectPath: string): void {\n  const config = readConfig()\n  const projects = new Set(config.projects || [])\n  projects.add(projectPath)\n  writeConfig({ ...config, projects: [...projects] })\n}\n\nexport function unregisterProject(projectPath: string): void {\n  const config = readConfig()\n  const projects = (config.projects || []).filter(p => p !== projectPath)\n  writeConfig({ ...config, projects })\n}\n\nexport function getRegisteredProjects(): string[] {\n  return readConfig().projects || []\n}\n"],"mappings":"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"}

package/dist/_chunks/core.mjs

@@ -3,8 +3,8 @@ import "./sanitize.mjs";
 import "./yaml.mjs";
 import "./markdown.mjs";
 import "./shared.mjs";
-import "./cli-helpers.mjs";
+import "./skill.mjs";
+import "./config.mjs";
 import "./lockfile.mjs";
 import "./skills.mjs";
-import "./formatting.mjs";
 export {};

package/dist/_chunks/embedding-cache2.mjs

@@ -1,4 +1,4 @@
-import { t as CACHE_DIR } from "./config.mjs";
+import { i as CACHE_DIR } from "./version.mjs";
 import "./cache.mjs";
 import { join } from "pathe";
 import { rmSync } from "node:fs";

package/dist/_chunks/index.d.mts

@@ -43,6 +43,9 @@ declare function linkShippedSkill(baseDir: string, skillName: string, targetDir:
  * Check if package is cached at given version
  */
 declare function isCached(name: string, version: string): boolean;
+/** Check if cache only has docs/README.md (pkg/ already has this) */
+declare function isReadmeOnlyCache(cacheDir: string): boolean;
+declare function inferDocsTypeFromCache(cacheDir: string, source?: string): 'llms.txt' | 'readme' | 'docs';
 /**
  * Ensure cache directories exist
  */
@@ -144,5 +147,5 @@ declare function getCacheKey(name: string, version: string): string;
  * Validates name/version to prevent path traversal.
  */
 declare function getCacheDir(name: string, version: string): string;
-export { REPOS_DIR as A, linkShippedSkill as C, CachedPackage as D, CachedDoc as E, getRepoCacheDir as M, CACHE_DIR as O, getShippedSkills as S, CacheConfig as T, readCachedSection as _, clearCache as a, writeToRepoCache as b, hasShippedDocs as c, linkPkg as d, linkPkgNamed as f, readCachedDocs as g, listReferenceFiles as h, clearAllCache as i, getPackageDbPath as j, REFERENCES_DIR as k, isCached as l, listCached as m, getCacheKey as n, ensureCacheDir as o, linkRepoCachedDir as p, getVersionKey as r, getPkgKeyFiles as s, getCacheDir as t, linkCachedDir as u, writeSections as v, resolvePkgDir as w, ShippedSkill as x, writeToCache as y };
+export { CACHE_DIR as A, ShippedSkill as C, CacheConfig as D, resolvePkgDir as E, REPOS_DIR as M, getPackageDbPath as N, CachedDoc as O, getRepoCacheDir as P, writeToRepoCache as S, linkShippedSkill as T, listReferenceFiles as _, clearCache as a, writeSections as b, hasShippedDocs as c, isReadmeOnlyCache as d, linkCachedDir as f, listCached as g, linkRepoCachedDir as h, clearAllCache as i, REFERENCES_DIR as j, CachedPackage as k, inferDocsTypeFromCache as l, linkPkgNamed as m, getCacheKey as n, ensureCacheDir as o, linkPkg as p, getVersionKey as r, getPkgKeyFiles as s, getCacheDir as t, isCached as u, readCachedDocs as v, getShippedSkills as w, writeToCache as x, readCachedSection as y };
 //# sourceMappingURL=index.d.mts.map

package/dist/_chunks/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cache/config.ts","../../src/cache/types.ts","../../src/core/prepare.ts","../../src/cache/storage.ts","../../src/cache/version.ts"],"mappings":"AASA;;;;cAAa,SAAA;AAGb;AAAA,cAAa,cAAA;;cAGA,SAAA;;iBAGG,eAAA,CAAgB,KAAA,UAAe,IAAA;;iBAO/B,gBAAA,CAAiB,IAAA,UAAc,OAAA;AAhB/C;;;AAAA,UCLiB,WAAA;EDKkC;ECHjD,IAAA;EDMyD;ECJzD,OAAA;AAAA;AAAA,UAGe,aAAA;EACf,IAAA;EACA,OAAA;EACA,GAAA;AAAA;AAAA,UAGe,SAAA;EACf,IAAA;EACA,OAAA;AAAA;;iBCLc,aAAA,CAAc,IAAA,UAAc,GAAA,UAAa,OAAA;AAAA,UAiDxC,YAAA;EACf,SAAA;EACA,QAAA;AAAA;;iBAIc,gBAAA,CAAiB,IAAA,UAAc,GAAA,UAAa,OAAA,YAAmB,YAAA;;iBAe/D,gBAAA,CAAiB,OAAA,UAAiB,SAAA,UAAmB,SAAA;;AFxErE;;iBGmBgB,QAAA,CAAS,IAAA,UAAc,OAAA;;;AHhBvC;iBGuBgB,cAAA,CAAA;;;;iBAQA,YAAA,CACd,IAAA,UACA,OAAA,UACA,IAAA,EAAM,SAAA;;;;iBAiBQ,gBAAA,CACd,KAAA,UACA,IAAA,UACA,IAAA,EAAM,SAAA;AH5CR;;;;AAAA,iBG8DgB,iBAAA,CAAkB,QAAA,UAAkB,KAAA,UAAe,IAAA,UAAc,MAAA;;AFnFjF;;;;;AAOA;;;iBEkGgB,aAAA,CAAc,QAAA,UAAkB,IAAA,UAAc,OAAA,UAAiB,MAAA;;;;;AD/F/E;;;;iBC4HgB,OAAA,CAAQ,QAAA,UAAkB,IAAA,UAAc,GAAA,UAAa,OAAA;;;;;AD3ErE;;;iBCmGgB,YAAA,CAAa,QAAA,UAAkB,IAAA,UAAc,GAAA,UAAa,OAAA;;AD7F1E;;;iBCmHgB,cAAA,CAAe,IAAA,UAAc,GAAA,UAAa,OAAA;;;;;;;iBAuC1C,aAAA,CAAc,IAAA,UAAc,OAAA,UAAiB,QAAA,EAAU,KAAA;EAAQ,IAAA;EAAc,OAAA;AAAA;;;;iBAY7E,iBAAA,CAAkB,IAAA,UAAc,OAAA,UAAiB,IAAA;AAAA,iBAOjD,cAAA,CAAe,IAAA,UAAc,GAAA,UAAa,OAAA;;AAnN1D;;iBAoOgB,UAAA,CAAA,GAAc,aAAA;;;AA7N9B;iBA4OgB,cAAA,CAAe,IAAA,UAAc,OAAA,WAAkB,SAAA;;;;iBA+B/C,UAAA,CAAW,IAAA,UAAc,OAAA;;;;iBAYzB,aAAA,CAAA;;;;;iBAeA,kBAAA,CAAmB,QAAA,UAAkB,QAAA;AHnUrD;;;;;AAGA;iBIIgB,aAAA,CAAc,OAAA;;;;iBAOd,WAAA,CAAY,IAAA,UAAc,OAAA;;;;;iBAQ1B,WAAA,CAAY,IAAA,UAAc,OAAA"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/cache/config.ts","../../src/cache/types.ts","../../src/core/prepare.ts","../../src/cache/storage.ts","../../src/cache/version.ts"],"mappings":"AAQA;;;;cAAa,SAAA;AAGb;AAAA,cAAa,cAAA;;cAGA,SAAA;;iBAGG,eAAA,CAAgB,KAAA,UAAe,IAAA;;iBAO/B,gBAAA,CAAiB,IAAA,UAAc,OAAA;AAhB/C;;;AAAA,UCJiB,WAAA;EDIkC;ECFjD,IAAA;EDKyD;ECHzD,OAAA;AAAA;AAAA,UAGe,aAAA;EACf,IAAA;EACA,OAAA;EACA,GAAA;AAAA;AAAA,UAGe,SAAA;EACf,IAAA;EACA,OAAA;AAAA;;iBCEc,aAAA,CAAc,IAAA,UAAc,GAAA,UAAa,OAAA;AAAA,UAiDxC,YAAA;EACf,SAAA;EACA,QAAA;AAAA;;iBAIc,gBAAA,CAAiB,IAAA,UAAc,GAAA,UAAa,OAAA,YAAmB,YAAA;;iBAe/D,gBAAA,CAAiB,OAAA,UAAiB,SAAA,UAAmB,SAAA;;AFhFrE;;iBGoBgB,QAAA,CAAS,IAAA,UAAc,OAAA;;iBAKvB,iBAAA,CAAkB,QAAA;AAAA,iBAQlB,sBAAA,CAAuB,QAAA,UAAkB,MAAA;;;;iBASzC,cAAA,CAAA;AHpChB;;;AAAA,iBG4CgB,YAAA,CACd,IAAA,UACA,OAAA,UACA,IAAA,EAAM,SAAA;;AHxCR;;iBGyDgB,gBAAA,CACd,KAAA,UACA,IAAA,UACA,IAAA,EAAM,SAAA;;;;AFhFR;iBEkGgB,iBAAA,CAAkB,QAAA,UAAkB,KAAA,UAAe,IAAA,UAAc,MAAA;;;;AF3FjF;;;;;;iBEiHgB,aAAA,CAAc,QAAA,UAAkB,IAAA,UAAc,OAAA,UAAiB,MAAA;;ADvG/E;;;;;;;iBCoIgB,OAAA,CAAQ,QAAA,UAAkB,IAAA,UAAc,GAAA,UAAa,OAAA;;ADnFrE;;;;;AAMA;iBCqGgB,YAAA,CAAa,QAAA,UAAkB,IAAA,UAAc,GAAA,UAAa,OAAA;;;;;iBAsB1D,cAAA,CAAe,IAAA,UAAc,GAAA,UAAa,OAAA;;;;AD5G1D;;;iBCmJgB,aAAA,CAAc,IAAA,UAAc,OAAA,UAAiB,QAAA,EAAU,KAAA;EAAQ,IAAA;EAAc,OAAA;AAAA;;;;iBAY7E,iBAAA,CAAkB,IAAA,UAAc,OAAA,UAAiB,IAAA;AAAA,iBAOjD,cAAA,CAAe,IAAA,UAAc,GAAA,UAAa,OAAA;;;;iBAiB1C,UAAA,CAAA,GAAc,aAAA;;;;iBAed,cAAA,CAAe,IAAA,UAAc,OAAA,WAAkB,SAAA;AArP/D;;;AAAA,iBAoRgB,UAAA,CAAW,IAAA,UAAc,OAAA;;AA3QzC;;iBAuRgB,aAAA,CAAA;;;AA/QhB;;iBA8RgB,kBAAA,CAAmB,QAAA,UAAkB,QAAA;AHnVrD;;;;;AAGA;iBIKgB,aAAA,CAAc,OAAA;;;;iBAOd,WAAA,CAAY,IAAA,UAAc,OAAA;;;;;iBAQ1B,WAAA,CAAY,IAAA,UAAc,OAAA"}

package/dist/_chunks/index3.d.mts

@@ -9,6 +9,84 @@ interface CachedDoc$1 {
  * Returns CachedDoc[] with releases/blog-{version}.md files
  */
 declare function fetchBlogReleases(packageName: string, installedVersion: string): Promise<CachedDoc$1[]>;
+/**
+ * Doc resolver types
+ */
+interface NpmPackageInfo {
+  name: string;
+  version?: string;
+  description?: string;
+  homepage?: string;
+  repository?: string | {
+    type: string;
+    url: string;
+    directory?: string;
+  };
+  readme?: string;
+  dependencies?: Record<string, string>;
+  devDependencies?: Record<string, string>;
+  peerDependencies?: Record<string, string>;
+}
+interface ResolvedPackage {
+  name: string;
+  version?: string;
+  /** ISO date string when this version was released */
+  releasedAt?: string;
+  description?: string;
+  /** Production dependencies with version specifiers */
+  dependencies?: Record<string, string>;
+  /** npm dist-tags with version and release date */
+  distTags?: Record<string, {
+    version: string;
+    releasedAt?: string;
+  }>;
+  docsUrl?: string;
+  llmsUrl?: string;
+  readmeUrl?: string;
+  repoUrl?: string;
+  /** Git docs folder - versioned docs from repo */
+  gitDocsUrl?: string;
+  /** Git tag/ref used for gitDocsUrl */
+  gitRef?: string;
+  /** True when gitRef is a branch fallback (no version tag found) */
+  gitDocsFallback?: boolean;
+  /** URL pattern to crawl for docs */
+  crawlUrl?: string;
+}
+interface LocalDependency {
+  name: string;
+  version: string;
+}
+interface LlmsContent {
+  raw: string;
+  /** Markdown links extracted from llms.txt */
+  links: LlmsLink[];
+}
+interface LlmsLink {
+  title: string;
+  url: string;
+}
+interface FetchedDoc {
+  url: string;
+  title: string;
+  content: string;
+}
+interface ResolveAttempt {
+  source: 'npm' | 'crates' | 'github-docs' | 'github-meta' | 'github-search' | 'llms.txt' | 'readme';
+  url?: string;
+  status: 'success' | 'not-found' | 'error';
+  message?: string;
+}
+interface ResolveResult {
+  package: ResolvedPackage | null;
+  attempts: ResolveAttempt[];
+  /** npm registry version, available even when doc resolution fails */
+  registryVersion?: string;
+}
+declare function resolveCrateDocsWithAttempts(crateName: string, options?: {
+  version?: string;
+  onProgress?: (message: string) => void;
+}): Promise<ResolveResult>;
 /**
  * Website crawl doc source — fetches docs by crawling a URL pattern
  */
@@ -136,80 +214,6 @@ declare function parseSkillFrontmatterName(content: string): {
 declare function fetchGitSkills(source: GitSkillSource, onProgress?: (msg: string) => void): Promise<{
   skills: RemoteSkill[];
 }>;
-/**
- * Doc resolver types
- */
-interface NpmPackageInfo {
-  name: string;
-  version?: string;
-  description?: string;
-  homepage?: string;
-  repository?: string | {
-    type: string;
-    url: string;
-    directory?: string;
-  };
-  readme?: string;
-  dependencies?: Record<string, string>;
-  devDependencies?: Record<string, string>;
-  peerDependencies?: Record<string, string>;
-}
-interface ResolvedPackage {
-  name: string;
-  version?: string;
-  /** ISO date string when this version was released */
-  releasedAt?: string;
-  description?: string;
-  /** Production dependencies with version specifiers */
-  dependencies?: Record<string, string>;
-  /** npm dist-tags with version and release date */
-  distTags?: Record<string, {
-    version: string;
-    releasedAt?: string;
-  }>;
-  docsUrl?: string;
-  llmsUrl?: string;
-  readmeUrl?: string;
-  repoUrl?: string;
-  /** Git docs folder - versioned docs from repo */
-  gitDocsUrl?: string;
-  /** Git tag/ref used for gitDocsUrl */
-  gitRef?: string;
-  /** True when gitRef is a branch fallback (no version tag found) */
-  gitDocsFallback?: boolean;
-  /** URL pattern to crawl for docs */
-  crawlUrl?: string;
-}
-interface LocalDependency {
-  name: string;
-  version: string;
-}
-interface LlmsContent {
-  raw: string;
-  /** Markdown links extracted from llms.txt */
-  links: LlmsLink[];
-}
-interface LlmsLink {
-  title: string;
-  url: string;
-}
-interface FetchedDoc {
-  url: string;
-  title: string;
-  content: string;
-}
-interface ResolveAttempt {
-  source: 'npm' | 'github-docs' | 'github-meta' | 'github-search' | 'llms.txt' | 'readme';
-  url?: string;
-  status: 'success' | 'not-found' | 'error';
-  message?: string;
-}
-interface ResolveResult {
-  package: ResolvedPackage | null;
-  attempts: ResolveAttempt[];
-  /** npm registry version, available even when doc resolution fails */
-  registryVersion?: string;
-}
 /** Minimum git-doc file count to prefer over llms.txt */
 declare const MIN_GIT_DOCS = 5;
 /** True when git-docs exist but are too few to be useful (< MIN_GIT_DOCS) */
@@ -534,9 +538,6 @@ declare function generateReleaseIndex(releasesOrOpts: GitHubRelease[] | ReleaseI
  * 2. If no releases found, try CHANGELOG.md as fallback
  */
 declare function fetchReleaseNotes(owner: string, repo: string, installedVersion: string, gitRef?: string, packageName?: string, fromDate?: string, changelogRef?: string): Promise<CachedDoc[]>;
-/**
- * Shared utilities for doc resolution
- */
 declare const $fetch: _$ofetch.$Fetch;
 /**
  * Fetch text content from URL
@@ -566,6 +567,8 @@ declare function parseGitHubUrl(url: string): {
   owner: string;
   repo: string;
 } | null;
+/** Parse owner/repo slug from GitHub URL */
+declare function parseGitHubRepoSlug(url: string | undefined): string | undefined;
 /**
  * Normalize git repo URL to https
  */
@@ -582,5 +585,5 @@ declare function parsePackageSpec(spec: string): {
  * Extract branch hint from URL fragment (e.g. "git+https://...#main" → "main")
  */
 declare function extractBranchHint(url: string): string | undefined;
-export { formatIssueAsMarkdown as $, ResolveOptions as A, formatDiscussionAsMarkdown as At, resolveInstalledVersion as B, getDocOverride as C, parseGitSkillInput as Ct, getRepoEntry as D, generateDocsIndex as Dt, getRelatedPackages as E, resolveEntryFiles as Et, fetchPkgDist as F, downloadLlmsDocs as G, resolvePackageDocs as H, getInstalledSkillVersion as I, fetchLlmsUrl as J, extractSections as K, parseVersionSpecifier as L, fetchLatestVersion as M, fetchCrawledDocs as Mt, fetchNpmPackage as N, toCrawlPattern as Nt, getRepoKeyForPackage as O, GitHubDiscussion as Ot, fetchNpmRegistryMeta as P, fetchBlogReleases as Pt, fetchGitHubIssues as Q, readLocalDependencies as R, getCrawlUrl as S, fetchGitSkills as St, getPrereleaseChangelogRef as T, EntryFile as Tt, resolvePackageDocsWithAttempts as U, resolveLocalPackageDocs as V, searchNpmPackages as W, parseMarkdownLinks as X, normalizeLlmsLinks as Y, GitHubIssue as Z, parseSemver as _, ResolveAttempt as _t, isGitHubRepoUrl as a, fetchGitHubRepoMeta as at, DocOverride as b, GitSkillSource as bt, parsePackageSpec as c, filterFrameworkDocs as ct, ReleaseIndexOptions as d, validateGitDocsWithLlms as dt, generateIssueIndex as et, SemVer as f, FetchedDoc as ft, isPrerelease as g, NpmPackageInfo as gt, generateReleaseIndex as h, LocalDependency as ht, fetchText as i, fetchGitDocs as it, ResolveStep as j, generateDiscussionIndex as jt, LocalPackageInfo as k, fetchGitHubDiscussions as kt, verifyUrl as l, isShallowGitDocs as lt, fetchReleaseNotes as m, LlmsLink as mt, extractBranchHint as n, GitDocsResult as nt, normalizeRepoUrl as o, fetchReadme as ot, compareSemver as p, LlmsContent as pt, fetchLlmsTxt as q, fetchGitHubRaw as r, MIN_GIT_DOCS as rt, parseGitHubUrl as s, fetchReadmeContent as st, $fetch as t, isGhAvailable as tt, GitHubRelease as u, resolveGitHubRepo as ut, BlogPreset as v, ResolveResult as vt, getFilePatterns as w, parseSkillFrontmatterName as wt, getBlogPreset as x, RemoteSkill as xt, BlogRelease as y, ResolvedPackage as yt, readLocalPackageInfo as z };
+export { fetchGitHubIssues as $, LocalPackageInfo as A, LlmsLink as At, readLocalPackageInfo as B, getCrawlUrl as C, formatDiscussionAsMarkdown as Ct, getRelatedPackages as D, resolveCrateDocsWithAttempts as Dt, getPrereleaseChangelogRef as E, toCrawlPattern as Et, fetchNpmRegistryMeta as F, ResolvedPackage as Ft, searchNpmPackages as G, resolveLocalPackageDocs as H, fetchPkgDist as I, fetchBlogReleases as It, fetchLlmsTxt as J, downloadLlmsDocs as K, getInstalledSkillVersion as L, ResolveStep as M, NpmPackageInfo as Mt, fetchLatestVersion as N, ResolveAttempt as Nt, getRepoEntry as O, FetchedDoc as Ot, fetchNpmPackage as P, ResolveResult as Pt, GitHubIssue as Q, parseVersionSpecifier as R, getBlogPreset as S, fetchGitHubDiscussions as St, getFilePatterns as T, fetchCrawledDocs as Tt, resolvePackageDocs as U, resolveInstalledVersion as V, resolvePackageDocsWithAttempts as W, normalizeLlmsLinks as X, fetchLlmsUrl as Y, parseMarkdownLinks as Z, isPrerelease as _, parseSkillFrontmatterName as _t, isGitHubRepoUrl as a, fetchGitDocs as at, BlogRelease as b, generateDocsIndex as bt, parseGitHubUrl as c, fetchReadmeContent as ct, GitHubRelease as d, resolveGitHubRepo as dt, formatIssueAsMarkdown as et, ReleaseIndexOptions as f, validateGitDocsWithLlms as ft, generateReleaseIndex as g, parseGitSkillInput as gt, fetchReleaseNotes as h, fetchGitSkills as ht, fetchText as i, MIN_GIT_DOCS as it, ResolveOptions as j, LocalDependency as jt, getRepoKeyForPackage as k, LlmsContent as kt, parsePackageSpec as l, filterFrameworkDocs as lt, compareSemver as m, RemoteSkill as mt, extractBranchHint as n, isGhAvailable as nt, normalizeRepoUrl as o, fetchGitHubRepoMeta as ot, SemVer as p, GitSkillSource as pt, extractSections as q, fetchGitHubRaw as r, GitDocsResult as rt, parseGitHubRepoSlug as s, fetchReadme as st, $fetch as t, generateIssueIndex as tt, verifyUrl as u, isShallowGitDocs as ut, parseSemver as v, EntryFile as vt, getDocOverride as w, generateDiscussionIndex as wt, DocOverride as x, GitHubDiscussion as xt, BlogPreset as y, resolveEntryFiles as yt, readLocalDependencies as z };
 //# sourceMappingURL=index3.d.mts.map

package/dist/_chunks/index3.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index3.d.mts","names":[],"sources":["../../src/sources/blog-releases.ts","../../src/sources/crawl.ts","../../src/sources/discussions.ts","../../src/sources/docs.ts","../../src/sources/entries.ts","../../src/sources/git-skills.ts","../../src/sources/types.ts","../../src/sources/github.ts","../../src/sources/issues.ts","../../src/sources/llms.ts","../../src/sources/npm.ts","../../src/sources/package-registry.ts","../../src/sources/releases.ts","../../src/sources/utils.ts"],"mappings":"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"}
+{"version":3,"file":"index3.d.mts","names":[],"sources":["../../src/sources/blog-releases.ts","../../src/sources/types.ts","../../src/sources/crates.ts","../../src/sources/crawl.ts","../../src/sources/discussions.ts","../../src/sources/docs.ts","../../src/sources/entries.ts","../../src/sources/git-skills.ts","../../src/sources/github.ts","../../src/sources/issues.ts","../../src/sources/llms.ts","../../src/sources/npm.ts","../../src/sources/package-registry.ts","../../src/sources/releases.ts","../../src/sources/utils.ts"],"mappings":"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"}

package/dist/_chunks/install.mjs

@@ -1,17 +1,18 @@
-import { a as getRepoCacheDir, i as getPackageDbPath, o as getCacheDir } from "./config.mjs";
+import { a as getModelLabel, r as createToolProgress, s as optimizeDocs } from "./agent.mjs";
+import { c as getRepoCacheDir, s as getPackageDbPath, t as getCacheDir } from "./version.mjs";
 import { i as readPackageJsonSafe } from "./package-json.mjs";
 import { n as linkShippedSkill, r as resolvePkgDir, t as getShippedSkills } from "./prepare.mjs";
 import { n as sanitizeMarkdown } from "./sanitize.mjs";
-import { a as hasShippedDocs, f as listReferenceFiles, g as writeToCache, i as getPkgKeyFiles, l as linkPkgNamed, o as isCached, p as readCachedDocs, r as ensureCacheDir } from "./cache.mjs";
+import { a as hasShippedDocs, c as isReadmeOnlyCache, d as linkPkgNamed, h as readCachedDocs, i as getPkgKeyFiles, m as listReferenceFiles, o as inferDocsTypeFromCache, r as ensureCacheDir, s as isCached, v as writeToCache } from "./cache.mjs";
 import { r as createIndex, t as SearchDepsUnavailableError } from "./retriv.mjs";
 import { n as getSharedSkillsDir } from "./shared.mjs";
-import { C as downloadLlmsDocs, D as normalizeLlmsLinks, M as resolveEntryFiles, T as fetchLlmsTxt, Z as fetchGitHubRaw, b as isShallowGitDocs, d as resolvePackageDocs, h as fetchGitDocs, k as fetchGitSkills, tt as parseGitHubUrl, v as fetchReadmeContent, y as filterFrameworkDocs } from "./sources.mjs";
+import { A as filterFrameworkDocs, E as fetchGitDocs, I as fetchLlmsTxt, P as downloadLlmsDocs, Q as fetchGitHubRaw, R as normalizeLlmsLinks, _ as resolveEntryFiles, d as resolvePackageDocs, j as isShallowGitDocs, k as fetchReadmeContent, m as fetchGitSkills, rt as parseGitHubUrl } from "./sources.mjs";
 import { a as targets } from "./detect.mjs";
-import { i as linkSkillToAgents, t as generateSkillMd } from "./prompts.mjs";
-import { a as getModelLabel, r as createToolProgress, s as optimizeDocs } from "./agent.mjs";
-import { O as readConfig, _ as promptForAgent, b as resolveAgent, w as defaultFeatures, x as sharedArgs } from "./cli-helpers.mjs";
-import { i as readLock, n as parsePackages, o as syncLockfilesToDirs, s as writeLock, t as mergeLocks } from "./lockfile.mjs";
-import { l as timedSpinner } from "./formatting.mjs";
+import { _ as timedSpinner, n as writeGeneratedSkillMd, o as linkSkillToAgents, r as writeSkillMd } from "./skill.mjs";
+import { a as readConfig, t as defaultFeatures } from "./config.mjs";
+import { _ as promptForAgent, b as resolveAgent, x as sharedArgs } from "./cli-helpers.mjs";
+import { a as readLock, c as writeLock, n as parsePackageNames, r as parsePackages, s as syncLockfilesToDirs, t as mergeLocks } from "./lockfile.mjs";
+import { r as toStoragePackageName } from "./prefix.mjs";
 import { S as writePromptFiles, a as classifyCachedDoc, b as selectLlmConfig, g as indexResources } from "./sync-shared2.mjs";
 import { n as shutdownWorker } from "./pool2.mjs";
 import "./sync.mjs";
@@ -47,7 +48,7 @@ async function installCommand(opts) {
 		const skillDir = join(skillsDir, name);
 		const referencesPath = join(skillDir, ".skilld");
 		const skillMdPath = join(skillDir, "SKILL.md");
-		if (!existsSync(skillDir) || !existsSync(skillMdPath) || !existsSync(referencesPath) || hasStaleReferences(referencesPath, info.packageName || name, info.version, features)) toRestore.push({
+		if (!existsSync(skillDir) || !existsSync(skillMdPath) || !existsSync(referencesPath) || hasStaleReferences(referencesPath, toStoragePackageName(info.packageName || name), info.version, features)) toRestore.push({
 			name,
 			info
 		});
@@ -62,7 +63,7 @@ async function installCommand(opts) {
 	const regenerated = [];
 	for (const { name, info } of toRestore) {
 		const version = info.version;
-		const pkgName = info.packageName || unsanitizeName(name, info.source);
+		const pkgName = toStoragePackageName(info.packageName || unsanitizeName(name, info.source));
 		if (info.source === "shipped") {
 			const match = getShippedSkills(pkgName, cwd, version).find((s) => s.skillName === name);
 			if (match) {
@@ -85,7 +86,7 @@ async function installCommand(opts) {
 			if (match) {
 				const skillDir = join(skillsDir, name);
 				mkdirSync(skillDir, { recursive: true });
-				writeFileSync(join(skillDir, "SKILL.md"), sanitizeMarkdown(match.content));
+				writeSkillMd(skillDir, sanitizeMarkdown(match.content));
 				for (const f of match.files) {
 					const filePath = join(skillDir, f.path);
 					mkdirSync(dirname(filePath), { recursive: true });
@@ -105,7 +106,7 @@ async function installCommand(opts) {
 			mkdirSync(referencesPath, { recursive: true });
 			linkPkgSymlink(referencesPath, pkgName, cwd, version);
 			for (const pkg of parsePackages(info.packages)) linkPkgNamed(skillDir, pkg.name, cwd, pkg.version);
-			if (!pkgHasShippedDocs(pkgName, cwd, version) && !isReadmeOnly(globalCachePath)) {
+			if (!pkgHasShippedDocs(pkgName, cwd, version) && !isReadmeOnlyCache(globalCachePath)) {
 				const docsLink = join(referencesPath, "docs");
 				const cachedDocs = join(globalCachePath, "docs");
 				if (existsSync(docsLink)) unlinkSync(docsLink);
@@ -291,7 +292,7 @@ async function installCommand(opts) {
 			mkdirSync(referencesPath, { recursive: true });
 			linkPkgSymlink(referencesPath, pkgName, cwd, version);
 			for (const pkg of parsePackages(info.packages)) linkPkgNamed(skillDir, pkg.name, cwd, pkg.version);
-			if (!isReadmeOnly(globalCachePath)) {
+			if (!isReadmeOnlyCache(globalCachePath)) {
 				const docsLink = join(referencesPath, "docs");
 				const cachedDocsDir = join(globalCachePath, "docs");
 				if (existsSync(docsLink)) unlinkSync(docsLink);
@@ -391,12 +392,6 @@ function linkPkgSymlink(referencesDir, name, cwd, version) {
 	if (existsSync(pkgLink)) unlinkSync(pkgLink);
 	symlinkSync(pkgPath, pkgLink, "junction");
 }
-function isReadmeOnly(cacheDir) {
-	const docsDir = join(cacheDir, "docs");
-	if (!existsSync(docsDir)) return false;
-	const files = readdirSync(docsDir);
-	return files.length === 1 && files[0] === "README.md";
-}
 function pkgHasShippedDocs(name, cwd, version) {
 	const pkgPath = resolvePkgDir(name, cwd, version);
 	if (!pkgPath) return false;
@@ -442,12 +437,10 @@ async function enhanceRegenerated(pkgName, version, skillDir, model, sections, c
 			const pkgJsonResult = readPackageJsonSafe(join(pkgPath, "package.json"));
 			if (pkgJsonResult) description = pkgJsonResult.parsed.description;
 		}
-		let docsType = "docs";
-		if (existsSync(join(globalCachePath, "docs", "llms.txt"))) docsType = "llms.txt";
-		else if (isReadmeOnly(globalCachePath)) docsType = "readme";
+		const docsType = inferDocsTypeFromCache(globalCachePath);
 		const dirName = skillDir.split("/").pop();
-		const allPackages = parsePackages(packages).map((p) => ({ name: p.name }));
-		const skillMd = generateSkillMd({
+		const allPackages = parsePackageNames(packages);
+		writeGeneratedSkillMd(skillDir, {
 			name: pkgName,
 			version,
 			description,
@@ -463,7 +456,6 @@ async function enhanceRegenerated(pkgName, version, skillDir, model, sections, c
 			packages: allPackages.length > 1 ? allPackages : void 0,
 			features
 		});
-		writeFileSync(join(skillDir, "SKILL.md"), skillMd);
 	} else llmLog.message("Enhancement skipped");
 }
 const installCommandDef = defineCommand({
@@ -491,8 +483,7 @@ const installCommandDef = defineCommand({
 	}
 });
 function regenerateBaseSkillMd(skillDir, pkgName, version, cwd, allSkillNames, source, packages) {
-	const skillMdPath = join(skillDir, "SKILL.md");
-	if (existsSync(skillMdPath)) return false;
+	if (existsSync(join(skillDir, "SKILL.md"))) return false;
 	const pkgPath = resolvePkgDir(pkgName, cwd, version);
 	let description;
 	if (pkgPath) {
@@ -500,17 +491,16 @@ function regenerateBaseSkillMd(skillDir, pkgName, version, cwd, allSkillNames, s
 		if (pkgResult) description = pkgResult.parsed.description;
 	}
 	const globalCachePath = getCacheDir(pkgName, version);
-	let docsType = "docs";
-	if (source?.includes("llms.txt") || existsSync(join(globalCachePath, "docs", "llms.txt"))) docsType = "llms.txt";
-	else if (isReadmeOnly(globalCachePath)) docsType = "readme";
+	const docsType = inferDocsTypeFromCache(globalCachePath, source);
 	const feat = readConfig().features ?? defaultFeatures;
 	const hasIssues = feat.issues && existsSync(join(globalCachePath, "issues"));
 	const hasDiscussions = feat.discussions && existsSync(join(globalCachePath, "discussions"));
 	const hasReleases = feat.releases && existsSync(join(globalCachePath, "releases"));
 	const relatedSkills = allSkillNames.filter((n) => n !== pkgName);
 	const dirName = skillDir.split("/").pop();
-	const allPackages = parsePackages(packages).map((p) => ({ name: p.name }));
-	const content = generateSkillMd({
+	const allPackages = parsePackageNames(packages);
+	mkdirSync(skillDir, { recursive: true });
+	writeGeneratedSkillMd(skillDir, {
 		name: pkgName,
 		version,
 		description,
@@ -525,8 +515,6 @@ function regenerateBaseSkillMd(skillDir, pkgName, version, cwd, allSkillNames, s
 		packages: allPackages.length > 1 ? allPackages : void 0,
 		features: readConfig().features ?? defaultFeatures
 	});
-	mkdirSync(skillDir, { recursive: true });
-	writeFileSync(skillMdPath, content);
 	return true;
 }
 function hasStaleReferences(referencesPath, pkgName, version, features) {