Files
orca/docs
brennanb2025andOrca 1d727458f7 fix(dashboard): unstick bold codex inline-agent rows after retention
Auto-ack walked only `agentStatusByPaneKey`, but the inline agents list
renders the union of live + retained. When codex's TUI title flips back
to a shell label within ms of `Stop`, `onAgentExited → removeAgentStatus`
tears down the live `done` row before auto-ack can see it. The retention
sync snapshots it into `retainedAgentsByPaneKey` carrying the post-Stop
`stateStartedAt`, and the row stays bold forever.

Extend the auto-ack scan to also iterate retained entries so any row the
user is actually looking at gets acked, regardless of which map it lives
in. Extract the scan into a pure `computeAutoAckTargets` helper so the
race is testable without a DOM. The asymmetry is independent of the
title heuristic — OSC 133 (PR replacing the heuristic) does not obviate
this fix; see docs/codex-agent-row-bold-stuck.md for the full analysis.

Co-authored-by: Orca <help@stably.ai>
2026-05-05 23:50:31 -07:00
..

Orca CLI Docs

Keep this folder focused on the durable references for Orca's public CLI and runtime model.

Keep These Docs

  • orca-cli-focused-v1-status.md
    • What is actually implemented and intentionally in scope now.
  • orca-cli-v1-spec.md
    • The public CLI contract, selector grammar, JSON envelope, and command semantics.
  • orca-runtime-layer-design.md
    • Why the runtime layer exists and which boundaries it owns.
  • orca-cli-bundled-distribution.md
    • How the bundled desktop-app distribution and PATH registration model works.

Why The Folder Is Small

Earlier design and implementation work produced several planning and evaluation docs. Those were useful while the feature was taking shape, but they were intentionally removed once the implementation converged so future readers are not forced to choose between multiple overlapping sources of truth.