修正作業とPR

修正作業はフィードバックID、修正指示、完了条件、PR URLを記録します。作成にはwork-items:write、参照にはwork-items:readが必要です。

修正作業を作成する

POST /api/v1/apps/:appId/automation/change-requests
Content-Type: application/json

フィールド	必須	制約
title	必須	前後空白除去後1–160文字
instructions	必須	前後空白除去後1–10000文字
acceptanceCriteria	任意	前後空白除去後最大10000文字。既定は空文字列
issueIds	必須	同じアプリの重複しないフィードバックUUID 1–20件
clientRequestId	必須	作成リクエストを識別するUUID

フィードバックIDは実際のIDに置き換えます。新規作成前にclientRequestIdを生成し、応答が不明な場合の再試行でも維持します。

curl --fail-with-body \
  "$OPENTESTER_API_URL/apps/$OPENTESTER_APP_ID/automation/change-requests" \
  --header "Authorization: Bearer $OPENTESTER_AGENT_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{
    "title": "保存直後の一覧更新を修正",
    "instructions": "保存成功後に一覧を更新し、重複追加を防ぎます。",
    "acceptanceCriteria": "新しい項目がすぐに一度だけ表示され、画面を開き直しても残ります。",
    "issueIds": ["bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb"],
    "clientRequestId": "dddddddd-dddd-4ddd-8ddd-dddddddddddd"
  }'

201応答の例です。

{
  "changeRequest": {
    "id": "cccccccc-cccc-4ccc-8ccc-cccccccccccc",
    "appId": "aaaaaaaa-aaaa-4aaa-8aaa-aaaaaaaaaaaa",
    "title": "保存直後の一覧更新を修正",
    "instructions": "保存成功後に一覧を更新し、重複追加を防ぎます。",
    "acceptanceCriteria": "新しい項目がすぐに一度だけ表示され、画面を開き直しても残ります。",
    "issueIds": ["bbbbbbbb-bbbb-4bbb-8bbb-bbbbbbbbbbbb"],
    "status": "open",
    "pullRequestUrl": null,
    "createdBy": "eeeeeeee-eeee-4eee-8eee-eeeeeeeeeeee",
    "createdAt": "2026-10-28T02:00:00.000Z",
    "updatedAt": "2026-10-28T02:00:00.000Z"
  }
}

重複作成を防ぐ

サーバーはアプリ・作成者・clientRequestIdで識別します。同じ所有者の別トークンで再試行しても同じ基準です。

• 同じIDと内容: 既存の作業を返します。
• 同じIDで異なる内容: 409 Conflictです。
• 異なるID: 同じ内容・フィードバックでも新しい作業を作成します。

比較時に前後空白を除去し、UUIDを小文字にし、issueIdsを並べ替えます。配列順だけが違う再試行は同一です。作業のロックや自動統合ではないため、作成前に既存作業を確認します。

一覧と詳細を取得する

GET /api/v1/apps/:appId/automation/change-requests?limit=20&offset=0
GET /api/v1/apps/:appId/automation/change-requests/:requestId

一覧は新しい順です。limitは既定20・最大50、offsetは既定0・最大100000です。状態フィルターはありません。各項目は作成結果と同じ構造です。

{
  "changeRequests": [],
  "total": 0,
  "limit": 20,
  "offset": 0
}

export CHANGE_REQUEST_ID="cccccccc-cccc-4ccc-8ccc-cccccccccccc"

curl --fail-with-body \
  "$OPENTESTER_API_URL/apps/$OPENTESTER_APP_ID/automation/change-requests/$CHANGE_REQUEST_ID" \
  --header "Authorization: Bearer $OPENTESTER_AGENT_TOKEN"

詳細は200と{ "changeRequest": { ... } }を返します。対象アプリに作業がなければ404です。

PRを関連付ける

実装・テスト後、work-items:writeで既存のGitHub PR URLを関連付けます。

POST /api/v1/apps/:appId/automation/change-requests/:requestId/pull-request
Content-Type: application/json

curl --fail-with-body \
  "$OPENTESTER_API_URL/apps/$OPENTESTER_APP_ID/automation/change-requests/$CHANGE_REQUEST_ID/pull-request" \
  --header "Authorization: Bearer $OPENTESTER_AGENT_TOKEN" \
  --header "Content-Type: application/json" \
  --data '{"url":"https://github.com/your-org/your-app/pull/42"}'

201応答のchangeRequestには更新されたオブジェクトが入り、statusはpr_linked、pullRequestUrlは保存されたURLになります。

規則	動作
許可URL	https://github.com/{owner}/{repo}/pull/{number}
PR番号	先頭ゼロなしの正の整数、最大10桁
追加URL要素	query、fragment、認証情報、ポートは不可
正規化	owner/repoを小文字化し、末尾スラッシュを除去
同じURLの再送	既存作業を返す。再試行可能
別のURL	409。1作業につきPRは1件

GitHub.comのみ対応し、GitLabやGitHub Enterpriseの別ホストは未対応です。

PR関連付けの意味

サーバーはURLを検証して保存します。PRの存在、アクセス権、CI、マージ状態はGitHubで確認します。pr_linkedは修正完了を意味しません。PR作成・マージ、Playデプロイ、フィードバック状態変更、報酬付与は行いません。

修正作業オブジェクト

フィールド	型	意味
id, appId	UUID	作業とアプリのID
title, instructions, acceptanceCriteria	string	タイトル、修正指示、完了条件
issueIds	UUID[]	並べ替え済みの関連フィードバックID
status	open | pr_linked	作成済みまたはPR関連付け済み
pullRequestUrl	string | null	関連付け前はnull
createdBy	UUID	作業を作成したアプリ所有者
createdAt, updatedAt	ISO 8601 string	作成・最終更新日時

本文の編集・削除、PRの交換・解除、実行担当者の割り当てAPIは現在ありません。