codebaseiq 0.1.0

package/dist/queries/similar.js

@@ -0,0 +1,2 @@
+import{a,b,c,d,e,f,g,h,i,j,k,l,m,n,o,p}from"../chunk-UDS562V4.js";import"../chunk-NMTSZXCL.js";import"../chunk-B75HZHUP.js";import"../chunk-7FND7D7N.js";import"../chunk-BGBBVSH4.js";import"../chunk-JOIRNPPY.js";import"../chunk-6CS3UQTN.js";import"../chunk-P5XHIJHI.js";import"../chunk-J77SU6VA.js";import"../chunk-UCD3H3UZ.js";import"../chunk-CVYSU6BX.js";import"../chunk-ELNRLMC5.js";import"../chunk-UZGZB3VB.js";import"../chunk-ZKX2FRS6.js";import"../chunk-C7QOQX32.js";import"../chunk-TIIC3ZE7.js";import"../chunk-YUKYB54I.js";import"../chunk-OANDYLJQ.js";import"../chunk-NNOKTMZT.js";import"../chunk-SGX43S2L.js";import"../chunk-FETNQCFO.js";import"../chunk-O6QTXQPJ.js";import"../chunk-ADTBPVUZ.js";import"../chunk-BMYOV5GP.js";import"../chunk-CWONGW6P.js";import"../chunk-3LCDIREB.js";import"../chunk-NNJ2KZZG.js";export{m as SAME_FILE_SIBLING_SATURATION_THRESHOLD,k as buildCalleeFingerprintIndex,l as candidateFingerprintsForTarget,p as classifySimilarityEvidence,d as comparePair,h as getAllCalleeFingerprints,i as getCalleeFingerprintIndex,g as insertTopSimilarResult,o as meaningfulCallees,a as similar,e as similarAll,f as similarAllCount,b as similarConsolidationPlan,j as similarityFingerprintProduct,c as targetSpecificIdfWeights,n as trimSameFileSiblingSaturatedCallees};
+//# sourceMappingURL=similar.js.map

package/dist/queries/slice.d.ts

@@ -0,0 +1,4 @@
+import '../db-D7sauVFH.js';
+export { SliceResult, referenceReachability, slice } from './reference-reachability.js';
+import 'better-sqlite3';
+import '../config-types-BNoC96J3.js';

package/dist/queries/slice.js

@@ -0,0 +1,2 @@
+import{a,b}from"../chunk-XME3HPXZ.js";import"../chunk-7FND7D7N.js";import"../chunk-BGBBVSH4.js";import"../chunk-JOIRNPPY.js";import"../chunk-6CS3UQTN.js";import"../chunk-P5XHIJHI.js";import"../chunk-J77SU6VA.js";import"../chunk-UCD3H3UZ.js";import"../chunk-CVYSU6BX.js";import"../chunk-ELNRLMC5.js";import"../chunk-UZGZB3VB.js";import"../chunk-ZKX2FRS6.js";import"../chunk-C7QOQX32.js";import"../chunk-TIIC3ZE7.js";import"../chunk-YUKYB54I.js";import"../chunk-OANDYLJQ.js";import"../chunk-NNOKTMZT.js";import"../chunk-SGX43S2L.js";import"../chunk-FETNQCFO.js";import"../chunk-O6QTXQPJ.js";import"../chunk-ADTBPVUZ.js";import"../chunk-BMYOV5GP.js";import"../chunk-CWONGW6P.js";import"../chunk-3LCDIREB.js";import"../chunk-NNJ2KZZG.js";export{a as referenceReachability,b as slice};
+//# sourceMappingURL=slice.js.map

package/dist/queries/source-inspection.d.ts

