@ninjaxtools/slopdex 0.9.0 → 0.11.0

package/dist/index.d.ts

@@ -3,7 +3,7 @@ declare class CodeIndex {
     readonly rootDir: string;
     readonly indexPath: string;
     readonly provider: EmbeddingProvider;
-    readonly summaryProvider: SummaryProvider;
+    readonly descriptionProvider: DescriptionProvider;
     constructor(options: CodeIndexOptions);
     close(): void;
     status(): IndexStatus;
@@ -12,13 +12,14 @@ declare class CodeIndex {
     updateFiles(options: UpdateFilesOptions): Promise<UpdateStats>;
     updateFromWorkingTree(options?: UpdateFromWorkingTreeOptions): Promise<UpdateStats>;
     updateFromGit(options?: UpdateFromGitOptions): Promise<UpdateStats>;
-    useSummaries(options?: {
+    useDescriptions(options?: {
         signal?: AbortSignal;
-    }): Promise<SummaryStats>;
-    searchSummary(options: SimilaritySearchOptions): Promise<SimilarityResult[]>;
+    }): Promise<DescriptionStats>;
+    disableDescriptions(): DescriptionStats;
+    searchDescription(options: SimilaritySearchOptions): Promise<SimilarityResult[]>;
     similaritySearch(options: SimilaritySearchOptions): Promise<SimilarityResult[]>;
     similarToFunction(functionId: number, options: {
-        includeSummaries?: boolean;
+        includeDescriptions?: boolean;
         limit: number;
         minSimilarity: number;
         maxSimilarity?: number;
@@ -26,9 +27,9 @@ declare class CodeIndex {
         minLines?: number;
         nameRegex?: string;
     }): SimilarityResult[];
-    vectorForFunction(functionId: number, kind?: "code" | "summary"): number[];
+    vectorForFunction(functionId: number, kind?: "code" | "description"): number[];
     searchByVector(vector: readonly number[], options: {
-        summaryVector?: readonly number[];
+        descriptionVector?: readonly number[];
         limit: number;
         minSimilarity: number;
         maxSimilarity?: number;
@@ -83,8 +84,8 @@ interface IndexedFunction extends ParsedCallable {
     lastSeenCommit: string | null;
     sourceMode: SourceMode;
     embeddingId: number;
-    summary: string | null;
-    summaryEmbeddingId: number | null;
+    description: string | null;
+    descriptionEmbeddingId: number | null;
 }
 interface EmbeddingProfile {
     provider: "openai" | "jina" | string;
@@ -101,31 +102,31 @@ interface EmbeddingProvider {
         signal?: AbortSignal;
     }): Promise<number[]>;
 }
-interface SummaryProfile {
+interface DescriptionProfile {
     provider: string;
     model: string;
     strategyVersion: string;
 }
-interface SummaryInput {
+interface DescriptionInput {
     repository: string;
     callable: ParsedCallable;
     fileSource: string;
 }
-interface SummaryProvider {
-    readonly profile: SummaryProfile;
-    summarize(input: SummaryInput, options?: {
+interface DescriptionProvider {
+    readonly profile: DescriptionProfile;
+    describe(input: DescriptionInput, options?: {
         signal?: AbortSignal;
     }): Promise<string>;
 }
-interface SummaryStats {
-    summariesCreated: number;
-    summariesEnabled: boolean;
+interface DescriptionStats {
+    descriptionsCreated: number;
+    descriptionsEnabled: boolean;
 }
 interface CodeIndexOptions {
     rootDir: string;
     indexPath?: string;
     provider: EmbeddingProvider;
-    summaryProvider?: SummaryProvider;
+    descriptionProvider?: DescriptionProvider;
     onWarning?: (message: string) => void;
     include?: readonly string[];
     exclude?: readonly string[];
@@ -172,13 +173,13 @@ interface SimilaritySearchOptions {
 interface SimilarityScores {
     similarity: number;
     codeSimilarity?: number;
-    summarySimilarity?: number;
+    descriptionSimilarity?: number;
 }
 interface AnalysisSimilarity {
-    similarityMode: "code" | "code-summary-average";
+    similarityMode: "code" | "code-description-average";
     similarityWeights: {
         code: number;
-        summary: number;
+        description: number;
     };
 }
 interface SimilarityResult extends SimilarityScores {
@@ -220,8 +221,8 @@ interface CrossSearchResult {
     source: IndexedFunction;
     matches: SimilarityResult[];
     scoring?: AnalysisSimilarity & {
-        sourceSummaryProfile: SummaryProfile | null;
-        targetSummaryProfile: SummaryProfile | null;
+        sourceDescriptionProfile: DescriptionProfile | null;
+        targetDescriptionProfile: DescriptionProfile | null;
     };
 }
 type CohesionLocationCategory = "same-file" | "same-folder" | "different-folder";
@@ -276,7 +277,7 @@ interface CohesionGroup<FunctionValue = IndexedFunction> {
     maximumCohesionGap: number;
     members: FunctionValue[];
 }
-interface CohesionSummary {
+interface CohesionMetrics {
     scope: "repository" | "selected-sources";
     functionsAnalyzed: number;
     candidateFunctions: number;
@@ -302,12 +303,12 @@ interface CohesionAnalysisOptions {
     }) => void;
 }
 interface CohesionReport<FunctionValue = IndexedFunction> {
-    schemaVersion: 1;
+    schemaVersion: 2;
     repository: {
         generation: number;
         gitCheckpoint: string | null;
         embeddingProfile: Required<EmbeddingProfile>;
-        summaryProfile: SummaryProfile | null;
+        descriptionProfile: DescriptionProfile | null;
     };
     parameters: AnalysisSimilarity & {
         neighbors: number;
@@ -318,7 +319,7 @@ interface CohesionReport<FunctionValue = IndexedFunction> {
         nameRegex?: string;
         sourceFilter: CrossSearchSourceFilter;
     };
-    summary: CohesionSummary;
+    metrics: CohesionMetrics;
     pairs: CohesionPair<FunctionValue>[];
     files: CohesionFileReport<FunctionValue>[];
     groups: CohesionGroup<FunctionValue>[];
@@ -332,9 +333,9 @@ interface IndexStatus {
     generation: number;
     gitCheckpoint: string | null;
     embeddingProfile: Required<EmbeddingProfile>;
-    summariesEnabled: boolean;
-    summaryCount: number;
-    summaryProfile: SummaryProfile | null;
+    descriptionsEnabled: boolean;
+    descriptionCount: number;
+    descriptionProfile: DescriptionProfile | null;
     indexingErrorCount: number;
     failedFileCount: number;
 }
@@ -358,7 +359,7 @@ declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
         readonly provider: "openai";
         readonly model: string;
         readonly dimensions: number;
-        readonly strategyVersion: "callable-v1";
+        readonly strategyVersion: "callable-v2";
     };
     constructor(options?: OpenAIEmbeddingProviderOptions);
     embedDocuments(inputs: readonly string[], options?: {
@@ -369,20 +370,20 @@ declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
     }): Promise<number[]>;
 }
 
-interface OpenAISummaryProviderOptions {
+interface OpenAIDescriptionProviderOptions {
     apiKey?: string;
     model?: string;
     baseUrl?: string;
 }
-declare class OpenAISummaryProvider implements SummaryProvider {
+declare class OpenAIDescriptionProvider implements DescriptionProvider {
     #private;
     readonly profile: {
         provider: string;
         model: string;
         strategyVersion: string;
     };
-    constructor(options?: OpenAISummaryProviderOptions);
-    summarize(input: SummaryInput, options?: {
+    constructor(options?: OpenAIDescriptionProviderOptions);
+    describe(input: DescriptionInput, options?: {
         signal?: AbortSignal;
     }): Promise<string>;
 }
@@ -399,7 +400,7 @@ declare class JinaEmbeddingProvider implements EmbeddingProvider {
         readonly provider: "jina";
         readonly model: string;
         readonly dimensions: number;
-        readonly strategyVersion: "callable-v1:code-query-passage";
+        readonly strategyVersion: "callable-v2:code-query-passage";
     };
     constructor(options?: JinaEmbeddingProviderOptions);
     embedDocuments(inputs: readonly string[], options?: {
@@ -428,11 +429,12 @@ declare function updateFiles(index: CodeIndex, options: UpdateFilesOptions): Pro
 declare function updateFromGit(index: CodeIndex, options?: UpdateFromGitOptions): Promise<UpdateStats>;
 declare function updateFromWorkingTree(index: CodeIndex, options?: UpdateFromWorkingTreeOptions): Promise<UpdateStats>;
 declare function similaritySearch(index: CodeIndex, options: SimilaritySearchOptions): Promise<SimilarityResult[]>;
-declare function useSummaries(index: CodeIndex, options?: {
+declare function useDescriptions(index: CodeIndex, options?: {
     signal?: AbortSignal;
-}): Promise<SummaryStats>;
-declare function searchSummary(index: CodeIndex, options: SimilaritySearchOptions): Promise<SimilarityResult[]>;
+}): Promise<DescriptionStats>;
+declare function disableDescriptions(index: CodeIndex): DescriptionStats;
+declare function searchDescription(index: CodeIndex, options: SimilaritySearchOptions): Promise<SimilarityResult[]>;
 declare function crossSearchFunctions(options: CrossSearchOptions): AsyncGenerator<CrossSearchResult, any, any>;
 declare function analyzeCodeCohesion(options: CohesionAnalysisOptions): Promise<CohesionReport<IndexedFunction>>;
 
-export { type AnalysisSimilarity, type CallableKind, CodeIndex, CodeIndexError, type CodeIndexOptions, type CohesionAnalysisOptions, type CohesionFileReport, type CohesionFunctionReference, type CohesionGroup, type CohesionJsonReport, type CohesionLocation, type CohesionLocationCategory, type CohesionPair, type CohesionReport, type CohesionSummary, type CrossSearchOptions, type CrossSearchResult, type CrossSearchSourceFilter, type EmbeddingProfile, type EmbeddingProvider, GitDivergenceError, GitUnavailableError, IncompatibleIndexError, type IndexStatus, type IndexedFunction, type IndexingError, type IndexingIssue, JinaEmbeddingProvider, type JinaEmbeddingProviderOptions, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderOptions, OpenAISummaryProvider, type OpenAISummaryProviderOptions, type ParsedCallable, type SimilarityResult, type SimilarityScores, type SimilaritySearchOptions, type SourceMode, type SummaryInput, type SummaryProfile, type SummaryProvider, type SummaryStats, type SupportedLanguage, type UpdateFilesOptions, type UpdateFromGitOptions, type UpdateFromWorkingTreeOptions, type UpdateStats, analyzeCodeCohesion, analyzeCohesion, cohesionLocation, crossSearch, crossSearchFunctions, openCodeIndex, readIndexErrors, searchSummary, similaritySearch, updateFiles, updateFromGit, updateFromWorkingTree, useSummaries };
+export { type AnalysisSimilarity, type CallableKind, CodeIndex, CodeIndexError, type CodeIndexOptions, type CohesionAnalysisOptions, type CohesionFileReport, type CohesionFunctionReference, type CohesionGroup, type CohesionJsonReport, type CohesionLocation, type CohesionLocationCategory, type CohesionMetrics, type CohesionPair, type CohesionReport, type CrossSearchOptions, type CrossSearchResult, type CrossSearchSourceFilter, type DescriptionInput, type DescriptionProfile, type DescriptionProvider, type DescriptionStats, type EmbeddingProfile, type EmbeddingProvider, GitDivergenceError, GitUnavailableError, IncompatibleIndexError, type IndexStatus, type IndexedFunction, type IndexingError, type IndexingIssue, JinaEmbeddingProvider, type JinaEmbeddingProviderOptions, OpenAIDescriptionProvider, type OpenAIDescriptionProviderOptions, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderOptions, type ParsedCallable, type SimilarityResult, type SimilarityScores, type SimilaritySearchOptions, type SourceMode, type SupportedLanguage, type UpdateFilesOptions, type UpdateFromGitOptions, type UpdateFromWorkingTreeOptions, type UpdateStats, analyzeCodeCohesion, analyzeCohesion, cohesionLocation, crossSearch, crossSearchFunctions, disableDescriptions, openCodeIndex, readIndexErrors, searchDescription, similaritySearch, updateFiles, updateFromGit, updateFromWorkingTree, useDescriptions };