scip-query 0.10.12 → 0.11.0

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

@@ -67,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) */
@@ -75,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>/) */
@@ -89,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;
@@ -145,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;

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

@@ -1,5 +1,5 @@
 import Database from 'better-sqlite3';
-import { S as ScipQueryConfig } from './config-types-dvHOz0zU.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-CtTIGh6H.d.ts → health-BEZ1Rt0S.d.ts}

@@ -1,4 +1,4 @@
-import { S as ScipDatabase } from './db-rMZO5JFK.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-rMZO5JFK.js';
-export { c as createGitignoreFilter } from './db-rMZO5JFK.js';
-export { S as ScipQueryConfig } from './config-types-dvHOz0zU.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.
  *

package/dist/index.js

@@ -1,4 +1,4 @@
-import{a as l}from"./chunk-UUBMFL3F.js";import{a as n}from"./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{b as o,d as s,e as i}from"./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";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`(
+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

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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface AffectedResult {
     symbol: string;

package/dist/queries/affected.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-XRUGSM76.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 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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface BottleneckResult {
     symbol: string;

package/dist/queries/bottlenecks.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-DFSEARAU.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 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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.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-7C6JBBE4.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 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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface CallGraphResult {
     symbol: string;

package/dist/queries/call-graph.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-WTY5FERW.js";import"../chunk-B75HZHUP.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 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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface ChangeSurfaceEntry {
     symbol: string;

package/dist/queries/change-surface.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-KZ4MG5NY.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 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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.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-TBCHRDAC.js";import"../chunk-ROGZXWN2.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{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-rMZO5JFK.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-dvHOz0zU.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-GG5LHT27.js";import"../chunk-HRDSU5FN.js";import"../chunk-WUOB4DHH.js";import"../chunk-F6IXELII.js";import"../chunk-ULHLDOD6.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{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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
 
 interface CodeResult {
     symbol: string;

package/dist/queries/code.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-S2MRVIJ5.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 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-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
+import { BranchEstimateBasis } from './complexity.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.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-HHOMJCP5.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 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

package/dist/queries/complexity.d.ts

@@ -1,6 +1,31 @@
-import { S as ScipDatabase } from '../db-rMZO5JFK.js';
+import { S as ScipDatabase } from '../db-_Bdx0E1W.js';
+import { S as SymbolMatch } from '../symbol-types-DaoeXKUt.js';
 import 'better-sqlite3';
-import '../config-types-dvHOz0zU.js';
+import '../config-types-BrHl3Bge.js';
+
+interface SyntaxNode {
+    type: string;
+    text: string;
+    startPosition: {
+        row: number;
+        column: number;
+    };
+    endPosition: {
+        row: number;
+        column: number;
+    };
+    startIndex: number;
+    endIndex: number;
+    childCount: number;
+    namedChildCount: number;
+    children: SyntaxNode[];
+    namedChildren: SyntaxNode[];
+    parent: SyntaxNode | null;
+    child(index: number): SyntaxNode | null;
+    namedChild(index: number): SyntaxNode | null;
+    childForFieldName(name: string): SyntaxNode | null;
+    descendantsOfType(type: string | string[]): SyntaxNode[];
+}
 
 interface ComplexityResult {
     symbol: string;
@@ -9,8 +34,9 @@ interface ComplexityResult {
     startLine: number;
     endLine: number;
     loc: number;
-    /** Branch count from source-level regex (if, else, for, while, switch, catch, ternary, &&, ||) */
+    /** Branch count from AST when available, otherwise source-level regex fallback. */
     branches: number;
+    estimateBasis: BranchEstimateBasis;
     /** Cyclomatic complexity estimate: branches + 1 */
     cyclomaticEstimate: number;
     /** Number of distinct callees within the definition */
@@ -18,6 +44,11 @@ interface ComplexityResult {
     fanIn: number;
     fanOut: number;
 }
+type BranchEstimateBasis = 'ast' | 'regex-fallback';
+interface BranchEstimate {
+    branches: number;
+    estimateBasis: BranchEstimateBasis;
+}
 /**
  * Per-symbol complexity analysis combining source-level branch counting
  * with index-level metrics (fan-in, fan-out, callee count).
@@ -28,5 +59,12 @@ interface ComplexityResult {
 declare function complexity(db: ScipDatabase, symbolPattern: string, opts?: {
     semantic?: boolean;
 }): ComplexityResult | null;
+declare function branchEstimateForDefinition(db: ScipDatabase, definition: SymbolMatch): BranchEstimate;
+/**
+ * Count branch points in a parsed AST. The count follows the same practical
+ * McCabe approximation as the command output: decision nodes plus boolean
+ * decision operators.
+ */
+declare function countBranchesFromAst(node: SyntaxNode): number;
 
-export { type ComplexityResult, complexity };
+export { type BranchEstimateBasis, type ComplexityResult, branchEstimateForDefinition, complexity, countBranchesFromAst };

package/dist/queries/complexity.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-AZBELWZQ.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 complexity};
+import{a,b,c}from"../chunk-PZS6J5YG.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 branchEstimateForDefinition,a as complexity,c as countBranchesFromAst};
 //# sourceMappingURL=complexity.js.map

package/dist/queries/convergence.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 ConvergenceResult {
     symbolA: {

package/dist/queries/convergence.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-Q5P7NOVM.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 convergence};
+import{a}from"../chunk-FLJJLSGB.js";import"../chunk-STBXCPKY.js";import"../chunk-KMVGRIO2.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 convergence};
 //# sourceMappingURL=convergence.js.map