@@ -0,0 +1,209 @@
+import { S as ScipDatabase } from '../db-D7sauVFH.js';
+import { B as BehaviorSignal, d as BehaviorSkeleton, e as BoundaryEvidenceStrength, f as BoundaryResolutionState, S as SystemMapNextAnchorPacket } from '../next-anchor-candidates-BwMczMvX.js';
+import { EvidenceOptions, EvidenceResult } from './evidence.js';
+import { g as ExplorationCompletionStatus } from '../exploration-topology-BG4v30HZ.js';
+import { B as BindingClosure } from '../code-DlqpBDd0.js';
+export { a as BindingDefinitionEvidence } from '../code-DlqpBDd0.js';
+import { SourceSearchTextCoverage } from './source-search.js';
+import { a as SourceUnitSnippet } from '../source-snippet-_wrcgmZc.js';
+import 'better-sqlite3';
+import '../config-types-BNoC96J3.js';
+import '../symbol-types-BIQwfoAx.js';
+import './deps.js';
+import './trace.js';
+import '../repository-text-C0Q8VYdN.js';
+import './outline.js';
+import '../file-kind-BKCVMNUf.js';
+
+type SourceInspectionEvidenceChannel = 'search' | 'exact-source' | 'definition' | 'caller' | 'callee' | 'production-reference' | 'test-reference' | 'dependency' | 'consumer';
+type SourceInspectionEvidenceBudgets = Partial<Record<SourceInspectionEvidenceChannel, number>>;
+interface SourceInspectionChannelCoverage {
+    candidateUnits: number;
+    returnedUnits: number;
+    omittedUnits: number;
+    maxUnits: number;
+}
+type SourceInspectionUnitRole = 'search' | 'location' | 'definition' | 'reference' | 'caller' | 'callee' | 'dependency' | 'consumer';
+type SourceInspectionView = 'source' | 'behavior';
+
+interface SourceInspectionSlice extends SourceUnitSnippet {
+    reasons: string[];
+    focusLines: number[];
+    ownerSymbol: string | null;
+    ownerShort: string | null;
+}
+interface SourceInspectionSourceUnit extends SourceInspectionSlice {
+    kind: 'source';
+    id: string;
+    roles: SourceInspectionUnitRole[];
+    symbols: string[];
+    omittedCharacters: number;
+    behavior?: BehaviorSkeleton;
+    runtimeFacts?: SourceInspectionRuntimeFact[];
+    /** @deprecated Inspect omits whole ranked units rather than clipping source within a returned unit. */
+    exactFollowup?: string;
+}
+/** A compact, source-recoverable projection of one mechanically grounded runtime operation. */
+interface SourceInspectionRuntimeFact {
+    observationId: string;
+    protocol: string;
+    action: string;
+    role: string;
+    strength: BoundaryEvidenceStrength;
+    resolution: BoundaryResolutionState;
+    line: number;
+    endLine: number;
+    keyParts: Array<{
+        name: string;
+        value: string;
+        evidence: string;
+    }>;
+    derivation: {
+        kind: string;
+        rule: string;
+        sourceSpans: number;
+    };
+}
+interface SourceInspectionPathUnit {
+    kind: 'path';
+    id: string;
+    roles: Array<'dependency' | 'consumer'>;
+    relativePath: string;
+    relationship: string;
+    reasons: string[];
+    symbols: string[];
+    exactFollowup: string;
+}
+/** One independently useful source excerpt or unresolved file relationship in the shared packet. */
+type SourceInspectionUnit = SourceInspectionSourceUnit | SourceInspectionPathUnit;
+/** @deprecated Inspect no longer emits semantic packet continuations. */
+interface SourceInspectionContinuation {
+    cursor: string;
+    command: string;
+    indexGeneration: string;
+}
+interface SourceInspectionSearch {
+    pattern: string;
+    matchingLines: number;
+    returnedMatches: number;
+    omittedMatches: number;
+    matchingFiles?: number;
+    returnedFiles?: number;
+    omittedFiles?: number;
+    candidateUnits?: number;
+    selectedUnits?: number;
+    omittedUnits?: number;
+    scopeHints?: SourceInspectionSearchScope[];
+    omittedScopeHints?: number;
+    textCoverage?: SourceSearchTextCoverage;
+    exactFollowup?: string;
+}
+interface SourceInspectionSearchScope {
+    scope: string;
+    matchingLines: number;
+    returnedMatches: number;
+    exactFollowup: string;
+}
+interface SourceInspectionLocation {
+    target: string;
+    matched: boolean;
+}
+interface SourceInspectionPacketCoverage {
+    mode: 'bounded' | 'complete';
+    candidateUnits: number;
+    returnedUnits: number;
+    omittedUnits: number;
+    omittedByRole: Partial<Record<SourceInspectionUnitRole, number>>;
+    exactSelectorsComplete: boolean;
+    maxUnits: number;
+    maxCharacters: number;
+    channels?: Record<SourceInspectionEvidenceChannel, SourceInspectionChannelCoverage>;
+    expansionCommand?: string;
+}
+interface SourceInspectionOmissionAnchor {
+    relativePath: string;
+    line: number;
+    ownerShort: string | null;
+    roles: SourceInspectionUnitRole[];
+    behaviorSignals: BehaviorSignal[];
+}
+interface SourceInspectionOmissionGroup {
+    id: string;
+    scope: string;
+    channel?: SourceInspectionEvidenceChannel;
+    roles: SourceInspectionUnitRole[];
+    behaviorSignals: BehaviorSignal[];
+    candidateUnits: number;
+    sourceCharacters: number;
+    anchors: SourceInspectionOmissionAnchor[];
+    drillCommand: string;
+}
+type SourceInspectionStoppingStatus = 'stop-ready' | 'relevance-check-required' | 'exact-evidence-withheld';
+interface SourceInspectionStoppingSummary {
+    /** Query-scoped completion; it never claims that the user's task is finished. */
+    queryStatus?: ExplorationCompletionStatus;
+    /** @deprecated Use queryStatus. Retained for one compatibility window. */
+    status: SourceInspectionStoppingStatus;
+    openEvidence: number;
+    guidance: string;
+    drillCommands: string[];
+}
+interface SourceInspectionResult {
+    searches: SourceInspectionSearch[];
+    evidence: EvidenceResult[];
+    locations: SourceInspectionLocation[];
+    /** @deprecated Prefer units, which includes every evidence role in one deduplicated packet. */
+    slices: SourceInspectionSlice[];
+    /** @deprecated Prefer candidateUnits. */
+    candidateSlices: number;
+    /** @deprecated Prefer omittedUnits. */
+    omittedSlices: number;
+    /** @deprecated Prefer packetCoverage.maxUnits. */
+    maxSlices: number;
+    maxTotalLines: number;
+    units?: SourceInspectionUnit[];
+    candidateUnits?: number;
+    omittedUnits?: number;
+    maxUnits?: number;
+    maxCharacters?: number;
+    returnedLines?: number;
+    returnedCharacters?: number;
+    returnedViewCharacters?: number;
+    view?: SourceInspectionView;
+    omissionGroups?: SourceInspectionOmissionGroup[];
+    packetCoverage?: SourceInspectionPacketCoverage;
+    stoppingSummary?: SourceInspectionStoppingSummary;
+    /** Exact downstream call targets outside the materialized behavior constructs. */
+    causalFrontier?: SystemMapNextAnchorPacket;
+    bindingClosure?: BindingClosure;
+    /** @deprecated Inspect no longer emits semantic packet continuations. */
+    continuation?: SourceInspectionContinuation | null;
+}
+interface SourceInspectionOptions {
+    searches?: readonly string[];
+    symbols?: readonly string[];
+    locations?: readonly string[];
+    scope?: string;
+    context?: number;
+    searchLimit?: number;
+    maxUnits?: number;
+    full?: boolean;
+    view?: SourceInspectionView;
+    /** @deprecated Inspect returns complete syntax units. */
+    unitLines?: number;
+    /** @deprecated Inspect no longer applies a packet line budget. */
+    totalLines?: number;
+    /** @deprecated Inspect no longer applies a packet unit budget. */
+    sliceLimit?: number;
+    /** Displayed-evidence character ceiling; source view may surface one whole oversized unit for CLI refusal. */
+    maxCharacters?: number;
+    evidence?: EvidenceOptions;
+    /** Independent unit ceilings; omitted channel evidence remains recoverable in coverage and omission groups. */
+    evidenceBudgets?: SourceInspectionEvidenceBudgets;
+    /** @deprecated Inspect no longer accepts semantic packet cursors. */
+    cursor?: string;
+}
+/** Build one ranked, deduplicated semantic packet from several known source questions. */
+declare function inspectSource(db: ScipDatabase, opts: SourceInspectionOptions): SourceInspectionResult;
+
+export { BehaviorSignal, BehaviorSkeleton, BindingClosure, type SourceInspectionChannelCoverage, type SourceInspectionContinuation, type SourceInspectionEvidenceBudgets, type SourceInspectionEvidenceChannel, type SourceInspectionLocation, type SourceInspectionOmissionAnchor, type SourceInspectionOmissionGroup, type SourceInspectionOptions, type SourceInspectionPacketCoverage, type SourceInspectionPathUnit, type SourceInspectionResult, type SourceInspectionRuntimeFact, type SourceInspectionSearch, type SourceInspectionSearchScope, type SourceInspectionSlice, type SourceInspectionSourceUnit, type SourceInspectionStoppingStatus, type SourceInspectionStoppingSummary, type SourceInspectionUnit, type SourceInspectionUnitRole, type SourceInspectionView, inspectSource };

