scip-query 0.20.0 → 0.21.0

package/dist/graph-evidence-CbUPCSKV.d.ts

@@ -0,0 +1,126 @@
+import { S as ScipDatabase } from './db-LKJXAlNS.js';
+import { G as GraphEvidenceFamily, a as GraphProjectionDirection } from './graph-exploration-contract-CqDsnPQL.js';
+import { P as ProgramEdgeSemantic, E as ExplorationSourceLocation, a as ExplorationEvidenceStrength } from './exploration-topology-BG4v30HZ.js';
+
+declare const GRAPH_EVIDENCE_VIEWS: readonly ["causal", "structure", "complete"];
+type GraphEvidenceView = (typeof GRAPH_EVIDENCE_VIEWS)[number];
+interface GraphEvidenceSelectors {
+    symbols?: readonly string[];
+    locations?: readonly string[];
+    searches?: readonly string[];
+}
+interface GraphEvidenceOptions {
+    view?: GraphEvidenceView;
+    families?: readonly GraphEvidenceFamily[];
+    direction?: GraphProjectionDirection;
+    subtypes?: readonly string[];
+    connecting?: boolean;
+    inventoryOnly?: boolean;
+    /** Materialize the exact membership of recoverable folds from the same projection. */
+    foldIds?: readonly string[];
+    maxDepth?: number;
+    maxEdges?: number;
+}
+interface GraphEvidenceSelection {
+    direction: GraphProjectionDirection;
+    subtypes: string[];
+    connecting: boolean;
+    inventoryOnly: boolean;
+    foldIds: string[];
+}
+interface GraphEvidenceInventoryRow {
+    family: GraphEvidenceFamily;
+    subtype: string;
+    incoming: number;
+    outgoing: number;
+    both: number;
+}
+interface GraphEvidenceFold {
+    id: string;
+    mode: 'linear' | 'scc' | 'topology';
+    family: GraphEvidenceFamily;
+    /** One subtype name, or `mixed` when this structural fold contains several. */
+    subtype: string;
+    /** Complete subtype inventory for the folded relationships. */
+    subtypes?: string[];
+    /** Query-neutral structural region shared by the folded relationships. */
+    region?: string;
+    edgeCount: number;
+    edgeIds: string[];
+    nodeIds: string[];
+    minimumMaxEdges: number;
+}
+interface GraphEvidenceTarget {
+    kind: string;
+    query: string;
+    status: 'matched' | 'ambiguous' | 'missing';
+    nodeIds: string[];
+    omittedCandidates: number;
+}
+interface GraphEvidenceNode {
+    id: string;
+    kind: string;
+    label: string;
+    symbol: string | null;
+    location: ExplorationSourceLocation | null;
+}
+interface GraphEvidenceEdge {
+    id: string;
+    family: GraphEvidenceFamily;
+    /** Original typed-program semantic family before presentation grouping. */
+    semanticFamily: ProgramEdgeSemantic['family'];
+    subtype: string;
+    from: GraphEvidenceNode;
+    to: GraphEvidenceNode;
+    sourceKind: string;
+    providerId: string;
+    supportCeiling: 'exact' | 'partial' | 'candidate';
+    establishes: string;
+    nonClaims: readonly string[];
+    recoverWith: readonly string[];
+    evidenceStrength: ExplorationEvidenceStrength;
+    evidenceMethods: string[];
+    evidenceConstituents?: Array<{
+        method: string;
+        strength: ExplorationEvidenceStrength;
+    }>;
+    context: ProgramEdgeSemantic['context'] | null;
+    attributes: ProgramEdgeSemantic['attributes'] | null;
+}
+interface GraphEvidenceCoverage {
+    status: 'accounted' | 'bounded' | 'incomplete';
+    topologyStatus: 'accounted' | 'incomplete';
+    scope: string;
+    maxDepth: number;
+    maxEdges: number;
+    /** Present for projection-aware callers; omitted by results produced before projection metadata existed. */
+    matchedEdges?: number;
+    eligibleEdges: number;
+    returnedEdges: number;
+    omittedEdges: number;
+    frontierGroups: number;
+    unsupportedFrontiers: number;
+    blindSpots: string[];
+    explanation: string;
+}
+interface GraphEvidenceResult {
+    kind: 'graph';
+    view: GraphEvidenceView | 'custom';
+    families: GraphEvidenceFamily[];
+    /** Explicit projection applied by the current implementation. */
+    selection?: GraphEvidenceSelection;
+    targets: GraphEvidenceTarget[];
+    /** Complete relationship counts before materialization budgeting. */
+    inventory?: GraphEvidenceInventoryRow[];
+    edges: GraphEvidenceEdge[];
+    /** Recoverable membership for relationships withheld by the materialization budget. */
+    folds?: GraphEvidenceFold[];
+    coverage: GraphEvidenceCoverage;
+}
+/**
+ * Compose the existing system-map topology into one small, agent-selected
+ * relationship packet. This function performs no task-relevance inference.
+ */
+declare function graphEvidence(db: ScipDatabase, selectors: GraphEvidenceSelectors, options?: GraphEvidenceOptions): GraphEvidenceResult;
+
+export { type GraphEvidenceCoverage as G, type GraphEvidenceEdge as a, type GraphEvidenceTarget as b, GRAPH_EVIDENCE_VIEWS as c, type GraphEvidenceFold as d, type GraphEvidenceInventoryRow as e, type GraphEvidenceNode as f, type GraphEvidenceOptions as g, type GraphEvidenceResult as h, type GraphEvidenceSelection as i, type GraphEvidenceSelectors as j, type GraphEvidenceView as k, graphEvidence as l };

package/dist/graph-exploration-contract-CqDsnPQL.d.ts

@@ -0,0 +1,7 @@
+/** Agent-facing graph families. Provider-specific detail belongs in edge subtypes. */
+declare const GRAPH_EVIDENCE_FAMILIES: readonly ["execution", "runtime", "dataflow", "state", "temporal", "contract", "identity", "ownership", "dependencies"];
+type GraphEvidenceFamily = (typeof GRAPH_EVIDENCE_FAMILIES)[number];
+declare const GRAPH_PROJECTION_DIRECTIONS: readonly ["incoming", "outgoing", "both"];
+type GraphProjectionDirection = (typeof GRAPH_PROJECTION_DIRECTIONS)[number];
+
+export { type GraphEvidenceFamily as G, type GraphProjectionDirection as a, GRAPH_EVIDENCE_FAMILIES as b };

package/dist/{health-Do5TKSJI.d.ts → health-Wl5G_LRt.d.ts}

@@ -1,5 +1,33 @@
-import { S as ScipDatabase } from './db-B5PM5yNk.js';
+import { S as ScipDatabase } from './db-LKJXAlNS.js';
 import { stats } from './queries/stats.js';
+import { G as GraphEvidenceFamily } from './graph-exploration-contract-CqDsnPQL.js';
+
+type GraphRelationEvidenceStrength = 'exact' | 'derived' | 'candidate' | 'mixed' | 'unknown';
+type GraphRelationSupportCeiling = 'exact' | 'partial' | 'candidate';
+type GraphRelationProviderRequirement = 'indexed-graph' | 'source-facts' | 'typescript-semantic';
+
+type DetectorEvidenceCalibration = 'exact' | 'derived' | 'candidate' | 'mixed' | 'unsupported';
+interface DetectorRelationRequirement {
+    family: GraphEvidenceFamily;
+    subtype: string;
+    minimumStrength: GraphRelationEvidenceStrength;
+}
+interface DetectorEvidenceContract {
+    id: string;
+    detector: string;
+    claim: string;
+    relationRequirements: readonly DetectorRelationRequirement[];
+    structuralEvidence: readonly string[];
+    calibration: Exclude<DetectorEvidenceCalibration, 'unsupported'>;
+    providerCoverage: GraphRelationSupportCeiling;
+    nonClaims: readonly string[];
+    recoverWith: string;
+}
+interface DetectorEvidenceAssessment extends DetectorEvidenceContract {
+    status: DetectorEvidenceCalibration;
+    providerIds: string[];
+    unavailableRequirements: GraphRelationProviderRequirement[];
+}
 
 /**
  * Structural copy of analysis/git-history's ChangeAmplification — defined
@@ -79,32 +107,6 @@ interface SuppressionSummary {
     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;
@@ -115,6 +117,8 @@ interface HealthAction {
     locRecoverable: number;
     /** What kind of evidence backs this action — agents should trust accordingly. */
     evidence: FindingEvidence;
+    /** Descriptor id in detectorEvidence; absent for analyses without a typed detector contract. */
+    evidenceContractId?: string;
 }
 /** One deduction line — the score is the sum of these, so it is auditable. */
 interface ScoreDeduction {
@@ -245,14 +249,9 @@ interface HealthReport {
         score: number;
         file?: string;
     }>;
+    /** Calibrated claim limits and recovery paths for detector evidence. */
+    detectorEvidence: DetectorEvidenceAssessment[];
     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", "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"];

package/dist/hierarchy-D553WRSZ.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-2ZBMOQGG.js";import"./chunk-VGRUM7JI.js";import"./chunk-SDPA5DKN.js";import"./chunk-DOPCR5BY.js";import"./chunk-VWLIOEEF.js";import"./chunk-DRENNWRG.js";import"./chunk-H5EXS3HM.js";import"./chunk-HGFDYOVB.js";import"./chunk-4DCKBY6T.js";export{a as hierarchy,b as ownershipChain};
+//# sourceMappingURL=hierarchy-D553WRSZ.js.map

package/dist/imports-DOZAJWLW.js

@@ -0,0 +1,2 @@
+import{a,b,c}from"./chunk-XXJ7WL3F.js";import"./chunk-SKUMCCC5.js";import"./chunk-35ELD3RM.js";import"./chunk-GTDP2SKQ.js";import"./chunk-4N6QSEMZ.js";import"./chunk-OIRWZIYL.js";import"./chunk-VGRUM7JI.js";import"./chunk-CT5SI2I4.js";import"./chunk-54EOGFBR.js";import"./chunk-F4FNK44D.js";import"./chunk-T6FRID7Y.js";import"./chunk-UZFCZ7SJ.js";import"./chunk-Q7HB7BFJ.js";import"./chunk-SEUJVWT2.js";import"./chunk-SF7X6QNW.js";import"./chunk-SDPA5DKN.js";import"./chunk-DOPCR5BY.js";import"./chunk-VWLIOEEF.js";import"./chunk-G6OGPXJW.js";import"./chunk-DRENNWRG.js";import"./chunk-H5EXS3HM.js";import"./chunk-HGFDYOVB.js";import"./chunk-3VLJ2DCA.js";import"./chunk-4DCKBY6T.js";export{b as importedBy,a as imports,c as unusedImports};
+//# sourceMappingURL=imports-DOZAJWLW.js.map

package/dist/index.d.ts

@@ -1,37 +1,10 @@
-import { S as ScipDatabase } from './db-B5PM5yNk.js';
+import { S as ScipDatabase } from './db-LKJXAlNS.js';
 import { I as IndexedDefinition, S as SymbolMatch, a as ScipSymbol, b as ScipLocalSymbol } from './symbol-types-BIQwfoAx.js';
-export { S as ScipQueryConfig } from './config-types-jVM3D7MA.js';
+import { c as classifyFile } from './file-kind-BKCVMNUf.js';
+import { C as CalleeRow } from './call-graph-evidence-lZa2dwQA.js';
+export { S as ScipQueryConfig } from './config-types-Cm-VSEBb.js';
 import 'better-sqlite3';
 
-/**
- * File classifier — one place to decide what role a source file plays.
- *
- * Multiple queries (dead, health, cycles, drift) all need to ask
- * questions like "is this a test file?", "is this an entry point?",
- * "is this a barrel?" Pre-this-module each query had its own answer
- * with subtle divergences. classifyFile gives every query one
- * consistent verdict.
- *
- * `FileKind` is closed — when a future contributor adds a kind they
- * edit the type, and the compiler forces every consumer's switch to
- * handle it.
- */
-
-type FileKind = 'entry' | 'barrel' | 'worker' | 'test' | 'source';
-/**
- * Classify a file by role. Pure pattern matching — doesn't need a DB.
- * For "is this barrel reachable?" use `isLiveBarrel(db, file)` instead.
- */
-declare function classifyFile(file: string): FileKind;
-
-type CalleeEvidenceSource = 'ast-callsite' | 'semantic-callee' | 'scip-chunk';
-interface CalleeRow {
-    symbol: string;
-    file: string;
-    chunkId: number;
-    source: CalleeEvidenceSource;
-}
-
 declare function sourceFallbackCallerEvidenceMap(db: ScipDatabase, definitions: ReadonlyArray<IndexedDefinition>, opts?: {
     skipPath?: (relativePath: string) => boolean;
 }): Map<number, Set<string>>;

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as e}from"./chunk-A73XVBCR.js";import{a as m}from"./chunk-7PIO7NKH.js";import{c as p}from"./chunk-UJCOIXDY.js";import"./chunk-26QA6FAI.js";import"./chunk-AQOFWNQJ.js";import"./chunk-DHEQMPLW.js";import"./chunk-BGBBVSH4.js";import"./chunk-Z4N3MZYA.js";import"./chunk-7O5IKBTZ.js";import"./chunk-HX7M4BDI.js";import"./chunk-P5XHIJHI.js";import"./chunk-T7YQSHPQ.js";import"./chunk-7WPLAODU.js";import"./chunk-BS2NMXQZ.js";import"./chunk-C43RDDP4.js";import"./chunk-MTDBHTSF.js";import{b as o,d as r,e as t}from"./chunk-EKZTZXHZ.js";import"./chunk-UJPRPGCO.js";import"./chunk-GH74ASD6.js";import"./chunk-WCCFZ7V7.js";import"./chunk-NGEXCJJW.js";import"./chunk-7S5E7KWT.js";import"./chunk-2KAZEZ6M.js";import"./chunk-C3KV2II6.js";export{p as ProjectIndex,e as ScipDatabase,m as createGitignoreFilter,t as leafName,o as parseSymbol,r as shortenSymbol};
+import{a as e}from"./chunk-IGKKTHJR.js";import{a as m}from"./chunk-2COFMIVK.js";import{c as p}from"./chunk-JVZNWJBH.js";import"./chunk-BGBBVSH4.js";import"./chunk-6BJ7SOY7.js";import"./chunk-63MBA7EG.js";import"./chunk-P5XHIJHI.js";import"./chunk-ICUQONOG.js";import"./chunk-ZDVDSDFG.js";import"./chunk-RGCJ4646.js";import"./chunk-ELNRLMC5.js";import"./chunk-LPGDO2XA.js";import"./chunk-MYUKI5VN.js";import"./chunk-HEOMG7IM.js";import"./chunk-35IW3P4H.js";import"./chunk-YUKYB54I.js";import"./chunk-DHEQMPLW.js";import"./chunk-7COHFNJK.js";import"./chunk-MTDBHTSF.js";import{b as o,d as r,e as t}from"./chunk-5IZTXSOL.js";import"./chunk-I3U2FN2T.js";import"./chunk-AA7K3XLM.js";import"./chunk-DMQ7ZKJG.js";import"./chunk-7HU2IJ2T.js";import"./chunk-MO226P4Q.js";export{p as ProjectIndex,e as ScipDatabase,m as createGitignoreFilter,t as leafName,o as parseSymbol,r as shortenSymbol};
 //# sourceMappingURL=index.js.map

package/dist/members-HE67475K.js

@@ -0,0 +1,2 @@
+import{a}from"./chunk-SSSJO4RG.js";import"./chunk-ZBNL3QCY.js";import"./chunk-BGBBVSH4.js";import"./chunk-WULAPQUD.js";import"./chunk-MTDBHTSF.js";import"./chunk-FTSQNONX.js";import"./chunk-35ELD3RM.js";import"./chunk-GTDP2SKQ.js";import"./chunk-OUB4J26T.js";import"./chunk-2I3RSUWX.js";import"./chunk-4N6QSEMZ.js";import"./chunk-OIRWZIYL.js";import"./chunk-VGRUM7JI.js";import"./chunk-YUKYB54I.js";import"./chunk-GFLTPNWV.js";import"./chunk-CT5SI2I4.js";import"./chunk-54EOGFBR.js";import"./chunk-F4FNK44D.js";import"./chunk-T6FRID7Y.js";import"./chunk-UZFCZ7SJ.js";import"./chunk-Q7HB7BFJ.js";import"./chunk-DHEQMPLW.js";import"./chunk-SEUJVWT2.js";import"./chunk-SF7X6QNW.js";import"./chunk-SDPA5DKN.js";import"./chunk-DOPCR5BY.js";import"./chunk-VWLIOEEF.js";import"./chunk-G6OGPXJW.js";import"./chunk-DRENNWRG.js";import"./chunk-H5EXS3HM.js";import"./chunk-HGFDYOVB.js";import"./chunk-3VLJ2DCA.js";import"./chunk-4DCKBY6T.js";export{a as members};
+//# sourceMappingURL=members-HE67475K.js.map

