skilld 0.10.1 → 0.11.0

package/dist/_chunks/yaml.mjs

@@ -1,445 +1,3 @@
-const REPO_REGISTRY = {
-	"vuejs/core": {
-		owner: "vuejs",
-		repo: "core",
-		docsRepo: "docs",
-		docsPath: "src",
-		homepage: "https://vuejs.org",
-		prereleaseChangelogRef: "minor",
-		packages: {
-			"vue": {
-				primary: true,
-				filePatterns: ["*.vue"],
-				rules: ["ALWAYS use `<script setup lang=\"ts\">`"]
-			},
-			"@vue/compiler-core": {},
-			"@vue/compiler-dom": {},
-			"@vue/reactivity": {},
-			"@vue/runtime-core": {},
-			"@vue/runtime-dom": {},
-			"@vue/shared": {}
-		},
-		blogReleases: [
-			{
-				version: "3.5",
-				url: "https://blog.vuejs.org/posts/vue-3-5",
-				date: "2024-09-01"
-			},
-			{
-				version: "3.4",
-				url: "https://blog.vuejs.org/posts/vue-3-4",
-				date: "2023-12-28"
-			},
-			{
-				version: "3.3",
-				url: "https://blog.vuejs.org/posts/vue-3-3",
-				date: "2023-05-11"
-			},
-			{
-				version: "3.2",
-				url: "https://blog.vuejs.org/posts/vue-3-2",
-				date: "2021-08-05"
-			},
-			{
-				version: "3.1",
-				url: "https://blog.vuejs.org/posts/vue-3-1",
-				date: "2021-06-07"
-			},
-			{
-				version: "3.0",
-				url: "https://blog.vuejs.org/posts/vue-3-0",
-				date: "2020-09-18"
-			}
-		]
-	},
-	"tailwindlabs/tailwindcss": {
-		owner: "tailwindlabs",
-		repo: "tailwindcss",
-		docsRepo: "tailwindcss.com",
-		docsPath: "src/docs",
-		homepage: "https://tailwindcss.com",
-		packages: { tailwindcss: { primary: true } }
-	},
-	"withastro/astro": {
-		owner: "withastro",
-		repo: "astro",
-		docsRepo: "docs",
-		docsPath: "src/content/docs/en",
-		homepage: "https://docs.astro.build",
-		packages: { astro: {
-			primary: true,
-			filePatterns: ["*.astro"]
-		} }
-	},
-	"vueuse/vueuse": {
-		owner: "vueuse",
-		repo: "vueuse",
-		docsPath: "packages",
-		packages: { "@vueuse/core": { primary: true } }
-	},
-	"sveltejs/svelte": {
-		owner: "sveltejs",
-		repo: "svelte",
-		packages: { svelte: {
-			primary: true,
-			filePatterns: ["*.svelte"],
-			rules: ["ALWAYS use runes syntax ($state, $derived, $effect, $props)"]
-		} }
-	},
-	"solidjs/solid": {
-		owner: "solidjs",
-		repo: "solid",
-		packages: { "solid-js": {
-			primary: true,
-			filePatterns: ["*.jsx", "*.tsx"]
-		} }
-	},
-	"QwikDev/qwik": {
-		owner: "QwikDev",
-		repo: "qwik",
-		packages: { qwik: {
-			primary: true,
-			filePatterns: ["*.tsx"]
-		} }
-	},
-	"marko-js/marko": {
-		owner: "marko-js",
-		repo: "marko",
-		packages: { marko: {
-			primary: true,
-			filePatterns: ["*.marko"]
-		} }
-	},
-	"riot/riot": {
-		owner: "riot",
-		repo: "riot",
-		packages: { riot: {
-			primary: true,
-			filePatterns: ["*.riot"]
-		} }
-	},
-	"microsoft/TypeScript": {
-		owner: "microsoft",
-		repo: "TypeScript",
-		packages: { typescript: {
-			primary: true,
-			filePatterns: [
-				"*.ts",
-				"*.tsx",
-				"*.mts",
-				"*.cts"
-			]
-		} },
-		blogReleases: [
-			{
-				version: "6.0",
-				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-6-0-beta/",
-				date: "2026-02-11",
-				title: "Announcing TypeScript 6.0 Beta"
-			},
-			{
-				version: "5.9",
-				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-9/",
-				date: "2025-08-01",
-				title: "Announcing TypeScript 5.9"
-			},
-			{
-				version: "5.8",
-				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-8/",
-				date: "2025-02-28",
-				title: "Announcing TypeScript 5.8"
-			},
-			{
-				version: "5.7",
-				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-7/",
-				date: "2024-11-22",
-				title: "Announcing TypeScript 5.7"
-			},
-			{
-				version: "5.6",
-				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-6/",
-				date: "2024-09-09",
-				title: "Announcing TypeScript 5.6"
-			},
-			{
-				version: "5.5",
-				url: "https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/",
-				date: "2024-06-20",
-				title: "Announcing TypeScript 5.5"
-			}
-		]
-	},
-	"jashkenas/coffeescript": {
-		owner: "jashkenas",
-		repo: "coffeescript",
-		packages: { coffeescript: {
-			primary: true,
-			filePatterns: ["*.coffee"]
-		} }
-	},
-	"gkz/LiveScript": {
-		owner: "gkz",
-		repo: "LiveScript",
-		packages: { livescript: {
-			primary: true,
-			filePatterns: ["*.ls"]
-		} }
-	},
-	"elm/compiler": {
-		owner: "elm",
-		repo: "compiler",
-		packages: { elm: {
-			primary: true,
-			filePatterns: ["*.elm"]
-		} }
-	},
-	"sass/dart-sass": {
-		owner: "sass",
-		repo: "dart-sass",
-		packages: { sass: {
-			primary: true,
-			filePatterns: ["*.scss", "*.sass"]
-		} }
-	},
-	"less/less.js": {
-		owner: "less",
-		repo: "less.js",
-		packages: { less: {
-			primary: true,
-			filePatterns: ["*.less"]
-		} }
-	},
-	"stylus/stylus": {
-		owner: "stylus",
-		repo: "stylus",
-		packages: { stylus: {
-			primary: true,
-			filePatterns: ["*.styl"]
-		} }
-	},
-	"postcss/postcss": {
-		owner: "postcss",
-		repo: "postcss",
-		packages: { postcss: {
-			primary: true,
-			filePatterns: ["*.css", "*.pcss"]
-		} }
-	},
-	"pugjs/pug": {
-		owner: "pugjs",
-		repo: "pug",
-		packages: { pug: {
-			primary: true,
-			filePatterns: ["*.pug"]
-		} }
-	},
-	"mde/ejs": {
-		owner: "mde",
-		repo: "ejs",
-		packages: { ejs: {
-			primary: true,
-			filePatterns: ["*.ejs"]
-		} }
-	},
-	"handlebars-lang/handlebars.js": {
-		owner: "handlebars-lang",
-		repo: "handlebars.js",
-		packages: { handlebars: {
-			primary: true,
-			filePatterns: ["*.hbs", "*.handlebars"]
-		} }
-	},
-	"janl/mustache.js": {
-		owner: "janl",
-		repo: "mustache.js",
-		packages: { mustache: {
-			primary: true,
-			filePatterns: ["*.mustache"]
-		} }
-	},
-	"mozilla/nunjucks": {
-		owner: "mozilla",
-		repo: "nunjucks",
-		packages: { nunjucks: {
-			primary: true,
-			filePatterns: ["*.njk"]
-		} }
-	},
-	"Shopify/liquid": {
-		owner: "Shopify",
-		repo: "liquid",
-		packages: { liquid: {
-			primary: true,
-			filePatterns: ["*.liquid"]
-		} }
-	},
-	"eemeli/yaml": {
-		owner: "eemeli",
-		repo: "yaml",
-		packages: { yaml: {
-			primary: true,
-			filePatterns: ["*.yaml", "*.yml"]
-		} }
-	},
-	"nodeca/js-yaml": {
-		owner: "nodeca",
-		repo: "js-yaml",
-		packages: { "js-yaml": {
-			primary: true,
-			filePatterns: ["*.yaml", "*.yml"]
-		} }
-	},
-	"BinaryMuse/toml-node": {
-		owner: "BinaryMuse",
-		repo: "toml-node",
-		packages: {
-			"toml": {
-				primary: true,
-				filePatterns: ["*.toml"]
-			},
-			"@iarna/toml": { filePatterns: ["*.toml"] }
-		}
-	},
-	"json5/json5": {
-		owner: "json5",
-		repo: "json5",
-		packages: { json5: {
-			primary: true,
-			filePatterns: ["*.json5"]
-		} }
-	},
-	"microsoft/node-jsonc-parser": {
-		owner: "microsoft",
-		repo: "node-jsonc-parser",
-		packages: { "jsonc-parser": {
-			primary: true,
-			filePatterns: ["*.jsonc"]
-		} }
-	},
-	"markdown-it/markdown-it": {
-		owner: "markdown-it",
-		repo: "markdown-it",
-		packages: { "markdown-it": {
-			primary: true,
-			filePatterns: ["*.md"]
-		} }
-	},
-	"markedjs/marked": {
-		owner: "markedjs",
-		repo: "marked",
-		packages: { marked: {
-			primary: true,
-			filePatterns: ["*.md"]
-		} }
-	},
-	"remarkjs/remark": {
-		owner: "remarkjs",
-		repo: "remark",
-		packages: { remark: {
-			primary: true,
-			filePatterns: ["*.md", "*.mdx"]
-		} }
-	},
-	"mdx-js/mdx": {
-		owner: "mdx-js",
-		repo: "mdx",
-		packages: { "@mdx-js/mdx": {
-			primary: true,
-			filePatterns: ["*.mdx"]
-		} }
-	},
-	"graphql/graphql-js": {
-		owner: "graphql",
-		repo: "graphql-js",
-		packages: {
-			"graphql": {
-				primary: true,
-				filePatterns: ["*.graphql", "*.gql"]
-			},
-			"graphql-tag": { filePatterns: ["*.graphql", "*.gql"] }
-		}
-	},
-	"dotansimha/graphql-code-generator": {
-		owner: "dotansimha",
-		repo: "graphql-code-generator",
-		packages: { "@graphql-codegen/cli": {
-			primary: true,
-			filePatterns: ["*.graphql", "*.gql"]
-		} }
-	},
-	"prisma/prisma": {
-		owner: "prisma",
-		repo: "prisma",
-		packages: {
-			"prisma": {
-				primary: true,
-				filePatterns: ["*.prisma"]
-			},
-			"@prisma/client": { filePatterns: ["*.prisma"] }
-		}
-	},
-	"nicolo-ribaudo/tc39-proposal-wasm-esm-integration": {
-		owner: "nicolo-ribaudo",
-		repo: "tc39-proposal-wasm-esm-integration",
-		packages: { "wasm-pack": {
-			primary: true,
-			filePatterns: ["*.wasm"]
-		} }
-	}
-};
-const PACKAGE_TO_REPO_MAP = {};
-for (const [repoKey, entry] of Object.entries(REPO_REGISTRY)) for (const packageName of Object.keys(entry.packages)) PACKAGE_TO_REPO_MAP[packageName] = repoKey;
-function getDocOverride(packageName) {
-	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
-	if (!repoKey) return void 0;
-	const entry = REPO_REGISTRY[repoKey];
-	if (!entry?.docsRepo && !entry?.docsPath) return void 0;
-	return {
-		owner: entry.owner,
-		repo: entry.docsRepo || entry.repo,
-		path: entry.docsPath || "",
-		ref: entry.docsRef,
-		homepage: entry.homepage
-	};
-}
-function getBlogPreset(packageName) {
-	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
-	if (!repoKey) return void 0;
-	const entry = REPO_REGISTRY[repoKey];
-	if (!entry?.blogReleases) return void 0;
-	return {
-		packageName,
-		releases: entry.blogReleases
-	};
-}
-function getFilePatterns(packageName) {
-	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
-	if (!repoKey) return void 0;
-	return REPO_REGISTRY[repoKey]?.packages[packageName]?.filePatterns;
-}
-function getRepoEntry(repoKey) {
-	return REPO_REGISTRY[repoKey];
-}
-function getRepoKeyForPackage(packageName) {
-	return PACKAGE_TO_REPO_MAP[packageName];
-}
-function getPackageRules(packageName) {
-	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
-	if (!repoKey) return [];
-	return REPO_REGISTRY[repoKey]?.packages[packageName]?.rules ?? [];
-}
-function getPrereleaseChangelogRef(packageName) {
-	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
-	if (!repoKey) return void 0;
-	return REPO_REGISTRY[repoKey]?.prereleaseChangelogRef;
-}
-function getRelatedPackages(packageName) {
-	const repoKey = PACKAGE_TO_REPO_MAP[packageName];
-	if (!repoKey) return [];
-	const entry = REPO_REGISTRY[repoKey];
-	if (!entry) return [];
-	return Object.keys(entry.packages);
-}
 const NEEDS_QUOTING = /[:"'\\\n\r\t#{}[\],&*!|>%@`]/;
 function yamlEscape(value) {
 	if (!NEEDS_QUOTING.test(value)) return value;
@@ -461,6 +19,6 @@ function yamlParseKV(line) {
 	if (!key) return null;
 	return [key, yamlUnescape(rawValue)];
 }
-export { getDocOverride as a, getPrereleaseChangelogRef as c, getRepoKeyForPackage as d, getBlogPreset as i, getRelatedPackages as l, yamlParseKV as n, getFilePatterns as o, yamlUnescape as r, getPackageRules as s, yamlEscape as t, getRepoEntry as u };
+export { yamlParseKV as n, yamlUnescape as r, yamlEscape as t };
 
 //# sourceMappingURL=yaml.mjs.map

package/dist/_chunks/yaml.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"yaml.mjs","names":[],"sources":["../../src/sources/package-registry.ts","../../src/core/yaml.ts"],"sourcesContent":["/**\n * Unified package registry — single source of truth for package metadata.\n * Consolidates doc overrides, blog presets, and file patterns.\n * Keyed by GitHub 'owner/repo' (source code repo).\n */\n\nexport interface BlogRelease {\n  version: string\n  url: string\n  date: string\n  title?: string\n}\n\nexport interface PackageEntry {\n  filePatterns?: string[]\n  primary?: boolean\n  /** Extra rules injected into skill generation prompts */\n  rules?: string[]\n}\n\nexport interface RepoEntry {\n  owner: string\n  repo: string\n  /** Separate docs repo name (e.g. 'docs' → owner/docs) */\n  docsRepo?: string\n  /** Path prefix to filter markdown files */\n  docsPath?: string\n  /** Branch/ref override */\n  docsRef?: string\n  /** Homepage URL */\n  homepage?: string\n  /** Branch to fetch CHANGELOG.md from when installed version is a prerelease (e.g. 'minor' for Vue) */\n  prereleaseChangelogRef?: string\n  /** Packages in this repo */\n  packages: Record<string, PackageEntry>\n  /** Curated blog release posts */\n  blogReleases?: BlogRelease[]\n}\n\n// Backwards-compatible types\nexport interface DocOverride {\n  owner: string\n  repo: string\n  path: string\n  ref?: string\n  homepage?: string\n}\n\nexport interface BlogPreset {\n  packageName: string\n  releases: BlogRelease[]\n}\n\n// ── Registry ──\n\nconst REPO_REGISTRY: Record<string, RepoEntry> = {\n  // ── Frameworks with doc overrides ──\n\n  'vuejs/core': {\n    owner: 'vuejs',\n    repo: 'core',\n    docsRepo: 'docs',\n    docsPath: 'src',\n    homepage: 'https://vuejs.org',\n    prereleaseChangelogRef: 'minor',\n    packages: {\n      'vue': { primary: true, filePatterns: ['*.vue'], rules: ['ALWAYS use `<script setup lang=\"ts\">`'] },\n      '@vue/compiler-core': {},\n      '@vue/compiler-dom': {},\n      '@vue/reactivity': {},\n      '@vue/runtime-core': {},\n      '@vue/runtime-dom': {},\n      '@vue/shared': {},\n    },\n    blogReleases: [\n      { version: '3.5', url: 'https://blog.vuejs.org/posts/vue-3-5', date: '2024-09-01' },\n      { version: '3.4', url: 'https://blog.vuejs.org/posts/vue-3-4', date: '2023-12-28' },\n      { version: '3.3', url: 'https://blog.vuejs.org/posts/vue-3-3', date: '2023-05-11' },\n      { version: '3.2', url: 'https://blog.vuejs.org/posts/vue-3-2', date: '2021-08-05' },\n      { version: '3.1', url: 'https://blog.vuejs.org/posts/vue-3-1', date: '2021-06-07' },\n      { version: '3.0', url: 'https://blog.vuejs.org/posts/vue-3-0', date: '2020-09-18' },\n    ],\n  },\n\n  'tailwindlabs/tailwindcss': {\n    owner: 'tailwindlabs',\n    repo: 'tailwindcss',\n    docsRepo: 'tailwindcss.com',\n    docsPath: 'src/docs',\n    homepage: 'https://tailwindcss.com',\n    packages: {\n      tailwindcss: { primary: true },\n    },\n  },\n\n  'withastro/astro': {\n    owner: 'withastro',\n    repo: 'astro',\n    docsRepo: 'docs',\n    docsPath: 'src/content/docs/en',\n    homepage: 'https://docs.astro.build',\n    packages: {\n      astro: { primary: true, filePatterns: ['*.astro'] },\n    },\n  },\n\n  'vueuse/vueuse': {\n    owner: 'vueuse',\n    repo: 'vueuse',\n    docsPath: 'packages',\n    packages: {\n      '@vueuse/core': { primary: true },\n    },\n  },\n\n  // ── Frameworks (file patterns only) ──\n\n  'sveltejs/svelte': {\n    owner: 'sveltejs',\n    repo: 'svelte',\n    packages: {\n      svelte: { primary: true, filePatterns: ['*.svelte'], rules: ['ALWAYS use runes syntax ($state, $derived, $effect, $props)'] },\n    },\n  },\n\n  'solidjs/solid': {\n    owner: 'solidjs',\n    repo: 'solid',\n    packages: {\n      'solid-js': { primary: true, filePatterns: ['*.jsx', '*.tsx'] },\n    },\n  },\n\n  'QwikDev/qwik': {\n    owner: 'QwikDev',\n    repo: 'qwik',\n    packages: {\n      qwik: { primary: true, filePatterns: ['*.tsx'] },\n    },\n  },\n\n  'marko-js/marko': {\n    owner: 'marko-js',\n    repo: 'marko',\n    packages: {\n      marko: { primary: true, filePatterns: ['*.marko'] },\n    },\n  },\n\n  'riot/riot': {\n    owner: 'riot',\n    repo: 'riot',\n    packages: {\n      riot: { primary: true, filePatterns: ['*.riot'] },\n    },\n  },\n\n  // ── Languages/transpilers ──\n\n  'microsoft/TypeScript': {\n    owner: 'microsoft',\n    repo: 'TypeScript',\n    packages: {\n      typescript: { primary: true, filePatterns: ['*.ts', '*.tsx', '*.mts', '*.cts'] },\n    },\n    blogReleases: [\n      { version: '6.0', url: 'https://devblogs.microsoft.com/typescript/announcing-typescript-6-0-beta/', date: '2026-02-11', title: 'Announcing TypeScript 6.0 Beta' },\n      { version: '5.9', url: 'https://devblogs.microsoft.com/typescript/announcing-typescript-5-9/', date: '2025-08-01', title: 'Announcing TypeScript 5.9' },\n      { version: '5.8', url: 'https://devblogs.microsoft.com/typescript/announcing-typescript-5-8/', date: '2025-02-28', title: 'Announcing TypeScript 5.8' },\n      { version: '5.7', url: 'https://devblogs.microsoft.com/typescript/announcing-typescript-5-7/', date: '2024-11-22', title: 'Announcing TypeScript 5.7' },\n      { version: '5.6', url: 'https://devblogs.microsoft.com/typescript/announcing-typescript-5-6/', date: '2024-09-09', title: 'Announcing TypeScript 5.6' },\n      { version: '5.5', url: 'https://devblogs.microsoft.com/typescript/announcing-typescript-5-5/', date: '2024-06-20', title: 'Announcing TypeScript 5.5' },\n    ],\n  },\n\n  'jashkenas/coffeescript': {\n    owner: 'jashkenas',\n    repo: 'coffeescript',\n    packages: {\n      coffeescript: { primary: true, filePatterns: ['*.coffee'] },\n    },\n  },\n\n  'gkz/LiveScript': {\n    owner: 'gkz',\n    repo: 'LiveScript',\n    packages: {\n      livescript: { primary: true, filePatterns: ['*.ls'] },\n    },\n  },\n\n  'elm/compiler': {\n    owner: 'elm',\n    repo: 'compiler',\n    packages: {\n      elm: { primary: true, filePatterns: ['*.elm'] },\n    },\n  },\n\n  // ── CSS preprocessors ──\n\n  'sass/dart-sass': {\n    owner: 'sass',\n    repo: 'dart-sass',\n    packages: {\n      sass: { primary: true, filePatterns: ['*.scss', '*.sass'] },\n    },\n  },\n\n  'less/less.js': {\n    owner: 'less',\n    repo: 'less.js',\n    packages: {\n      less: { primary: true, filePatterns: ['*.less'] },\n    },\n  },\n\n  'stylus/stylus': {\n    owner: 'stylus',\n    repo: 'stylus',\n    packages: {\n      stylus: { primary: true, filePatterns: ['*.styl'] },\n    },\n  },\n\n  'postcss/postcss': {\n    owner: 'postcss',\n    repo: 'postcss',\n    packages: {\n      postcss: { primary: true, filePatterns: ['*.css', '*.pcss'] },\n    },\n  },\n\n  // ── Template engines ──\n\n  'pugjs/pug': {\n    owner: 'pugjs',\n    repo: 'pug',\n    packages: {\n      pug: { primary: true, filePatterns: ['*.pug'] },\n    },\n  },\n\n  'mde/ejs': {\n    owner: 'mde',\n    repo: 'ejs',\n    packages: {\n      ejs: { primary: true, filePatterns: ['*.ejs'] },\n    },\n  },\n\n  'handlebars-lang/handlebars.js': {\n    owner: 'handlebars-lang',\n    repo: 'handlebars.js',\n    packages: {\n      handlebars: { primary: true, filePatterns: ['*.hbs', '*.handlebars'] },\n    },\n  },\n\n  'janl/mustache.js': {\n    owner: 'janl',\n    repo: 'mustache.js',\n    packages: {\n      mustache: { primary: true, filePatterns: ['*.mustache'] },\n    },\n  },\n\n  'mozilla/nunjucks': {\n    owner: 'mozilla',\n    repo: 'nunjucks',\n    packages: {\n      nunjucks: { primary: true, filePatterns: ['*.njk'] },\n    },\n  },\n\n  'Shopify/liquid': {\n    owner: 'Shopify',\n    repo: 'liquid',\n    packages: {\n      liquid: { primary: true, filePatterns: ['*.liquid'] },\n    },\n  },\n\n  // ── Data formats ──\n\n  'eemeli/yaml': {\n    owner: 'eemeli',\n    repo: 'yaml',\n    packages: {\n      yaml: { primary: true, filePatterns: ['*.yaml', '*.yml'] },\n    },\n  },\n\n  'nodeca/js-yaml': {\n    owner: 'nodeca',\n    repo: 'js-yaml',\n    packages: {\n      'js-yaml': { primary: true, filePatterns: ['*.yaml', '*.yml'] },\n    },\n  },\n\n  'BinaryMuse/toml-node': {\n    owner: 'BinaryMuse',\n    repo: 'toml-node',\n    packages: {\n      'toml': { primary: true, filePatterns: ['*.toml'] },\n      '@iarna/toml': { filePatterns: ['*.toml'] },\n    },\n  },\n\n  'json5/json5': {\n    owner: 'json5',\n    repo: 'json5',\n    packages: {\n      json5: { primary: true, filePatterns: ['*.json5'] },\n    },\n  },\n\n  'microsoft/node-jsonc-parser': {\n    owner: 'microsoft',\n    repo: 'node-jsonc-parser',\n    packages: {\n      'jsonc-parser': { primary: true, filePatterns: ['*.jsonc'] },\n    },\n  },\n\n  // ── Markdown ──\n\n  'markdown-it/markdown-it': {\n    owner: 'markdown-it',\n    repo: 'markdown-it',\n    packages: {\n      'markdown-it': { primary: true, filePatterns: ['*.md'] },\n    },\n  },\n\n  'markedjs/marked': {\n    owner: 'markedjs',\n    repo: 'marked',\n    packages: {\n      marked: { primary: true, filePatterns: ['*.md'] },\n    },\n  },\n\n  'remarkjs/remark': {\n    owner: 'remarkjs',\n    repo: 'remark',\n    packages: {\n      remark: { primary: true, filePatterns: ['*.md', '*.mdx'] },\n    },\n  },\n\n  'mdx-js/mdx': {\n    owner: 'mdx-js',\n    repo: 'mdx',\n    packages: {\n      '@mdx-js/mdx': { primary: true, filePatterns: ['*.mdx'] },\n    },\n  },\n\n  // ── GraphQL ──\n\n  'graphql/graphql-js': {\n    owner: 'graphql',\n    repo: 'graphql-js',\n    packages: {\n      'graphql': { primary: true, filePatterns: ['*.graphql', '*.gql'] },\n      'graphql-tag': { filePatterns: ['*.graphql', '*.gql'] },\n    },\n  },\n\n  'dotansimha/graphql-code-generator': {\n    owner: 'dotansimha',\n    repo: 'graphql-code-generator',\n    packages: {\n      '@graphql-codegen/cli': { primary: true, filePatterns: ['*.graphql', '*.gql'] },\n    },\n  },\n\n  // ── Other ──\n\n  'prisma/prisma': {\n    owner: 'prisma',\n    repo: 'prisma',\n    packages: {\n      'prisma': { primary: true, filePatterns: ['*.prisma'] },\n      '@prisma/client': { filePatterns: ['*.prisma'] },\n    },\n  },\n\n  'nicolo-ribaudo/tc39-proposal-wasm-esm-integration': {\n    owner: 'nicolo-ribaudo',\n    repo: 'tc39-proposal-wasm-esm-integration',\n    packages: {\n      'wasm-pack': { primary: true, filePatterns: ['*.wasm'] },\n    },\n  },\n}\n\n// ── Reverse index (auto-generated) ──\n\nconst PACKAGE_TO_REPO_MAP: Record<string, string> = {}\n\nfor (const [repoKey, entry] of Object.entries(REPO_REGISTRY)) {\n  for (const packageName of Object.keys(entry.packages)) {\n    PACKAGE_TO_REPO_MAP[packageName] = repoKey\n  }\n}\n\n// ── Backwards-compatible helpers ──\n\nexport function getDocOverride(packageName: string): DocOverride | undefined {\n  const repoKey = PACKAGE_TO_REPO_MAP[packageName]\n  if (!repoKey)\n    return undefined\n  const entry = REPO_REGISTRY[repoKey]\n  if (!entry?.docsRepo && !entry?.docsPath)\n    return undefined\n\n  return {\n    owner: entry.owner,\n    repo: entry.docsRepo || entry.repo,\n    path: entry.docsPath || '',\n    ref: entry.docsRef,\n    homepage: entry.homepage,\n  }\n}\n\nexport function getBlogPreset(packageName: string): BlogPreset | undefined {\n  const repoKey = PACKAGE_TO_REPO_MAP[packageName]\n  if (!repoKey)\n    return undefined\n  const entry = REPO_REGISTRY[repoKey]\n  if (!entry?.blogReleases)\n    return undefined\n\n  return {\n    packageName,\n    releases: entry.blogReleases,\n  }\n}\n\nexport function getFilePatterns(packageName: string): string[] | undefined {\n  const repoKey = PACKAGE_TO_REPO_MAP[packageName]\n  if (!repoKey)\n    return undefined\n  return REPO_REGISTRY[repoKey]?.packages[packageName]?.filePatterns\n}\n\n// ── New APIs ──\n\nexport function getRepoEntry(repoKey: string): RepoEntry | undefined {\n  return REPO_REGISTRY[repoKey]\n}\n\nexport function getRepoKeyForPackage(packageName: string): string | undefined {\n  return PACKAGE_TO_REPO_MAP[packageName]\n}\n\nexport function getPackageRules(packageName: string): string[] {\n  const repoKey = PACKAGE_TO_REPO_MAP[packageName]\n  if (!repoKey)\n    return []\n  return REPO_REGISTRY[repoKey]?.packages[packageName]?.rules ?? []\n}\n\nexport function getPrereleaseChangelogRef(packageName: string): string | undefined {\n  const repoKey = PACKAGE_TO_REPO_MAP[packageName]\n  if (!repoKey)\n    return undefined\n  return REPO_REGISTRY[repoKey]?.prereleaseChangelogRef\n}\n\nexport function getRelatedPackages(packageName: string): string[] {\n  const repoKey = PACKAGE_TO_REPO_MAP[packageName]\n  if (!repoKey)\n    return []\n  const entry = REPO_REGISTRY[repoKey]\n  if (!entry)\n    return []\n  return Object.keys(entry.packages)\n}\n","/**\n * Minimal YAML value escaping/unescaping for our hand-rolled parsers.\n *\n * Handles the characters that break naive `:` splitting and quote stripping:\n * colons, quotes, newlines, backslashes.\n */\n\n/** Characters that require double-quoting in YAML values */\nconst NEEDS_QUOTING = /[:\"'\\\\\\n\\r\\t#{}[\\],&*!|>%@`]/\n\n/**\n * Escape a value for safe YAML emission. Always double-quotes if the value\n * contains any special characters; returns unquoted for simple values.\n */\nexport function yamlEscape(value: string): string {\n  if (!NEEDS_QUOTING.test(value))\n    return value\n  // Escape backslashes first, then double quotes, then control chars\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t')\n  return `\"${escaped}\"`\n}\n\n/**\n * Parse a raw YAML value string back to its actual value.\n * Handles double-quoted (with escapes), single-quoted, and unquoted values.\n */\nexport function yamlUnescape(raw: string): string {\n  const trimmed = raw.trim()\n  if (!trimmed)\n    return ''\n\n  // Double-quoted: process escape sequences\n  if (trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return trimmed.slice(1, -1)\n      .replace(/\\\\n/g, '\\n')\n      .replace(/\\\\r/g, '\\r')\n      .replace(/\\\\t/g, '\\t')\n      .replace(/\\\\\"/g, '\"')\n      .replace(/\\\\\\\\/g, '\\\\')\n  }\n\n  // Single-quoted: no escape processing, just strip quotes\n  if (trimmed.startsWith('\\'') && trimmed.endsWith('\\''))\n    return trimmed.slice(1, -1)\n\n  return trimmed\n}\n\n/**\n * Parse a YAML `key: value` line, correctly handling colons inside quoted values.\n * Returns [key, value] or null if not a valid KV line.\n */\nexport function yamlParseKV(line: string): [string, string] | null {\n  const trimmed = line.trim()\n  // Find the first `: ` or `:\\n` or `:$` — the YAML key-value separator\n  const colonIdx = trimmed.indexOf(':')\n  if (colonIdx === -1)\n    return null\n  const key = trimmed.slice(0, colonIdx).trim()\n  const rawValue = trimmed.slice(colonIdx + 1)\n  if (!key)\n    return null\n  return [key, yamlUnescape(rawValue)]\n}\n"],"mappings":"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"}
+{"version":3,"file":"yaml.mjs","names":[],"sources":["../../src/core/yaml.ts"],"sourcesContent":["/**\n * Minimal YAML value escaping/unescaping for our hand-rolled parsers.\n *\n * Handles the characters that break naive `:` splitting and quote stripping:\n * colons, quotes, newlines, backslashes.\n */\n\n/** Characters that require double-quoting in YAML values */\nconst NEEDS_QUOTING = /[:\"'\\\\\\n\\r\\t#{}[\\],&*!|>%@`]/\n\n/**\n * Escape a value for safe YAML emission. Always double-quotes if the value\n * contains any special characters; returns unquoted for simple values.\n */\nexport function yamlEscape(value: string): string {\n  if (!NEEDS_QUOTING.test(value))\n    return value\n  // Escape backslashes first, then double quotes, then control chars\n  const escaped = value\n    .replace(/\\\\/g, '\\\\\\\\')\n    .replace(/\"/g, '\\\\\"')\n    .replace(/\\n/g, '\\\\n')\n    .replace(/\\r/g, '\\\\r')\n    .replace(/\\t/g, '\\\\t')\n  return `\"${escaped}\"`\n}\n\n/**\n * Parse a raw YAML value string back to its actual value.\n * Handles double-quoted (with escapes), single-quoted, and unquoted values.\n */\nexport function yamlUnescape(raw: string): string {\n  const trimmed = raw.trim()\n  if (!trimmed)\n    return ''\n\n  // Double-quoted: process escape sequences\n  if (trimmed.startsWith('\"') && trimmed.endsWith('\"')) {\n    return trimmed.slice(1, -1)\n      .replace(/\\\\n/g, '\\n')\n      .replace(/\\\\r/g, '\\r')\n      .replace(/\\\\t/g, '\\t')\n      .replace(/\\\\\"/g, '\"')\n      .replace(/\\\\\\\\/g, '\\\\')\n  }\n\n  // Single-quoted: no escape processing, just strip quotes\n  if (trimmed.startsWith('\\'') && trimmed.endsWith('\\''))\n    return trimmed.slice(1, -1)\n\n  return trimmed\n}\n\n/**\n * Parse a YAML `key: value` line, correctly handling colons inside quoted values.\n * Returns [key, value] or null if not a valid KV line.\n */\nexport function yamlParseKV(line: string): [string, string] | null {\n  const trimmed = line.trim()\n  // Find the first `: ` or `:\\n` or `:$` — the YAML key-value separator\n  const colonIdx = trimmed.indexOf(':')\n  if (colonIdx === -1)\n    return null\n  const key = trimmed.slice(0, colonIdx).trim()\n  const rawValue = trimmed.slice(colonIdx + 1)\n  if (!key)\n    return null\n  return [key, yamlUnescape(rawValue)]\n}\n"],"mappings":"AAQA,MAAM,gBAAgB;AAMtB,SAAgB,WAAW,OAAuB;AAChD,KAAI,CAAC,cAAc,KAAK,MAAM,CAC5B,QAAO;AAQT,QAAO,IANS,MACb,QAAQ,OAAO,OAAO,CACtB,QAAQ,MAAM,OAAM,CACpB,QAAQ,OAAO,MAAM,CACrB,QAAQ,OAAO,MAAM,CACrB,QAAQ,OAAO,MAAM,CACL;;AAOrB,SAAgB,aAAa,KAAqB;CAChD,MAAM,UAAU,IAAI,MAAM;AAC1B,KAAI,CAAC,QACH,QAAO;AAGT,KAAI,QAAQ,WAAW,KAAI,IAAI,QAAQ,SAAS,KAAI,CAClD,QAAO,QAAQ,MAAM,GAAG,GAAG,CACxB,QAAQ,QAAQ,KAAK,CACrB,QAAQ,QAAQ,KAAK,CACrB,QAAQ,QAAQ,IAAK,CACrB,QAAQ,QAAQ,KAAI,CACpB,QAAQ,SAAS,KAAK;AAI3B,KAAI,QAAQ,WAAW,IAAK,IAAI,QAAQ,SAAS,IAAK,CACpD,QAAO,QAAQ,MAAM,GAAG,GAAG;AAE7B,QAAO;;AAOT,SAAgB,YAAY,MAAuC;CACjE,MAAM,UAAU,KAAK,MAAM;CAE3B,MAAM,WAAW,QAAQ,QAAQ,IAAI;AACrC,KAAI,aAAa,GACf,QAAO;CACT,MAAM,MAAM,QAAQ,MAAM,GAAG,SAAS,CAAC,MAAM;CAC7C,MAAM,WAAW,QAAQ,MAAM,WAAW,EAAE;AAC5C,KAAI,CAAC,IACH,QAAO;AACT,QAAO,CAAC,KAAK,aAAa,SAAS,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/core/config.ts","../../src/agent/prompts/optional/types.ts","../../src/agent/prompts/prompt.ts","../../src/agent/prompts/skill.ts","../../src/agent/types.ts","../../src/agent/clis/types.ts","../../src/agent/clis/index.ts","../../src/agent/detect-imports.ts","../../src/agent/detect.ts","../../src/agent/install.ts","../../src/agent/targets/types.ts","../../src/agent/targets/registry.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/core/config.ts","../../src/agent/prompts/optional/types.ts","../../src/agent/prompts/prompt.ts","../../src/agent/prompts/skill.ts","../../src/agent/types.ts","../../src/agent/clis/types.ts","../../src/agent/clis/index.ts","../../src/agent/detect-imports.ts","../../src/agent/detect.ts","../../src/agent/install.ts","../../src/agent/targets/types.ts","../../src/agent/targets/registry.ts"],"mappings":"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"}

package/dist/agent/index.mjs

@@ -1,6 +1,6 @@
 import "../_chunks/chunk.mjs";
 import "../_chunks/config.mjs";
 import "../_chunks/storage.mjs";
-import "../_chunks/yaml.mjs";
+import "../_chunks/package-registry.mjs";
 import { S as targets, a as getModelName, b as detectTargetAgent, c as computeSkillDirName, d as sanitizeName, f as unlinkSkillFromAgents, g as buildSectionPrompt, h as buildAllSectionPrompts, i as getModelLabel, l as installSkillForAgents, m as SECTION_OUTPUT_FILES, n as createToolProgress, o as optimizeDocs, p as SECTION_MERGE_ORDER, r as getAvailableModels, s as generateSkillMd, t as detectImportedPackages, u as linkSkillToAgents, x as getAgentVersion, y as detectInstalledAgents } from "../_chunks/detect-imports.mjs";
 export { SECTION_MERGE_ORDER, SECTION_OUTPUT_FILES, targets as agents, buildAllSectionPrompts, buildSectionPrompt, computeSkillDirName, createToolProgress, detectImportedPackages, detectInstalledAgents, detectTargetAgent, generateSkillMd, getAgentVersion, getAvailableModels, getModelLabel, getModelName, installSkillForAgents, linkSkillToAgents, optimizeDocs, sanitizeName, unlinkSkillFromAgents };