package/dist/queries/source-inspection.js

@@ -0,0 +1,2 @@
+import{a}from"../chunk-EZNMUY67.js";import"../chunk-CQP3THUZ.js";import"../chunk-ICFDQHAM.js";import"../chunk-ID63777H.js";import"../chunk-AKB7V7TV.js";import"../chunk-GW6Z3WGY.js";import"../chunk-MVB3DAEY.js";import"../chunk-KMITESMT.js";import"../chunk-Y6KHROC3.js";import"../chunk-PTAWHLVJ.js";import"../chunk-ST7V3SKN.js";import"../chunk-YSNONTJ2.js";import"../chunk-QHRNXP3C.js";import"../chunk-GTXSJDCO.js";import"../chunk-SMRBZ6EC.js";import"../chunk-XLQ3GLWZ.js";import"../chunk-JEJLSICM.js";import"../chunk-FQKZWM4L.js";import"../chunk-VE5AVNMP.js";import"../chunk-B75HZHUP.js";import"../chunk-7FND7D7N.js";import"../chunk-BGBBVSH4.js";import"../chunk-JOIRNPPY.js";import"../chunk-6CS3UQTN.js";import"../chunk-P5XHIJHI.js";import"../chunk-J77SU6VA.js";import"../chunk-UCD3H3UZ.js";import"../chunk-CVYSU6BX.js";import"../chunk-ELNRLMC5.js";import"../chunk-UZGZB3VB.js";import"../chunk-ZKX2FRS6.js";import"../chunk-C7QOQX32.js";import"../chunk-TIIC3ZE7.js";import"../chunk-YUKYB54I.js";import"../chunk-OANDYLJQ.js";import"../chunk-NNOKTMZT.js";import"../chunk-SGX43S2L.js";import"../chunk-FETNQCFO.js";import"../chunk-O6QTXQPJ.js";import"../chunk-ADTBPVUZ.js";import"../chunk-BMYOV5GP.js";import"../chunk-CWONGW6P.js";import"../chunk-3LCDIREB.js";import"../chunk-NNJ2KZZG.js";export{a as inspectSource};
+//# sourceMappingURL=source-inspection.js.map

