Skip to content

Expose SourceOS State Integrity context in shell ergonomics #7

@mdheller

Description

@mdheller

Purpose

SourceOS Shell should expose State Integrity context as ambient local-first operating state.

Canonical spec: SourceOS-Linux/sourceos-spec/docs/architecture/sourceos-state-integrity-layer.md
Program tracker: SourceOS-Linux/sourceos-spec#83

Required context

  • active profile
  • active workspace
  • active device
  • daemon availability
  • degraded state
  • policy block state
  • conflict state
  • repair-needed state
  • repo/worktree relation where applicable

Requirements

  • Consume structured CLI/daemon state, not raw log scraping.
  • Keep shell output quiet unless state needs operator attention.
  • Route users to sourceos sync status, sourceos sync doctor, and sourceos sync explain <object>.
  • Coordinate with TurtleTerm and Neovim surfaces.

Acceptance criteria

  • SourceOS Shell has a documented State Integrity context contract.
  • Prompt/status integration distinguishes clean, degraded, conflicted, policy-blocked, and offline/local-only states.
  • Shell ergonomics do not assume cloud connectivity.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions