scip-query 0.1.0

package/dist/queries/convergence.d.ts

@@ -0,0 +1,11 @@
+import { S as ScipDatabase, f as ConvergenceResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Given two similar symbols, show what a consolidated version would look like.
+ * The shared callee set becomes the common body. The unique callees become
+ * the parameterization points.
+ */
+declare function convergence(db: ScipDatabase, symbolPatternA: string, symbolPatternB: string): ConvergenceResult | null;
+
+export { convergence };

package/dist/queries/convergence.js

@@ -0,0 +1,9 @@
+import {
+  convergence
+} from "../chunk-LB7OS35Q.js";
+import "../chunk-FUHJCHS4.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  convergence
+};
+//# sourceMappingURL=convergence.js.map

package/dist/queries/convergence.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/coupling.d.ts

@@ -0,0 +1,17 @@
+import { S as ScipDatabase, g as CouplingResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Measure coupling between two files: how many symbols do they share
+ * (symbols defined in one and referenced in the other, or vice versa).
+ */
+declare function coupling(db: ScipDatabase, file1: string, file2: string): CouplingResult;
+/**
+ * Find the most coupled file pairs in the codebase.
+ */
+declare function topCoupling(db: ScipDatabase, opts?: {
+    limit?: number;
+    scope?: string;
+}): CouplingResult[];
+
+export { coupling, topCoupling };

package/dist/queries/coupling.js

@@ -0,0 +1,9 @@
+import {
+  coupling,
+  topCoupling
+} from "../chunk-KVSW5KYP.js";
+export {
+  coupling,
+  topCoupling
+};
+//# sourceMappingURL=coupling.js.map

package/dist/queries/coupling.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/cycles.d.ts

@@ -0,0 +1,16 @@
+import { S as ScipDatabase, h as CycleResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Detect circular dependency chains between files.
+ * A cycle exists when file A depends on B, B depends on C, and C depends on A.
+ *
+ * Uses the same dependency edges as the `deps` command (symbol definitions
+ * referenced across files), then runs DFS cycle detection.
+ */
+declare function cycles(db: ScipDatabase, opts?: {
+    scope?: string;
+    maxDepth?: number;
+}): CycleResult[];
+
+export { cycles };

package/dist/queries/cycles.js

@@ -0,0 +1,8 @@
+import {
+  cycles
+} from "../chunk-5WTJAXY2.js";
+import "../chunk-FUHJCHS4.js";
+export {
+  cycles
+};
+//# sourceMappingURL=cycles.js.map

package/dist/queries/cycles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/dataflow.d.ts

@@ -0,0 +1,19 @@
+import { S as ScipDatabase, D as DataflowResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Reference-level dataflow analysis: where does data around this symbol
+ * come from and where does it go?
+ *
+ * This is not value-level dataflow (we can't trace x = foo(); bar(x);
+ * as a chain). Instead it shows:
+ * - Where the symbol is defined and used
+ * - What other symbols appear in the same enclosing scope (co-occurring data)
+ * - What feeds into the function that defines it (producers)
+ * - What consumes the function that uses it (consumers)
+ *
+ * Language-agnostic: works with any SCIP index.
+ */
+declare function dataflow(db: ScipDatabase, symbolPattern: string): DataflowResult | null;
+
+export { dataflow };

package/dist/queries/dataflow.js

@@ -0,0 +1,9 @@
+import {
+  dataflow
+} from "../chunk-T6ARFSBZ.js";
+import "../chunk-FUHJCHS4.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  dataflow
+};
+//# sourceMappingURL=dataflow.js.map

package/dist/queries/dataflow.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/dead.d.ts

@@ -0,0 +1,10 @@
+import { S as ScipDatabase, i as DeadOptions, j as DeadSummary } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Find dead exports: symbols defined locally with no cross-file references.
+ * Language-agnostic — works with any SCIP index.
+ */
+declare function dead(db: ScipDatabase, opts?: DeadOptions): DeadSummary;
+
+export { dead };

package/dist/queries/dead.js

@@ -0,0 +1,9 @@
+import {
+  dead
+} from "../chunk-5FGUEU7N.js";
+import "../chunk-FUHJCHS4.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  dead
+};
+//# sourceMappingURL=dead.js.map

package/dist/queries/dead.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,16 @@
+import { S as ScipDatabase, k as DeepChainResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Find the longest transitive dependency chains between files.
+ * A chain A → B → C → D means A depends on B, B on C, C on D.
+ *
+ * Long chains = high coupling depth = changes at the end ripple through many layers.
+ */
+declare function deepChains(db: ScipDatabase, opts?: {
+    limit?: number;
+    scope?: string;
+    minDepth?: number;
+}): DeepChainResult[];
+
+export { deepChains };

package/dist/queries/deep-chains.js

@@ -0,0 +1,8 @@
+import {
+  deepChains
+} from "../chunk-MBVNHJVN.js";
+import "../chunk-FUHJCHS4.js";
+export {
+  deepChains
+};
+//# sourceMappingURL=deep-chains.js.map

package/dist/queries/deep-chains.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/deps.d.ts

@@ -0,0 +1,9 @@
+import { S as ScipDatabase, l as DepResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/** What internal files does this file depend on? (forward dependencies) */
+declare function deps(db: ScipDatabase, filePattern: string): DepResult[];
+/** What files depend on this file/module? (reverse dependencies) */
+declare function rdeps(db: ScipDatabase, filePattern: string): DepResult[];
+
+export { deps, rdeps };

package/dist/queries/deps.js

@@ -0,0 +1,9 @@
+import {
+  deps,
+  rdeps
+} from "../chunk-N5KEREIA.js";
+export {
+  deps,
+  rdeps
+};
+//# sourceMappingURL=deps.js.map

package/dist/queries/deps.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,13 @@
+import { S as ScipDatabase, m as DiffImpactResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Given a git diff, compute the affected symbol set.
+ * Finds all symbols defined in changed files, their fan-in,
+ * the files that consume them, and test coverage gaps.
+ */
+declare function diffImpact(db: ScipDatabase, opts?: {
+    base?: string;
+}): DiffImpactResult;
+
+export { diffImpact };

package/dist/queries/diff-impact.js

@@ -0,0 +1,9 @@
+import {
+  diffImpact
+} from "../chunk-YZAA4LYG.js";
+import "../chunk-FUHJCHS4.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  diffImpact
+};
+//# sourceMappingURL=diff-impact.js.map

package/dist/queries/diff-impact.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/doc-coverage.d.ts

@@ -0,0 +1,14 @@
+import { S as ScipDatabase, n as DocCoverageResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Check documentation coverage: what percentage of symbols have doc strings?
+ * Reports overall stats and lists undocumented symbols.
+ */
+declare function docCoverage(db: ScipDatabase, opts?: {
+    scope?: string;
+    minLoc?: number;
+    limit?: number;
+}): DocCoverageResult;
+
+export { docCoverage };

package/dist/queries/doc-coverage.js

@@ -0,0 +1,8 @@
+import {
+  docCoverage
+} from "../chunk-FGXRVW7G.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  docCoverage
+};
+//# sourceMappingURL=doc-coverage.js.map

package/dist/queries/doc-coverage.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/drift.d.ts

@@ -0,0 +1,25 @@
+import { S as ScipDatabase, o as DriftSummary } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Detect structural drift using the reference graph, not just import patterns.
+ *
+ * Three types of drift, each detecting a real problem:
+ *
+ * 1. **Unused imports** — file depends on a module but never references
+ *    any of its symbols. Dead dependency, safe to remove.
+ *
+ * 2. **Layer violations** — file imports from a directory it shouldn't
+ *    based on the project's directory structure (e.g., a query importing
+ *    from reindex, a helper importing from CLI). Architectural decay.
+ *
+ * 3. **Pattern deviations** — file imports something no sibling does,
+ *    suggesting it's reaching outside its expected scope. Only flagged
+ *    when the file is the ONLY one in its directory with that dep.
+ */
+declare function drift(db: ScipDatabase, opts?: {
+    scope?: string;
+    minDeviation?: number;
+}): DriftSummary;
+
+export { drift };

package/dist/queries/drift.js

@@ -0,0 +1,8 @@
+import {
+  drift
+} from "../chunk-36OMT7ZJ.js";
+import "../chunk-FUHJCHS4.js";
+export {
+  drift
+};
+//# sourceMappingURL=drift.js.map

package/dist/queries/drift.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

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

@@ -0,0 +1,25 @@
+import { S as ScipDatabase, E as ExtractCandidate } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Find functions with natural extraction seams.
+ *
+ * A large function that references two distinct groups of symbols —
+ * where group A's symbols are never co-referenced with group B's —
+ * has a natural extraction boundary. The isolated cluster can likely
+ * be pulled into its own function.
+ *
+ * We detect this by:
+ * 1. Finding all callees of a function
+ * 2. Building a co-occurrence graph (which callees appear in the same chunk)
+ * 3. Finding connected components — disconnected components = extraction seams
+ * 4. Scoring each cluster by how isolated it is from the rest
+ */
+declare function extractCandidates(db: ScipDatabase, opts?: {
+    scope?: string;
+    minLoc?: number;
+    minCallees?: number;
+    limit?: number;
+}): ExtractCandidate[];
+
+export { extractCandidates };

package/dist/queries/extract-candidates.js

@@ -0,0 +1,9 @@
+import {
+  extractCandidates
+} from "../chunk-CM454WL3.js";
+import "../chunk-FUHJCHS4.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  extractCandidates
+};
+//# sourceMappingURL=extract-candidates.js.map

package/dist/queries/extract-candidates.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/fan.d.ts

@@ -0,0 +1,29 @@
+import { S as ScipDatabase, F as FanResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Fan-in: how many distinct files reference this symbol.
+ * High fan-in = widely depended upon = high blast radius for changes.
+ */
+declare function fanIn(db: ScipDatabase, symbolPattern: string): FanResult[];
+/**
+ * Fan-out: how many external symbols does this file reference.
+ * High fan-out = depends on many things = fragile to upstream changes.
+ */
+declare function fanOut(db: ScipDatabase, filePattern: string): FanResult[];
+/**
+ * Top fan-in across the whole codebase — the most depended-on symbols.
+ */
+declare function topFanIn(db: ScipDatabase, opts?: {
+    limit?: number;
+    scope?: string;
+}): FanResult[];
+/**
+ * Top fan-out across the whole codebase — files that depend on the most external symbols.
+ */
+declare function topFanOut(db: ScipDatabase, opts?: {
+    limit?: number;
+    scope?: string;
+}): FanResult[];
+
+export { fanIn, fanOut, topFanIn, topFanOut };

package/dist/queries/fan.js

@@ -0,0 +1,14 @@
+import {
+  fanIn,
+  fanOut,
+  topFanIn,
+  topFanOut
+} from "../chunk-GTILYBH6.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  fanIn,
+  fanOut,
+  topFanIn,
+  topFanOut
+};
+//# sourceMappingURL=fan.js.map

package/dist/queries/fan.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/files.d.ts

@@ -0,0 +1,6 @@
+import { S as ScipDatabase, p as FileResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+declare function files(db: ScipDatabase, pattern: string): FileResult[];
+
+export { files };

package/dist/queries/files.js

@@ -0,0 +1,7 @@
+import {
+  files
+} from "../chunk-MGNMHKX3.js";
+export {
+  files
+};
+//# sourceMappingURL=files.js.map

package/dist/queries/files.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/health.d.ts

@@ -0,0 +1,18 @@
+import { S as ScipDatabase, H as HealthReport } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Single composite health report that runs all de-bloat analyses
+ * and produces a prioritized action list.
+ *
+ * The scoring formula accounts for common false positives:
+ * - Entry points (CLI, workers, barrels) appearing as "dead code"
+ * - Typed result interfaces with 1 consumer (normal for APIs)
+ * - Consistent import patterns across sibling modules (not duplication)
+ * - Barrel and orchestrator files deviating from sibling patterns (expected)
+ */
+declare function health(db: ScipDatabase, opts?: {
+    scope?: string;
+}): HealthReport;
+
+export { health };

package/dist/queries/health.js

@@ -0,0 +1,21 @@
+import {
+  health
+} from "../chunk-7OZPA5OO.js";
+import "../chunk-GJFURBEW.js";
+import "../chunk-XFXDXEUN.js";
+import "../chunk-3ZZJVBIO.js";
+import "../chunk-TDNNOR6D.js";
+import "../chunk-NDSQYIWT.js";
+import "../chunk-TSPZOMHC.js";
+import "../chunk-LUSIFBXO.js";
+import "../chunk-36OMT7ZJ.js";
+import "../chunk-CM454WL3.js";
+import "../chunk-EMDQWNYR.js";
+import "../chunk-5WTJAXY2.js";
+import "../chunk-5FGUEU7N.js";
+import "../chunk-FUHJCHS4.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  health
+};
+//# sourceMappingURL=health.js.map

package/dist/queries/health.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/hierarchy.d.ts

@@ -0,0 +1,13 @@
+import { S as ScipDatabase, q as HierarchyNode } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Walk the enclosing_symbol chain upward to show a symbol's ancestry.
+ * e.g., method → class → module → file
+ *
+ * Falls back to parsing the SCIP symbol descriptor chain when
+ * enclosing_symbol is not populated by the indexer.
+ */
+declare function hierarchy(db: ScipDatabase, symbolPattern: string): HierarchyNode[];
+
+export { hierarchy };

package/dist/queries/hierarchy.js

@@ -0,0 +1,8 @@
+import {
+  hierarchy
+} from "../chunk-DEZKCZXD.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  hierarchy
+};
+//# sourceMappingURL=hierarchy.js.map

package/dist/queries/hierarchy.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/hotspots.d.ts

@@ -0,0 +1,13 @@
+import { S as ScipDatabase, r as HotspotResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * Find the most-referenced symbols in the codebase — the choke points
+ * where changes have the widest blast radius.
+ */
+declare function hotspots(db: ScipDatabase, opts?: {
+    limit?: number;
+    scope?: string;
+}): HotspotResult[];
+
+export { hotspots };

package/dist/queries/hotspots.js

@@ -0,0 +1,8 @@
+import {
+  hotspots
+} from "../chunk-BFSCMC22.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  hotspots
+};
+//# sourceMappingURL=hotspots.js.map

package/dist/queries/hotspots.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/imports.d.ts

@@ -0,0 +1,19 @@
+import { S as ScipDatabase, I as ImportResult, U as UnusedImportResult } from '../db-BxaevAyc.js';
+import 'better-sqlite3';
+
+/**
+ * What symbols does this file import?
+ * Uses role=2 (import) from the SCIP mentions table.
+ */
+declare function imports(db: ScipDatabase, filePattern: string): ImportResult[];
+/**
+ * Which files import this symbol?
+ */
+declare function importedBy(db: ScipDatabase, symbolPattern: string): ImportResult[];
+/**
+ * Find imports in a file that are never referenced (role=0) in the same file.
+ * These are likely unused imports.
+ */
+declare function unusedImports(db: ScipDatabase, filePattern: string): UnusedImportResult[];
+
+export { importedBy, imports, unusedImports };