package/dist/queries/source-search.d.ts

@@ -0,0 +1,85 @@
+import { S as ScipDatabase } from '../db-D7sauVFH.js';
+import { F as FileKind } from '../file-kind-BKCVMNUf.js';
+import { S as SourceObservationFreshness } from '../repository-text-C0Q8VYdN.js';
+export { a as SourceSemanticFreshnessState } from '../repository-text-C0Q8VYdN.js';
+import { S as SourceSnippet } from '../source-snippet-_wrcgmZc.js';
+import 'better-sqlite3';
+import '../config-types-BNoC96J3.js';
+
+interface SourceSearchIdentity {
+    relativePath: string;
+    focusLine: number;
+    ownerSymbol: string | null;
+    ownerShort: string | null;
+    ownerStartLine: number | null;
+    ownerEndLine: number | null;
+    fileKind: FileKind;
+    freshness?: SourceObservationFreshness;
+}
+interface SourceSearchMatch extends SourceSnippet {
+    ownerSymbol: string | null;
+    ownerShort: string | null;
+    ownerStartLine?: number | null;
+    ownerEndLine?: number | null;
+    fileKind?: FileKind;
+    freshness?: SourceObservationFreshness;
+}
+interface SourceSearchFileCoverage {
+    relativePath: string;
+    matchingLines: number;
+    returnedMatches: number;
+    freshness?: SourceObservationFreshness;
+}
+interface SourceSearchScopeHint {
+    scope: string;
+    matchingLines: number;
+    matchingFiles: number;
+}
+interface SourceSearchIdentityCoverage {
+    mode: 'complete' | 'bounded';
+    returned: number;
+    total: number;
+    omitted: number;
+}
+interface SourceSearchTextCoverage {
+    basis: 'current-project-text-files';
+    candidateFiles: number;
+    scannedTextFiles: number;
+    scannedBytes: number;
+    skippedBinaryPaths: string[];
+    skippedUnreadablePaths: string[];
+    skippedOversizedPaths: string[];
+    semanticFiles: {
+        aligned: number;
+        stale: number;
+        unavailable: number;
+    };
+}
+interface SourceSearchResult {
+    pattern: string;
+    mode: 'literal' | 'regexp';
+    identities?: SourceSearchIdentity[];
+    identityManifest?: SourceSearchIdentity[];
+    identityCoverage?: SourceSearchIdentityCoverage;
+    matches: SourceSearchMatch[];
+    matchingLines: number;
+    matchingFiles?: number;
+    omittedMatches: number;
+    fileCoverage?: SourceSearchFileCoverage[];
+    scopeHints?: SourceSearchScopeHint[];
+    omittedScopeHints?: number;
+    scannedFiles: number;
+    textCoverage?: SourceSearchTextCoverage;
+}
+interface SourceSearchOptions {
+    scope?: string;
+    context?: number;
+    limit?: number;
+    regexp?: boolean;
+    ignoreCase?: boolean;
+    ranking?: 'structural';
+}
+/** Search the source of indexed documents and retain line and symbol ownership. */
+declare function searchSource(db: ScipDatabase, pattern: string, opts?: SourceSearchOptions): SourceSearchResult;
+
+export { SourceObservationFreshness, type SourceSearchFileCoverage, type SourceSearchIdentity, type SourceSearchIdentityCoverage, type SourceSearchMatch, type SourceSearchOptions, type SourceSearchResult, type SourceSearchScopeHint, type SourceSearchTextCoverage, searchSource };

package/dist/queries/source-search.js

@@ -0,0 +1,2 @@
+import{c as a}from"../chunk-CQP3THUZ.js";import"../chunk-YSNONTJ2.js";import"../chunk-XLQ3GLWZ.js";import"../chunk-JEJLSICM.js";import"../chunk-TIIC3ZE7.js";import"../chunk-YUKYB54I.js";import"../chunk-OANDYLJQ.js";import"../chunk-FETNQCFO.js";import"../chunk-O6QTXQPJ.js";import"../chunk-ADTBPVUZ.js";import"../chunk-BMYOV5GP.js";import"../chunk-CWONGW6P.js";import"../chunk-3LCDIREB.js";import"../chunk-NNJ2KZZG.js";export{a as searchSource};
+//# sourceMappingURL=source-search.js.map

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

@@ -0,0 +1,72 @@
+import { S as ScipDatabase } from '../db-D7sauVFH.js';
+import 'better-sqlite3';
+import '../config-types-BNoC96J3.js';
+
+type StaleAbstractionActionTier = 'direct' | 'signal';
+type StalenessKind = 'unused-abstraction' | 'misplaced-single-consumer-type' | 'single-consumer-abstraction' | 'one-to-one-class-encapsulation';
+interface StaleAbstraction {
+    symbol: string;
+    shortName: string;
+    file: string;
+    startLine: number;
+    endLine: number;
+    loc: number;
+    /**
+     * Cross-file consumers NOT counting files that only re-export the symbol
+     * through a barrel (`export { X } from '...'`). Barrel files expand the
+     * public surface; they aren't real consumers.
+     */
+    consumers: number;
+    /** Number of files whose only reference is a passthrough re-export. */
+    barrelConsumers: number;
+    /** What the definition is syntactically — detected from source at the definition line. */
+    kind: 'class' | 'interface' | 'type' | 'enum' | 'other';
+    /**
+     * Does the defining file itself reference the type outside its own declaration?
+     * `false` is the strongest stale signal — the type lives in a file that never
+     * uses it (misplaced types file), while another file is its only consumer.
+     */
+    definerUsesType: boolean;
+    /**
+     * Ranked confidence in the "stale" verdict:
+     *   'high'   — consumers === 0, OR consumers === 1 && !definerUsesType && kind !== 'class'.
+     *   'medium' — consumers <= 1 with one of the signals pointing weakly stale.
+     *   'low'    — consumers === 1 but kind === 'class' (likely encapsulation, not over-abstraction).
+     */
+    confidence: 'high' | 'medium' | 'low';
+    /** Short human-readable explanation of why this was flagged. */
+    reason: string;
+    /** Direct cleanup for unused abstractions; contextual signal for one-consumer ownership questions. */
+    actionTier: StaleAbstractionActionTier;
+    /** Reviewer-facing stale shape. */
+    stalenessKind: StalenessKind;
+    recommendation: string;
+}
+/**
+ * Find stale abstractions: type-level symbols (classes, interfaces, type
+ * aliases) that have 0 or 1 *real* cross-file consumers.
+ *
+ * "Real" means: after excluding barrel files whose only reference is a
+ * passthrough re-export (`export { X } from '...'`). A type re-exported
+ * through the public API surface isn't stale — consumers just reach it
+ * through the barrel.
+ *
+ * Findings are ranked by confidence:
+ *   - high:   0 consumers (truly unused type), OR 1 consumer where the
+ *             defining file never uses the type itself (misplaced type).
+ *   - medium: 1 consumer, definer uses it, kind is interface/type/enum —
+ *             single-use abstraction worth questioning.
+ *   - low:    1 consumer but kind === 'class' — usually encapsulation
+ *             (big class owned by its single consumer), not over-abstraction.
+ */
+declare function staleAbstractions(db: ScipDatabase, opts?: {
+    scope?: string;
+    minLoc?: number;
+    maxLoc?: number;
+    limit?: number;
+    includeLowConfidence?: boolean;
+    scanLimit?: number;
+    semantic?: boolean;
+}): StaleAbstraction[];
+
+export { type StaleAbstraction, type StaleAbstractionActionTier, type StalenessKind, staleAbstractions };

