universal-physics-tensor 0.24.0 → 0.28.0

package/README.md

@@ -61,12 +61,14 @@ npm run upt -- audit                                       # derive the bridges
 npm run upt -- predict                                     # empty regime cells as link hypotheses
 npm run upt -- discover                                    # vet link candidates (merge/unlock/consistency)
 npm run upt -- discover --source=canonical                 # run the funnel on standard physics ALONE (no bridges)
-npm run upt -- discover --derive                           # surface machine-derived identity consequences (unreleased; --max-orders / --anchor flags available)
+npm run upt -- discover --derive                           # surface machine-derived identity consequences (--max-orders / --anchor flags available)
 npm run upt -- connectors                                  # which isolated bridges can connect to the core
 npm run upt -- coverage                                    # audit each bridge's empirical grounding
 npm run upt -- canonical                                   # the standard-physics L-layer registry (answer key)
 npm run upt -- recover                                     # validate bridges against standard physics
 npm run upt -- symbolic --simplify                         # compose + fold bridges' SYMBOLIC forms (MathTS simplify)
+npm run upt -- map --source=both --format=mermaid          # VISUAL map of the graph (Mermaid; also --format=dot|svg, --proposed, --out=PATH)
+npm run upt -- map --equation "period = 2*pi*sqrt(length/gravity)"   # drop YOUR OWN equation onto the map: dimensional check + where it lands
 # ...and YOUR OWN equations:
 npm run upt -- eval "hbar*c^3/(8*pi*G*M*k_B)" hbar=1.054571817e-34 c=299792458 G=6.6743e-11 M=1.989e30 k_B=1.380649e-23
 npm run upt -- derive period:time length:length gravity:acceleration --formula "2*pi*sqrt(length/gravity)"
@@ -85,7 +87,8 @@ and a built-in, dependency-free parser otherwise — transparently, via a
 
 See [`cli/README.md`](cli/README.md) for the full CLI reference — every command
 and alias, the `--source=catalog|canonical|both` flag, input syntax, exit codes,
-and troubleshooting.
+and troubleshooting. [`docs/architecture/PHYSICS_MAP.md`](docs/architecture/PHYSICS_MAP.md)
+shows the rendered map (`upt map --format=mermaid|dot|svg`).
 
 ## Installation
 
