feat(physics): chiral orientation sign-gate — sgn(Q)=const fail-closed (ADR-0241 §2.4C)
All checks were successful
lane-shas / verify pinned lane SHAs (pull_request) Successful in 17m17s
smoke / smoke (-m "not quarantine") (pull_request) Successful in 5m8s

Builds the one missing safeguard from the 4-blueprint integration audit:
the mirror-inversion protection (core_ha §5.2: sgn(∫⟨ψ I₅ ψ̃⟩₀) = const).
The chiral charge was a verified non-vacuous READOUT, but goldtether took
abs(), discarding the sign — orientation was measured, never enforced.

- core/physics/chiral_gate.py: ChiralOrientationGate latches sgn(Q) on the
  first non-vacuous reading (|Q| >= 0.1 floor); a materially re-emerging
  flip raises ChiralOrientationError (fail-closed; a sign flip is
  unreachable under rotor transport, so it evidences corruption).
  Even field-states stay vacuous — no orientation fabricated, no #19
  revival; the gate is behaviorally inert on today's serve path.
- goldtether_residual now feeds the SIGNED charge to the gate; the
  residual term keeps magnitude-only semantics byte-identical (pinned).
- Docs: integration-plan missing-piece row -> BUILT; fidelity ledger §12
  gains the failable pin row.

TDD RED->GREEN. [Verification]: smoke suite passed locally (141s, 175
passed); gate suite 7 passed; goldtether-consumer regression 99 passed.
This commit is contained in:
Shay 2026-07-15 13:35:08 -07:00
parent 25772154ff
commit 301742a38a
5 changed files with 309 additions and 3 deletions

122
core/physics/chiral_gate.py Normal file
View file

@ -0,0 +1,122 @@
"""Chiral orientation gate — sgn(Q) preservation (ADR-0241 §2.4C / core_ha §5.2).
The topological spinor charge Q = ψ I₅ ψ̃ anchors the global orientation of
the cognitive manifold: "preserving the sign and magnitude of Q_top across all
scales prevent[s] mirror-image inversions" (ADR-0241 §2.4C), and the
core_ha unification memo pins the invariant safeguard as sgn(Q) = const
(§5.2). The substrate already carries a verified non-vacuous READOUT
(:meth:`WaveManifold.chiral_charge` conserved exactly under ψ ), but
its only consumer took ``abs(...)``, discarding the sign. This module is the
missing ENFORCEMENT: latch the orientation on the first non-vacuous reading,
fail closed on any materially re-emerging flip.
Honesty pins (#19 family):
* Even field-states have Q structurally ~0 no orientation is defined and
the gate never fabricates one (``vacuous``; the retired grade-5 gate is
not revived). Serve-path even versors therefore never latch: wiring this
gate into GoldTether is behaviorally inert for today's serve fields.
* |Q| may legitimately pass below the floor (superposition mixtures); the
latch persists and only a materially re-emerging opposite sign violates.
Tier-1 module: imported by ``goldtether`` (sanctioned serve substrate).
Algebra-native only; no teaching/vault imports.
"""
from __future__ import annotations
from dataclasses import dataclass, field
from typing import Any, Literal
import numpy as np
from core.physics.wave_manifold import WaveManifold
#: Below this |Q|, orientation is undefined (even-field honesty; #19 family).
DEFAULT_Q_FLOOR = 0.1
class ChiralOrientationError(ValueError):
"""Fail-closed chiral orientation violation (mirror inversion).
A sign flip of Q is unreachable under sanctioned rotor transport (Q is
strictly conserved under left unitary multiplication), so a materially
flipped sign is evidence of a non-unitary / corrupting transition and the
gate refuses it rather than averaging it away.
"""
def __init__(self, reason: str, **disclosure: Any) -> None:
self.reason = reason
self.disclosure = dict(disclosure)
super().__init__(f"chiral_orientation refused [{reason}]: {self.disclosure}")
@dataclass(frozen=True, slots=True)
class ChiralObservation:
"""One gate reading with an honest epistemic verdict."""
q: float
sign: int # 1 / +1, or 0 when |q| < q_floor (no orientation defined)
latched_sign: int # 0 until the first non-vacuous reading
verdict: Literal["vacuous", "latched", "conserved"]
def as_dict(self) -> dict[str, Any]:
return {
"q": self.q,
"sign": self.sign,
"latched_sign": self.latched_sign,
"verdict": self.verdict,
}
@dataclass(slots=True)
class ChiralOrientationGate:
"""Monitor-style latch for the global chiral orientation sign.
* First reading with |Q| ``q_floor`` latches ``sgn(Q)``.
* Later readings: same sign ``conserved``; |Q| < floor ``vacuous``
(latch persists); opposite sign at material |Q| raises
:class:`ChiralOrientationError` (fail-closed; never averages).
"""
q_floor: float = DEFAULT_Q_FLOOR
latched_sign: int = 0
_wave: WaveManifold = field(default_factory=WaveManifold)
def observe(self, psi: np.ndarray) -> ChiralObservation:
"""Read Q from the field and enforce sign preservation."""
return self.observe_q(self._wave.chiral_charge(psi))
def observe_q(self, q: float) -> ChiralObservation:
"""Enforce sign preservation on a precomputed charge readout."""
q = float(q)
sign = 0 if abs(q) < self.q_floor else (1 if q > 0.0 else -1)
if sign == 0:
# No orientation defined at this reading; latch (if any) persists.
return ChiralObservation(
q=q, sign=0, latched_sign=self.latched_sign, verdict="vacuous"
)
if self.latched_sign == 0:
self.latched_sign = sign
return ChiralObservation(
q=q, sign=sign, latched_sign=sign, verdict="latched"
)
if sign == self.latched_sign:
return ChiralObservation(
q=q, sign=sign, latched_sign=self.latched_sign, verdict="conserved"
)
raise ChiralOrientationError(
"orientation_flip",
q=q,
sign=sign,
latched_sign=self.latched_sign,
q_floor=self.q_floor,
)
__all__ = [
"DEFAULT_Q_FLOOR",
"ChiralObservation",
"ChiralOrientationError",
"ChiralOrientationGate",
]