package/dist/queries/stale-abstractions.js

@@ -0,0 +1,2 @@
+import{a}from"../chunk-I2T2LLK2.js";import"../chunk-SELM5MER.js";import"../chunk-DGXRDLV5.js";import"../chunk-B75HZHUP.js";import"../chunk-7FND7D7N.js";import"../chunk-BGBBVSH4.js";import"../chunk-JOIRNPPY.js";import"../chunk-6CS3UQTN.js";import"../chunk-P5XHIJHI.js";import"../chunk-J77SU6VA.js";import"../chunk-UCD3H3UZ.js";import"../chunk-CVYSU6BX.js";import"../chunk-ELNRLMC5.js";import"../chunk-UZGZB3VB.js";import"../chunk-ZKX2FRS6.js";import"../chunk-C7QOQX32.js";import"../chunk-TIIC3ZE7.js";import"../chunk-YUKYB54I.js";import"../chunk-OANDYLJQ.js";import"../chunk-NNOKTMZT.js";import"../chunk-SGX43S2L.js";import"../chunk-FETNQCFO.js";import"../chunk-O6QTXQPJ.js";import"../chunk-ADTBPVUZ.js";import"../chunk-BMYOV5GP.js";import"../chunk-CWONGW6P.js";import"../chunk-3LCDIREB.js";import"../chunk-NNJ2KZZG.js";export{a as staleAbstractions};
+//# sourceMappingURL=stale-abstractions.js.map

package/dist/queries/stats.d.ts

