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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions