zpe-touch

What This Is

Bounded touch-stream codec. Contact geometry and receptor fields stay isolated from thermal, vibrotactile, and proprioceptive branches.

Touch is one lane in the Zer0pa 17-lane ZPE codec portfolio, each lane an independent encoding product for its own signal domain. Useful now, improving continuously.

The public scope is narrow by design: contact remains explicit, each fiber branch stays independent, and affective touch is out of scope. This repo ships technique evidence and CI-anchored proof artifacts, not a product-readiness claim. Compass-8 posture (V2 §7.2): NO — the internal technique evidence here is implementation, not a Compass-8 product claim.

Codec Mechanics

Key Metrics

Source: proofs/manifests/VERIFICATION_SUMMARY.md

Repo Identity

Readiness

Honest Blocker

Affective touch.; Full embodied touch.; Ambient thermal scene modeling.

What We Prove

• The frozen contact branch preserves contact geometry, receptor identity, body region, and pressure exactly on the shipped bounded surface.
• Thermal payloads roundtrip exactly on an explicit bounded branch with state and history carried in the stream. A contact-only decoder recovers 0.0 of this payload; the thermal branch decoder recovers 1.0.
• Vibrotactile payloads roundtrip exactly on an explicit bounded RA_II branch with state and history carried in the stream. Same contact-only gap: 0.0 vs 1.0.
• Proprioceptive payloads roundtrip exactly on an explicit bounded joint-angle and tension branch with ordered history carried in the stream. Same contact-only gap: 0.0 vs 1.0.
• Cross-fiber wrong-decoder collisions stay at zero across thermal, vibrotactile, and proprioceptive validation (wrong_decoder_collision_rate = 0.0 for all three).
• Same-contact/different-history cases do not alias (same_contact_history_alias_rate = 0.0 for all three fiber types).
• Native Rust backend word output and decode metadata match the local Python reference path exactly.

What We Don't Claim

• Affective touch.
• Full embodied touch.
• Ambient thermal scene modeling.
• Non-RA_II vibrotactile semantics.
• Full-body kinematics.
• Silent recovery of thermal, vibrotactile, or proprioceptive data from contact-only words.
• Compass-8 product readiness or any public product claim.
• Comparative benchmarks against external touch codecs. No named external baseline exists for this scope.

Verification Status

Proof Anchors

Repo Shape

Extended Metrics

Rows retained from the previous expanded ## Key Metrics table. The public product page uses the first four rows only.

Quick Start

cargo --version
python3 -m venv .venv
. .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install . build pytest
python -m pytest tests/test_touch_pack_regression.py tests/test_touch_native_optional.py tests/test_touch_fiber_branches.py -q
python scripts/generate_public_touch_artifacts.py
python -m build

Upcoming Workstreams

This section captures the active lane priorities — what the next agent or contributor picks up, and what investors should expect. Cadence is continuous, not milestoned.

• Deployable haptic stream API — Active Engineering. Build Python+Rust API wrapping the existing branch-isolation primitives (contact base + thermal / vibrotactile / proprioceptive fiber branches). Foundation is mature; this is the lane's transition from frozen-scope research artifact to product-shaped component. Compass-8 NO posture preserved.