Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

Document breaking API changes from per-project data organization (required ?projectId=, removed promptFeatureExtractionId)

オープン
#1,304 コメント 0 件 リアクション 0 件 担当者 0 名 GitHub で見る

メンテナーはふだん 1 日以内に返信

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

評価

難易度
4/5
見積もり時間
3〜5日
初心者へのやさしさ
55/100
issue の種類
ドキュメント
明瞭さ
おおむね明確
活発さ
静か
技術スタック
typescript

調査の方向性

Start by reviewing requests/index.ts:280 and schemas/request.ts:173, then inspect PR #1241 and the in-repository callers that submit or poll runs. Document the required ?projectId= parameter and removed promptFeatureExtractionId in the release notes or changelog, and verify that no internal caller omits the project parameter. The handling of unknown submit-body fields remains a decision to confirm.

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

説明

type: documentation

Original author: @manekinekko

Context

Follow-up from review of #1241 (per-project data organization). The PR introduces backward-incompatible API contract changes that need to be surfaced to consumers.

Problem

  1. ?projectId= is now required on submit and scoped list operations (ProjectIdQuerySchema + getQueryProjectId throw 400 when absent). Any external caller not updated in this PR — CI scripts, automation, other services, webhooks — starts getting a 400 the moment this deploys. The in-repo CLI and Portal are handled; outside callers are not.
  2. promptFeatureExtractionId is removed from the submit body, RequestDocument, and the response schema, and the prompt-feature-extractions collection is dropped. Because the submit body schema isn't .strict(), clients still sending the field have it silently stripped (no error), and any consumer reading it off responses will find it gone.

Proposed resolution

  • Add these to the PR description and release notes / changelog as explicit breaking changes.
  • Audit for any un-migrated internal callers that submit or poll runs without a project, and update them.
  • Decide whether unknown submit-body fields should be rejected (.strict()) so removed/renamed fields fail loudly rather than being silently ignored.

Acceptance criteria

  • Breaking changes documented where API consumers will see them.
  • No remaining internal caller submits/polls runs without ?projectId=.

Related

  • PR #1241 (per-project data organization)
  • Inline comments: requests/index.ts:280, schemas/request.ts:173
主要言語
TypeScript
スター
14
フォーク
20
平均マージ
2日 12時間
マージ済み PR(30日)
28

環境構築

はじめの一歩

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

microsoft/scope のほかの issue

microsoft/scope の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。