Status: ROOT_AUDIT_VERIFIED Ring Role: Core / normative protocol authority Claim Boundary: deterministic integrity floor, byte audit, and ring governance only
Riverbraid-Core is the deterministic integrity floor for the Riverbraid architecture.
It defines the minimum governance substrate used to make structure, authority, and drift visible before trust is granted. It does not claim to implement the full experimental Riverbraid research surface. Outer repositories may extend, visualize, adapt, or experiment, but Riverbraid-Core remains the canonical reference for protocol authority and audit behavior.
Riverbraid is an open-source deterministic integrity floor for AI governance: a fail-closed, byte-auditable architecture that makes structure, authority, and drift visible. Its broader research directions, including mathematical physics of cognition, memory-flow-truth braiding, and intent-aware compute, remain experimental surfaces built on top of this verified floor.
Riverbraid-Core provides:
- Ring classification and constellation audit
- Required file surface verification
- Byte-level audit of tracked repository files
- BOM detection for text surfaces
- Dirty worktree detection
- Verification output validation
- Audit manifest generation
- Append-only audit trail recording
Riverbraid-Core is normative for Riverbraid protocol governance.
It defines the audit substrate and verification rules. It does not implement domain-specific behavior for runtime forks, UI layers, signing tools, embedded ports, language surfaces, or experimental cognition layers.
Any repository outside Core must not redefine Riverbraid protocol semantics. It may only declare its role, expose its verification surface, and pass the applicable ring gates.
Any change to these files requires a full Ring 2 verification pass before being treated as valid:
- constellation-audit.mjs
- byte-audit.mjs
- cluster-manifest-v2.json
- verify-output.json
- audit-output.json
- AUDIT-MANIFEST.sha256
- AUDIT-TRAIL.ndjson
Required checks: node constellation-audit.mjs --ring 2 node byte-audit.mjs --ring 2
Expected verified states:
- RING_GATE_PASS_VERIFIED
- BYTE_GATE_PASS_VERIFIED
Core owns protocol authority and audit rules. Outer rings own implementation surfaces, runtime experiments, bridges, tools, visualization, and communication layers. Core must remain small enough to audit directly. New experimental behavior belongs outside Core unless it is required for the integrity floor itself.
The Core audit path is linear:
- Declare manifest
- Check required files
- Read verifier outputs
- Hash tracked bytes
- Reject BOM
- Reject dirty worktrees
- Emit audit manifest
- Record audit trail
The broader Riverbraid research surface may remain nonlinear, experimental, expressive, or exploratory. That layer does not override Core verification.
Riverbraid-Core is stationary when all of the following are true:
- Local worktree is clean
- Required files are present
- Verifier outputs parse successfully
- Ring 2 returns RING_GATE_PASS_VERIFIED
- Ring 2 returns BYTE_GATE_PASS_VERIFIED
- Audit manifest exists
- Audit trail records the verification event
- No UTF-8 BOM is present in tracked text files
Run: node constellation-audit.mjs --ring 2 node byte-audit.mjs --ring 2
Current Phase 16 byte floor result:
- BYTE_GATE_PASS_VERIFIED
- Ring 2: 8 / 8 byte verified
Riverbraid-Core supports the truthful claim that Riverbraid is a working open-source deterministic integrity floor and governance artifact.
The broader claims around True AI, mathematical physics of cognition, memory-flow-truth braiding, resonance, and intent-aware compute remain active experimental directions unless implemented, tested, and verified in dedicated repositories.