universal-physics-tensor 0.45.2 → 0.47.0

package/dist/atlas/witness-specs.js

@@ -0,0 +1,372 @@
+/**
+ * Atlas Phase 4, S4.3 — the EXECUTABLE witness registry.
+ *
+ * Design note: `docs/planning/Atlas-Phase-4-Design.md` §3.
+ *
+ * A `Witness` record names a check and the test file that runs it; it carries
+ * nothing a runner can execute. This module holds the executable form of every
+ * witness the results artifact covers, keyed by the record it supports. The
+ * Lead-run `scripts/emit-witness-results.mjs` runs exactly this list, and
+ * `tests/atlas/witness-results.test.ts` deep-equals the committed artifact
+ * against a fresh run of it.
+ *
+ * ## The symbolic specs apply the bridge's DICTIONARY, they do not restate it
+ *
+ * Writing `lhs` and `rhs` as two hand-typed ASTs that happen to be equal would
+ * check nothing but the typist. Each spec below starts from the PREMISE
+ * model's expression and pushes it through the bridge's variable dictionary
+ * with `substitute`; the CAS then has to show that the result equals the
+ * CONCLUSION model's expression. What is checked is the dictionary.
+ *
+ * @module atlas/witness-specs
+ * @internal
+ */
+import { sym } from '../dimensional/ast-builders.js';
+import { DIMENSIONLESS, ENERGY, LENGTH, MASS } from '../dimensional/types.js';
+import { substitute } from '../composition/expr-subst.js';
+import { CAPACITANCE, DAMPING, INDUCTANCE, RESISTANCE, SPRING_CONSTANT, } from './oscillators/dimensions.js';
+import { heatSteadyDeviation, langevinMsdRatio, telegraphSlowRateRatio, telegraphWaveFrequencyRatio, diffusionKernel, gaussianSpread, heatFtcsCentre, randomWalkCentralDensity, wickHeatResidual, } from './diffusion/numerics.js';
+import { DENSITY, DIFFUSIVITY, SPECIFIC_HEAT, THERMAL_CONDUCTIVITY } from './diffusion/dimensions.js';
+import { VISCOSITY } from './diffusion/models.js';
+import { wickRotatedFreeKernel } from './witnesses/quantum-support.js';
+import { kgNonrelativisticError, kgUniformModeValue, stiffStringPhaseVelocity, acousticLeapfrogQuarter, dalembertResidual, kleinGordonPhaseVelocity, stringLeapfrogMidpoint, } from './waves/numerics.js';
+const op = (o, ...args) => ({
+    kind: 'op',
+    op: o,
+    args,
+});
+const n = (value) => sym(String(value), DIMENSIONLESS);
+/**
+ * Push `expr` through a variable dictionary, REFUSING a mapping that matches no
+ * leaf. A zero-occurrence substitution is a silent no-op that would leave the
+ * premise variable in place and let the check pass or fail for the wrong
+ * reason — the same guard `composeSymbolic` applies (Adam A-3).
+ */
+function applyDictionary(expr, dictionary) {
+    let out = expr;
+    for (const [name, replacement] of Object.entries(dictionary)) {
+        const r = substitute(out, name, replacement);
+        if (r.count === 0) {
+            throw new Error(`witness-specs: dictionary entry '${name}' matches no leaf`);
+        }
+        out = r.expr;
+    }
+    return out;
+}
+// Spring and LC symbols, with the dimensions the oscillator models declare.
+const m = sym('m', MASS);
+const k = sym('k', SPRING_CONSTANT);
+const b = sym('b', DAMPING);
+const L = sym('L', INDUCTANCE);
+const C = sym('C', CAPACITANCE);
+const R = sym('R', RESISTANCE);
+/** The spring ↔ circuit dictionary of `ab-spring-lc` / `ab-damped-rlc`: m ↔ L, k ↔ 1/C, b ↔ R. */
+const SPRING_TO_CIRCUIT = {
+    m: L,
+    k: op('/', n(1), C),
+    b: R,
+};
+// ── Diffusion family (S4.4) ────────────────────────────────────────────────
+/** WD1 fixture: D and t, fixed while the walk is refined. @internal */
+export const WD1_FIXTURE = { D: 0.5, t: 2 };
+/**
+ * WD2 fixture. κ, ρ and c_p are chosen so the heat equation's own variables
+ * are all different from 1 while κ/(ρ c_p) = 1: a dictionary that dropped or
+ * inverted a factor would move the answer.
+ *
+ * @internal
+ */
+export const WD2_FIXTURE = {
+    kappa: 2,
+    rho: 4,
+    cp: 0.5,
+    s0: 0.05,
+    tEnd: 0.2,
+    halfWidth: 4,
+};
+/** WD3 fixture: an off-centre point, so no symmetry zeroes a derivative. @internal */
+export const WD3_FIXTURE = { hbar: 1, m: 0.5, s: 0.7, x: 0.3, tau: 0.4, h0: 0.1 };
+const kappa = sym('kappa', THERMAL_CONDUCTIVITY);
+const rho = sym('rho', DENSITY);
+const cp = sym('cp', SPECIFIC_HEAT);
+const D = sym('D', DIFFUSIVITY);
+const q = sym('q', { ...LENGTH, L: -1 });
+// ── Wave family (S4.5) ─────────────────────────────────────────────────────
+/** WS1 fixture: F and μ both ≠ 1 while c = √(F/μ) = 2. @internal */
+export const WS1_FIXTURE = { tension: 2, mu: 0.5, tEnd: 0.3 };
+/** WS2 fixture: an off-centre point where both profiles contribute. @internal */
+export const WS2_FIXTURE = { c: 1.5, x: 0.4, t: 0.3, h0: 0.1 };
+/** WS3 fixture: γ = 1.4 with nondimensional p₀ = 1, ρ₀ = 1.2. @internal */
+export const WS3_FIXTURE = { p0: 1, rho0: 1.2, gamma: 1.4, tEnd: 0.37 };
+/** WS4 fixture: ω₀ = c = 1, base wavenumber k₀ = 10 (the domain edge ω₀/(ck) = 0.1). @internal */
+export const WS4_FIXTURE = { omega0: 1, c: 1, k0: 10 };
+// ── Sprint 4 closure ───────────────────────────────────────────────────────
+/** WD4 fixture: m, γ, k_BT all ≠ 1; τ_p = m/γ = 4. @internal */
+export const WD4_FIXTURE = { m: 2, gamma: 0.5, kT: 1.5 };
+/** WD6 base: τ₀ = 0.1 with D = q = 1, so ε = τ at the resolution's τ = τ₀/resolution. @internal */
+export const WD6_FIXTURE = { tau0: 0.1, D: 1, q: 1 };
+/** WD7 base: ε = 25 · resolution with D = q = 1. @internal */
+export const WD7_FIXTURE = { eps0: 25, D: 1, q: 1 };
+/** WD8 fixture: a unit rod held at 2 and 5, base time 0.1 (Fourier number 0.1 per unit). @internal */
+export const WD8_FIXTURE = {
+    alpha: 1,
+    ell: 1,
+    tLeft: 2,
+    tRight: 5,
+    t0: 0.1,
+    cells: 40,
+};
+/** WS5 base: x₀ = ck/ω₀ = 0.1, halved per resolution step. @internal */
+export const WS5_FIXTURE = { x0: 0.1 };
+/** WS6 fixture: c = 1, ω₀ = 2, t = 3; resolution = time steps. @internal */
+export const WS6_FIXTURE = { c: 1, omega0: 2, tEnd: 3 };
+/** WS7 fixture: F = 100, μ = 0.01 (so √(F/μ) = 100), EI = 0.01, k₀ = 10 (β = 0.01 at res 1). @internal */
+export const WS7_FIXTURE = { F: 100, mu: 0.01, EI: 0.01, k0: 10 };
+const kT = sym('kT', ENERGY);
+const gammaSym = sym('gamma', DAMPING);
+const eta = sym('eta', VISCOSITY);
+const a = sym('a', LENGTH);
+const pi = sym('pi', DIMENSIONLESS);
+/**
+ * Every witness the results artifact covers, in a fixed order (the artifact is
+ * emitted in this order, so reordering is a reviewable diff, not churn).
+ *
+ * @internal
+ */
+export const WITNESS_REGISTRY = [
+    {
+        // ω0² of the spring, pushed through the dictionary, is ω0² of the LC circuit.
+        recordId: 'ab-spring-lc',
+        kind: 'symbolic',
+        spec: {
+            id: 'W1s',
+            lhs: applyDictionary(op('/', k, m), { m: SPRING_TO_CIRCUIT['m'], k: SPRING_TO_CIRCUIT['k'] }),
+            rhs: op('/', n(1), op('*', L, C)),
+        },
+    },
+    {
+        // ζ² of the damped spring, b²/(4mk), pushed through the dictionary, is ζ² of
+        // the RLC circuit, R²C/(4L). The squared form avoids a fractional exponent
+        // on a dimensioned base, which the grammar forbids.
+        recordId: 'ab-damped-rlc',
+        kind: 'symbolic',
+        spec: {
+            id: 'W2s',
+            lhs: applyDictionary(op('/', op('^', b, n(2)), op('*', n(4), m, k)), SPRING_TO_CIRCUIT),
+            rhs: op('/', op('*', op('^', R, n(2)), C), op('*', n(4), L)),
+        },
+    },
+    {
+        // Coarse-graining: the walk's density at the origin converges to the
+        // diffusion kernel as the closure D = Δx²/(2Δt) is held and Δt → 0.
+        recordId: 'ab-walk-diffusion',
+        kind: 'numeric',
+        spec: {
+            id: 'WD1',
+            evaluate: (steps) => randomWalkCentralDensity(steps, WD1_FIXTURE.D, WD1_FIXTURE.t),
+            target: diffusionKernel(0, WD1_FIXTURE.t, WD1_FIXTURE.D),
+            coarseResolution: 100,
+            fineResolution: 1000,
+            tolerance: 1e-4,
+        },
+    },
+    {
+        // Exact equivalence: the HEAT equation, solved in κ, ρ, c_p, reproduces the
+        // FICK solution with D = κ/(ρ c_p).
+        recordId: 'ab-heat-diffusion',
+        kind: 'numeric',
+        spec: {
+            id: 'WD2',
+            evaluate: (cells) => heatFtcsCentre(cells, WD2_FIXTURE),
+            target: gaussianSpread(0, WD2_FIXTURE.tEnd, WD2_FIXTURE.kappa / (WD2_FIXTURE.rho * WD2_FIXTURE.cp), WD2_FIXTURE.s0),
+            coarseResolution: 80,
+            fineResolution: 160,
+            tolerance: 5e-4,
+        },
+    },
+    {
+        // The heat side's Fourier-mode decay rate κq²/(ρ c_p), pushed through the
+        // inverse dictionary κ ↦ D ρ c_p, is the Fick side's D q².
+        recordId: 'ab-heat-diffusion',
+        kind: 'symbolic',
+        spec: {
+            id: 'WD2s',
+            lhs: applyDictionary(op('/', op('*', kappa, op('^', q, n(2))), op('*', rho, cp)), {
+                kappa: op('*', D, rho, cp),
+            }),
+            rhs: op('*', D, op('^', q, n(2))),
+        },
+    },
+    {
+        // Analytic continuation: the Wick-rotated free kernel satisfies the
+        // diffusion equation with D = ħ/(2m); the residual's target is zero.
+        recordId: 'ab-schrodinger-diffusion',
+        kind: 'numeric',
+        spec: {
+            id: 'WD3',
+            evaluate: (resolution) => wickHeatResidual(resolution, WD3_FIXTURE, wickRotatedFreeKernel),
+            target: 0,
+            coarseResolution: 1,
+            fineResolution: 4,
+            tolerance: 1e-3,
+        },
+    },
+    {
+        // Restriction: the string, solved in F and μ, reproduces the 1-D wave
+        // solution with c = √(F/μ).
+        recordId: 'ab-string-wave',
+        kind: 'numeric',
+        spec: {
+            id: 'WS1',
+            evaluate: (cells) => stringLeapfrogMidpoint(cells, WS1_FIXTURE),
+            target: Math.sin(Math.PI * 0.5) *
+                Math.cos(Math.PI * Math.sqrt(WS1_FIXTURE.tension / WS1_FIXTURE.mu) * WS1_FIXTURE.tEnd),
+            coarseResolution: 40,
+            fineResolution: 80,
+            tolerance: 2e-4,
+        },
+    },
+    {
+        // Derivation: d'Alembert's form satisfies the wave equation; residual → 0.
+        recordId: 'ab-wave-dalembert',
+        kind: 'numeric',
+        spec: {
+            id: 'WS2',
+            evaluate: (resolution) => dalembertResidual(resolution, WS2_FIXTURE),
+            target: 0,
+            coarseResolution: 4,
+            fineResolution: 8,
+            tolerance: 2e-3,
+        },
+    },
+    {
+        // Hyperedge: linearized Euler closed by the adiabatic EOS reproduces the
+        // sound model with c_s² = γp₀/ρ₀.
+        recordId: 'ab-sound-speed',
+        kind: 'numeric',
+        spec: {
+            id: 'WS3',
+            evaluate: (cells) => acousticLeapfrogQuarter(cells, WS3_FIXTURE),
+            target: Math.cos(2 * Math.PI * Math.sqrt((WS3_FIXTURE.gamma * WS3_FIXTURE.p0) / WS3_FIXTURE.rho0) * WS3_FIXTURE.tEnd),
+            coarseResolution: 64,
+            fineResolution: 128,
+            tolerance: 2e-4,
+        },
+    },
+    {
+        // Approximation: the Klein–Gordon phase velocity tends to c as k grows.
+        recordId: 'ab-klein-gordon-wave',
+        kind: 'numeric',
+        spec: {
+            id: 'WS4',
+            evaluate: (resolution) => kleinGordonPhaseVelocity(resolution, WS4_FIXTURE.omega0, WS4_FIXTURE.c, WS4_FIXTURE.k0),
+            target: WS4_FIXTURE.c,
+            coarseResolution: 1,
+            fineResolution: 2,
+            tolerance: 2e-3,
+        },
+    },
+    // ── Sprint 4 closure ─────────────────────────────────────────────────────
+    {
+        // Coarse-graining: Langevin second moments at t = resolution · τ_p, over 2Dt.
+        recordId: 'ab-langevin-diffusion',
+        kind: 'numeric',
+        spec: {
+            id: 'WD4',
+            evaluate: (resolution) => langevinMsdRatio(resolution, WD4_FIXTURE),
+            target: 1,
+            coarseResolution: 10,
+            fineResolution: 100,
+            tolerance: 0.02,
+        },
+    },
+    {
+        // Hyperedge: γ = 6πηa pushed into Einstein's D = k_BT/γ.
+        recordId: 'ab-stokes-einstein',
+        kind: 'symbolic',
+        spec: {
+            id: 'WD5s',
+            lhs: applyDictionary(op('/', kT, gammaSym), { gamma: op('*', n(6), pi, eta, a) }),
+            rhs: op('/', kT, op('*', n(6), pi, eta, a)),
+        },
+    },
+    {
+        // Singular limit τ → 0: the telegraph slow rate over Dq² tends to 1.
+        recordId: 'ab-telegraph-diffusion',
+        kind: 'numeric',
+        spec: {
+            id: 'WD6',
+            evaluate: (resolution) => telegraphSlowRateRatio(WD6_FIXTURE.tau0 / resolution, WD6_FIXTURE.D, WD6_FIXTURE.q),
+            target: 1,
+            coarseResolution: 2,
+            fineResolution: 4,
+            tolerance: 0.03,
+        },
+    },
+    {
+        // ε → ∞: the telegraph oscillation frequency over c q tends to 1.
+        recordId: 'ab-telegraph-wave',
+        kind: 'numeric',
+        spec: {
+            id: 'WD7',
+            evaluate: (resolution) => telegraphWaveFrequencyRatio(WD7_FIXTURE.eps0 * resolution, WD7_FIXTURE.D, WD7_FIXTURE.q),
+            target: 1,
+            coarseResolution: 1,
+            fineResolution: 2,
+            tolerance: 3e-3,
+        },
+    },
+    {
+        // Steady state: the heat solution's deviation from the Laplace profile → 0.
+        recordId: 'ab-heat-laplace',
+        kind: 'numeric',
+        spec: {
+            id: 'WD8',
+            evaluate: (resolution) => heatSteadyDeviation(resolution, WD8_FIXTURE),
+            target: 0,
+            coarseResolution: 2,
+            fineResolution: 4,
+            tolerance: 0.025,
+        },
+    },
+    {
+        // Non-relativistic limit: kinetic-frequency error → 0 as x = ck/ω₀ halves.
+        recordId: 'ab-kg-schrodinger',
+        kind: 'numeric',
+        spec: {
+            id: 'WS5',
+            evaluate: (resolution) => kgNonrelativisticError(WS5_FIXTURE.x0 / resolution),
+            target: 0,
+            coarseResolution: 1,
+            fineResolution: 2,
+            tolerance: 1e-3,
+        },
+    },
+    {
+        // Uniform-mode restriction: the full KG PDE, uniform data, vs cos(ω₀t).
+        recordId: 'ab-kg-oscillator',
+        kind: 'numeric',
+        spec: {
+            id: 'WS6',
+            evaluate: (steps) => kgUniformModeValue(steps, WS6_FIXTURE.c, WS6_FIXTURE.omega0, WS6_FIXTURE.tEnd),
+            target: Math.cos(WS6_FIXTURE.omega0 * WS6_FIXTURE.tEnd),
+            coarseResolution: 50,
+            fineResolution: 100,
+            tolerance: 3e-4,
+        },
+    },
+    {
+        // Flexible-string limit: stiff-string phase velocity → √(F/μ) as k shrinks.
+        recordId: 'ab-stiff-string',
+        kind: 'numeric',
+        spec: {
+            id: 'WS7',
+            evaluate: (resolution) => stiffStringPhaseVelocity(resolution, WS7_FIXTURE.F, WS7_FIXTURE.mu, WS7_FIXTURE.EI, WS7_FIXTURE.k0),
+            target: Math.sqrt(WS7_FIXTURE.F / WS7_FIXTURE.mu),
+            coarseResolution: 1,
+            fineResolution: 2,
+            tolerance: 0.15,
+        },
+    },
+];
+//# sourceMappingURL=witness-specs.js.map