package/dist/cli.mjs

@@ -3,10 +3,12 @@ import { t as __exportAll } from "./_chunks/chunk.mjs";
 import { i as getCacheDir, n as REFERENCES_DIR, o as getVersionKey, r as getPackageDbPath, t as CACHE_DIR } from "./_chunks/config.mjs";
 import { a as getShippedSkills, b as sanitizeMarkdown, c as linkCachedDir, d as linkShippedSkill, g as resolvePkgDir, i as getPkgKeyFiles, l as linkPkg, m as readCachedDocs, n as clearCache, o as hasShippedDocs, p as listReferenceFiles, r as ensureCacheDir, s as isCached, u as linkPkgNamed, v as writeToCache } from "./_chunks/storage.mjs";
 import "./cache/index.mjs";
+import { n as yamlParseKV, r as yamlUnescape, t as yamlEscape } from "./_chunks/yaml.mjs";
+import { i as parseFrontmatter } from "./_chunks/markdown.mjs";
 import { n as clearEmbeddingCache } from "./_chunks/embedding-cache.mjs";
 import { closePool, createIndex, openPool, searchPooled, searchSnippets } from "./retriv/index.mjs";
-import { c as getPrereleaseChangelogRef, i as getBlogPreset, n as yamlParseKV, r as yamlUnescape, t as yamlEscape } from "./_chunks/yaml.mjs";
-import { $ as SHARED_SKILLS_DIR, E as normalizeLlmsLinks, F as fetchBlogReleases, K as parseGitHubUrl, L as fetchReleaseNotes, M as fetchGitHubDiscussions, N as formatDiscussionAsMarkdown, O as fetchGitSkills, P as generateDiscussionIndex, Q as isGhAvailable, R as generateReleaseIndex, S as downloadLlmsDocs, V as $fetch, X as formatIssueAsMarkdown, Y as fetchGitHubIssues, Z as generateIssueIndex, b as resolveGitHubRepo, d as resolvePackageDocs, et as getSharedSkillsDir, f as resolvePackageDocsWithAttempts, h as fetchGitDocs, i as fetchPkgDist, j as resolveEntryFiles, k as parseGitSkillInput, n as fetchNpmPackage, nt as semverGt, p as searchNpmPackages, q as parsePackageSpec, r as fetchNpmRegistryMeta, s as readLocalDependencies, t as fetchLatestVersion, tt as mapInsert, u as resolveLocalPackageDocs, v as fetchReadmeContent, w as fetchLlmsTxt, y as isShallowGitDocs, z as isPrerelease } from "./_chunks/npm.mjs";
+import { a as getPrereleaseChangelogRef, t as getBlogPreset } from "./_chunks/package-registry.mjs";
+import { $ as isGhAvailable, B as isPrerelease, E as normalizeLlmsLinks, F as generateDiscussionIndex, H as $fetch, I as fetchBlogReleases, J as parsePackageSpec, M as generateDocsIndex, N as fetchGitHubDiscussions, O as fetchGitSkills, P as formatDiscussionAsMarkdown, Q as generateIssueIndex, R as fetchReleaseNotes, S as downloadLlmsDocs, X as fetchGitHubIssues, Z as formatIssueAsMarkdown, b as resolveGitHubRepo, d as resolvePackageDocs, et as SHARED_SKILLS_DIR, f as resolvePackageDocsWithAttempts, h as fetchGitDocs, i as fetchPkgDist, j as resolveEntryFiles, k as parseGitSkillInput, n as fetchNpmPackage, nt as mapInsert, p as searchNpmPackages, q as parseGitHubUrl, r as fetchNpmRegistryMeta, rt as semverGt, s as readLocalDependencies, t as fetchLatestVersion, tt as getSharedSkillsDir, u as resolveLocalPackageDocs, v as fetchReadmeContent, w as fetchLlmsTxt, y as isShallowGitDocs, z as generateReleaseIndex } from "./_chunks/npm.mjs";
 import "./sources/index.mjs";
 import { S as targets, _ as maxItems, a as getModelName, b as detectTargetAgent, c as computeSkillDirName, d as sanitizeName, f as unlinkSkillFromAgents, i as getModelLabel, n as createToolProgress, o as optimizeDocs, r as getAvailableModels, s as generateSkillMd, t as detectImportedPackages, u as linkSkillToAgents, v as maxLines, x as getAgentVersion, y as detectInstalledAgents } from "./_chunks/detect-imports.mjs";
 import "./agent/index.mjs";
