api(openapi): GET /api/tasks の status クエリパラメータに enum 値を明示 (R7#4)

[win2cot]

背景

GET /api/tasks の status クエリは type: string のみで有効値が機械的に読めない。

やること

カンマ区切り対応 pattern または配列化のいずれかで明示:

(A) pattern: ^(NOT_STARTED|IN_PROGRESS|DONE|ON_HOLD)(,(...))*$
(B) type: array, items: { $ref: '#/components/schemas/TaskStatus' }, explode: false

OpenAPI らしさで(B)推奨。

参照

PR #76 Claude review (R7) 推奨 #4

[win2cot]

@claude go

[claude]

Claude finished @win2cot's task in 2m 56s —— View job • claude/issue-110-20260514-1039 • Create PR ➔

---

完了

• コンテキストの収集・理解
• OpenAPI スペックファイルの特定 (api/openapi.yaml)
• status クエリパラメータを配列型 ($ref: TaskStatus, explode: false) に更新
• ビルド・テストの確認 (BUILD SUCCESSFUL)
• コミット・プッシュ

変更内容

api/openapi.yaml の GET /api/tasks の status パラメータを Issue 推奨の (B) 案 で更新しました。

変更前:

- { name: status, in: query, schema: { type: string }, description: "カンマ区切りで複数指定可" }

変更後:

- name: status
  in: query
  explode: false
  description: "絞込ステータス(複数指定可、カンマ区切り: status=NOT_STARTED,IN_PROGRESS)"
  schema:
    type: array
    items:
      $ref: "#/components/schemas/TaskStatus"

• explode: false により status=NOT_STARTED,IN_PROGRESS 形式のカンマ区切りクエリに対応
• $ref: TaskStatus で有効値 (NOT_STARTED / IN_PROGRESS / DONE / ON_HOLD) を機械的に読めるように
• API version を 1.3.1 → 1.3.2 に更新