scip-query 0.10.12 → 0.12.0

package/dist/queries/similar.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface SimilarSymbolResult {
     symbolA: string;
@@ -24,6 +24,29 @@ interface SimilarSymbolResult {
     evidenceClassReasons: string[];
     recommendation: string;
 }
+interface SimilarConsolidationPlan {
+    symbolA: {
+        symbol: string;
+        shortName: string;
+        file: string;
+        loc: number;
+    };
+    symbolB: {
+        symbol: string;
+        shortName: string;
+        file: string;
+        loc: number;
+    };
+    similarity: number;
+    similarityBasis: NonNullable<SimilarSymbolResult['similarityBasis']>;
+    sharedEvidence: string[];
+    uniqueToA: string[];
+    uniqueToB: string[];
+    evidenceClass: SimilarEvidenceClass;
+    actionTier: SimilarActionTier;
+    recommendation: string;
+    consolidationStrategy: string;
+}
 type SimilarEvidenceClass = 'access-query-scaffolding' | 'domain-behavior' | 'framework-scaffolding' | 'mixed' | 'structural-overlap';
 type SimilarActionTier = 'direct' | 'signal';
 interface SimilarEvidenceClassification {
@@ -54,7 +77,21 @@ declare function similar(db: ScipDatabase, symbolPattern: string, opts?: {
     semantic?: boolean;
     sourceCandidateMode?: SourceCandidateMode;
 }): SimilarSymbolResult[];
+declare function similarConsolidationPlan(db: ScipDatabase, symbolPatternA: string, symbolPatternB: string, opts?: {
+    semantic?: boolean;
+    scanLimit?: number;
+}): SimilarConsolidationPlan | null;
 declare function targetSpecificIdfWeights(target: SymbolFingerprint, index: Pick<CalleeFingerprintIndex, 'corpus' | 'docFreq'>): Map<string, number>;
+interface ComparePairOptions {
+    minSimilarity: number;
+    /** Pair is dropped when significantShared.length < this AND sharedCount < requireSharedCount. */
+    requireSignificantShared: number;
+    requireSharedCount: number;
+    medianIdf?: number;
+    magnitudeA?: number;
+    magnitudeB?: number;
+}
+declare function comparePair(a: SymbolFingerprint, b: SymbolFingerprint, idfWeights: ReadonlyMap<string, number>, opts: ComparePairOptions): SimilarSymbolResult | null;
 /**
  * Find similar symbols across the entire codebase.
  * Uses TF-IDF weighted similarity to filter out infrastructure noise.
@@ -142,7 +179,9 @@ declare function getCalleeFingerprintIndex(db: ScipDatabase, opts: CalleeFingerp
 declare function similarityFingerprintProduct(db: ScipDatabase): SimilarityFingerprintProduct;
 declare function buildCalleeFingerprintIndex(corpus: readonly SymbolFingerprint[]): CalleeFingerprintIndex;
 declare function candidateFingerprintsForTarget(target: SymbolFingerprint, index: CalleeFingerprintIndex): SymbolFingerprint[];
+declare const SAME_FILE_SIBLING_SATURATION_THRESHOLD = 5;
+declare function trimSameFileSiblingSaturatedCallees(fingerprints: readonly SymbolFingerprint[]): SymbolFingerprint[];
 declare function meaningfulCallees(callees: Iterable<string>): Set<string>;
 declare function classifySimilarityEvidence(sharedEvidence: readonly string[], basis: NonNullable<SimilarSymbolResult['similarityBasis']>): SimilarEvidenceClassification;
 
-export { type CalleeFingerprintCorpusOptions, type CalleeFingerprintIndex, type CalleeFingerprintIndexOptions, type RankedSimilarResult, type SimilarActionTier, type SimilarEvidenceClass, type SimilarEvidenceClassification, type SimilarSymbolResult, type SimilarityFingerprintProduct, type SourceCandidateMode, type SourceFingerprint, type SourceFingerprintCandidateOptions, type SourceFingerprintIndex, type SourceFingerprintOptions, type SymbolFingerprint, buildCalleeFingerprintIndex, candidateFingerprintsForTarget, classifySimilarityEvidence, getAllCalleeFingerprints, getCalleeFingerprintIndex, insertTopSimilarResult, meaningfulCallees, similar, similarAll, similarAllCount, similarityFingerprintProduct, targetSpecificIdfWeights };
+export { type CalleeFingerprintCorpusOptions, type CalleeFingerprintIndex, type CalleeFingerprintIndexOptions, type RankedSimilarResult, SAME_FILE_SIBLING_SATURATION_THRESHOLD, type SimilarActionTier, type SimilarConsolidationPlan, type SimilarEvidenceClass, type SimilarEvidenceClassification, type SimilarSymbolResult, type SimilarityFingerprintProduct, type SourceCandidateMode, type SourceFingerprint, type SourceFingerprintCandidateOptions, type SourceFingerprintIndex, type SourceFingerprintOptions, type SymbolFingerprint, buildCalleeFingerprintIndex, candidateFingerprintsForTarget, classifySimilarityEvidence, comparePair, getAllCalleeFingerprints, getCalleeFingerprintIndex, insertTopSimilarResult, meaningfulCallees, similar, similarAll, similarAllCount, similarConsolidationPlan, similarityFingerprintProduct, targetSpecificIdfWeights, trimSameFileSiblingSaturatedCallees };

package/dist/queries/similar.js

@@ -1,2 +1,2 @@
-import{a,b,c,d,e,f,g,h,i,j,k,l}from"../chunk-Z2LDWIJV.js";import"../chunk-ELC77ZDE.js";import"../chunk-B75HZHUP.js";import"../chunk-RM2WQ75T.js";import"../chunk-WUOB4DHH.js";import"../chunk-BGBBVSH4.js";import"../chunk-L446VQYQ.js";import"../chunk-RSSXKJ6J.js";import"../chunk-UQ73QF5D.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-F6IXELII.js";import"../chunk-ULHLDOD6.js";import"../chunk-DVFP6PZI.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{i as buildCalleeFingerprintIndex,j as candidateFingerprintsForTarget,l as classifySimilarityEvidence,f as getAllCalleeFingerprints,g as getCalleeFingerprintIndex,e as insertTopSimilarResult,k as meaningfulCallees,a as similar,c as similarAll,d as similarAllCount,h as similarityFingerprintProduct,b as targetSpecificIdfWeights};
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p}from"../chunk-BCNT6ODA.js";import"../chunk-KMVGRIO2.js";import"../chunk-B75HZHUP.js";import"../chunk-UAHZ57BR.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-72MFTCU5.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{m as SAME_FILE_SIBLING_SATURATION_THRESHOLD,k as buildCalleeFingerprintIndex,l as candidateFingerprintsForTarget,p as classifySimilarityEvidence,d as comparePair,h as getAllCalleeFingerprints,i as getCalleeFingerprintIndex,g as insertTopSimilarResult,o as meaningfulCallees,a as similar,e as similarAll,f as similarAllCount,b as similarConsolidationPlan,j as similarityFingerprintProduct,c as targetSpecificIdfWeights,n as trimSameFileSiblingSaturatedCallees};
 //# sourceMappingURL=similar.js.map

package/dist/queries/slice.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface SliceResult {
     symbol: string;

package/dist/queries/slice.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-CXWCLVYL.js";import"../chunk-RM2WQ75T.js";import"../chunk-WUOB4DHH.js";import"../chunk-BGBBVSH4.js";import"../chunk-L446VQYQ.js";import"../chunk-RSSXKJ6J.js";import"../chunk-UQ73QF5D.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-F6IXELII.js";import"../chunk-ULHLDOD6.js";import"../chunk-DVFP6PZI.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as slice};
+import{a}from"../chunk-T7VQG55Q.js";import"../chunk-UAHZ57BR.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-72MFTCU5.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as slice};
 //# sourceMappingURL=slice.js.map

package/dist/queries/stale-abstractions.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 type StaleAbstractionActionTier = 'direct' | 'signal';
 type StalenessKind = 'unused-abstraction' | 'misplaced-single-consumer-type' | 'single-consumer-abstraction' | 'one-to-one-class-encapsulation';

package/dist/queries/stale-abstractions.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-T3AEVJBG.js";import"../chunk-2FMFF4RI.js";import"../chunk-UVPY3RUZ.js";import"../chunk-B75HZHUP.js";import"../chunk-RM2WQ75T.js";import"../chunk-WUOB4DHH.js";import"../chunk-BGBBVSH4.js";import"../chunk-L446VQYQ.js";import"../chunk-RSSXKJ6J.js";import"../chunk-UQ73QF5D.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-F6IXELII.js";import"../chunk-ULHLDOD6.js";import"../chunk-DVFP6PZI.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as staleAbstractions};
+import{a}from"../chunk-D7J6GZAG.js";import"../chunk-T6NGEV5I.js";import"../chunk-K6UI6EBZ.js";import"../chunk-B75HZHUP.js";import"../chunk-UAHZ57BR.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-72MFTCU5.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as staleAbstractions};
 //# sourceMappingURL=stale-abstractions.js.map

package/dist/queries/stats.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface StatsResult {
     documents: number;

package/dist/queries/surface.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface SurfaceResult {
     consumer: string;

package/dist/queries/surface.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-VB2EZZPA.js";import"../chunk-OFXN2BCT.js";import"../chunk-RM2WQ75T.js";import"../chunk-WUOB4DHH.js";import"../chunk-BGBBVSH4.js";import"../chunk-L446VQYQ.js";import"../chunk-RSSXKJ6J.js";import"../chunk-UQ73QF5D.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-F6IXELII.js";import"../chunk-ULHLDOD6.js";import"../chunk-DVFP6PZI.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as surface};
+import{a}from"../chunk-OPE5YXFE.js";import"../chunk-OSWF3HSF.js";import"../chunk-UAHZ57BR.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-72MFTCU5.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as surface};
 //# sourceMappingURL=surface.js.map

package/dist/queries/symbols.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface SymbolResult {
     startLine: number;

package/dist/queries/symbols.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-AOWFUGDL.js";import"../chunk-OFXN2BCT.js";import"../chunk-NBNEVLRC.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as symbols};
+import{a}from"../chunk-PXHPCWX5.js";import"../chunk-OSWF3HSF.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as symbols};
 //# sourceMappingURL=symbols.js.map

package/dist/queries/system.d.ts

@@ -1,7 +1,7 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import { SymbolResult } from './symbols.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface SystemResult {
     files: string[];

package/dist/queries/system.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-LEHVP4DY.js";import"../chunk-OFXN2BCT.js";import"../chunk-NBNEVLRC.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as system};
+import{a}from"../chunk-7ITCOJGD.js";import"../chunk-OSWF3HSF.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as system};
 //# sourceMappingURL=system.js.map

package/dist/queries/trace.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface TraceResult {
     definitions: Array<{

package/dist/queries/trace.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-2GLNBCHB.js";import"../chunk-UQ73QF5D.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-ULHLDOD6.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as trace};
+import{a}from"../chunk-52Q4JFDW.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as trace};
 //# sourceMappingURL=trace.js.map

package/dist/queries/twin-ab.d.ts

@@ -0,0 +1,55 @@
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
+import 'better-sqlite3';
+import '../config-types-BrHl3Bge.js';
+
+/**
+ * twin-ab (Q4): mechanical support for scip-integrity-audit drill 5
+ * ("cross-examine same-concept twins" — feed both the same input and
+ * require the same answer). v1 is a scaffold generator, not an executor:
+ * generating realistic inputs for arbitrary types is a rabbit hole, so this
+ * resolves both referents, verifies they are callable and importable, and
+ * emits a ready-to-fill vitest file — the agent fills the input table and
+ * runs it.
+ */
+interface TwinAbSymbol {
+    ref: string;
+    symbol: string;
+    shortName: string;
+    file: string;
+    startLine: number;
+    /** Cleaned SCIP signature text (e.g. `(value: string): string`); null when the index has none. */
+    signature: string | null;
+    /** Top-level parameter count parsed from `signature`; null when unparseable. */
+    paramCount: number | null;
+}
+interface TwinAbSuccess {
+    ok: true;
+    a: TwinAbSymbol;
+    b: TwinAbSymbol;
+    /** Null when either side's param count is unknown — compatibility cannot be judged. */
+    signatureCompatible: boolean | null;
+    testSource: string;
+}
+interface TwinAbRefusal {
+    ok: false;
+    reason: string;
+}
+type TwinAbOutcome = TwinAbSuccess | TwinAbRefusal;
+/**
+ * Project-root-relative default `--out` path when the caller doesn't pass
+ * one — a deterministic, ref-derived path under a dedicated generated-
+ * artifacts directory, mirroring `tla scaffold`'s convention of a fixed
+ * project-relative directory (`specs/<moduleName>`) rather than an OS tmp
+ * dir. Derived from the raw ref strings (not the resolved symbols) so the
+ * caller can compute it before resolution — `twinAb` needs the output path
+ * up front to compute import specifiers.
+ */
+declare function defaultTwinAbOutPath(refA: string, refB: string): string;
+/**
+ * `outFile` is the absolute path the caller intends to write the generated
+ * vitest file to — needed up front so the generated `import` specifiers are
+ * correct relative paths, not just the twin's own file paths.
+ */
+declare function twinAb(db: ScipDatabase, refA: string, refB: string, outFile: string): TwinAbOutcome;
+
+export { type TwinAbOutcome, type TwinAbRefusal, type TwinAbSuccess, type TwinAbSymbol, defaultTwinAbOutPath, twinAb };

package/dist/queries/twin-ab.js

@@ -0,0 +1,2 @@
+import{a,b}from"../chunk-NQ75OVUU.js";import"../chunk-EZ5WDZ2Q.js";import"../chunk-QARYU7R3.js";import"../chunk-K6UI6EBZ.js";import"../chunk-B75HZHUP.js";import"../chunk-UAHZ57BR.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-72MFTCU5.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as defaultTwinAbOutPath,b as twinAb};
+//# sourceMappingURL=twin-ab.js.map

package/dist/queries/twin-drift.d.ts

@@ -0,0 +1,97 @@
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
+import 'better-sqlite3';
+import '../config-types-BrHl3Bge.js';
+
+/**
+ * Twin-drift: same leaf name (or a near-name variant like escapeRegex vs
+ * escapeRegExp), used across two or more files, with bodies that have
+ * *diverged* rather than stayed identical or being unrelated homonyms.
+ *
+ * Distinct from the existing detectors:
+ * - duplicate-bodies requires byte-identical normalized bodies.
+ * - similar requires callee-set overlap (any names).
+ * - similar-signatures requires the same type shape (any names).
+ *
+ * This one is the missing "same concept, drifted implementation" case:
+ * React/Vue helper families with drifted thresholds, escapeRegex vs
+ * escapeRegExp, etc.
+ */
+type TwinRelationship = 'identical' | 'divergent' | 'homonym';
+interface TwinMember {
+    symbol: string;
+    shortName: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+    loc: number;
+}
+interface TwinGroup {
+    /** Representative leaf name for the near-name cluster. */
+    leaf: string;
+    relationship: TwinRelationship;
+    /** 1 - normalized-token Jaccard similarity of the closest cross-file pair, rounded to 3 decimals. */
+    maxDivergence: number;
+    members: TwinMember[];
+    /** First differing normalized token run between the closest divergent pair. Only set for 'divergent' groups. */
+    firstDivergentTokens?: string;
+}
+/** Pure input record — the seam `groupTwins` tests are written against. */
+interface TwinDriftRecord {
+    leaf: string;
+    symbol: string;
+    shortName: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+    loc: number;
+    normalizedBody: string;
+    tokens: readonly string[];
+    /**
+     * True when the body is (up to a short guard) nothing more than a single
+     * call expression, optionally `return`ed/`await`ed — the shape a thin
+     * controller/service/storage delegate has. Purely structural (source-text
+     * based); doesn't by itself mean the call target is the other twin — see
+     * `isDelegatePair`/`buildDelegationChecker` for that.
+     */
+    isThinForwarder: boolean;
+}
+declare function twinDrift(db: ScipDatabase, opts?: {
+    scope?: string;
+    minSimilarity?: number;
+    includeHomonyms?: boolean;
+    limit?: number;
+    scanLimit?: number;
+}): TwinGroup[];
+/**
+ * Every classified twin group (identical, divergent, homonym) — including
+ * the 'identical' groups `twinDrift` always defers to duplicate-bodies.
+ * Internal consumers like diff-gate's twin-partner check need 'identical'
+ * groups too (a same-name pair that WAS byte-identical is exactly the kind
+ * of pair a one-sided edit should alarm on).
+ */
+declare function allTwinGroups(db: ScipDatabase, opts?: {
+    scope?: string;
+    minSimilarity?: number;
+    scanLimit?: number;
+}): TwinGroup[];
+/**
+ * Pure grouping core: cluster records by (near-)leaf name, then classify
+ * each cross-file cluster by its closest pair's body similarity.
+ *   - every cross-file pair byte-identical after normalization -> 'identical' (defer to duplicate-bodies)
+ *   - closest pair similarity in [minSimilarity, 1)                -> 'divergent' (the finding)
+ *   - closest pair similarity < minSimilarity                      -> 'homonym' (coincidental name reuse)
+ */
+declare function groupTwins(records: readonly TwinDriftRecord[], opts?: {
+    minSimilarity?: number;
+    /**
+     * Injected so this stays a pure/DB-free function for `groupTwins`'s unit
+     * tests: `isDelegatePair(from, to, clusterMembers)` answers "is `from` a
+     * thin forwarder whose call target resolves to `to` (directly, or by
+     * chaining through same-leaf-name delegates found in `clusterMembers`)?"
+     * `allTwinGroups` wires the real, source/import-backed implementation
+     * via `buildDelegationChecker`.
+     */
+    isDelegatePair?: (from: TwinDriftRecord, to: TwinDriftRecord, clusterMembers: readonly TwinDriftRecord[]) => boolean;
+}): TwinGroup[];
+
+export { type TwinDriftRecord, type TwinGroup, type TwinMember, type TwinRelationship, allTwinGroups, groupTwins, twinDrift };

package/dist/queries/twin-drift.js

@@ -0,0 +1,2 @@
+import{a,b,c}from"../chunk-EDB7Y442.js";import"../chunk-Q3B3FNCU.js";import"../chunk-FXG3PHVW.js";import"../chunk-B75HZHUP.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{b as allTwinGroups,c as groupTwins,a as twinDrift};
+//# sourceMappingURL=twin-drift.js.map

package/dist/queries/unused-imports.d.ts

@@ -1,4 +1,4 @@
-import '../db-rMZO5JFK.js';
+import '../db-_Bdx0E1W.js';
 export { ImportResult, UnusedImportResult, importedBy, imports, unusedImports } from './imports.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';

package/dist/queries/unused-imports.js

@@ -1,2 +1,2 @@
-import{a,b,c}from"../chunk-4ISHQ7UW.js";import"../chunk-OFXN2BCT.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-ULHLDOD6.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{b as importedBy,a as imports,c as unusedImports};
+import{a,b,c}from"../chunk-ETU2I5JM.js";import"../chunk-OSWF3HSF.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{b as importedBy,a as imports,c as unusedImports};
 //# sourceMappingURL=unused-imports.js.map

package/dist/queries/unused-params.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface UnusedParamsFinding {
     symbol: string;

package/dist/queries/unused-params.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-XHMVZFA6.js";import"../chunk-UVPY3RUZ.js";import"../chunk-B75HZHUP.js";import"../chunk-RM2WQ75T.js";import"../chunk-WUOB4DHH.js";import"../chunk-BGBBVSH4.js";import"../chunk-L446VQYQ.js";import"../chunk-RSSXKJ6J.js";import"../chunk-UQ73QF5D.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-F6IXELII.js";import"../chunk-ULHLDOD6.js";import"../chunk-DVFP6PZI.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as unusedParams};
+import{a}from"../chunk-CW3KZ7UF.js";import"../chunk-K6UI6EBZ.js";import"../chunk-B75HZHUP.js";import"../chunk-UAHZ57BR.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-72MFTCU5.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as unusedParams};
 //# sourceMappingURL=unused-params.js.map

package/dist/queries/vue-component-duplicates.d.ts

@@ -1,6 +1,7 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
+import { F as FrontendBehaviorEvidenceClass, a as FrontendBehaviorActionTier } from '../frontend-behavior-evidence-EfM4_9bc.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface VueComponentDuplicateResult {
     fileA: string;
@@ -13,6 +14,10 @@ interface VueComponentDuplicateResult {
     sharedDirectives: string[];
     sharedSlots: string[];
     sharedIdentifiers: string[];
+    evidenceClass: FrontendBehaviorEvidenceClass;
+    actionTier: FrontendBehaviorActionTier;
+    evidenceClassReasons: string[];
+    recommendation: string;
     uniqueToA: string[];
     uniqueToB: string[];
     locA: number;

package/dist/queries/vue-component-duplicates.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-JNMLBL36.js";import"../chunk-HWVYTJOV.js";import"../chunk-MNCQPMCH.js";import"../chunk-ELC77ZDE.js";import"../chunk-ULHLDOD6.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as vueComponentDuplicates};
+import{a}from"../chunk-TG7QSYCJ.js";import"../chunk-KJCDEDQW.js";import"../chunk-6XA4LDHY.js";import"../chunk-KMVGRIO2.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as vueComponentDuplicates};
 //# sourceMappingURL=vue-component-duplicates.js.map

package/dist/queries/vue-composable-candidates.d.ts

@@ -1,7 +1,7 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
-import { F as FrontendBehaviorActionTier, a as FrontendBehaviorEvidenceClass } from '../frontend-behavior-evidence-BxKpKWUu.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
+import { a as FrontendBehaviorActionTier, F as FrontendBehaviorEvidenceClass } from '../frontend-behavior-evidence-EfM4_9bc.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 type VueComposableEvidenceClass = FrontendBehaviorEvidenceClass;
 type VueComposableActionTier = FrontendBehaviorActionTier;

package/dist/queries/vue-composable-candidates.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-7IWIMNHI.js";import"../chunk-HWVYTJOV.js";import"../chunk-MNCQPMCH.js";import"../chunk-ELC77ZDE.js";import"../chunk-ULHLDOD6.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as vueComposableCandidates};
+import{a}from"../chunk-URSSPS5H.js";import"../chunk-KJCDEDQW.js";import"../chunk-6XA4LDHY.js";import"../chunk-KMVGRIO2.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as vueComposableCandidates};
 //# sourceMappingURL=vue-composable-candidates.js.map

package/dist/queries/vue-large-view-pressure.d.ts

@@ -1,12 +1,13 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 type VueLargeViewPressureAxis = 'template' | 'script' | 'style' | 'external-script' | 'custom-block' | 'total';
 type VueLargeViewContextKind = 'component' | 'route-page';
 type VueLargeViewRecommendationKind = 'custom-block-review' | 'external-script-boundary' | 'route-page-decomposition' | 'script-behavior-extraction' | 'style-decomposition' | 'template-decomposition' | 'total-size-review';
 interface VueLargeViewPressureResult {
     file: string;
+    /** Component/SFC + external-script lines, plus one hop of delegated `use*` composable LOC. */
     totalLines: number;
     sfcLines: number;
     templateLines: number;
@@ -15,6 +16,9 @@ interface VueLargeViewPressureResult {
     externalScriptLines: number;
     externalScriptPaths: string[];
     customBlockLines: number;
+    /** LOC of imported `use*` composables this view's script actually invokes (one hop, not recursed). */
+    delegatedComposableLines: number;
+    delegatedComposablePaths: string[];
     dominantPressure: VueLargeViewPressureAxis;
     pressureKinds: VueLargeViewPressureAxis[];
     contextKind: VueLargeViewContextKind;

package/dist/queries/vue-large-view-pressure.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-N25HPUOK.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as vueLargeViewPressure};
+import{a}from"../chunk-7JZRFDCU.js";import"../chunk-6XA4LDHY.js";import"../chunk-KMVGRIO2.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as vueLargeViewPressure};
 //# sourceMappingURL=vue-large-view-pressure.js.map

package/dist/queries/wrapper-candidates.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 type WrapperActionTier = 'direct' | 'signal';
 interface WrapperCandidate {

package/dist/queries/wrapper-candidates.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-RUV5IY25.js";import"../chunk-2FMFF4RI.js";import"../chunk-3XSNW5XB.js";import"../chunk-UVPY3RUZ.js";import"../chunk-B75HZHUP.js";import"../chunk-RM2WQ75T.js";import"../chunk-WUOB4DHH.js";import"../chunk-BGBBVSH4.js";import"../chunk-L446VQYQ.js";import"../chunk-RSSXKJ6J.js";import"../chunk-UQ73QF5D.js";import"../chunk-CYHIKTJN.js";import"../chunk-NBNEVLRC.js";import"../chunk-F6IXELII.js";import"../chunk-ULHLDOD6.js";import"../chunk-DVFP6PZI.js";import"../chunk-63CI3IXR.js";import"../chunk-NABVR6B7.js";import"../chunk-THB6AM3V.js";import"../chunk-SA3DPTHT.js";import"../chunk-SGTKURU6.js";import"../chunk-AREANYIA.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as wrapperCandidates};
+import{a}from"../chunk-2LQWMYG4.js";import"../chunk-QARYU7R3.js";import"../chunk-T6NGEV5I.js";import"../chunk-K6UI6EBZ.js";import"../chunk-B75HZHUP.js";import"../chunk-UAHZ57BR.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-72MFTCU5.js";import"../chunk-MKM7NBZK.js";import"../chunk-YDDGCJJG.js";import"../chunk-ECVXWZ4Q.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-MBKJ7GHT.js";import"../chunk-HXXMPYEF.js";import"../chunk-T2FQ4GHD.js";import"../chunk-ISLWJ4PY.js";import"../chunk-WS3Z6W3M.js";import"../chunk-GNG622H3.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as wrapperCandidates};
 //# sourceMappingURL=wrapper-candidates.js.map