4d59e66043
PR-2 of ADR-0181. Lands the deterministic substrate only — no pack artifacts
(PR-3), no evals (PR-4), no Delta-CRDT wiring (PR-5), no teachers (PR-6).
Pipeline (spec §1): canonical signal → frame grid → acoustic lexer →
typed AudioIR → canonical event ordering → elliptic rotor lowering →
versor composition → AudioCompilationUnit (the future CRDT delta).
Modules (sensorium/audio/):
- types.py frozen AudioSignal/Token/Event/IR + AudioCompilationUnit.merge_key
- checksum.py layered sha256 chain (source→canonical→token→ir→manifest→projection)
- resample.py pure-numpy polyphase FIR (scipy absent; FIR taps are a PR-3 artifact)
- canonical.py mono/24kHz canonicalisation + provenance hashes
- frames.py 20ms/10ms deterministic frame grid (zero-padded tail)
- lexer.py quantized per-frame descriptors (energy/voicing/zcr/centroid/pYIN-style F0)
- parser.py runs → typed spans/events (pause/speech/prosody/turn/non-speech)
- operators.py elliptic-ONLY rotor registry; planes {6,7,8,10,11,13} square to -1
- compiler.py compile_events serialization barrier (ADR-0181 §2.1) + checksum chain
- trace.py trace-safe audio evidence (no PCM)
Correctness: v1 restricts to the six elliptic grade-2 planes (e_i e_j, i,j∈{1..4})
so every rotor and every composition is a unit versor — versor_condition < 1e-6
holds without weakening the threshold (CLAUDE.md §Non-Negotiable Field Invariant).
Non-elliptic blades (those touching e5) are rejected at OperatorSpec construction.
Tests (tests/test_audio_compiler.py, 13 passed): A-1 determinism, A-4 serialization
barrier order-sensitivity, A-5 versor condition, A-6 trace hygiene, IR-replay,
shape/dtype, elliptic-plane lawfulness. Smoke 67 + arch-invariants 40 green.
No core mutation: ingest/field/generate/vault/vocab untouched (ADR-0013).
unitize_versor is the only normalization, algebra-owned (CLAUDE.md §Normalization).
26 lines
982 B
Python
26 lines
982 B
Python
"""
|
|
sensorium/audio/trace.py — audio evidence trace (spec §6, ADR-0181 §3.1).
|
|
|
|
Produces the trace-safe record of a compiled audio chunk: the layered
|
|
checksum chain, pack identity, and the content-addressed merge key — and
|
|
NEVER raw waveform bytes (ADR-0181 §4.2 A-6 / ADR-0180 §1.5.5). This is what
|
|
a CognitiveTurnResult / TurnEvent stores as audio evidence.
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
from sensorium.audio.types import AudioCompilationUnit
|
|
|
|
|
|
def audio_evidence_trace(unit: AudioCompilationUnit) -> dict[str, object]:
|
|
"""Trace-safe evidence dict for one compiled chunk. No PCM."""
|
|
return {
|
|
"modality": "audio",
|
|
"pack_id": unit.pack_id,
|
|
"canonical_sha256": unit.canonical_sha256,
|
|
"ir_sha256": unit.ir_sha256,
|
|
"pack_manifest_sha256": unit.pack_manifest_sha256,
|
|
"projection_sha256": unit.projection_sha256,
|
|
"merge_key": list(unit.merge_key),
|
|
"versor_condition": unit.versor_condition,
|
|
}
|