fix(http): Fileserver 업로드 실패에 Envelope의 traceId를 싣는다
문제: readFailureEnvelope는 실패 Envelope의 meta.traceId를 함께 돌려주고, V3 실행기는 그 값을 AppFailure.traceId로 싣는다(1103/03-06). Fileserver client는 envelope.value만 넘겨 traceId를 버린다. 지원 담당이 업로드 실패를 서버 로그의 요청과 잇지 못한다. 같은 백엔드의 다른 쓰기 실패는 이을 수 있다. 고른 방법: envelopeFailure가 읽은 Envelope 전체를 받아 traceId가 있으면 createFailure의 traceId로 싣는다. V3와 같은 규칙이다. 없으면 키를 두지 않는다. 매뉴얼 7절 결과 읽기에 한 줄 적었다. 위험·한계: Envelope 실패에만 싣는다. 성공 Envelope을 읽지 못한 실패 (SCHEMA_MISMATCH 등, 202 REJECTED 포함)는 readSuccessEnvelope가 meta를 돌려주지 않아 traceId가 없다. V3도 같다. 검증: desktop batch에서 확인. node scripts/run-vitest.ts run tests/integration/fileserver-upload.test.ts RED(이 커밋의 테스트 + 부모 src): Envelope failures 표 17행이 traceId "trace-1"이 없어 모두 실패한다. Refs: 1105/01-03
This commit is contained in:
@@ -695,15 +695,16 @@ async function readAnswer(
|
||||
if (status < 400) return unreadable("ENVELOPE_MISMATCH", "STATUS_UNEXPECTED");
|
||||
const envelope = readFailureEnvelope(json);
|
||||
if (!envelope.ok) return unreadable("ENVELOPE_MISMATCH", "ENVELOPE_INVALID");
|
||||
return envelopeFailure(status, envelope.value, response, settings);
|
||||
return envelopeFailure(status, envelope, response, settings);
|
||||
}
|
||||
|
||||
function envelopeFailure(
|
||||
status: number,
|
||||
error: EnvelopeError,
|
||||
envelope: Readonly<{ value: EnvelopeError; traceId?: string }>,
|
||||
response: Response,
|
||||
settings: Settings,
|
||||
): Result<never, AppFailure> {
|
||||
const error = envelope.value;
|
||||
const effect = fileserverFailureEffect(status, error);
|
||||
const retryAfterMs = parseRetryAfterDelay(
|
||||
response.headers.get("retry-after"),
|
||||
@@ -731,6 +732,9 @@ function envelopeFailure(
|
||||
...(reading.validationIssues === undefined
|
||||
? {}
|
||||
: { validationIssues: reading.validationIssues }),
|
||||
// 1105/01-03. The backend's `meta.traceId`, as the V3 executor carries it
|
||||
// (1103/03-06), so support can find this upload in the server logs.
|
||||
...(envelope.traceId === undefined ? {} : { traceId: envelope.traceId }),
|
||||
});
|
||||
// `retryable` in the Envelope is the server's decision for this answer and
|
||||
// can only narrow the client's.
|
||||
|
||||
Reference in New Issue
Block a user