stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity

audit work, fixed StellaOps.sln warnings/errors, fixed tests, sprints work, new advisories

Browse Source
This commit is contained in:
master
2026-01-07 18:49:59 +02:00
parent 04ec098046
commit 608a7f85c0
866 changed files with 56323 additions and 6231 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
docs/ARCHITECTURE_REFERENCE.md
View File

@@ -103,6 +103,28 @@ Canonical entry points:
- Installation guide: `docs/INSTALL_GUIDE.md`
- Ops and runbooks: `docs/operations/`, `docs/modules/*/operations/`
## Hybrid Logical Clock (HLC) Ordering
StellaOps uses Hybrid Logical Clocks for audit-safe job queue ordering:
| Component | Description | Documentation |
|-----------|-------------|---------------|
| HLC Library | Core HLC timestamp and clock implementation | `src/__Libraries/StellaOps.HybridLogicalClock/` |
| Scheduler Queue Chain | HLC-based enqueue with cryptographic linking | `docs/modules/scheduler/architecture.md` |
| Air-Gap Sync | Offline job merge using HLC total ordering | `docs/operations/airgap-operations-runbook.md` |
| Migration Guide | Enabling HLC ordering in existing deployments | `docs/modules/scheduler/hlc-migration-guide.md` |
| Troubleshooting | HLC-specific issue resolution | `docs/operations/runbooks/hlc-troubleshooting.md` |
Key concepts:
- **HLC Timestamp**: Tuple of `(PhysicalTime, LogicalCounter, NodeId)` for total ordering
- **Chain Linking**: Each job links to its predecessor via cryptographic hash
- **Batch Snapshots**: Periodic DSSE-signed proofs of chain state
- **Deterministic Merge**: Offline nodes can merge jobs in correct HLC order
Metrics and observability:
- Grafana dashboard: `devops/observability/grafana/hlc-queue-metrics.json`
- Alerting rules: `devops/observability/alerting/hlc-alerts.yaml`
## Data and schemas
Use these as the canonical map for schemas and contracts: