stella-ops.org/git.stella-ops.org
1
0
Fork 0
Code Issues Pull Requests Actions Releases Wiki Activity
Files
main
git.stella-ops.org/docs/modules/cli
History
master 66cb6c4b8a
Some checks failed
Docs CI / lint-and-preview (push) Has been cancelled
Details
feat: Add guild charters and task boards for various components 
- Introduced guild charters for Scanner Deno, PHP, Ruby, Native, WebService, Java, Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, UI, Zastava Observer, Zastava Webhook, Zastava Core, and Plugin Platform.
- Each charter outlines the mission, scope, required reading, and working agreements for the respective guilds.
- Created task boards for Surface.Env, Surface.FS, Surface.Secrets, Surface.Validation, and Zastava components to track progress and dependencies.
- Ensured all documents emphasize determinism, offline readiness, security, and integration with shared Surface libraries.
2025-11-01 02:21:46 +02:00
..
guides
Merge branch 'main' of https://git.stella-ops.org/stella-ops.org/git.stella-ops.org
2025-10-31 19:16:43 +02:00
operations
Align AOC tasks for Excititor and Concelier
2025-10-31 18:50:15 +02:00
AGENTS.md
feat: Add guild charters and task boards for various components
2025-11-01 02:21:46 +02:00
architecture.md
feat(kms): Implement file-backed key management commands and handlers
2025-10-30 14:41:48 +02:00
implementation_plan.md
Align AOC tasks for Excititor and Concelier
2025-10-31 18:50:15 +02:00
README.md
Align AOC tasks for Excititor and Concelier
2025-10-31 18:50:15 +02:00
TASKS.md
Align AOC tasks for Excititor and Concelier
2025-10-31 18:50: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.

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.