package/dist/atlas/witness-specs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-specs.js","sourceRoot":"","sources":["../../src/atlas/witness-specs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,OAAO,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,yBAAyB,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAC1D,OAAO,EACL,WAAW,EACX,OAAO,EACP,UAAU,EACV,UAAU,EACV,eAAe,GAChB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,sBAAsB,EACtB,2BAA2B,EAC3B,eAAe,EACf,cAAc,EACd,cAAc,EACd,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAOjC,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACtG,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EACL,sBAAsB,EACtB,kBAAkB,EAClB,wBAAwB,EACxB,uBAAuB,EACvB,iBAAiB,EACjB,wBAAwB,EACxB,sBAAsB,GACvB,MAAM,qBAAqB,CAAC;AAuB7B,MAAM,EAAE,GAAG,CAAC,CAA8B,EAAE,GAAG,IAAgB,EAAY,EAAE,CAAC,CAAC;IAC7E,IAAI,EAAE,IAAI;IACV,EAAE,EAAE,CAAC;IACL,IAAI;CACL,CAAC,CAAC;AACH,MAAM,CAAC,GAAG,CAAC,KAAa,EAAY,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,aAAa,CAAC,CAAC;AAEzE;;;;;GAKG;AACH,SAAS,eAAe,CAAC,IAAc,EAAE,UAA8C;IACrF,IAAI,GAAG,GAAG,IAAI,CAAC;IACf,KAAK,MAAM,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,CAAC;QAC7D,MAAM,CAAC,GAAG,UAAU,CAAC,GAAG,EAAE,IAAI,EAAE,WAAW,CAAC,CAAC;QAC7C,IAAI,CAAC,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,oCAAoC,IAAI,mBAAmB,CAAC,CAAC;QAC/E,CAAC;QACD,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC;IACf,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACzB,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC;AACpC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;AAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AAC/B,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAChC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;AAE/B,kGAAkG;AAClG,MAAM,iBAAiB,GAAuC;IAC5D,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACnB,CAAC,EAAE,CAAC;CACL,CAAC;AAEF,8EAA8E;AAE9E,uEAAuE;AACvE,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAW,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAgB;IACtC,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;IACN,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,IAAI;IACR,IAAI,EAAE,GAAG;IACT,SAAS,EAAE,CAAC;CACb,CAAC;AAEF,sFAAsF;AACtF,MAAM,CAAC,MAAM,WAAW,GAAgB,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AAE/F,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,EAAE,oBAAoB,CAAC,CAAC;AACjD,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;AAChC,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AACpC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;AAChC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,EAAE,GAAG,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;AAEzC,8EAA8E;AAE9E,oEAAoE;AACpE,MAAM,CAAC,MAAM,WAAW,GAAkB,EAAE,OAAO,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC;AAE7E,iFAAiF;AACjF,MAAM,CAAC,MAAM,WAAW,GAAqB,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AAEjF,2EAA2E;AAC3E,MAAM,CAAC,MAAM,WAAW,GAAoB,EAAE,EAAE,EAAE,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AAEzF,kGAAkG;AAClG,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,EAAE,EAAE,EAAW,CAAC;AAEhE,8EAA8E;AAE9E,gEAAgE;AAChE,MAAM,CAAC,MAAM,WAAW,GAAoB,EAAE,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC;AAE1E,mGAAmG;AACnG,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAW,CAAC;AAE9D,8DAA8D;AAC9D,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAW,CAAC;AAE7D,sGAAsG;AACtG,MAAM,CAAC,MAAM,WAAW,GAAuB;IAC7C,KAAK,EAAE,CAAC;IACR,GAAG,EAAE,CAAC;IACN,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,EAAE,EAAE,GAAG;IACP,KAAK,EAAE,EAAE;CACV,CAAC;AAEF,wEAAwE;AACxE,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,EAAE,EAAE,GAAG,EAAW,CAAC;AAEhD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAW,CAAC;AAEjE,0GAA0G;AAC1G,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,EAAW,CAAC;AAE3E,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;AAC7B,MAAM,QAAQ,GAAG,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;AACvC,MAAM,GAAG,GAAG,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,CAAC;AAClC,MAAM,CAAC,GAAG,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AAC3B,MAAM,EAAE,GAAG,GAAG,CAAC,IAAI,EAAE,aAAa,CAAC,CAAC;AAEpC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAiC;IAC5D;QACE,8EAA8E;QAC9E,QAAQ,EAAE,cAAc;QACxB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAE,EAAE,CAAC,EAAE,iBAAiB,CAAC,GAAG,CAAE,EAAE,CAAC;YAC/F,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;SAClC;KACF;IACD;QACE,6EAA6E;QAC7E,2EAA2E;QAC3E,oDAAoD;QACpD,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,iBAAiB,CAAC;YACvF,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;SAC7D;KACF;IACD;QACE,qEAAqE;QACrE,oEAAoE;QACpE,QAAQ,EAAE,mBAAmB;QAC7B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,wBAAwB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YAClF,MAAM,EAAE,eAAe,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YACxD,gBAAgB,EAAE,GAAG;YACrB,cAAc,EAAE,IAAI;YACpB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,4EAA4E;QAC5E,oCAAoC;QACpC,QAAQ,EAAE,mBAAmB;QAC7B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,EAAE,WAAW,CAAC;YACvD,MAAM,EAAE,cAAc,CACpB,CAAC,EACD,WAAW,CAAC,IAAI,EAChB,WAAW,CAAC,KAAK,GAAG,CAAC,WAAW,CAAC,GAAG,GAAG,WAAW,CAAC,EAAE,CAAC,EACtD,WAAW,CAAC,EAAE,CACf;YACD,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,GAAG;YACnB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,0EAA0E;QAC1E,2DAA2D;QAC3D,QAAQ,EAAE,mBAAmB;QAC7B,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,EAAE,EAAE,MAAM;YACV,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,EAAE;gBAChF,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE,CAAC;aAC3B,CAAC;YACF,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;SAClC;KACF;IACD;QACE,oEAAoE;QACpE,qEAAqE;QACrE,QAAQ,EAAE,0BAA0B;QACpC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,WAAW,EAAE,qBAAqB,CAAC;YAC1F,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,sEAAsE;QACtE,4BAA4B;QAC5B,QAAQ,EAAE,gBAAgB;QAC1B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,sBAAsB,CAAC,KAAK,EAAE,WAAW,CAAC;YAC/D,MAAM,EACJ,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,GAAG,CAAC;gBACvB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,OAAO,GAAG,WAAW,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC;YACxF,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,EAAE;YAClB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,2EAA2E;QAC3E,QAAQ,EAAE,mBAAmB;QAC7B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,iBAAiB,CAAC,UAAU,EAAE,WAAW,CAAC;YACpE,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,yEAAyE;QACzE,kCAAkC;QAClC,QAAQ,EAAE,gBAAgB;QAC1B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,uBAAuB,CAAC,KAAK,EAAE,WAAW,CAAC;YAChE,MAAM,EAAE,IAAI,CAAC,GAAG,CACd,CAAC,GAAG,IAAI,CAAC,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,WAAW,CAAC,EAAE,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CACpG;YACD,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,GAAG;YACnB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,wEAAwE;QACxE,QAAQ,EAAE,sBAAsB;QAChC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CACvB,wBAAwB,CAAC,UAAU,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC;YACzF,MAAM,EAAE,WAAW,CAAC,CAAC;YACrB,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;IACD,4EAA4E;IAC5E;QACE,8EAA8E;QAC9E,QAAQ,EAAE,uBAAuB;QACjC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,gBAAgB,CAAC,UAAU,EAAE,WAAW,CAAC;YACnE,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,GAAG;YACnB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,yDAAyD;QACzD,QAAQ,EAAE,oBAAoB;QAC9B,IAAI,EAAE,UAAU;QAChB,IAAI,EAAE;YACJ,EAAE,EAAE,MAAM;YACV,GAAG,EAAE,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,CAAC;YACjF,GAAG,EAAE,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;SAC5C;KACF;IACD;QACE,qEAAqE;QACrE,QAAQ,EAAE,wBAAwB;QAClC,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CACvB,sBAAsB,CAAC,WAAW,CAAC,IAAI,GAAG,UAAU,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YACrF,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,kEAAkE;QAClE,QAAQ,EAAE,mBAAmB;QAC7B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CACvB,2BAA2B,CAAC,WAAW,CAAC,IAAI,GAAG,UAAU,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC;YAC1F,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,4EAA4E;QAC5E,QAAQ,EAAE,iBAAiB;QAC3B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,mBAAmB,CAAC,UAAU,EAAE,WAAW,CAAC;YACtE,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,KAAK;SACjB;KACF;IACD;QACE,2EAA2E;QAC3E,QAAQ,EAAE,mBAAmB;QAC7B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,GAAG,UAAU,CAAC;YAC7E,MAAM,EAAE,CAAC;YACT,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,wEAAwE;QACxE,QAAQ,EAAE,kBAAkB;QAC5B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE,CAClB,kBAAkB,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,MAAM,EAAE,WAAW,CAAC,IAAI,CAAC;YAChF,MAAM,EAAE,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC;YACvD,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,GAAG;YACnB,SAAS,EAAE,IAAI;SAChB;KACF;IACD;QACE,4EAA4E;QAC5E,QAAQ,EAAE,iBAAiB;QAC3B,IAAI,EAAE,SAAS;QACf,IAAI,EAAE;YACJ,EAAE,EAAE,KAAK;YACT,QAAQ,EAAE,CAAC,UAAU,EAAE,EAAE,CACvB,wBAAwB,CAAC,UAAU,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE,WAAW,CAAC,EAAE,CAAC;YACrG,MAAM,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,GAAG,WAAW,CAAC,EAAE,CAAC;YACjD,gBAAgB,EAAE,CAAC;YACnB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,IAAI;SAChB;KACF;CACF,CAAC"}

