skilld 1.5.0 → 1.5.2

package/dist/_chunks/index3.d.mts

@@ -0,0 +1,615 @@
+import * as ofetch$1 from "ofetch";
+
+//#region src/sources/blog-releases.d.ts
+interface CachedDoc$1 {
+  path: string;
+  content: string;
+}
+/**
+ * Fetch blog release notes from package presets
+ * Filters to only releases matching or older than the installed version
+ * Returns CachedDoc[] with releases/blog-{version}.md files
+ */
+declare function fetchBlogReleases(packageName: string, installedVersion: string): Promise<CachedDoc$1[]>;
+//#endregion
+//#region src/sources/crawl.d.ts
+/**
+ * Website crawl doc source — fetches docs by crawling a URL pattern
+ */
+/**
+ * Crawl a URL pattern and return docs as cached doc format.
+ * Uses HTTP crawler (no browser needed) with sitemap discovery + glob filtering.
+ *
+ * @param url - URL with optional glob pattern (e.g. 'https://example.com/docs/**')
+ * @param onProgress - Optional progress callback
+ * @param maxPages - Max pages to crawl (default 200)
+ */
+declare function fetchCrawledDocs(url: string, onProgress?: (message: string) => void, maxPages?: number): Promise<Array<{
+  path: string;
+  content: string;
+}>>;
+/** Append glob pattern to a docs URL for crawling */
+declare function toCrawlPattern(docsUrl: string): string;
+//#endregion
+//#region src/sources/discussions.d.ts
+/**
+ * GitHub discussions fetching via gh CLI GraphQL
+ * Prioritizes Q&A and Help categories, includes accepted answers
+ * Comment quality filtering, smart truncation, noise removal
+ */
+interface DiscussionComment {
+  body: string;
+  author: string;
+  reactions: number;
+  isMaintainer?: boolean;
+}
+interface GitHubDiscussion {
+  number: number;
+  title: string;
+  body: string;
+  category: string;
+  createdAt: string;
+  url: string;
+  upvoteCount: number;
+  comments: number;
+  isMaintainer?: boolean;
+  answer?: string;
+  topComments: DiscussionComment[];
+}
+/**
+ * Fetch discussions from a GitHub repo using gh CLI GraphQL.
+ * Prioritizes Q&A and Help categories. Includes accepted answer body for answered discussions.
+ * Fetches extra comments and scores them for quality.
+ */
+declare function fetchGitHubDiscussions(owner: string, repo: string, limit?: number, releasedAt?: string, fromDate?: string): Promise<GitHubDiscussion[]>;
+/**
+ * Format a single discussion as markdown with YAML frontmatter
+ */
+declare function formatDiscussionAsMarkdown(d: GitHubDiscussion): string;
+/**
+ * Generate a summary index of all discussions for quick LLM scanning.
+ * Groups by category so the LLM can quickly find Q&A vs general discussions.
+ */
+declare function generateDiscussionIndex(discussions: GitHubDiscussion[]): string;
+//#endregion
+//#region src/sources/docs.d.ts
+/**
+ * Docs index generation — creates _INDEX.md for docs directory
+ */
+/**
+ * Generate a _INDEX.md for a docs/ directory.
+ * Input: array of cached docs with paths like `docs/api/reactivity.md`.
+ * Output: markdown index grouped by directory with title + description per page.
+ */
+declare function generateDocsIndex(docs: Array<{
+  path: string;
+  content: string;
+}>): string;
+//#endregion
+//#region src/sources/entries.d.ts
+interface EntryFile {
+  path: string;
+  content: string;
+  type: 'types' | 'source';
+}
+/**
+ * Glob .d.ts type definition files from a package directory, skipping junk.
+ */
+declare function resolveEntryFiles(packageDir: string): Promise<EntryFile[]>;
+//#endregion
+//#region src/sources/git-skills.d.ts
+/**
+ * Git repo skill source — parse inputs + fetch pre-authored skills from repos
+ *
+ * Supports GitHub shorthand (owner/repo), full URLs, SSH, GitLab, and local paths.
+ * Skills are pre-authored SKILL.md files — no doc resolution or LLM generation needed.
+ */
+interface GitSkillSource {
+  type: 'github' | 'gitlab' | 'git-ssh' | 'local';
+  owner?: string;
+  repo?: string;
+  /** Direct path to a specific skill (from /tree/ref/path URLs) */
+  skillPath?: string;
+  /** Branch/tag parsed from URL */
+  ref?: string;
+  /** Absolute path for local sources */
+  localPath?: string;
+}
+interface RemoteSkill {
+  /** From SKILL.md frontmatter `name` field, or directory name */
+  name: string;
+  /** From SKILL.md frontmatter `description` field */
+  description: string;
+  /** Path within repo (e.g., "skills/web-design-guidelines") */
+  path: string;
+  /** Full SKILL.md content */
+  content: string;
+  /** Supporting files (scripts/, references/, assets/) */
+  files: Array<{
+    path: string;
+    content: string;
+  }>;
+}
+/**
+ * Detect whether an input string is a git skill source.
+ * Returns null for npm package names (including scoped @scope/pkg).
+ */
+declare function parseGitSkillInput(input: string): GitSkillSource | null;
+/**
+ * Parse name and description from SKILL.md frontmatter.
+ */
+declare function parseSkillFrontmatterName(content: string): {
+  name?: string;
+  description?: string;
+};
+/**
+ * Fetch skills from a git source. Returns list of discovered skills.
+ */
+declare function fetchGitSkills(source: GitSkillSource, onProgress?: (msg: string) => void): Promise<{
+  skills: RemoteSkill[];
+}>;
+//#endregion
+//#region src/sources/types.d.ts
+/**
+ * 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;
+}
+//#endregion
+//#region src/sources/github.d.ts
+/** 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) */
+declare const isShallowGitDocs: (n: number) => boolean;
+interface GitDocsResult {
+  /** URL pattern for fetching docs (use with ref) */
+  baseUrl: string;
+  /** Git ref (tag) used */
+  ref: string;
+  /** List of doc file paths relative to repo root */
+  files: string[];
+  /** Prefix to strip when normalizing paths to docs/ (e.g. 'apps/evalite-docs/src/content/') for nested monorepo docs */
+  docsPrefix?: string;
+  /** Full repo file tree — only set when discoverDocFiles() heuristic was used (not standard docs/ prefix) */
+  allFiles?: string[];
+  /** True when ref is a branch (main/master) rather than a version-specific tag */
+  fallback?: boolean;
+}
+/**
+ * Filter out docs for other frameworks when the package targets a specific one.
+ * e.g. @tanstack/vue-query → keep vue + shared docs, exclude react/solid/angular
+ * Uses word-boundary matching to catch all path conventions:
+ *   framework/react/, 0.react/, api/ai-react.md, react-native.mdx, etc.
+ */
+declare function filterFrameworkDocs(files: string[], packageName?: string): string[];
+/**
+ * Fetch versioned docs from GitHub repo's docs/ folder.
+ * Pass packageName to check doc overrides (e.g. vue -> vuejs/docs).
+ */
+declare function fetchGitDocs(owner: string, repo: string, version: string, packageName?: string, repoUrl?: string): Promise<GitDocsResult | null>;
+/**
+ * Validate that discovered git docs are relevant by cross-referencing llms.txt links
+ * against the repo file tree. Uses extensionless suffix matching to handle monorepo nesting.
+ *
+ * Returns { isValid, matchRatio } where isValid = matchRatio >= 0.3
+ */
+declare function validateGitDocsWithLlms(llmsLinks: LlmsLink[], repoFiles: string[]): {
+  isValid: boolean;
+  matchRatio: number;
+};
+/**
+ * Fetch GitHub repo metadata to get website URL.
+ * Pass packageName to check doc overrides first (avoids API call).
+ */
+declare function fetchGitHubRepoMeta(owner: string, repo: string, packageName?: string): Promise<{
+  homepage?: string;
+} | null>;
+/**
+ * Resolve README URL for a GitHub repo, returns ungh:// pseudo-URL or raw URL
+ */
+declare function fetchReadme(owner: string, repo: string, subdir?: string, ref?: string): Promise<string | null>;
+/**
+ * Fetch README content from ungh:// pseudo-URL, file:// URL, or regular URL
+ */
+declare function fetchReadmeContent(url: string): Promise<string | null>;
+/**
+ * Resolve a GitHub repo into a ResolvedPackage (no npm registry needed).
+ * Fetches repo meta, latest release version, git docs, README, and llms.txt.
+ */
+declare function resolveGitHubRepo(owner: string, repo: string, onProgress?: (msg: string) => void): Promise<ResolvedPackage | null>;
+//#endregion
+//#region src/sources/issues.d.ts
+/**
+ * GitHub issues fetching via gh CLI Search API
+ * Freshness-weighted scoring, type quotas, comment quality filtering
+ * Categorized by labels, noise filtered out, non-technical issues detected
+ */
+type IssueType = 'bug' | 'question' | 'docs' | 'feature' | 'other';
+interface IssueComment {
+  body: string;
+  author: string;
+  reactions: number;
+  isMaintainer?: boolean;
+}
+interface GitHubIssue {
+  number: number;
+  title: string;
+  state: string;
+  labels: string[];
+  body: string;
+  createdAt: string;
+  url: string;
+  reactions: number;
+  comments: number;
+  type: IssueType;
+  topComments: IssueComment[];
+  /** Freshness-weighted score: reactions * decay(age) */
+  score: number;
+  /** For closed issues: version where fix landed, if detectable */
+  resolvedIn?: string;
+}
+/**
+ * Check if gh CLI is installed and authenticated (cached)
+ */
+declare function isGhAvailable(): boolean;
+/**
+ * Fetch issues from a GitHub repo with freshness-weighted scoring and type quotas.
+ * Returns a balanced mix: bugs > questions > docs > other > features.
+ * Filters noise, non-technical content, and enriches with quality comments.
+ */
+declare function fetchGitHubIssues(owner: string, repo: string, limit?: number, releasedAt?: string, fromDate?: string): Promise<GitHubIssue[]>;
+/**
+ * Format a single issue as markdown with YAML frontmatter
+ */
+declare function formatIssueAsMarkdown(issue: GitHubIssue): string;
+/**
+ * Generate a summary index of all issues for quick LLM scanning.
+ * Groups by type so the LLM can quickly find bugs vs questions.
+ */
+declare function generateIssueIndex(issues: GitHubIssue[]): string;
+//#endregion
+//#region src/sources/llms.d.ts
+/**
+ * Check for llms.txt at a docs URL, returns the llms.txt URL if found
+ */
+declare function fetchLlmsUrl(docsUrl: string): Promise<string | null>;
+/**
+ * Fetch and parse llms.txt content
+ */
+declare function fetchLlmsTxt(url: string): Promise<LlmsContent | null>;
+/**
+ * Parse markdown links from llms.txt to get .md file paths
+ */
+declare function parseMarkdownLinks(content: string): LlmsLink[];
+declare function downloadLlmsDocs(llmsContent: LlmsContent, baseUrl: string, onProgress?: (url: string, index: number, total: number) => void): Promise<FetchedDoc[]>;
+/**
+ * Normalize llms.txt links to relative paths for local access
+ * Handles: absolute URLs, root-relative paths, and relative paths
+ */
+declare function normalizeLlmsLinks(content: string, baseUrl?: string): string;
+/**
+ * Extract sections from llms-full.txt by URL patterns
+ * Format: ---\nurl: /path.md\n---\n<content>\n\n---\nurl: ...
+ */
+declare function extractSections(content: string, patterns: string[]): string | null;
+//#endregion
+//#region src/sources/npm.d.ts
+/**
+ * Search npm registry for packages matching a query.
+ * Used as a fallback when direct package lookup fails.
+ */
+declare function searchNpmPackages(query: string, size?: number): Promise<Array<{
+  name: string;
+  description?: string;
+  version: string;
+}>>;
+/**
+ * Fetch package info from npm registry
+ */
+declare function fetchNpmPackage(packageName: string): Promise<NpmPackageInfo | null>;
+interface DistTagInfo {
+  version: string;
+  releasedAt?: string;
+}
+interface NpmRegistryMeta {
+  releasedAt?: string;
+  distTags?: Record<string, DistTagInfo>;
+}
+/**
+ * Fetch release date and dist-tags from npm registry
+ */
+declare function fetchNpmRegistryMeta(packageName: string, version: string): Promise<NpmRegistryMeta>;
+type ResolveStep = 'npm' | 'github-docs' | 'github-meta' | 'github-search' | 'readme' | 'llms.txt' | 'crawl' | 'local';
+interface ResolveOptions {
+  /** User's installed version - used to fetch versioned git docs */
+  version?: string;
+  /** Current working directory - for local readme fallback */
+  cwd?: string;
+  /** Progress callback - called before each resolution step */
+  onProgress?: (step: ResolveStep) => void;
+}
+/**
+ * Resolve documentation URL for a package (legacy - returns null on failure)
+ */
+declare function resolvePackageDocs(packageName: string, options?: ResolveOptions): Promise<ResolvedPackage | null>;
+/**
+ * Resolve documentation URL for a package with attempt tracking
+ */
+declare function resolvePackageDocsWithAttempts(packageName: string, options?: ResolveOptions): Promise<ResolveResult>;
+/**
+ * Parse version specifier, handling protocols like link:, workspace:, npm:, file:
+ */
+declare function parseVersionSpecifier(name: string, version: string, cwd: string): LocalDependency | null;
+/**
+ * Resolve the actual installed version of a package by finding its package.json
+ * via mlly's resolvePathSync. Works regardless of package manager or version protocol.
+ */
+declare function resolveInstalledVersion(name: string, cwd: string): string | null;
+/**
+ * Read package.json dependencies with versions
+ */
+declare function readLocalDependencies(cwd: string): Promise<LocalDependency[]>;
+interface LocalPackageInfo {
+  name: string;
+  version: string;
+  description?: string;
+  repoUrl?: string;
+  localPath: string;
+}
+/**
+ * Read package info from a local path (for link: deps)
+ */
+declare function readLocalPackageInfo(localPath: string): LocalPackageInfo | null;
+/**
+ * Resolve docs for a local package (link: dependency)
+ */
+declare function resolveLocalPackageDocs(localPath: string): Promise<ResolvedPackage | null>;
+/**
+ * Download and extract npm package tarball to cache directory.
+ * Used when the package isn't available in node_modules.
+ *
+ * Extracts to: ~/.skilld/references/<pkg>@<version>/pkg/
+ * Returns the extracted directory path, or null on failure.
+ */
+declare function fetchPkgDist(name: string, version: string): Promise<string | null>;
+/**
+ * Fetch just the latest version string from npm (lightweight)
+ */
+declare function fetchLatestVersion(packageName: string): Promise<string | null>;
+/**
+ * Get installed skill version from SKILL.md
+ */
+declare function getInstalledSkillVersion(skillDir: string): string | null;
+//#endregion
+//#region src/sources/package-registry.d.ts
+/**
+ * Unified package registry — single source of truth for package metadata.
+ * Consolidates doc overrides, blog presets, and file patterns.
+ * Keyed by GitHub 'owner/repo' (source code repo).
+ */
+interface BlogRelease {
+  version: string;
+  url: string;
+  date: string;
+  title?: string;
+}
+interface PackageEntry {
+  filePatterns?: string[];
+  primary?: boolean;
+  /** Extra rules injected into skill generation prompts */
+  rules?: string[];
+}
+interface RepoEntry {
+  owner: string;
+  repo: string;
+  /** Separate docs repo name (e.g. 'docs' → owner/docs) */
+  docsRepo?: string;
+  /** Path prefix to filter markdown files */
+  docsPath?: string;
+  /** Branch/ref override */
+  docsRef?: string;
+  /** Homepage URL */
+  homepage?: string;
+  /** URL pattern to crawl for docs (glob, e.g. 'https://example.com/docs/**') */
+  crawlUrl?: string;
+  /** Branch to fetch CHANGELOG.md from when installed version is a prerelease (e.g. 'minor' for Vue) */
+  prereleaseChangelogRef?: string;
+  /** Packages in this repo */
+  packages: Record<string, PackageEntry>;
+  /** Curated blog release posts */
+  blogReleases?: BlogRelease[];
+}
+interface DocOverride {
+  owner: string;
+  repo: string;
+  path: string;
+  ref?: string;
+  homepage?: string;
+}
+interface BlogPreset {
+  packageName: string;
+  releases: BlogRelease[];
+}
+declare function getDocOverride(packageName: string): DocOverride | undefined;
+declare function getBlogPreset(packageName: string): BlogPreset | undefined;
+declare function getFilePatterns(packageName: string): string[] | undefined;
+declare function getRepoEntry(repoKey: string): RepoEntry | undefined;
+declare function getRepoKeyForPackage(packageName: string): string | undefined;
+declare function getPrereleaseChangelogRef(packageName: string): string | undefined;
+declare function getCrawlUrl(packageName: string): string | undefined;
+declare function getRelatedPackages(packageName: string): string[];
+//#endregion
+//#region src/sources/releases.d.ts
+/**
+ * GitHub release notes fetching via GitHub API (preferred) with ungh.cc fallback
+ */
+interface GitHubRelease {
+  id: number;
+  tag: string;
+  name: string;
+  prerelease: boolean;
+  createdAt: string;
+  publishedAt: string;
+  markdown: string;
+}
+interface CachedDoc {
+  path: string;
+  content: string;
+}
+interface SemVer {
+  major: number;
+  minor: number;
+  patch: number;
+  raw: string;
+}
+declare function parseSemver(version: string): SemVer | null;
+/**
+ * Check if a version string contains a prerelease suffix (e.g. 6.0.0-beta, 1.2.3-rc.1)
+ */
+declare function isPrerelease(version: string): boolean;
+declare function compareSemver(a: SemVer, b: SemVer): number;
+interface ReleaseIndexOptions {
+  releases: GitHubRelease[];
+  packageName?: string;
+  blogReleases?: Array<{
+    version: string;
+    title: string;
+    date: string;
+  }>;
+  hasChangelog?: boolean;
+}
+/**
+ * Generate a unified summary index of all releases for quick LLM scanning.
+ * Includes GitHub releases, blog release posts, and CHANGELOG link.
+ */
+declare function generateReleaseIndex(releasesOrOpts: GitHubRelease[] | ReleaseIndexOptions, packageName?: string): string;
+/**
+ * Fetch release notes for a package. Returns CachedDoc[] with releases/{tag}.md files.
+ *
+ * Strategy:
+ * 1. Fetch GitHub releases, filter to package-specific tags for monorepos
+ * 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[]>;
+//#endregion
+//#region src/sources/utils.d.ts
+/**
+ * Shared utilities for doc resolution
+ */
+declare const $fetch: ofetch$1.$Fetch;
+/**
+ * Fetch text content from URL
+ */
+declare function fetchText(url: string): Promise<string | null>;
+/**
+ * Fetch text from a GitHub raw URL with auth fallback for private repos.
+ * Tries unauthenticated first (fast path), falls back to authenticated
+ * request when the repo is known to be private or unauthenticated fails.
+ *
+ * Only sends auth tokens to raw.githubusercontent.com — returns null for
+ * non-GitHub URLs that fail unauthenticated to prevent token leakage.
+ */
+declare function fetchGitHubRaw(url: string): Promise<string | null>;
+/**
+ * Verify URL exists and is not HTML (likely 404 page)
+ */
+declare function verifyUrl(url: string): Promise<boolean>;
+/**
+ * Check if URL is a GitHub repo URL (not a docs site)
+ */
+declare function isGitHubRepoUrl(url: string): boolean;
+/**
+ * Parse owner/repo from GitHub URL
+ */
+declare function parseGitHubUrl(url: string): {
+  owner: string;
+  repo: string;
+} | null;
+/**
+ * Normalize git repo URL to https
+ */
+declare function normalizeRepoUrl(url: string): string;
+/**
+ * Parse package spec with optional dist-tag or version: "vue@beta" → { name: "vue", tag: "beta" }
+ * Handles scoped packages: "@vue/reactivity@beta" → { name: "@vue/reactivity", tag: "beta" }
+ */
+declare function parsePackageSpec(spec: string): {
+  name: string;
+  tag?: string;
+};
+/**
+ * Extract branch hint from URL fragment (e.g. "git+https://...#main" → "main")
+ */
+declare function extractBranchHint(url: string): string | undefined;
+//#endregion
+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 };
+//# sourceMappingURL=index3.d.mts.map

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

