Skip to content

feat(shell): operator CLI, lifecycle schema, ADR-035 examples#30

Merged
mdheller merged 1 commit into
mainfrom
feat/shell-ergonomics-stubs
Jul 18, 2026
Merged

feat(shell): operator CLI, lifecycle schema, ADR-035 examples#30
mdheller merged 1 commit into
mainfrom
feat/shell-ergonomics-stubs

Conversation

@mdheller

Copy link
Copy Markdown
Contributor

Summary

  • scripts/sourceosctl: bash operator CLI — explain {writes,sync,browser,terminal,logs,compromise}, state-integrity status [--json] (queries sourceos-syncd if live, stubs otherwise), lifecycle status [--json] (HostRuntimeLifecycleState snapshot)
  • schemas/host-runtime-lifecycle.schema.json: JSON Schema 2020-12 for all 13 HostRuntimeLifecycle states, typed refs for identity/policy/capability/session, drainReason enforcement via if/then
  • docs/adr-035-examples.md: EngineManifest fixtures (docd/terminal/preview-renderer), BoundaryTransition fixtures (admitted/suppressed/ingress), FaultEnvelope examples, SESSION_READY→RUNNING happy path

Closes

🤖 Generated with Claude Code

, #9, #11, #15, #18)

- scripts/sourceosctl: bash CLI with explain {writes,sync,browser,terminal,logs,compromise},
  state-integrity status [--json] (queries sourceos-syncd if present, stubs otherwise),
  and lifecycle status [--json] (HostRuntimeLifecycleState RUNNING snapshot)
- schemas/host-runtime-lifecycle.schema.json: typed JSON Schema 2020-12 for all 13 lifecycle
  states (BOOT → LOCAL_READY → IDENTITY_CONFIRMED → ORG_POLICY_READY →
  CAPABILITY_GRAPH_READY → SESSION_READY → RUNNING → DRAINING → CLEANUP_RUNNING → HALTED/RECOVERY)
- docs/adr-035-examples.md: EngineManifest fixtures for docd/terminal/preview-renderer,
  BoundaryTransition fixtures (admitted, suppressed, ingress), FaultEnvelope examples
  (render-failure non-fatal, policy-violation fatal, capability-revocation fatal),
  and the SESSION_READY→RUNNING lifecycle happy path

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant