Metadata-Version: 2.4
Name: zpe-dm3
Version: 0.1.0
Summary: Repo-surface utilities and review scaffolding for the DM3 structural diagnostic.
Author: Zer0pa-Architect-Prime
License-Expression: LicenseRef-Zer0pa-GDM3-RRL-1.0
Project-URL: Homepage, https://github.com/Zer0pa/DM3
Project-URL: Source, https://github.com/Zer0pa/DM3
Project-URL: Bug Tracker, https://github.com/Zer0pa/DM3/issues
Keywords: dm3,zer0pa,graph diagnostic,structural diagnostic
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Science/Research
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Dynamic: license-file

# DM3

> Live window into the Zer0pa lab. This is a computation diagnostic surface, not a codec or cognition claim.

## What This Is

DM3 is a deterministic graph-structure diagnostic for a fixed Android ARM64 binary; tau passes, sigma shape is scoped, R8 remains blocked.

DM3 is a graph-structure diagnostic built around a precompiled Android
aarch64 Rust binary (`dm3_runner`, SHA-256
`daaaa84a052b60523bf9d63152f1154225abf119c279aa4b3aabf14487279672`)
and a fixed 380-vertex C3-symmetric graph. The exposed relaxation state
is 380 x 192 = 72,960 dimensions, with twelve callable task modes.

The current public surface combines the promoted Session 7 closeout, the
Session 8 Phase A/A5/B3/A6 learning characterization, and the Phase G v2
closed cells through `G.2`. The headline update is narrow: the
`exp_k2_scars` trimodal sawtooth shape is now CONFIRMED for shape across
three tested cross-controls, while its magnitudes remain
configuration-dependent and explicitly not portable.

## System Mechanics

| Field | Value |
| --- | --- |
| Architecture | GRAPH_DIAGNOSTIC_STREAM |
| Substrate | Fixed 380-vertex C3-symmetric graph; 72,960-dimensional relaxation state |
| Execution | Closed Android `aarch64` Rust binary `dm3_runner` |
| Task Surface | Twelve callable task modes |
| Mechanics | Phase G controls, ARM64 determinism checks, static Tier-2 reconstruction |
| Open Gate | R8 live runtime trace remains `OPEN_TIER3_BLOCKED` |

## Key Metrics

| Metric | Value | Baseline |
| --- | --- | --- |
| CALLABLE_TASKS | 12 | binary |
| ARM64_CROSS_PLATFORM_MATCH | 5/5 step values | RM10 native Android vs Apple M1 Android ARM64 AVD |
| SIGMA_SHAPE_PORTABILITY | 3/3 configs | Phase G `G.2`, shape only |
| RECONSTRUCTION_STATIC_TIER2 | R1-R7 closed; R8 blocked | static backwards-reconstruction lane |

> Source: `CLAIMS.md`, `IS_AND_IS_NOT.md`, `CHARACTERIZATION_REPORT.md`, `CLAIM_TAU_CONFIRMED_20260424.md`, and `RECONSTRUCTION_TIER2_NOTE.md`.

## Repo Identity

| Field | Value |
| --- | --- |
| Identifier | DM3 |
| Repository | https://github.com/Zer0pa/DM3 |
| Portfolio | Computation |
| Visibility | PUBLIC |
| Default Branch | main |
| Authority Source | `proofs/manifests/CURRENT_AUTHORITY_PACKET.md` |
| License | Genesis-DM3 RRL v1.0 / repository license files |

## Readiness

| Field | Value |
| --- | --- |
| Evidence posture | staged research surface; not a portfolio verdict |
| Checks | 9 README verification rows |
| Custody boundary | latest tau raw receipts are HF-backed/not GitHub-resident in this checkout |
| Confidence | scoped by claim kill criteria |
| Authority | `CLAIMS.md`; `IS_AND_IS_NOT.md`; `CHARACTERIZATION_REPORT.md` |

### Honest Blocker

R8 remains `OPEN_TIER3_BLOCKED`; tau raw receipts are HF-backed rather than GitHub-resident in this checkout; Phase G `G.7` and later cells remain unpromoted pending chain-close handover and host-side receipt pull.

## What We Prove

- DM3 is a compiled structural diagnostic on a fixed 380-vertex
  C3-symmetric graph with a 72,960-dimensional relaxation state.
- The Session 7 closeout remains the promoted authority floor:
  `RandomAdj_v1.bin` flips R1, `RegionTags_v2.bin` flips R2, and the
  compound `RA+v2+steps=50` surface flips both while raising
  `r4.transfer_ratio`.
- The first promoted positive learning line is narrow and task-specific:
  `exp_k2_scars` learns on the scoped baseline at `--steps 20`, maps to
  a trimodal sawtooth across the 28->50 region, and has a sharp
  `49 -> 50` cliff.
