scip-query 0.23.0 → 0.26.0

package/dist/deps-EOWFC6FD.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-2YXE77TJ.js";import"./chunk-OGFV2BUX.js";import"./chunk-LOVIZBJ4.js";import"./chunk-QXEUDXBT.js";import"./chunk-J5FJMODQ.js";import"./chunk-WOFQ5DTB.js";import"./chunk-PH52RA7D.js";import"./chunk-7Y5T6XDP.js";import"./chunk-X6RMKHJQ.js";import"./chunk-JEVRKFRL.js";import"./chunk-QOIXNWQR.js";import"./chunk-GZKFETP5.js";import"./chunk-HRRFKWPZ.js";import"./chunk-YULZRALL.js";import"./chunk-HGFDYOVB.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";export{a as deps,b as rdeps};
+//# sourceMappingURL=deps-EOWFC6FD.js.map

package/dist/direct-navigation-Y5B6OSIQ.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{A as a}from"./chunk-EJVTR244.js";import"./chunk-EYK3ZAO2.js";import"./chunk-JYWEX7RR.js";import"./chunk-OZCJXZK6.js";export{a as directNavigationQueryCommandDescriptors};
+//# sourceMappingURL=direct-navigation-Y5B6OSIQ.js.map

package/dist/{exploration-topology-BG4v30HZ.d.ts → exploration-topology-CSgEyAz-.d.ts}

@@ -8,6 +8,8 @@ interface ExplorationSourceLocation {
     file: string;
     line: number;
     endLine?: number;
+    startColumn?: number;
+    endColumn?: number;
 }
 type ExplorationEvidenceStrength = 'exact' | 'derived' | 'candidate' | 'mixed' | 'unknown';
 type ExplorationDisposition = 'emitted' | 'folded' | 'excluded' | 'unsupported';
@@ -253,4 +255,4 @@ interface ExplorationRouteCatalog {
     coverage: ExplorationRouteCatalogCoverage;
 }
 
-export type { ExplorationSourceLocation as E, ProgramEdgeSemantic as P, ExplorationEvidenceStrength as a, ExplorationTopologyNode as b, ExplorationEvidenceSource as c, ExplorationTopology as d, ExplorationAnchorStatus as e, ExplorationCompletion as f, ExplorationCompletionStatus as g, ExplorationDisposition as h, ExplorationDispositionCounts as i, ExplorationFrontierGroup as j, ExplorationTopologyAnchor as k, ExplorationTopologyCoverage as l, ExplorationTopologyEdge as m, ExplorationTopologyInput as n, ExplorationTopologyPath as o };
+export type { ExplorationSourceLocation as E, ProgramEdgeSemantic as P, ExplorationEvidenceStrength as a, ExplorationAnchorStatus as b, ExplorationCompletion as c, ExplorationCompletionStatus as d, ExplorationDisposition as e, ExplorationDispositionCounts as f, ExplorationEvidenceSource as g, ExplorationFrontierGroup as h, ExplorationTopology as i, ExplorationTopologyAnchor as j, ExplorationTopologyCoverage as k, ExplorationTopologyEdge as l, ExplorationTopologyInput as m, ExplorationTopologyNode as n, ExplorationTopologyPath as o };

package/dist/files-K4AI3JUM.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-XKIDJCIK.js";import"./chunk-QIWXRW72.js";import"./chunk-YUKYB54I.js";import"./chunk-PH52RA7D.js";import"./chunk-JEVRKFRL.js";import"./chunk-GZKFETP5.js";import"./chunk-HRRFKWPZ.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";export{a as files,b as pathMatchesGlob};
+//# sourceMappingURL=files-K4AI3JUM.js.map

package/dist/frontend-profile-roles-D7eCum8P.d.ts

@@ -0,0 +1,10 @@
+type FrontendPairContext = 'product' | 'framework-route-pair' | 'intercepting-route-pair' | 'ui-kit-pair';
+interface FrontendPolicyExclusion {
+    /** Stable identifier for the policy that excluded the rows. */
+    reason: string;
+    /** Reviewer-facing explanation of what was excluded and why. */
+    detail: string;
+    count: number;
+}
+
+export type { FrontendPairContext as F, FrontendPolicyExclusion as a };

package/dist/{health-CPp2Jf1Z.d.ts → health-BtfmNrfa.d.ts}

@@ -47,10 +47,19 @@ interface CountLocSummary {
     loc: number;
     /** Files contributing findings — feeds fix-density validation. */
     files?: string[];
+    /**
+     * Rows a detector policy removed from the count (test scaffolding, vendored
+     * kit primitives, framework-mandated twins). Disclosed so an excluded row is
+     * never mistaken for an absent one.
+     */
+    exclusions?: PolicyExclusionSummary[];
 }
