Files
orca/docs
Jinwoo-H 6ea4b10e5c design: auto-kill orphaned legacy daemons on upgrade
Legacy Orca daemon processes can survive protocol-version upgrades forever,
hoarding PTY file descriptors after their sessions have exited. This design
captures the zero-regression constraints for reclaiming those legacy daemons
without changing the current daemon lifecycle.

Use a two-tier event-driven cleanup path: sweep idle or wedged previous-version
daemons on startup, then keep live legacy sessions routed to their original
daemon and shut that daemon down when its final session exits.
2026-05-01 17:07:43 -04: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.