diff --git a/CHANGELOG.md b/CHANGELOG.md index 159b826c..73b7aeca 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -55,7 +55,16 @@ | [계약] | 폐기 별칭 `MappingResult`(`boundary-mapper.ts`)와 `ApiFailure`(`errors.ts`)는 export로 남지만 lint(`no-restricted-imports`)가 `src`·`tests`의 import를 막는다. `BoundaryMappingResult`, `AppFailure`로 바꾼다. 타입이 같아 런타임은 그대로다 (1101/07-01) | `eslint.config.ts`, `src/contracts/boundary-mapper.ts`, `src/contracts/errors.ts`, `src/adapters/http/` | `fc303d8` | | [계약] | `StorageBackend`에 `"external"`이 생겼다. cross-context pulse 키는 외부 소유로 바뀌어 StoragePort로 읽고 쓰면 `*_UNAVAILABLE`로 거절된다. exhaustive switch를 쓰는 코드는 분기를 더한다 (1101/05-01) | `src/contracts/storage-keys.ts`, `config/contracts/registry-governance.json`, `config/contracts/registry-change-evidence.json` | `e98a980` | | [계약] | 쓰지 않는 npm script 4개(`scan:security:fixture`, `build:profile`, `generate:contract-set`, `build:app-only`)를 지웠다. 게이트가 닿지 않는 `scan:*` script는 `config/ci/ungated-scripts.json` 항목이 있어야 한다 (1101/12-05) | `package.json`, `scripts/lib/ungated-scripts.ts`, `docs/operations/ci-quality-gates.md` | `98b9682` | -| [계약] | 호스팅 계약에 앱 경로(`appRoute`, `/__probe/deep-link`)와 워커 스크립트(`serviceWorker`, 워커를 싣는 빌드만) 표면이 생겼다. 호스트는 파일이 없는 모든 경로에 그 release의 `index.html`을 HTML 헤더로 주고(SPA fallback), `service-worker.js`는 `no-cache`로 준다. fallback이 없으면 FE-GATE-019 live probe가 실패한다. nginx 예시는 `docs/operations/release-cache-rollback.md`에 있다 (1101/13-04) | `config/hosting/cache-policy.json`, `config/hosting/response-headers.fixture.json`, `scripts/lib/hosting-probe.ts`, `scripts/verify-hosting-headers.ts` | `cee9198` | +| [계약] | 호스팅 계약에 앱 경로(`appRoute`, `/__probe/deep-link`)와 워커 스크립트(`serviceWorker`, 워커를 싣는 빌드만) 표면이 생겼다. 호스트는 파일이 없는 모든 경로에 그 release의 `index.html`을 HTML 헤더로 주고(SPA fallback), `service-worker.js`는 `no-cache`로 준다. fallback이 없으면 FE-GATE-019 live probe가 실패한다. nginx 예시는 `docs/operations/release-cache-rollback.md`에 있다 (1101/13-04) | `config/hosting/cache-policy.json`, `config/hosting/response-headers.fixture.json`, `scripts/lib/hosting-probe.ts`, `scripts/verify-hosting-headers.ts` | `629c8f0` | +| [계약] | 업로드 part 발급·PUT이 서버의 `Retry-After`를 기다리고, `maxRetryAfterMs`를 넘으면 다시 보내지 않는다. 실패 결과에 대기 시간이 붙도록 포트 반환 타입이 넓어졌다(추가만) (1101/01-01) | `src/adapters/browser-transfer/` | `95e4445` | +| [계약] | upload 실패 번역이 HTTP 상태와 함께 code를 보고 복구 행동(recovery)을 고른다. 6개 경로 중 5개의 recovery 값이 표대로 바뀌었다. BFF 발급 401/403은 아직 object store 403과 구분되지 않는다 (0929/01-01) | `src/adapters/browser-transfer/` | `9142390` | +| [계약] | realtime 배럴이 결과 생성 함수 `realtimeSuccess`·`realtimeFailure`를 내보낸다. 동결이 필요한 경계에 직접 만든 결과를 넘기던 코드는 이 함수로 바꾼다 (1101/04-01) | `src/adapters/realtime/index.ts` | `3fe28de` | +| [계약] | 라우터 base path(`VITE_ROUTER_BASE_PATH`)를 쓰면 Web Push 정상 클릭, SW 사전 캐시 URL, SW의 설정 URL이 모두 그 경로 아래로 간다 (1101/06-01, 0929/06-02) | `src/adapters/web-push/`, `scripts/generate-service-worker-assets.ts` | `c67edd2`, `85d55e0` | +| [계약] | 앱 조립이 소유 context 루트가 닿지 않는 기능 라우트(1101/09-06)와 시작할 런타임이 없는 선택 capability(realtime·webWorkers·offlineCommands, 1101/09-07)를 throw로 거절한다. 전에는 조용히 NOT_FOUND가 되거나 아무것도 시작하지 않았다 | `src/apps/deployable-app-module.ts`, `src/bootstrap/` | `7139c7c`, `48a4074` | +| [계약] | 전송 전 거절의 원인이 진단에 남고, 연결 실수·멱등 키 위반은 `VALIDATION_REJECTED` 대신 `UNKNOWN_CLIENT_FAILURE`로 나온다. 그 실패의 화면 문구가 "요청을 처리할 수 없습니다."로 바뀐다 (1101/03-02) | `src/adapters/http/` | `4da0466` | +| [계약] | Vitest가 CI에서 skip·todo·only가 남은 실행을 실패시킨다(`-t`나 `file:line`으로 좁힌 실행은 제외). quarantine 주석이 붙은 skip도 실패한다(`docs/testing/frontend-platform-testing-strategy.md` 16.5절) (1101/10-04) | `vitest.config.ts`, `tests/support/` | `95e7d11` | +| [계약] | 시각 회귀 허용치가 비율 0.2%에서 절대 50 px로 바뀌었다. 전에는 잘린 선택 상자(UI-04, 1,145 px)도 통과했다 (1101/11-03) | `playwright.visual.config.ts` | `5ce3db9` | +| [계약] | file-transfer 레시피 번들 예산이 55,700 → 56,100 gzip B로 올랐다(측정 56,031). 01-01·01-04·02-01·0929/01-01 수정분이다. 예산 인상은 소유자가 다시 검토한다 | `config/recipes/frontend-capability-recipes.json` | `95e4445` 외 | ### 그 밖의 수정 @@ -66,6 +75,11 @@ - 문서: 성능 문서의 번들 기준선(202,509~202,522 B, 여유 약 2,280 B)과 출처별 크기, 분류 규칙을 1101/15-01 뒤 빌드에 맞췄다 (1101/15-02). `PRODUCT.md`를 더하고 예제 제거 주장을 드릴 범위에 맞췄다 (1101/14-04). 이 문서와 리뷰 가이드가 리뷰 ID에 라운드를 붙인다 (1101/14-02) - `verify:documentation`이 실패하면 실패한 검사 이름과 고칠 문서·빠진 route ID를 적는다 (1101/14-06) - 테스트: Testing Library 대기 기한을 `tests/setup.ts` 한 곳에서 5초로 정하고, 부하에 흔들리던 극한 규모·guardian 테스트를 고쳤다 (0929/10-01). `npx vitest`나 npm을 거친 IDE 실행기로 돌려도 npm scope 환경변수 때문에 실패하지 않는다(`vitest.config.ts`) (1101/15-05). cgroup 시스템 테스트가 `/proc` 표본 대신 실행 단계가 남긴 PID·argv 기록을 읽는다 (1101/11-01). exact-five CLI 테스트가 실제 출력 문구를 기대한다 (0929/11-01). guardian이 실패하면 stdin을 기다리지 않고 끝난다(`3c175a5`). 계약 조립기와 V2/V3 대조 테스트 보강 (1101/07-02, 1101/07-06) +- 브라우저 파일·캐시: preview와 download의 dispose가 자기 lease만 풀어 grace 중인 download URL을 끊지 않는다 (1101/02-01). 같은 이미지 동시 resolve는 probe를 한 번만 돈다 (1101/01-04). 캐시 stage 재검증 실패가 `CACHE_STAGE`로 기록되고 (1101/02-03), 정책 변경·손상 뒤에도 다음 배포가 pointer를 덮어쓴다 (0929/02-01). cross-context publish 실패 원인이 관측 reason에 실린다 (1101/02-05) +- HTTP·조회: 문제 응답 분류기 실패가 진단 reason `CLASSIFIER_FAILED`로 남는다 (1101/03-05). 어느 무효화 topic도 닿지 않는 조회 namespace를 진단으로 한 번 알린다 (1101/03-01) +- 화면: 검색값만 바뀌면 포커스·스크롤·`route.changed`를 건드리지 않는다 (1101/08-02). h2·h3·h4 제목 크기·굵기 (1101/08-04), 한국어 단어 단위 줄바꿈 (1101/08-06), 상태 화면·오류 요약의 제목 수준 지정 (1101/08-05), 예제 화면의 `lang="ko-KR"` (1101/08-07), 폼 저장 실패와 결과 불명 화면의 지원 참조 (0929/08-04) +- 진단: context·feature 오류 경계와 라우트 모듈 실패가 진단에 남고, 지원 참조가 `build:incident` 형식이다 (1101/09-09). REST 보안 프로필 오류가 operation과 깨진 조건을 말한다 (1101/16-03) +- 테스트·운영 도구: guardian이 실패하면 stdin을 기다리지 않고 바로 끝난다 (G-1). SW e2e가 제품이 이미 켠 worker와 빌드가 만든 사전 캐시 목록을 쓴다 (0929/11-03, 0929/06-04). 이벤트 계약 검증이 실제 이벤트 행으로 고정됐다 (1101/10-01) ### 알려진 제한