@@ -0,0 +1,15 @@
+import { S as ScipDatabase } from '../db-D7sauVFH.js';
+import 'better-sqlite3';
+import '../config-types-BNoC96J3.js';
+
+interface StatsResult {
+    documents: number;
+    symbols: number;
+    definitions: number;
+    references: number;
+    indexSizeBytes: number;
+    lastBuilt: Date | null;
+}
+declare function stats(db: ScipDatabase): StatsResult;
+
+export { type StatsResult, stats };

package/dist/queries/stats.js

@@ -0,0 +1,2 @@
+import{a}from"../chunk-6YTSKJJ3.js";export{a as stats};
+//# sourceMappingURL=stats.js.map

package/dist/queries/surface.d.ts

@@ -0,0 +1,22 @@
+import { S as ScipDatabase } from '../db-D7sauVFH.js';
+import 'better-sqlite3';
+import '../config-types-BNoC96J3.js';
+
+interface SurfaceResult {
+    consumer: string;
+    symbol: string;
+    shortName: string;
+}
+interface ConsumerSurfaceResult extends SurfaceResult {
+    basis: 'external-reference';
+}
+/**
+ * @deprecated Historical union of externally referenced symbols and every
+ * indexed callable definition in the selected module. Use `consumerSurface`
+ * when the claim is specifically about observed external use.
+ */
+declare function surface(db: ScipDatabase, modulePattern: string): SurfaceResult[];
+/** Callable or value symbols in a module that have an observed reference from outside it. */
+declare function consumerSurface(db: ScipDatabase, modulePattern: string): ConsumerSurfaceResult[];
+
+export { type ConsumerSurfaceResult, type SurfaceResult, consumerSurface, surface };

package/dist/queries/surface.js

@@ -0,0 +1,2 @@
+import{a,b}from"../chunk-N3IQCBCF.js";import"../chunk-GTXSJDCO.js";import"../chunk-7FND7D7N.js";import"../chunk-BGBBVSH4.js";import"../chunk-JOIRNPPY.js";import"../chunk-6CS3UQTN.js";import"../chunk-P5XHIJHI.js";import"../chunk-J77SU6VA.js";import"../chunk-UCD3H3UZ.js";import"../chunk-CVYSU6BX.js";import"../chunk-ELNRLMC5.js";import"../chunk-UZGZB3VB.js";import"../chunk-ZKX2FRS6.js";import"../chunk-C7QOQX32.js";import"../chunk-TIIC3ZE7.js";import"../chunk-YUKYB54I.js";import"../chunk-OANDYLJQ.js";import"../chunk-NNOKTMZT.js";import"../chunk-SGX43S2L.js";import"../chunk-FETNQCFO.js";import"../chunk-O6QTXQPJ.js";import"../chunk-ADTBPVUZ.js";import"../chunk-BMYOV5GP.js";import"../chunk-CWONGW6P.js";import"../chunk-3LCDIREB.js";import"../chunk-NNJ2KZZG.js";export{b as consumerSurface,a as surface};
+//# sourceMappingURL=surface.js.map

package/dist/queries/symbols.d.ts

@@ -0,0 +1,14 @@
+import { S as ScipDatabase } from '../db-D7sauVFH.js';
+import 'better-sqlite3';
+import '../config-types-BNoC96J3.js';
+
+interface SymbolResult {
+    startLine: number;
+    endLine: number;
+    symbol: string;
+    shortName: string;
+    signature: string | null;
+}
+declare function symbols(db: ScipDatabase, filePattern: string): SymbolResult[];
+
+export { type SymbolResult, symbols };

package/dist/queries/symbols.js

@@ -0,0 +1,2 @@
+import{a}from"../chunk-OGTFJ3XD.js";import"../chunk-GTXSJDCO.js";import"../chunk-UZGZB3VB.js";import"../chunk-FETNQCFO.js";import"../chunk-O6QTXQPJ.js";import"../chunk-ADTBPVUZ.js";import"../chunk-BMYOV5GP.js";import"../chunk-CWONGW6P.js";import"../chunk-3LCDIREB.js";import"../chunk-NNJ2KZZG.js";export{a as symbols};
+//# sourceMappingURL=symbols.js.map