stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
7503c19b8ffa7f2891e5e672f9cfbf7efa4e2efb
git.stella-ops.org/docs/modules/cli
History
StellaOps Bot 7503c19b8f Add determinism tests for verdict artifact generation and update SHA256 sums script 
- Implemented comprehensive tests for verdict artifact generation to ensure deterministic outputs across various scenarios, including identical inputs, parallel execution, and change ordering.
- Created helper methods for generating sample verdict inputs and computing canonical hashes.
- Added tests to validate the stability of canonical hashes, proof spine ordering, and summary statistics.
- Introduced a new PowerShell script to update SHA256 sums for files, ensuring accurate hash generation and file integrity checks.
2025-12-24 02:17:34 +02:00
..
artefacts
Refactor code structure for improved readability and maintainability; removed redundant code blocks and optimized function calls.
2025-11-20 07:50:52 +02:00
contracts
feat: Add UI benchmark driver and scenarios for graph interactions
2025-12-02 01:28:17 +02:00
guides
Add determinism tests for verdict artifact generation and update SHA256 sums script
2025-12-24 02:17:34 +02:00
operations
Align AOC tasks for Excititor and Concelier
2025-10-31 18:50:15 +02:00
prep
prep docs and service updates
2025-11-21 06:56:36 +00:00
AGENTS.md
Update AGENTS.md files across multiple modules to standardize task status update instructions and introduce a new document for Secret Leak Detection operations.
2025-11-05 11:58:32 +02:00
architecture.md
Refactor code structure for improved readability and maintainability; optimize performance in key functions.
2025-12-22 19:10:27 +02:00
implementation_plan.md
feat: Add initial implementation of Vulnerability Resolver Jobs
2025-11-18 07:52:15 +02:00
README.md
feat: Add initial implementation of Vulnerability Resolver Jobs
2025-11-18 07:52:15 +02:00

README.md

StellaOps CLI

The stella CLI is the operator-facing Swiss army knife for scans, exports, policy management, offline kit operations, and automation scripting.

Responsibilities

  • Deliver deterministic verbs for scan, diff, export, policy, and observability operations.
  • Handle interactive and non-interactive authentication via Authority (device code, client credentials).
  • Support offline kit workflows including bundle verification and seed installation.
  • Expose JSON outputs suitable for CI parity and golden tests.

Key components

  • StellaOps.Cli native AOT host.
  • Shared helpers in StellaOps.Cli.Core.
  • Restart-time plug-ins under StellaOps.Cli.Plugins.*.

Integrations & dependencies

  • Authority for token exchange.
  • Backend APIs (Scanner, Policy, Export Center, Notify).
  • Offline kit bundles and local keychain/DPoP storage.

Operational notes

  • Deterministic output fixtures under src/Cli/StellaOps.Cli.Tests.
  • Versioned command docs in docs/modules/cli/guides.
  • Plugin catalogue in plugins/cli/** (restart-only).

Related resources

  • ./guides/20_REFERENCE.md
  • ./guides/cli-reference.md
  • ./guides/policy.md

Backlog references

  • DOCS-CLI-OBS-52-001 / DOCS-CLI-FORENSICS-53-001 in ../../TASKS.md.
  • CLI-CORE-41-001 epic in src/Cli/StellaOps.Cli/TASKS.md.

Current workstreams (Q4 2025)

  • Active docs sprint: docs/implplan/SPRINT_0316_0001_0001_docs_modules_cli.md — normalised sprint naming, doc sync, and upcoming ops/runbook refresh.

Epic alignment

  • Epic 2 – Policy Engine & Editor: deliver deterministic policy authoring, simulation, and explain verbs.
  • Epic 4 – Policy Studio: integrate registry/promotion workflows, approvals, and lint tooling.
  • Epic 6 – Vulnerability Explorer: surface triage and ledger operations.
  • Epic 10 – Export Center: orchestrate export requests, verification, and Offline Kit automation.
  • Epic 11 – Notifications Studio: manage notification authoring/previews from the command line.