wip: doctor/cli/docs/api to vector db consolidation; api hardening for descriptions, tenant, and scopes; migrations and conversions of all DALs to EF v10

docs/modules/tools/README.md

@@ -0,0 +1,41 @@
+# Developer Tools
+
+> Collection of CLI utilities for fixture management, policy validation, smoke testing, and workflow generation.
+
+## Purpose
+
+Developer Tools is a collection of standalone CLI utilities used by Stella Ops developers and operators during development and CI workflows. Each tool addresses a specific concern -- refreshing golden test fixtures from live APIs, validating policy DSL files, running smoke tests, or generating CI workflow definitions. The tools are not deployed as services; they run locally or in CI pipelines.
+
+## Quick Links
+
+- [Architecture](./architecture.md)
+
+## Status
+
+| Attribute    | Value            |
+|-------------|-------------------|
+| **Maturity** | Production        |
+| **Source**   | `src/Tools/`      |
+
+## Key Features
+
+- FixtureUpdater: golden fixture refresh from live APIs
+- GoldenPairs: SBOM/advisory corpus management
+- PolicyDslValidator: policy language validation
+- PolicySchemaExporter: JSON schema export for IDE autocomplete
+- PolicySimulationSmoke: policy simulation smoke tests
+- LanguageAnalyzerSmoke: language detection tests
+- RustFsMigrator: filesystem migration for RustFS (S3-compatible) storage
+- WorkflowGenerator: CI workflow generation with F# DSL
+
+## Dependencies
+
+### Upstream
+
+- Policy Engine libraries - policy DSL parsing and schema definitions
+- Scanner libraries - language analyzer and SBOM processing
+
+### Downstream
+
+- CI pipelines - consume generated workflow definitions
+- Test suites - consume golden fixtures and SBOM/advisory pairs