skill-creator 1.5.1 → 1.5.2

package/dist/index.d.mts

@@ -1,5 +1,74 @@
-import { ChromaClient } from "chromadb";
-
+//#region src/core/searchAdapter.d.ts
+/**
+ * Search Engine Adapter Interface
+ * Provides a unified interface for different search implementations
+ */
+interface SearchResult$2 {
+  id: string;
+  title: string;
+  content: string;
+  source: 'user' | 'context7';
+  file_path: string;
+  score: number;
+  metadata: Record<string, unknown>;
+}
+interface SearchOptions$1 {
+  topK?: number;
+  where?: Record<string, any>;
+  fuzzyThreshold?: number;
+}
+type SearchMode = 'auto' | 'fulltext' | 'fuzzy' | 'vector' | 'chroma';
+type SearchBackendId = 'minisearch' | 'ufuzzy' | 'sqlite-vec';
+interface SearchBackendInfo {
+  backendId: SearchBackendId;
+  mode: Exclude<SearchMode, 'chroma'>;
+  supportsPersistence: boolean;
+  supportsEmbeddings: boolean;
+}
+interface SearchIndexState {
+  backendId: SearchBackendId;
+  referencesHash?: string;
+  builtAt?: string;
+  documentCount?: number;
+  rulesetVersion?: string;
+}
+interface SearchEngine {
+  /**
+   * Initialize backend resources if needed
+   */
+  initialize?(): Promise<void>;
+  /**
+   * Build search index from files
+   */
+  buildIndex(referencesDir: string): Promise<void>;
+  /**
+   * Search for documents matching the query
+   */
+  search(query: string, options?: SearchOptions$1): Promise<SearchResult$2[]>;
+  /**
+   * Return backend identity/capabilities
+   */
+  getBackendInfo(): SearchBackendInfo;
+  /**
+   * Check if the search index is built and ready
+   */
+  isBuilt(): boolean;
+  /**
+   * Get search engine statistics
+   */
+  getStats(): Promise<{
+    totalDocuments: number;
+  }>;
+  /**
+   * Read index state metadata
+   */
+  getIndexState?(): Promise<SearchIndexState>;
+  /**
+   * Clear the search index
+   */
+  clearIndex(): void | Promise<void>;
+}
+//#endregion
 //#region node_modules/.pnpm/zod@4.1.12/node_modules/zod/v4/core/standard-schema.d.cts
 /** The Standard Schema interface. */
 interface StandardSchemaV1<Input = unknown, Output = Input> {
@@ -1500,6 +1569,8 @@ interface CreateSkillOptions {
   skillDirname: string;
   skillName: string;
   skillDescription?: string;
+  sourcePackageName?: string;
+  sourcePackageVersionHint?: string;
   force?: boolean;
 }
 interface CreateSkillResult {
@@ -1513,6 +1584,21 @@ interface UpdateContext7Result {
   filesCreated: number;
   message: string;
 }
+interface CommandIndexingResult {
+  attempted: boolean;
+  skipped: boolean;
+  succeeded: boolean;
+  totalDocuments: number;
+  backendInfo?: SearchBackendInfo | null;
+  error?: string;
+}
+interface DownloadContext7CommandResult {
+  projectId: string;
+  update: UpdateContext7Result;
+  skillMdUpdated: boolean;
+  context7Files: string[];
+  indexing: CommandIndexingResult;
+}
 interface AddContentResult {
   added: boolean;
   updated: boolean;
@@ -1523,6 +1609,7 @@ interface AddContentResult {
   similarContent?: Array<{
     title: string;
     score: number;
+    sourceRank?: 'primary' | 'secondary';
     source: string;
     preview: string;
   }>;
@@ -1531,6 +1618,16 @@ interface AddContentResult {
     content: string;
   };
 }
+interface AddContentCommandResult extends AddContentResult {
+  skillMdUpdated: boolean;
+  userFiles: string[];
+}
+interface BuildIndexCommandResult {
+  mode: Exclude<SearchMode, 'chroma'>;
+  vectorEmbedder?: string;
+  totalDocuments: number;
+  backendInfo?: SearchBackendInfo | null;
+}
 interface PackageVersion {
   version: string;
   formatted: string;
@@ -1543,6 +1640,35 @@ interface Context7Library {
   trust_score: number;
   versions?: string[];
 }
+interface Context7ResolvedLibrary {
+  packageName: string;
+  version?: string;
+  query: string;
+  bestMatch: {
+    id: string;
+    title: string;
+    description: string;
+    totalSnippets: number;
+    trustScore: number;
+    benchmarkScore: number;
+    versions: string[];
+    matchKind: 'package-path' | 'package-slug' | 'website' | 'other';
+    versionMatched: boolean;
+    selectionScore: number;
+  };
+  candidates: Array<{
+    id: string;
+    title: string;
+    description: string;
+    totalSnippets: number;
+    trustScore: number;
+    benchmarkScore: number;
+    versions: string[];
+    matchKind: 'package-path' | 'package-slug' | 'website' | 'other';
+    versionMatched: boolean;
+    selectionScore: number;
+  }>;
+}
 //#endregion
 //#region src/core/skillCreator.d.ts
 declare class SkillCreator {
@@ -1551,146 +1677,135 @@ declare class SkillCreator {
   createSkill(options: CreateSkillOptions): Promise<CreateSkillResult>;
   private createDirectoryStructure;
   private createSkillMdFromTemplate;
+  private inferVersionHint;
 }
 //#endregion
-//#region src/core/searchAdapter.d.ts
+//#region src/core/fuzzySearchAdapter.d.ts
 /**
- * Search Engine Adapter Interface
- * Provides a unified interface for different search implementations
+ * uFuzzy-based Search Engine Adapter
+ * Clean implementation focused only on search functionality
  */
-interface SearchResult$2 {
-  id: string;
-  title: string;
-  content: string;
-  source: 'user' | 'context7';
-  file_path: string;
-  score: number;
-  metadata: any;
-}
-interface SearchOptions$1 {
-  topK?: number;
-  where?: Record<string, any>;
-  fuzzyThreshold?: number;
-}
-interface SearchEngine {
-  /**
-   * Build search index from files
-   */
+declare class FuzzySearchAdapter implements SearchEngine {
+  private documents;
+  private fuzzy;
+  private lastSearchInfo;
+  constructor();
   buildIndex(referencesDir: string): Promise<void>;
-  /**
-   * Search for documents matching the query
-   */
   search(query: string, options?: SearchOptions$1): Promise<SearchResult$2[]>;
   /**
-   * Check if the search index is built and ready
-   */
-  isBuilt(): boolean;
-  /**
-   * Get search engine statistics
+   * Basic fuzzy search using uFuzzy
    */
-  getStats(): any;
+  private fuzzySearch;
   /**
-   * Clear the search index
+   * Enhanced fuzzy search that returns both indices and detailed info
    */
+  private fuzzySearchWithInfo;
+  isBuilt(): boolean;
+  getStats(): Promise<{
+    totalDocuments: number;
+  }>;
+  getBackendInfo(): SearchBackendInfo;
+  getIndexState(): Promise<SearchIndexState>;
+  searchByPriority(query: string, topK?: number): Promise<SearchResult$2[]>;
   clearIndex(): void;
 }
 //#endregion
-//#region src/core/chromaSearchAdapter.d.ts
-interface ChromaSearchOptions {
-  /** 技能目录路径 */
+//#region src/core/miniSearchAdapter.d.ts
+interface MiniSearchAdapterOptions {
   skillDir: string;
-  /** ChromaDB 集合名称 */
-  collectionName: string;
-  /** 启动超时时间（毫秒） */
-  startupTimeout?: number;
-  /** 是否启用自动回退 */
-  enableFallback?: boolean;
 }
-/**
- * ChromaDB Search Adapter
- * 支持按需启动、自动回退和优雅关闭
- */
-declare class ChromaSearchAdapter implements SearchEngine {
-  private fuzzyAdapter;
-  private serverManager;
-  private options;
-  private isIndexBuilt;
-  private embeddingFunction;
-  constructor(options: ChromaSearchOptions);
-  /**
-   * 统一准备ChromaDB环境
-   * 封装服务器启动、客户端创建和配置的通用逻辑
-   */
-  private prepareChromadb;
-  /**
-   * 安全关闭ChromaDB服务器
-   */
-  private safeShutdownServer;
-  search(query: string, options?: SearchOptions$1): Promise<SearchResult$2[]>;
-  /**
-   * 计算当前文件的hash映射 {filename: hash}
-   */
-  private calculateFileHashes;
-  /**
-   * 加载之前的文件hash缓存
-   */
-  private loadFileHashCache;
-  /**
-   * 保存文件hash缓存
-   */
-  private saveFileHashCache;
-  /**
-   * 分析文件变化
-   */
-  private analyzeFileChanges;
-  /**
-   * 获取或创建集合
-   */
-  private getOrCreateCollection;
-  /**
-   * 处理文件变化
-   */
-  private processFileChanges;
+declare class MiniSearchAdapter implements SearchEngine {
+  private readonly options;
+  private index;
+  private documents;
+  private indexState;
+  constructor(options: MiniSearchAdapterOptions);
+  initialize(): Promise<void>;
   buildIndex(referencesDir: string): Promise<void>;
-  clearIndex(): Promise<void>;
+  search(query: string, options?: SearchOptions$1): Promise<SearchResult$2[]>;
+  getBackendInfo(): SearchBackendInfo;
   isBuilt(): boolean;
   getStats(): Promise<{
     totalDocuments: number;
   }>;
-  /**
-   * 获取运行中的服务器状态
-   */
-  getServerStatus(): {
-    isRunning: boolean;
-  };
+  getIndexState(): Promise<SearchIndexState>;
+  clearIndex(): void;
+  private createIndex;
+  private getSearchDir;
+  private ensureSearchDir;
+  private getIndexFilePath;
+  private getStateFilePath;
+  private loadPersistedIndexIfAvailable;
+  private persistIndex;
+  private loadDocuments;
+  private calculateReferencesHash;
+  private rerankResults;
+  private normalizeQueryTokens;
+  private calculateCoverage;
+  private calculatePathCoverage;
+  private calculateTermDensity;
+  private extractQueryPhrases;
+  private calculatePhraseCoverage;
+  private calculateProximityScore;
+  private findSubstringPositions;
+  private calibrateRawScore;
+  private tokensLooselyMatch;
 }
 //#endregion
-//#region src/core/fuzzySearchAdapter.d.ts
-/**
- * uFuzzy-based Search Engine Adapter
- * Clean implementation focused only on search functionality
- */
-declare class FuzzySearchAdapter implements SearchEngine {
-  private documents;
-  private fuzzy;
-  private lastSearchInfo;
-  constructor();
+//#region src/core/embeddingFunctions.d.ts
+interface EmbeddingFunction {
+  generate(input: string[]): Promise<number[][]>;
+}
+//#endregion
+//#region src/core/sqliteVectorSearchAdapter.d.ts
+interface SqliteVectorSearchAdapterOptions {
+  skillDir: string;
+  embeddingDimensions?: number;
+  embeddingFunction?: EmbeddingFunction;
+  embedderMode?: string;
+  candidateMultiplier?: number;
+  minCandidateLimit?: number;
+}
+declare class SqliteVectorSearchAdapter implements SearchEngine {
+  private readonly options;
+  private db;
+  private indexState;
+  private embedder;
+  constructor(options: SqliteVectorSearchAdapterOptions);
+  initialize(): Promise<void>;
   buildIndex(referencesDir: string): Promise<void>;
   search(query: string, options?: SearchOptions$1): Promise<SearchResult$2[]>;
-  /**
-   * Basic fuzzy search using uFuzzy
-   */
-  private fuzzySearch;
-  /**
-   * Enhanced fuzzy search that returns both indices and detailed info
-   */
-  private fuzzySearchWithInfo;
+  getBackendInfo(): SearchBackendInfo;
   isBuilt(): boolean;
   getStats(): Promise<{
     totalDocuments: number;
   }>;
-  searchByPriority(query: string, topK?: number): Promise<SearchResult$2[]>;
+  getIndexState(): Promise<SearchIndexState>;
   clearIndex(): void;
+  private getSearchDir;
+  private getEmbeddingDimensions;
+  private ensureSearchDir;
+  private getDbPath;
+  private getStateFilePath;
+  private prepareSchema;
+  private loadIndexState;
+  private persistIndexState;
+  private loadDocuments;
+  private calculateReferencesHash;
+  private loadRuntimeDependencies;
+  static isRuntimeSupported(): Promise<boolean>;
+  private ensureEmbedder;
+  private rerankRows;
+  private normalizeQueryTokens;
+  private extractQueryPhrases;
+  private calculateCoverage;
+  private calculatePathCoverage;
+  private calculatePhraseCoverage;
+  private calculateProximityScore;
+  private findSubstringPositions;
+  private tokensLooselyMatch;
+  private scoreTokenMatch;
+  private normalizeDocumentContent;
 }
 //#endregion
 //#region src/search_format/types.d.ts
@@ -1707,8 +1822,14 @@ interface FormattableSearchResult extends SearchResult$2 {
   /** Display tier information */
   metadata: SearchResult$2['metadata'] & {
     displayTier?: 'full' | 'preview' | 'metadata-only';
+    displayRank?: number;
+    displayScore?: number;
+    sourceRank?: 'primary' | 'secondary';
     maxScore?: number;
     averageScore?: number;
+    qualityScore?: number;
+    relativeScore?: number;
+    queryCoverage?: number;
     matchRanges?: number[][];
   };
 }
@@ -1728,8 +1849,8 @@ interface FormattedResult {
 //#endregion
 //#region src/core/searchEngineFactory.d.ts
 interface SearchEngineOptions {
-  /** Search mode: auto, fuzzy, or chroma */
-  mode?: 'auto' | 'fuzzy' | 'chroma';
+  /** Search mode */
+  mode?: SearchMode;
   /** Skill directory for file operations */
   skillDir?: string;
   /** References directory containing documentation */
@@ -1738,12 +1859,10 @@ interface SearchEngineOptions {
   config?: SkillConfig;
   /** Additional options for adapters */
   adapterOptions?: {
-    /** Enable ChromaDB fallback on failure */
-    enableChromaFallback?: boolean;
-    /** ChromaDB startup timeout */
-    chromaStartupTimeout?: number;
     /** Auto search quality threshold */
     qualityThreshold?: number;
+    /** Explicit vector embedder mode */
+    vectorEmbedder?: string;
   };
 }
 //#endregion
@@ -1799,6 +1918,8 @@ declare class UnifiedSearchEngine {
   getStats(): Promise<{
     totalDocuments: number;
   }>;
+  getBackendInfo(): Promise<SearchBackendInfo | null>;
+  getIndexState(): Promise<SearchIndexState | null>;
   /**
    * Clear search index
    */
@@ -1812,20 +1933,25 @@ declare class UnifiedSearchEngine {
 //#region src/core/contentManager.d.ts
 interface ContentManagerOptions {
   searchEngine: {
+    initialize?(): Promise<void>;
+    buildIndex?(referencesDir: string): Promise<void>;
+    clearIndex?(): Promise<void> | void;
     search(query: string, topK?: number, where?: any): Promise<any[]>;
   };
   referencesDir: string;
+  fetchImpl?: typeof fetch;
 }
 declare class ContentManager {
   private options;
   private userDir;
   private context7BaseDir;
-  private md;
   constructor(options: ContentManagerOptions);
   /**
    * Get the directory path for a specific context7 project
    */
   private getContext7ProjectDir;
+  private encodeContext7ProjectId;
+  private decodeContext7ProjectId;
   updateFromContext7(libraryId: string, force?: boolean): Promise<UpdateContext7Result>;
   addUserContent(options: {
     title: string;
@@ -1846,10 +1972,29 @@ declare class ContentManager {
   private createUniqueFilePath;
   private findSimilarContent;
   private isContentEnhanced;
+  private isContentDuplicate;
+  private normalizeContentForComparison;
+  private getSimilarityScore;
+  private mergeSimilarResults;
+  private findDirectUserMatches;
+  private findUserFileByTitle;
+  private findBestUserMergeTarget;
+  private calculateTokenOverlap;
+  private getSourcePriority;
+  private clamp01;
+  private summarizeSimilarContent;
+  private resolveSearchResultFilePath;
+  private getExpectedUserFilePath;
+  private renderKnowledgeNote;
+  private appendKnowledgeUpdate;
+  private getNextKnowledgeUpdateIndex;
+  private stripMatchingLeadingHeading;
+  private writeUserContentFile;
   private getHashFilePath;
   private saveContentHash;
   private needsUpdate;
-  private triggerReindex;
+  private prepareSearchEngine;
+  private invalidateSearchIndex;
   /**
    * List all context7 projects
    */
@@ -1891,6 +2036,8 @@ interface SearchOptions {
   minScore?: number;
 }
 declare class PackageUtils {
+  private static getRegistryBaseUrl;
+  private static getSearchBaseUrl;
   /**
    * Get package version from npm registry
    */
@@ -1924,7 +2071,7 @@ declare class PackageUtils {
     [key: string]: any;
   } | null;
   /**
-   * Format version according to doc-downloader rules
+   * Format version according to the skill directory naming rules.
    */
   static formatVersion(version: string): string;
   /**
@@ -1960,5 +2107,52 @@ declare class PackageUtils {
   } | null>;
 }
 //#endregion
-export { type AddContentResult, ChromaSearchAdapter, Config, type ContentItem, ContentManager, type ContentStats, type Context7Library, type CreateSkillOptions, type CreateSkillResult, FuzzySearchAdapter, PackageUtils, type PackageVersion, type SearchEngine, type SearchResult, type SkillConfig, SkillCreator, UnifiedSearchEngine, type UpdateContext7Result };
+//#region src/utils/context7.d.ts
+declare const Context7SearchCandidateSchema: ZodObject<{
+  id: ZodString;
+  title: ZodString;
+  description: ZodDefault<ZodOptional<ZodString>>;
+  branch: ZodOptional<ZodString>;
+  lastUpdateDate: ZodOptional<ZodString>;
+  state: ZodOptional<ZodString>;
+  totalTokens: ZodDefault<ZodOptional<ZodNumber>>;
+  totalSnippets: ZodDefault<ZodOptional<ZodNumber>>;
+  stars: ZodDefault<ZodOptional<ZodNumber>>;
+  trustScore: ZodDefault<ZodOptional<ZodNumber>>;
+  benchmarkScore: ZodDefault<ZodOptional<ZodNumber>>;
+  versions: ZodDefault<ZodOptional<ZodArray<ZodString>>>;
+}, $strip>;
+type Context7SearchCandidate = output<typeof Context7SearchCandidateSchema>;
+interface ResolvedContext7Candidate extends Context7SearchCandidate {
+  matchKind: 'package-path' | 'package-slug' | 'website' | 'other';
+  versionMatched: boolean;
+  selectionScore: number;
+}
+interface ResolveContext7Result {
+  packageName: string;
+  version?: string;
+  query: string;
+  bestMatch: ResolvedContext7Candidate;
+  candidates: ResolvedContext7Candidate[];
+}
+interface ResolveContext7Options {
+  version?: string;
+  limit?: number;
+  fetchImpl?: typeof fetch;
+}
+declare class Context7Utils {
+  static resolveLibrary(packageName: string, options?: ResolveContext7Options): Promise<ResolveContext7Result | null>;
+  static createSearchQuery(packageName: string, version?: string): string;
+  private static searchLibraries;
+  private static getLibrarySearchNames;
+  private static getPackageBaseName;
+  private static tokenizeIdentifier;
+  private static acceptBestMatch;
+  private static annotateCandidate;
+  private static classifyCandidate;
+  private static matchesVersion;
+  private static getCandidateMergeScore;
+}
+//#endregion
+export { type AddContentCommandResult, type AddContentResult, type BuildIndexCommandResult, type CommandIndexingResult, Config, type ContentItem, ContentManager, type ContentStats, type Context7Library, type Context7ResolvedLibrary, Context7Utils, type CreateSkillOptions, type CreateSkillResult, type DownloadContext7CommandResult, FuzzySearchAdapter, MiniSearchAdapter, PackageUtils, type PackageVersion, type SearchBackendInfo, type SearchEngine, type SearchIndexState, type SearchMode, type SearchResult, type SkillConfig, SkillCreator, SqliteVectorSearchAdapter, UnifiedSearchEngine, type UpdateContext7Result };
 //# sourceMappingURL=index.d.mts.map