package/dist/methods-K5JK4PPH.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-OFY4HTMI.js";import"./chunk-ZBNL3QCY.js";import"./chunk-BGBBVSH4.js";import"./chunk-WULAPQUD.js";import"./chunk-MTDBHTSF.js";import"./chunk-FTSQNONX.js";import"./chunk-35ELD3RM.js";import"./chunk-GTDP2SKQ.js";import"./chunk-OUB4J26T.js";import"./chunk-2I3RSUWX.js";import"./chunk-4N6QSEMZ.js";import"./chunk-OIRWZIYL.js";import"./chunk-VGRUM7JI.js";import"./chunk-YUKYB54I.js";import"./chunk-GFLTPNWV.js";import"./chunk-CT5SI2I4.js";import"./chunk-54EOGFBR.js";import"./chunk-F4FNK44D.js";import"./chunk-T6FRID7Y.js";import"./chunk-UZFCZ7SJ.js";import"./chunk-Q7HB7BFJ.js";import"./chunk-DHEQMPLW.js";import"./chunk-SEUJVWT2.js";import"./chunk-SF7X6QNW.js";import"./chunk-SDPA5DKN.js";import"./chunk-DOPCR5BY.js";import"./chunk-VWLIOEEF.js";import"./chunk-G6OGPXJW.js";import"./chunk-DRENNWRG.js";import"./chunk-H5EXS3HM.js";import"./chunk-HGFDYOVB.js";import"./chunk-3VLJ2DCA.js";import"./chunk-4DCKBY6T.js";export{b as methods,a as resolveMethods};
+//# sourceMappingURL=methods-K5JK4PPH.js.map

package/dist/next-anchor-candidates-BwMczMvX.d.ts

@@ -0,0 +1,90 @@
+import { a as ExplorationEvidenceStrength, c as ExplorationEvidenceSource } from './exploration-topology-BG4v30HZ.js';
+
+/** Compatibility projection used by current renderers while evidence axes remain independent. */
+type BoundaryEvidenceStrength = 'exact' | 'derived' | 'candidate';
+type BoundaryResolutionState = 'locally-linked' | 'external' | 'unresolved' | 'ambiguous';
+type BoundarySourceScope = 'production' | 'test' | 'fixture' | 'example' | 'generated' | 'script' | 'unknown';
+
+type BehaviorSignal = 'anchor' | 'signature' | 'binding' | 'branch' | 'loop' | 'call' | 'await' | 'return' | 'throw' | 'mutation' | 'shape' | 'spread' | 'catch' | 'finally';
+interface BehaviorSkeletonLine {
+    line: number;
+    endLine: number;
+    depth: number;
+    signals: BehaviorSignal[];
+    text: string;
+    copied: boolean;
+}
+interface BehaviorSkeleton {
+    callable?: {
+        name: string;
+        startLine: number;
+        endLine: number;
+    };
+    representation: 'outline';
+    constructKind: string;
+    signature: string;
+    lines: BehaviorSkeletonLine[];
+    signals: BehaviorSignal[];
+    testCases: string[];
+    coverage: {
+        sourceStatements: number;
+        representedStatements: number;
+        copiedStatements: number;
+        omittedStatements: 0;
+    };
+    rawCharacters: number;
+    outlineCharacters: number;
+    /** @deprecated Prefer coverage.sourceStatements. */
+    candidateLines: number;
+    /** @deprecated Behavioral outlines never silently omit statements. */
+    omittedLines: number;
+}
+
+interface SystemMapNextAnchorAlternative {
+    symbol: string | null;
+    label: string;
+    file: string;
+    line: number;
+    endLine: number | null;
+}
+interface SystemMapNextAnchor {
+    id: string;
+    status: ExplorationEvidenceStrength | 'ambiguous';
+    source: 'graph-call' | 'graph-relation' | 'leaf-identity-candidate';
+    /** Optional on legacy call candidates; populated for newly rendered causal targets. */
+    direction?: 'upstream' | 'downstream' | 'connector';
+    causalRole?: 'caller' | 'callee' | 'result-callback' | 'callable-reference' | 'runtime-producer' | 'runtime-consumer';
+    relationKind?: string;
+    fromStepId: string;
+    fromLabel: string;
+    callsite: {
+        file: string;
+        line: number;
+        endLine: number;
+        text: string;
+        signals: BehaviorSignal[];
+        calleeLeaf: string;
+    };
+    alternatives: SystemMapNextAnchorAlternative[];
+    alternativeCount: number;
+    evidence: ExplorationEvidenceSource[];
+}
+interface SystemMapNextAnchorPacket {
+    anchors: SystemMapNextAnchor[];
+    withheldAnchors: SystemMapNextAnchor[];
+    candidateAnchors: number;
+    omittedAnchors: number;
+    scannedBehaviorSteps: number;
+    visibleCallsites: number;
+    graphEvidencedCallsites: number;
+    identityCandidateCallsites: number;
+    ambiguousCallsites: number;
+    unresolvedCallsites: number;
+    upstreamCandidates?: number;
+    resultCandidates?: number;
+    runtimeCandidates?: number;
+    inspectCommand: string | null;
+    remainingInspectCommands: string[];
+}
+
+export type { BehaviorSignal as B, SystemMapNextAnchorPacket as S, BoundarySourceScope as a, SystemMapNextAnchor as b, SystemMapNextAnchorAlternative as c, BehaviorSkeleton as d, BoundaryEvidenceStrength as e, BoundaryResolutionState as f };

package/dist/output-continuation-command-LKBUTNRL.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{a}from"./chunk-PNISDVYC.js";import"./chunk-OVPS2ILI.js";import"./chunk-4UUCUASK.js";import"./chunk-OIVZ7PW6.js";export{a as outputContinuationCommandDescriptor};
+//# sourceMappingURL=output-continuation-command-LKBUTNRL.js.map

package/dist/output-pagination-VAWOGX4R.js

