orca/docs
Jinjing 648f207281
feat(checks-panel): auto-refresh on entering Checks tab (#1688)
Force a freshness check each time the user enters the Checks tab
(open sidebar, switch to Checks tab, or switch active worktree/branch)
so stale PR metadata, cached-null "no PR" results, stale checks, and
stale comments are surfaced immediately rather than waiting for the
cache TTL.

- Extracts entry-refresh logic into `checks-entry-refresh.ts` with a
  30 s grace window to suppress rapid show/hide duplicate fetches.
- Adds a `shouldEntryRefresh` effect in `ChecksPanel` keyed by
  `activeWorktreeId::repo.path::branch`; resets on panel hide so
  close-and-reopen re-evaluates freshness.
- Fixes a stale-closure bug in `handleRefresh`: `fetchPRChecks` is now
  called directly with the freshly resolved `headSha` after PR refresh
  instead of reusing the pre-refresh closure's captured sha.
- Adds 11 unit tests in `checks-entry-refresh.test.ts`.
- Design doc: `docs/refresh-on-checks-tab.md`.

Co-authored-by: Orca <help@stably.ai>
2026-05-10 23:16:41 -07:00
..
assets fix(readme): correct Kimi CLI link and swap Anthropic favicon for Claude glyph (#1405) 2026-05-04 13:21:56 -07:00
README.es.md chore: move Autohand Code listing after Auggie in READMEs and agent catalog 2026-05-05 00:27:36 -07:00
README.ja.md chore: move Autohand Code listing after Auggie in READMEs and agent catalog 2026-05-05 00:27:36 -07:00
README.md Revert "fix(skills): remove broken doc references in orca-cli SKILL.md" (#1638) 2026-05-09 18:03:59 -07:00
README.zh-CN.md chore: move Autohand Code listing after Auggie in READMEs and agent catalog 2026-05-05 00:27:36 -07:00
STYLEGUIDE.md Move STYLEGUIDE.md into docs/ (#1625) 2026-05-09 01:08:35 -07:00
gh-work-item-drawer-cache-flash.md fix(github-drawer): eliminate reopen flash via useSyncExternalStore (#1680) 2026-05-10 19:53:05 -07:00
gh-work-item-drawer-cache.md perf(github-drawer): cache work-item details + collapse issue fetch (#1655) 2026-05-09 23:46:30 -07:00
manual-repo-reorder.md feat(sidebar): allow manual drag-and-drop reordering of repos (#1686) 2026-05-10 23:07:28 -07:00
mobile-prefer-renderer-scrollback.md Mobile improvements: scrollback hydration, keyboard layout, and worktree-creation polish (#1423) 2026-05-04 23:24:22 -07:00
mobile-presence-lock.md Mobile: server-authoritative phone-fit state machine + race fixes + UX cleanup (#1518) 2026-05-06 21:54:23 -07:00
mobile-shared-client-per-host.md Mobile: stabilise connection + terminal-fit fixes + share one RpcClient per host (#1481) 2026-05-05 18:58:13 -07:00
refresh-on-checks-tab.md feat(checks-panel): auto-refresh on entering Checks tab (#1688) 2026-05-10 23:16:41 -07:00
resource-usage-merge-spec.md feat(telemetry): PR 4 — wire 7 core events to call sites (#1433) 2026-05-05 11:57:51 -07:00
sidebar-filter-redesign.md feat(sidebar-filter): replace dropdown with searchable popover for repo filtering (#1684) 2026-05-10 21:47:15 -07:00
sidekick-animation-state-mapping.md fix: Support Codex pet sidekick animations (#1533) 2026-05-07 23:50:20 -07:00
tasks-page-resume-state.md feat(tasks): remember tasks page resume state across sessions (#1442) 2026-05-05 11:19:50 -07:00

README.md

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.