skilld 1.7.3 → 2.0.0

package/dist/_chunks/index.d.mts

@@ -1,151 +0,0 @@
-/**
- * Cache configuration
- */
-/** Global cache directory */
-declare const CACHE_DIR: string;
-/** References subdirectory */
-declare const REFERENCES_DIR: string;
-/** Repo-level cache (issues, discussions, releases shared across monorepo packages) */
-declare const REPOS_DIR: string;
-/** Get repo cache dir for owner/repo with path traversal validation */
-declare function getRepoCacheDir(owner: string, repo: string): string;
-/** Get search DB path for a specific package@version */
-declare function getPackageDbPath(name: string, version: string): string;
-/**
- * Cache types
- */
-interface CacheConfig {
-  /** Package name */
-  name: string;
-  /** Package version (full semver) */
-  version: string;
-}
-interface CachedPackage {
-  name: string;
-  version: string;
-  dir: string;
-}
-interface CachedDoc {
-  path: string;
-  content: string;
-}
-/** Resolve package directory: node_modules first, then global cache */
-declare function resolvePkgDir(name: string, cwd: string, version?: string): string | null;
-interface ShippedSkill {
-  skillName: string;
-  skillDir: string;
-}
-/** Check if package ships a skills/ directory with SKILL.md or _SKILL.md subdirs */
-declare function getShippedSkills(name: string, cwd: string, version?: string): ShippedSkill[];
-/** Create symlink from skills dir to shipped skill dir */
-declare function linkShippedSkill(baseDir: string, skillName: string, targetDir: string): void;
-/**
- * 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
- */
-declare function ensureCacheDir(): void;
-/**
- * Write docs to cache
- */
-declare function writeToCache(name: string, version: string, docs: CachedDoc[]): string;
-/**
- * Write docs to repo-level cache (~/.skilld/repos/<owner>/<repo>/)
- */
-declare function writeToRepoCache(owner: string, repo: string, docs: CachedDoc[]): string;
-/**
- * Create symlink from .skilld dir to a repo-level cached subdirectory.
- *   .claude/skills/<skill>/.skilld/<subdir> -> ~/.skilld/repos/<owner>/<repo>/<subdir>
- */
-declare function linkRepoCachedDir(skillDir: string, owner: string, repo: string, subdir: string): void;
-/**
- * Create symlink from .skilld dir to a cached subdirectory.
- * Unified handler for docs, issues, discussions, sections, releases.
- *
- * Structure:
- *   .claude/skills/<skill>/.skilld/<subdir> -> ~/.skilld/references/<pkg>@<version>/<subdir>
- *
- * The .skilld/ dirs are gitignored. After clone, `skilld install` recreates from lockfile.
- */
-declare function linkCachedDir(skillDir: string, name: string, version: string, subdir: string): void;
-/**
- * Create symlink from .skilld dir to package directory
- *
- * Structure:
- *   .claude/skills/<skill>/.skilld/pkg -> node_modules/<pkg> OR ~/.skilld/references/<pkg>@<version>/pkg
- *
- * This gives access to package.json, README.md, dist/, and any shipped docs/
- */
-declare function linkPkg(skillDir: string, name: string, cwd: string, version?: string): void;
-/**
- * Create named symlink from .skilld dir to package directory.
- * Short name = last segment of package name (e.g., @vue/reactivity → pkg-reactivity)
- *
- * Structure:
- *   .claude/skills/<skill>/.skilld/pkg-<short> -> node_modules/<pkg>
- */
-declare function linkPkgNamed(skillDir: string, name: string, cwd: string, version?: string): void;
-/**
- * Get key files from a package directory for display
- * Returns entry points + docs files
- */
-declare function getPkgKeyFiles(name: string, cwd: string, version?: string): string[];
-/**
- * Write LLM-generated section outputs to global cache for cross-project reuse
- *
- * Structure:
- *   ~/.skilld/references/<pkg>@<version>/sections/_BEST_PRACTICES.md
- */
-declare function writeSections(name: string, version: string, sections: Array<{
-  file: string;
-  content: string;
-}>): void;
-/**
- * Read a cached section from the global references dir
- */
-declare function readCachedSection(name: string, version: string, file: string): string | null;
-declare function hasShippedDocs(name: string, cwd: string, version?: string): boolean;
-/**
- * List all cached packages
- */
-declare function listCached(): CachedPackage[];
-/**
- * Read cached docs for a package
- */
-declare function readCachedDocs(name: string, version: string): CachedDoc[];
-/**
- * Clear cache for a specific package
- */
-declare function clearCache(name: string, version: string): boolean;
-/**
- * Clear all cache
- */
-declare function clearAllCache(): number;
-/**
- * List files in .skilld directory (pkg + docs) as relative paths for prompt context
- * Returns paths like ./.skilld/pkg/README.md, ./.skilld/docs/api.md
- */
-declare function listReferenceFiles(skillDir: string, maxDepth?: number): string[];
-/**
- * Version utilities
- */
-/**
- * Get exact version key for cache keying
- */
-declare function getVersionKey(version: string): string;
-/**
- * Get cache key for a package: name@version
- */
-declare function getCacheKey(name: string, version: string): string;
-/**
- * Get path to cached package references.
- * Validates name/version to prevent path traversal.
- */
-declare function getCacheDir(name: string, version: string): string;
-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 +0,0 @@
-{"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/index2.d.mts

@@ -1,44 +0,0 @@
-import { c as SearchResult, l as SearchSnippet, n as Document, r as IndexConfig, s as SearchOptions } from "./types.mjs";
-import * as _$retriv from "retriv";
-type RetrivInstance = Awaited<ReturnType<typeof getDb>>;
-declare class SearchDepsUnavailableError extends Error {
-  constructor(cause: unknown, message?: string);
-}
-declare function getDb(config: Pick<IndexConfig, 'dbPath'>): Promise<_$retriv.SearchProvider & {
-  _testSetCategories?: (cats: string[]) => void;
-}>;
-/**
- * Index documents in-process (no worker thread).
- * Preferred for tests and environments where worker_threads is unreliable.
- */
-declare function createIndexDirect(documents: Document[], config: IndexConfig & {
-  removeIds?: string[];
-}): Promise<void>;
-/**
- * Index documents in a background worker thread.
- * Falls back to direct indexing if worker fails to spawn.
- */
-declare function createIndex(documents: Document[], config: IndexConfig & {
-  removeIds?: string[];
-}): Promise<void>;
-/**
- * List all raw document IDs in an existing index.
- * Returns chunk IDs (e.g. "doc-id#chunk-0") for chunked docs.
- * Queries sqlite directly to bypass createRetriv's parent-ID deduplication,
- * so callers can use these IDs for exact removal and parent-ID grouping.
- */
-declare function listIndexIds(config: Pick<IndexConfig, 'dbPath'>): Promise<string[]>;
-/**
- * Remove documents by ID from an existing index.
- */
-declare function removeFromIndex(ids: string[], config: Pick<IndexConfig, 'dbPath'>): Promise<void>;
-declare function search(query: string, config: IndexConfig, options?: SearchOptions): Promise<SearchResult[]>;
-/**
- * Search and return formatted snippets
- */
-declare function searchSnippets(query: string, config: IndexConfig, options?: SearchOptions): Promise<SearchSnippet[]>;
-declare function openPool(dbPaths: string[]): Promise<Map<string, RetrivInstance>>;
-declare function searchPooled(query: string, pool: Map<string, RetrivInstance>, options?: SearchOptions): Promise<SearchSnippet[]>;
-declare function closePool(pool: Map<string, RetrivInstance>): Promise<void>;
-export { getDb as a, removeFromIndex as c, searchSnippets as d, createIndexDirect as i, search as l, closePool as n, listIndexIds as o, createIndex as r, openPool as s, SearchDepsUnavailableError as t, searchPooled as u };
-//# sourceMappingURL=index2.d.mts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"index2.d.mts","names":[],"sources":["../../src/retriv/index.ts"],"mappings":";;KAKK,cAAA,GAAiB,OAAA,CAAQ,UAAA,QAAkB,KAAA;AAAA,cAEnC,0BAAA,SAAmC,KAAA;cAClC,KAAA,WAAgB,OAAA;AAAA;AAAA,iBAqCR,KAAA,CAAM,MAAA,EAAQ,IAAA,CAAK,WAAA,cAAsB,OAAA,CAAvB,QAAA,CAAuB,cAAA;;;;;;;iBA0CzC,iBAAA,CACpB,SAAA,EAAW,QAAA,IACX,MAAA,EAAQ,WAAA;EAAgB,SAAA;AAAA,IACvB,OAAA;AAnFH;;;;AAAA,iBA+FsB,WAAA,CACpB,SAAA,EAAW,QAAA,IACX,MAAA,EAAQ,WAAA;EAAgB,SAAA;AAAA,IACvB,OAAA;;;;AA5DH;;;iBAwEsB,YAAA,CACpB,MAAA,EAAQ,IAAA,CAAK,WAAA,cACZ,OAAA;;;;iBAiBmB,eAAA,CACpB,GAAA,YACA,MAAA,EAAQ,IAAA,CAAK,WAAA,cACZ,OAAA;AAAA,iBAQmB,MAAA,CACpB,KAAA,UACA,MAAA,EAAQ,WAAA,EACR,OAAA,GAAS,aAAA,GACR,OAAA,CAAQ,YAAA;;;;iBAqBW,cAAA,CACpB,KAAA,UACA,MAAA,EAAQ,WAAA,EACR,OAAA,GAAS,aAAA,GACR,OAAA,CAAQ,aAAA;AAAA,iBA2BW,QAAA,CAAS,OAAA,aAAoB,OAAA,CAAQ,GAAA,SAAY,cAAA;AAAA,iBASjD,YAAA,CACpB,KAAA,UACA,IAAA,EAAM,GAAA,SAAY,cAAA,GAClB,OAAA,GAAS,aAAA,GACR,OAAA,CAAQ,aAAA;AAAA,iBAkCW,SAAA,CAAU,IAAA,EAAM,GAAA,SAAY,cAAA,IAAkB,OAAA"}