package/dist/queries/imports.js

@@ -0,0 +1,12 @@
+import {
+  importedBy,
+  imports,
+  unusedImports
+} from "../chunk-BEPIEVLR.js";
+import "../chunk-QOV2R2WT.js";
+export {
+  importedBy,
+  imports,
+  unusedImports
+};
+//# sourceMappingURL=imports.js.map

package/dist/queries/imports.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/queries/index.d.ts

@@ -0,0 +1,47 @@
+export { stats } from './stats.js';
+export { files } from './files.js';
+export { symbols } from './symbols.js';
+export { methods } from './methods.js';
+export { refs } from './refs.js';
+export { trace } from './trace.js';
+export { deps, rdeps } from './deps.js';
+export { system } from './system.js';
+export { surface } from './surface.js';
+export { dead } from './dead.js';
+export { hotspots } from './hotspots.js';
+export { importedBy, imports, unusedImports } from './imports.js';
+export { outline } from './outline.js';
+export { members } from './members.js';
+export { fanIn, fanOut, topFanIn, topFanOut } from './fan.js';
+export { coupling, topCoupling } from './coupling.js';
+export { cycles } from './cycles.js';
+export { bottlenecks } from './bottlenecks.js';
+export { isolated } from './isolated.js';
+export { byKind, kindCounts } from './by-kind.js';
+export { testCoverage, testCoverageSummary } from './test-coverage.js';
+export { docCoverage } from './doc-coverage.js';
+export { deepChains } from './deep-chains.js';
+export { hierarchy } from './hierarchy.js';
+export { callGraph } from './call-graph.js';
+export { similar, similarAll } from './similar.js';
+export { similarFiles } from './similar-files.js';
+export { similarChains } from './similar-chains.js';
+export { extractCandidates } from './extract-candidates.js';
+export { affected } from './affected.js';
+export { changeSurface } from './change-surface.js';
+export { diffImpact } from './diff-impact.js';
+export { drift } from './drift.js';
+export { wrapperCandidates } from './wrapper-candidates.js';
+export { passthroughCandidates } from './passthrough-candidates.js';
+export { staleAbstractions } from './stale-abstractions.js';
+export { complexityHotspots } from './complexity-hotspots.js';
+export { health } from './health.js';
+export { convergence } from './convergence.js';
+export { code } from './code.js';
+export { complexity } from './complexity.js';
+export { dataflow } from './dataflow.js';
+export { slice } from './slice.js';
+export { redundantReexports } from './redundant-reexports.js';
+export { similarSignatures } from './similar-signatures.js';
+import '../db-BxaevAyc.js';
+import 'better-sqlite3';