package/dist/atlas/witness-symbolic.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Atlas Phase 4, S4.2 — the symbolic witness runner.
+ *
+ * Design note: `docs/planning/Atlas-Phase-4-Design.md` §2.
+ *
+ * A symbolic witness claims `lhs = rhs`. The runner forms the DIFFERENCE and
+ * asks the optional CAS peer to simplify it: a difference that collapses to a
+ * literal zero is `'checked'`; one that collapses to a non-zero literal is
+ * `'refuted'`; anything else is `'unresolved'` with the reason it could not
+ * decide.
+ *
+ * ## The simplifier is INJECTED, and no test touches the registry
+ *
+ * `src/numerical/formula-registry.ts` caches its selection in module scope and
+ * exposes no reset hook, so a test that registered a stub would leak it into
+ * every later test in the same worker. {@link runSymbolicWitness} therefore
+ * takes the simplifier as a PARAMETER, defaulting to `simplifyExpr`. Tests
+ * pass a stub for the present path and `null` for the absent path; the
+ * registry is never written. One test exercises the real peer under the
+ * existing skip-when-absent pattern.
+ *
+ * `null` means "the peer is absent" and is a first-class argument value, not a
+ * forgotten one. `simplifyExpr` itself CANNOT tell absence from "nothing to
+ * simplify" — both return `simplified: false` — so when the argument is
+ * OMITTED the runner asks `isSimplifierAvailable()` first and maps absence to
+ * `null`. Without that step the default path would report a missing peer as
+ * `'not-simplified'`, the wrong reason on the one path most callers take.
+ *
+ * Deviation from the plan's wording, recorded in the design note §2.1: the
+ * plan names `getFormulaParser()` as the default. A parser cannot decide
+ * `lhs − rhs = 0`; the capability needed is SIMPLIFICATION, which lives in
+ * `expr-simplify.ts` (a different peer, `@danielsimonjr/mathts-functions`).
+ *
+ * @module atlas/witness-symbolic
+ * @internal
+ */
+import type { ExprNode } from '../dimensional/ast-types.js';
+import type { WitnessRunResult } from './witness-result.js';
+/**
+ * The simplification capability this runner needs, as a function rather than
+ * the whole module — so a stub is five lines and cannot accidentally depend on
+ * anything else `expr-simplify.ts` exports.
+ *
+ * @internal
+ */
+export type SymbolicSimplifier = (expr: ExprNode) => Promise<{
+    readonly expr: ExprNode;
+    readonly simplified: boolean;
+}>;
+/** What a symbolic witness asserts. @internal */
+export interface SymbolicWitnessSpec {
+    /** The `Witness.id` (`'W7b'`). */
+    readonly id: string;
+    readonly lhs: ExprNode;
+    readonly rhs: ExprNode;
+    /**
+     * Wall-clock budget in milliseconds. Default 5000.
+     *
+     * ⚠ **This bounds how long the RUNNER WAITS, not how long the CAS works.**
+     * The peer's `simplify` is synchronous inside its promise, so nothing here
+     * can interrupt it; a timeout reports that no answer arrived in time and the
+     * underlying work may still be running. Saying otherwise would be the
+     * "a running process is not a working one" error in reverse.
+     */
+    readonly budgetMs?: number;
+}
+/**
+ * Run one symbolic witness.
+ *
+ * @param spec - the claim, as two ASTs whose difference should vanish.
+ * @param simplifier - the CAS capability, or `null` when the optional peer is
+ * absent. When omitted, resolves to `simplifyExpr` if the peer is available and
+ * to `null` otherwise. Pass `null` EXPLICITLY to exercise the absent path.
+ * @returns a result; **never throws**, because a thrown error forces callers
+ * into a `catch` that cannot distinguish "did not run" from "failed".
+ * @internal
+ */
+export declare function runSymbolicWitness(spec: SymbolicWitnessSpec, simplifier?: SymbolicSimplifier | null): Promise<WitnessRunResult>;
+//# sourceMappingURL=witness-symbolic.d.ts.map

