stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions 2 Releases Wiki Activity
Files
c778e74e226377905c05e3c2fc91ee1ef270a4fb
git.stella-ops.org/docs/modules/cli
History
master 50abd2137f Update docs, sprint plans, and compose configuration 
Add 12 new sprint files (Integrations, Graph, JobEngine, FE, Router,
AdvisoryAI), archive completed scheduler UI sprint, update module
architecture docs (router, graph, jobengine, web, integrations),
and add Gitea entrypoint script for local dev.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-06 08:53:50 +03: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
tests fixes and sprints work
2026-01-22 19:08:46 +02:00
guides
Update docs, sprint plans, and compose configuration
2026-04-06 08:53:50 +03:00
operations
Align AOC tasks for Excititor and Concelier
2025-10-31 18:50:15 +02:00
AGENTS.md
doctor enhancements, setup, enhancements, ui functionality and design consolidation and , test projects fixes , product advisory attestation/rekor and delta verfications enhancements
2026-01-19 09:02:59 +02:00
architecture.md
Update module architecture docs and workflow tutorials
2026-03-30 17:25:37 +03:00
cli-vs-ui-parity.md
consolidation of some of the modules, localization fixes, product advisories work, qa work
2026-03-05 03:54:22 +02:00
implementation_plan.md
audit notes work completed, test fixes work (95% done), new sprints, new data sources setup and configuration
2026-01-14 10:48:00 +02:00
README.md
tests fixes and sprints work
2026-01-22 19:08:46 +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/commands/analytics.md
  • ./guides/policy.md
  • ./guides/trust-profiles.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.

Implementation Status

Epic Milestones:

  • Epic 2 (Policy Engine & Editor) – Deliver deterministic policy verbs, simulation, and explain outputs
  • Epic 4 (Policy Studio) – Add registry/promotion workflows, lint tooling, and approvals UX
  • Epic 6 (Vulnerability Explorer) – Integrate ledger/triage operations
  • Epic 10 (Export Center) – Automate export verification and Offline Kit flows
  • Epic 11 (Notifications Studio) – Manage rule/channel authoring and previews via CLI

Key Responsibilities:

  • Deterministic verbs for scan, diff, export, policy, and observability operations
  • Interactive and non-interactive authentication via Authority (device code, client credentials)
  • Offline kit workflows including bundle verification and seed installation
  • JSON outputs suitable for CI parity and golden tests

Operational Focus:

  • Maintain deterministic output fixtures and versioned command documentation
  • Support plugin catalogue for restart-only extensions
  • Keep documentation aligned with active sprint outcomes