@ninjaxtools/slopdex 0.14.0 → 0.18.0

package/dist/code-index-YEFTNG7E.js

@@ -0,0 +1,14 @@
+import {
+  CodeIndex
+} from "./chunk-N6D66ASM.js";
+import "./chunk-6LHZCHEB.js";
+import "./chunk-TSURHRFF.js";
+import "./chunk-KQRS5P4U.js";
+import "./chunk-BXWO2KMC.js";
+import "./chunk-S225GYCL.js";
+import "./chunk-VH5VGRCI.js";
+import "./chunk-DKRB2XT5.js";
+export {
+  CodeIndex
+};
+//# sourceMappingURL=code-index-YEFTNG7E.js.map

package/dist/code-index-YEFTNG7E.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/cross-search-FVKDMGP7.js

@@ -0,0 +1,10 @@
+import {
+  crossSearch
+} from "./chunk-KUV6PKKL.js";
+import "./chunk-KQRS5P4U.js";
+import "./chunk-VH5VGRCI.js";
+import "./chunk-DKRB2XT5.js";
+export {
+  crossSearch
+};
+//# sourceMappingURL=cross-search-FVKDMGP7.js.map

package/dist/cross-search-FVKDMGP7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/database-KAPV2YMP.js

@@ -0,0 +1,14 @@
+import {
+  IndexDatabase,
+  readIndexErrorCounts,
+  readIndexErrors,
+  resetIndexState
+} from "./chunk-6LHZCHEB.js";
+import "./chunk-DKRB2XT5.js";
+export {
+  IndexDatabase,
+  readIndexErrorCounts,
+  readIndexErrors,
+  resetIndexState
+};
+//# sourceMappingURL=database-KAPV2YMP.js.map

package/dist/database-KAPV2YMP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/hosted-GHIUHKOU.js

@@ -0,0 +1,13 @@
+import {
+  CohereReranker,
+  JinaReranker
+} from "./chunk-DTI7SXGL.js";
+import "./chunk-BXWO2KMC.js";
+import "./chunk-S225GYCL.js";
+import "./chunk-VH5VGRCI.js";
+import "./chunk-DKRB2XT5.js";
+export {
+  CohereReranker,
+  JinaReranker
+};
+//# sourceMappingURL=hosted-GHIUHKOU.js.map

package/dist/hosted-GHIUHKOU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/index.d.ts

@@ -30,11 +30,93 @@ declare class CodeIndex {
         nameRegex?: string;
     }): SimilarityResult[];
     vectorForFunction(functionId: number, kind?: "code" | "description"): number[];