View file

@ -32,6 +32,7 @@ from algebra.backend import geometric_product, versor_condition
from algebra.cl41 import N_COMPONENTS, reverse
from algebra.rotor import rotor_power, word_transition_rotor
from algebra.versor import versor_unit_residual
from core.physics.chiral_gate import ChiralOrientationGate
from core.physics.wave_manifold import WaveManifold
_CLOSURE_TOL = 1e-6
@ -152,6 +153,13 @@ class GoldTetherMonitor:
r_floor: float = 0.1
r_critical: float = 1.0
gold_invariants: list = field(default_factory=_primal_gold_invariants, compare=False)
# Chiral orientation enforcement (ADR-0241 §2.4C / core_ha §5.2):
# sgn(Q) latches on the first non-vacuous spinor reading and a materially
# re-emerging flip fails closed. Even serve field-states are vacuous
# (Q ≈ 0), so the gate never latches on today's serve path — inert there.
chiral_gate: "ChiralOrientationGate" = field(
default_factory=lambda: ChiralOrientationGate(), compare=False
)
@property
def supervised_autonomy_level(self) -> float:
@ -227,7 +235,12 @@ class GoldTetherMonitor:
# path can move the residual without a second API.
wave = WaveManifold()
drift = wave.measure_unitary_residual(F_arr)
chiral = abs(float(wave.chiral_charge(F_arr)))
# Signed charge feeds the fail-closed orientation gate (sgn(Q)=const,
# ADR-0241 §2.4C / core_ha §5.2). The residual term keeps its
# magnitude-only semantics unchanged below.
q_signed = float(wave.chiral_charge(F_arr))
self.chiral_gate.observe_q(q_signed)
chiral = abs(q_signed)
drift_term = (
(drift + chiral) / self.epsilon_drift
if self.epsilon_drift > 0.0

View file

@ -52,7 +52,7 @@ The recurring pattern across all four docs: the blueprints were written when the
### 🔨 MISSING PIECE — capability the vision specifies but the code does **not** yet enforce; **build anew** so we don't go backwards
| Missing invariant | Current state | Build |
|---|---|---|
| **Chiral SIGN-preservation gate** (ADR-0241 §2.4C + core_ha §5.2: `sgn(∫⟨ψIψ̃⟩₀)=const`, mirror-inversion protection) | `chiral_charge` is a verified non-vacuous **readout**, but its only consumer (`goldtether.py:230`) takes `abs(...)`**discarding the sign** — and it's ~0 on serve-path even-versors. No fail-closed `sgn(Q)=const` gate exists. | A `chiral_orientation_gate` that latches the initial sign and fails closed on flip during transport; wire the *signed* charge (not `abs`) where a non-vacuous spinor path exists. Preserves the "topologically secure alignment" the blueprint promises. |
| **Chiral SIGN-preservation gate** (ADR-0241 §2.4C + core_ha §5.2: `sgn(∫⟨ψIψ̃⟩₀)=const`, mirror-inversion protection) | **BUILT** (`feat/chiral-sign-preservation-gate`, stacked on PR #40): `core/physics/chiral_gate.py``ChiralOrientationGate` latches `sgn(Q)` on the first non-vacuous reading, fails closed (`ChiralOrientationError`) on a materially re-emerging flip; wired at the enforcement point (`goldtether_residual` now feeds the *signed* charge to the gate; residual keeps magnitude semantics byte-identical). Even serve fields stay vacuous → inert on today's serve path (no #19 revival). Pins: `tests/test_chiral_orientation_gate.py` (7). | — (was: latch initial sign + fail closed on flip; wire signed charge) |
| **CRDT delta-sync semilattice** (core_ha §2/§3 tombstone → "commutative/associative/idempotent Delta-CRDT in `core/sync/`") | `core/sync/` is a journal/object-store (no `merge`/idempotent/semilattice semantics found). Determinism today = bit-exact `array_codec` + single-writer `VaultStore` (Shape B+), **not** multi-writer CRDT merge. | Decide: either build the CRDT (needed for genuine multi-agent/multi-writer "one continuous life") **or** correct the doc to state determinism is single-writer bit-exact. Don't leave the claim floating. |
### ⛔ SCRAP / DO-NOT-BUILD — correctly rejected over-claims
@ -83,7 +83,7 @@ The recurring pattern across all four docs: the blueprints were written when the
1. **DONE** — Finding #2 serve-boundary reconciliation (de-barrel + transitive guard + A-04/ledger correction). Green.
2. **Next fix-forward (LOW, batch):** downgrade anyon ledger row; `EpistemicStatus` boundary note (or relocate to shared kernel); Fibonacci `minimizer` docstring; `ClosureViolationException` naming note.
3. **Build-anew (capability):** chiral **sign-preservation gate** (§5.2) — the one true missing safeguard; TDD a `sgn(Q)=const` fail-closed gate + signed wiring.
3. **DONE** — chiral **sign-preservation gate** (§5.2) built TDD (RED→GREEN) on `feat/chiral-sign-preservation-gate`: gate primitive + goldtether wiring + 7 pins; 99 goldtether-consumer tests green.
4. **Decision + build/doc:** CRDT-vs-bit-exact determinism story for `core/sync` (affects multi-agent "one continuous life").
5. **Get ADR-0242 memo export** → close its fidelity slice (evidence-gated-optimization vs the cert impl; confirm no further deviations).
6. Staged/gated items (Rust parity D9, sensorium compilers, continuous integrals) remain post-Accept backlog.

View file

@ -309,6 +309,7 @@ PY
| Physics Cl(4,1) via `algebra.backend` (P11a) | 🟢 wave/goldtether/trajectory/procrustes/surprise/vault/packing; AST pin; Rust when `CORE_BACKEND=rust` |
| Contemplation Trace A SPECULATIVE holographic seal (P9) | 🟢 `core/contemplation/wave_seam.py` (hypothesis vs COHERENT evidence) |
| Energy boundary + multi-scale τ (P10 Trace B) | 🟢 `wave_energy_boundary` (wave residual → energy/trajectory; τ_n=F_n·τ_0; E0E1 crystallization) |
| Chiral orientation sign-gate \(\mathrm{sgn}(Q)=\text{const}\) (§2.4C / core_ha §5.2 mirror-inversion safeguard) | 🟢 `chiral_gate.ChiralOrientationGate` — latch on first non-vacuous \(Q\), fail-closed `ChiralOrientationError` on flip; wired via signed charge in `goldtether_residual` (residual value unchanged; even fields vacuous → serve-inert, no #19 revival). Pins: `test_chiral_orientation_gate.py` |
### Subsumption map (Slice 23)
| Operator | Delegation |

View file

@ -0,0 +1,170 @@
"""ADR-0241 §2.4C / core_ha §5.2 — chiral orientation gate (sgn(Q) = const).
RED until core/physics/chiral_gate.py lands.
The blueprint's mirror-inversion safeguard: the global chiral anomaly sign of
the spinor field must stay constant "preserving the sign … anchors the
global orientation of the cognitive manifold, preventing mirror-image
inversions." The substrate has a verified non-vacuous READOUT
(WaveManifold.chiral_charge; Q = ψ I₅ ψ̃), but its only consumer
(GoldTetherMonitor.goldtether_residual) takes abs(), discarding the sign
so orientation was measured, never enforced (integration-plan missing piece).
Fixture algebra (grade-1 v, central I₅ with I₅² = 1, Ĩ₅ = I₅):
Q(v + v·I₅) = 2 and Q(v v·I₅) = +2
so the mirror pair is a genuine sign flip and it is unreachable by any
rotor transport (Q is strictly conserved under ψ ), i.e. it models
exactly the corruption class the gate exists to catch.
"""
from __future__ import annotations
import numpy as np
import pytest
from algebra.cl41 import N_COMPONENTS, geometric_product
from algebra.rotor import make_rotor_from_angle
from core.physics.chiral_gate import (
ChiralObservation,
ChiralOrientationError,
ChiralOrientationGate,
)
from core.physics.goldtether import GoldTetherMonitor
from core.physics.wave_manifold import WaveManifold, _I5
def _e(i: int, val: float = 1.0) -> np.ndarray:
v = np.zeros(N_COMPONENTS, dtype=np.float64)
v[i] = val
return v
def _spinor_pair() -> tuple[np.ndarray, np.ndarray]:
"""(ψ, mirror-ψ) with Q(ψ) = 2.5 and Q(mirror) = +2.5."""
v = _e(1) + 0.5 * _e(3)
psi = v + geometric_product(v, _I5)
mirror = v - geometric_product(v, _I5)
return psi, mirror
# --- Latch + conservation ----------------------------------------------------
def test_gate_latches_then_reports_conserved_under_left_spinor_transport():
gate = ChiralOrientationGate()
M = WaveManifold()
psi, _ = _spinor_pair()
first = gate.observe(psi)
assert isinstance(first, ChiralObservation)
assert first.verdict == "latched"
assert first.sign == -1
assert first.latched_sign == -1
assert abs(first.q) > 0.1
R = make_rotor_from_angle(0.4, bivector_idx=7)
psi_next = M.left_spinor_step(psi, R)
second = gate.observe(psi_next)
assert second.verdict == "conserved"
assert second.sign == -1
assert abs(second.q - first.q) < 1e-9 # Q strictly conserved
def test_gate_fails_closed_on_mirror_inversion():
gate = ChiralOrientationGate()
psi, mirror = _spinor_pair()
gate.observe(psi)
with pytest.raises(ChiralOrientationError, match="orientation_flip"):
gate.observe(mirror)
# --- Even-field honesty (#19 family) ------------------------------------------
def test_gate_honest_on_even_versor_never_latches():
"""Even field-states have Q ≈ 0: no orientation is defined, the gate must
not fabricate one, and repeated vacuous observations are not violations
(does not revive the retired #19 gate)."""
gate = ChiralOrientationGate()
for angle, plane in ((0.9, 11), (0.3, 6), (0.55, 8)):
obs = gate.observe(make_rotor_from_angle(angle, bivector_idx=plane))
assert obs.verdict == "vacuous"
assert obs.sign == 0
assert obs.latched_sign == 0
def test_gate_vacuous_after_latch_is_not_violation_but_flip_reemergence_is():
"""|Q| may legitimately pass below the floor (superposition states); the
latch persists, and a materially re-emerging FLIPPED sign still fails."""
gate = ChiralOrientationGate()
psi, mirror = _spinor_pair()
gate.observe(psi)
even = make_rotor_from_angle(0.7, bivector_idx=9)
mid = gate.observe(even)
assert mid.verdict == "vacuous"
assert mid.latched_sign == -1 # latch persists
same = gate.observe(psi)
assert same.verdict == "conserved"
with pytest.raises(ChiralOrientationError, match="orientation_flip"):
gate.observe(mirror)
# --- Determinism ---------------------------------------------------------------
def test_gate_determinism():
psi, _ = _spinor_pair()
even = make_rotor_from_angle(0.2, bivector_idx=6)
seq = (psi, even, psi)
def run() -> tuple[str, ...]:
gate = ChiralOrientationGate()
return tuple(gate.observe(x).verdict for x in seq)
assert run() == run() == ("latched", "vacuous", "conserved")
# --- GoldTether wiring (the enforcement point) ---------------------------------
def test_goldtether_residual_latches_and_fails_closed_on_flip():
monitor = GoldTetherMonitor()
psi, mirror = _spinor_pair()
r = monitor.goldtether_residual(psi)
assert np.isfinite(r)
assert monitor.chiral_gate.latched_sign == -1
with pytest.raises(ChiralOrientationError, match="orientation_flip"):
monitor.goldtether_residual(mirror)
def test_goldtether_residual_unchanged_and_inert_on_even_serve_fields():
"""Serve-path even field-states are vacuous: the gate never latches and
the residual VALUE is byte-identical to the pre-gate computation
(drift + abs(chiral) magnitude semantics untouched)."""
monitor = GoldTetherMonitor()
wave = WaveManifold()
F = make_rotor_from_angle(0.42, bivector_idx=8)
r = monitor.goldtether_residual(F)
assert monitor.chiral_gate.latched_sign == 0
# Replicate the pre-gate residual formula exactly (ADR-0238 §2.3): the
# gate must not perturb the value. Fresh monitors seed primal gold
# invariants, so the geometric term is live.
drift = wave.measure_unitary_residual(F)
chiral = abs(float(wave.chiral_charge(F)))
drift_term = (drift + chiral) / monitor.epsilon_drift
scale = float(np.linalg.norm(F))
min_dist = min(
float(np.linalg.norm(F - np.asarray(inv, dtype=np.float64)))
for inv in monitor.gold_invariants
)
geo_term = min_dist / scale
expected = monitor.w_drift * drift_term + (1.0 - monitor.w_drift) * geo_term
assert abs(r - expected) < 1e-15