@@ -337,26 +339,24 @@ function parsePackages(packages) {
 function serializePackages(pkgs) {
 	return pkgs.map((p) => `${p.name}@${p.version}`).join(", ");
 }
+const SKILL_FM_KEYS = [
+	"packageName",
+	"version",
+	"packages",
+	"repo",
+	"source",
+	"syncedAt",
+	"generator",
+	"path",
+	"ref",
+	"commit"
+];
 function parseSkillFrontmatter(skillPath) {
 	if (!existsSync(skillPath)) return null;
-	const match = readFileSync(skillPath, "utf-8").match(/^---\n([\s\S]*?)\n---/);
-	if (!match) return null;
+	const fm = parseFrontmatter(readFileSync(skillPath, "utf-8"));
+	if (Object.keys(fm).length === 0) return null;
 	const info = {};
-	for (const line of match[1].split("\n")) {
-		const kv = yamlParseKV(line);
-		if (!kv) continue;
-		const [key, value] = kv;
-		if (key === "packageName") info.packageName = value;
-		if (key === "version") info.version = value;
-		if (key === "packages") info.packages = value;
-		if (key === "repo") info.repo = value;
-		if (key === "source") info.source = value;
-		if (key === "syncedAt") info.syncedAt = value;
-		if (key === "generator") info.generator = value;
-		if (key === "path") info.path = value;
-		if (key === "ref") info.ref = value;
-		if (key === "commit") info.commit = value;
-	}
+	for (const key of SKILL_FM_KEYS) if (fm[key]) info[key] = fm[key];
 	return info;
 }
 function readLock(skillsDir) {
@@ -1070,6 +1070,13 @@ async function fetchAndCacheResources(opts) {
 				writeToCache(packageName, version, cachedDocs);
 			}
 		}
+		if (docsType !== "readme" && cachedDocs.filter((d) => d.path.startsWith("docs/") && d.path.endsWith(".md")).length > 1) {
+			const docsIndex = generateDocsIndex(cachedDocs);
+			if (docsIndex) writeToCache(packageName, version, [{
+				path: "docs/_INDEX.md",
+				content: docsIndex
+			}]);
+		}
 	} else {
 		const detected = detectDocsType(packageName, version, resolved.repoUrl, resolved.llmsUrl);
 		docsType = detected.docsType;
@@ -1086,6 +1093,16 @@ async function fetchAndCacheResources(opts) {
 				}
 			});
 		}
