Developer Tools
Collection of CLI utilities, benchmarks, SDK generators, and dev portal for fixture management, policy validation, smoke testing, workflow generation, and developer experience.
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
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
- Supply-chain hardening suite: deterministic mutation/negative-path security gates under
tests/supply-chain/ - StellaOps.Bench: performance benchmarks for LinkNotMerge, VEX, Notify, Policy, and Scanner subsystems (absorbed from
src/Bench/) - StellaOps.Verifier: standalone offline evidence bundle verifier for air-gapped environments (absorbed from
src/Verifier/) - StellaOps.Sdk.Generator: multi-language SDK code generation from OpenAPI spec (absorbed from
src/Sdk/) - StellaOps.Sdk.Release: SDK release automation (absorbed from
src/Sdk/) - StellaOps.DevPortal.Site: Astro-based interactive developer portal with API docs and Try-It console (absorbed from
src/DevPortal/)
Dependencies
Upstream
- Policy Engine libraries - policy DSL parsing and schema definitions
- Scanner libraries - language analyzer and SBOM processing
- Notify libraries - notification model definitions (Bench.Notify)
- TestKit - shared test infrastructure for benchmark test projects
- System.CommandLine - CLI parsing for Verifier
- Astro/Starlight (Node.js) - DevPortal static site framework
Downstream
- CI pipelines - consume generated workflow definitions
- Test suites - consume golden fixtures and SBOM/advisory pairs
- SDK consumers - consume generated Go/Java/Python/TypeScript clients
- Auditors - consume Verifier output in air-gapped verification workflows