package/dist/atlas/witness-symbolic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-symbolic.d.ts","sourceRoot":"","sources":["../../src/atlas/witness-symbolic.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;;;GAMG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAC/B,IAAI,EAAE,QAAQ,KACX,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;CAAE,CAAC,CAAC;AAExE,iDAAiD;AACjD,MAAM,WAAW,mBAAmB;IAClC,kCAAkC;IAClC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAeD;;;;;;;;;;GAUG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,mBAAmB,EACzB,UAAU,CAAC,EAAE,kBAAkB,GAAG,IAAI,GACrC,OAAO,CAAC,gBAAgB,CAAC,CAoF3B"}

package/dist/atlas/witness-symbolic.js

@@ -0,0 +1,140 @@
+/**
+ * Atlas Phase 4, S4.2 — the symbolic witness runner.
+ *
+ * Design note: `docs/planning/Atlas-Phase-4-Design.md` §2.
+ *
+ * A symbolic witness claims `lhs = rhs`. The runner forms the DIFFERENCE and
+ * asks the optional CAS peer to simplify it: a difference that collapses to a
+ * literal zero is `'checked'`; one that collapses to a non-zero literal is
+ * `'refuted'`; anything else is `'unresolved'` with the reason it could not
+ * decide.
+ *
+ * ## The simplifier is INJECTED, and no test touches the registry
+ *
+ * `src/numerical/formula-registry.ts` caches its selection in module scope and
+ * exposes no reset hook, so a test that registered a stub would leak it into
+ * every later test in the same worker. {@link runSymbolicWitness} therefore
+ * takes the simplifier as a PARAMETER, defaulting to `simplifyExpr`. Tests
+ * pass a stub for the present path and `null` for the absent path; the
+ * registry is never written. One test exercises the real peer under the
+ * existing skip-when-absent pattern.
+ *
+ * `null` means "the peer is absent" and is a first-class argument value, not a
+ * forgotten one. `simplifyExpr` itself CANNOT tell absence from "nothing to
+ * simplify" — both return `simplified: false` — so when the argument is
+ * OMITTED the runner asks `isSimplifierAvailable()` first and maps absence to
+ * `null`. Without that step the default path would report a missing peer as
+ * `'not-simplified'`, the wrong reason on the one path most callers take.
+ *
+ * Deviation from the plan's wording, recorded in the design note §2.1: the
+ * plan names `getFormulaParser()` as the default. A parser cannot decide
+ * `lhs − rhs = 0`; the capability needed is SIMPLIFICATION, which lives in
+ * `expr-simplify.ts` (a different peer, `@danielsimonjr/mathts-functions`).
+ *
+ * @module atlas/witness-symbolic
+ * @internal
+ */
+import { isSimplifierAvailable, simplifyExpr } from '../composition/expr-simplify.js';
+const DEFAULT_BUDGET_MS = 5000;
+/** The numeric value of a literal leaf, or `null`. Same rule as `validator.ts`. */
+function literalValue(node) {
+    if (node.kind !== 'symbol')
+        return null;
+    if (node.name.trim() === '')
+        return null;
+    const v = Number(node.name);
+    return Number.isFinite(v) ? v : null;
+}
+/** A sentinel the timeout race resolves with; never confusable with a result. */
+const TIMED_OUT = Symbol('timed-out');
+/**
+ * Run one symbolic witness.
+ *
+ * @param spec - the claim, as two ASTs whose difference should vanish.
+ * @param simplifier - the CAS capability, or `null` when the optional peer is
+ * absent. When omitted, resolves to `simplifyExpr` if the peer is available and
+ * to `null` otherwise. Pass `null` EXPLICITLY to exercise the absent path.
+ * @returns a result; **never throws**, because a thrown error forces callers
+ * into a `catch` that cannot distinguish "did not run" from "failed".
+ * @internal
+ */
+export async function runSymbolicWitness(spec, simplifier) {
+    const started = Date.now();
+    if (simplifier === undefined) {
+        simplifier = (await isSimplifierAvailable()) ? simplifyExpr : null;
+    }
+    const base = { witnessId: spec.id, kind: 'symbolic' };
+    const elapsed = () => Date.now() - started;
+    if (simplifier === null) {
+        return {
+            ...base,
+            status: 'unresolved',
+            reason: 'peer-absent',
+            detail: 'The optional CAS peer is absent, so the claim was never examined. This is ' +
+                'not evidence against it.',
+            elapsedMs: elapsed(),
+        };
+    }
+    const difference = { kind: 'op', op: '-', args: [spec.lhs, spec.rhs] };
+    const budget = spec.budgetMs ?? DEFAULT_BUDGET_MS;
+    let outcome;
+    let timer;
+    try {
+        outcome = await Promise.race([
+            simplifier(difference),
+            new Promise((resolve) => {
+                timer = setTimeout(() => resolve(TIMED_OUT), budget);
+            }),
+        ]);
+    }
+    catch (err) {
+        return {
+            ...base,
+            status: 'unresolved',
+            reason: 'parse-error',
+            detail: `The simplifier threw rather than answering: ${String(err)}. A throw is not a ` +
+                'refutation.',
+            elapsedMs: elapsed(),
+        };
+    }
+    finally {
+        if (timer !== undefined)
+            clearTimeout(timer);
+    }
+    if (outcome === TIMED_OUT) {
+        return {
+            ...base,
+            status: 'unresolved',
+            reason: 'timeout',
+            detail: `No answer arrived within ${budget} ms. The budget bounds the WAIT, not the ` +
+                'CAS: the underlying simplification may still be running.',
+            elapsedMs: elapsed(),
+        };
+    }
+    const value = literalValue(outcome.expr);
+    if (value === 0) {
+        return {
+            ...base,
+            status: 'checked',
+            detail: 'lhs − rhs simplified to literal 0.',
+            elapsedMs: elapsed(),
+        };
+    }
+    if (value !== null) {
+        return {
+            ...base,
+            status: 'refuted',
+            detail: `lhs − rhs simplified to the non-zero constant ${value}.`,
+            elapsedMs: elapsed(),
+        };
+    }
+    return {
+        ...base,
+        status: 'unresolved',
+        reason: 'not-simplified',
+        detail: 'The difference did not reduce to a constant. The claim may still hold; this ' +
+            'simplifier could not show it.',
+        elapsedMs: elapsed(),
+    };
+}
+//# sourceMappingURL=witness-symbolic.js.map

package/dist/atlas/witness-symbolic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"witness-symbolic.js","sourceRoot":"","sources":["../../src/atlas/witness-symbolic.ts"],"names":[],"mappings":"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"}