# StellaOps docs2

This directory is a cleaned, deduplicated documentation set rebuilt from the existing docs tree
(excluding docs/implplan and docs/product-advisories). It keeps stable, product-level facts and
removes old status notes, duplicated architecture snapshots, and dated implementation checklists.

Assumptions baked into docs2
- Runtime: .NET 10 (net10.0) for services and libraries
- UI: Angular 17 for the console
- Data: PostgreSQL as the only canonical database
- Cache and queues: Valkey (Redis compatible)
- Object storage: RustFS (S3 compatible)
- Determinism and offline-first operation are non-negotiable

How to navigate
- product/overview.md - Vision, capabilities, and requirements
- product/roadmap-and-requirements.md - Requirements and roadmap summary
- architecture/overview.md - System map and dependencies
- architecture/workflows.md - Key data and control flows
- architecture/evidence-and-trust.md - Evidence chain, DSSE, replay, AOC
- architecture/reachability-vex.md - Reachability, VEX consensus, unknowns
- modules/index.md - Module summaries (core and supporting)
- operations/install-deploy.md - Install and deployment guidance
- operations/airgap.md - Offline kit and air-gap operations
- operations/replay-and-determinism.md - Replay artifacts and deterministic rules
- operations/runbooks.md - Operational runbooks and incident response
- release/release-engineering.md - Release and CI/CD overview
- api/overview.md - API surface and conventions
- api/auth-and-tokens.md - Authority, OpTok, DPoP and mTLS, PoE
- cli-ui.md - CLI and console guide
- data-and-schemas.md - Storage, schemas, and determinism rules
- data/persistence.md - Database model and migration notes
- data/events.md - Event envelopes and validation
- security-and-governance.md - Security policy, hardening, governance, compliance
- security/risk-model.md - Risk scoring model and explainability
- security/forensics-and-evidence-locker.md - Evidence locker and forensic storage
- contracts-and-interfaces.md - Cross-module contracts and specs
- task-packs.md - Task Runner pack format and workflow
- testing-and-quality.md - Test strategy and quality gates
- observability.md - Metrics, logs, tracing, telemetry stack
- developer/onboarding.md - Local dev setup and workflows
- developer/plugin-sdk.md - Plugin SDK summary
- sdk/overview.md - SDK and client guidance
- benchmarks.md - Benchmark program overview
- training-and-adoption.md - Evaluation checklist and training material
- glossary.md - Core terms

Notes
- Raw schemas, samples, and fixtures remain under docs/ and are referenced from docs2.
- If you need a deep schema or fixture, follow the path in data-and-schemas.md.