scip-query 0.10.11 → 0.11.0

package/dist/{config-types-BDIWAYzr.d.ts → config-types-BrHl3Bge.d.ts}

@@ -8,7 +8,7 @@ interface InstallMethod {
     /** Arguments for the command */
     args: string[];
 }
-type SupportedLanguage = 'typescript' | 'javascript' | 'java' | 'scala' | 'kotlin' | 'rust' | 'python' | 'ruby' | 'go' | 'cpp' | 'c' | 'csharp' | 'vb' | 'dart' | 'php';
+type SupportedLanguage = 'typescript' | 'javascript' | 'java' | 'scala' | 'kotlin' | 'rust' | 'python' | 'ruby' | 'go' | 'cpp' | 'c' | 'csharp' | 'vb' | 'dart' | 'php' | 'clojure';
 type TypeScriptProjectMode = 'single' | 'workspace';
 interface IndexerConfig {
     language: SupportedLanguage;
@@ -27,6 +27,7 @@ interface IndexerConfig {
         pnpmWorkspaces?: boolean;
         indexerBinary: string;
         projectPath?: string;
+        configPath?: string;
     }) => {
         binary: string;
         args: string[];
@@ -66,6 +67,10 @@ interface ScipQueryConfig {
     declaredCouplings?: DeclaredCouplingConfig[];
     /** Optional analyzer configuration. */
     locality?: LocalityConfig;
+    /** Enumeration-rot contracts: a declared key set that must track a ground-truth source. */
+    coverageContracts?: CoverageContractConfig[];
+    /** Documentation policy (snapshot-doc exemptions, ...). */
+    docs?: DocsConfig;
 }
 interface ProjectConfig {
     /** Override which languages to index (default: auto-detect) */
@@ -74,6 +79,8 @@ interface ProjectConfig {
     indexerConcurrency?: number;
     /** Watch mode settings */
     watch?: WatchConfig;
+    /** Agent hook behavior. */
+    hooks?: HookRuntimeConfig;
     /** Per-language indexer overrides */
     indexer?: Partial<Record<SupportedLanguage, IndexerOverrides>>;
     /** Override the database storage path (default: ~/.cache/scip-query/<hash>/) */
@@ -88,11 +95,58 @@ interface ProjectConfig {
     declaredCouplings?: DeclaredCouplingConfig[];
     /** Optional locality analyzer configuration. */
     locality?: LocalityConfig;
+    /** Enumeration-rot contracts: a declared key set that must track a ground-truth source. */
+    coverageContracts?: CoverageContractConfig[];
+    /** Documentation policy (snapshot-doc exemptions, ...). */
+    docs?: DocsConfig;
+}
+type CoverageContractKeySpec = {
+    type: 'object-literal-keys';
+    identifier: string;
+} | {
+    type: 'string-array';
+    identifier: string;
+} | {
+    type: 'markdown-list';
+    marker: string;
+};
+type CoverageContractSourceSpec = {
+    type: 'top-level-dirs';
+    path: string;
+} | {
+    type: 'file-glob';
+    pattern: string;
+} | {
+    type: 'registered-commands';
+} | {
+    type: 'builtin-skills';
+};
+interface CoverageContractConfig {
+    /** Human-readable name for the contract, used in finding messages. */
+    name: string;
+    /** File the declared key set is extracted from. */
+    file: string;
+    /** How to extract the declared key set from `file`. */
+    keys: CoverageContractKeySpec;
+    /** The ground-truth source the declared key set must track. */
+    mustEqual: CoverageContractSourceSpec;
+    /** When false (the default), declared keys with no ground-truth match are also flagged. */
+    allowExtra?: boolean;
 }
 interface LocalityConfig {
     /** Folder names that should be treated as architectural ownership boundaries. */
     architecturalBoundarySegments?: string[];
 }
+interface DocsConfig {
+    /**
+     * Glob patterns (see src/analysis/glob-match.ts for supported syntax) for
+     * dated snapshot docs that intentionally cite code "as of" a moment in
+     * time — excluded from diff-gate's doc-reference check and doc-drift's
+     * default findings. A `<!-- scip-query: snapshot -->` marker inside a doc
+     * has the same effect regardless of its path.
+     */
+    snapshotPaths?: string[];
+}
 interface DeclaredCouplingConfig {
     /** Human-readable name for the maintenance unit. */
     name: string;
@@ -144,6 +198,10 @@ interface WatchConfig {
     /** Extra glob patterns to ignore beyond .gitignore */
     ignore?: string[];
 }
+interface HookRuntimeConfig {
+    /** Prompt router mode for project-local hooks (default: single). */
+    router?: 'off' | 'single';
+}
 interface IndexerOverrides {
     /** Enable pnpm workspace support (TypeScript) */
     pnpmWorkspaces?: boolean;
@@ -151,6 +209,8 @@ interface IndexerOverrides {
     projectMode?: TypeScriptProjectMode;
     /** Explicit TypeScript project roots or tsconfig paths, relative to project root unless absolute */
     projects?: string[];
+    /** Indexer-specific config file path, relative to project root */
+    configPath?: string;
 }
 
 export type { FindingSuppression as F, IndexerConfig as I, ProjectConfig as P, ScipQueryConfig as S, TypeScriptProjectMode as T, SupportedLanguage as a };

package/dist/{db-Djj3Nqrb.d.ts → db-_Bdx0E1W.d.ts}

@@ -1,5 +1,5 @@
 import Database from 'better-sqlite3';
-import { S as ScipQueryConfig } from './config-types-BDIWAYzr.js';
+import { S as ScipQueryConfig } from './config-types-BrHl3Bge.js';
 
 /**
  * Builds a gitignore-based path filter from .gitignore files found

package/dist/diff-gate-types-CG2YQ_ei.d.ts

@@ -0,0 +1,4 @@
+type DiffGateActionTier = 'direct' | 'signal' | 'support';
+type DocCitationKind = 'behavioral-claim' | 'configuration-example' | 'guide-reference' | 'intentional-record';
+
+export type { DiffGateActionTier as D, DocCitationKind as a };

package/dist/{frontend-behavior-evidence-BxKpKWUu.d.ts → frontend-behavior-evidence-EfM4_9bc.d.ts}

@@ -1,4 +1,4 @@
 type FrontendBehaviorEvidenceClass = 'domain-behavior' | 'generic-workflow-scaffolding' | 'mixed' | 'shared-abstraction';
 type FrontendBehaviorActionTier = 'signal' | 'support';
 
-export type { FrontendBehaviorActionTier as F, FrontendBehaviorEvidenceClass as a };
+export type { FrontendBehaviorEvidenceClass as F, FrontendBehaviorActionTier as a };

package/dist/{health-D5J42g4D.d.ts → health-BEZ1Rt0S.d.ts}

@@ -1,4 +1,4 @@
-import { S as ScipDatabase } from './db-Djj3Nqrb.js';
+import { S as ScipDatabase } from './db-_Bdx0E1W.js';
 import { stats } from './queries/stats.js';
 
 /**
@@ -70,12 +70,39 @@ interface GitEvidenceSummary {
         changes: number;
         fixChanges: number;
     }>;
+    commitsScanned: number;
 }
 interface SuppressionSummary {
     total: number;
     byCategory: Record<string, number>;
 }
 
+/**
+ * Pure finding-outcome ledger math. Closes the round-1 finding "the
+ * validation axis computes per-detector lift and feeds nothing": this
+ * module tracks, per finding identity, whether a detector's output is
+ * actually being acted on — and reports that, without changing which
+ * findings get emitted (downranking stays a human/config decision).
+ *
+ * Storage lives in src/storage/evidence-cache.ts (finding_outcome_ledger
+ * table); this module is the pure transition + stats core the storage
+ * layer's rows flow through. Clock is injected everywhere so tests never
+ * depend on wall time.
+ */
+
+interface DetectorPrecisionStats {
+    check: string;
+    /** Distinct finding identities ever recorded for this check. */
+    seen: number;
+    resolved: number;
+    suppressed: number;
+    stillOpen: number;
+    resolutionRate: number;
+    suppressionRate: number;
+    /** Age (days) of the oldest still-open finding; null when none are open. */
+    oldestOpenAgeDays: number | null;
+}
+
 type FindingEvidence = 'graph-fact' | 'heuristic' | 'change-graph';
 interface HealthAction {
     category: string;
@@ -155,6 +182,10 @@ interface HealthValidation {
         fixDensity: number;
         lift: number | null;
     }>;
+    validationBasis: {
+        method: 'subject-regex';
+        commitsScanned: number;
+    };
 }
 interface HealthReport {
     /** Headline = min(riskScore, hygieneScore); kept for compatibility. */
@@ -176,6 +207,10 @@ interface HealthReport {
         isolatedLoc: number;
         cycles: number;
         similarPairs: number;
+        duplicateBodyGroups: number;
+        duplicateBodyLoc: number;
+        twinDriftGroups: number;
+        twinDriftLoc: number;
         reactComponentDuplicatePairs: number;
         reactHookCandidatePairs: number;
         reactHookCandidateScoreCount: number;
@@ -193,6 +228,7 @@ interface HealthReport {
         complexityHotspotCount: number;
         hiddenCouplingPairs: number | null;
         hiddenCouplingScoreCount: number | null;
+        coverageContractViolations: number;
     };
     axes: HealthAxes;
     validation: HealthValidation | null;
@@ -208,9 +244,16 @@ interface HealthReport {
         file?: string;
     }>;
     warnings?: string[];
+    /**
+     * Per-check finding-outcome stats from the finding_outcome_ledger
+     * (populated by `diff-gate --hook` runs) — resolution/suppression rate
+     * and open-finding age. Reports, never affects the score above. Empty
+     * until the ledger has data.
+     */
+    detectorPrecision: DetectorPrecisionStats[];
 }
 
-declare const HEALTH_PHASES: readonly ["overview", "dead", "isolated", "cycles", "similar", "react-component-duplicates", "react-hook-candidates", "react-large-component-pressure", "vue-component-duplicates", "vue-composable-candidates", "vue-large-view-pressure", "extract-candidates", "wrapper-candidates", "passthrough-candidates", "stale-abstractions", "drift", "complexity-hotspots", "git-evidence", "suppressions"];
+declare const HEALTH_PHASES: readonly ["overview", "dead", "isolated", "cycles", "similar", "duplicate-bodies", "twin-drift", "react-component-duplicates", "react-hook-candidates", "react-large-component-pressure", "vue-component-duplicates", "vue-composable-candidates", "vue-large-view-pressure", "extract-candidates", "wrapper-candidates", "passthrough-candidates", "stale-abstractions", "drift", "complexity-hotspots", "git-evidence", "suppressions", "coverage-contracts"];
 type HealthPhaseName = (typeof HEALTH_PHASES)[number];
 type HealthPhaseResult = {
     phase: 'overview';
@@ -228,6 +271,12 @@ type HealthPhaseResult = {
 } | {
     phase: 'similar';
     similarCount: number;
+} | {
+    phase: 'duplicate-bodies';
+    duplicateBodies: CountLocSummary;
+} | {
+    phase: 'twin-drift';
+    twinDrift: CountLocSummary;
 } | {
     phase: 'react-component-duplicates';
     reactComponentDuplicates: CountLocSummary;
@@ -270,6 +319,9 @@ type HealthPhaseResult = {
 } | {
     phase: 'suppressions';
     suppressions: SuppressionSummary;
+} | {
+    phase: 'coverage-contracts';
+    coverageContracts: CountLocSummary;
 };
 /**
  * Single composite health report that runs all de-bloat analyses

package/dist/index.d.ts

@@ -1,73 +1,9 @@
-import { S as ScipDatabase } from './db-Djj3Nqrb.js';
-export { c as createGitignoreFilter } from './db-Djj3Nqrb.js';
-export { S as ScipQueryConfig } from './config-types-BDIWAYzr.js';
+import { S as ScipDatabase } from './db-_Bdx0E1W.js';
+export { c as createGitignoreFilter } from './db-_Bdx0E1W.js';
+import { S as SymbolMatch, I as IndexedDefinition, a as ScipSymbol, b as ScipLocalSymbol } from './symbol-types-DaoeXKUt.js';
+export { S as ScipQueryConfig } from './config-types-BrHl3Bge.js';
 import 'better-sqlite3';
 
-/**
- * A symbol's location in the SCIP index. The minimum data needed to
- * identify a definition: which document it lives in, which lines it
- * spans, and the global symbol id. Used as a lightweight handle when
- * the caller doesn't need the symbol's textual name or path.
- */
-interface SymbolLocation {
-    documentId: number;
-    startLine: number;
-    endLine: number;
-    symbolId: number;
-}
-/**
- * A SymbolLocation plus the human-readable bits: the SCIP symbol string
- * and the document's relative path. Returned by lookup helpers like
- * `findFirstSymbolMatch` so callers don't have to round-trip through the
- * documents table to get a path or symbol name.
- */
-interface SymbolMatch extends SymbolLocation {
-    symbol: string;
-    relativePath: string;
-}
-/**
- * A full definition record: SymbolMatch plus per-symbol metadata
- * (leaf name, parent type, kind, documentation, enclosing symbol).
- * Used by the catalog APIs (`getDefinitionsForFile`, `getAllDefinitions`,
- * `getScopedDefinitions`) so consumers don't have to re-derive any of
- * these per-record.
- */
-interface IndexedDefinition extends SymbolMatch {
-    leaf: string;
-    parentTypeName: string | null;
-    isFunctionLike: boolean;
-    isTypeLike: boolean;
-    kind: number | null;
-    documentation: string | null;
-    enclosingSymbol: string | null;
-}
-/** Parsed components of a SCIP symbol string */
-interface ScipSymbol {
-    /** The indexer scheme (e.g. "scip-typescript", "scip-java", "rust-analyzer") */
-    scheme: string;
-    /** Package manager (e.g. "npm", "maven", "cargo") */
-    manager: string;
-    /** Package name (e.g. "@vega/api", "com.example/mylib") */
-    packageName: string;
-    /** Package version */
-    version: string;
-    /** Descriptor chain — the path to the symbol within the file */
-    descriptors: ScipDescriptor[];
-    /** The raw, unparsed symbol string */
-    raw: string;
-}
-interface ScipDescriptor {
-    name: string;
-    suffix: DescriptorSuffix;
-}
-type DescriptorSuffix = 'namespace' | 'type' | 'term' | 'method' | 'type-param' | 'parameter' | 'meta' | 'macro';
-/** A local symbol (file-scoped, no cross-file identity) */
-interface ScipLocalSymbol {
-    kind: 'local';
-    id: string;
-    raw: string;
-}
-
 /**
  * File classifier — one place to decide what role a source file plays.
  *
@@ -128,7 +64,9 @@ declare function buildFileDepGraph(db: ScipDatabase, scope?: string): Map<string
 declare function crossFileCallerEvidenceMap(db: ScipDatabase, definitions?: ReadonlyArray<SymbolMatch>, opts?: {
     semantic?: boolean;
 }): Map<number, Set<string>>;
-declare function sourceFallbackCallerEvidenceMap(db: ScipDatabase, definitions: ReadonlyArray<IndexedDefinition>): Map<number, Set<string>>;
+declare function sourceFallbackCallerEvidenceMap(db: ScipDatabase, definitions: ReadonlyArray<IndexedDefinition>, opts?: {
+    skipPath?: (relativePath: string) => boolean;
+}): Map<number, Set<string>>;
 
 type FrameworkSourceReferenceKind = 'cross-language-dispatch' | 'rust-attribute';
 
@@ -233,7 +171,9 @@ declare class ProjectIndex {
     crossFileCallerMap(definitions?: ReadonlyArray<SymbolMatch>, opts?: {
         semantic?: boolean;
     }): ReturnType<typeof crossFileCallerEvidenceMap>;
-    sourceFallbackCallerFiles(definitions: ReadonlyArray<IndexedDefinition>): ReturnType<typeof sourceFallbackCallerEvidenceMap>;
+    sourceFallbackCallerFiles(definitions: ReadonlyArray<IndexedDefinition>, opts?: {
+        skipPath?: (relativePath: string) => boolean;
+    }): ReturnType<typeof sourceFallbackCallerEvidenceMap>;
     callerFileMap(definitions: ReadonlyArray<IndexedDefinition>, opts?: {
         semantic?: boolean;
         sourceFallback?: boolean;

package/dist/index.js

@@ -1,4 +1,4 @@
-import{a as l}from"./chunk-UUBMFL3F.js";import{a as n}from"./chunk-5OST6GYB.js";import"./chunk-C5CTSJ6X.js";import"./chunk-BGBBVSH4.js";import"./chunk-RNM6LMCF.js";import"./chunk-JCLDUKT6.js";import"./chunk-KDFONWTW.js";import"./chunk-OLTESY4K.js";import"./chunk-TQ5W2H3S.js";import"./chunk-TK7O5ER5.js";import"./chunk-VUKC6F77.js";import"./chunk-P5RYBRIO.js";import"./chunk-OBGRLXWF.js";import"./chunk-2KHTSEIL.js";import{a as o,c as i,d as s}from"./chunk-JM72FNGA.js";import"./chunk-72KY2ZFO.js";import"./chunk-YZA6PPZL.js";import"./chunk-HF25DFSC.js";import"./chunk-DS6QEB3G.js";import"./chunk-XUGQU7PM.js";import"./chunk-A536TEU4.js";import"./chunk-64MNV6AB.js";import"./chunk-7S5E7KWT.js";import c from"better-sqlite3";var d=["node_modules",".git","dist","build","out","coverage","target",".next",".nuxt",".cache",".turbo",".scipquery-cache","__pycache__",".venv","venv"],r=class{db;config;pathFilter;statementCache=new Map;constructor(t,e){this.config=t,this.pathFilter=e??null,this.db=new c(t.dbPath,{readonly:!0}),this.db.pragma("busy_timeout = 5000"),this.db.pragma("query_only = ON"),this.db.pragma("temp_store = MEMORY"),this.db.pragma("cache_size = -64000"),this.db.pragma("mmap_size = 268435456")}isIgnored(t){return this.pathFilter?.isIgnored(t)??!1}get localSymbolPredicate(){return`(
+import{a as l}from"./chunk-YZXV3CU3.js";import{a as n}from"./chunk-X4O6K47U.js";import"./chunk-NAH5EAZS.js";import"./chunk-BGBBVSH4.js";import"./chunk-QJ3FK4TB.js";import"./chunk-WFGOH2UI.js";import"./chunk-C4ICAIJ4.js";import"./chunk-WQHWIVA7.js";import"./chunk-XEMQUN3Z.js";import"./chunk-MTDBHTSF.js";import"./chunk-R3JY4EZ4.js";import{b as o,d as s,e as i}from"./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";import c from"better-sqlite3";var d=["node_modules",".git","dist","build","out","coverage","target",".next",".nuxt",".cache",".turbo",".nbb",".cpcache",".shadow-cljs",".scipquery-cache","__pycache__",".venv","venv"],r=class{db;config;pathFilter;statementCache=new Map;constructor(t,e){this.config=t,this.pathFilter=e??null,this.db=new c(t.dbPath,{readonly:!0}),this.db.pragma("busy_timeout = 5000"),this.db.pragma("query_only = ON"),this.db.pragma("temp_store = MEMORY"),this.db.pragma("cache_size = -64000"),this.db.pragma("mmap_size = 268435456")}isIgnored(t){return this.pathFilter?.isIgnored(t)??!1}get localSymbolPredicate(){return`(
       EXISTS (
         SELECT 1
         FROM defn_enclosing_ranges local_der
@@ -16,5 +16,5 @@ import{a as l}from"./chunk-UUBMFL3F.js";import{a as n}from"./chunk-5OST6GYB.js";
           ${this.pathExclusionsFor("local_d").trimStart()}
       )
     )`}get pathExclusions(){return this.pathExclusionsFor("d")}get symbolNoise(){return this.symbolNoiseFor("gs")}pathExclusionsFor(...t){return t.flatMap(e=>d.flatMap(a=>[`AND ${e}.relative_path NOT LIKE '${a}/%'`,`AND ${e}.relative_path NOT LIKE '%/${a}/%'`])).join(`
-      `)}symbolNoiseFor(t){return`AND ${t}.symbol NOT LIKE '%().(%' AND ${t}.symbol NOT LIKE '%typeLiteral%'`}all(t,...e){return this.statement(t).all(...e)}get(t,...e){return this.statement(t).get(...e)}close(){this.statementCache.clear(),this.db.close()}statement(t){let e=this.statementCache.get(t);return e||(e=this.db.prepare(t),this.statementCache.set(t,e)),e}};export{n as ProjectIndex,r as ScipDatabase,l as createGitignoreFilter,s as leafName,o as parseSymbol,i as shortenSymbol};
+      `)}symbolNoiseFor(t){return`AND ${t}.symbol NOT LIKE '%().(%' AND ${t}.symbol NOT LIKE '%typeLiteral%'`}all(t,...e){return this.statement(t).all(...e)}get(t,...e){return this.statement(t).get(...e)}close(){this.statementCache.clear(),this.db.close()}statement(t){let e=this.statementCache.get(t);return e||(e=this.db.prepare(t),this.statementCache.set(t,e)),e}};export{n as ProjectIndex,r as ScipDatabase,l as createGitignoreFilter,i as leafName,o as parseSymbol,s as shortenSymbol};
 //# sourceMappingURL=index.js.map

package/dist/postinstall.js

@@ -1,6 +1,3 @@
 #!/usr/bin/env node
-import{c as g,d as k,e as m,f}from"./chunk-ONPCQ2PM.js";import{existsSync as p,mkdirSync as L,symlinkSync as v,readlinkSync as b,unlinkSync as q}from"fs";import{join as e,dirname as y,resolve as d}from"path";import{homedir as u,platform as A}from"os";import{fileURLToPath as C}from"url";var H=A()==="win32",U=["scip-query","scip-query-setup","scip-adoption","scip-health-audit","scip-health-improve","scip-hyper-optimization","scip-api-impact","concrete-plan","scip-ai-cleanup","scip-debug","scip-explore","scip-triage-issue","scip-diagram","scip-debloat","scip-doc-reconcile","scip-directory-architecture","scip-maintainability","scip-react-maintainability","scip-vue-maintainability","scip-verify","scip-language-playbook"];function N(i={}){let l=i.quiet?()=>{}:console.log,o=C(import.meta.url),h=d(y(o),"..","skills"),I=[e(u(),".claude","skills"),e(u(),".codex","skills"),e(u(),".agents","skills")],n={installed:[],skipped:[],alreadyLinked:[]};for(let r of I){let $=y(r);if(!p($))continue;L(r,{recursive:!0});let t=R(r);for(let s of U){let a=e(h,s),c=e(r,s);if(!p(a)){n.skipped.push(`${t}/${s}`);continue}if(p(c)){try{let x=b(c);if(d(x)===d(a)){n.alreadyLinked.push(`${t}/${s}`),l(`  ok:   ${s} \u2192 ${t} (already linked)`);continue}}catch{n.skipped.push(`${t}/${s}`),l(`  skip: ${s} \u2192 ${t} (exists, not a symlink)`);continue}q(c)}v(a,c,H?"junction":"dir"),n.installed.push(`${t}/${s}`),l(`  done: ${s} \u2192 ${t}`)}}return n}function R(i){return i.includes(".codex")?"Codex":i.includes(".agents")?"Agents":"Claude"}function S(){console.log("scip-query: installing skills...");let i=N({quiet:!1});if(i.installed.length+i.alreadyLinked.length>0&&console.log(`
-${i.installed.length} skill(s) installed, ${i.alreadyLinked.length} already linked.`),!g())console.log(`
-scip CLI not found on PATH. Attempting auto-install...`),f(console.log)||m();else{let o=k();console.log(`
-scip CLI: ${o??"installed"}`)}console.log("")}S();
+import"./chunk-TFWDJDGO.js";import{existsSync as e,mkdirSync as n,symlinkSync as o,readlinkSync as r,unlinkSync as l,readdirSync as c}from"fs";import{join as p,dirname as u,resolve as d,relative as k,isAbsolute as g}from"path";import{homedir as f,platform as s}from"os";import{fileURLToPath as h}from"url";var S=s()==="win32";function i(){console.log("scip-query installed -- run 'scip-query setup' in a repo to enable skills, hooks, and the index.")}i();
 //# sourceMappingURL=postinstall.js.map

package/dist/queries/affected.d.ts

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

package/dist/queries/affected.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-VCQYSG2M.js";import"../chunk-RNM6LMCF.js";import"../chunk-JCLDUKT6.js";import"../chunk-KDFONWTW.js";import"../chunk-OLTESY4K.js";import"../chunk-TQ5W2H3S.js";import"../chunk-TK7O5ER5.js";import"../chunk-VUKC6F77.js";import"../chunk-P5RYBRIO.js";import"../chunk-OBGRLXWF.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as affected};
+import{a}from"../chunk-ZEKBR4OK.js";import"../chunk-QJ3FK4TB.js";import"../chunk-WFGOH2UI.js";import"../chunk-C4ICAIJ4.js";import"../chunk-WQHWIVA7.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-R3JY4EZ4.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 affected};
 //# sourceMappingURL=affected.js.map

package/dist/queries/bottlenecks.d.ts

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

package/dist/queries/bottlenecks.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-IHUETYFW.js";import"../chunk-B75HZHUP.js";import"../chunk-5OST6GYB.js";import"../chunk-C5CTSJ6X.js";import"../chunk-BGBBVSH4.js";import"../chunk-RNM6LMCF.js";import"../chunk-JCLDUKT6.js";import"../chunk-KDFONWTW.js";import"../chunk-OLTESY4K.js";import"../chunk-TQ5W2H3S.js";import"../chunk-TK7O5ER5.js";import"../chunk-VUKC6F77.js";import"../chunk-P5RYBRIO.js";import"../chunk-OBGRLXWF.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as bottlenecks};
+import{a}from"../chunk-X6OGDTQH.js";import"../chunk-B75HZHUP.js";import"../chunk-X4O6K47U.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-QJ3FK4TB.js";import"../chunk-WFGOH2UI.js";import"../chunk-C4ICAIJ4.js";import"../chunk-WQHWIVA7.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-R3JY4EZ4.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 bottlenecks};
 //# sourceMappingURL=bottlenecks.js.map

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

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

package/dist/queries/by-kind.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-6JRV4MY2.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as byKind,b as kindCounts};
+import{a,b}from"../chunk-M2YXL62V.js";import"../chunk-MTDBHTSF.js";import"../chunk-R3JY4EZ4.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 byKind,b as kindCounts};
 //# sourceMappingURL=by-kind.js.map

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

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

package/dist/queries/call-graph.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-7TWLSZK5.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-RNM6LMCF.js";import"../chunk-JCLDUKT6.js";import"../chunk-KDFONWTW.js";import"../chunk-OLTESY4K.js";import"../chunk-TQ5W2H3S.js";import"../chunk-TK7O5ER5.js";import"../chunk-VUKC6F77.js";import"../chunk-P5RYBRIO.js";import"../chunk-OBGRLXWF.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as callGraph};
+import{a}from"../chunk-3T2FNHIU.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-QJ3FK4TB.js";import"../chunk-WFGOH2UI.js";import"../chunk-C4ICAIJ4.js";import"../chunk-WQHWIVA7.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-R3JY4EZ4.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 callGraph};
 //# sourceMappingURL=call-graph.js.map

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

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

package/dist/queries/change-surface.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-Z4HICZGY.js";import"../chunk-7B6LP46R.js";import"../chunk-5OST6GYB.js";import"../chunk-C5CTSJ6X.js";import"../chunk-BGBBVSH4.js";import"../chunk-RNM6LMCF.js";import"../chunk-JCLDUKT6.js";import"../chunk-KDFONWTW.js";import"../chunk-OLTESY4K.js";import"../chunk-TQ5W2H3S.js";import"../chunk-TK7O5ER5.js";import"../chunk-VUKC6F77.js";import"../chunk-P5RYBRIO.js";import"../chunk-OBGRLXWF.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as changeSurface};
+import{a}from"../chunk-KKMOB3OJ.js";import"../chunk-XHWLNQVZ.js";import"../chunk-X4O6K47U.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-QJ3FK4TB.js";import"../chunk-WFGOH2UI.js";import"../chunk-C4ICAIJ4.js";import"../chunk-WQHWIVA7.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-R3JY4EZ4.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 changeSurface};
 //# sourceMappingURL=change-surface.js.map

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

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

package/dist/queries/cleanup-plan.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-JATUZIEH.js";import"../chunk-USPV3T5K.js";import"../chunk-B75HZHUP.js";import"../chunk-5OST6GYB.js";import"../chunk-C5CTSJ6X.js";import"../chunk-BGBBVSH4.js";import"../chunk-RNM6LMCF.js";import"../chunk-JCLDUKT6.js";import"../chunk-KDFONWTW.js";import"../chunk-OLTESY4K.js";import"../chunk-TQ5W2H3S.js";import"../chunk-TK7O5ER5.js";import"../chunk-VUKC6F77.js";import"../chunk-P5RYBRIO.js";import"../chunk-OBGRLXWF.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{b as RemovedRangeIndex,a as cleanupPlan};
+import{a,b}from"../chunk-BDRBPG7Y.js";import"../chunk-343O6EVV.js";import"../chunk-B75HZHUP.js";import"../chunk-X4O6K47U.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-QJ3FK4TB.js";import"../chunk-WFGOH2UI.js";import"../chunk-C4ICAIJ4.js";import"../chunk-WQHWIVA7.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-R3JY4EZ4.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 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-Djj3Nqrb.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import { C as CoChangeCommitScope, a as CoChangeRecency, b as CoChangeSubjectContext } from '../git-history-Dao3_Pu9.js';
 import 'better-sqlite3';
-import '../config-types-BDIWAYzr.js';
+import '../config-types-BrHl3Bge.js';
 
 type CoChangePartnerClass = 'doc-code' | 'config-code' | 'schema-script' | 'model-view' | 'test-code' | 'same-feature' | 'unknown';
 interface CoChangePartnerClassification {
@@ -69,6 +69,16 @@ declare function coChange(db: ScipDatabase, file?: string, opts?: {
     limit?: number;
     includeLinked?: boolean;
     maxFilesPerCommit?: number;
+    /**
+     * Caps how many of the (already together-count-sorted) candidate pairs
+     * get classified — the per-pair loop below does filesystem/graph lookups
+     * so its cost scales with candidate count on a large repo history. Set
+     * by the CLI's analysis-budget disclosure on large indexes; honoring it
+     * for real (rather than only disclosing it) keeps the disclosed budget
+     * truthful. Highest-`together` pairs are kept first since `coChangePairs`
+     * returns them pre-sorted by priority.
+     */
+    scanLimit?: number;
 }): CoChangeResult;
 declare function classifyCoChangePartner(fileA: string, fileB: string): CoChangePartnerClassification;
 declare function declaredCouplingSuggestionForPair(pair: CoChangePairEvidence, classification: CoChangePartnerClassification, structurallyLinked: boolean): DeclaredCouplingSuggestion | undefined;

package/dist/queries/co-change.js

@@ -1,2 +1,2 @@
-import{a,b,c,d,e}from"../chunk-65AU3HFZ.js";import"../chunk-BSN22NRK.js";import"../chunk-C5CTSJ6X.js";import"../chunk-VUKC6F77.js";import"../chunk-P5RYBRIO.js";import"../chunk-OBGRLXWF.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.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-NJJ7AS4F.js";import"../chunk-FXG3PHVW.js";import"../chunk-NAH5EAZS.js";import"../chunk-XEMQUN3Z.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{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,6 +1,6 @@
-import { S as ScipDatabase } from '../db-Djj3Nqrb.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-BDIWAYzr.js';
+import '../config-types-BrHl3Bge.js';
 
 interface CodeResult {
     symbol: string;

package/dist/queries/code.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-YWYFU2V3.js";import"../chunk-7B6LP46R.js";import"../chunk-TK7O5ER5.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as code};
+import{a}from"../chunk-DRPAQAFM.js";import"../chunk-XHWLNQVZ.js";import"../chunk-WQHWIVA7.js";import"../chunk-R3JY4EZ4.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 code};
 //# sourceMappingURL=code.js.map

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

@@ -1,6 +1,8 @@
-import { S as ScipDatabase } from '../db-Djj3Nqrb.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
+import { BranchEstimateBasis } from './complexity.js';
 import 'better-sqlite3';
-import '../config-types-BDIWAYzr.js';
+import '../config-types-BrHl3Bge.js';
+import '../symbol-types-DaoeXKUt.js';
 
 interface ComplexityHotspot {
     symbol: string;
@@ -12,13 +14,15 @@ interface ComplexityHotspot {
     fanIn: number;
     fanOut: number;
     calleeCount: number;
+    branches: number;
+    estimateBasis: BranchEstimateBasis;
     score: number;
 }
 /**
  * Find complexity hotspots: symbols with a composite score based on
  * LOC, fan-in, fan-out, and callee count.
  *
- * Score = (loc / 50) * (fanIn / 5) * max(fanOut / 5, 1)
+ * Score = (loc / 50) * (fanIn / 5) * max(fanOut / 5, 1) * max(cyclomatic / 5, 1)
  *
  * Bulk fan-in/out via caller evidence + buildCalleeMap so we pay
  * one SQL pass per kind regardless of how many definitions we score —

package/dist/queries/complexity-hotspots.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-GQBMH2TQ.js";import"../chunk-PFOCOG57.js";import"../chunk-B75HZHUP.js";import"../chunk-5OST6GYB.js";import"../chunk-C5CTSJ6X.js";import"../chunk-BGBBVSH4.js";import"../chunk-RNM6LMCF.js";import"../chunk-JCLDUKT6.js";import"../chunk-KDFONWTW.js";import"../chunk-OLTESY4K.js";import"../chunk-TQ5W2H3S.js";import"../chunk-TK7O5ER5.js";import"../chunk-VUKC6F77.js";import"../chunk-P5RYBRIO.js";import"../chunk-OBGRLXWF.js";import"../chunk-2KHTSEIL.js";import"../chunk-JM72FNGA.js";import"../chunk-72KY2ZFO.js";import"../chunk-YZA6PPZL.js";import"../chunk-HF25DFSC.js";import"../chunk-DS6QEB3G.js";import"../chunk-XUGQU7PM.js";import"../chunk-A536TEU4.js";import"../chunk-64MNV6AB.js";import"../chunk-7S5E7KWT.js";export{a as complexityHotspots};
+import{a}from"../chunk-WGA5BBTA.js";import"../chunk-K6UI6EBZ.js";import"../chunk-PZS6J5YG.js";import"../chunk-B75HZHUP.js";import"../chunk-X4O6K47U.js";import"../chunk-NAH5EAZS.js";import"../chunk-BGBBVSH4.js";import"../chunk-QJ3FK4TB.js";import"../chunk-WFGOH2UI.js";import"../chunk-C4ICAIJ4.js";import"../chunk-WQHWIVA7.js";import"../chunk-XEMQUN3Z.js";import"../chunk-MTDBHTSF.js";import"../chunk-R3JY4EZ4.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 complexityHotspots};
 //# sourceMappingURL=complexity-hotspots.js.map