Epic: Ark .app フル同梱化 (非エンジニア向けセットアップレス配布)

ゴール

非エンジニアが `.dmg` をダウンロード → ダブルクリックするだけで Ark を使える状態を作る。
ターミナル操作 / brew install / npm install / claude /login の事前知識を一切要求しない。

現状のセットアップ手順 (棚卸し)

子 issue

• #185 — F4 実装: tmux / ttyd を .app に同梱
• #186 — SDK 付属 claude binary をターミナルセッション (tmux send-keys) でも使う
• #187 — 初回起動時 OAuth ガイド: claude /login を Tray から誘導
• #188 — Apple Developer 登録 + notarization で Gatekeeper 警告を消す

推奨実装順

1. #186 (SDK binary 流用): 最小工数で「claude CLI 不要」が達成できる、依存追加なし
2. #185 (tmux/ttyd 同梱): F4 skeleton を実装、build-bin.yml + release.yml の link
3. #187 (OAuth UX): 上記 2 つが揃った後にダイアログ実装
4. #188 (notarization): 配布フローの最終ピース、コスト決断が必要

並列可能だが、#186 → #185 → #187 で開発者向け配布が可能になる。#188 は非エンジニア向け配布のゲート。

スコープ外

Windows 対応

• `electron-builder.yml` の build target が darwin-arm64 のみ
• CLAUDE.md 明記「macOS / Windows 非対応」(F0:B-3 Keychain 制約)
• F6 Keychain → Windows Credential Manager 切替
• `resolveUnpackedSdkClaudeExecutablePath` も `darwin / linux` 以外を弾く (PR #180)

Windows 版は別 Epic で:

• Windows 用 native build (tmux 互換? ConEmu? wsl?)
• `.exe` shebang 問題 (`.cmd` wrapper)
• Credential Manager 切替
• EV Code Signing Cert (~$300-500/年)

需要次第、本 Epic 完成後に判断。

Linux desktop `.AppImage`

現状 Linux は server mode + pm2 想定で desktop .app 未対応。本 Epic 完成 (macOS) 後に検討。

関連 PR / Issue

• PR #178: macOS .app 版を追加 (F1-F8 全フェーズ実装)
• PR #180: beacon を SDK bundled binary で動かす fix
• PR #182: release.yml smoke test
• #181: 固定ポート指定で .app bootstrap を検証する
• #183: F5 Claude CLI 自動インストーラー (A 案 - #186 採用で scope 縮小 or close 候補)

完了条件

非エンジニアが以下のフローで Ark を使い始められる:

1. Releases から `Ark.dmg` をダウンロード
2. dmg をマウント、Ark.app を Applications にドラッグ
3. 起動 → Gatekeeper 警告なし (notarized: #188)
4. Welcome dialog → 「claude.ai にログイン」を押すと OAuth flow (#187)
5. ターミナルが開いて claude が即座に応答 (#185 + #186)

This is an epic spanning child issues #185–#188 rather than a single edit. Start by reading electron-builder.yml, build-bin.yml, release.yml, and the linked child issues, then follow the recommended order beginning with #186. Done means the listed macOS flow works from downloading Ark.dmg through launching a notarized app, OAuth login, and an immediately responsive terminal.