fix(storage): 저장소 진단 이벤트에 실패 원인을 싣는다 (05-02)
문제: Web Storage 어댑터의 실패 원인은 QUOTA_EXCEEDED, SIZE_LIMIT_EXCEEDED, UNAVAILABLE, VALUE_REJECTED 넷이다. 진단 이벤트 storage.operation.failed는 error_kind에 quota면 STORAGE_QUOTA_EXCEEDED, 나머지는 모두 STORAGE_UNAVAILABLE을 넣고 원인을 버린다. 그래서 운영자는 "브라우저 저장소를 못 쓴다"와 "저장된 값이 깨져서 버렸다"를 같은 이벤트로 본다. 호출자에게 주는 실패 code에는 원인이 이미 들어 있다. 고른 방법: recordStorageFailure의 context에 reason: cause를 더한다. reason은 진단 계약의 허용 칸(taxonomy)이고 원인 값은 어댑터의 닫힌 유니온이라 cardinality가 늘지 않는다. projectDiagnosticRecord에 넣어 칸이 그대로 남는 것을 확인했다. 버린 대안: error_kind를 원인별로 나누는 것. error_kind는 createFailure의 error kind taxonomy와 맞춰져 있어, 값을 늘리면 그 taxonomy를 바꿔야 한다. 이미 있는 reason 칸에 싣는 쪽이 추가만으로 끝난다. 위험·한계: 진단 이벤트에 칸이 하나 는다(추가만). 수집기가 reason을 바깥으로 내보내는지는 영역 03 소관이라 보지 않았다. 검증: - RED: storage-registry의 quota, discard 3종(malformed, invalid envelope, oversized), oversize write 테스트 5개가 실패. 예: "expected vi.fn() to be called with arguments" 차이 `- "reason": "VALUE_REJECTED"`. - GREEN: 같은 파일 23/23 통과. - 회귀: storage-registry, runtime-adapters, diagnostics, release-mismatch-recovery 4파일 68/68 통과. tsc app·test 통과, eslint 통과. Refs: docs/reviews/2026-11-01-maturity-review/05-adapters-storage-kernel.md
This commit is contained in:
@@ -377,6 +377,9 @@ function recordStorageFailure(
|
||||
cause === "QUOTA_EXCEEDED"
|
||||
? "STORAGE_QUOTA_EXCEEDED"
|
||||
: "STORAGE_UNAVAILABLE",
|
||||
// 05-02. error_kind folds three causes into STORAGE_UNAVAILABLE; the
|
||||
// cause tells a corrupt or oversized value apart from no storage.
|
||||
reason: cause,
|
||||
},
|
||||
});
|
||||
} catch {
|
||||
|
||||
Reference in New Issue
Block a user