Files
git.stella-ops.org/docs/modules/tools/README.md

42 lines
1.5 KiB
Markdown

# 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