scip-query 0.9.0 → 0.10.1

package/dist/{config-types-CGIeLEpY.d.ts → config-types-Bok4jrO3.d.ts}

@@ -58,6 +58,10 @@ interface ScipQueryConfig {
     gitignorePaths?: string[];
     /** Optional semantic-provider configuration */
     semantic?: SemanticConfig;
+    /** Machine-readable accepted findings. */
+    suppressions?: FindingSuppression[];
+    /** Project-declared file groups that intentionally change together. */
+    declaredCouplings?: DeclaredCouplingConfig[];
 }
 interface ProjectConfig {
     /** Override which languages to index (default: auto-detect) */
@@ -72,6 +76,30 @@ interface ProjectConfig {
     entryRoots?: EntryRootsConfig;
     /** Optional semantic-provider configuration */
     semantic?: SemanticConfig;
+    /** Machine-readable accepted findings. */
+    suppressions?: FindingSuppression[];
+    /** Project-declared file groups that intentionally change together. */
+    declaredCouplings?: DeclaredCouplingConfig[];
+}
+interface DeclaredCouplingConfig {
+    /** Human-readable name for the maintenance unit. */
+    name: string;
+    /** Exact relative file paths that form one intentional co-change group. */
+    files: string[];
+    /** Human reason for why these files should move together. */
+    reason?: string;
+}
+interface FindingSuppression {
+    /** Stable finding id, for example SQABC123DEF456. */
+    id?: string;
+    /** Detector/check name, for example diff-gate's "echo". */
+    check?: string;
+    /** Optional file path to narrow check-level suppressions. */
+    file?: string;
+    /** Human reason for accepting the finding. Required by config validation. */
+    reason: string;
+    /** ISO date after which the suppression no longer applies. */
+    expiresAt?: string;
 }
 interface SemanticConfig {
     typescript?: TypeScriptSemanticConfig;
@@ -105,4 +133,4 @@ interface IndexerOverrides {
     pnpmWorkspaces?: boolean;
 }
 
-export type { IndexerConfig as I, ProjectConfig as P, ScipQueryConfig as S, SupportedLanguage as a };
+export type { FindingSuppression as F, IndexerConfig as I, ProjectConfig as P, ScipQueryConfig as S, SupportedLanguage as a };

package/dist/{db-DdTPetj5.d.ts → db-BkFlkzI3.d.ts}

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

package/dist/{health-C6r2VgpA.d.ts → health-CbGMdRPg.d.ts}

@@ -1,4 +1,4 @@
-import { S as ScipDatabase } from './db-DdTPetj5.js';
+import { S as ScipDatabase } from './db-BkFlkzI3.js';
 import { stats } from './queries/stats.js';
 
 /**
@@ -12,7 +12,10 @@ interface ChangeAmplificationSummary {
     commitsAnalyzed: number;
 }
 interface CountLocSummary {
+    /** Raw finding count reported to users. */
     count: number;
+    /** Score-pressure count; lower than count when findings are broad discovery leads. */
+    scoreCount?: number;
     loc: number;
     /** Files contributing findings — feeds fix-density validation. */
     files?: string[];
@@ -75,6 +78,15 @@ interface ScoreDeduction {
     /** Risk deductions are empirically validated predictors; hygiene are tidiness signals. */
     kind: 'risk' | 'hygiene';
 }
+interface HealthPressure {
+    axis: string;
+    category: string;
+    kind: ScoreDeduction['kind'];
+    count: number;
+    threshold: number;
+    ratio: number;
+    extraPenalty: number;
+}
 interface HealthAxes {
     /** LOC provably removable with behavior preserved (dead + isolated). */
     deletable: {
@@ -86,7 +98,7 @@ interface HealthAxes {
     };
     /** Files touched per commit — the measured cost of one conceptual change. */
     changeAmplification: ChangeAmplificationSummary | null;
-    /** File pairs that co-change without a dependency edge — concepts the reference graph can't see. */
+    /** File pairs that co-change without a structural link — concepts the visible graph can't see. */
     hiddenCoupling: {
         pairCount: number;
         top: Array<{
@@ -145,6 +157,14 @@ interface HealthReport {
         isolatedLoc: number;
         cycles: number;
         similarPairs: number;
+        reactComponentDuplicatePairs: number;
+        reactHookCandidatePairs: number;
+        reactHookCandidateScoreCount: number;
+        reactLargeComponentPressureFiles: number;
+        vueComponentDuplicatePairs: number;
+        vueComposableCandidatePairs: number;
+        vueComposableCandidateScoreCount: number;
+        vueLargeViewPressureFiles: number;
         extractionCandidates: number;
         wrappers: number;
         passthroughs: number;
@@ -160,6 +180,7 @@ interface HealthReport {
         byCategory: Record<string, number>;
     } | null;
     actions: HealthAction[];
+    pressure: HealthPressure[];
     topComplexity: Array<{
         symbol: string;
         score: number;
@@ -168,7 +189,7 @@ interface HealthReport {
     warnings?: string[];
 }
 
-declare const HEALTH_PHASES: readonly ["overview", "dead", "isolated", "cycles", "similar", "extract-candidates", "wrapper-candidates", "passthrough-candidates", "stale-abstractions", "drift", "complexity-hotspots", "git-evidence", "suppressions"];
+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"];
 type HealthPhaseName = typeof HEALTH_PHASES[number];
 type HealthPhaseResult = {
     phase: 'overview';
@@ -186,6 +207,24 @@ type HealthPhaseResult = {
 } | {
     phase: 'similar';
     similarCount: number;
+} | {
+    phase: 'react-component-duplicates';
+    reactComponentDuplicates: CountLocSummary;
+} | {
+    phase: 'react-hook-candidates';
+    reactHookCandidates: CountLocSummary;
+} | {
+    phase: 'react-large-component-pressure';
+    reactLargeComponentPressure: CountLocSummary;
+} | {
+    phase: 'vue-component-duplicates';
+    vueComponentDuplicates: CountLocSummary;
+} | {
+    phase: 'vue-composable-candidates';
+    vueComposableCandidates: CountLocSummary;
+} | {
+    phase: 'vue-large-view-pressure';
+    vueLargeViewPressure: CountLocSummary;
 } | {
     phase: 'extract-candidates';
     extractCount: number;

package/dist/index.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from './db-DdTPetj5.js';
-export { c as createGitignoreFilter } from './db-DdTPetj5.js';
-export { S as ScipQueryConfig } from './config-types-CGIeLEpY.js';
+import { S as ScipDatabase } from './db-BkFlkzI3.js';
+export { c as createGitignoreFilter } from './db-BkFlkzI3.js';
+export { S as ScipQueryConfig } from './config-types-Bok4jrO3.js';
 import 'better-sqlite3';
 
 /**
@@ -199,7 +199,7 @@ interface SourceReferenceResolveContext {
 }
 declare function scanSourceReferences(db: ScipDatabase, opts: ScanSourceReferencesOptions, visit: (hit: SourceReferenceHit) => void): void;
 
-interface ProductionCallableDefinitionsOptions {
+declare function productionCallableDefinitions(db: ScipDatabase, opts?: {
     scope?: string;
     minLoc?: number;
     maxLoc?: number;
@@ -217,13 +217,14 @@ interface ProductionCallableDefinitionsOptions {
     requireFunctionLikeSymbol?: boolean;
     requireCallableSymbol?: boolean;
     sortByLocDesc?: boolean;
-}
+}): IndexedDefinition[];
+
 declare class ProjectIndex {
     private readonly db;
     constructor(db: ScipDatabase);
     scopedDefinitions(scope?: string): IndexedDefinition[];
     definitionsForFile(relativePath: string): IndexedDefinition[];
-    productionCallableDefinitions(opts?: ProductionCallableDefinitionsOptions): IndexedDefinition[];
+    productionCallableDefinitions(opts?: NonNullable<Parameters<typeof productionCallableDefinitions>[1]>): IndexedDefinition[];
     calleeMap(definitions: ReadonlyArray<SymbolMatch>, opts?: {
         additive?: boolean;
         semantic?: boolean;

package/dist/index.js

@@ -1,4 +1,4 @@
-import{a}from"./chunk-TKDJQ2WD.js";import{a as s}from"./chunk-NO2TPMCQ.js";import"./chunk-TQTVM27C.js";import"./chunk-RIXOMSOR.js";import"./chunk-EAU4RDFG.js";import"./chunk-PCMVXWDC.js";import"./chunk-6ZFKI5EP.js";import"./chunk-64UY7VTR.js";import"./chunk-7I6KNKE3.js";import"./chunk-APLCSDXL.js";import"./chunk-WEJYUS5O.js";import"./chunk-PBGTMPJ7.js";import{a as i,c as n,d as l}from"./chunk-SOGLYIJ4.js";import"./chunk-WQFOZIID.js";import"./chunk-NN3O7TPH.js";import"./chunk-VDZL45XI.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"],o=class{db;config;pathFilter;constructor(t,e){this.config=t,this.pathFilter=e??null,this.db=new c(t.dbPath,{readonly:!0}),this.db.pragma("busy_timeout = 5000")}isIgnored(t){return this.pathFilter?.isIgnored(t)??!1}get localSymbolPredicate(){return`(
+import{a}from"./chunk-TKDJQ2WD.js";import{a as s}from"./chunk-W3PQRAI4.js";import"./chunk-L77GXANO.js";import"./chunk-BGBBVSH4.js";import"./chunk-623UQCVG.js";import"./chunk-44JOJLMO.js";import"./chunk-SA6B3EGD.js";import"./chunk-QH5GTVVB.js";import"./chunk-5ALI77D7.js";import"./chunk-5D3BT4B4.js";import"./chunk-QUKZ77A6.js";import"./chunk-ADKQX2OY.js";import{a as i,c as n,d as l}from"./chunk-64LH2QUP.js";import"./chunk-T67R7V5I.js";import"./chunk-XGGTESMN.js";import"./chunk-HCQ7J2N5.js";import"./chunk-YVQUQIBM.js";import"./chunk-CMGOXDVP.js";import"./chunk-TMS4JPWY.js";import"./chunk-NN3O7TPH.js";import"./chunk-BJ7OHKB5.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"],o=class{db;config;pathFilter;constructor(t,e){this.config=t,this.pathFilter=e??null,this.db=new c(t.dbPath,{readonly:!0}),this.db.pragma("busy_timeout = 5000")}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,6 @@
 #!/usr/bin/env node
-import{b as k,c as g,d as f,e as m}from"./chunk-LWYIGRHR.js";import{existsSync as p,mkdirSync as L,symlinkSync as v,readlinkSync as b,unlinkSync as q}from"fs";import{join as t,dirname as y,resolve as d}from"path";import{homedir as u,platform as C}from"os";import{fileURLToPath as N}from"url";var R=C()==="win32",T=["scip-query","concrete-plan","scip-ai-cleanup","scip-explore","scip-debloat","scip-doc-reconcile","scip-maintainability","scip-verify","scip-language-playbook"];function A(n={}){let e=n.quiet?()=>{}:console.log,o=N(import.meta.url),I=d(y(o),"..","skills"),$=[t(u(),".claude","skills"),t(u(),".codex","skills"),t(u(),".agents","skills")],s={installed:[],skipped:[],alreadyLinked:[]};for(let r of $){let h=y(r);if(!p(h))continue;L(r,{recursive:!0});let l=j(r);for(let i of T){let a=t(I,i),c=t(r,i);if(!p(a)){s.skipped.push(`${l}/${i}`);continue}if(p(c)){try{let x=b(c);if(d(x)===d(a)){s.alreadyLinked.push(`${l}/${i}`),e(`  ok:   ${i} \u2192 ${l} (already linked)`);continue}}catch{s.skipped.push(`${l}/${i}`),e(`  skip: ${i} \u2192 ${l} (exists, not a symlink)`);continue}q(c)}v(a,c,R?"junction":"dir"),s.installed.push(`${l}/${i}`),e(`  done: ${i} \u2192 ${l}`)}}return s}function j(n){return n.includes(".codex")?"Codex":n.includes(".agents")?"Agents":"Claude"}function S(){console.log("scip-query: installing skills...");let n=A({quiet:!1});if(n.installed.length+n.alreadyLinked.length>0&&console.log(`
-${n.installed.length} skill(s) installed, ${n.alreadyLinked.length} already linked.`),!k())console.log(`
+import{b as k,c as g,d as f,e as m}from"./chunk-LWYIGRHR.js";import{existsSync as p,mkdirSync as L,symlinkSync as b,readlinkSync as v,unlinkSync as q}from"fs";import{join as s,dirname as y,resolve as d}from"path";import{homedir as u,platform as C}from"os";import{fileURLToPath as N}from"url";var R=C()==="win32",T=["scip-query","concrete-plan","scip-ai-cleanup","scip-explore","scip-debloat","scip-doc-reconcile","scip-maintainability","scip-react-maintainability","scip-vue-maintainability","scip-verify","scip-language-playbook"];function A(i={}){let e=i.quiet?()=>{}:console.log,o=N(import.meta.url),I=d(y(o),"..","skills"),$=[s(u(),".claude","skills"),s(u(),".codex","skills"),s(u(),".agents","skills")],l={installed:[],skipped:[],alreadyLinked:[]};for(let r of $){let h=y(r);if(!p(h))continue;L(r,{recursive:!0});let t=j(r);for(let n of T){let a=s(I,n),c=s(r,n);if(!p(a)){l.skipped.push(`${t}/${n}`);continue}if(p(c)){try{let x=v(c);if(d(x)===d(a)){l.alreadyLinked.push(`${t}/${n}`),e(`  ok:   ${n} \u2192 ${t} (already linked)`);continue}}catch{l.skipped.push(`${t}/${n}`),e(`  skip: ${n} \u2192 ${t} (exists, not a symlink)`);continue}q(c)}b(a,c,R?"junction":"dir"),l.installed.push(`${t}/${n}`),e(`  done: ${n} \u2192 ${t}`)}}return l}function j(i){return i.includes(".codex")?"Codex":i.includes(".agents")?"Agents":"Claude"}function S(){console.log("scip-query: installing skills...");let i=A({quiet:!1});if(i.installed.length+i.alreadyLinked.length>0&&console.log(`
+${i.installed.length} skill(s) installed, ${i.alreadyLinked.length} already linked.`),!k())console.log(`
 scip CLI not found on PATH. Attempting auto-install...`),m(console.log)||f();else{let o=g();console.log(`
 scip CLI: ${o??"installed"}`)}console.log("")}S();
 //# sourceMappingURL=postinstall.js.map

package/dist/queries/affected.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface AffectedResult {
     symbol: string;

package/dist/queries/affected.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-UUDYI3FF.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as affected};
+import{a}from"../chunk-LT6GJ27X.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.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-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface BottleneckResult {
     symbol: string;

package/dist/queries/bottlenecks.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-L6TOEQ2M.js";import"../chunk-MX6F756F.js";import"../chunk-NO2TPMCQ.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as bottlenecks};
+import{a}from"../chunk-LUBKUISI.js";import"../chunk-B75HZHUP.js";import"../chunk-W3PQRAI4.js";import"../chunk-L77GXANO.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.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-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface ByKindResult {
     symbol: string;

package/dist/queries/by-kind.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-RCRK4E7E.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as byKind,b as kindCounts};
+import{a,b}from"../chunk-DMLPJ75B.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.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-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface CallGraphResult {
     symbol: string;

package/dist/queries/call-graph.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-D43L5PQF.js";import"../chunk-MX6F756F.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as callGraph};
+import{a}from"../chunk-I6PTB2CM.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.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-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface ChangeSurfaceEntry {
     symbol: string;

package/dist/queries/change-surface.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-ITUU3VE3.js";import"../chunk-WC43FMAB.js";import"../chunk-NO2TPMCQ.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as changeSurface};
+import{a}from"../chunk-4N7LFYSD.js";import"../chunk-QOFKVNFE.js";import"../chunk-W3PQRAI4.js";import"../chunk-L77GXANO.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.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-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface CleanupPlanEntry {
     symbol: string;

package/dist/queries/cleanup-plan.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-VTF5EH22.js";import"../chunk-YO6DU7QZ.js";import"../chunk-MX6F756F.js";import"../chunk-NO2TPMCQ.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{b as RemovedRangeIndex,a as cleanupPlan};
+import{a,b}from"../chunk-27KPKLRJ.js";import"../chunk-6U4EODW3.js";import"../chunk-B75HZHUP.js";import"../chunk-W3PQRAI4.js";import"../chunk-L77GXANO.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{b as RemovedRangeIndex,a as cleanupPlan};
 //# sourceMappingURL=cleanup-plan.js.map

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

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface CoChangeFinding {
     fileA: string;
@@ -11,7 +11,7 @@ interface CoChangeFinding {
     confidence: number;
     changesA: number;
     changesB: number;
-    /** True when a dependency edge already explains the coupling. */
+    /** True when a dependency edge or declared coupling already explains the pair. */
     structurallyLinked: boolean;
 }
 interface CoChangeResult {
@@ -23,7 +23,7 @@ interface CoChangeResult {
 declare function isCoChangeNoiseFile(file: string): boolean;
 /**
  * Hidden coupling from the change graph: file pairs that repeatedly change
- * in the same commits but have NO dependency edge between them.
+ * in the same commits but have no structural link between them.
  *
  * The reference graph cannot see that two mechanisms implement one concept —
  * a config list and the test that checks it share no symbols. The commit
@@ -37,6 +37,7 @@ declare function coChange(db: ScipDatabase, file?: string, opts?: {
     minConfidence?: number;
     limit?: number;
     includeLinked?: boolean;
+    maxFilesPerCommit?: number;
 }): CoChangeResult;
 
 export { type CoChangeFinding, type CoChangeResult, coChange, isCoChangeNoiseFile };

package/dist/queries/co-change.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-I66MQD5U.js";import"../chunk-R3G6ERW7.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{b as coChange,a as isCoChangeNoiseFile};
+import{a,b}from"../chunk-RYBMW2EN.js";import"../chunk-YISMWW66.js";import"../chunk-L77GXANO.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{b as coChange,a as isCoChangeNoiseFile};
 //# sourceMappingURL=co-change.js.map

package/dist/queries/code.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface CodeResult {
     symbol: string;

package/dist/queries/code.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-Z2AJQ7VA.js";import"../chunk-WC43FMAB.js";import"../chunk-7I6KNKE3.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as code};
+import{a}from"../chunk-YYCQQBMG.js";import"../chunk-QOFKVNFE.js";import"../chunk-5ALI77D7.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as code};
 //# sourceMappingURL=code.js.map

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

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface ComplexityHotspot {
     symbol: string;

package/dist/queries/complexity-hotspots.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-VHENVDS2.js";import"../chunk-V76FCF5F.js";import"../chunk-MX6F756F.js";import"../chunk-NO2TPMCQ.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as complexityHotspots};
+import{a}from"../chunk-IJYWCB57.js";import"../chunk-5BZOSICN.js";import"../chunk-B75HZHUP.js";import"../chunk-W3PQRAI4.js";import"../chunk-L77GXANO.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as complexityHotspots};
 //# sourceMappingURL=complexity-hotspots.js.map

package/dist/queries/complexity.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface ComplexityResult {
     symbol: string;

package/dist/queries/complexity.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-YSSTUCNS.js";import"../chunk-NO2TPMCQ.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as complexity};
+import{a}from"../chunk-5HDYAOSF.js";import"../chunk-W3PQRAI4.js";import"../chunk-L77GXANO.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as complexity};
 //# sourceMappingURL=complexity.js.map

package/dist/queries/convergence.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface ConvergenceResult {
     symbolA: {

package/dist/queries/convergence.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-I7OTKWNY.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as convergence};
+import{a}from"../chunk-ADTG377O.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as convergence};
 //# sourceMappingURL=convergence.js.map

package/dist/queries/coupling.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface CouplingResult {
     file1: string;

package/dist/queries/coupling.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-46ILZVMX.js";import"../chunk-WC43FMAB.js";import"../chunk-7I6KNKE3.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as coupling,b as topCoupling};
+import{a,b}from"../chunk-PV4CEDIL.js";import"../chunk-QOFKVNFE.js";import"../chunk-5ALI77D7.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as coupling,b as topCoupling};
 //# sourceMappingURL=coupling.js.map

package/dist/queries/cycles.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface CycleResult {
     /** Files forming a cycle, in order */

package/dist/queries/cycles.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-EKP7XJ6L.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as cycles};
+import{a}from"../chunk-E55WCTLH.js";import"../chunk-L77GXANO.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as cycles};
 //# sourceMappingURL=cycles.js.map

package/dist/queries/dataflow.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface DataflowResult {
     symbol: string;

package/dist/queries/dataflow.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-BCFED24F.js";import"../chunk-MX6F756F.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as dataflow};
+import{a}from"../chunk-YIE5FZAF.js";import"../chunk-B75HZHUP.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as dataflow};
 //# sourceMappingURL=dataflow.js.map

package/dist/queries/dead.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface DeadOptions {
     scope?: string;

package/dist/queries/dead.js

@@ -1,2 +1,2 @@
-import{b as a}from"../chunk-YO6DU7QZ.js";import"../chunk-MX6F756F.js";import"../chunk-NO2TPMCQ.js";import"../chunk-TQTVM27C.js";import"../chunk-RIXOMSOR.js";import"../chunk-EAU4RDFG.js";import"../chunk-PCMVXWDC.js";import"../chunk-6ZFKI5EP.js";import"../chunk-64UY7VTR.js";import"../chunk-7I6KNKE3.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-PBGTMPJ7.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as dead};
+import{b as a}from"../chunk-6U4EODW3.js";import"../chunk-B75HZHUP.js";import"../chunk-W3PQRAI4.js";import"../chunk-L77GXANO.js";import"../chunk-BGBBVSH4.js";import"../chunk-623UQCVG.js";import"../chunk-44JOJLMO.js";import"../chunk-SA6B3EGD.js";import"../chunk-QH5GTVVB.js";import"../chunk-5ALI77D7.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as dead};
 //# sourceMappingURL=dead.js.map

package/dist/queries/deep-chains.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface DeepChainResult {
     /** Files in the chain, from leaf to root */

package/dist/queries/deep-chains.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-PE4EJOLN.js";import"../chunk-RIXOMSOR.js";import"../chunk-APLCSDXL.js";import"../chunk-WEJYUS5O.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as deepChains};
+import{a}from"../chunk-332L7SRO.js";import"../chunk-5D3BT4B4.js";import"../chunk-QUKZ77A6.js";import"../chunk-ADKQX2OY.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as deepChains};
 //# sourceMappingURL=deep-chains.js.map

package/dist/queries/deps.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
+import '../config-types-Bok4jrO3.js';
 
 interface DepResult {
     relativePath: string;

package/dist/queries/deps.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-AGW2MVIO.js";import"../chunk-WC43FMAB.js";import"../chunk-7I6KNKE3.js";import"../chunk-SOGLYIJ4.js";import"../chunk-WQFOZIID.js";import"../chunk-NN3O7TPH.js";import"../chunk-VDZL45XI.js";export{a as deps,b as rdeps};
+import{a,b}from"../chunk-5VB3WU7K.js";import"../chunk-QOFKVNFE.js";import"../chunk-5ALI77D7.js";import"../chunk-64LH2QUP.js";import"../chunk-T67R7V5I.js";import"../chunk-XGGTESMN.js";import"../chunk-HCQ7J2N5.js";import"../chunk-YVQUQIBM.js";import"../chunk-CMGOXDVP.js";import"../chunk-TMS4JPWY.js";import"../chunk-NN3O7TPH.js";import"../chunk-BJ7OHKB5.js";export{a as deps,b as rdeps};
 //# sourceMappingURL=deps.js.map

package/dist/queries/diff-gate.d.ts

@@ -1,13 +1,28 @@
-import { S as ScipDatabase } from '../db-DdTPetj5.js';
+import { S as ScipDatabase } from '../db-BkFlkzI3.js';
+import { F as FindingSuppression } from '../config-types-Bok4jrO3.js';
 import 'better-sqlite3';
-import '../config-types-CGIeLEpY.js';
 
 type DiffGateCheck = 'echo' | 'incomplete-migration' | 'co-change-partner' | 'doc-reference' | 'unused-params' | 'new-dead' | 'baseline';
+/** Canonical check list — the CLI validates `--skip` values against this. */
+declare const DIFF_GATE_CHECKS: readonly DiffGateCheck[];
+type DiffGateEvidence = 'graph-fact' | 'semantic' | 'heuristic' | 'change-graph' | 'baseline';
+type DiffGateSeverity = 'info' | 'warning' | 'error';
 interface DiffGateFinding {
+    id: string;
     check: DiffGateCheck;
+    severity: DiffGateSeverity;
+    evidence: DiffGateEvidence;
+    confidence?: number;
+    file?: string;
+    startLine?: number;
+    endLine?: number;
+    symbol?: string;
+    relatedFiles?: string[];
     message: string;
+    why: string[];
     /** Concrete remediation an agent can act on without human triage. */
     remediation: string;
+    suppressionHint?: string;
 }
 interface DiffGateResult {
     base: string;
@@ -19,6 +34,11 @@ interface DiffGateResult {
         check: DiffGateCheck;
         reason: string;
     }>;
+    /** Findings accepted by structured .scipquery.json suppressions. */
+    suppressed: Array<{
+        finding: DiffGateFinding;
+        suppression: FindingSuppression;
+    }>;
     findings: DiffGateFinding[];
     note?: string;
 }
@@ -49,7 +69,9 @@ declare function diffGate(db: ScipDatabase, opts?: {
     minTogether?: number;
     minConfidence?: number;
     maxEchoChecks?: number;
+    maxHelpers?: number;
     minSimilarity?: number;
+    skip?: readonly DiffGateCheck[];
 }): DiffGateResult;
 
-export { type DiffGateCheck, type DiffGateFinding, type DiffGateResult, diffGate };
+export { DIFF_GATE_CHECKS, type DiffGateCheck, type DiffGateEvidence, type DiffGateFinding, type DiffGateResult, type DiffGateSeverity, diffGate };