@ninjaxtools/slopdex 0.3.0 → 0.6.0

package/dist/index.d.ts

@@ -8,18 +8,25 @@ declare class CodeIndex {
     status(): IndexStatus;
     allFunctions(): IndexedFunction[];
     updateFiles(options: UpdateFilesOptions): Promise<UpdateStats>;
+    updateFromWorkingTree(options?: UpdateFromWorkingTreeOptions): Promise<UpdateStats>;
     updateFromGit(options?: UpdateFromGitOptions): Promise<UpdateStats>;
     similaritySearch(options: SimilaritySearchOptions): Promise<SimilarityResult[]>;
     similarToFunction(functionId: number, options: {
         limit: number;
         minSimilarity: number;
         maxSimilarity?: number;
+        excludePaths?: readonly string[];
+        minLines?: number;
+        nameRegex?: string;
     }): SimilarityResult[];
     vectorForFunction(functionId: number): number[];
     searchByVector(vector: readonly number[], options: {
         limit: number;
         minSimilarity: number;
         maxSimilarity?: number;
+        excludePaths?: readonly string[];
+        minLines?: number;
+        nameRegex?: string;
     }): SimilarityResult[];
     sourceFunctions(filter: CrossSearchSourceFilter): Promise<IndexedFunction[]>;
 }
