---
generated_at: 2026-02-24 10:30:00
metrics:
  claims_total: 24
  claims_with_evidence: 24
  claims_without_evidence: 0
confidence_derived: 1.00
---

# 根拠レポート：API設計書

## 本レポートについて

### 目的
本レポートは、生成された設計書・ドキュメントの信頼性を検証し、人間レビュアーが効率的にレビューできるようにすることを目的としています。

### チェック方法
以下の観点でドキュメントの内容（Claim：主張）を検証しています：

1. **根拠の有無確認**：各主張に対して、ソースコード・既存設計書・要件定義書などの根拠（Evidence）が存在するか
2. **根拠との整合性**：主張の内容が根拠と矛盾していないか
3. **網羅性**：参照すべき情報源を適切にカバーしているか

### 信頼度スコアの算出
- **confidence_derived** = 根拠あり件数 / 総主張件数
- 状態「○」：根拠あり、「△」：根拠不足または要確認

### 本レポートの使い方
1. まず「サマリー」で全体の信頼度と優先レビュー項目を確認
2. 「Claims と根拠の対応」で △ の項目を重点的にレビュー
3. 「不足情報」で補完が必要な情報源を確認

---

## 1) サマリー（まず見るところ）
- 総合信頼度（derived）：**1.00**
  - 根拠あり：24 / 24、根拠なし：0
- 優先レビュー（高）
  - 根拠不足の項目はありません

## 2) 参照した情報（Evidence一覧）
> ここに「実在するもの」だけ列挙。抽出フェーズで付けたIDをそのまま出す。

- E-01: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` - OpenAPI 3.1.1仕様ファイル（メイン根拠）
- E-02: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行1-7 - API基本情報（title, version）
- E-03: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行8-42 - /global/health エンドポイント定義
- E-04: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行44-67 - /global/event エンドポイント定義
- E-05: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行69-134 - /global/config エンドポイント定義
- E-06: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行136-159 - /global/dispose エンドポイント定義
- E-07: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行161-256 - /auth/{providerID} エンドポイント定義
- E-08: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行258-426 - /project 関連エンドポイント定義
- E-09: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行428-770 - /pty 関連エンドポイント定義
- E-10: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行772-907 - /config 関連エンドポイント定義
- E-11: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行909-1151 - /experimental/tool, /experimental/worktree エンドポイント定義
- E-12: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行1205-1329 - /experimental/session, /experimental/resource エンドポイント定義
- E-13: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行1331-2057 - /session 関連エンドポイント定義
- E-14: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行2059-2180 - /session/{sessionID}/share エンドポイント定義
- E-15: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行2182-2800 - /session メッセージ関連エンドポイント定義
- E-16: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行2802-3241 - /session/{sessionID}/prompt_async, /session/{sessionID}/command, /session/{sessionID}/shell, /session/{sessionID}/revert 定義
- E-17: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行3243-3508 - /permission, /question エンドポイント定義
- E-18: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行3510-3688 - /question/{requestID}/reply, /question/{requestID}/reject 定義
- E-19: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行3690-4135 - /provider 関連エンドポイント定義
- E-20: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行4137-4470 - /find, /file 関連エンドポイント定義
- E-21: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行4472-4931 - /mcp 関連エンドポイント定義
- E-22: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行4933-5452 - /tui 関連エンドポイント定義
- E-23: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行5453-5876 - /instance, /path, /vcs, /command, /log, /agent, /skill, /lsp, /formatter 定義
- E-24: `/Users/tomoka.baba/Work/opencode-dev/packages/sdk/openapi.json` 行5914-5947 - /event エンドポイント定義

## 3) Claims と根拠の対応（レビューの主戦場）
| Claim ID | 主張 | Evidence | 状態 |
|---|---|---|---|
| C-01 | APIはOpenAPI 3.1.1仕様に準拠している | E-01, E-02 | ○ |
| C-02 | /global/health エンドポイントでヘルスチェックが可能 | E-03 | ○ |
| C-03 | /global/event エンドポイントでSSEイベント購読が可能 | E-04 | ○ |
| C-04 | /global/config エンドポイントで設定の取得・更新が可能 | E-05 | ○ |
| C-05 | /global/dispose エンドポイントで全インスタンス破棄が可能 | E-06 | ○ |
| C-06 | /auth/{providerID} エンドポイントで認証情報の設定・削除が可能 | E-07 | ○ |
| C-07 | /project 関連エンドポイントでプロジェクト管理が可能 | E-08 | ○ |
| C-08 | /pty 関連エンドポイントでPTYセッション管理が可能 | E-09 | ○ |
| C-09 | /config エンドポイントで設定とプロバイダー情報取得が可能 | E-10 | ○ |
| C-10 | /experimental/tool, /experimental/worktree エンドポイントが存在する | E-11 | ○ |
| C-11 | /experimental/session, /experimental/resource エンドポイントが存在する | E-12 | ○ |
| C-12 | /session エンドポイントでセッションのCRUD操作が可能 | E-13 | ○ |
| C-13 | /session/{sessionID}/share エンドポイントで共有機能が利用可能 | E-14 | ○ |
| C-14 | /session/{sessionID}/message エンドポイントでメッセージ送受信が可能 | E-15 | ○ |
| C-15 | /session/{sessionID}/prompt_async, command, shell, revert エンドポイントが存在する | E-16 | ○ |
| C-16 | /permission, /question エンドポイントで権限要求・質問管理が可能 | E-17, E-18 | ○ |
| C-17 | /provider エンドポイントでAIプロバイダー情報とOAuth機能が利用可能 | E-19 | ○ |
| C-18 | /find, /file エンドポイントで検索・ファイル操作が可能 | E-20 | ○ |
| C-19 | /mcp エンドポイントでMCPサーバー管理が可能 | E-21 | ○ |
| C-20 | /tui エンドポイントでTUI操作が可能 | E-22 | ○ |
| C-21 | /instance, /path, /vcs, /command, /log, /agent, /skill, /lsp, /formatter エンドポイントが存在する | E-23 | ○ |
| C-22 | /event エンドポイントでSSEイベント購読が可能 | E-24 | ○ |
| C-23 | 共通エラーレスポンス（400, 404）が定義されている | E-01 (BadRequestError, NotFoundError スキーマ) | ○ |
| C-24 | sessionIDはパターン ^ses.* に従う | E-13 (session/{sessionID} パスパラメータ定義) | ○ |

## 4) 不足情報（Unknown / Missing）
- 該当なし - すべての主張に根拠があります

## 5) リスクフラグ（レビュー観点）
- 0: 低リスク - OpenAPI仕様ファイルから直接抽出したため、信頼性が高い
- 0: 低リスク - エンドポイント定義は仕様ファイルに明確に記載されている
- 1: 中リスク - 実際の実装との整合性は別途確認が必要（仕様と実装の乖離の可能性）
- 0: 低リスク - レスポンス例はOpenAPI仕様のスキーマ定義に基づいて作成

## 6) レビュアーチェックリスト（最小）
- [ ] OpenAPI仕様ファイル（/packages/sdk/openapi.json）が最新版であることを確認
- [ ] 実際のAPIサーバーで主要エンドポイントの動作確認
- [ ] 認証方式に関する記載が実装と一致しているか確認（現在「認証なし」と記載）
- [ ] 非推奨APIの記載が正確か確認
- [ ] 実験的API（/experimental/）の安定性について開発チームに確認
