stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
main
git.stella-ops.org/docs/modules/tools/README.md

2.7 KiB
Raw Permalink Blame History

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