+		if (docsType !== "readme" && !existsSync(join(getCacheDir(packageName, version), "docs", "_INDEX.md"))) {
+			const cached = readCachedDocs(packageName, version);
+			if (cached.filter((d) => d.path.startsWith("docs/") && d.path.endsWith(".md")).length > 1) {
+				const docsIndex = generateDocsIndex(cached);
+				if (docsIndex) writeToCache(packageName, version, [{
+					path: "docs/_INDEX.md",
+					content: docsIndex
+				}]);
+			}
+		}
 	}
 	const cacheDir = getCacheDir(packageName, version);
 	const issuesDir = join(cacheDir, "issues");
@@ -1161,18 +1178,18 @@ async function fetchAndCacheResources(opts) {
 			const allDocs = [...releaseDocs, ...blogDocs];
 			const blogEntries = blogDocs.filter((d) => !d.path.endsWith("_INDEX.md")).map((d) => {
 				const versionMatch = d.path.match(/blog-(.+)\.md$/);
-				const titleMatch = d.content.match(/^title:\s*"(.+)"/m);
-				const dateMatch = d.content.match(/^date:\s*(.+)/m);
+				const fm = parseFrontmatter(d.content);
 				return {
 					version: versionMatch?.[1] ?? "",
-					title: titleMatch?.[1] ?? `Release ${versionMatch?.[1]}`,
-					date: dateMatch?.[1]?.trim() ?? ""
+					title: fm.title ?? `Release ${versionMatch?.[1]}`,
+					date: fm.date ?? ""
 				};
 			}).filter((b) => b.version);
 			const ghReleases = releaseDocs.filter((d) => d.path.startsWith("releases/") && !d.path.endsWith("CHANGELOG.md")).map((d) => {
-				const tag = d.content.match(/^tag:\s*(.+)/m)?.[1]?.trim() ?? "";
-				const name = (d.content.match(/^name:\s*"([^"]+)"/m) || d.content.match(/^name:\s*(\S+)/m))?.[1]?.trim() ?? tag;
-				const published = d.content.match(/^published:\s*(.+)/m)?.[1]?.trim() ?? "";
+				const fm = parseFrontmatter(d.content);
+				const tag = fm.tag ?? "";
+				const name = fm.name ?? tag;
+				const published = fm.published ?? "";
 				return {
 					id: 0,
 					tag,