@@ -0,0 +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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"}

package/dist/_chunks/install.mjs

@@ -1,24 +1,27 @@
 import { a as getModelLabel, r as createToolProgress, s as optimizeDocs } from "./agent.mjs";
 import { a as getRepoCacheDir, i as getPackageDbPath, o as getCacheDir } from "./config.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 { _ as resolvePkgDir, a as getShippedSkills, f as linkShippedSkill, h as readCachedDocs, i as getPkgKeyFiles, m as listReferenceFiles, o as hasShippedDocs, r as ensureCacheDir, s as isCached, u as linkPkgNamed, y as writeToCache } from "./cache.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 "./yaml.mjs";
 import "./markdown.mjs";
-import { SearchDepsUnavailableError, createIndex } from "../retriv/index.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 targets } from "./detect.mjs";
 import { i as linkSkillToAgents, t as generateSkillMd } from "./prompts.mjs";
-import { E as readConfig, S as defaultFeatures, _ as sharedArgs, g as resolveAgent, p as promptForAgent } from "./cli-helpers.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 "./skills.mjs";
 import { l as timedSpinner } from "./formatting.mjs";
+import "./wizard.mjs";
 import { S as writePromptFiles, a as classifyCachedDoc, b as selectLlmConfig, g as indexResources } from "./sync-shared2.mjs";
