scip-query 0.20.0 → 0.21.1

package/dist/reindex.d.ts

@@ -1,15 +1,69 @@
-import { a as SupportedLanguage, I as IndexerConfig, T as TypeScriptProjectMode } from './config-types-jVM3D7MA.js';
-import { R as RefreshTrigger, L as LastRefreshMetadata } from './scip-cli-BnEwZRLJ.js';
-export { t as tryInstallScipCli } from './scip-cli-BnEwZRLJ.js';
+import { L as LastRefreshMetadata, R as RefreshTrigger, P as ProjectInputChangeJournal } from './scip-cli-H-n59izO.js';
+export { t as tryInstallScipCli } from './scip-cli-H-n59izO.js';
+import { a as SupportedLanguage, I as IndexerConfig, T as TypeScriptProjectMode } from './config-types-B9B60MiR.js';
 import { Index } from '@c4312/scip';
 
+interface ReindexWriteTelemetry {
+    reflinkedBytes: number;
+    fallbackCopiedBytes: number;
+    /** Conservative physical bytes written by bounded incremental database work. */
+    incrementalWrittenBytes?: number;
+}
+
+interface ReindexShardDiagnostic {
+    /** Unique id for this shard: the language, or `<language>:<projectPath>` for a TS workspace sub-project. */
+    id: string;
+    language: SupportedLanguage;
+    /** True when the cached shard was reused without rerunning its indexer. */
+    reused: boolean;
+    /** How this shard was obtained during the refresh. */
+    strategy: 'reused' | 'incremental' | 'full';
+    /** Present only when `reused` is false: why the cached shard could not be used. */
+    missReason?: string;
+    /** Present when a preferred refresh strategy failed and the shard was rebuilt another way. */
+    fallbackReason?: string;
+    /** Short hash of this shard's fingerprint inputs (source content + indexer options). */
+    fingerprint: string;
+    /** Size in bytes of the shard's cached SCIP output, or null when unavailable. */
+    outputBytes: number | null;
+    /** Bytes newly emitted by this run; absent when outputBytes is already the produced size. */
+    producedOutputBytes?: number;
+    /** Wall time spent producing this shard; 0 when reused. */
+    durationMs: number;
+    /** Indexer command invoked to produce this shard; absent when reused. */
+    command?: string;
+}
+interface ReindexResult {
+    /** Languages that were successfully indexed. */
+    languages: SupportedLanguage[];
+    indexPath: string;
+    dbPath: string;
+    durationMs: number;
+    /** True when existing SCIP/SQLite outputs were reused because inputs were unchanged. */
+    reused: boolean;
+    /**
+     * Languages detected in the project but skipped because their indexer
+     * could not be located, installed, or run. Each entry includes the reason.
+     */
+    skipped: {
+        language: SupportedLanguage;
+        reason: string;
+    }[];
+    /** Persisted description of this refresh attempt. */
+    lastRefresh?: LastRefreshMetadata;
+    /** Per-shard reuse diagnostics; one entry per language/workspace shard. */
+    shards?: ReindexShardDiagnostic[];
+    /** Staging-copy cost split by copy-on-write clones and real byte-copy fallbacks. */
+    writeTelemetry?: ReindexWriteTelemetry;
+}
+
 /**
  * Detect which languages are present in a project directory by checking for
  * marker files, root-level project files, and source-file extensions.
  */
 declare function detectLanguages(projectRoot: string): SupportedLanguage[];
 
-type PostIndexAugmentationFact = 'auxiliary-document' | 'synthetic-symbol' | 'source-mapped-occurrence' | 'definition-mention' | 'replacement-chunk' | 'fingerprint-cache';
+type PostIndexAugmentationFact = 'auxiliary-document' | 'synthetic-symbol' | 'source-mapped-occurrence' | 'definition-mention' | 'replacement-chunk' | 'fingerprint-cache' | 'runtime-boundary-observation' | 'runtime-boundary-link';
 interface PostIndexAugmentationContext {
     projectRoot: string;
     dbPath: string;
@@ -197,44 +251,12 @@ interface ReindexOptions {
     indexerConcurrency?: number;
     /** Source that requested this refresh, persisted for status and setup diagnostics. */
     trigger?: RefreshTrigger;
-}
-interface ReindexShardDiagnostic {
-    /** Unique id for this shard: the language, or `<language>:<projectPath>` for a TS workspace sub-project. */
-    id: string;
-    language: SupportedLanguage;
-    /** True when the cached shard was reused without rerunning its indexer. */
-    reused: boolean;
-    /** Present only when `reused` is false: why the cached shard could not be used. */
-    missReason?: string;
-    /** Short hash of this shard's fingerprint inputs (source content + indexer options). */
-    fingerprint: string;
-    /** Size in bytes of the shard's cached SCIP output, or null when unavailable. */
-    outputBytes: number | null;
-    /** Wall time spent producing this shard; 0 when reused. */
-    durationMs: number;
-    /** Indexer command invoked to produce this shard; absent when reused. */
-    command?: string;
-}
-interface ReindexResult {
-    /** Languages that were successfully indexed. */
-    languages: SupportedLanguage[];
-    indexPath: string;
-    dbPath: string;
-    durationMs: number;
-    /** True when existing SCIP/SQLite outputs were reused because inputs were unchanged. */
-    reused: boolean;
-    /**
-     * Languages detected in the project but skipped because their indexer
-     * could not be located, installed, or run. Each entry includes the reason.
-     */
-    skipped: {
-        language: SupportedLanguage;
-        reason: string;
-    }[];
-    /** Persisted description of this refresh attempt. */
-    lastRefresh?: LastRefreshMetadata;
-    /** Per-shard reuse diagnostics (plan6 6.5.2); one entry per language/workspace shard. */
-    shards?: ReindexShardDiagnostic[];
+    /** Exact watcher-observed changes since one accepted immutable generation. */
+    changeJournal?: ProjectInputChangeJournal;
+    /** When false, skip full language indexers after incremental misses. Default true. */
+    allowExpensiveRebuild?: boolean;
+    /** Cancel this reindex and every bounded child process. */
+    signal?: AbortSignal;
 }
 /**
  * Reindex a project: detect languages, run the appropriate SCIP indexer(s),