scip-query 0.20.0 → 0.21.0

package/dist/queries/anchors.d.ts

@@ -0,0 +1,123 @@
+import { F as FileKind } from '../file-kind-BKCVMNUf.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
+import { a as CalleeEvidenceSource } from '../call-graph-evidence-lZa2dwQA.js';
+import 'better-sqlite3';
+import '../config-types-Cm-VSEBb.js';
+
+type AnchorDiscoveryMatchSource = 'symbol' | 'path' | 'documentation' | 'source';
+interface AnchorDiscoveryTermMatch {
+    term: string;
+    sources: AnchorDiscoveryMatchSource[];
+    locations: Array<{
+        file: string;
+        line: number;
+    }>;
+}
+interface AnchorDiscoveryCandidate {
+    symbol: string;
+    label: string;
+    leaf: string;
+    file: string;
+    line: number;
+    endLine: number;
+    kind: 'callable' | 'type' | 'symbol';
+    fileKind: FileKind;
+    matches: AnchorDiscoveryTermMatch[];
+    focusLocations: Array<{
+        file: string;
+        line: number;
+        matchedTerms: string[];
+    }>;
+    matchedTerms: string[];
+    symbolMatchedTerms: string[];
+    symbolPhraseLength: number;
+    identityMatchedTerms: string[];
+    rarity: number;
+    symbolRarity: number;
+    /** Exact slash-delimited query path fragments matched by this candidate's repository path. */
+    queryPathMatches?: string[];
+    /** Exact current source size for the compiler-owned range, when available. */
+    sourceCharacters?: number;
+}
+interface AnchorDiscoveryRelation {
+    kind: 'call' | 'runtime-boundary';
+    fromSymbol: string;
+    fromLabel: string;
+    fromFile: string;
+    toSymbol: string;
+    toLabel: string;
+    toFile: string;
+    depth: number;
+    strength: 'exact' | 'derived';
+    evidence: CalleeEvidenceSource | 'scip-occurrence-callsite' | 'ast-member-import-candidate' | `runtime-boundary:${string}`;
+    callsiteLine: number | null;
+    runtimeBoundaryKey?: string;
+}
+interface AnchorDiscoveryGroup {
+    id: string;
+    kind: 'cross-boundary-flow' | 'parallel-paths' | 'connected-flow' | 'shared-callee-owners';
+    roots: AnchorDiscoveryCandidate[];
+    keyAnchors: AnchorDiscoveryCandidate[];
+    candidateOwnerCount: number;
+    omittedCandidateOwners: AnchorDiscoveryCandidate[];
+    ownerRecoveryCommands: string[];
+    upstreamEntries: AnchorDiscoveryUpstreamEntry[];
+    matchedTerms: string[];
+    /** Exact slash-delimited query path fragments covered by the group's roots. */
+    queryPathMatches?: string[];
+    relations: AnchorDiscoveryRelation[];
+    relationCount: number;
+    /** Number of independently named sides that carry at least one causal edge. */
+    parallelConnectedSides?: number;
+    /** Number of independently named sides whose matched root has an outgoing causal edge. */
+    parallelOrchestrationSides?: number;
+    /** Query vocabulary that occurs in the repository path on every batched side. */
+    parallelSharedPathTerms?: string[];
+    /** Rarest repository frequency among the shared path terms; lower is more discriminative. */
+    parallelSharedPathFrequency?: number;
+    /** Matched roots that initiate at least one returned causal relationship. */
+    orchestrationRootCount?: number;
+    omittedRelations: number;
+    systemMapCommand: string;
+}
+interface AnchorDiscoveryUpstreamEntry {
+    name: string;
+    file: string;
+    line: number;
+    endLine: number;
+    callsiteLine: number;
+}
+interface AnchorDiscoveryResult {
+    query: string;
+    /** Slash-delimited repository path fragments preserved from the original query. */
+    queryPathFragments?: string[];
+    normalizedTerms: string[];
+    matchedTerms: string[];
+    unmatchedTerms: string[];
+    groups: AnchorDiscoveryGroup[];
+    candidateRoots: AnchorDiscoveryCandidate[];
+    candidateRootCount: number;
+    analyzedRootCount: number;
+    omittedRootCount: number;
+    omittedGroupCount: number;
+    scannedFiles: number;
+    scannedBytes: number;
+    recoveryCommand: string | null;
+}
+interface AnchorDiscoveryOptions {
+    scope?: string;
+    limit?: number;
+    full?: boolean;
+    semantic?: boolean;
+}
+/**
+ * Locate a small set of graph starting points from vocabulary that already
+ * exists in the repository. Query words are normalized mechanically; their
+ * meaning is not inferred. The highest-ranked owning definitions receive a
+ * bounded two-hop call expansion so connected candidates can be selected in
+ * one model-visible packet.
+ */
+declare function discoverAnchors(db: ScipDatabase, query: string, options?: AnchorDiscoveryOptions): AnchorDiscoveryResult;
+declare function normalizeAnchorQuery(query: string): string[];
+
+export { type AnchorDiscoveryCandidate, type AnchorDiscoveryGroup, type AnchorDiscoveryMatchSource, type AnchorDiscoveryOptions, type AnchorDiscoveryRelation, type AnchorDiscoveryResult, type AnchorDiscoveryTermMatch, type AnchorDiscoveryUpstreamEntry, discoverAnchors, normalizeAnchorQuery };