-import { n as shutdownWorker } from "./pool.mjs";
+import { n as shutdownWorker } from "./pool2.mjs";
 import "./sync.mjs";
 import { homedir } from "node:os";
 import { dirname, join } from "pathe";
-import { copyFileSync, existsSync, lstatSync, mkdirSync, readFileSync, readdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
+import { copyFileSync, existsSync, lstatSync, mkdirSync, readdirSync, symlinkSync, unlinkSync, writeFileSync } from "node:fs";
 import * as p from "@clack/prompts";
 import { defineCommand } from "citty";
 //#region src/commands/install.ts
@@ -444,8 +447,8 @@ async function enhanceRegenerated(pkgName, version, skillDir, model, sections, c
 		const pkgPath = resolvePkgDir(pkgName, cwd, version);
 		let description;
 		if (pkgPath) {
-			const pkgJsonPath = join(pkgPath, "package.json");
-			if (existsSync(pkgJsonPath)) description = JSON.parse(readFileSync(pkgJsonPath, "utf-8")).description;
+			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";
@@ -502,8 +505,8 @@ function regenerateBaseSkillMd(skillDir, pkgName, version, cwd, allSkillNames, s
 	const pkgPath = resolvePkgDir(pkgName, cwd, version);
 	let description;
 	if (pkgPath) {
-		const pkgJsonPath = join(pkgPath, "package.json");
-		if (existsSync(pkgJsonPath)) description = JSON.parse(readFileSync(pkgJsonPath, "utf-8")).description;
+		const pkgResult = readPackageJsonSafe(join(pkgPath, "package.json"));
+		if (pkgResult) description = pkgResult.parsed.description;
 	}
 	const globalCachePath = getCacheDir(pkgName, version);
 	let docsType = "docs";