Skip to content

Add local SourceOS Agent Reliability session monitor and policy explainer #2

@mdheller

Description

@mdheller

Context

The SourceOS Agent Reliability Control Plane needs a local-first developer surface. TurtleTerm should make agent work visible and governable from the terminal, not force users into a hosted dashboard.

Related lane:

  • SocioProphet/guardrail-fabric: SourceOS Agent Reliability Control Plane spec
  • SocioProphet/socioprophet-agent-standards: SourceOS Agent Reliability Standard
  • SocioProphet/agentplane: guarded workcells, stop gates, runtime evidence

Scope

Add TurtleTerm surfaces for:

  • active agent sessions
  • guardrail decisions
  • blocked commands and remediation
  • redaction events
  • stop-gate status
  • changed files/commits/PR/CI state
  • human approval prompts
  • audit bundle export
  • Neovim handoff/navigation

UX requirements

  • Terminal-native first; no mandatory hosted service.
  • Show why blocked with policy ID, scope, reason, and remediation.
  • Show what remains before done using AgentPlane stop-gate evidence.
  • Allow local review of external-action drafts before PR/publish handoff.
  • Provide a read-only session timeline that can be exported.
  • Integrate with Neovim so files, diffs, and policy evidence are navigable.

Acceptance criteria

  • TurtleTerm can read local .sourceos/logs/guardrail-decisions.jsonl and AgentPlane evidence artifacts.
  • A blocked action is rendered with an actionable recovery path.
  • Stop-gate failures are visible before an agent claims completion.
  • No cloud telemetry is required for local operation.

Non-goals

  • Do not make TurtleTerm the source of truth. It is the local operator surface over evidence generated by guardrail-fabric and AgentPlane.
  • Do not introduce upstream/product-surface references that dilute TurtleTerm branding.

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