package/dist/queries/anchors.js

@@ -0,0 +1,2 @@
+import{a,b}from"../chunk-XVDMJMES.js";import"../chunk-WB6LGCFB.js";import"../chunk-FEQIQ26E.js";import"../chunk-TNOHGHZQ.js";import"../chunk-TM5XEDDR.js";import"../chunk-YRVERHJR.js";import"../chunk-7TWP3MCP.js";import"../chunk-BOJ5SVE2.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as discoverAnchors,b as normalizeAnchorQuery};
+//# sourceMappingURL=anchors.js.map

package/dist/queries/architecture.d.ts

@@ -1,5 +1,5 @@
-import { A as ArchitectureConfig } from '../config-types-jVM3D7MA.js';
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { G as ArchitectureConfig } from '../config-types-Cm-VSEBb.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
 
 interface TestBoundaryViolation {
@@ -64,6 +64,7 @@ interface ArchitecturePolicyCoverage {
     totalBoundaries: number;
     missingRows: string[];
     requiresCompletePolicy: boolean;
+    requiresCompleteCoverage?: boolean;
     requiresMinimalPolicy: boolean;
 }
 /** A declared allowance that no observed edge uses. */

package/dist/queries/architecture.js

@@ -1,2 +1,2 @@
-import{a,b,c,d,e,f}from"../chunk-YTQVETEO.js";import"../chunk-QZ4JVECJ.js";import"../chunk-35NLDRZC.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-C43RDDP4.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as ARCHITECTURE_BASELINE_PREFIX,b as analyzeArchitectureGraph,c as architecture,d as architectureFindingIdentities,f as detectCoarseBoundaries,e as hasEnforceableArchitecturePolicy};
+import{a,b,c,d,e,f}from"../chunk-D5EKVZPI.js";import"../chunk-QDCCHMVZ.js";import"../chunk-35NLDRZC.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as ARCHITECTURE_BASELINE_PREFIX,b as analyzeArchitectureGraph,c as architecture,d as architectureFindingIdentities,f as detectCoarseBoundaries,e as hasEnforceableArchitecturePolicy};
 //# sourceMappingURL=architecture.js.map

package/dist/queries/bottlenecks.d.ts

@@ -1,18 +1,29 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
+interface CoordinationHubCalleeEvidence {
+    symbol: string;
+    shortName: string;
+    file: string;
+    evidenceStrength: 'exact' | 'candidate';
+    evidenceSource: string;
+}
 interface BottleneckResult {
     symbol: string;
     shortName: string;
     fanIn: number;
     fanOut: number;
     callerFiles: string[];
+    candidateCallerFiles?: string[];
     externalCallees: Array<{
         symbol: string;
         shortName: string;
         file: string;
     }>;
+    externalCalleeEvidence?: CoordinationHubCalleeEvidence[];
+    candidateExternalCallees?: string[];
+    inputBasis?: 'mixed-static-call-or-reference-evidence';
     /** fanIn * fanOut — higher = more central coupling hub */
     score: number;
     definedIn: string;
@@ -22,11 +33,11 @@ interface BottleneckResult {
     recommendation: string;
 }
 /**
- * Find coupling hubs: symbols with both high fan-in (many consumers)
- * AND high fan-out (references many other symbols).
+ * Find coordination hubs: symbols with both many incoming caller/reference
+ * evidence files and many outgoing cross-file callable targets.
  *
- * These are the most dangerous symbols to change — they sit at the
- * intersection of many dependency paths. Score = fanIn * fanOut.
+ * This is a coordination-hub heuristic, not a graph-theoretic articulation
+ * point or proof that a change is dangerous. Score = fanIn * fanOut.
  */
 declare function bottlenecks(db: ScipDatabase, opts?: {
     limit?: number;
@@ -36,5 +47,13 @@ declare function bottlenecks(db: ScipDatabase, opts?: {
     scanLimit?: number;
     semantic?: boolean;
 }): BottleneckResult[];
+declare function coordinationHubs(db: ScipDatabase, opts?: {
+    limit?: number;
+    scope?: string;
+    minFanIn?: number;
+    minFanOut?: number;
+    scanLimit?: number;
+    semantic?: boolean;
+}): BottleneckResult[];
 
-export { type BottleneckResult, bottlenecks };
+export { type BottleneckResult, type CoordinationHubCalleeEvidence, bottlenecks, coordinationHubs };

package/dist/queries/bottlenecks.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-RDO52JGY.js";import"../chunk-UJCOIXDY.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as bottlenecks};
+import{a,b}from"../chunk-KWARB5FZ.js";import"../chunk-BOJ5SVE2.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as bottlenecks,b as coordinationHubs};
 //# sourceMappingURL=bottlenecks.js.map

package/dist/queries/by-kind.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 interface ByKindResult {
     symbol: string;

package/dist/queries/by-kind.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-5E4WNAVD.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as byKind,b as kindCounts};
+import{a,b}from"../chunk-3PII3JI5.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as byKind,b as kindCounts};
 //# sourceMappingURL=by-kind.js.map

package/dist/queries/call-graph.d.ts

@@ -1,7 +1,15 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
+interface CallGraphEvidenceRow {
+    symbol: string;
+    shortName: string;
+    file: string;
+    relationship: 'resolved-call' | 'reference-candidate' | 'chunk-candidate';
+    evidenceStrength: 'exact' | 'candidate';
+    evidenceSource: string;
+}
 interface CallGraphResult {
     symbol: string;
     shortName: string;
@@ -17,6 +25,12 @@ interface CallGraphResult {
         shortName: string;
         file: string;
     }>;
+    callerEvidence?: CallGraphEvidenceRow[];
+    calleeEvidence?: CallGraphEvidenceRow[];
+    coverage?: {
+        scope: 'indexed-static-call-graph';
+        blindSpots: string[];
+    };
 }
 /**
  * Build a call graph for a symbol: who calls it (incoming) and
@@ -29,4 +43,4 @@ declare function callGraph(db: ScipDatabase, symbolPattern: string, opts?: {
     semantic?: boolean;
 }): CallGraphResult | null;
 
-export { type CallGraphResult, callGraph };
+export { type CallGraphEvidenceRow, type CallGraphResult, callGraph };

package/dist/queries/call-graph.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-3ORVDL3H.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as callGraph};
+import{a}from"../chunk-HWLCBKFE.js";import"../chunk-BOJ5SVE2.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as callGraph};
 //# sourceMappingURL=call-graph.js.map

package/dist/queries/change-surface.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 type ChangeRiskReasonKind = 'operational-root' | 'published-api' | 'metadata-unavailable';
 interface ChangeRiskReason {

package/dist/queries/change-surface.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-FTFP6O3L.js";import"../chunk-S7OYBOCK.js";import"../chunk-UJCOIXDY.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-BGBBVSH4.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as changeSurface};
+import{a}from"../chunk-PUVZNFVY.js";import"../chunk-HUZNZ3H2.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as changeSurface};
 //# sourceMappingURL=change-surface.js.map

package/dist/queries/cleanup-plan.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 interface CleanupPlanEntry {
     symbol: string;

package/dist/queries/cleanup-plan.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-CJST5ETY.js";import"../chunk-GOUBFH5O.js";import"../chunk-6SHPK5ZE.js";import"../chunk-UJCOIXDY.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{b as RemovedRangeIndex,a as cleanupPlan};
+import{a,b}from"../chunk-YUFWLWIC.js";import"../chunk-U2GPTA5U.js";import"../chunk-URMZLV2N.js";import"../chunk-BOJ5SVE2.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{b as RemovedRangeIndex,a as cleanupPlan};
 //# sourceMappingURL=cleanup-plan.js.map

package/dist/queries/co-change.d.ts

@@ -1,7 +1,7 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import { C as CoChangeCommitScope, a as CoChangeRecency, b as CoChangeSubjectContext, G as GitHistoryMode } from '../git-history-ChNHbfZQ.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 type CoChangePartnerClass = 'doc-code' | 'config-code' | 'schema-script' | 'model-view' | 'test-code' | 'same-feature' | 'unknown';
 interface CoChangePartnerClassification {

package/dist/queries/co-change.js

@@ -1,2 +1,2 @@
-import{a,b,c,d,e}from"../chunk-ZK26BAQL.js";import"../chunk-RUJURYSV.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-P5XHIJHI.js";import"../chunk-C43RDDP4.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{c as classifyCoChangePartner,b as coChange,e as coChangeStructuralLinkChecker,d as declaredCouplingSuggestionForPair,a as isCoChangeNoiseFile};
+import{a,b,c,d,e}from"../chunk-Q2J2VZZT.js";import"../chunk-DEUGHURX.js";import"../chunk-P5XHIJHI.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{c as classifyCoChangePartner,b as coChange,e as coChangeStructuralLinkChecker,d as declaredCouplingSuggestionForPair,a as isCoChangeNoiseFile};
 //# sourceMappingURL=co-change.js.map

package/dist/queries/code.d.ts

@@ -1,27 +1,6 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+export { S as SourceObservationFreshness, a as SourceSemanticFreshnessState } from '../repository-text-C0Q8VYdN.js';
+import '../db-LKJXAlNS.js';
+export { b as CodeBatchEntry, c as CodeBatchResult, d as CodeFileCoverage, e as CodeFileDefinitionLedgerEntry, f as CodeFileMemberMode, g as CodeRangeCoverage, h as CodeResolutionCandidate, C as CodeResult, i as CodeSelectorKind, j as CodeSelectorStatus, l as code, m as codeBatch } from '../code-CczEvHui.js';
+import './outline.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
-
-interface CodeResult {
-    symbol: string;
-    shortName: string;
-    relativePath: string;
-    startLine: number;
-    endLine: number;
-    language: string | null;
-    source: string;
-}
-/**
- * Read the source code for a symbol, bounded to its definition range.
- * Language-agnostic: just reads the file and extracts the relevant lines.
- *
- * Accepts:
- *   - Symbol name pattern: "processVegaMention"
- *   - Full short name: "src:modules:chat:processVegaMention"
- *   - File:line-line syntax: "src/chat/service.ts:100-200"
- */
-declare function code(db: ScipDatabase, symbolPattern: string, opts?: {
-    context?: number;
-}): CodeResult | null;
-
-export { type CodeResult, code };
+import '../config-types-Cm-VSEBb.js';

package/dist/queries/code.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-4MAK2HOY.js";import"../chunk-S7OYBOCK.js";import"../chunk-AQOFWNQJ.js";import"../chunk-T7YQSHPQ.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as code};
+import{d as a,e as b}from"../chunk-6SWA6B24.js";import"../chunk-FUG6RPYY.js";import"../chunk-KW6B5OL4.js";import"../chunk-B7ECWJAZ.js";import"../chunk-VETXXOYU.js";import"../chunk-HUZNZ3H2.js";import"../chunk-TNOHGHZQ.js";import"../chunk-TM5XEDDR.js";import"../chunk-7TWP3MCP.js";import"../chunk-ICUQONOG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as code,b as codeBatch};
 //# sourceMappingURL=code.js.map

package/dist/queries/complexity-hotspots.d.ts

@@ -1,7 +1,7 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import { BranchEstimateBasis } from './complexity.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 import '../symbol-types-BIQwfoAx.js';
 
 interface ComplexityHotspot {

package/dist/queries/complexity-hotspots.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-JW56N3KI.js";import"../chunk-ZTETIQ35.js";import"../chunk-4TURLRL5.js";import"../chunk-UJCOIXDY.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as complexityHotspots};
+import{a}from"../chunk-IOKWFRFQ.js";import"../chunk-QBANU5BQ.js";import"../chunk-IXJ26KJJ.js";import"../chunk-BOJ5SVE2.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as complexityHotspots};
 //# sourceMappingURL=complexity-hotspots.js.map

package/dist/queries/complexity.d.ts

@@ -1,7 +1,7 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import { S as SymbolMatch } from '../symbol-types-BIQwfoAx.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 interface SyntaxNode {
     type: string;

package/dist/queries/complexity.js

@@ -1,2 +1,2 @@
-import{a,b,c,d}from"../chunk-4TURLRL5.js";import"../chunk-UJCOIXDY.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-BGBBVSH4.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{b as branchEstimateForDefinition,c as branchEstimatesForDefinitions,a as complexity,d as countBranchesFromAst};
+import{a,b,c,d}from"../chunk-IXJ26KJJ.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{b as branchEstimateForDefinition,c as branchEstimatesForDefinitions,a as complexity,d as countBranchesFromAst};
 //# sourceMappingURL=complexity.js.map

package/dist/queries/context.d.ts

@@ -0,0 +1,145 @@
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
+import { b as CoChangeSubjectContext } from '../git-history-ChNHbfZQ.js';
+import { AffectedResult } from './affected.js';
+import { CallGraphResult } from './call-graph.js';
+import { ChangeSurfaceResult } from './change-surface.js';
+import { SimilarSymbolResult } from './similar.js';
+import { ComplexityResult } from './complexity.js';
+import { DataflowResult } from './dataflow.js';
+import { DepResult } from './deps.js';
+import { SliceResult } from './reference-reachability.js';
+import { SurfaceResult } from './surface.js';
+import { SystemResult } from './system.js';
+import { TraceResult } from './trace.js';
+import 'better-sqlite3';
+import '../config-types-Cm-VSEBb.js';
+import '../symbol-types-BIQwfoAx.js';
+import './symbols.js';
+
+interface RepositoryContextOptions {
+    semantic?: boolean;
+    impactDepth?: number;
+    sliceDepth?: number;
+    scope?: string;
+    /** Already-resolved invocation HEAD for snapshot-consistent history evidence. */
+    gitHead?: string;
+}
+/** Decision-time history risk for the target's file, from the change graph. */
+interface RepositoryContextHistory {
+    /** False when git history is unavailable or no file could be resolved. */
+    available: boolean;
+    file: string | null;
+    churn: {
+        changes: number;
+        fixChanges: number;
+        lastChangedAt: number;
+    } | null;
+    /** Files that usually change together with this one — edit checklist. */
+    coChangePartners: Array<{
+        file: string;
+        together: number;
+        confidence: number;
+        subjectContext: CoChangeSubjectContext;
+    }>;
+    /** Detector suppressions present in the file — known accepted findings. */
+    suppressionsInFile: number;
+}
+interface RepositoryContextAffectedConsumer {
+    symbol: string;
+    shortName: string;
+    file: string;
+    referenceCount: number;
+}
+interface RepositoryContextConsumerReuseCandidate {
+    /** Similarity evidence between one affected consumer and this possible existing owner. */
+    candidate: SimilarSymbolResult;
+    /** Affected consumers whose bounded similarity scan produced this same possible owner. */
+    consumers: RepositoryContextAffectedConsumer[];
+}
+interface RepositoryContextConsumerReuseCoverage {
+    totalConsumers: number;
+    analyzedConsumers: number;
+    omittedConsumers: number;
+    perConsumerSearchLimit: number;
+    perConsumerCandidateLimit: number;
+    candidateLimit: number;
+    returnedCandidates: number;
+}
+interface RepositoryContextConsumerReuse {
+    candidates: RepositoryContextConsumerReuseCandidate[];
+    coverage: RepositoryContextConsumerReuseCoverage;
+}
+interface RepositoryContextPrimaryCallable {
+    symbol: string;
+    shortName: string;
+    file: string;
+}
+interface RepositoryContextSourceSlice extends RepositoryContextPrimaryCallable {
+    role: 'target' | 'consumer' | 'reuse-candidate';
+    startLine: number;
+    endLine: number;
+    source: string;
+    omittedLines: number;
+    /** Exact reference lines inside a consumer-centered source window. */
+    focusLines?: number[];
+}
+interface RepositoryContextSourcePacket {
+    slices: RepositoryContextSourceSlice[];
+    candidateSlices: number;
+    omittedSlices: number;
+    maxSlices: number;
+    maxLinesPerSlice: number;
+    maxTotalLines: number;
+    targetLineLimit?: number;
+    consumerContextLines?: number;
+    reuseLineLimit?: number;
+}
+interface RepositoryContextResult {
+    target: string;
+    /** One callable selected from a file target only when the choice is unambiguous. */
+    primaryCallable?: RepositoryContextPrimaryCallable;
+    matched: {
+        symbol: boolean;
+        file: boolean;
+        module: boolean;
+    };
+    history: RepositoryContextHistory;
+    trace: TraceResult;
+    callGraph: CallGraphResult | null;
+    complexity: ComplexityResult | null;
+    dataflow: DataflowResult | null;
+    backwardSlice: SliceResult | null;
+    forwardSlice: SliceResult | null;
+    affected: AffectedResult[];
+    changeSurface: ChangeSurfaceResult | null;
+    deps: DepResult[];
+    rdeps: DepResult[];
+    system: SystemResult;
+    surface: SurfaceResult[];
+    /** Bounded existing symbols whose implementation evidence may support reuse. */
+    reuseCandidates?: SimilarSymbolResult[];
+    /**
+     * Bounded possible owners found by comparing functions that directly use
+     * the target. Kept separate because this is surrounding-behavior evidence,
+     * not evidence that the owner can replace the target itself.
+     */
+    affectedConsumerReuse?: RepositoryContextConsumerReuse;
+    /** Bounded source slices for the target, its direct consumers, and possible owners. */
+    sourcePacket?: RepositoryContextSourcePacket;
+    warnings: string[];
+}
+declare function repositoryContext(db: ScipDatabase, target: string, opts?: RepositoryContextOptions): RepositoryContextResult;
+interface AffectedConsumerReuseLimits {
+    consumerLimit?: number;
+    perConsumerSearchLimit?: number;
+    perConsumerCandidateLimit?: number;
+    candidateLimit?: number;
+}
+/**
+ * Turn compiler-resolved target references into a bounded search for existing
+ * owners of the surrounding consumer behavior. Exported for a pure contract
+ * test; production supplies `similar` as the evidence source.
+ */
+declare function discoverAffectedConsumerReuse(traceResult: Pick<TraceResult, 'referencedBy'>, targetSymbol: string | null, findSimilar: (consumerSymbol: string) => SimilarSymbolResult[], limits?: AffectedConsumerReuseLimits): RepositoryContextConsumerReuse;
+
+export { type RepositoryContextAffectedConsumer, type RepositoryContextConsumerReuse, type RepositoryContextConsumerReuseCandidate, type RepositoryContextConsumerReuseCoverage, type RepositoryContextHistory, type RepositoryContextOptions, type RepositoryContextPrimaryCallable, type RepositoryContextResult, type RepositoryContextSourcePacket, type RepositoryContextSourceSlice, discoverAffectedConsumerReuse, repositoryContext };

package/dist/queries/context.js

@@ -0,0 +1,2 @@
+import{a,b}from"../chunk-URTX2BEA.js";import"../chunk-X7PJJYKX.js";import"../chunk-73Z33VFI.js";import"../chunk-SYUNTKO2.js";import"../chunk-UL4VJUMD.js";import"../chunk-BBEDPVPB.js";import"../chunk-UQ7XPRWU.js";import"../chunk-5236NQV3.js";import"../chunk-PIZY2GX6.js";import"../chunk-HWLCBKFE.js";import"../chunk-PUVZNFVY.js";import"../chunk-Q2J2VZZT.js";import"../chunk-DEUGHURX.js";import"../chunk-FUG6RPYY.js";import"../chunk-B7ECWJAZ.js";import"../chunk-HUZNZ3H2.js";import"../chunk-IXJ26KJJ.js";import"../chunk-IDPLC3FI.js";import"../chunk-KMVGRIO2.js";import"../chunk-QD7IFBCR.js";import"../chunk-TM5XEDDR.js";import"../chunk-BOJ5SVE2.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{b as discoverAffectedConsumerReuse,a as repositoryContext};
+//# sourceMappingURL=context.js.map

package/dist/queries/convergence.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 interface ConvergenceResult {
     symbolA: {

package/dist/queries/convergence.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-3CLX5EOX.js";import"../chunk-Y2MVPNKY.js";import"../chunk-KMVGRIO2.js";import"../chunk-UJCOIXDY.js";import"../chunk-26QA6FAI.js";import"../chunk-AQOFWNQJ.js";import"../chunk-DHEQMPLW.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as convergence};
+import{a}from"../chunk-MOBF2GH6.js";import"../chunk-IDPLC3FI.js";import"../chunk-KMVGRIO2.js";import"../chunk-BOJ5SVE2.js";import"../chunk-JVZNWJBH.js";import"../chunk-BGBBVSH4.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-HEOMG7IM.js";import"../chunk-35IW3P4H.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as convergence};
 //# sourceMappingURL=convergence.js.map

package/dist/queries/coupling.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 interface CouplingResult {
     file1: string;
@@ -16,6 +16,7 @@ interface CouplingResult {
  * (symbols defined in one and referenced in the other, or vice versa).
  */
 declare function coupling(db: ScipDatabase, file1: string, file2: string): CouplingResult;
+declare function sharedSymbolCoupling(db: ScipDatabase, file1: string, file2: string): CouplingResult;
 /**
  * Find the most coupled file pairs in the codebase.
  */
@@ -23,5 +24,9 @@ declare function topCoupling(db: ScipDatabase, opts?: {
     limit?: number;
     scope?: string;
 }): CouplingResult[];
+declare function topSharedSymbolCoupling(db: ScipDatabase, opts?: {
+    limit?: number;
+    scope?: string;
+}): CouplingResult[];
 
-export { type CouplingResult, coupling, topCoupling };
+export { type CouplingResult, coupling, sharedSymbolCoupling, topCoupling, topSharedSymbolCoupling };