Files
orca/docs
brennanb2025andOrca 66e70d501a fix(github): resolve PR for branches whose local and remote names diverge
Two-stage resolver in a new branch-pr-resolution module:
1. Resolve @{upstream} and query gh by the remote branch name.
2. On miss, search by HEAD SHA and require headRefOid === headSha to
   reject stale/recycled branches.

Fixes the silent "no PR" when a worktree's local branch differs from
its pushed remote name (e.g. after git push origin HEAD:prefix/my-branch
with no upstream set). getPRForBranch keeps its signature and becomes a
shim; client.ts unchanged externally.

Adds conflict-summary.test.ts restoring the three conflict-summary
assertions that previously lived in client.test.ts.

Co-authored-by: Orca <help@stably.ai>
2026-04-30 14:34:40 -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.