@@ -244,31 +247,41 @@ delivered a measured **5-6× RK4 geodesic-integrator speedup** (see [CHANGELOG](
 
 ## Development Status
 
-**Current version:** v0.24.0 on npm
-([`universal-physics-tensor`](https://www.npmjs.com/package/universal-physics-tensor),
-published 2026-06-19) — building on the **v0.8.0 → v0.23.0** rollup arc (composition
+**Current version:** v0.27.0 (GitHub release; npm `latest` is still
+[v0.25.0](https://www.npmjs.com/package/universal-physics-tensor) — the
+parser-consolidation program publishes to npm once all phases land) — building on
+the **v0.8.0 → v0.23.0** rollup arc (composition
 graph + GW170817 / BE-23 data confrontations + catalog adjudication, Part-IX
 Phase C/D, the full catalog→graph migration, the bridge-inference +
 symbolic-composition tooling, the G-9 geometrized-units adapters, the
 distributional/variational grammar primitives, the AST bridge-gradient path, and
-the **canonical-equation L-layer** with bridge↔canonical linkage). v0.24.0 adds
+the **canonical-equation L-layer** with bridge↔canonical linkage). v0.24.0 added
 the **identity-consequence surfacer** (`upt discover --derive` → machine-derived
 candidate relations, held out of the catalog pending §XXVII-B review; see
 [Part-XI](docs/specification/Part-XI-Proposed-Equations.md)), **canonical-only
 discovery** (`--source=catalog|canonical|both`), canonical-graph quality fixes
 (magnitude-gate sourcing, variable-name unification, the declared
 compton↔de-Broglie link), and architecture refactors (the `tensor↔cell` runtime
-cycle removed; the `numerical→bridges` upward dependency dropped).
+cycle removed; the `numerical→bridges` upward dependency dropped). v0.25.0 adds
+**physics-map visualization** — `upt map --format=mermaid|dot|svg` renders the
+graph (quantities = nodes, equations = junctions) from live data; SVG via the
+optional `@viz-js/viz` peer (see
+[`docs/architecture/PHYSICS_MAP.md`](docs/architecture/PHYSICS_MAP.md)). v0.26.0
+adds **`upt map --equation`** — drop your own equation onto the map, with
+**dimensional validation** and a dimension-based "did you mean?" — backed by a
+public **`parsePhysics`** (string → dimensional `ExprNode`) and single-unknown
+dimensional inference. v0.27.0 **consolidates the ASTs** — both parser front-ends
+now transpile through one normalized path to `ExprNode`, the single semantic IR.
 
 | Metric | Value |
 |---|---|
 | Bridge catalog | **44** (IDs 11-54) — 8 established · 33 speculative · 3 highly-speculative · 0 invalid; membership-adjudicated **36 bridges · 5 not-a-bridge · 3 contested**; **41-edge composition graph** (full migration, 131 centralized quantity nodes) with a bridge-inference suite — **identifiability classifier**, **retrodiction harness**, **Buckingham-π enumerator**, unified by an **`explainQuantity`** entry point, plus (v0.12) the candidate-vetting **discovery loop**, regime-prediction map, empirical-coverage audit, and **symbolic composition** (the Observable contract + MathTS simplification) |
-| Test suite | **2841** passing (4 skipped, 1 todo; incl. property-based algebra tests) across 277 files — gated by CI |
+| Test suite | **2929** passing (4 skipped, 1 todo; incl. property-based algebra tests) across 283 files — gated by CI |
 | `tsc --noEmit` | clean (src + strict `tsc -p tsconfig.tests.json`) |
 | GR validation anchors | BE-52 Mercury perihelion relErr 1.8×10⁻⁷ · BE-37 Shapiro delay relErr ~2×10⁻⁸ |
 | First derived relation | E_min(M) = ℏc³ln2/(8πGM) from BE-42 ∘ BE-16, relErr ≤ 10⁻¹² (pre-registered CT-1) |
 | First data confrontation | GW170817 → BE-36: recomputed bounds +6.5×10⁻¹⁶ / −3.1×10⁻¹⁵ vs published +7×10⁻¹⁶ / −3×10⁻¹⁵ |
-| Core capability | Dimensional AST validator (23 node kinds; valence-homogeneity + symbolic-exponent grammar, v0.13; distributional/variational primitives, v0.14) · curvature + Einstein-field-equation layers · GL4 symplectic geodesic integrator · composition graph (`composeEdges` + symbolic `composeSymbolic`) · geometrized-units adapters (G-9 increment 1, v0.13) · canonical-equation **L-layer** + bridge↔canonical linkage / F4 guard (v0.22) · **identity-consequence surfacer** (`upt discover --derive`, unreleased) |
+| Core capability | Dimensional AST validator (23 node kinds; valence-homogeneity + symbolic-exponent grammar, v0.13; distributional/variational primitives, v0.14) · curvature + Einstein-field-equation layers · GL4 symplectic geodesic integrator · composition graph (`composeEdges` + symbolic `composeSymbolic`) · geometrized-units adapters (G-9 increment 1, v0.13) · canonical-equation **L-layer** + bridge↔canonical linkage / F4 guard (v0.22) · **identity-consequence surfacer** (`upt discover --derive`, v0.24) · **physics-map visualization** (`upt map --format=mermaid\|dot\|svg`) |
 
 Release history lives in the **[CHANGELOG](CHANGELOG.md)** — from the v0.1.0
 catalog-closure milestone (40/40 AST encodings via the Wave A→Z encoding arc,