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
    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