Reconstruct semantic structure at API and callback boundaries

Summary#

Performance-oriented internals often flatten or pack data into forms that downstream hooks cannot use correctly. Keep the optimized representation internal, and restore the consumer-facing structure right before callbacks, previews, or plugin APIs run. Preserve the simple fast path and add any model-specific metadata the consumer needs instead of forcing every consumer to understand internal packing.

Problem#

An internal optimization changes tensor or tree shape, but downstream preview, logging, or extension code still expects the higher-level semantic structure and breaks or becomes unusable.

Solution#

Add an explicit boundary adapter that converts packed internal data back into the public semantic form before invoking external consumers, while leaving already-simple cases unchanged and supplying missing consumer-specific factors or metadata.

Failure Modes#

Leaking internal packed shapes into public callbacks and making every consumer reimplement unpacking
Applying the conversion on every case and turning a compatibility fix into a hot-path regression
Restoring the outer structure but forgetting model- or format-specific metadata needed by preview/render code

Sources#

https://github.com/Comfy-Org/ComfyUI/pull/15196
https://github.com/Comfy-Org/ComfyUI/pull/15186
https://github.com/Comfy-Org/ComfyUI/pull/15197
https://github.com/GitHubDaily/GitHubDaily/pull/267
https://github.com/GitHubDaily/GitHubDaily/pull/52
https://github.com/fastapi/full-stack-fastapi-template/pull/2394
https://github.com/fastapi/full-stack-fastapi-template/pull/2393
https://github.com/fastapi/full-stack-fastapi-template/pull/2392
https://github.com/fastapi/full-stack-fastapi-template/pull/2389
https://github.com/fastapi/full-stack-fastapi-template/pull/2386
https://github.com/fastapi/full-stack-fastapi-template/pull/2382
https://github.com/fastapi/full-stack-fastapi-template/pull/2380
https://github.com/fastapi/full-stack-fastapi-template/pull/2373
https://github.com/fastapi/full-stack-fastapi-template/pull/2379
https://github.com/react/react/pull/37063
https://github.com/react/react/pull/37154
https://github.com/react/react/pull/37104
https://github.com/react/react/pull/37152
https://github.com/react/react/pull/37151
https://github.com/react/react/pull/37155
https://github.com/thedaviddias/Front-End-Checklist/pull/664
https://github.com/thedaviddias/Front-End-Checklist/pull/680
mined_at: 2026-08-02T03:54:47Z

Sagwan Revalidation 2026-08-02T04:35:44Z#

verdict: ok
note: 일반 설계 원칙으로 현재 practice와 충돌 없고 재사용 가능함

Sagwan Revalidation 2026-08-06T04:22:30Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-08T13:54:18Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-11T02:13:08Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-13T13:59:51Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-16T03:18:19Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-18T14:48:44Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-21T03:16:29Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-23T15:50:07Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-26T04:14:50Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-28T16:21:33Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-08-31T05:18:02Z#

verdict: ok
note: [chatgpt HTTP 401] {

Sagwan Revalidation 2026-09-02T19:29:28Z#

verdict: ok
note: 일반 설계 원칙으로 여전히 유효하며 최신 practice와 충돌하지 않음

Sagwan Revalidation 2026-09-08T22:23:40Z#

verdict: ok
note: [chatgpt HTTP 404] {

Sagwan Revalidation 2026-09-11T12:58:13Z#

verdict: ok
note: 경계 어댑터 패턴은 시대와 무관한 설계 원칙으로, 내용·권장안 모두 현재 practice와 상충하지 않는다.

Sagwan Revalidation 2026-09-14T08:39:20Z#

verdict: ok
note: 경계 어댑터 패턴은 특정 버전에 종속되지 않는 설계 원칙이며, 문제·해결책·실패 패턴 모두 현재 practice와 일치한다.