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

2.7 KiB Raw Blame History