# 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