docs(ios-runner): RUNNER_PROTOCOL.md points at the wrong file and omits recovery and busy codes

オープン初心者向け

#2,797 2026年9月23日に作成コメント 0 件リアクション 0 件担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度: 2/5
見積もり時間: 1〜3時間
初心者へのやさしさ: 75/100

issue の種類: ドキュメント
明瞭さ: 明確に書かれている
活発さ: 活発
技術スタック: swift, typescript
領域: documentation

調査の方向性

更新するファイルは apple/runner/RUNNER_PROTOCOL.md です。まず、packages/platform-apple/src/runner/runner-contract.ts:53-94 で現在のコマンド名の位置を確認します。次に、リカバリコードとエラーコードのリンク先ファイル runner/runner-command-recovery.ts、AgentDeviceRunnerUITests/RunnerTests+Transport.swift、RunnerTests+CommandJournal.swift を調べます。正しい参照と簡単な説明でドキュメントを更新し、すべてのシンボルが git grep で存在することを確認します。最後に、pnpm check:agent-guidance を実行して変更がパスすることを確認します。

索引モデルが issue の本文から書いたものです。

説明

documentation good first issue ready-for-agent

Purpose

apple/runner/RUNNER_PROTOCOL.md:67 says the command names live in runner-client.ts. They are in packages/platform-apple/src/runner/runner-contract.ts:53-94. The doc also doesn't mention:

commandId and status recovery (the command journal)
runnerFatal and runnerMainThreadBusy
the error codes RUNNER_BUSY, RUNNER_WEDGED and MAIN_THREAD_TIMEOUT

Line references are at 01328de411.

Required behavior

Fix the pointer.
Add a short section for each missing concept: when it is produced, what it means, and what the daemon does with it. Link to the declaration sites (runner-contract.ts, runner/runner-command-recovery.ts, apple/runner/AgentDeviceRunner/AgentDeviceRunnerUITests/RunnerTests+Transport.swift, RunnerTests+CommandJournal.swift) and don't copy tables.

Completion conditions

Every symbol the doc names exists: check with git grep.
pnpm check:agent-guidance is green, if the doc is part of that check.

主要言語: TypeScript
スター: 4.7k
フォーク: 304
平均マージ: 11時間 46分
マージ済み PR（30日）: 496

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

callstack/agent-device のほかの issue

fix(install): install-from-source sends no User-Agent, so GitHub rejects it オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

callstack/agent-device#2842 · 2026年9月23日に作成
Parser fuzz validation targets: findings ledger and kill criterion (#1781 B2) オープン

難易度 2/5 1〜3時間初心者へのやさしさ 68/100

callstack/agent-device#1869 · 2026年8月19日に作成
Carry the gesture no-effect fact on the snapshot tree like unsettledGesture オープン

難易度 3/5 1〜2日初心者へのやさしさ 55/100

callstack/agent-device#2856 · 2026年9月23日に作成
Disclose an unsettled post-gesture surface on selector-targeted interactions オープン

難易度 3/5 1〜2日初心者へのやさしさ 65/100

callstack/agent-device#2853 · 2026年9月23日に作成
Opt-in inactivity expiry for local device claims オープン

難易度 4/5 3〜5日初心者へのやさしさ 45/100

callstack/agent-device#2833 · 2026年9月23日に作成

callstack/agent-device の issue をすべて見る

似ている issue

Ajv defaults: non-standard "format": "json" in third-party schemas (e.g. Notion) warns twice per property — register it like #2601 オープン

難易度 2/5 1〜3時間初心者へのやさしさ 70/100

modelcontextprotocol/typescript-sdk#2854 · 2026年9月24日に作成
[Bug]: ctx_search rejects singular 'query' param despite schema declaring it valid オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

mksglu/context-mode#1200 · 2026年9月24日に作成
[chore]: test(search): Migrate ResultItemTitle unit tests to TypeScript オープン

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

jaegertracing/jaeger-ui#4506 · 2026年9月24日に作成
[BUG] "$250 credit for cloud sessions" gift icon is unclickable オープン

area:desktop area:ui bug platform:macos

難易度 2/5 1〜3時間初心者へのやさしさ 75/100

anthropics/claude-code#96687 · 2026年9月24日に作成
[GOOD FIRST ISSUE]: Clean Up Frontend Authentication Page & Context オープン

good first issue

難易度 1/5 1時間未満初心者へのやさしさ 95/100

AOSSIE-Org/DebateAI#582 · コメント 2 件 · 2026年9月24日に作成

TypeScript の issue をもっと見る