-interface StaleSummary extends CountLocSummary {
-    unused: number;
-    singleUse: number;
+interface PolicyExclusionSummary {
+    /** Stable identifier for the excluding policy. */
+    reason: string;
+    /** Reviewer-facing explanation of what was excluded and why. */
+    detail: string;
+    count: number;
 }
 interface DriftSummary {
     count: number;
@@ -61,19 +70,13 @@ interface DriftSummary {
     direct: number;
     signal: number;
 }
-interface ComplexitySummary {
-    top: Array<{
-        symbol: string;
-        score: number;
-        file?: string;
-    }>;
-    extremeCount: number;
-}
 interface GitEvidenceSummary {
     amplification: ChangeAmplificationSummary | null;
     hiddenCoupling: {
         pairCount: number;
         scoreCount: number;
+        /** Co-change pairs policy did not count as hidden coupling (disclosed). */
+        exclusions?: PolicyExclusionSummary[];
         top: Array<{
             fileA: string;
             fileB: string;
@@ -120,25 +123,15 @@ interface HealthAction {
     /** 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 {
-    axis: string;
-    points: number;
+/** One detector policy that removed rows from a finding count, with the count it removed. */
+interface HealthPolicyExclusion {
+    detector: string;
+    reason: string;
     detail: string;
-    /** Risk deductions use graph/change evidence; hygiene deductions use candidate signals. */
-    kind: 'risk' | 'hygiene';
-}
-interface HealthPressure {
-    axis: string;
-    category: string;
-    kind: ScoreDeduction['kind'];
     count: number;
-    threshold: number;
-    ratio: number;
-    extraPenalty: number;
 }
 interface HealthAxes {
-    /** LOC in indexed zero-reference or disconnected candidates (legacy field name: deletable). */
+    /** LOC in indexed no-observed-reference candidates (legacy field name: deletable). */
     deletable: {
         loc: number;
         symbols: number;
@@ -146,9 +139,9 @@ interface HealthAxes {
     cycles: {
         count: number;
     };
-    /** Files touched per commit — the measured cost of one conceptual change. */
+    /** Files touched per observed commit; a commit may contain several unrelated changes. */
     changeAmplification: ChangeAmplificationSummary | null;
-    /** File pairs that co-change without a structural link — concepts the visible graph can't see. */
+    /** File pairs changed in the same commits without an observed structural link; this is historical association. */
     hiddenCoupling: {
         pairCount: number;
         scoreCount: number;
@@ -160,14 +153,6 @@ interface HealthAxes {
             scoreWeight?: number;
         }>;
     } | null;
-    /** Complexity hotspots weighted by churn — complex code nobody touches costs nothing. */
-    churnWeightedComplexity: Array<{
-        symbol: string;
-        file?: string;
-        score: number;
-        changes: number;
-        weighted: number;
-    }> | null;
     /** What fraction of findings rest on graph facts vs heuristics, and how many the user has rejected. */
     evidenceQuality: {
         graphFindings: number;
@@ -193,24 +178,35 @@ interface HealthValidation {
         commitsScanned: number;
     };
 }
+/** What a report was computed from, so two runs can be compared as the same or different input. */
+interface HealthProvenance {
+    computedAt: string;
+    generation: {
+        /** Immutable index generation identity the report read. */
+        identity: string;
+        /** When that generation was published, when the generation store records it. */
+        publishedAt: string | null;
+        /** How that generation was produced, when the generation store records it. */
+        mode: 'incremental' | 'full' | null;
+    };
+    /** Null when the project is not a git repository. */
+    git: {
+        head: string;
+        branch: string | null;
+        dirtyPaths: number;
+    } | null;
+}
 interface HealthReport {
-    /** Headline = min(riskScore, hygieneScore); kept for compatibility. */
-    score: number;
-    /** Risk-oriented graph facts and change-graph signals; the composite remains experimental. */
-    riskScore: number;
-    /** Tidiness signals (candidate detectors) — real but not fix-predictive. */
-    hygieneScore: number;
-    scoreBreakdown: ScoreDeduction[];
     overview: {
         documents: number;
         symbols: number;
         indexSizeBytes: number;
     };
+    /** Absent only on reports written by older builds. */
+    provenance?: HealthProvenance;
     findings: {
         deadSymbols: number;
         deadLoc: number;
-        isolatedSymbols: number;
-        isolatedLoc: number;
         cycles: number;
         similarPairs: number;
         duplicateBodyGroups: number;
@@ -225,13 +221,8 @@ interface HealthReport {
         vueComposableCandidatePairs: number;
         vueComposableCandidateScoreCount: number;
         vueLargeViewPressureFiles: number;
-        extractionCandidates: number;
-        wrappers: number;
-        wrapperScoreCount: number;
         passthroughs: number;
-        staleTypes: number;
         driftedFiles: number;
-        complexityHotspotCount: number;
         hiddenCouplingPairs: number | null;
         hiddenCouplingScoreCount: number | null;
         coverageContractViolations: number;
@@ -243,18 +234,19 @@ interface HealthReport {
         byCategory: Record<string, number>;
     } | null;
     actions: HealthAction[];
-    pressure: HealthPressure[];
-    topComplexity: Array<{
-        symbol: string;
-        score: number;
-        file?: string;
-    }>;
+    /**
+     * Rows detector policies removed from the counts above (test scaffolding,
+     * vendored kit primitives, framework-mandated twins). Each row is still
+     * listed by its detector command; it is disclosed here so an excluded
+     * finding is never mistaken for an absent one.
+     */
+    policyExclusions: HealthPolicyExclusion[];
     /** Calibrated claim limits and recovery paths for detector evidence. */
     detectorEvidence: DetectorEvidenceAssessment[];
     warnings?: string[];
 }
 
-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"];
+declare const HEALTH_PHASES: readonly ["overview", "dead", "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", "passthrough-candidates", "drift", "git-evidence", "suppressions", "coverage-contracts"];
 type HealthPhaseName = (typeof HEALTH_PHASES)[number];
 type HealthPhaseResult = {
     phase: 'overview';
@@ -263,12 +255,10 @@ type HealthPhaseResult = {
 } | {
     phase: 'dead';
     dead: CountLocSummary;
-} | {
-    phase: 'isolated';
-    isolated: CountLocSummary;
 } | {
     phase: 'cycles';
     realCycleCount: number;
+    cycleExclusions: PolicyExclusionSummary[];
 } | {
     phase: 'similar';
     similarCount: number;
@@ -296,24 +286,12 @@ type HealthPhaseResult = {
 } | {
     phase: 'vue-large-view-pressure';
     vueLargeViewPressure: CountLocSummary;
-} | {
-    phase: 'extract-candidates';
-    extractCount: number;
-} | {
-    phase: 'wrapper-candidates';
-    wrappers: CountLocSummary;
 } | {
     phase: 'passthrough-candidates';
     passthroughs: CountLocSummary;
-} | {
-    phase: 'stale-abstractions';
-    stale: StaleSummary;
 } | {
     phase: 'drift';
     drift: DriftSummary;
-} | {
-    phase: 'complexity-hotspots';
-    complexity: ComplexitySummary;
 } | {
     phase: 'git-evidence';
     gitEvidence: GitEvidenceSummary | null;
@@ -338,6 +316,12 @@ declare function health(db: ScipDatabase, opts?: {
     scope?: string;
     full?: boolean;
 }): HealthReport;
+/**
+ * The generation and git state this run read. Two reports are comparable
+ * only when these match; the "files | symbols" header alone cannot tell a
+ * detector change from a repository change.
+ */
+declare function healthProvenance(db: ScipDatabase): HealthProvenance;
 declare function healthPhase(db: ScipDatabase, phase: HealthPhaseName, opts?: {
     scope?: string;
     full?: boolean;
@@ -346,6 +330,6 @@ declare function healthPhases(db: ScipDatabase, phases: readonly HealthPhaseName
     scope?: string;
     full?: boolean;
 }): HealthPhaseResult[];
-declare function healthReportFromPhases(phaseResults: HealthPhaseResult[]): HealthReport;
+declare function healthReportFromPhases(phaseResults: HealthPhaseResult[], db?: ScipDatabase): HealthReport;
 
-export { HEALTH_PHASES as H, type HealthAction as a, type HealthReport as b, healthPhase as c, healthReportFromPhases as d, type HealthPhaseName as e, healthPhases as f, health as h };
+export { HEALTH_PHASES as H, type HealthAction as a, type HealthProvenance as b, type HealthReport as c, healthPhase as d, healthProvenance as e, healthReportFromPhases as f, type HealthPhaseName as g, health as h, healthPhases as i };

package/dist/hierarchy-6W5NDIFI.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-DDMC3FON.js";import"./chunk-QXEUDXBT.js";import"./chunk-J5FJMODQ.js";import"./chunk-WOFQ5DTB.js";import"./chunk-PH52RA7D.js";import"./chunk-7Y5T6XDP.js";import"./chunk-X6RMKHJQ.js";import"./chunk-JEVRKFRL.js";import"./chunk-QOIXNWQR.js";import"./chunk-GZKFETP5.js";import"./chunk-HRRFKWPZ.js";import"./chunk-YULZRALL.js";import"./chunk-HGFDYOVB.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";export{a as hierarchy,b as ownershipChain};
+//# sourceMappingURL=hierarchy-6W5NDIFI.js.map

package/dist/imports-WH365QY4.js

@@ -0,0 +1,2 @@
+import{a,b,c}from"./chunk-IZJ6YUKP.js";import"./chunk-S6CZA3MV.js";import"./chunk-OGFV2BUX.js";import"./chunk-65245JCM.js";import"./chunk-NJJMVD65.js";import"./chunk-WRQXLNYE.js";import"./chunk-LOVIZBJ4.js";import"./chunk-QXEUDXBT.js";import"./chunk-TRBI4UKT.js";import"./chunk-WKPV2TDZ.js";import"./chunk-F4FNK44D.js";import"./chunk-ZLADLUE6.js";import"./chunk-6FFVZZL4.js";import"./chunk-4XQ4O6IM.js";import"./chunk-BZB4QPIP.js";import"./chunk-CN5EH7O3.js";import"./chunk-T3I6NHBH.js";import"./chunk-J5FJMODQ.js";import"./chunk-WOFQ5DTB.js";import"./chunk-PH52RA7D.js";import"./chunk-7Y5T6XDP.js";import"./chunk-X6RMKHJQ.js";import"./chunk-JEVRKFRL.js";import"./chunk-QOIXNWQR.js";import"./chunk-GZKFETP5.js";import"./chunk-3JIQS44J.js";import"./chunk-O4UZSPPI.js";import"./chunk-B3PYOSCX.js";import"./chunk-HRRFKWPZ.js";import"./chunk-YULZRALL.js";import"./chunk-HGFDYOVB.js";import"./chunk-QZ7KQZRN.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";export{b as importedBy,a as imports,c as unusedImports};
+//# sourceMappingURL=imports-WH365QY4.js.map

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { S as ScipDatabase } from './db-BwIVAYNB.js';
+import { C as CalleeRow, a as CalleeEvidenceSource } from './call-graph-evidence-CUtj8V2I.js';
 import { I as IndexedDefinition, S as SymbolMatch, a as ScipSymbol, b as ScipLocalSymbol } from './symbol-types-BIQwfoAx.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-B9B60MiR.js';
 import 'better-sqlite3';
 
@@ -109,6 +109,18 @@ declare class ProjectIndex {
         additive?: boolean;
         semantic?: boolean;
     }): Map<number, CalleeRow[]>;
+    /** The same invocation filter and evidence calibration used by the public call graph. */
+    callableCallees(definition: SymbolMatch, opts?: {
+        semantic?: boolean;
+    }): {
+        evidenceStrength: "exact" | "candidate";
+        symbol: string;
+        file: string;
+        chunkId: number;
+        source: CalleeEvidenceSource;
+        callsiteLine?: number;
+        kind?: "jsx-render";
+    }[];
     crossFileCallerMap(definitions?: ReadonlyArray<SymbolMatch>, opts?: {
         semantic?: boolean;
     }): Map<number, Set<string>>;

package/dist/index.js

@@ -1,2 +1,2 @@
-import{a as e}from"./chunk-WDNVY4E7.js";import{x as m}from"./chunk-5ENOG4VP.js";import{c as p}from"./chunk-CJZXN4NU.js";import"./chunk-BGBBVSH4.js";import"./chunk-W7CXK74K.js";import"./chunk-NWQXSFFU.js";import"./chunk-P5XHIJHI.js";import"./chunk-E73UNJTF.js";import"./chunk-WB3WYIRE.js";import"./chunk-DYGHBZ2N.js";import"./chunk-KK7GPALL.js";import"./chunk-OSSESPDX.js";import"./chunk-TRNAEQ6P.js";import"./chunk-XRYABF57.js";import"./chunk-NJITK2GP.js";import"./chunk-YUKYB54I.js";import"./chunk-DHEQMPLW.js";import"./chunk-TEBQMNVI.js";import"./chunk-MTDBHTSF.js";import{b as o,d as r,e as t}from"./chunk-N2ZSIIGR.js";import"./chunk-ODDUPDP7.js";import"./chunk-ZOHS7AQV.js";import"./chunk-FESCRNVV.js";import"./chunk-JWTGMPIT.js";import"./chunk-N5B2NILC.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-NLOQOBXI.js";import{a as m}from"./chunk-J2TMAIN5.js";import"./chunk-PKN354TH.js";import{b as p}from"./chunk-6LSEIIF7.js";import"./chunk-BGBBVSH4.js";import"./chunk-36SGVCGX.js";import"./chunk-AGWFSTXC.js";import"./chunk-P5XHIJHI.js";import"./chunk-73AAKPUC.js";import"./chunk-KZBJWZJB.js";import"./chunk-4WTUBQ36.js";import"./chunk-NZAXKGRL.js";import"./chunk-KK7GPALL.js";import"./chunk-YNQCGEQE.js";import"./chunk-FMRN2TRL.js";import"./chunk-DA7RPPDF.js";import"./chunk-4WCUBZU3.js";import"./chunk-E3FDPXZK.js";import"./chunk-DHEQMPLW.js";import"./chunk-KHWRRPV4.js";import"./chunk-72AD6ZRR.js";import"./chunk-YUKYB54I.js";import"./chunk-GCKCF5FL.js";import"./chunk-DVFP6PZI.js";import{b as o,d as r,e as t}from"./chunk-5D2LVK7O.js";import"./chunk-7WTPQ4NX.js";import"./chunk-FVULPZDF.js";import"./chunk-D3FDISIC.js";import"./chunk-A2IIGFMJ.js";import"./chunk-PH52RA7D.js";import"./chunk-GVWX5T43.js";import"./chunk-T6DK3ZP7.js";import"./chunk-5TNQJUR2.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-K3PHMF5S.js

@@ -0,0 +1,2 @@
+import{a}from"./chunk-4D6RO7G4.js";import"./chunk-QXEUDXBT.js";import"./chunk-J5FJMODQ.js";import"./chunk-WOFQ5DTB.js";import"./chunk-PH52RA7D.js";import"./chunk-7Y5T6XDP.js";import"./chunk-X6RMKHJQ.js";import"./chunk-JEVRKFRL.js";import"./chunk-QOIXNWQR.js";import"./chunk-GZKFETP5.js";import"./chunk-HRRFKWPZ.js";import"./chunk-YULZRALL.js";import"./chunk-HGFDYOVB.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";export{a as members};
+//# sourceMappingURL=members-K3PHMF5S.js.map

package/dist/methods-E7KVMBX4.js

@@ -0,0 +1,2 @@
+import{a,b}from"./chunk-P6ODM7BY.js";import"./chunk-TZCVNCAN.js";import"./chunk-BGBBVSH4.js";import"./chunk-7VPEEAAG.js";import"./chunk-S6CZA3MV.js";import"./chunk-65245JCM.js";import"./chunk-NJJMVD65.js";import"./chunk-H73WY2RM.js";import"./chunk-ZHMRSZFD.js";import"./chunk-ZGTYGDMF.js";import"./chunk-WRQXLNYE.js";import"./chunk-DVFP6PZI.js";import"./chunk-QIWXRW72.js";import"./chunk-LOVIZBJ4.js";import"./chunk-QXEUDXBT.js";import"./chunk-O2C4UILI.js";import"./chunk-WXU3DGPU.js";import"./chunk-YUKYB54I.js";import"./chunk-TRBI4UKT.js";import"./chunk-WKPV2TDZ.js";import"./chunk-F4FNK44D.js";import"./chunk-ZLADLUE6.js";import"./chunk-6FFVZZL4.js";import"./chunk-DHEQMPLW.js";import"./chunk-4XQ4O6IM.js";import"./chunk-BZB4QPIP.js";import"./chunk-CN5EH7O3.js";import"./chunk-T3I6NHBH.js";import"./chunk-J5FJMODQ.js";import"./chunk-WOFQ5DTB.js";import"./chunk-PH52RA7D.js";import"./chunk-7Y5T6XDP.js";import"./chunk-X6RMKHJQ.js";import"./chunk-JEVRKFRL.js";import"./chunk-QOIXNWQR.js";import"./chunk-GZKFETP5.js";import"./chunk-3JIQS44J.js";import"./chunk-O4UZSPPI.js";import"./chunk-B3PYOSCX.js";import"./chunk-HRRFKWPZ.js";import"./chunk-YULZRALL.js";import"./chunk-HGFDYOVB.js";import"./chunk-QZ7KQZRN.js";import"./chunk-TKD34PHN.js";import"./chunk-2HLAFUCY.js";import"./chunk-U5RIG3JP.js";import"./chunk-62BDNPMI.js";export{b as methods,a as resolveMethods};
+//# sourceMappingURL=methods-E7KVMBX4.js.map

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

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{a}from"./chunk-XHMN6ZX7.js";import"./chunk-B56T42J3.js";import"./chunk-JYWEX7RR.js";import"./chunk-OZCJXZK6.js";export{a as outputContinuationCommandDescriptor};
+//# sourceMappingURL=output-continuation-command-BJSY67SN.js.map

package/dist/output-pagination-UZJ5ACIX.js

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

package/dist/postinstall.js

@@ -1,3 +1,3 @@
 #!/usr/bin/env node
-import"./chunk-LEECKFCJ.js";import"./chunk-F4FNK44D.js";import"./chunk-WYPL7GF7.js";import"./chunk-3AF4TUFK.js";import"./chunk-B3PYOSCX.js";import"./chunk-JFMEXGFE.js";import"./chunk-7F45LJKI.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();
+import"./chunk-VX2O4RIS.js";import"./chunk-F4FNK44D.js";import"./chunk-YTAP5Y2G.js";import"./chunk-BL6XJKTA.js";import"./chunk-B3PYOSCX.js";import"./chunk-QZ7KQZRN.js";import"./chunk-2HLAFUCY.js";import"./chunk-62BDNPMI.js";import{existsSync as i,mkdirSync as e,symlinkSync as r,readlinkSync as l,unlinkSync as o,readdirSync as c}from"fs";import{join as a,dirname as p,resolve as d,relative as g,isAbsolute as f}from"path";import{homedir as S,platform as s}from"os";import{fileURLToPath as h}from"url";var $=s()==="win32";function n(){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.")}n();
 //# sourceMappingURL=postinstall.js.map

package/dist/project-reindex-EP24WT4X.js

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+import{r as a}from"./chunk-CFYMZFXT.js";import"./chunk-OZCJXZK6.js";export{a as reindexConfiguredProject};
+//# sourceMappingURL=project-reindex-EP24WT4X.js.map

package/dist/queries/affected.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-YU5DZUZI.js";import"../chunk-W7CXK74K.js";import"../chunk-NWQXSFFU.js";import"../chunk-P5XHIJHI.js";import"../chunk-E73UNJTF.js";import"../chunk-WB3WYIRE.js";import"../chunk-DYGHBZ2N.js";import"../chunk-KK7GPALL.js";import"../chunk-OSSESPDX.js";import"../chunk-TRNAEQ6P.js";import"../chunk-TEBQMNVI.js";import"../chunk-MTDBHTSF.js";import"../chunk-N2ZSIIGR.js";import"../chunk-ODDUPDP7.js";import"../chunk-ZOHS7AQV.js";import"../chunk-FESCRNVV.js";import"../chunk-JWTGMPIT.js";import"../chunk-N5B2NILC.js";export{a as affected,b as possibleImpactClosure};
+import{a,b}from"../chunk-ZHSP366W.js";import"../chunk-36SGVCGX.js";import"../chunk-AGWFSTXC.js";import"../chunk-P5XHIJHI.js";import"../chunk-73AAKPUC.js";import"../chunk-KZBJWZJB.js";import"../chunk-4WTUBQ36.js";import"../chunk-NZAXKGRL.js";import"../chunk-KK7GPALL.js";import"../chunk-YNQCGEQE.js";import"../chunk-FMRN2TRL.js";import"../chunk-DA7RPPDF.js";import"../chunk-KHWRRPV4.js";import"../chunk-72AD6ZRR.js";import"../chunk-YUKYB54I.js";import"../chunk-GCKCF5FL.js";import"../chunk-DVFP6PZI.js";import"../chunk-5D2LVK7O.js";import"../chunk-7WTPQ4NX.js";import"../chunk-FVULPZDF.js";import"../chunk-D3FDISIC.js";import"../chunk-A2IIGFMJ.js";import"../chunk-PH52RA7D.js";import"../chunk-GVWX5T43.js";import"../chunk-T6DK3ZP7.js";import"../chunk-5TNQJUR2.js";export{a as affected,b as possibleImpactClosure};
 //# sourceMappingURL=affected.js.map

package/dist/queries/architecture.d.ts

@@ -26,8 +26,7 @@ interface ArchitectureBoundaryEdge {
     examples: ArchitectureFileEdge[];
     /**
      * True when the entire boundary dependency rests on a single import. Not a
-     * violation — a signal that the edge is incidental rather than load-bearing,
-     * and therefore cheap to remove if it was never intended.
+     * violation. Import count alone does not establish responsibility or removal cost.
      */
     fragile: boolean;
 }
@@ -47,6 +46,8 @@ interface ArchitectureReciprocalPair {
     reverse: ArchitectureBoundaryEdge;
 }
 interface ArchitectureCycle {
+    fileCycleMembers?: string[];
+    origin?: 'contains-file-cycle' | 'grouping-only';
     boundaries: string[];
     internalEdges: ArchitectureBoundaryEdge[];
     /** Least-broad internal edge(s), useful as inspection points rather than automatic repairs. */
@@ -54,6 +55,8 @@ interface ArchitectureCycle {
     violatesPolicy: boolean;
 }
 interface ArchitectureCoverage {
+    scope?: string;
+    limitations?: string[];
     totalFiles: number;
     mappedFiles: number;
     unmappedFiles: string[];
@@ -99,19 +102,26 @@ interface ArchitectureCoarseBoundary {
     violatesPolicy: boolean;
     subUnits: string[];
     internalEdges: ArchitectureSubUnitEdge[];
-    /** Least-broad internal edge(s) — the cheapest inspection points. */
+    /** Internal edges with the fewest distinct file dependencies; cost is not measured. */
     narrowestEdges: ArchitectureSubUnitEdge[];
 }
 interface ArchitectureReport {
+    dependencyRoles?: {
+        excludedTestEdges: number;
+        basis: 'production-imports-including-types';
+        cycleMeaning: string;
+    };
     configured: boolean;
     boundaries: ArchitectureBoundarySummary[];
     edges: ArchitectureBoundaryEdge[];
     forbiddenEdges: ArchitectureBoundaryEdge[];
+    testEdges?: ArchitectureBoundaryEdge[];
+    testForbiddenEdges?: ArchitectureBoundaryEdge[];
     reciprocalPairs: ArchitectureReciprocalPair[];
     cycles: ArchitectureCycle[];
     /** Boundaries hiding an internal cycle that the boundary graph cannot express. */
     coarseBoundaries: ArchitectureCoarseBoundary[];
-    /** Declared allowances with no observed edge — policy wider than reality. */
+    /** Declared allowances with no observed edge from a boundary with observed source files. */
     staleAllowances: ArchitectureStaleAllowance[];
     /** Boundaries over a configured fan-out or file-count limit. */
     boundaryLimits: ArchitectureBoundaryLimit[];
@@ -131,6 +141,7 @@ declare const ARCHITECTURE_BASELINE_PREFIX = "architecture:";
 declare function analyzeArchitectureGraph(fileGraph: ReadonlyMap<string, ReadonlySet<string>>, indexedFiles: readonly string[], config?: ArchitectureConfig, opts?: {
     isModuleHierarchyFile?: (file: string) => boolean;
     testBoundaryViolations?: TestBoundaryViolation[];
+    scope?: string;
 }): ArchitectureReport;
 /** Build and analyze the current project's import dependency graph. */
 declare function architecture(db: ScipDatabase, opts?: {

package/dist/queries/architecture.js

@@ -1,2 +1,2 @@
-import{b as a,c as b,d as c,e as d,f as e,g as f}from"../chunk-GSP44ENC.js";import"../chunk-SV2LEFVM.js";import"../chunk-35NLDRZC.js";import"../chunk-XRYABF57.js";import"../chunk-NJITK2GP.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-TEBQMNVI.js";import"../chunk-N2ZSIIGR.js";import"../chunk-ODDUPDP7.js";import"../chunk-ZOHS7AQV.js";import"../chunk-FESCRNVV.js";import"../chunk-JWTGMPIT.js";import"../chunk-N5B2NILC.js";export{a as ARCHITECTURE_BASELINE_PREFIX,b as analyzeArchitectureGraph,c as architecture,d as architectureFindingIdentities,f as detectCoarseBoundaries,e as hasEnforceableArchitecturePolicy};
+import{e as a,f as b,g as c,h as d,i as e,j as f}from"../chunk-ETOIKRHO.js";import"../chunk-SV2LEFVM.js";import"../chunk-HXENDJC6.js";import"../chunk-2IWUT6CJ.js";import"../chunk-4WCUBZU3.js";import"../chunk-E3FDPXZK.js";import"../chunk-DHEQMPLW.js";import"../chunk-KHWRRPV4.js";import"../chunk-72AD6ZRR.js";import"../chunk-YUKYB54I.js";import"../chunk-GCKCF5FL.js";import"../chunk-5D2LVK7O.js";import"../chunk-7WTPQ4NX.js";import"../chunk-FVULPZDF.js";import"../chunk-D3FDISIC.js";import"../chunk-A2IIGFMJ.js";import"../chunk-PH52RA7D.js";import"../chunk-GVWX5T43.js";import"../chunk-T6DK3ZP7.js";import"../chunk-5TNQJUR2.js";export{a as ARCHITECTURE_BASELINE_PREFIX,b as analyzeArchitectureGraph,c as architecture,d as architectureFindingIdentities,f as detectCoarseBoundaries,e as hasEnforceableArchitecturePolicy};
 //# sourceMappingURL=architecture.js.map

package/dist/queries/bottlenecks.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-YPWBKGFU.js";import"../chunk-BOJ5SVE2.js";import"../chunk-CJZXN4NU.js";import"../chunk-BGBBVSH4.js";import"../chunk-W7CXK74K.js";import"../chunk-NWQXSFFU.js";import"../chunk-P5XHIJHI.js";import"../chunk-E73UNJTF.js";import"../chunk-WB3WYIRE.js";import"../chunk-DYGHBZ2N.js";import"../chunk-KK7GPALL.js";import"../chunk-OSSESPDX.js";import"../chunk-TRNAEQ6P.js";import"../chunk-XRYABF57.js";import"../chunk-NJITK2GP.js";import"../chunk-YUKYB54I.js";import"../chunk-DHEQMPLW.js";import"../chunk-TEBQMNVI.js";import"../chunk-MTDBHTSF.js";import"../chunk-N2ZSIIGR.js";import"../chunk-ODDUPDP7.js";import"../chunk-ZOHS7AQV.js";import"../chunk-FESCRNVV.js";import"../chunk-JWTGMPIT.js";import"../chunk-N5B2NILC.js";export{a as bottlenecks,b as coordinationHubs};
+import{a,b}from"../chunk-WS4C6TCK.js";import"../chunk-BOJ5SVE2.js";import"../chunk-6LSEIIF7.js";import"../chunk-BGBBVSH4.js";import"../chunk-36SGVCGX.js";import"../chunk-AGWFSTXC.js";import"../chunk-P5XHIJHI.js";import"../chunk-73AAKPUC.js";import"../chunk-KZBJWZJB.js";import"../chunk-4WTUBQ36.js";import"../chunk-NZAXKGRL.js";import"../chunk-KK7GPALL.js";import"../chunk-YNQCGEQE.js";import"../chunk-FMRN2TRL.js";import"../chunk-DA7RPPDF.js";import"../chunk-4WCUBZU3.js";import"../chunk-E3FDPXZK.js";import"../chunk-DHEQMPLW.js";import"../chunk-KHWRRPV4.js";import"../chunk-72AD6ZRR.js";import"../chunk-YUKYB54I.js";import"../chunk-GCKCF5FL.js";import"../chunk-DVFP6PZI.js";import"../chunk-5D2LVK7O.js";import"../chunk-7WTPQ4NX.js";import"../chunk-FVULPZDF.js";import"../chunk-D3FDISIC.js";import"../chunk-A2IIGFMJ.js";import"../chunk-PH52RA7D.js";import"../chunk-GVWX5T43.js";import"../chunk-T6DK3ZP7.js";import"../chunk-5TNQJUR2.js";export{a as bottlenecks,b as coordinationHubs};
 //# sourceMappingURL=bottlenecks.js.map

package/dist/queries/by-kind.js

@@ -1,2 +1,2 @@
-import{a,b}from"../chunk-QBE3YX64.js";import"../chunk-MTDBHTSF.js";import"../chunk-N2ZSIIGR.js";import"../chunk-ODDUPDP7.js";import"../chunk-ZOHS7AQV.js";import"../chunk-FESCRNVV.js";import"../chunk-JWTGMPIT.js";import"../chunk-N5B2NILC.js";export{a as byKind,b as kindCounts};
+import{a,b}from"../chunk-Z33WQG4Q.js";import"../chunk-DVFP6PZI.js";import"../chunk-5D2LVK7O.js";import"../chunk-7WTPQ4NX.js";import"../chunk-FVULPZDF.js";import"../chunk-D3FDISIC.js";import"../chunk-A2IIGFMJ.js";import"../chunk-PH52RA7D.js";import"../chunk-GVWX5T43.js";import"../chunk-T6DK3ZP7.js";import"../chunk-5TNQJUR2.js";export{a as byKind,b as kindCounts};
 //# sourceMappingURL=by-kind.js.map

package/dist/queries/call-graph.d.ts

@@ -6,9 +6,11 @@ interface CallGraphEvidenceRow {
     symbol: string;
     shortName: string;
     file: string;
-    relationship: 'resolved-call' | 'reference-candidate' | 'chunk-candidate';
+    relationship: 'resolved-call' | 'source-call-candidate' | 'reference-candidate' | 'chunk-candidate';
     evidenceStrength: 'exact' | 'candidate';
     evidenceSource: string;
+    /** `render` when the edge is a rendered component element (`<Child />`) rather than a call expression. */
+    interaction?: 'render';
 }
 interface CallGraphResult {
     symbol: string;

package/dist/queries/call-graph.js

@@ -1,2 +1,2 @@
-import{a}from"../chunk-ZF5KHH7C.js";import"../chunk-BOJ5SVE2.js";import"../chunk-BGBBVSH4.js";import"../chunk-W7CXK74K.js";import"../chunk-NWQXSFFU.js";import"../chunk-P5XHIJHI.js";import"../chunk-E73UNJTF.js";import"../chunk-WB3WYIRE.js";import"../chunk-DYGHBZ2N.js";import"../chunk-KK7GPALL.js";import"../chunk-OSSESPDX.js";import"../chunk-TRNAEQ6P.js";import"../chunk-TEBQMNVI.js";import"../chunk-MTDBHTSF.js";import"../chunk-N2ZSIIGR.js";import"../chunk-ODDUPDP7.js";import"../chunk-ZOHS7AQV.js";import"../chunk-FESCRNVV.js";import"../chunk-JWTGMPIT.js";import"../chunk-N5B2NILC.js";export{a as callGraph};
+import{a}from"../chunk-F4LUHJTF.js";import"../chunk-BOJ5SVE2.js";import"../chunk-BGBBVSH4.js";import"../chunk-36SGVCGX.js";import"../chunk-AGWFSTXC.js";import"../chunk-P5XHIJHI.js";import"../chunk-73AAKPUC.js";import"../chunk-KZBJWZJB.js";import"../chunk-4WTUBQ36.js";import"../chunk-NZAXKGRL.js";import"../chunk-KK7GPALL.js";import"../chunk-YNQCGEQE.js";import"../chunk-FMRN2TRL.js";import"../chunk-DA7RPPDF.js";import"../chunk-KHWRRPV4.js";import"../chunk-72AD6ZRR.js";import"../chunk-YUKYB54I.js";import"../chunk-GCKCF5FL.js";import"../chunk-DVFP6PZI.js";import"../chunk-5D2LVK7O.js";import"../chunk-7WTPQ4NX.js";import"../chunk-FVULPZDF.js";import"../chunk-D3FDISIC.js";import"../chunk-A2IIGFMJ.js";import"../chunk-PH52RA7D.js";import"../chunk-GVWX5T43.js";import"../chunk-T6DK3ZP7.js";import"../chunk-5TNQJUR2.js";export{a as callGraph};
 //# sourceMappingURL=call-graph.js.map

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

@@ -31,6 +31,7 @@ interface ChangeSurfaceEntry {
 interface ChangeSurfaceResult {
     file: string;
     symbols: ChangeSurfaceEntry[];
+    /** Distinct consumer files across all selected symbols, not a sum of per-symbol counts. */
     totalExternalConsumers: number;
     fileRisk?: FileChangeRiskMetadata;
 }