xiaoxue_admin
/
orca
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
orca/docs
History
Jinjing ace7db218d
perf(github-drawer): cache work-item details + collapse issue fetch (#1655) 
Reopening a GitHub issue/PR drawer paid full IPC + `gh` startup latency on
every open. Two changes here:

1. Module-level SWR cache in GitHubItemDialog.tsx keyed by
   (repoPath, issueSourcePreference, type, number). Reopening within 30s
   paints cached data instantly; older entries paint stale-then-refresh.
   Concurrent opens dedupe on a shared in-flight promise. Mutation
   handlers invalidate by (repo, type, number); a cache-generation
   counter prevents in-flight refetches from resurrecting stale data
   after a mid-flight invalidation.

2. Collapsed GraphQL query for issue details replaces 3 serial `gh`
   subprocesses (REST issue + REST comments + GraphQL participants) with
   one round-trip. Falls back to the legacy fan-out on any GraphQL error
   so historical contract is preserved.

Cross-window invalidation rides a new `gh:workItemMutated` IPC broadcast
that skips the originating sender (the source already updated its cache
optimistically — re-broadcasting would race the optimistic write).
`addIssueComment` now takes a `type` so the broadcast scopes correctly
when a PR shares its number with an issue.

Co-authored-by: Orca <help@stably.ai>
 		2026-05-09 23:46:30 -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.md perf(github-drawer): cache work-item details + collapse issue fetch (#1655) 2026-05-09 23:46:30 -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
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
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.