@@ -0,0 +1,19 @@
+import{A as fe,D as _,E as k,F as H,a as R,b as x,c as D,d as $,e as de,o as U,p as T,r as pe,t as b,w as he,x as ge,y as J,z as le}from"./chunk-Y4XQ7LES.js";import{createHash as A,randomBytes as Ce}from"crypto";import{chmodSync as it,closeSync as L,fstatSync as ve,lstatSync as ot,mkdirSync as xe,openSync as Y,readSync as at,readdirSync as Te,renameSync as _e,rmSync as Q,statSync as ut,writeSync as Ae}from"fs";import{tmpdir as ct}from"os";import{dirname as dt,join as N,resolve as pt}from"path";import{StringDecoder as Z}from"string_decoder";import{InvalidArgumentError as we}from"commander";var Ye=/^[A-Za-z0-9_@%+=:,./-]+$/u;function me(e,t={}){return t.omitSafeQuotes&&Ye.test(e)?e:(t.platform??process.platform)==="win32"?`"${e.replaceAll("%","%%").replaceAll('"','\\"')}"`:`'${e.replaceAll("'",`'"'"'`)}'`}import{AsyncLocalStorage as Qe}from"async_hooks";import{createHash as rn}from"crypto";import{existsSync as on,mkdirSync as an}from"fs";import{tmpdir as cn}from"os";import{isAbsolute as pn,join as hn,resolve as Ze}from"path";var Ke="SCIP_QUERY_SESSION";var et=128,ye=new Qe;function Se(e,t){let n=e.sessionEnabled===!1||e.json?void 0:st(),r={enabled:n!==void 0,reemit:e.reemit===!0,command:e.command,projectRoot:Ze(e.cwd),sessionIdentity:n,staged:[],stagedEvidence:[],finalized:!1};return ye.run(r,t)}function B(e){let t=ye.getStore();if(!t||t.finalized)return;t.finalized=!0;let n=t.state;if(!n){t.staged.length=0,t.stagedEvidence.length=0;return}try{if(e&&(t.staged.length>0||t.stagedEvidence.length>0)){let r=n.ledger.nextOrdinal,s=tt(t.staged).map(i=>({...i,ordinal:r,command:t.command})),o=rt(t.stagedEvidence).map(i=>({...i,ordinal:r,command:t.command}));n.ledger.ranges.push(...s),n.ledger.evidence.push(...o),n.ledger.nextOrdinal+=1,n.ledger.updatedAt=new Date().toISOString(),_(n.ledgerPath,n.ledger,{spacing:2,trailingNewline:!0})}}catch{}finally{n.lock.release(),t.state=null,t.staged.length=0,t.stagedEvidence.length=0}}function tt(e){let t=[...e].sort((r,s)=>r.relativePath.localeCompare(s.relativePath)||r.startLine-s.startLine||r.endLine-s.endLine),n=[];for(let r of t){let s=n[n.length-1];if(s&&s.relativePath===r.relativePath&&s.ownerSymbol===r.ownerSymbol&&s.policy===r.policy&&r.startLine<=s.endLine+1&&nt(s,r)){let o=r.startLine-s.startLine;for(let i=0;i<r.lineHashes.length;i+=1)s.lineHashes[o+i]??=r.lineHashes[i];s.endLine=Math.max(s.endLine,r.endLine)}else n.push({...r,lineHashes:[...r.lineHashes]})}return n}function nt(e,t){let n=Math.max(e.startLine,t.startLine),r=Math.min(e.endLine,t.endLine);for(let s=n;s<=r;s+=1)if(e.lineHashes[s-e.startLine]!==t.lineHashes[s-t.startLine])return!1;return!0}function rt(e){let t=new Set,n=[];for(let r of e){let s=`${r.kind}\0${r.identity}\0${r.contentHash}`;t.has(s)||(t.add(s),n.push(r))}return n}function st(){let e=process.env[Ke]?.trim();if(e&&!(e.length>et||!/^[A-Za-z0-9._:-]+$/.test(e)))return`explicit:${e}`}var K="scip-query-output-page",ee=1,ht="continue",w=256,C=1e5,j=4096,m=32e6,Le=64*1024*1024,gt=256*1024*1024,lt=32,Ne=32768,Re=16,ft=$*Re,M=4096,Oe=Le,te=3600*1e3,mt="scip-query-json-export",yt=1,$e=3;function ne(){return N(ct(),`scip-query-output-pages-${typeof process.getuid=="function"?process.getuid():"user"}`)}var re=/^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/u,Ue=/^[A-Za-z0-9_][A-Za-z0-9_-]{11}$/u,St=/^4\.([A-Za-z0-9_-]{22})\.([0-9a-z]{1,10})$/u,vt=/^([A-Za-z0-9_][A-Za-z0-9_-]{11})(?:\.([0-9a-z]{1,10}))?$/u,ke=1,wt="quota.lock",Ot=2e3,bt=5,be=1024*1024,It=new Int32Array(new SharedArrayBuffer(Int32Array.BYTES_PER_ELEMENT)),F,Et=Object.freeze({maxSnapshotBytes:Le,maxAggregateBytes:gt,maxSnapshotCount:lt});function Pt(e){if(!T(e))return{kind:"malformed",reason:"Output page envelope must be an object."};if(e.kind!==K||e.schemaVersion!==ee)return{kind:"malformed",reason:"Output page envelope kind or schema version is unsupported."};if(!T(e.producer)||e.producer.name!=="scip-query"||typeof e.producer.version!="string"||e.producer.version.length===0||typeof e.command!="string"||e.command.length===0||e.contentType!=="text/plain"&&e.contentType!=="application/json"||e.agentInstruction!==void 0&&typeof e.agentInstruction!="string"||typeof e.content!="string"||!T(e.page))return{kind:"malformed",reason:"Output page envelope contains invalid common fields."};let t=e.page;if(["offset","returnedCharacters","totalCharacters","omittedCharacters","remainingCharacters"].some(c=>!pe(t[c]))||!b(t.outputHash))return{kind:"malformed",reason:"Output page counts or output hash are invalid."};let r=Number(t.offset),s=Number(t.returnedCharacters),o=Number(t.totalCharacters),i=Number(t.omittedCharacters),a=Number(t.remainingCharacters);if(s!==e.content.length||i!==o-s||a!==o-r-s||a<0)return{kind:"malformed",reason:"Output page character counts are inconsistent."};if(t.complete===!0){if(t.remainingCharacters!==0||t.continuation!==void 0)return{kind:"malformed",reason:"A complete output page cannot have remaining content or a continuation."}}else if(t.complete===!1){let c=t.continuation;if(t.remainingCharacters===0||!T(c)||typeof c.cursor!="string"||c.cursor.length===0||typeof c.command!="string"||c.command.length===0)return{kind:"malformed",reason:"An incomplete output page requires a non-empty continuation."}}else return{kind:"malformed",reason:"Output page complete must be a Boolean."};return{kind:"supported",envelope:e}}function Ln(e){let t=Pt(e);if(t.kind==="malformed")throw new Error(t.reason);return t.envelope}var He={writeStdout:e=>{process.stdout.write(e)},writeStderr:e=>{process.stderr.write(e)}};async function Ct(e,t,n=He){return Se({command:e.command,cwd:e.cwd,argv:e.argv,json:e.json,sessionEnabled:e.sourceSession,reemit:e.reemitSource},async()=>{try{await xt(e,t,n)}finally{B(!1)}})}async function xt(e,t,n){let r=e.pageSize??R,s=e.snapshotRoot??ne(),o=kt(e.snapshotLimits),i=e.maxOutputCharacters??m;if(!Number.isSafeInteger(i)||i<=0)throw new Error("Output character safety limit must be a positive integer.");let a=Math.min(i,m,e.agentOutput?ft:m);if(Be(r),e.cursor!==void 0&&e.cursor.length>j)throw new Error(`Output cursor exceeds the ${j}-character limit. Run the command again without --output-cursor.`);if(e.jsonOutputPath!==void 0){if(!e.json)throw new Error("--json-output requires --json.");if(e.agentOutput||e.pageSize!==void 0||e.cursor!==void 0)throw new Error("--json-output cannot be combined with --agent-output or output pagination.");e.command==="system-map"&&H(e.cwd,e.sourceSession!==!1),await Tt(e,t,n,a);return}if(e.json&&!e.agentOutput&&e.pageSize===void 0&&e.cursor===void 0){e.command==="system-map"&&H(e.cwd,e.sourceSession!==!1),await At(e,t,n);return}let c=Je(e.argv),p=Ge(e.invocationPrefix),h=De(e.command,e.cwd,p,c),g=e.cursor===void 0?void 0:Gt(e.cursor,h);e.command==="system-map"&&!g&&H(e.cwd,e.sourceSession!==!1);let d=g?.snapshotId,u;if(g)try{u=Nt(g,h,r,a,s,e.onSnapshotRead)}catch(y){let q=y instanceof Error?y.message:String(y);throw new Error(`${q} Restart with: ${Fe(p,c,r)}`,{cause:y})}else{let y=new W(h,p,e.command,e.cwd,c,r,a,Jt(e,p),s,o,e.agentOutput?Re:Ne,!e.json,se(a,e.agentOutput===!0)),q=Me(V=>y.write(V)),ce=!1;try{await t(),ce=!0}finally{q(),ce||y.abort()}let P;try{P=y.complete()}catch(V){throw y.abort(),V}d=P.snapshotId,u={content:P.content,offset:0,pageIndex:0,pageCount:P.pageCount,totalCharacters:P.totalCharacters,outputHash:P.outputHash}}let v=u.offset+u.content.length,l=u.pageIndex+1>=u.pageCount,f=l?void 0:Dt({invocationPrefix:p,nextPageIndex:u.pageIndex+1,snapshotId:qt(d)});if(k(e.command,e.cwd,l,e.sourceSession!==!1,f?.command),u.offset===0&&l&&e.cursor===void 0){n.writeStdout(u.content),B(!0),d&&I(d,s);return}let E={kind:K,schemaVersion:ee,producer:{name:"scip-query",version:e.producerVersion},command:e.command,contentType:e.json?"application/json":"text/plain",agentInstruction:f?"INCOMPLETE EVIDENCE: do not draw conclusions or report completion from this partial page. Run page.continuation.command exactly, then repeat until page.complete is true.":"OUTPUT COMPLETE: all rendered characters have been retrieved. Evaluate the command result's own coverage separately.",page:f?{offset:u.offset,returnedCharacters:u.content.length,totalCharacters:u.totalCharacters,omittedCharacters:u.totalCharacters-u.content.length,remainingCharacters:u.totalCharacters-v,complete:!1,outputHash:u.outputHash,continuation:f}:{offset:u.offset,returnedCharacters:u.content.length,totalCharacters:u.totalCharacters,omittedCharacters:u.totalCharacters-u.content.length,remainingCharacters:u.totalCharacters-v,complete:!0,outputHash:u.outputHash},content:u.content};if(e.json){n.writeStdout(`${JSON.stringify(E)}
+`),l&&d&&I(d,s);return}n.writeStdout(Kt(E)),l&&d&&I(d,s)}async function Nn(e,t,n=ne(),r=He){if(e.length>j)throw new Error(`Output cursor exceeds the ${j}-character limit.`);let s=ae(e);if(!s)throw new Error("Invalid output cursor. Run the original command again.");let o=ie(s.snapshotId,n);await Ct({command:o.command,producerVersion:t,invocationPrefix:o.invocationPrefix,argv:[...o.argv,"--output-page-size",String(o.pageSize),"--output-cursor",e],cwd:o.cwd,json:o.argv.some(i=>i==="--json"||i.startsWith("--json=")),sourceSession:!o.argv.some(i=>i==="--no-session"),agentOutput:o.argv.some(i=>i==="--agent-output"),pageSize:o.pageSize,cursor:e,snapshotRoot:n},()=>{throw new Error("Output continuation attempted to rerun the original command.")},r)}async function Tt(e,t,n,r){let s=e.jsonOutputPath;if(s===void 0||s.length===0||Buffer.byteLength(s)>M||s.includes("\0"))throw new Error(`--json-output requires a path from 1 through ${M} UTF-8 bytes.`);let o=pt(e.cwd,s);if(Buffer.byteLength(o)>M)throw new Error(`The resolved --json-output path exceeds ${M} UTF-8 bytes.`);let i=new Z("utf8"),a=A("sha256"),c=0,p=0,h=f=>{if(p+=f.length,!Number.isSafeInteger(p)||p>r)throw new Error(se(r,!1))};xe(dt(o),{recursive:!0});let g=`${o}.tmp-${Ce(12).toString("hex")}`,d=Y(g,"wx",384),u=!0,v=Me(f=>{let E=c+f.length;if(!Number.isSafeInteger(E)||E>Oe)throw new Error(`JSON export exceeds the ${Oe}-byte file safety limit. Narrow the query before retrying.`);if(h(i.write(f)),d===void 0)throw new Error("JSON export writer is closed.");_t(d,f),a.update(f),c=E});try{await t(),h(i.end()),v(),L(d),d=void 0,_e(g,o),u=!1}finally{if(v(),d!==void 0)try{L(d)}catch{}u&&Q(g,{force:!0})}let l={kind:mt,schemaVersion:yt,producer:{name:"scip-query",version:e.producerVersion},command:e.command,path:o,bytes:c,sha256:a.digest("hex")};n.writeStdout(`${JSON.stringify(l)}
+`),k(e.command,e.cwd,!0,e.sourceSession!==!1),B(!0)}function _t(e,t){let n=0;for(;n<t.length;){let r=Ae(e,t,n,t.length-n);if(r<=0)throw new Error("JSON export write made no forward progress.");n+=r}}function se(e,t){let n=`Command output exceeds the ${e}-character safety limit. Narrow the query before retrying.`;return t?`${n} For the complete machine result, use --json --json-output <path> and inspect the file programmatically.`:n}function Rn(e){if(!/^\d+$/u.test(e))throw new we(`Output page size must be an integer from ${w} through ${C}.`);let t=Number(e);try{Be(t)}catch{throw new we(`Output page size must be an integer from ${w} through ${C}.`)}return t}function Be(e){if(!Number.isSafeInteger(e)||e<w||e>C)throw new Error(`Output page size must be an integer from ${w} through ${C}.`)}async function At(e,t,n){let r=new G(x,e.maxOutputCharacters??m),s=process.stdout.write,o=!1,i=`${de(`scip-query: JSON output exceeds the ${x}-byte client-safe budget and may be truncated by the client. Do not use possibly partial client output as evidence. Read every page with: ${Fe(Ge(e.invocationPrefix),Qt(Je(e.argv)),R)}`)}
+`;process.stdout.write=((a,c,p)=>{let h=r.push(a,c);return h!==void 0&&(o||(o=!0,n.writeStderr(i)),s.call(process.stdout,h)),je(c,p),!0});try{await t();let a=r.finish();a.crossedPageBoundary&&!o&&(o=!0,n.writeStderr(i)),a.bytes.length>0&&s.call(process.stdout,a.bytes),o&&n.writeStderr(i),k(e.command,e.cwd,!0,e.sourceSession!==!1)}finally{process.stdout.write=s}}function Me(e){let t=process.stdout.write;return process.stdout.write=((n,r,s)=>{let o=Lt(n,r);return e(o),je(r,s),!0}),()=>{process.stdout.write=t}}function Lt(e,t){return typeof e=="string"?Buffer.from(e,typeof t=="string"?t:"utf8"):Buffer.from(e)}function je(e,t){let n=typeof e=="function"?e:t;typeof n=="function"&&n()}var G=class{constructor(t,n){this.byteLimit=t;this.maxOutputCharacters=n}byteLimit;maxOutputCharacters;decoder=new Z("utf8");chunks=[];overflowed=!1;totalCharacters=0;totalBytes=0;push(t,n){let r=typeof t=="string"?Buffer.from(t,typeof n=="string"?n:"utf8"):Buffer.from(t);if(this.totalBytes+=r.length,this.addCharacters(this.decoder.write(r)),this.overflowed)return r;if(this.chunks.push(r),this.totalBytes<=this.byteLimit)return;this.overflowed=!0;let s=Buffer.concat(this.chunks);return this.chunks.length=0,s}finish(){this.addCharacters(this.decoder.end());let t=this.totalBytes>this.byteLimit,n=Buffer.concat(this.chunks);return this.chunks.length=0,{bytes:n,crossedPageBoundary:t}}addCharacters(t){if(this.totalCharacters+=t.length,!Number.isSafeInteger(this.totalCharacters)||this.totalCharacters>this.maxOutputCharacters)throw new Error(`Command output exceeds the ${this.maxOutputCharacters}-character safety limit. Narrow the query before retrying.`)}},W=class{constructor(t,n,r,s,o,i,a,c,p,h,g,d,u=se(a,!1)){this.invocationHash=t;this.invocationPrefix=n;this.command=r;this.cwd=s;this.argv=o;this.pageSize=i;this.maxOutputCharacters=a;this.pageContentByteLimit=c;this.snapshotRoot=p;this.limits=h;this.maxPages=g;this.preferLineBoundaries=d;this.overflowMessage=u;oe(p);do this.snapshotId=Ce(9).toString("base64url");while(this.snapshotId.startsWith("-"));this.temporaryPath=S(p,this.snapshotId,"tmp")}invocationHash;invocationPrefix;command;cwd;argv;pageSize;maxOutputCharacters;pageContentByteLimit;snapshotRoot;limits;maxPages;preferLineBoundaries;overflowMessage;snapshotId;temporaryPath;decoder=new Z("utf8");hash=A("sha256");pages=[];descriptor=null;pending="";firstPageContent="";totalCharacters=0;pageCharacterOffset=0;byteLength=0;reservedBytes=0;opened=!1;finished=!1;write(t){if(this.finished)throw new Error("Output snapshot writer is closed.");this.appendDecoded(this.decoder.write(t))}complete(){if(this.finished)throw new Error("Output snapshot writer is closed.");if(this.appendDecoded(this.decoder.end()),this.finished=!0,!this.opened){let s=this.pending,o=Buffer.from(s);return this.assertWithinByteLimit(o.length),this.hash.update(o),this.pending="",{content:s,totalCharacters:this.totalCharacters,outputHash:this.hash.digest("hex"),pageCount:1}}if((this.pending.length>0||this.pages.length===0)&&(this.flushPage(this.pending),this.pending=""),this.descriptor===null)throw new Error("Output snapshot writer is not open.");L(this.descriptor),this.descriptor=null;let t=this.hash.digest("hex"),n=S(this.snapshotRoot,this.snapshotId,"output"),r=S(this.snapshotRoot,this.snapshotId,"json");try{_e(this.temporaryPath,n);let s={version:$e,snapshotId:this.snapshotId,invocationHash:this.invocationHash,invocationPrefix:[...this.invocationPrefix],command:this.command,cwd:this.cwd,argv:[...this.argv],outputHash:t,pageSize:this.pageSize,pages:this.pages,totalCharacters:this.totalCharacters,byteLength:this.byteLength,createdAtMs:Date.now()};return _(r,s),Ie(this.snapshotRoot,this.snapshotId,this.byteLength,"complete",this.limits),this.reservedBytes=this.byteLength,{content:this.firstPageContent,totalCharacters:this.totalCharacters,outputHash:t,pageCount:this.pages.length,snapshotId:this.snapshotId}}catch(s){throw I(this.snapshotId,this.snapshotRoot),s}}abort(){this.descriptor!==null&&(L(this.descriptor),this.descriptor=null),this.finished=!0,I(this.snapshotId,this.snapshotRoot)}appendDecoded(t){if(t.length===0)return;let n=this.totalCharacters+t.length;if(!Number.isSafeInteger(n)||n>this.maxOutputCharacters)throw new Error(this.overflowMessage);for(this.totalCharacters=n,this.pending+=t,this.assertWithinByteLimit(this.byteLength+Buffer.byteLength(this.pending));this.pending.length>this.pageSize||Buffer.byteLength(this.pending)>this.pageContentByteLimit;){this.open();let r=Vt(this.pending,this.pageSize,this.pageContentByteLimit,this.preferLineBoundaries),s=this.pending.slice(0,r);this.pending=this.pending.slice(r),this.flushPage(s)}}open(){if(!this.opened){Ht(this.snapshotRoot,this.snapshotId,0,this.limits);try{this.descriptor=Y(this.temporaryPath,"wx",384),this.opened=!0}catch(t){throw Bt(this.snapshotRoot,this.snapshotId),t}}}flushPage(t){if(this.descriptor===null)throw new Error("Output snapshot writer is not open.");if(this.pages.length>=this.maxPages)throw new Error(`Command output requires more than ${this.maxPages} snapshot pages. Retry with a larger --output-page-size, narrow the query, or use --json --json-output <path>.`);let n=Buffer.from(t),r=this.byteLength+n.length;if(this.assertWithinByteLimit(r),r>this.reservedBytes){let i=Math.min(this.limits.maxSnapshotBytes,Math.ceil(r/be)*be);Ie(this.snapshotRoot,this.snapshotId,i,"active",this.limits),this.reservedBytes=i}let s=0;for(;s<n.length;){let i=Ae(this.descriptor,n,s,n.length-s);if(i<=0)throw new Error("Output snapshot write made no progress.");s+=i}let o={characterOffset:this.pageCharacterOffset,characterLength:t.length,byteOffset:this.byteLength,byteLength:n.length,hash:A("sha256").update(n).digest("hex")};this.pages.length===0&&(this.firstPageContent=t),this.pages.push(o),this.hash.update(n),this.pageCharacterOffset+=t.length,this.byteLength=r}assertWithinByteLimit(t){if(!Number.isSafeInteger(t)||t>this.limits.maxSnapshotBytes)throw new Error(`Command output exceeds the ${this.limits.maxSnapshotBytes}-byte snapshot limit. Narrow the query before retrying.`)}};function Nt(e,t,n,r,s,o){oe(s);let i=ie(e.snapshotId,s);if(i.invocationHash!==t)throw new Error("This output cursor belongs to a different command, working directory, or argument set. Run again without --output-cursor.");if(i.snapshotId!==e.snapshotId||e.version===3&&(i.invocationHash!==e.invocationHash||i.outputHash!==e.outputHash))throw new Error("Output snapshot identity does not match this cursor.");if(i.pageSize!==n||e.version===3&&e.pageSize!==n)throw new Error(`Output page size changed after this cursor was issued; use ${i.pageSize}.`);let a=i.pages[e.pageIndex];if(!a)throw new Error("Output cursor points past the current result.");if(i.totalCharacters>r)throw new Error(`Output snapshot exceeds the ${r}-character safety limit.`);if(Date.now()-i.createdAtMs>te)throw I(e.snapshotId,s),new Error("Output snapshot expired before all pages were read.");let c=S(s,e.snapshotId,"output"),p=Y(c,"r");try{let h=ve(p);if(!h.isFile()||h.size!==i.byteLength)throw new Error("Output snapshot size or type changed.");let g=Buffer.allocUnsafe(a.byteLength),d=0;for(;d<g.length;){let l=at(p,g,d,g.length-d,a.byteOffset+d);if(l===0)break;d+=l,o?.(l)}let u=ve(p);if(u.dev!==h.dev||u.ino!==h.ino||u.size!==h.size||d!==a.byteLength)throw new Error("Output snapshot changed while it was being read.");if(A("sha256").update(g).digest("hex")!==a.hash)throw new Error("Output snapshot page no longer matches its metadata.");let v=g.toString("utf8");if(v.length!==a.characterLength)throw new Error("Output snapshot page character count changed.");return{content:v,offset:a.characterOffset,pageIndex:e.pageIndex,pageCount:i.pages.length,totalCharacters:i.totalCharacters,outputHash:i.outputHash}}catch(h){throw I(e.snapshotId,s),h}finally{L(p)}}function ie(e,t){if(!O(e))throw new Error("Output snapshot identifier is invalid.");let n;try{n=JSON.parse(U(S(t,e,"json"),"output snapshot metadata"))}catch(r){throw new Error("Output snapshot is unavailable.",{cause:r})}if(!Rt(n))throw new Error("Output snapshot metadata is invalid.");return n}function Rt(e){if(!e||typeof e!="object")return!1;let t=e;return t.version===$e&&typeof t.snapshotId=="string"&&O(t.snapshotId)&&b(t.invocationHash)&&We(t.invocationPrefix)&&typeof t.command=="string"&&t.command.length>0&&t.command.length<=256&&typeof t.cwd=="string"&&t.cwd.length>0&&t.cwd.length<=8192&&Zt(t.argv)&&De(t.command,t.cwd,t.invocationPrefix,t.argv)===t.invocationHash&&b(t.outputHash)&&Number.isSafeInteger(t.pageSize)&&(t.pageSize??0)>=w&&(t.pageSize??0)<=C&&Array.isArray(t.pages)&&t.pages.length>1&&t.pages.length<=Ne&&t.pages.every($t)&&Ut(t.pages)&&Number.isSafeInteger(t.totalCharacters)&&(t.totalCharacters??-1)>=0&&t.pages.reduce((n,r)=>n+r.characterLength,0)===t.totalCharacters&&Number.isSafeInteger(t.byteLength)&&(t.byteLength??-1)>=0&&t.pages.reduce((n,r)=>n+r.byteLength,0)===t.byteLength&&Number.isSafeInteger(t.createdAtMs)&&(t.createdAtMs??-1)>=0}function $t(e){if(!e||typeof e!="object")return!1;let t=e;return Number.isSafeInteger(t.characterOffset)&&(t.characterOffset??-1)>=0&&Number.isSafeInteger(t.characterLength)&&(t.characterLength??0)>0&&Number.isSafeInteger(t.byteOffset)&&(t.byteOffset??-1)>=0&&Number.isSafeInteger(t.byteLength)&&(t.byteLength??0)>0&&b(t.hash)}function Ut(e){let t=0,n=0;for(let r of e){if(r.characterOffset!==t||r.byteOffset!==n)return!1;t+=r.characterLength,n+=r.byteLength}return!0}function oe(e){xe(e,{recursive:!0,mode:448});let t=ot(e);if(!t.isDirectory()||t.isSymbolicLink())throw new Error(`Output snapshot root is not a private directory: ${e}`);if(typeof process.getuid=="function"&&t.uid!==process.getuid())throw new Error(`Output snapshot root is not owned by the current user: ${e}`);process.platform!=="win32"&&it(e,448)}function kt(e){let t={...Et,...e};for(let[n,r]of Object.entries(t))if(!Number.isSafeInteger(r)||r<=0)throw new Error(`Output snapshot ${n} must be a positive integer.`);if(t.maxSnapshotBytes>t.maxAggregateBytes)throw new Error("Output snapshot maxSnapshotBytes cannot exceed maxAggregateBytes.");return t}function Ht(e,t,n,r){z(e,()=>{jt(e),ze(e,t,n,"active",r)})}function Ie(e,t,n,r,s){if(!Number.isSafeInteger(n)||n<0||n>s.maxSnapshotBytes)throw new Error(`Command output exceeds the ${s.maxSnapshotBytes}-byte snapshot limit.`);z(e,()=>{ze(e,t,n,r,s)})}function ze(e,t,n,r,s){if(!Number.isSafeInteger(n)||n<0||n>s.maxSnapshotBytes)throw new Error(`Command output exceeds the ${s.maxSnapshotBytes}-byte snapshot limit.`);let o=Mt(e),i=o.find(g=>g.snapshotId===t),a=o.reduce((g,d)=>g+d.reservedBytes,0)-(i?.reservedBytes??0)+n,c=o.length+(i?0:1);if(c>s.maxSnapshotCount||a>s.maxAggregateBytes)throw new Error(`Output snapshot capacity is full (${c}/${s.maxSnapshotCount} snapshots, ${a}/${s.maxAggregateBytes} bytes). Narrow the query or finish an existing pagination sequence before retrying.`);let p=Date.now(),h={version:ke,snapshotId:t,pid:process.pid,...X()?{processIdentity:X()}:{},reservedBytes:n,state:r,createdAtMs:i?.createdAtMs??p,updatedAtMs:p};_(S(e,t,"reserve"),h)}function Bt(e,t){z(e,()=>{Q(S(e,t,"reserve"),{force:!0})})}function Mt(e){let t=[];for(let n of Te(e,{withFileTypes:!0})){if(!n.isFile()||!n.name.endsWith(".reserve"))continue;let r=n.name.slice(0,-8);if(O(r))try{let s=JSON.parse(U(N(e,n.name),"output snapshot reservation"));if(!qe(s)||s.snapshotId!==r)throw new Error("reservation identity is invalid");t.push(s)}catch(s){throw new Error(`Output snapshot reservation ${n.name} is invalid; retry after its owning process or snapshot expires.`,{cause:s})}}return t}function qe(e){if(!e||typeof e!="object")return!1;let t=e;return t.version===ke&&typeof t.snapshotId=="string"&&O(t.snapshotId)&&Number.isSafeInteger(t.pid)&&(t.pid??0)>0&&(t.processIdentity===void 0||he(t.processIdentity)!==null&&t.processIdentity.pid===t.pid)&&Number.isSafeInteger(t.reservedBytes)&&(t.reservedBytes??-1)>=0&&(t.state==="active"||t.state==="complete")&&Number.isSafeInteger(t.createdAtMs)&&Number.isSafeInteger(t.updatedAtMs)}function jt(e){let t=Date.now();for(let n of Te(e,{withFileTypes:!0})){if(!n.isFile()||!n.name.endsWith(".reserve"))continue;let r=n.name.slice(0,-8);if(!O(r))continue;let s=null;try{let c=JSON.parse(U(N(e,n.name),"output snapshot reservation"));s=qe(c)?c:null}catch{s=null}let o=zt(S(e,r,"json")),i=s?.state==="active"&&le(s.pid)&&(s.processIdentity===void 0||(()=>{let c=J(s.pid);return c!==null&&ge(s.processIdentity,c)})()),a=s?t-s.updatedAtMs>te:!1;i||o&&!a||!o&&s&&!a&&s.state==="complete"||Ve(r,e)}}function zt(e){try{return ut(e),!0}catch{return!1}}function z(e,t){oe(e);let n=N(e,wt),r=Date.now()+Ot;for(;;){let s=fe(n,{kind:"output-snapshot-quota",processIdentity:X()});if(s.kind==="acquired")try{return t()}finally{s.lock.release()}if(Date.now()>=r)throw new Error("Output snapshot quota is busy. Retry the command.");Atomics.wait(It,0,0,bt)}}function X(){return F===void 0&&(F=J(process.pid)),F}function I(e,t){O(e)&&z(t,()=>Ve(e,t))}function Ve(e,t){for(let n of["json","output","tmp","reserve"])Q(S(t,e,n),{force:!0})}function S(e,t,n){if(!O(t))throw new Error("Output snapshot identifier is invalid.");return N(e,`${t}.${n}`)}function qt(e){if(!e)throw new Error("Incomplete output did not create a resumable snapshot.");return e}function Ee(e){return e>=55296&&e<=56319}function Vt(e,t,n,r){let s=Math.min(e.length,t);if(Ee(e.charCodeAt(s-1))&&(s-=1),Buffer.byteLength(e.slice(0,s))>n){let o=0,i=s;for(;o<i;){let a=Math.ceil((o+i)/2);Buffer.byteLength(e.slice(0,a))<=n?o=a:i=a-1}s=o,Ee(e.charCodeAt(s-1))&&(s-=1)}if(s<=0)throw new Error("Output page byte limit cannot contain one UTF-8 character.");if(r){let o=e.lastIndexOf(`
+`,s-1);if(o>=0)return o+1}return s}function Dt(e){let t=Ft({pageIndex:e.nextPageIndex,snapshotId:e.snapshotId});return{cursor:t,command:ue(e.invocationPrefix,t)}}function Jt(e,t){let n="c".repeat(64),r={cursor:n,command:ue(t,n)};if(!e.json){let i="9".repeat(String(m).length),a=`[scip-query output page: characters ${i}-${i} of ${i}]
+
+[Incomplete: ${i} characters remain. Continue exactly:
+${r.command}]
+`;return Pe(D,Buffer.byteLength(a),1)}let s={kind:K,schemaVersion:ee,producer:{name:"scip-query",version:e.producerVersion},command:e.command,contentType:"application/json",agentInstruction:"INCOMPLETE EVIDENCE: do not draw conclusions or report completion from this partial page. Run page.continuation.command exactly, then repeat until page.complete is true.",page:{offset:m,returnedCharacters:m,totalCharacters:m,omittedCharacters:m,remainingCharacters:m,complete:!1,outputHash:"f".repeat(64),continuation:r},content:""},o=Buffer.byteLength(`${JSON.stringify(s)}
+`);return Pe($,o,2)}function Pe(e,t,n){let r=Math.floor((x-t)/n);if(r<w)throw new Error(`The command invocation leaves fewer than ${w} bytes for client-safe output content. Use a shorter executable path.`);return Math.min(e,r)}function Ft(e){return Ue.test(e.snapshotId)?e.pageIndex===1?e.snapshotId:`${e.snapshotId}.${e.pageIndex.toString(36)}`:`4.${Xt(e.snapshotId)}.${e.pageIndex.toString(36)}`}function Gt(e,t){let n=ae(e);if(!n)throw new Error("Invalid output cursor. Run the command again without --output-cursor.");if(n.version===3&&n.invocationHash!==t)throw new Error("This output cursor belongs to a different command, working directory, or argument set. Run again without --output-cursor.");return n}function ae(e){let t=vt.exec(e);if(t){let r=t[2]??"1",s=Number.parseInt(r,36);return Number.isSafeInteger(s)&&s>=1&&s.toString(36)===r?{version:4,pageIndex:s,snapshotId:t[1]}:null}let n=St.exec(e);if(n){let r=Yt(n[1]),s=Number.parseInt(n[2],36);return r&&Number.isSafeInteger(s)&&s>=1&&s.toString(36)===n[2]?{version:4,pageIndex:s,snapshotId:r}:null}try{let r=JSON.parse(Buffer.from(e,"base64url").toString("utf8"));return Wt(r)?r:null}catch{return null}}function $n(e,t=ne()){let n=ae(e);if(n)try{let r=ie(n.snapshotId,t);if(r.snapshotId!==n.snapshotId||n.version===3&&(r.invocationHash!==n.invocationHash||r.outputHash!==n.outputHash||r.pageSize!==n.pageSize)||Date.now()-r.createdAtMs>te||!r.pages[n.pageIndex])return;let s=r.pages[n.pageIndex];return{snapshotId:r.snapshotId,pageIndex:n.pageIndex,command:r.command,cwd:r.cwd,continuationCommand:ue(r.invocationPrefix,e),remainingCharacters:r.totalCharacters-s.characterOffset,totalCharacters:r.totalCharacters,outputHash:r.outputHash,createdAtMs:r.createdAtMs}}catch{return}}function Wt(e){if(!e||typeof e!="object")return!1;let t=e;return t.version===3&&b(t.invocationHash)&&Number.isSafeInteger(t.pageIndex)&&(t.pageIndex??-1)>=1&&Number.isSafeInteger(t.pageSize)&&(t.pageSize??0)>=w&&(t.pageSize??0)<=C&&b(t.outputHash)&&typeof t.snapshotId=="string"&&O(t.snapshotId)}function Xt(e){if(!re.test(e))throw new Error("Output snapshot identifier is invalid.");return Buffer.from(e.replaceAll("-",""),"hex").toString("base64url")}function Yt(e){let t=Buffer.from(e,"base64url");if(t.length!==16)return null;let n=t.toString("hex"),r=`${n.slice(0,8)}-${n.slice(8,12)}-${n.slice(12,16)}-${n.slice(16,20)}-${n.slice(20)}`;return re.test(r)?r:null}function O(e){return typeof e=="string"&&(Ue.test(e)||re.test(e))}function De(e,t,n,r){return A("sha256").update(JSON.stringify({command:e,cwd:t,invocationPrefix:n,argv:r})).digest("hex")}function Je(e){let t=[];for(let n=0;n<e.length;n+=1){let r=e[n];if(r==="--output-page-size"||r==="--output-cursor"){n+=1;continue}r.startsWith("--output-page-size=")||r.startsWith("--output-cursor=")||t.push(r)}return t}function Qt(e){return e.filter(t=>t!=="--raw-json"&&t!=="--raw-json=true")}function Fe(e,t,n){return Xe([...e,...t,"--output-page-size",String(n)])}function ue(e,t){return Xe([...e,ht,t])}function Ge(e){let t=e===void 0?["scip-query"]:[...e];if(!We(t))throw new Error("Output pagination invocation prefix must contain one to sixteen non-empty shell arguments.");return t}function We(e){return Array.isArray(e)&&e.length>0&&e.length<=16&&e.every(t=>typeof t=="string"&&t.length>0&&t.length<=2048&&!t.includes("\0")&&!t.includes("\r")&&!t.includes(`
+`))}function Zt(e){return Array.isArray(e)&&e.length>0&&e.length<=256&&e.every(t=>typeof t=="string"&&t.length<=8192&&!t.includes("\0")&&!t.includes("\r")&&!t.includes(`
+`))}function Xe(e){return e.map(t=>me(t,{omitSafeQuotes:!0})).join(" ")}function Kt(e){let t=e.page.continuation,n=Math.max(e.page.offset,e.page.offset+e.page.returnedCharacters-1),r=`[scip-query output page: characters ${e.page.offset}-${n} of ${e.page.totalCharacters}]
+`,s=t?`
+[Incomplete: ${e.page.remainingCharacters} characters remain. Continue exactly:
+${t.command}]
+`:`
+[scip-query transport complete; evaluate command coverage separately]
+`;return`${r}${e.content}${s}`}export{x as CLIENT_SAFE_OUTPUT_BYTES,mt as CLI_JSON_EXPORT_RECEIPT_KIND,yt as CLI_JSON_EXPORT_RECEIPT_SCHEMA_VERSION,ht as CLI_OUTPUT_CONTINUATION_COMMAND,K as CLI_OUTPUT_PAGE_KIND,ee as CLI_OUTPUT_PAGE_SCHEMA_VERSION,R as DEFAULT_OUTPUT_PAGE_SIZE,D as HUMAN_OUTPUT_PAGE_CONTENT_BYTES,$ as JSON_OUTPUT_PAGE_CONTENT_BYTES,ft as MAX_AGENT_OUTPUT_CHARACTERS,Re as MAX_AGENT_OUTPUT_PAGES,Oe as MAX_JSON_OUTPUT_FILE_BYTES,M as MAX_JSON_OUTPUT_PATH_LENGTH,j as MAX_OUTPUT_CURSOR_LENGTH,C as MAX_OUTPUT_PAGE_SIZE,gt as MAX_OUTPUT_SNAPSHOT_AGGREGATE_BYTES,Le as MAX_OUTPUT_SNAPSHOT_BYTES,lt as MAX_OUTPUT_SNAPSHOT_COUNT,Ne as MAX_OUTPUT_SNAPSHOT_PAGES,m as MAX_TRACKED_OUTPUT_CHARACTERS,w as MIN_OUTPUT_PAGE_SIZE,te as OUTPUT_SNAPSHOT_TTL_MS,Nn as continueCliOutput,Pt as decodeCliOutputPageEnvelope,$n as inspectPendingCliOutputCursor,Rn as parseOutputPageSize,Ln as requireCliOutputPageEnvelope,Ct as runWithCliOutputPagination};
+//# sourceMappingURL=output-pagination-VAWOGX4R.js.map

package/dist/postinstall.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import"./chunk-KFZNKUNT.js";import{existsSync as n,mkdirSync as i,symlinkSync as o,readlinkSync as r,unlinkSync as l,readdirSync as c}from"fs";import{join as u,dirname as p,resolve as d,relative as k,isAbsolute as g}from"path";import{homedir as m,platform as e}from"os";import{fileURLToPath as h}from"url";var y=e()==="win32";function s(){console.log("scip-query installed (Node.js 24 LTS recommended; minimum Node.js 22) -- run 'scip-query setup' in a repo to enable skills, hooks, and the index.")}s();
+import"./chunk-BZYSGZRK.js";import"./chunk-F4FNK44D.js";import{existsSync as n,mkdirSync as i,symlinkSync as o,readlinkSync as r,unlinkSync as l,readdirSync as c}from"fs";import{join as u,dirname as p,resolve as d,relative as k,isAbsolute as g}from"path";import{homedir as m,platform as t}from"os";import{fileURLToPath as y}from"url";var h=t()==="win32";function s(){console.log("scip-query installed (Node.js 24 LTS recommended; minimum Node.js 22) -- run 'scip-query setup' in a repo to install skills and build the index.")}s();
 //# sourceMappingURL=postinstall.js.map

package/dist/project-reindex-4ARU6QCM.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{m as a}from"./chunk-F7WQ337U.js";import"./chunk-OIVZ7PW6.js";export{a as reindexConfiguredProject};
+//# sourceMappingURL=project-reindex-4ARU6QCM.js.map

package/dist/queries/affected.d.ts

@@ -1,6 +1,6 @@
-import { S as ScipDatabase } from '../db-B5PM5yNk.js';
+import { S as ScipDatabase } from '../db-LKJXAlNS.js';
 import 'better-sqlite3';
-import '../config-types-jVM3D7MA.js';
+import '../config-types-Cm-VSEBb.js';
 
 interface AffectedResult {
     symbol: string;
@@ -8,8 +8,21 @@ interface AffectedResult {
     file: string;
     depth: number;
 }
+interface PossibleImpactCoverage {
+    status: 'accounted' | 'bounded' | 'incomplete';
+    edgeBasis: 'reverse-static-call-or-reference-evidence';
+    maxDepth: number;
+    reachedDepth: number;
+    perSymbolEvidenceLimit: number | null;
+    remainingFrontierSymbols: number;
+    reasons: string[];
+}
+interface PossibleImpactClosureResult {
+    rows: AffectedResult[];
+    coverage: PossibleImpactCoverage;
+}
 /**
- * Full transitive closure of symbols that could break if a given symbol changes.
+ * Bounded reverse closure of symbols that may consume a given symbol.
  * BFS from the target through the mention graph: depth 1 = direct consumers,
  * depth 2 = consumers of consumers, etc.
  */
@@ -17,5 +30,10 @@ declare function affected(db: ScipDatabase, symbolPattern: string, opts?: {
     maxDepth?: number;
     scope?: string;
 }): AffectedResult[];
+/** Conservative reverse reference/caller closure; rows are possible impacts, not predicted failures. */
+declare function possibleImpactClosure(db: ScipDatabase, symbolPattern: string, opts?: {
+    maxDepth?: number;
+    scope?: string;
+}): PossibleImpactClosureResult;
 
-export { type AffectedResult, affected };
+export { type AffectedResult, type PossibleImpactClosureResult, type PossibleImpactCoverage, affected, possibleImpactClosure };

package/dist/queries/affected.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-IB2N4FIY.js";import"../chunk-Z4N3MZYA.js";import"../chunk-7O5IKBTZ.js";import"../chunk-HX7M4BDI.js";import"../chunk-P5XHIJHI.js";import"../chunk-T7YQSHPQ.js";import"../chunk-7WPLAODU.js";import"../chunk-BS2NMXQZ.js";import"../chunk-C43RDDP4.js";import"../chunk-MTDBHTSF.js";import"../chunk-EKZTZXHZ.js";import"../chunk-UJPRPGCO.js";import"../chunk-GH74ASD6.js";import"../chunk-WCCFZ7V7.js";import"../chunk-NGEXCJJW.js";import"../chunk-7S5E7KWT.js";import"../chunk-2KAZEZ6M.js";import"../chunk-C3KV2II6.js";export{a as affected};
+import{a,b}from"../chunk-QD7IFBCR.js";import"../chunk-6BJ7SOY7.js";import"../chunk-63MBA7EG.js";import"../chunk-P5XHIJHI.js";import"../chunk-ICUQONOG.js";import"../chunk-ZDVDSDFG.js";import"../chunk-RGCJ4646.js";import"../chunk-ELNRLMC5.js";import"../chunk-LPGDO2XA.js";import"../chunk-MYUKI5VN.js";import"../chunk-7COHFNJK.js";import"../chunk-MTDBHTSF.js";import"../chunk-5IZTXSOL.js";import"../chunk-I3U2FN2T.js";import"../chunk-AA7K3XLM.js";import"../chunk-DMQ7ZKJG.js";import"../chunk-7HU2IJ2T.js";import"../chunk-MO226P4Q.js";export{a as affected,b as possibleImpactClosure};
 //# sourceMappingURL=affected.js.map