docs re-org, audit fixes, build fixes

docs/README.md

@@ -4,7 +4,7 @@ StellaOps is a deterministic, offline-first container security platform: every v
 
 ## Two Levels of Documentation
 
-- **High-level (canonical):** the curated guides in `docs/*.md` (usually numbered).
+- **High-level (canonical):** the curated guides in `docs/*.md`.
 - **Detailed (reference):** deep dives under `docs/**` (module dossiers, architecture notes, API contracts/samples, runbooks, schemas). The entry point is `docs/technical/README.md`.
 
 This documentation set is internal and does not keep compatibility stubs for old paths. Content is consolidated to reduce duplication and outdated pages.
@@ -13,23 +13,23 @@ This documentation set is internal and does not keep compatibility stubs for old
 
 | Goal | Open this |
 | --- | --- |
-| Understand the product in 2 minutes | [overview.md](/docs/overview/) |
-| Run a first scan (CLI) | [quickstart.md](/docs/quickstart/) |
-| Browse capabilities | [key-features.md](/docs/key-features/) |
-| Roadmap (priorities + definition of "done") | [05_ROADMAP.md](/docs/05_roadmap/) |
-| Architecture: high-level overview | [40_ARCHITECTURE_OVERVIEW.md](/docs/40_architecture_overview/) |
-| Architecture: full reference map | [07_HIGH_LEVEL_ARCHITECTURE.md](/docs/07_high_level_architecture/) |
-| Architecture: user flows (UML) | [technical/architecture/user-flows.md](/docs/technical/architecture/user-flows/) |
-| Architecture: module matrix (46 modules) | [technical/architecture/module-matrix.md](/docs/technical/architecture/module-matrix/) |
-| Architecture: data flows | [technical/architecture/data-flows.md](/docs/technical/architecture/data-flows/) |
-| Architecture: schema mapping | [technical/architecture/schema-mapping.md](/docs/technical/architecture/schema-mapping/) |
-| Offline / air-gap operations | [24_OFFLINE_KIT.md](/docs/24_offline_kit/) |
-| Security deployment hardening | [17_SECURITY_HARDENING_GUIDE.md](/docs/17_security_hardening_guide/) |
-| Ingest advisories (Concelier + CLI) | [10_CONCELIER_CLI_QUICKSTART.md](/docs/10_concelier_cli_quickstart/) |
-| Develop plugins/connectors | [10_PLUGIN_SDK_GUIDE.md](/docs/10_plugin_sdk_guide/) |
-| Console (Web UI) operator guide | [15_UI_GUIDE.md](/docs/15_ui_guide/) |
-| VEX consensus and issuer trust | [16_VEX_CONSENSUS_GUIDE.md](/docs/16_vex_consensus_guide/) |
-| Vulnerability Explorer guide | [20_VULNERABILITY_EXPLORER_GUIDE.md](/docs/20_vulnerability_explorer_guide/) |
+| Understand the product in 2 minutes | [overview.md](overview.md) |
+| Run a first scan (CLI) | [quickstart.md](quickstart.md) |
+| Browse capabilities | [key-features.md](key-features.md) |
+| Roadmap (priorities + definition of "done") | [ROADMAP.md](ROADMAP.md) |
+| Architecture: high-level overview | [ARCHITECTURE_OVERVIEW.md](ARCHITECTURE_OVERVIEW.md) |
+| Architecture: full reference map | [ARCHITECTURE_REFERENCE.md](ARCHITECTURE_REFERENCE.md) |
+| Architecture: user flows (UML) | [technical/architecture/user-flows.md](technical/architecture/user-flows.md) |
+| Architecture: module matrix (46 modules) | [technical/architecture/module-matrix.md](technical/architecture/module-matrix.md) |
+| Architecture: data flows | [technical/architecture/data-flows.md](technical/architecture/data-flows.md) |
+| Architecture: schema mapping | [technical/architecture/schema-mapping.md](technical/architecture/schema-mapping.md) |
+| Offline / air-gap operations | [OFFLINE_KIT.md](OFFLINE_KIT.md) |
+| Security deployment hardening | [SECURITY_HARDENING_GUIDE.md](SECURITY_HARDENING_GUIDE.md) |
+| Ingest advisories (Concelier + CLI) | [CONCELIER_CLI_QUICKSTART.md](CONCELIER_CLI_QUICKSTART.md) |
+| Develop plugins/connectors | [PLUGIN_SDK_GUIDE.md](PLUGIN_SDK_GUIDE.md) |
+| Console (Web UI) operator guide | [UI_GUIDE.md](UI_GUIDE.md) |
+| VEX consensus and issuer trust | [VEX_CONSENSUS_GUIDE.md](VEX_CONSENSUS_GUIDE.md) |
+| Vulnerability Explorer guide | [VULNERABILITY_EXPLORER_GUIDE.md](VULNERABILITY_EXPLORER_GUIDE.md) |
 
 ## Detailed Indexes