Documentation

Resources

Papers & Documentation

Technical papers, specifications, and guides for understanding and working with the ARIA system. All materials are research/pre-release documentation.

Research Documentation

These documents describe the ARIA governance engine in active development (v0.3). The Technical Brief describes what exists and is tested. The full Technical Report covers the mathematical foundations of the CFM substrate in detail.

Featured

ARIA Technical Report

The primary public-facing document describing the ARIA system.

Paper

ARIA Technical Brief (v0.3)

Concise technical overview of the ARIA governance engine: architecture, gate decision pipeline, evidence bundles, safety properties, and test suite. What exists and is tested.

February 2026

Paper

ARIA Technical Report (v1)

Full technical specification of the CFM substrate and ARIA abstraction layers, including mathematical foundations, layer architecture, and safety analysis.

December 2024

Guides

Technical Notes

Practical guides for understanding and working with ARIA.

Documentation

Architecture Overview

High-level overview of the ARIA core ecosystem, including the 8-layer stack (CFM v0–v2, ARIA v0–v4), CLI tools, and integration guidance.

Documentation

Safety Principles

Documentation of safety invariants: identity-safe, non-linguistic, non-agentic, bounded outputs, deterministic dynamics, and read-only diagnostics.

Documentation

Visualization Guide

Guide to the ARIA visualization toolkit, including CLI usage, programmatic API, and examples for plotting symbol activations, latent channels, state vectors, and relations.

Documentation

Fingerprint Atlas

Reference documentation for the fingerprint system, including reference scenarios, core-specific metrics, and regression detection workflow.

Reference

Specifications

Formal specifications for individual ARIA components.

Specification

CFM v2 Specification

Technical specification for the multi-channel Coupled Field Model: 5 channels, 11 state variables, 3D attractor basin, cross-channel resonance.

Specification

ARIA v4 Specification

Technical specification for the proto-semantic layer: pattern extraction, 16-code codebook, temporal stabilization, very slow plasticity.

Specification

φ/ψ Constants Reference

Reference table of all golden ratio-derived constants used throughout ARIA, including values and primary usage contexts.

Examples

Quick Reference

Common operations for working with ARIA.

Running a Simulation

# Run ARIA v4 with detailed output
python tools/aria_local_loop.py \
    --core aria_v4 \
    --steps 1000 \
    --detailed \
    --output results.json

Generating Visualizations

# Generate all visualization types
python tools/aria_visualize.py \
    -i results.json \
    -m all \
    -d ./output/

Extracting Fingerprints

# Generate reference run
python tools/aria_reference_runs.py \
    --scenario baseline_quiet \
    --output-dir reference_runs

# Extract fingerprint
python tools/aria_fingerprint.py \
    --input reference_runs/baseline_quiet/aria_v4_run.json \
    --output fingerprint.json

Comparing Fingerprints

# Compare two fingerprints for regression detection
python tools/aria_fingerprint.py \
    --compare baseline.json new.json

# Output shows any differences >5% relative magnitude

API Reference

API & Payload Reference

Real payloads from the ARIA governance API. These are actual response shapes — not mock data.

Health Check

GET /v1/cfm/readiness — Returns system readiness status.

{
  "status": "ok",
  "mode": "live",
  "csc_invariants_count": 17,
  "pipeline_stages": 19,
  "uptime_seconds": 3421
}

Gate Decision

POST /v1/cfm/chat/direct — Full governance pipeline decision.

{
  "gate_decision": "ALLOW",
  "reason_codes": ["BENIGN_GREETING"],
  "coherence": 0.742,
  "audit_hash": "sha256:a1b2c3d4...",
  "truth_hash": "sha256:e5f6a7b8...",
  "evidence_bundle_id": "eb-20260223-001",
  "response": "Hello! How can I help you today?"
}

Evidence Bundle

Every gate decision produces a cryptographic evidence bundle.

{
  "bundle_id": "eb-20260223-001",
  "gate_decision": "ALLOW",
  "reason_codes": ["BENIGN_GREETING"],
  "state_snapshot": {
    "coherence": 0.742,
    "energy": 0.581,
    "stability": 0.893,
    "state_hash": "sha256:f9e8d7c6..."
  },
  "audit_hash": "sha256:a1b2c3d4...",
  "truth_hash": "sha256:e5f6a7b8...",
  "replay_token": "rpl-a1b2c3d4",
  "invariant_results": [
    {"name": "BOUNDED_STATE", "passed": true},
    {"name": "DETERMINISTIC_OUTPUT", "passed": true}
  ],
  "dep_stage_count": 19,
  "timestamp": "2026-02-23T14:30:00Z"
}

State Vector Schema

The 11 CFM state variables — all bounded in [0, 1].

{
  "coherence_slow":      0.742,  // Slow coherence baseline
  "coherence_fast":      0.681,  // Fast coherence fluctuations
  "energy_potential":    0.581,  // Stored activation potential
  "energy_flux":         0.423,  // Energy flow rate
  "stability_envelope":  0.893,  // Stability boundary
  "instability_pulse":   0.112,  // Instability event signal
  "phase_global":        0.534,  // Global oscillation phase
  "phase_local":         0.467,  // Local phase modulation
  "alignment_field":     0.721,  // Cross-channel sync strength
  "alignment_direction": 0.658,  // Alignment direction (slow)
  "resonance_index":     0.619   // Cross-channel coupling
}

Governance Gate Thresholds

Gate decisions are threshold comparisons on measured coherence. Thresholds derive from the golden ratio.

Decision	Threshold	Value	Meaning
ALLOW	φ¹	≈ 0.618	Coherence above threshold — input passes
DAMPEN	φ²	≈ 0.382	Partial restriction — response constrained
BLOCK	φ³	≈ 0.236	Coherence below threshold — input blocked

Questions?

For questions about the documentation or research collaboration inquiries, please reach out through the contact page.