Summary#
Use compatibility shims and API cleanup only after checking real caller behavior
Problem#
External producers or clients often use slightly different key formats or ignore optional parameters, so strict expectations or speculative cleanup can break working integrations.
Solution#
First audit actual client behavior. If real ecosystems emit alternate-but-equivalent formats, add a narrow compatibility mapping. If a parameter is truly unused, remove it from both route and spec only after confirming real callers already rely on the default behavior.
Failure Modes#
- Breaking hidden integrations by assuming all callers follow the documented format.
- Adding broad compatibility logic that introduces ambiguous precedence or masks bad inputs.
- Deleting API surface without validating live client traffic and default semantics.
Sources#
- https://github.com/Comfy-Org/ComfyUI/pull/14373
- https://github.com/Comfy-Org/ComfyUI/pull/14216
- https://github.com/Comfy-Org/ComfyUI/pull/13853
- https://github.com/Comfy-Org/ComfyUI/pull/14349
- https://github.com/Comfy-Org/ComfyUI/pull/14241
- https://github.com/Comfy-Org/ComfyUI/pull/14363
- https://github.com/Comfy-Org/ComfyUI/pull/14014
- https://github.com/Comfy-Org/ComfyUI/pull/13400
- https://github.com/Comfy-Org/ComfyUI/pull/14381
- https://github.com/Comfy-Org/ComfyUI/pull/14368
- https://github.com/Comfy-Org/ComfyUI/pull/14372
- https://github.com/Comfy-Org/ComfyUI/pull/14371
- https://github.com/GitHubDaily/GitHubDaily/pull/267
- https://github.com/GitHubDaily/GitHubDaily/pull/52
- https://github.com/fastapi/full-stack-fastapi-template/pull/2305
- https://github.com/react/react/pull/36173
- https://github.com/react/react/pull/36727
- https://github.com/react/react/pull/36726
- https://github.com/thedaviddias/Front-End-Checklist/pull/664
- https://github.com/thedaviddias/Front-End-Checklist/pull/680
- mined_at: 2026-06-10T16:20:46Z
Sagwan Revalidation 2026-06-10T17:05:00Z#
- verdict:
refresh - note: 권장안은 유효하나 fastapi/full 링크가 불완전해 출처 정리가 필요함
Sagwan Revalidation 2026-06-11T19:36:05Z#
- verdict:
ok - note: 호환성은 실제 호출자 확인 후 좁게 적용하라는 원칙은 여전히 유효함
Sagwan Revalidation 2026-06-12T19:48:41Z#
- verdict:
ok - note: 핵심 원칙은 여전히 유효하고 수치·시한 의존 정보가 없다
Sagwan Revalidation 2026-06-13T21:43:32Z#
- verdict:
ok - note: 일반 API 호환성 원칙으로 최근 practice와 충돌하지 않는다
Sagwan Revalidation 2026-06-14T21:54:40Z#
- verdict:
ok - note: 실사용자 행태 확인 후 호환·정리하라는 원칙은 여전히 유효함
Sagwan Revalidation 2026-06-15T23:25:12Z#
- verdict:
ok - note: 일반 호환성 원칙으로 현재 practice와 충돌 없이 재사용 가능함
Sagwan Revalidation 2026-06-17T00:26:54Z#
- verdict:
ok - note: 실제 호출자 확인 후 호환 처리 원칙은 여전히 최신 관행과 부합함
Sagwan Revalidation 2026-06-18T00:27:23Z#
- verdict:
refresh - note: 핵심 교훈은 유효하나 fastapi/full 링크가 불완전해 출처 정리가 필요합니다
Sagwan Revalidation 2026-06-19T00:57:12Z#
- verdict:
ok - note: 실제 호출자 확인 후 호환성·API 정리를 하라는 원칙은 여전히 유효함
Sagwan Revalidation 2026-06-20T02:16:58Z#
- verdict:
ok - note: 일반 원칙으로 최신 관행과 충돌 없고 재사용 가능함
Sagwan Revalidation 2026-06-21T02:38:03Z#
- verdict:
ok - note: 호출자 관찰 후 호환 shim·API 정리 원칙은 여전히 유효함
Sagwan Revalidation 2026-06-22T02:46:44Z#
- verdict:
ok - note: 일반 원칙이며 수치·세부 권장안 변화 없이 여전히 재사용 가능함
Sagwan Revalidation 2026-06-23T03:19:20Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-24T03:52:59Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-25T05:36:10Z#
- verdict:
ok - note: [chatgpt HTTP 401] {
Sagwan Revalidation 2026-06-26T07:15:22Z#
- verdict:
ok - note: 실제 호출 행태 확인 후 호환·정리한다는 원칙은 여전히 유효함
Sagwan Revalidation 2026-06-27T10:52:56Z#
- verdict:
ok - note: 일반 원칙과 권장안이 현재 practice와도 부합해 변경 불필요
Sagwan Revalidation 2026-06-28T11:35:50Z#
- verdict:
ok - note: 원칙 중심 조언이라 최신 practice와 충돌 없고 재사용 가능함
Sagwan Revalidation 2026-06-29T12:42:42Z#
- verdict:
ok - note: 원칙은 최신 관행과 맞고, 링크/권장안도 하루 사이 변동 징후가 없음
Sagwan Revalidation 2026-06-30T17:18:10Z#
- verdict:
ok - note: 실제 호출자 확인 후 호환 처리·API 정리 원칙은 여전히 유효함
Sagwan Revalidation 2026-07-02T00:35:07Z#
- verdict:
ok - note: 최근 검증 이후 변동 가능성 낮고, 호환성 원칙은 여전히 유효함
Sagwan Revalidation 2026-07-03T13:33:13Z#
- verdict:
ok - note: 호출자 실태 확인 후 호환 처리·API 정리 원칙은 여전히 유효합니다.
Sagwan Revalidation 2026-07-04T20:01:01Z#
- verdict:
ok - note: 일반 원칙성 내용으로 최근 practice와 충돌 없고 재사용 가능함
Sagwan Revalidation 2026-07-06T01:23:39Z#
- verdict:
ok - note: 일반 원칙성 조언으로, 최근 practice와 충돌하거나 낡은 수치가 없다.
Sagwan Revalidation 2026-07-07T07:14:50Z#
- verdict:
ok - note: 실제 호출자 확인 후 호환 처리한다는 원칙은 여전히 최신 관행입니다
Sagwan Revalidation 2026-07-08T13:24:43Z#
- verdict:
ok - note: 일반 원칙 중심이라 최신 practice와 충돌 없고 재사용 가능함
Sagwan Revalidation 2026-07-10T15:18:38Z#
- verdict:
ok - note: 최근 검증 이후 변동 징후 없고 원칙도 현재 관행과 부합함
Sagwan Revalidation 2026-07-12T08:53:37Z#
- verdict:
refresh - note: FastAPI 소스 링크가 불완전해 보이나 핵심 권고는 여전히 유효함
Sagwan Revalidation 2026-07-14T04:50:03Z#
- verdict:
ok - note: 호환성 변경 전 실제 호출자 확인 원칙은 최신 관행과도 부합함
Sagwan Revalidation 2026-07-16T05:21:32Z#
- verdict:
refresh - note: 핵심 원칙은 유효하나 fastapi/full 출처 링크가 불완전해 보인다.
Sagwan Revalidation 2026-07-18T07:13:30Z#
- verdict:
ok - note: 실제 호출자 확인 후 호환성 처리·API 정리 원칙은 여전히 유효함
Sagwan Revalidation 2026-07-20T07:58:08Z#
- verdict:
ok - note: 일반 원칙성 capsule로 최근 API 호환성 관행과 충돌하지 않음
Sagwan Revalidation 2026-07-22T10:18:11Z#
- verdict:
refresh - note: 원칙은 유효하나 fastapi/full 출처 링크가 불명확해 정리 필요.
Sagwan Revalidation 2026-07-24T12:33:40Z#
- verdict:
ok - note: 실제 호출자 확인 뒤 좁은 호환 처리·API 정리를 하라는 원칙은 유효함
Sagwan Revalidation 2026-07-26T15:39:04Z#
- verdict:
ok - note: 일반 호환성 원칙이며 최근 practice와 충돌 없이 재사용 가능.
Sagwan Revalidation 2026-07-28T22:09:35Z#
- verdict:
ok - note: 원칙은 여전히 최신 관행과 부합하며 최근 변경 신호가 없습니다.
Sagwan Revalidation 2026-07-31T04:45:43Z#
- verdict:
refresh - note: 마지막 FastAPI 출처 링크가 불완전해 출처 정리가 필요합니다