- Claim `τ` confirms ARM64 cross-platform determinism for
  `exp_k2_scars`: RM10 native Android and Apple M1 Android ARM64 AVD
  emit bit-exact KPIs at `--steps {20,30,40,45,50}`.
- Claim `χ` confirms same-config path-independence on the tested Phase G
  surface: 4/4 canonical SHA comparisons match across invocation paths.
- Claim `σ″` is now CONFIRMED for shape only: Phase G `G.2` preserves
  the trimodal sawtooth across cfg-A `RandomAdj_v1`, cfg-B
  `RegionTags_v2`, and cfg-C `xnor_mini`. The values are not promoted
  as portable.
- The static backwards-reconstruction lane closes R1-R7 at Tier-2:
  the loaded fixture is exactly the Cartesian product `P_95 x K_4`, the
  internal default skeleton is exactly `P_95 x K_3`, and R8 remains the
  open Tier-3 runtime-trace gate.
- Retractions, weakenings, and rejected-before-promoted claim wordings
  stay visible in `RETRACTIONS.md` and `CLAIMS.md`.

## What We Don't Claim

- DM3 is not an AI system, not a cognition claim, and not a mystical or
  spiritual architecture.
- The `exp_k2_scars` result is not a broad "DM3 learns" claim. It is a
  scoped deterministic learning-subsystem characterization.
- Claim `σ″` does not say magnitudes are portable. Phase G `G.2` shows
  shape portability and value non-portability; cfg-B is substantially
  weaker than cfg-A or the baseline.
- Claim `ψ` is only a CANDIDATE that the baseline curve admits a cycle
  past the `49 -> 50` cliff. It is not a periodicity claim.
- `G.7`, `G.3`, `G.4`, `G.5`, and `G.5+` have no promoted outcomes on
  this surface.
- DM3 has not been reconstructed. R1-R7 are static Tier-2 evidence; R8
  needs Android argv / file-open / output-write tracing under live
  execution and remains `OPEN_TIER3_BLOCKED`.
- ARM64 determinism does not imply x86 parity, source-rebuild parity,
  GPU parity, or NPU parity.
- Source provenance remains unavailable on this public surface.

## Verification Status

| Code | Check | Verdict |
|---|---|---|
| V_01 | Canonical README spine present with parser-safe headings and field shapes | PASS |
| V_02 | Root legal, docs, package, proof, and CI scaffold preserved | PASS |
| V_03 | License Section 19 canonical-reference files surfaced at root | PASS |
| V_04 | Phase A/A5/B3/A6 and Phase G updates routed through claim ledgers | PASS |
| V_05 | `σ″` shape-vs-magnitudes distinction present | PASS |
| V_06 | R8 remains open; no complete-reconstruction language promoted | PASS |
| V_07 | Genesis-DM3 RRL v1.0 instantiated at root with matching SPDX metadata | PASS |
| V_08 | Protected files unchanged in this update: `LICENSE`, `CITATION.cff`, `TRADEMARK.md`, `CONTACT.md` | PASS |
| V_09 | Phase G partial receipt trees mirrored; `MANIFEST.tsv` update deferred to chain close | PASS |

## Proof Anchors

| Path | State |
| --- | --- |
| `proofs/manifests/CURRENT_AUTHORITY_PACKET.md` | VERIFIED |
| `CLAIMS.md` | VERIFIED |
| `IS_AND_IS_NOT.md` | VERIFIED |
| `CHARACTERIZATION_REPORT.md` | VERIFIED |
| `CLAIM_TAU_CONFIRMED_20260424.md` | VERIFIED |
| `RECONSTRUCTION_TIER2_NOTE.md` | VERIFIED |

## Repo Shape

| Field | Value |
| --- | --- |
| Proof Anchors | 6 display anchors |
| Portfolio | Computation |
| Authority Source | `proofs/manifests/CURRENT_AUTHORITY_PACKET.md` |
| Python Package | zpe-dm3 |
| Engineering Lane | `docs/restart/` + `artifacts/` |
| Support Sections | GitHub custody boundary; sibling artifact; Quick Start; Ecosystem |

## Current GitHub Custody Boundary

The README carries later claim-ledger language for tau and Phase G, but
the GitHub-resident authority packet still dates to 2026-04-22. The tau
raw receipts named by `CLAIM_TAU_CONFIRMED_20260424.md` are HF-backed
and are not present as GitHub-resident raw receipt files in this checkout.
Treat tau as a scoped claim-ledger result, not as a fully refreshed
GitHub authority packet, until README, authority packet, receipt custody,
and proof manifest all name the same boundary. The 2026-05-02 engineer
audit note records `G.7` closed on-device and `G.3` in flight, but no
host-side closeout pull, manifest update, or claim promotion has landed
on this public surface.