+    get readOnly(): boolean;
+    similarityCacheInfo(): {
+        cachedSources: number;
+        cachedPairs: number;
+    };
+    /**
+     * Incrementally refresh the persisted pairwise-similarity cache for same-index
+     * analysis. Only pairs scoring at or above `minSimilarity` (the caller's
+     * effective threshold) are stored; queries below the cached floor fall back to
+     * live vector search. Only functions whose embeddings changed (plus a merge
+     * pass over the remaining functions when the changed set is small) are
+     * re-queried; unchanged pairs are reused. Lowering the floor below what is
+     * cached re-queries every function, since the missing band cannot be rebuilt
+     * incrementally; raising it reuses the cache for free. A per-function state
+     * row records the embedding triple, floor, row count, and a completeness flag,
+     * so a sparse row set is never mistaken for an unfinished computation. Call
+     * before cross-search/cohesion, then read through
+     * {@link cachedSimilarToFunction}. Best-effort under concurrent writers: a
+     * later refresh repairs any rows raced by an overlapping update.
+     */
+    refreshSimilarityCache(options?: {
+        width?: number;
+        /** Minimum similarity stored; pairs below it are never cached. Defaults to -1 (cache everything). */
+        minSimilarity?: number;
+        signal?: AbortSignal;
+        /** Overrides the index-level onProgress for the cache-fill bar. */
+        onProgress?: (progress: IndexProgress) => void;
+    }): Promise<{
+        similarityMode: string;
+        width: number;
+        minSimilarity: number;
+        sourcesRefreshed: number;
+        pairsStored: number;
+        skipped: boolean;
+    }>;
+    /**
+     * Same-index neighbor lookup backed by {@link refreshSimilarityCache}.
+     * Returns cache rows filtered exactly like {@link similarToFunction} and falls
+     * back to a live vector query whenever the cache entry is missing, stale,
+     * computed at a higher floor than requested, or too truncated to satisfy the
+     * filters. A cache entry flagged complete holds every pair above its floor,
+     * so short results from it are exact and need no live query.
+     *
+     * Prefer {@link cachedSimilarityReader} inside per-function loops: it loads
+     * the validity snapshot once instead of re-reading it for every function.
+     */
+    cachedSimilarToFunction(functionId: number, options: {
+        includeDescriptions?: boolean;
+        limit: number;
+        minSimilarity: number;
+        maxSimilarity?: number;
+        excludePaths?: readonly string[];
+        minLines?: number;
+        nameRegex?: string;
+    }): SimilarityResult[];
+    /**
+     * Snapshot the similarity-cache validity state (per-mode states, embedding
+     * triples, generation) once for a run of neighbor lookups. The returned
+     * lookup behaves exactly like {@link cachedSimilarToFunction} but avoids
+     * re-reading whole tables per function; refresh the cache first and create
+     * one reader per analysis run. Best-effort under concurrent writers, like the
+     * refresh itself: a concurrent mutation mid-run is picked up by the next run.
+     *
+     * A fallback scan doubles as a read-repair: when the entry is fresh but
+     * unusable (missing, recorded at a higher floor, or incomplete), the scan is
+     * widened to the full cache width and written back, so later lookups hit.
+     * Stale entries are left for the refresh, dense-at-max-width entries cannot
+     * be improved, and read-only indexes never write.
+     */
+    cachedSimilarityReader(options?: {
+        includeDescriptions?: boolean;
+    }): {
+        similarToFunction: (functionId: number, query: {
+            includeDescriptions?: boolean;
+            limit: number;
+            minSimilarity: number;
+            maxSimilarity?: number;
+            excludePaths?: readonly string[];
+            minLines?: number;
+            nameRegex?: string;
+        }) => SimilarityResult[];
+    };
     vectorForFile(filePath: string): number[];
     searchByVector(vector: readonly number[], options: {
         descriptionVector?: readonly number[];
         fileDescriptionVector?: readonly number[];
-        limit: number;
+        limit?: number;
         minSimilarity: number;
         maxSimilarity?: number;
         excludePaths?: readonly string[];
@@ -164,6 +246,12 @@ interface DescriptionStats {
     fileDescriptionsCreated: number;
     descriptionsEnabled: boolean;
 }
+type IndexProgressPhase = "vectors" | "descriptions" | "description-vectors" | "similarity-cache" | "cross-search";
+interface IndexProgress {
+    phase: IndexProgressPhase;
+    completed: number;
+    total: number;
+}
 interface CodeIndexOptions {
     rootDir: string;
     indexPath?: string;
@@ -172,10 +260,16 @@ interface CodeIndexOptions {
     reranker?: Reranker;
     descriptionProvider?: DescriptionProvider;
     onWarning?: (message: string) => void;
+    /** Maximum number of concurrent provider requests for vectors and descriptions. */
+    parallelism?: number;
+    /** Receives vector and description generation progress updates. */
+    onProgress?: (progress: IndexProgress) => void;
     include?: readonly string[];
     exclude?: readonly string[];
     maxFileSize?: number;
     embeddingBatchSize?: number;
+    /** Emit a stderr notice for every call made by the default description provider. */
+    verbose?: boolean;
     readOnly?: boolean;
 }
 interface UpdateFilesOptions {
@@ -275,6 +369,8 @@ interface CrossSearchOptions {
         completed: number;
         total: number;
     }) => void;
+    /** Receives similarity-cache fill progress; defaults to the source index's onProgress. */
+    onCacheProgress?: (progress: IndexProgress) => void;
 }
 interface CrossSearchMatch extends SimilarityResult {
     /** Present when cohesion re-ranking is enabled. */
@@ -364,6 +460,8 @@ interface CohesionAnalysisOptions {
         completed: number;
         total: number;
     }) => void;
+    /** Receives similarity-cache fill progress; defaults to the source index's onProgress. */
+    onCacheProgress?: (progress: IndexProgress) => void;
 }
 interface CohesionReport<FunctionValue = IndexedFunction> {
     schemaVersion: 3;
@@ -418,6 +516,8 @@ interface OpenAIEmbeddingProviderOptions {
     model?: string;
     dimensions?: number;
     baseUrl?: string;
+    verbose?: boolean;
+    parallelism?: number;
 }
 declare class OpenAIEmbeddingProvider implements EmbeddingProvider {
     #private;
@@ -441,6 +541,9 @@ interface OpenAIDescriptionProviderOptions {
     model?: string;
     baseUrl?: string;
     provider?: DescriptionProviderName;
+    verbose?: boolean;
+    retryDelayMs?: number;
+    parallelism?: number;
 }
 declare const DESCRIPTION_PROVIDER_NAMES: readonly ["openai", "opencode", "opencode-go"];
 type DescriptionProviderName = typeof DESCRIPTION_PROVIDER_NAMES[number];
@@ -466,6 +569,8 @@ interface JinaEmbeddingProviderOptions {
     model?: string;
     dimensions?: number;
     baseUrl?: string;
+    verbose?: boolean;
+    parallelism?: number;
 }
 declare class JinaEmbeddingProvider implements EmbeddingProvider {
     #private;
@@ -488,6 +593,7 @@ interface HostedRerankerOptions {
     apiKey?: string;
     model?: string;
     baseUrl?: string;
+    verbose?: boolean;
 }
 interface HostedRerankerSettings {
     provider: "cohere" | "jina";
@@ -525,6 +631,7 @@ interface OpenAILLMRerankerOptions {
     model?: string;
     baseUrl?: string;
     candidateCount?: number;
+    verbose?: boolean;
 }
 declare class OpenAILLMReranker implements Reranker {
     #private;
@@ -571,4 +678,4 @@ declare function searchDescription(index: CodeIndex, options: SimilaritySearchOp
 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, CohereReranker, type CohereRerankerOptions, type CohesionAnalysisOptions, type CohesionFileReport, type CohesionFunctionReference, type CohesionGroup, type CohesionJsonReport, type CohesionLocation, type CohesionLocationCategory, type CohesionMetrics, type CohesionPair, type CohesionReport, type CrossSearchMatch, type CrossSearchOptions, type CrossSearchResult, type CrossSearchSourceFilter, type DescriptionFileInput, type DescriptionFileSession, type DescriptionInput, type DescriptionProfile, type DescriptionProvider, type DescriptionProviderName, type DescriptionStats, type EmbeddingProfile, type EmbeddingProvider, GitDivergenceError, GitUnavailableError, IncompatibleIndexError, type IndexStatus, type IndexedFunction, type IndexingError, type IndexingIssue, JinaEmbeddingProvider, type JinaEmbeddingProviderOptions, JinaReranker, type JinaRerankerOptions, OpenAIDescriptionProvider, type OpenAIDescriptionProviderOptions, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderOptions, OpenAILLMReranker, type OpenAILLMRerankerOptions, type ParsedCallable, type ReindexFilesOptions, type ReindexFilesStats, type Reranker, type RerankerProfile, 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, reindexFiles, searchDescription, similaritySearch, updateFiles, updateFromGit, updateFromWorkingTree, useDescriptions };
+export { type AnalysisSimilarity, type CallableKind, CodeIndex, CodeIndexError, type CodeIndexOptions, CohereReranker, type CohereRerankerOptions, type CohesionAnalysisOptions, type CohesionFileReport, type CohesionFunctionReference, type CohesionGroup, type CohesionJsonReport, type CohesionLocation, type CohesionLocationCategory, type CohesionMetrics, type CohesionPair, type CohesionReport, type CrossSearchMatch, type CrossSearchOptions, type CrossSearchResult, type CrossSearchSourceFilter, type DescriptionFileInput, type DescriptionFileSession, type DescriptionInput, type DescriptionProfile, type DescriptionProvider, type DescriptionProviderName, type DescriptionStats, type EmbeddingProfile, type EmbeddingProvider, GitDivergenceError, GitUnavailableError, IncompatibleIndexError, type IndexProgress, type IndexProgressPhase, type IndexStatus, type IndexedFunction, type IndexingError, type IndexingIssue, JinaEmbeddingProvider, type JinaEmbeddingProviderOptions, JinaReranker, type JinaRerankerOptions, OpenAIDescriptionProvider, type OpenAIDescriptionProviderOptions, OpenAIEmbeddingProvider, type OpenAIEmbeddingProviderOptions, OpenAILLMReranker, type OpenAILLMRerankerOptions, type ParsedCallable, type ReindexFilesOptions, type ReindexFilesStats, type Reranker, type RerankerProfile, 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, reindexFiles, searchDescription, similaritySearch, updateFiles, updateFromGit, updateFromWorkingTree, useDescriptions };