ZPE-Robotics

ZPE-Robotics is the public repository for the zpe-motion-kernel package. The current public artifact is a standalone Python package for frozen wire-v1 motion transport, replay, search, and audit workflows. The repo and package are public, but the governing engineering surface remains blocker-state and is not a full robotics-platform release.

Surface	Current truth
Repository	https://github.com/Zer0pa/ZPE-Robotics.git
Package / import / CLI	zpe-motion-kernel / zpe_robotics / zpe
Acquisition surface	pip install zpe-motion-kernel
License	LicenseRef-Zer0pa-SAL-6.0
Contact	architects@zer0pa.ai
Release state	public repo and published package; engineering surface remains blocker-governed
Engineering	not complete
Current authority	proofs/ENGINEERING_BLOCKERS.md

Authority layer	File
governing blocker state	proofs/ENGINEERING_BLOCKERS.md
benchmark gate verdicts	proofs/enterprise_benchmark/GATE_VERDICTS.json
adversarial verdicts	proofs/red_team/red_team_report.json
package/runtime boundary	proofs/runbooks/TECHNICAL_RELEASE_SURFACE.md
IMC integration boundary	proofs/imc_audit/imc_architecture_audit.json

Surface	Current truth
Benchmark gates	B1, B2, B4, and B5 pass; B3 fails
Real-data benchmark	187.1345x on lerobot/columbia_cairlab_pusht_real
Red-team	attacks 1, 2, and 6 withstand; 4 partially withstands; 3 and 5 fail; 7 remains open
Replay claim boundary	strict bit-exact replay is not proven on the current .zpbot round-trip
Searchability	supported without decode on the benchmark surface
Rust integration	no robotics .zpbot Rust ABI is wired into this repo
Release workflow	GitHub OIDC workflow is aligned; PyPI UI registration is still operator-only
Release-ready verdict	not authorized; public visibility does not erase blockers

Area	Purpose
src/zpe_robotics/	package implementation, CLI, packet handling, search, anomaly, and audit logic
tests/	release-surface, CLI, codec, and regression checks
scripts/	replay, benchmark, falsification, and clean-clone helpers
docs/	front-door, architecture, support, legal, and family-linkage docs
proofs/	blockers, benchmark artifacts, red-team outputs, release runbooks, and historical bundles
.github/workflows/	CI, clean-clone, parity, comparator, and publish workflows

• Runtime and proof artifacts outrank prose.
• GO and NO-GO language is reserved for named gates only.
• Historical proof bundles remain lineage only. They do not override the March 21 blocker-state evidence.
• No IMC runtime import is introduced by this repo.
• The current installable package artifact is zpe-motion-kernel 0.1.0, but the repo's March 21 blocker-state docs remain the authority surface for engineering status.

Use these files together:

Need	Read first
Current blocker truth	proofs/ENGINEERING_BLOCKERS.md
Benchmark verdicts	proofs/enterprise_benchmark/GATE_VERDICTS.json
Adversarial findings	proofs/red_team/red_team_report.json
Package/runtime boundary	proofs/runbooks/TECHNICAL_RELEASE_SURFACE.md
Release-candidate note	docs/RELEASE_CANDIDATE.md
Citation record	CITATION.cff
Docs registry	docs/DOC_REGISTRY.md
Historical lineage	proofs/artifacts/historical/README.md

Public package install:

pip install zpe-motion-kernel
zpe --version

Repo-local engineering surface:

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip setuptools wheel
python -m pip install -e ".[dev,benchmark,telemetry,netnew]"
python -m pytest tests -q
python -m build

If you need the shortest honest verification route, use docs/AUDITOR_PLAYBOOK.md. If you need the release workflow boundary, use RELEASING.md.

Need	Route
Contributor workflow	CONTRIBUTING.md
Security reporting	SECURITY.md
Governance and claim policy	GOVERNANCE.md
Support routing	docs/SUPPORT.md
Docs index	docs/README.md
Operator commands	docs/OPERATOR_RUNBOOK.md