@@ -39,6 +46,7 @@ interface ParsedCallable {
     startColumn: number;
     endLine: number;
     endColumn: number;
+    lineCount: number;
     source: string;
     sourceHash: string;
     embeddingInput: string;
@@ -88,6 +96,10 @@ interface UpdateFilesOptions {
 interface UpdateFromGitOptions {
     target?: string;
     rebuildOnDivergence?: boolean;
+    includeWorkingTree?: boolean;
+    signal?: AbortSignal;
+}
+interface UpdateFromWorkingTreeOptions {
     signal?: AbortSignal;
 }
 interface UpdateStats {
@@ -114,9 +126,12 @@ type CrossSearchSourceFilter = {
     type: "all";
     path?: string;
 } | {
-    type: "added-since";
+    type: "changed-since";
     commit: string;
     path?: string;
+} | {
+    type: "uncommitted";
+    path?: string;
 };
 interface CrossSearchOptions {
     source: CodeIndex;
@@ -126,6 +141,9 @@ interface CrossSearchOptions {
     minSimilarity?: number;
     maxSimilarity?: number;
     includeSymmetricDuplicates?: boolean;
+    crossFileOnly?: boolean;
+    minLines?: number;
+    nameRegex?: string;
     signal?: AbortSignal;
     onProgress?: (progress: {
         completed: number;
@@ -136,6 +154,107 @@ interface CrossSearchResult {
     source: IndexedFunction;
     matches: SimilarityResult[];
 }
+type CohesionLocationCategory = "same-file" | "same-folder" | "different-folder";
+interface CohesionLocation {
+    category: CohesionLocationCategory;
+    physicalDistance: number;
+    folderHops: number;
+    commonAncestor: string | null;
+    sourceTestPair: boolean;
+}
+interface CohesionFunctionReference {
+    path: string;
+    qualifiedName: string;
+    kind: CallableKind;
+    signature: string | null;
+    startLine: number;
+    startColumn: number;
+    endLine: number;
+    endColumn: number;
+    lineCount: number;
+    source?: string;
+}
+interface CohesionPair<FunctionValue = IndexedFunction> {
+    rank: number;
+    left: FunctionValue;
+    right: FunctionValue;
+    similarity: number;
+    reciprocal: boolean | null;
+    semanticWeight: number;
+    separationWeight: number;
+    cohesionGap: number;
+    location: CohesionLocation;
+}
+interface CohesionFileReport<FunctionValue = IndexedFunction> {
+    path: string;
+    functionCount: number;
+    internalAffinity: number;
+    sameFolderAffinity: number;
+    externalAffinity: number;
+    externalAffinityRatio: number;
+    strongestExternalMatch?: {
+        function: FunctionValue;
+        similarity: number;
+        cohesionGap: number;
+    };
+}
+interface CohesionGroup<FunctionValue = IndexedFunction> {
+    rank: number;
+    memberCount: number;
+    fileCount: number;
+    minimumEdgeSimilarity: number;
+    maximumEdgeSimilarity: number;
+    maximumPhysicalDistance: number;
+    maximumCohesionGap: number;
+    members: FunctionValue[];
+}
+interface CohesionSummary {
+    scope: "repository" | "selected-sources";
+    functionsAnalyzed: number;
+    candidateFunctions: number;
+    semanticEdges: number;
+    sameFileRatio: number;
+    sameFolderRatio: number;
+    remoteRatio: number;
+    weightedMeanDistance: number;
+}
+interface CohesionAnalysisOptions {
+    source: CodeIndex;
+    sourceFilter?: CrossSearchSourceFilter;
+    neighbors?: number;
+    limit?: number;
+    minSimilarity?: number;
+    maxSimilarity?: number;
+    minLines?: number;
+    nameRegex?: string;
+    signal?: AbortSignal;
+    onProgress?: (progress: {
+        completed: number;
+        total: number;
+    }) => void;
+}
+interface CohesionReport<FunctionValue = IndexedFunction> {
+    schemaVersion: 1;
+    repository: {
+        generation: number;
+        gitCheckpoint: string | null;
+        embeddingProfile: Required<EmbeddingProfile>;
+    };
+    parameters: {
+        neighbors: number;
+        limit: number;
+        minSimilarity: number;
+        maxSimilarity?: number;
+        minLines: number;
+        nameRegex?: string;
+        sourceFilter: CrossSearchSourceFilter;
+    };
+    summary: CohesionSummary;
+    pairs: CohesionPair<FunctionValue>[];
+    files: CohesionFileReport<FunctionValue>[];
+    groups: CohesionGroup<FunctionValue>[];
+}
+type CohesionJsonReport = CohesionReport<CohesionFunctionReference>;
 interface IndexStatus {
     rootDir: string;
     indexPath: string;
@@ -146,6 +265,9 @@ interface IndexStatus {
     embeddingProfile: Required<EmbeddingProfile>;
 }
 
+declare function analyzeCohesion(options: CohesionAnalysisOptions): Promise<CohesionReport>;
+declare function cohesionLocation(leftPath: string, rightPath: string): CohesionLocation;
+
 declare function crossSearch(options: CrossSearchOptions): AsyncGenerator<CrossSearchResult>;
 
 interface OpenAIEmbeddingProviderOptions {
@@ -200,6 +322,9 @@ declare class CodeIndexError extends Error {
 declare class GitDivergenceError extends CodeIndexError {
     constructor(checkpoint: string, target: string);
 }
+declare class GitUnavailableError extends CodeIndexError {
+    constructor(message: string, options?: ErrorOptions);
+}
 declare class IncompatibleIndexError extends CodeIndexError {
     constructor(message: string);
 }
@@ -207,7 +332,9 @@ declare class IncompatibleIndexError extends CodeIndexError {
 declare function openCodeIndex(options: CodeIndexOptions): CodeIndex;
 declare function updateFiles(index: CodeIndex, options: UpdateFilesOptions): Promise<UpdateStats>;
 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 crossSearchFunctions(options: CrossSearchOptions): AsyncGenerator<CrossSearchResult, any, any>;
+declare function analyzeCodeCohesion(options: CohesionAnalysisOptions): Promise<CohesionReport<IndexedFunction>>;
 
-export { type CallableKind, CodeIndex, CodeIndexError, type CodeIndexOptions, type CrossSearchOptions, type CrossSearchResult, type CrossSearchSourceFilter, type EmbeddingProfile, type EmbeddingProvider, GitDivergenceError, IncompatibleIndexError, type IndexStatus, type IndexedFunction, JinaEmbeddingProvider, type JinaEmbeddingProviderOptions, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderOptions, type ParsedCallable, type SimilarityResult, type SimilaritySearchOptions, type SourceMode, type SupportedLanguage, type UpdateFilesOptions, type UpdateFromGitOptions, type UpdateStats, crossSearch, crossSearchFunctions, openCodeIndex, similaritySearch, updateFiles, updateFromGit };
+export { 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, JinaEmbeddingProvider, type JinaEmbeddingProviderOptions, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderOptions, type ParsedCallable, type SimilarityResult, type SimilaritySearchOptions, type SourceMode, type SupportedLanguage, type UpdateFilesOptions, type UpdateFromGitOptions, type UpdateFromWorkingTreeOptions, type UpdateStats, analyzeCodeCohesion, analyzeCohesion, cohesionLocation, crossSearch, crossSearchFunctions, openCodeIndex, similaritySearch, updateFiles, updateFromGit, updateFromWorkingTree };