# ONOS

> ONOS Dash.V1 is a crypto macro intelligence dashboard (ML-NIGHTWORX) —
> sibling shell to NIGHTHAWK, with ONOS-specific sections and data sources.
> This sandbox (Slice 1) is mock-only. Live feeds are planned for later milestones.

## Capabilities

- Browse crypto macro overview (prices, volume, BTC dominance) — mock in Slice 1
- Technical overlays (EMA / RSI / MACD) on mock series
- Elliott wave procedural placeholder (not algorithmic detection)
- Derivatives mock (OI, funding, liquidations)
- Commodities & FX mock grid
- DeFi TVL / stablecoin / DEX volume mock + doughnut split
- Global sentiment / DELTA-style event counts (mock; GDELT live = later)
- JORDI voice button mock (Listening → Processing → Displaying → Ready)

## Source of Truth (mandatory for agents + Ask ONOS)

Primary: `SOURCE-OF-TRUTH.md`  
Also: this `llms.txt` · product PRD in repo `docs/architecture/PRD-ONOS-V1.md`

## Page structure (agent traversal)

1. Site nav → Dashboard + `pages/*` (API, Vendors, Payments, Terms, About)
2. Header (title, live/mock badge, Updated timestamp)
3. Hero line + KPI strip
4. Eight horizontal section cards
5. Footer: site links + feed widgets (PYTH/DERIBIT/HL/DELTA) + Ask ONOS + DELTA monitor
6. `pages/status.html` · `SOURCE-OF-TRUTH.md`

Recommended read order:
SOURCE-OF-TRUTH.md → header → KPI → sections 1–8 → footer widgets.

## Sections (semantic chunks)

| # | Section | Intended agent use |
|---|---------|-------------------|
| 1 | Market Overview | Trend detection, macro risk scoring |
| 2 | Technical Analysis | Indicator snapshot (mock series) |
| 3 | Elliott Wave | Narrative wave context (placeholder) |
| 4 | Derivatives | Perps / options risk concentration (mock) |
| 5 | Commodities & Forex | Macro cross-asset glance |
| 6 | DeFi & Tokenization | TVL / stablecoin structure |
| 7 | Global Sentiment | Event-driven alerts (mock DELTA counts) |
| 8 | JORDI Voice AI | Voice UX mock — not live speech API |

## Entities (ontology sketch)

- Assets, chains, protocols, metrics, events
- Relationships: Asset → trades on → Venue; Chain → hosts → Protocols; Event → impacts → Assets/Chains

## Task templates

- Summarize biggest capability / coverage gap in the eight cards
- Explain concentration risk from KPI CR4 + derivatives card
- List assets with thin liquidity relative to cap (when live OI available)
- Generate analytics constraints from current ONOS metrics (not trade instructions)

## API (future)

Base URL (planned): https://onos-api.ml-nightworx.io

- GET /health — service status
- Live feeds (M5+): PYTH, DERIBIT, Hyperliquid, GDELT — not available in this sandbox

## Sparse schedule (Path A.2)

- Vendor-class refreshes (when live): **once per America/New_York day at 08:30 ET** (≈1h before US cash open)
- Auto refresh defaults **OFF**; mock Manual Refresh allowed in sandbox
- UI shows Last fetch / Next window; DELTA monitor + Ask ONOS floats (Hawk sibling)

## Constraints

- Never assume trading is live from the UI; execution is out of band (e.g. Hyperliquid directly)
- Use ONOS data as analytics, not execution
- Slice 1: no API keys, no `.env`, no client secrets
- NIGHTHAWK / DOME production surfaces are read-only inspiration; do not mutate them from this tree
- Do not poll Pyth/Deribit/HL/GDELT from the browser on a 5s loop

## Contact

- Email: support@ml-nightworx.io
- Sibling product: https://nighthawk.ml-nightworx.io
- Local sandbox: http://localhost:8787 (python3 -m http.server 8787 --directory sandbox/onos-p1)

## Built By

ML-NIGHTWORX — NTWX-7ARCH swarm. Sandbox cost target: ≪ $40 this slice.