gitnexus 1.6.8-rc.9 → 1.6.8

package/dist/core/ingestion/cfg/reaching-defs.js

@@ -0,0 +1,785 @@
+import { buildDominanceFrontiers, buildDominators, condenseReachingSets, hasReachableLoop, latticeEquals, reversePostOrder, tarjanScc, unionSets, } from './reaching-defs-graph.js';
+/**
+ * Canonical `block:stmt` string key for a program point. Colon-separated to
+ * match the codebase's `blockIndex:stmtIndex` id conventions. Shared by the
+ * taint propagation engine (dedup/state keys) and the taint emit path
+ * (persisted edge-id material) so the two never drift.
+ */
+export function pointKey(p) {
+    return `${p.blockIndex}:${p.stmtIndex}`;
+}
+/**
+ * def-site key: packs (blockIndex, stmtIndex) into one number. The stride is
+ * a per-BLOCK statement bound, and `maxFunctionLines` caps LINES, not
+ * statements — a minified one-line function coalesces arbitrarily many
+ * statements into one block, so an overflow would silently alias
+ * (block b, stmt STRIDE+k) with (block b+1, stmt k) and fabricate wrong-block
+ * facts. computeReachingDefs therefore range-checks up front and bails to a
+ * sound empty `overflow` result instead of ever letting a key alias.
+ * 2^21 statements per block × blocks ≤ 2^32 stays inside Number's 2^53.
+ */
+const STMT_STRIDE = 1 << 21;
+const defKey = (blockIndex, stmtIndex) => blockIndex * STMT_STRIDE + stmtIndex;
+const EMPTY_LATTICE = new Map();
+/**
+ * Compute reaching definitions for one function. See the module doc for the
+ * purity/determinism/sharing contract.
+ *
+ * This is the production entry point. As of #2201 it auto-dispatches via
+ * {@link computeInSetsAuto} — the SSA-sparse solver ({@link computeInSetsSparse})
+ * for looping functions large enough to amortize construction, the dense
+ * GEN/KILL worklist ({@link computeInSetsDense}) everywhere else (and for the
+ * throw-edge / unreachable-block functions the SSA path does not model). The two
+ * solvers are held byte-identical by the equivalence fuzz (status, bindings,
+ * sorted facts, def/use telemetry), so the dispatch is a pure performance
+ * heuristic; the dense solver doubles as that differential oracle.
+ */
+export function computeReachingDefs(cfg, limits) {
+    // #2201: production auto-selects the solver per function (see
+    // {@link computeInSetsAuto}) — the SSA solver where it pays off (looping
+    // functions large enough to amortize construction, incl. the deep nests the
+    // dense ceiling used to truncate), the dense worklist everywhere else (small
+    // or loop-free functions, where it is faster). Both are held byte-identical
+    // by the equivalence fuzz, so the choice is a pure performance heuristic.
+    return solveReachingDefs(cfg, limits, computeInSetsAuto);
+}
+/**
+ * Per-file memoized reaching-defs solver (#2227 tri-review, U12). Under `--pdg`
+ * the SAME per-function RD fixpoint was solved 3–4× per analyze (RD emit +
+ * call-summary harvest + taint + summary harvest). Cache by (cfg identity,
+ * limits) so each DISTINCT solve runs once: the RD-emit bucket (passes
+ * `maxBlockVisits`) and the harvest/taint bucket (does not) stay byte-identical
+ * to their inline solves because the limits are part of the key. Lazy — solves
+ * on first request, so the taint zero-match fast path still skips its solve.
+ * Create one per FILE and drop it after the file to bound the per-function
+ * `facts` arrays (100k+ objects on a huge function) from going whole-repo.
+ */
+export function createMemoizedReachingDefs() {
+    const cache = new Map();
+    return (cfg, limits) => {
+        const key = `${limits?.maxFacts ?? ''}|${limits?.maxBlockVisits ?? ''}`;
+        let byKey = cache.get(cfg);
+        if (byKey === undefined) {
+            byKey = new Map();
+            cache.set(cfg, byKey);
+        }
+        const hit = byKey.get(key);
+        if (hit !== undefined)
+            return hit;
+        const result = computeReachingDefs(cfg, limits);
+        byKey.set(key, result);
+        return result;
+    };
+}
+/**
+ * Dense GEN/KILL monotone worklist — the original (#2082 M2) reaching-defs
+ * solver. As of #2201 it plays two roles: (1) the production dispatcher
+ * ({@link computeInSetsAuto}) routes small / loop-free functions, and the
+ * throw-edge / unreachable-block functions the SSA path does not model, to this
+ * dense solver; (2) it is the differential equivalence ORACLE the fuzz checks
+ * the SSA path against. Keep it behavior-frozen — it is the ground truth.
+ *
+ * @internal exported for the equivalence fuzz harness (direct dense-vs-sparse
+ * comparison); the bench drives the production {@link computeReachingDefs}.
+ */
+export function computeReachingDefsDense(cfg, limits) {
+    return solveReachingDefs(cfg, limits, computeInSetsDense);
+}
+/**
+ * SSA-sparse reaching-defs (#2201) — exposed directly so the equivalence fuzz
+ * can drive the SSA solver on every eligible CFG (bypassing the production
+ * size/loop dispatch heuristic in {@link computeInSetsAuto}) and assert
+ * byte-identity against the dense oracle. See {@link computeInSetsSparse} for
+ * the algorithm and byte-identical contract.
+ *
+ * @internal exported only for the equivalence fuzz harness.
+ */
+export function computeReachingDefsSparse(cfg, limits) {
+    return solveReachingDefs(cfg, limits, computeInSetsSparse);
+}
+/**
+ * Shared orchestrator: the no-facts / overflow guards, the harvest, the
+ * adjacency build, the swappable IN-set computation, and the statement sweep.
+ * Only `computeInSets` differs between the production (sparse) and oracle
+ * (dense) paths — everything else is identical, which is what makes the two
+ * byte-identical by construction.
+ */
+function solveReachingDefs(cfg, limits, computeInSets) {
+    if (!cfg.bindings) {
+        return { status: 'no-facts', bindings: [], facts: [], defCount: 0, useCount: 0 };
+    }
+    const blocks = cfg.blocks;
+    const n = blocks.length;
+    // Key-aliasing guard (see STMT_STRIDE): a block with ≥ STRIDE statements
+    // cannot be keyed without aliasing into the next block's def sites, which
+    // would fabricate wrong-block facts — strictly worse than producing none.
+    // Bail to a sound empty `overflow` result (the emit path warns distinctly).
+    for (const b of blocks) {
+        if ((b.statements?.length ?? 0) >= STMT_STRIDE) {
+            return { status: 'overflow', bindings: cfg.bindings, facts: [], defCount: 0, useCount: 0 };
+        }
+    }
+    const h = harvestStatementFacts(blocks, n);
+    const adj = buildAdjacency(cfg, n);
+    const solved = computeInSets(cfg, n, h, adj, limits);
+    if (!solved.converged) {
+        // Did NOT converge within the budget — the in-sets are not at the fixpoint,
+        // so any facts would be unsound. Bail to a sound empty `truncated` result
+        // (a coverage gap, not an error), carrying the def/use telemetry gathered.
+        return {
+            status: 'truncated',
+            bindings: cfg.bindings,
+            facts: [],
+            defCount: h.defCount,
+            useCount: h.useCount,
+        };
+    }
+    const maxFacts = limits?.maxFacts && limits.maxFacts > 0 ? limits.maxFacts : Infinity;
+    const { facts, truncated } = sweepFacts(blocks, solved.reachingAt, h.defLine, maxFacts);
+    return {
+        status: truncated ? 'truncated' : 'computed',
+        bindings: cfg.bindings,
+        facts,
+        defCount: h.defCount,
+        useCount: h.useCount,
+    };
+}
+/**
+ * Per-block GEN + def/use telemetry. gen[b]: bindingIdx → { set, kills }. A
+ * MUST def resets the accumulated set (kill is total); a MAY def (conditionally-
+ * evaluated context — see StatementFacts.mayDefs) only ADDS: the binding's
+ * incoming defs survive, so the transfer is out[x] = kills ? set : in[x] ∪ set.
+ * allDefsGen[b] is what a throw edge delivers to its handler: an exception can
+ * fire between any two statements, so every intermediate def may be the live one
+ * at the handler — IN∪OUT alone misses defs overwritten later in the same
+ * coalesced block.
+ */
+function harvestStatementFacts(blocks, n) {
+    const gen = new Array(n).fill(null);
+    const allDefsGen = new Array(n).fill(null);
+    const defLine = new Map(); // defKey → source line
+    let defCount = 0;
+    let useCount = 0;
+    for (const b of blocks) {
+        const stmts = b.statements;
+        if (!stmts || stmts.length === 0)
+            continue;
+        let g = null;
+        let all = null;
+        for (let i = 0; i < stmts.length; i++) {
+            const s = stmts[i];
+            useCount += s.uses.length;
+            const key = defKey(b.index, i);
+            const record = (d, kills) => {
+                defCount += 1;
+                defLine.set(key, s.line);
+                if (!g)
+                    g = new Map();
+                const entry = g.get(d);
+                if (kills || !entry) {
+                    g.set(d, { set: new Set([key]), kills: kills || (entry?.kills ?? false) });
+                }
+                else {
+                    entry.set.add(key); // may-def accumulates; never clears
+                }
+                if (!all)
+                    all = new Map();
+                const allSet = all.get(d);
+                if (allSet)
+                    allSet.add(key);
+                else
+                    all.set(d, new Set([key]));
+            };
+            if (s.mayDefs)
+                for (const d of s.mayDefs)
+                    record(d, false);
+            for (const d of s.defs)
+                record(d, true);
+        }
+        gen[b.index] = g;
+        allDefsGen[b.index] = all;
+    }
+    return { gen, allDefsGen, defLine, defCount, useCount };
+}
+/**
+ * Throw-aware predecessor/successor adjacency, sorted for deterministic merges.
+ * A `throw` edge contributes IN(from) ∪ allDefs(from) to its handler, not OUT:
+ * an exception may fire BEFORE the block's defs complete (the seed def in
+ * `let x = seed(); try { x = risky(); } catch { sink(x) }` must reach the sink)
+ * AND between any two defs of a multi-def coalesced block. Sound over-
+ * approximation; monotone, so the fixpoint absorbs it. See mergePreds.
+ */
+function buildAdjacency(cfg, n) {
+    const preds = Array.from({ length: n }, () => []);
+    const succs = Array.from({ length: n }, () => []);
+    // Handlers whose IN depends on this block's IN (throw edges) — requeued on
+    // IN change, since a genned binding can absorb IN growth without changing
+    // OUT, which would otherwise leave the handler stale.
+    const throwSuccs = Array.from({ length: n }, () => []);
+    for (const e of cfg.edges) {
+        // Optional-chained pushes drop out-of-range endpoints defensively — the
+        // emit path validates via isEmitSafeCfg, but this pure function also runs
+        // on hand-built CFGs.
+        succs[e.from]?.push(e.to);
+        preds[e.to]?.push({ from: e.from, viaThrow: e.kind === 'throw' });
+        if (e.kind === 'throw')
+            throwSuccs[e.from]?.push(e.to);
+    }
+    for (const list of preds) {
+        list.sort((a, b) => a.from - b.from || Number(a.viaThrow) - Number(b.viaThrow));
+        // duplicate (from, throw+non-throw) pairs both survive — the throw leg
+        // adds IN(from); the merge dedups set-wise.
+    }
+    for (const list of succs)
+        list.sort((a, b) => a - b);
+    return { preds, succs, throwSuccs };
+}
+/**
+ * DENSE IN-set computer — the original monotone GEN/KILL worklist. Iterates in
+ * reverse post-order, seeded with every block (unreachable blocks keep ⊥ IN —
+ * correct, their defs reach nothing). Convergence: sets grow monotonically
+ * within the finite def-site universe ⇒ ≤ loop-depth+1 passes in practice.
+ *
+ * WTO / loop-aware iteration (Bourdoncle 1993) was evaluated as a fix for the
+ * O(blocks²) deep-loop-nest blow-up and REJECTED (#2195): on the dense-loop
+ * benchmark a faithful weak-topological-order solver was 104/104 byte-identical
+ * but 0% faster — the cost is inherent to dense-set propagation + lattice
+ * merges, not visitation order. The asymptotic fix shipped in #2201: the
+ * SSA-sparse solver ({@link computeInSetsSparse}). This dense version is retained
+ * only as the differential equivalence oracle the fuzz checks SSA against.
+ *
+ * @internal
+ */
+function computeInSetsDense(cfg, n, h, adj, limits) {
+    const { gen, allDefsGen } = h;
+    const { preds, succs, throwSuccs } = adj;
+    const { order } = reversePostOrder(cfg.entryIndex, succs, n);
+    const inSets = new Array(n).fill(EMPTY_LATTICE);
+    const outSets = new Array(n).fill(EMPTY_LATTICE);
+    const inWorklist = new Array(n).fill(true);
+    let pending = n;
+    const maxBlockVisits = limits?.maxBlockVisits && limits.maxBlockVisits > 0 ? limits.maxBlockVisits : Infinity;
+    let blockVisits = 0;
+    while (pending > 0) {
+        for (const b of order) {
+            if (!inWorklist[b])
+                continue;
+            inWorklist[b] = false;
+            pending -= 1;
+            if (++blockVisits > maxBlockVisits)
+                return { converged: false };
+            const p = preds[b];
+            const inB = p.length === 0
+                ? EMPTY_LATTICE
+                : p.length === 1 && !p[0].viaThrow
+                    ? outSets[p[0].from] // alias — zero allocation on straight-line chains
+                    : mergePreds(p, inSets, outSets, allDefsGen);
+            const inChanged = !latticeEquals(inSets[b], inB);
+            inSets[b] = inB;
+            const g = gen[b];
+            // OUT = overlay(IN): a KILLING gen entry replaces the binding's set; a
+            // may-def-only entry unions with the incoming set (never kills). When
+            // nothing is genned, OUT aliases IN outright.
+            let outB;
+            if (!g) {
+                outB = inB;
+            }
+            else {
+                outB = new Map(inB); // copies REFERENCES, never set contents
+                for (const [bindingIdx, entry] of g) {
+                    if (entry.kills) {
+                        outB.set(bindingIdx, entry.set);
+                    }
+                    else {
+                        const incoming = inB.get(bindingIdx);
+                        outB.set(bindingIdx, incoming ? unionSets(incoming, entry.set) : entry.set);
+                    }
+                }
+            }
+            const requeue = (s) => {
+                if (!inWorklist[s]) {
+                    inWorklist[s] = true;
+                    pending += 1;
+                }
+            };
+            if (!latticeEquals(outSets[b], outB)) {
+                outSets[b] = outB;
+                for (const s of succs[b])
+                    requeue(s);
+            }
+            if (inChanged)
+                for (const s of throwSuccs[b])
+                    requeue(s);
+        }
+    }
+    return { converged: true, reachingAt: (blockIndex, binding) => inSets[blockIndex]?.get(binding) };
+}
+/**
+ * SPARSE IN-set computer (#2201) — the production solver. Instead of the dense
+ * GEN/KILL worklist's per-block lattice fixpoint, it builds pruned SSA for the
+ * function (Cooper-Harvey-Kennedy dominators → Cytron dominance frontiers and
+ * φ-placement → stack-based renaming) and answers block-entry reaching-def
+ * queries by walking the SSA def-use graph. φ-nodes statically capture loop
+ * merges, so a use's reaching set is recovered without iterating the loop
+ * (depth-independent), and pass-through blocks carry the dominating definition
+ * via the rename stack rather than re-materializing a dense lattice at every
+ * block — the two effects that make it faster than the dense solver on the
+ * deep-nest and dense-bindings pathologies.
+ *
+ * BYTE-IDENTICAL CONTRACT: it computes the same may-reaching-definition SET at
+ * each block entry as {@link computeInSetsDense}. Order does not matter — {@link
+ * sweepFacts} sorts each use's reaching keys before the maxFacts cutoff (#2201
+ * KTD6) — so only set CONTENTS must match; the equivalence fuzz holds the line.
+ *
+ * SCOPE (KTD4): the SSA path covers fully-reachable CFGs with kill/may-def
+ * transfers, reducible AND irreducible (CHK + Cytron are correct on irreducible
+ * graphs). It does NOT model throw edges' IN∪allDefs handler semantics or
+ * propagation among unreachable blocks; functions with either are routed to the
+ * dense oracle — byte-identical and correct, just not asymptotically faster.
+ * These are not the perf pathologies (deep nests / dense-bindings are
+ * throw-free and fully reachable), so the win lands where it matters.
+ *
+ * No fixpoint iteration ⇒ the solve always converges in O(program); the
+ * `maxBlockVisits` ceiling that fired on the dense worklist's deep nests never
+ * fires here (#2201 acceptance). The bound is honored only on the dense
+ * fallback path.
+ *
+ * @internal
+ */
+function computeInSetsSparse(cfg, n, h, adj, limits) {
+    const nBindings = cfg.bindings?.length ?? 0;
+    if (nBindings === 0)
+        return { converged: true, reachingAt: () => undefined };
+    const { gen } = h;
+    const { preds, succs, throwSuccs } = adj;
+    const entry = cfg.entryIndex;
+    // Gate to the dense oracle for the shapes the SSA path does not model.
+    for (const list of throwSuccs)
+        if (list.length)
+            return computeInSetsDense(cfg, n, h, adj, limits);
+    // Malformed-input guard: an out-of-range binding index (negative or
+    // ≥ nBindings — a corrupted/stale durable parsedfile store) would crash the
+    // SSA path's nBindings-sized arrays (defBlocks[v]/stacks[u]). The dense solver
+    // tolerates any index (its lattice is a Map), so fall back — keeping the two
+    // byte-identical AND preserving the graceful per-function degradation the
+    // dense path gave (a throw here would escape the unguarded taint/harvest call
+    // sites and lose the whole file's taint layer). See hasEmitSafeFacts (emit.ts).
+    for (const b of cfg.blocks) {
+        const stmts = b.statements;
+        if (!stmts)
+            continue;
+        for (const s of stmts) {
+            for (const d of s.defs)
+                if (d < 0 || d >= nBindings)
+                    return computeInSetsDense(cfg, n, h, adj, limits);
+            for (const u of s.uses)
+                if (u < 0 || u >= nBindings)
+                    return computeInSetsDense(cfg, n, h, adj, limits);
+            if (s.mayDefs)
+                for (const d of s.mayDefs)
+                    if (d < 0 || d >= nBindings)
+                        return computeInSetsDense(cfg, n, h, adj, limits);
+        }
+    }
+    // Synthetic pre-entry block (#2201): textbook SSA construction assumes the
+    // entry has no predecessors. A loop back-edge into the entry — or a self-loop
+    // on it — makes the entry a merge that needs a φ, and the dominance-frontier
+    // walk degenerates when idom[entry] === entry (it never lands the entry in its
+    // own frontier). A virtual start node S → entry (S itself has no preds)
+    // restores the invariant: idom[entry] = S, the entry joins {start ⊔
+    // back-edges}, and the implicit start operand contributes ⊥ (an empty rename
+    // stack). S carries no statements, gen, or uses and is never queried.
+    const S = n;
+    const nx = n + 1;
+    const succsX = new Array(nx);
+    for (let b = 0; b < n; b++)
+        succsX[b] = succs[b];
+    succsX[S] = [entry];
+    const dPredsX = new Array(nx);
+    for (let b = 0; b < n; b++) {
+        // preds[b] is pre-sorted by `from` (buildAdjacency), so duplicate `from`
+        // values (a throw + non-throw edge to the same handler, or parallel edges)
+        // are ADJACENT — dedup by skipping consecutive equals instead of a per-block
+        // Set + spread + sort (#2201 review R9). S = n exceeds every block index, so
+        // appending it for the entry keeps the list ascending without a re-sort.
+        const list = [];
+        let last = -1;
+        for (const p of preds[b]) {
+            if (p.from !== last) {
+                list.push(p.from);
+                last = p.from;
+            }
+        }
+        if (b === entry)
+            list.push(S);
+        dPredsX[b] = list;
+    }
+    dPredsX[S] = [];
+    // ── dominators (Cooper-Harvey-Kennedy; correct on irreducible CFGs) ──
+    // RPO rooted at the synthetic entry. `reachX` is the reachability the DFS
+    // already computed — reused for the unreachable-block gate below instead of a
+    // separate BFS (#2201 review R8). Because S→entry is S's only edge, reachX[b]
+    // (b<n) is exactly "reachable from entry", identical to the old BFS gate.
+    const { order: rpo, visited: reachX } = reversePostOrder(S, succsX, nx);
+    // The SSA path does not model propagation among unreachable blocks (KTD4) —
+    // fall back to the dense oracle if any block is unreachable from the entry.
+    for (let b = 0; b < n; b++)
+        if (!reachX[b])
+            return computeInSetsDense(cfg, n, h, adj, limits);
+    const idom = buildDominators(rpo, dPredsX, S, nx);
+    // ── dominance frontiers (Cytron) ──
+    const df = buildDominanceFrontiers(dPredsX, idom, nx);
+    // ── per-binding def blocks (must- or may-def ⇒ block transfer touches v) ──
+    const defBlocks = Array.from({ length: nBindings }, () => []);
+    for (let b = 0; b < n; b++) {
+        const g = gen[b];
+        if (g)
+            for (const v of g.keys())
+                defBlocks[v].push(b);
+    }
+    // ── value-graph nodes: leaves carry def-site keys; internal nodes (φ /
+    //    may-def union) carry operand node ids. reachingSet(node) = union of all
+    //    leaf keys reachable through operands (computed once, cycle-safe, below).
+    const nodeKeys = [];
+    const nodeOps = [];
+    const newLeaf = (keys) => (nodeKeys.push(keys),
+        nodeOps.push([]),
+        nodeKeys.length - 1);
+    const newInternal = () => (nodeKeys.push(null), nodeOps.push([]), nodeKeys.length - 1);
+    // ── φ-placement: φ for v at the iterated dominance frontier of v's defs ──
+    const phiNode = new Array(nx).fill(null);
+    for (let v = 0; v < nBindings; v++) {
+        const dB = defBlocks[v];
+        if (dB.length === 0)
+            continue;
+        const placed = new Set();
+        const inWork = new Set(dB);
+        const work = [...dB];
+        while (work.length) {
+            const x = work.pop();
+            for (const y of df[x]) {
+                if (placed.has(y))
+                    continue;
+                placed.add(y);
+                let m = phiNode[y];
+                if (!m)
+                    phiNode[y] = m = new Map();
+                m.set(v, newInternal());
+                if (!inWork.has(y)) {
+                    inWork.add(y);
+                    work.push(y);
+                }
+            }
+        }
+    }
+    // ── memory bound (#2201 review R1): cap the value graph, else fall back ──
+    // After φ-placement, nodeKeys.length == the φ-node count — the term that grows
+    // superlinearly with the input on the deep-loop / dense-binding pathology.
+    // Renaming below adds at most ~2 nodes per gen entry (already bounded by the
+    // def-site universe the STMT_STRIDE overflow guard caps). If the projected
+    // total would exceed the budget, fall back to the dense oracle here — BEFORE
+    // paying for renaming + Tarjan SCC on a blown-up graph. Byte-identical (dense
+    // is the equivalence oracle) and bounded (dense honors maxBlockVisits). Mirrors
+    // the throw-edge / unreachable / OOB-binding gates at the top of this function.
+    const nodeBudget = limits?.maxSsaValueGraphNodes && limits.maxSsaValueGraphNodes > 0
+        ? limits.maxSsaValueGraphNodes
+        : DEFAULT_MAX_SSA_VALUE_GRAPH_NODES;
+    let projectedRenameNodes = 0;
+    for (let b = 0; b < n; b++)
+        projectedRenameNodes += (gen[b]?.size ?? 0) * 2;
+    if (nodeKeys.length + projectedRenameNodes > nodeBudget) {
+        return computeInSetsDense(cfg, n, h, adj, limits);
+    }
+    // ── renaming (iterative dominator-tree DFS, per-binding value stacks) ──
+    const domChildren = Array.from({ length: nx }, () => []);
+    for (let b = 0; b < nx; b++)
+        if (b !== S && idom[b] !== -1)
+            domChildren[idom[b]].push(b);
+    for (const list of domChildren)
+        list.sort((a, b) => a - b);
+    const stacks = Array.from({ length: nBindings }, () => []);
+    const entryValue = new Array(nx).fill(null);
+    const enterBlock = (b) => {
+        const pushed = [];
+        const pm = phiNode[b];
+        if (pm)
+            for (const [v, node] of pm) {
+                stacks[v].push(node);
+                pushed.push(v);
+            }
+        // record block-entry (IN) value for each binding USED here — after φ push,
+        // before this block's own gen (the sweep applies intra-block defs itself).
+        // The synthetic entry S has no block ⇒ no statements/gen/uses.
+        const stmts = cfg.blocks[b]?.statements;
+        if (stmts) {
+            let ev = null;
+            for (const s of stmts)
+                for (const u of s.uses) {
+                    const st = stacks[u];
+                    if (st.length) {
+                        if (!ev)
+                            ev = new Map();
+                        ev.set(u, st[st.length - 1]);
+                    }
+                }
+            entryValue[b] = ev;
+        }
+        // apply block gen ⇒ OUT values that flow to successors
+        const g = gen[b];
+        if (g)
+            for (const [v, ge] of g) {
+                const st = stacks[v];
+                let node;
+                if (ge.kills) {
+                    node = newLeaf(ge.set);
+                }
+                else {
+                    node = newInternal();
+                    if (st.length)
+                        nodeOps[node].push(st[st.length - 1]); // prior reaching (may-def keeps it)
+                    nodeOps[node].push(newLeaf(ge.set));
+                }
+                st.push(node);
+                pushed.push(v);
+            }
+        // fill successor φ operands with this block's current OUT for each φ binding
+        for (const s of succsX[b]) {
+            const sm = phiNode[s];
+            if (!sm)
+                continue;
+            for (const [v, phi] of sm) {
+                const st = stacks[v];
+                if (st.length)
+                    nodeOps[phi].push(st[st.length - 1]);
+            }
+        }
+        return pushed;
+    };
+    const frames = [
+        { b: S, ci: 0, pushed: enterBlock(S) },
+    ];
+    while (frames.length) {
+        const f = frames[frames.length - 1];
+        const kids = domChildren[f.b];
+        if (f.ci < kids.length) {
+            const c = kids[f.ci++];
+            frames.push({ b: c, ci: 0, pushed: enterBlock(c) });
+        }
+        else {
+            for (const v of f.pushed)
+                stacks[v].pop();
+            frames.pop();
+        }
+    }
+    // ── reaching sets per node via SCC condensation (cycle-safe union) ──
+    // Tarjan condenses the value graph (operand cycles from loop φs collapse to a
+    // single SCC); a forward pass over the reverse-topo SCC order unions each
+    // SCC's reaching set from its operands' (alias fast path for single-source
+    // SCCs — #2201 review R2). Both stages are pure (reaching-defs-graph.ts).
+    const { sccOf, sccMembers } = tarjanScc(nodeOps);
+    const reachByScc = condenseReachingSets(sccMembers, sccOf, nodeKeys, nodeOps);
+    return {
+        converged: true,
+        reachingAt: (blockIndex, binding) => {
+            const node = entryValue[blockIndex]?.get(binding);
+            if (node === undefined)
+                return undefined;
+            const set = reachByScc[sccOf[node]];
+            return set.size ? set : undefined;
+        },
+    };
+}
+/**
+ * Minimum block count below which SSA construction (dominators + dominance
+ * frontiers + φ-placement + renaming + SCC) does not amortize over the dense
+ * worklist's single-pass aliasing. Calibrated empirically (~14-block crossover
+ * for loop-heavy functions; 16 leaves headroom); the dense-bindings
+ * `rd_scaling_budget` gate in bench/cfg/baselines.json catches a regression if
+ * this is mistuned. Paired with a reachable-loop check — loop-free functions
+ * always take the cheaper dense path regardless of size.
+ */
+const SSA_MIN_BLOCKS = 16;
+/**
+ * Default ceiling on the SSA-sparse solver's value-graph node count (#2201
+ * review R1). Above this the sparse path falls back to the dense oracle (which
+ * bounds its own work via `maxBlockVisits`), trading the deep-loop full-facts
+ * win for bounded memory on pathological inputs. Sized FAR above any real or
+ * benchmarked function: the suite's densest SSA scenarios (`dense-bindings`,
+ * `deep-nest`) build well under 10⁴ nodes, while the pathology this guards
+ * (thousands of blocks × hundreds of bindings) builds 10⁶–10⁷. The
+ * `dense-bindings` / `deep-nest` `rd_scaling_budget` gates in
+ * bench/cfg/baselines.json fail if this is set so low it forces those scenarios
+ * onto the dense path. Overridable per-call via
+ * {@link ReachingDefsLimits.maxSsaValueGraphNodes}.
+ */
+const DEFAULT_MAX_SSA_VALUE_GRAPH_NODES = 1_000_000;
+/**
+ * Production solver dispatcher (#2201). The SSA solver beats the dense worklist
+ * only when there is enough work to amortize SSA construction — a loop (so the
+ * dense fixpoint pays the loop-depth pass multiplier, or truncates at the
+ * ceiling) AND a non-trivial block count. Small or loop-free functions, which
+ * dense solves in one or two cheap aliasing passes, stay on the dense path.
+ * Because the two solvers are byte-identical (held by the equivalence fuzz),
+ * this is a pure performance heuristic with no effect on results.
+ *
+ * @internal
+ */
+function computeInSetsAuto(cfg, n, h, adj, limits) {
+    if (n >= SSA_MIN_BLOCKS && hasReachableLoop(cfg.entryIndex, adj.succs, n)) {
+        return computeInSetsSparse(cfg, n, h, adj, limits);
+    }
+    return computeInSetsDense(cfg, n, h, adj, limits);
+}
+/**
+ * Statement sweep — recover statement-granular def→use facts from the per-block
+ * entry reaching lattices, sort them, and apply the maxFacts truncation. SHARED
+ * by both solvers, and the maxFacts cutoff is where their (intentionally
+ * different) reaching-set INSERTION orders would otherwise leak into the output:
+ * the dense worklist seeds keys in RPO fixpoint order, the SSA solver in
+ * renaming/SCC order, so a loop-carried use's reaching set is the same SET in a
+ * different order. The byte-identity of a TRUNCATED result therefore does NOT
+ * come from matching insertion orders — it comes from the KTD6 per-use
+ * `useKeys.sort()` BELOW, which canonicalizes each use's keys by defKey before
+ * the cutoff. (The full, untruncated fact array is re-sorted at the end, so the
+ * pre-sort is a no-op there; its whole purpose is the truncated prefix.) Outer
+ * emission order — block index, then statement index, then use order — is shared
+ * structurally and needs no canonicalization.
+ */
+function sweepFacts(blocks, reachingAt, defLine, maxFacts) {
+    const facts = [];
+    let truncated = false;
+    // Scratch buffer for one use's reaching def-keys, reused across every use to
+    // avoid a per-use array allocation (#2201 review R9). Cleared per use; the
+    // KTD6 sort below operates on it in place.
+    const useKeys = [];
+    outer: for (const b of blocks) {
+        const stmts = b.statements;
+        if (!stmts || stmts.length === 0)
+            continue;
+        // Sparse intra-block overlay: only the bindings REDEFINED within this block
+        // so far. A use's reaching set is the overlay's override if present, else
+        // the block-entry reaching set (reachingAt). This never materializes the
+        // full block lattice — the dense O(live-vars) per-block copy the sparse
+        // solver exists to avoid.
+        const overlay = new Map();
+        for (let i = 0; i < stmts.length; i++) {
+            const s = stmts[i];
+            // A use's binding that the SAME statement also defines could be a
+            // read-then-write (`x += 1` — sees prior defs) OR a write-then-read
+            // (`if ((m = re.exec(s)) && m[1])` — sees the same-statement def).
+            // StatementFacts carries no intra-statement order, so emit BOTH: prior
+            // defs ∪ the same-statement def. Sound over-approximation — the extra
+            // self-fact on compound assignments is harmless; missing the
+            // assign-and-test def→use (the most common JS idiom) would be a taint
+            // false negative. May-defs join the self-key set the same way.
+            // def/mayDef arrays are tiny (1–3 entries), so a membership scan over them
+            // is cheaper than the old per-statement `new Set([...defs, ...mayDefs])`
+            // (#2201 review R9). `hasSelfDefs` short-circuits pure-use statements.
+            const hasSelfDefs = s.defs.length > 0 || (s.mayDefs?.length ?? 0) > 0;
+            for (const u of s.uses) {
+                const reaching = overlay.get(u) ?? reachingAt(b.index, u);
+                const selfKey = hasSelfDefs && (s.defs.includes(u) || (s.mayDefs?.includes(u) ?? false))
+                    ? defKey(b.index, i)
+                    : undefined;
+                if (!reaching && selfKey === undefined)
+                    continue;
+                // Reuse the scratch buffer instead of spreading a fresh array per use.
+                useKeys.length = 0;
+                if (reaching)
+                    for (const k of reaching)
+                        useKeys.push(k);
+                if (selfKey !== undefined && !reaching?.has(selfKey))
+                    useKeys.push(selfKey);
+                // Canonical emission order (#2201 KTD6): sort each use's reaching
+                // def-sites by defKey (= def block, then def stmt) BEFORE the maxFacts
+                // cutoff. The full (untruncated) fact array is re-sorted identically at
+                // the end, so this is a no-op there; its purpose is to make the
+                // TRUNCATED subset schedule-independent — the reaching SET's insertion
+                // order is fixpoint-evaluation-order-dependent for loop-carried
+                // bindings (dense RPO vs sparse change-driven seed different keys
+                // first), so a pre-sort cutoff is what keeps the two solvers'
+                // truncated results byte-identical.
+                useKeys.sort((a, b) => a - b);
+                for (const key of useKeys) {
+                    if (facts.length >= maxFacts) {
+                        truncated = true;
+                        break outer;
+                    }
+                    const defBlock = Math.floor(key / STMT_STRIDE);
+                    const defStmt = key % STMT_STRIDE;
+                    facts.push({
+                        bindingIdx: u,
+                        def: { blockIndex: defBlock, stmtIndex: defStmt, line: defLine.get(key) ?? s.line },
+                        use: { blockIndex: b.index, stmtIndex: i, line: s.line },
+                    });
+                }
+            }
+            if (s.mayDefs?.length) {
+                // Gen WITHOUT kill: the conditional def joins the binding's set.
+                const key = defKey(b.index, i);
+                for (const d of s.mayDefs) {
+                    const prior = overlay.get(d) ?? reachingAt(b.index, d);
+                    overlay.set(d, prior ? unionSets(prior, new Set([key])) : new Set([key]));
+                }
+            }
+            if (s.defs.length > 0) {
+                for (const d of s.defs)
+                    overlay.set(d, new Set([defKey(b.index, i)])); // kill + gen
+            }
+        }
+    }
+    facts.sort((a, b) => a.def.blockIndex - b.def.blockIndex ||
+        a.def.stmtIndex - b.def.stmtIndex ||
+        a.use.blockIndex - b.use.blockIndex ||
+        a.use.stmtIndex - b.use.stmtIndex ||
+        a.bindingIdx - b.bindingIdx);
+    return { facts, truncated };
+}
+/**
+ * Union predecessor lattices, sharing sets where possible. A normal edge
+ * contributes OUT(from). A THROW edge contributes IN(from) ∪ allDefs(from):
+ * an exception may fire before, between, or after any of the block's defs, so
+ * the handler can observe the incoming state OR any intermediate def — OUT
+ * alone (last-def-wins) misses defs overwritten later in the same block.
+ * IN ∪ allDefs ⊇ OUT, so the throw contribution subsumes it.
+ */
+function mergePreds(preds, inSets, outSets, allDefsGen) {
+    const merged = new Map();
+    const mergeOne = (source) => {
+        for (const [bindingIdx, set] of source) {
+            const existing = merged.get(bindingIdx);
+            if (!existing) {
+                merged.set(bindingIdx, set); // share the first contributor's set
+            }
+            else if (existing !== set) {
+                // Union only when the references differ. Copy-on-extend: `existing`
+                // may be a shared set from another block — never mutate it.
+                let target = existing;
+                let copied = false;
+                for (const key of set) {
+                    if (!target.has(key)) {
+                        if (!copied) {
+                            target = new Set(existing);
+                            copied = true;
+                        }
+                        target.add(key);
+                    }
+                }
+                if (copied)
+                    merged.set(bindingIdx, target);
+            }
+        }
+    };
+    for (const p of preds) {
+        if (p.viaThrow) {
+            mergeOne(inSets[p.from]); // exception may fire pre-defs…
+            const all = allDefsGen[p.from];
+            if (all)
+                mergeOne(all); // …or after ANY of the block's defs
+        }
+        else {
+            mergeOne(outSets[p.from]);
+        }
+    }
+    return merged;
+}