feat: Studio 응답 봉투를 전송 경계에서 언랩한다

studio-v1.yaml v3.0.0(ADR-006)에 맞춰 계약을 재생성하고, 성공은
{success,data,meta}, 실패는 {success,error,meta} 봉투를 전송 경계에서
언랩하는 envelopeData/envelopeError validator를 도입한다. 앱·도메인
계층은 기존과 같은 payload/ProblemDetails 모양을 계속 받고,
StudioGateway 포트 시그니처는 무변경이다.

- tech-log-studio-contract-contribution.ts: envelopeData/envelopeError
  도입, 18개 operation의 outputValidator를 passthrough에서 envelopeData로
  교체
- studio-error-mapping.ts: 봉투 오류의 status(항상 0)를
  outcome.metadata.status로 덮는다. SafeResponseMetadata.status가
  실제 필드명이며(httpStatus 아님) PROBLEM outcome에서 필수 필드다
- contract.ts: 삭제된 ProblemDetails 생성 스키마를 손으로 유지 — 앱
  계층·mock 게이트웨이가 그 모양을 계속 소비한다
- asset-upload-transport.ts: multipart 업로드는 일반 계약 런타임을
  거치지 않는 별도 seam이지만 같은 wire 봉투를 쓴다 — envelopeData/
  envelopeError를 재사용해 이 경로도 언랩한다 (브리프 파일 목록 밖의
  발견, report에 기록)
- 테스트: 신규 studio-envelope-unwrap.test.ts(TDD) + 봉투 뼈대를 직접
  만드는 기존 테스트(asset-upload-transport, studio-csrf-composition,
  contract-generation)를 봉투 형태로 갱신

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
DongHyeonka
2026-08-18 21:55:45 +09:00
co-authored by Claude Opus 5
parent d84b57bb3f
commit 25a6b63d27
11 changed files with 640 additions and 216 deletions
@@ -23,7 +23,35 @@ export type PublicationListItem = Schemas["PublicationListItem"];
export type PublicationPage = Schemas["PublicationPage"];
export type PublicationSnapshot = Schemas["PublicationSnapshot"];
export type CatalogPage = Schemas["CatalogPage"];
export type ProblemDetails = Schemas["ProblemDetails"];
/**
* ADR-006으로 canonical 계약의 오류가 봉투(`ErrorEnvelope`/`ApiError`)로
* 바뀌면서 `ProblemDetails` 스키마 자체는 canonical에서 삭제됐다. 앱 계층
* (`StudioGatewayError`, mock 게이트웨이들, `asset-upload-transport.ts`)은
* 여전히 이 평평한(flat) 모양을 소비한다 — 전송 경계
* (`tech-log-studio-contract-contribution.ts`의 `envelopeError`)가 `ApiError`를
* 여기로 옮기고, mock은 이 모양을 직접 구성한다. 그래서 더 이상 생성된
* 스키마에서 뽑지 않고 여기서 손으로 유지한다.
*/
export type ProblemDetails = {
/** Format: uri-reference */
type: string;
title: string;
status: number;
detail: string;
code: Schemas["ApiError"]["code"];
category?: Schemas["ApiError"]["category"];
retryable?: boolean;
details?: unknown;
/** Format: uri-reference */
instance?: string;
traceId?: string;
fieldErrors?: Schemas["FieldError"][];
latestDocument?: Schemas["WorkingCopyDetail"];
latestPublication?: Schemas["PublicationAggregate"];
conflictingFields?: string[];
} & {
[key: string]: unknown;
};
export type PublicRenderModel = Schemas["PublicRenderModel"];
export type Asset = Schemas["Asset"];
export type AssetDetail = Schemas["AssetDetail"];