## Sibling Research Artifact - Genesis

Genesis (`genesis_comparative`, internal repository) is a source-available deterministic Rust pipeline on the same 95-station path base as DM3 — specifically on `P_95 ☐ K_3` (285 vertices, 567 edges, 96 triangular faces, `Aut = D_6` of order 12), which is **bit-identical to DM3's internal default skeleton** (the graph that `Dm3State::initialize → build_helix_meru → build_dual_meru` constructs when no fixture is loaded). The DM3 loaded fixture `P_95 ☐ K_4` (`Aut = C_2 × S_4`, order 48) is one discrete `K_3 → K_4` complete-graph fiber promotion away from the Genesis substrate; the relationship is lateral, not subordinate — Genesis is a source-available falsifiable instance of DM3's `K_3` surface, exercised on the same RM10 Android device. The source-built mesh authority is byte-identical between the two geometry bundles at `dual_meru_mesh.ply` SHA `7ee17457b7daeec565bb1e06982b8a1facd8169f` and `dual_meru_yantra_2d.svg` SHA `a1dbf572167960b9bd348d392d3405b1114db1ef` (same upstream Rust pipeline: `yantra_2d → lift_3d → yantra_3d_dual`). On the DM3 side, **R8 OPEN remains the open Tier-3 runtime gate** and is independent of any Genesis result — Genesis confirms or falsifies DM3's signature observables on the `K_3` surface, not DM3's runtime identity on the `K_4` surface. Cross-repository pointer: `Zer0pa/Genesis` (internal — not publicly reachable).

## Quick Start

```bash
python3 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -e .[dev]
python -m zpe_dm3 surface
python -m zpe_dm3 check
pytest -q
```

## Ecosystem

- The engineering checkout's `repo_stage/` holds the current staged DM3
  public packet that feeds this root surface.
- `docs/restart/` and `artifacts/` remain the engineering lane for
  session PRDs, handovers, and mirrored receipts.
- `proofs/` and `validation/` hold root-level authority manifests and
  repo-shape checks for review.
- Phase G partial pulls are mirrored under
  `artifacts/phase_S8_PG_followup_20260429T023308Z/` and
  `artifacts/phase_S8_PG_followup_20260429T130215Z/`; the latest G.7
  snapshot is mirrored under
  `artifacts/phase_S8_PG_followup_20260430T082723Z/`. `MANIFEST.tsv`
  remains deferred until the live chain closes. The latest pull adds
  22 G.7 in-flight receipts without a G.7 outcome.
- The 2026-05-02 repo-agent audit note is mirrored at
  `docs/restart/REPO_AGENT_NOTE_PHASE_G_G7_CLOSE_AND_G3_IN_FLIGHT_20260502T1838.md`.
  It records on-device G.7 closure and G.3 in-flight status as an
  audit boundary only; promotion waits for the chain-close handover.

### Canonical References

- Artefact Bundle Register: `ARTEFACT_BUNDLE.md` and `ARTEFACT_BUNDLE_REGISTER.tsv`
- Claims Document: `CLAIMS.md`
- Is/Is-Not Document: `IS_AND_IS_NOT.md`
- Retractions Register: `RETRACTIONS.md`
- Characterization Report: `CHARACTERIZATION_REPORT.md`
- Reconstruction Tier-2 Note: `RECONSTRUCTION_TIER2_NOTE.md`
- Licensor Contact and Licensor Identity: `CONTACT.md`
- Trademark Register: `TRADEMARK.md`
- License Date For This Version: `LICENSE` header
- Supplemental schedules: none in force at this endpoint

### Authority Notes

Session 7 closeout remains the promoted authority floor. Session 8
adds fixed-config `exp_k2_scars` determinism, a sharp `49 -> 50` cliff,
ARM64 cross-platform determinism, and the trimodal sawtooth curve
lineage. Phase G v2 is integrated only through closed cells `G.0` to
`G.2`; the 2026-04-29 partial data pulls are mirrored under
`artifacts/phase_S8_PG_followup_20260429T023308Z/` and
`artifacts/phase_S8_PG_followup_20260429T130215Z/`, with the latest
G.7 partial snapshot under
`artifacts/phase_S8_PG_followup_20260430T082723Z/`. The May 2
repo-agent note records later on-device G.7 closure and G.3 in-flight
state, but `G.7` and later cells stay out of promotion until chain
close and host-side receipt mirroring.

The reconstruction lane is static Tier-2 only. R1-R7 are public because
their evidence is host-recomputable from parsed fixtures, static
disassembly, and catalogue invariants. R8 is the open runtime authority
gate.
