Skip to content

Latest commit

 

History

History
95 lines (70 loc) · 3.06 KB

File metadata and controls

95 lines (70 loc) · 3.06 KB
soterion
sigil glyph code_point role owner status last_reviewed
SCROLL
📜
U+1F4DC
documentation
HADES
active
2026-05-21

🜏 Soterion: 📜 documentation | owner: HADES | status: active | reviewed: 2026-05-21

annunimas-signal-grid

Spawned from the Annunimas sovereign crate blueprint. This crate is currently a projection-surface blueprint, not the live Hermes transport owner.

  • Realm: communications
  • Productizable: true
  • Role: projection surface
  • Required exports: core/state/annunimas-signal-grid.json
  • Required hooks: task ledger, ARDA visibility, Soterion trace, governance validators, memory checkpoint capture

Vision

annunimas-signal-grid is the communications projection surface for ARDA. It turns comments, alerts, pauses, review requests, and escalation cues into explicit route plans that an operator can inspect before an autonomous system acts. The crate keeps Hermes as the live transport owner while giving ARDA a stable contract for signal classification and governance-aware routing.

Getting Started

cargo test
cargo doc --no-deps

Start with the baseline route-plan examples in src/pipeline.rs, then add concrete classifiers and transport adapters outside the blueprint boundary.

Architecture Overview

flowchart TB
    Incoming[Incoming Comments and Signals] --> Classifier[Signal Classifier]
    Classifier --> Policy[Signal Grid Policy]
    Policy --> RoutePlan[Route Plan]
    RoutePlan --> HumanReview{Human Review Required?}
    HumanReview -->|yes| HUD[ARDA HUD Review Surface]
    HumanReview -->|no| Transport[Hermes Transport Owner]
    RoutePlan --> StateExport[core/state/annunimas-signal-grid.json]
    StateExport --> HUD
Loading

Relationship to ARDA

Signal Grid is ARDA's governed communications projection. It turns raw comments, alerts, pauses, and escalation cues into route plans that can be audited by the HUD and constrained by policy before any live transport acts.

Status

Blueprint-stage Rust crate. Hermes remains the live transport owner; this repo defines the stable signal-classification and route-plan contract for future runtime adapters.

Baseline

This crate blueprint starts with:

  • crate contract in src/contract.rs
  • route-plan examples in src/pipeline.rs
  • service status and governance baseline validation in src/service.rs
  • governance smoke test in tests/contract_smoke.rs

Any new agentic crate should preserve this baseline rather than retrofitting governance, memory, and state-export posture later.

Usage

use annunimas_signal_grid::pipeline::{CommentSignal, SignalGridPolicy};
use annunimas_signal_grid::service::plan_route;

let plan = plan_route(CommentSignal::NegativeSentiment, SignalGridPolicy::normal());

assert!(plan.human_review_required);

Extension Points

  • Add concrete signal classifiers before promoting beyond blueprint status.
  • Keep Hermes as the live transport owner unless this crate gets a distinct runtime path.
  • Preserve behavioral tests for routing, suppression, pause, full-stop, and alert transitions.