55 lines
2.7 KiB
Markdown
55 lines
2.7 KiB
Markdown
# 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
|
|
|
|
- [Architecture](./architecture.md)
|
|
- [Supply-Chain Hardening Suite](./supply-chain-hardening-suite.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
|
|
- 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
|