Merge pull request 'fix: UI 감사와 11-01 성숙도 리뷰의 발견과 결정 24건을 반영한다' (#4) from fix/ui-design-audit-2026-11-01 into main
Reviewed-on: #4
This commit was merged in pull request #4.
This commit is contained in:
@@ -58,14 +58,14 @@
|
||||
},
|
||||
{
|
||||
"name": "zod-is-reached-through-contracts-zod",
|
||||
"comment": "F-7 (13-08). src/contracts/zod.ts sets zod jitless before any schema is built, so the production CSP never sees zod's Function probe. Schema code imports z from there.",
|
||||
"comment": "F-7 (13-08). src/contracts/zod.ts sets zod jitless before any schema is built, so the production CSP never sees zod's Function probe. Schema code imports z from there. A subpath (zod/v4, zod/mini) is the same zod and counts too (0929/P-07-06).",
|
||||
"severity": "error",
|
||||
"from": {
|
||||
"path": "^src",
|
||||
"pathNot": "^src/contracts/zod\\.ts$"
|
||||
},
|
||||
"to": {
|
||||
"path": "^zod$"
|
||||
"path": "^zod(/|$)"
|
||||
}
|
||||
},
|
||||
{
|
||||
@@ -172,7 +172,7 @@
|
||||
},
|
||||
{
|
||||
"name": "unselected-realtime-runtime-is-not-composed",
|
||||
"comment": "§9.2 / 12-10. Realtime and Web Push are NOT_SELECTED in the template (src/features/installed-runtime-capabilities.ts), so the composition root and the installed-feature registries do not import their concrete adapters. A project that selects one replaces this rule when it wires the runtime. Owner: frontend-platform.",
|
||||
"comment": "§9.2 / 12-10. Realtime and Web Push are NOT_SELECTED in the template (src/features/product-capabilities.ts), so the composition root and the installed-feature registries do not import their concrete adapters. A project that selects one replaces this rule when it wires the runtime. Owner: frontend-platform.",
|
||||
"severity": "error",
|
||||
"from": {
|
||||
"path": "^src/(bootstrap/|features/installed-feature-)"
|
||||
@@ -237,9 +237,21 @@
|
||||
"path": "^src/features/installed-"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "boot-does-not-load-every-feature-runtime",
|
||||
"comment": "15-01. src/features/loaded-feature-runtimes.ts awaits every installed feature's runtime half at module evaluation. Imported anywhere on the boot path, the first render would wait for all feature code, and the initial-chunk budget would not see it because the runtimes are dynamic imports. Any top-level await in the browser graph also turns off rolldown chunk optimizations for the whole build. At runtime the composition root loads one feature at a time when its routes are entered; the platform overview route calls loadInstalledFeatureRuntimeRegistries() instead. Node scripts and tests are outside src and may import it. Owner: frontend-platform.",
|
||||
"severity": "error",
|
||||
"from": {
|
||||
"path": "^src/",
|
||||
"pathNot": "^src/features/loaded-feature-runtimes\\.ts$"
|
||||
},
|
||||
"to": {
|
||||
"path": "^src/features/loaded-feature-runtimes\\.ts$"
|
||||
}
|
||||
},
|
||||
{
|
||||
"name": "adapters-do-not-know-other-concrete-adapters",
|
||||
"comment": "docs/architecture/layers.md §4: a concrete adapter never depends on another concrete adapter. The adapter kernel is shared on purpose and any adapter may import it: src/adapters/platform/** (clock, abort primitive, capacity guard), src/adapters/browser-file-storage/result.ts (browser-data result helpers) and src/adapters/cross-context-invalidation/index.ts (the cross-context invalidation transport and its types). Owner: frontend-platform. No new file-level exception is added here; a new shared primitive goes into src/adapters/platform/.",
|
||||
"comment": "docs/architecture/layers.md §4: a concrete adapter never depends on another concrete adapter. The adapter kernel is shared on purpose and any adapter may import it: src/adapters/platform/** (shared mechanisms only: clock, abort primitive, capacity guard, IndexedDB connection and transaction, Retry-After, JSON member scanner; plus two bootstrap-only services, see layers.md), src/adapters/browser-file-storage/result.ts (browser-data result helpers) and src/adapters/cross-context-invalidation/index.ts (the cross-context invalidation transport and its types). Owner: frontend-platform. No new file-level exception is added here; a new shared primitive goes into src/adapters/platform/.",
|
||||
"severity": "error",
|
||||
"from": {
|
||||
"path": "^src/adapters/([^/]+)/"
|
||||
@@ -312,7 +324,7 @@
|
||||
},
|
||||
{
|
||||
"name": "observability-vendors-live-behind-adapters",
|
||||
"comment": "Spec §24. Features, platform, application, domain, contracts and presentation emit observability only through the provider-neutral TelemetryPort. A vendor telemetry SDK may be imported only by an adapter-side transport under src/adapters.",
|
||||
"comment": "scale-architecture.md §24. Features, platform, application, domain, contracts and presentation emit observability only through the provider-neutral TelemetryPort. A vendor telemetry SDK may be imported only by an adapter-side transport under src/adapters.",
|
||||
"severity": "error",
|
||||
"from": {
|
||||
"path": "^src/",
|
||||
@@ -324,7 +336,7 @@
|
||||
},
|
||||
{
|
||||
"name": "platform-kernel-is-product-neutral",
|
||||
"comment": "Spec §4. src/platform holds product-neutral primitives (budgets, execution, telemetry pipeline, validation, error envelopes). It never reaches up into a concrete feature, context, adapter, bootstrap or presentation module. Exception: src/platform/routing composes deployable-app descriptors by type. Owner: frontend-platform. Revisit if routing gains a product-specific import.",
|
||||
"comment": "scale-architecture.md §4. src/platform holds product-neutral primitives (budgets, execution, telemetry pipeline, validation, error envelopes). It never reaches up into a concrete feature, context, adapter, bootstrap or presentation module. Exception: src/platform/routing composes deployable-app descriptors by type. Owner: frontend-platform. Revisit if routing gains a product-specific import.",
|
||||
"severity": "error",
|
||||
"from": {
|
||||
"path": "^src/platform/",
|
||||
|
||||
+5
-2
@@ -5,8 +5,11 @@
|
||||
#
|
||||
# Runtime configuration — API endpoints, auth mode, telemetry, capability
|
||||
# switches — is NOT here. It lives in `config/runtime/<profile>.json` and is
|
||||
# materialized into `dist/config.json` at build time, so it can be changed
|
||||
# without rebuilding. See the "Runtime configuration" section of README.md.
|
||||
# materialized into `dist/config.json` at build time. Only the emergency
|
||||
# switches (CAPABILITY_OVERRIDES, FEATURE_OVERRIDES) may be changed in a
|
||||
# deployed config.json without rebuilding, by the checked procedure in
|
||||
# docs/runbooks/FE-RB-001.md. See the "Runtime configuration" section of
|
||||
# README.md.
|
||||
#
|
||||
# Copy to `.env.local` (git-ignored) to override locally.
|
||||
|
||||
|
||||
@@ -51,6 +51,7 @@ jobs:
|
||||
- { gate: FE-GATE-009, name: accessibility, browser: true }
|
||||
- { gate: FE-GATE-010, name: architecture, browser: false }
|
||||
- { gate: FE-GATE-011, name: build, browser: false }
|
||||
- { gate: FE-GATE-012, name: bundle, browser: false }
|
||||
- { gate: FE-GATE-013, name: security, browser: false }
|
||||
- { gate: FE-GATE-020, name: removability, browser: false }
|
||||
steps:
|
||||
@@ -66,7 +67,9 @@ jobs:
|
||||
corepack pnpm install --frozen-lockfile --ignore-scripts
|
||||
- name: Install Playwright browsers
|
||||
if: ${{ matrix.browser }}
|
||||
run: corepack pnpm exec playwright install --with-deps chromium firefox webkit
|
||||
run: |
|
||||
corepack pnpm exec playwright install --with-deps chromium firefox webkit
|
||||
$(command -v sudo || true) apt-get install -y fonts-noto-core fonts-noto-cjk fonts-noto-cjk-extra fonts-liberation
|
||||
- name: Run blocking gate
|
||||
run: corepack pnpm ci:gate -- ${{ matrix.gate }}
|
||||
- name: Upload merge gate evidence
|
||||
@@ -87,7 +90,6 @@ jobs:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
include:
|
||||
- { gate: FE-GATE-012, name: bundle, browser: false }
|
||||
- { gate: FE-GATE-014, name: config-compatibility, browser: false }
|
||||
- { gate: FE-GATE-026, name: lab-performance, browser: true }
|
||||
- { gate: FE-GATE-028, name: manual-accessibility-review, browser: false }
|
||||
@@ -104,7 +106,9 @@ jobs:
|
||||
corepack pnpm install --frozen-lockfile --ignore-scripts
|
||||
- name: Install Playwright browsers
|
||||
if: ${{ matrix.browser }}
|
||||
run: corepack pnpm exec playwright install --with-deps chromium firefox webkit
|
||||
run: |
|
||||
corepack pnpm exec playwright install --with-deps chromium firefox webkit
|
||||
$(command -v sudo || true) apt-get install -y fonts-noto-core fonts-noto-cjk fonts-noto-cjk-extra fonts-liberation
|
||||
- name: Run blocking gate
|
||||
run: corepack pnpm ci:gate -- ${{ matrix.gate }}
|
||||
- name: Upload release gate evidence
|
||||
@@ -366,15 +370,29 @@ jobs:
|
||||
node scripts/cleanup-verified-promotion.ts
|
||||
fi
|
||||
|
||||
deployment:
|
||||
name: deploy-promoted-release
|
||||
needs: [immutable_build, promotion]
|
||||
if: ${{ gitea.event_name == 'workflow_dispatch' && (inputs.stage == 'production' || inputs.stage == 'field') }}
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 45
|
||||
outputs:
|
||||
deployed: ${{ steps.deploy.outputs.deployed }}
|
||||
steps:
|
||||
- name: Deployment slot is empty
|
||||
id: deploy
|
||||
run: echo "deployed=false" >> "$GITHUB_OUTPUT"
|
||||
|
||||
production_gate:
|
||||
name: "${{ matrix.gate }} / ${{ matrix.name }}"
|
||||
needs: [immutable_build, promotion]
|
||||
needs: [immutable_build, promotion, deployment]
|
||||
if: ${{ gitea.event_name == 'workflow_dispatch' && (inputs.stage == 'production' || inputs.stage == 'field') }}
|
||||
runs-on: ubuntu-latest
|
||||
timeout-minutes: 45
|
||||
env:
|
||||
HOSTING_BASE_URL: "${{ vars.HOSTING_BASE_URL }}"
|
||||
CANDIDATE_ARCHIVE_SHA256: "${{ needs.immutable_build.outputs.archive_sha256 }}"
|
||||
RELEASE_DEPLOYED: "${{ needs.deployment.outputs.deployed }}"
|
||||
strategy:
|
||||
fail-fast: false
|
||||
matrix:
|
||||
|
||||
@@ -12,6 +12,9 @@ artifacts/**/*.json
|
||||
artifacts/**/*.xml
|
||||
artifacts/**/*.txt
|
||||
artifacts/**/*.sarif
|
||||
# 1103/12-08. Step logs from check:scale:* and verify:extreme-scale. They were
|
||||
# committed once, and every local merge-gate run rewrote them.
|
||||
artifacts/**/*.log
|
||||
artifacts/tests/e2e/
|
||||
artifacts/tests/browser-capabilities/
|
||||
artifacts/storybook/
|
||||
|
||||
+313
-48
@@ -4,11 +4,276 @@
|
||||
가져오는 방법은 `README.md`의 "Updating a copied project" 절에 있다.
|
||||
|
||||
- 버전은 git 태그 `vX.Y.Z`로 식별한다. 태그 사이의 변경을 여기 적는다.
|
||||
- 미출시 절은 한 번의 동기화 단위(기준 커밋 → 브랜치 끝)에서 받는 변경의 순 요약이다. 최종 상태만 적고, 같은 범위 안에서 뒤 커밋이 바꾼 중간 상태는 지운다. 호환을 깨는 변경은 절 첫머리 "먼저 할 일"에 옮기기 전·옮기는 법·옮긴 뒤 확인 순서로 적는다.
|
||||
- **[보안]** 복사한 프로젝트도 가져가야 하는 보안·개인정보 수정이다.
|
||||
- **[계약]** 백엔드, 배포 설정, CI, 또는 기능 코드가 함께 바뀌어야 하는 변경이다(헤더, 변수, 게이트, 공개 포트).
|
||||
- 표시가 없으면 템플릿 안에서 끝나는 수정이다.
|
||||
- 괄호 안 ID는 리뷰 발견 ID다. 근거와 재현 조건은 해당 리뷰 문서에 있다.
|
||||
- 커밋 해시는 브랜치 `fix/maturity-review-2026-09-25` 기준이다. 병합 방식에 따라 `main`에서는 해시가 다를 수 있으니 ID로 찾는다(`git log --grep '03-03'`).
|
||||
- 괄호 안 ID는 리뷰 발견 ID다. `MMDD/NN-MM`으로 적는다. `MMDD`는 리뷰 폴더 `docs/reviews/YYYY-MM-DD-maturity-review/`의 월일이고, 근거와 재현 조건은 그 폴더의 영역 문서에 있다. 복사한 프로젝트가 README대로 `docs/reviews/`를 지웠다면 이 폴더와 `PRODUCT.md`는 원본 템플릿 repo에서 찾는다. 라운드마다 `NN-MM`을 새로 매기므로 같은 `14-02`라도 라운드가 다르면 다른 결함이다. `F-N`은 그 라운드 `FOLLOW-UP.md`의 ID다. `tests/unit/changelog-review-ids.test.ts`가 라운드 없는 ID를 막는다.
|
||||
- 0.2.0의 커밋 해시는 브랜치 `fix/maturity-review-2026-09-25`에서 만들었고, `main`에서도 같은 해시로 찾을 수 있다(2026-11-03에 52개 모두 확인). 그 뒤 절은 절 머리에 범위(기준 커밋과 브랜치)를 적고, 그 절의 해시는 모두 그 범위에 있다. 0.2.0의 커밋 제목은 라운드 없이 ID만 적었다(`git log --grep '03-03'`).
|
||||
|
||||
## 미출시 — `752a61f` → 브랜치 `fix/maturity-review-2026-11-03`
|
||||
|
||||
한 번의 동기화로 받는 변경의 순 요약이다. 범위는 `main` `752a61f`부터 브랜치 `fix/maturity-review-2026-11-03`의 끝까지다. 이 절을 쓸 때 끝은 `f887817`이었다(병합 커밋을 빼고 310개). 그 뒤 깨끗한 clone 검증(merge 단계 14개)에서 찾은 수정과 pin 갱신을 더했다. 버전 번호와 태그는 아직 정하지 않았다.
|
||||
|
||||
이 묶음은 세 갈래를 합쳤다.
|
||||
|
||||
- `fix/ui-design-audit-2026-11-01`: 2026-11-01 UI 디자인 감사(`docs/reviews/2026-11-01-ui-design-audit.md`, ID `UI-NN`)와 2026-11-01 성숙도 리뷰(`docs/reviews/2026-11-01-maturity-review/`) 조치.
|
||||
- `claude/happy-easley-233d07`: 짝 백엔드 Envelope 읽기, V2 HTTP 경로 삭제, 거절 판정 표, 쿠키 쓰기 CSRF, KEYED 재전송. 앞 갈래와 `e40684b`에서 합쳤다.
|
||||
- 2026-11-03 성숙도 리뷰(`docs/reviews/2026-11-03-maturity-review/`) 조치 브랜치 11개. `fix/maturity-review-2026-11-03`에서 합쳤다.
|
||||
|
||||
읽는 법:
|
||||
|
||||
- 최종 상태만 적는다. 같은 범위 안에서 뒤 커밋이 다시 바꾼 중간 상태는 적지 않는다. 예를 들어 V2 클라이언트를 고친 커밋들은 V2를 지운 행 하나로 남겼다. 중간 기록은 커밋 이력에 있다.
|
||||
- 이 repo의 커밋 해시는 기준점 `752a61f`·`af3d8e6`을 빼면 모두 이 범위에 있다. 브랜치 끝에서 닿고 `752a61f`에서는 닿지 않는다. 다른 repo의 커밋(다운스트림, 짝 백엔드)은 repo 이름과 함께 적었다.
|
||||
- 두 다운스트림(tech-log-frontend, memento-frontend)의 기준점은 `af3d8e6`이다. `af3d8e6`과 `752a61f` 사이에는 리뷰 문서만 있다. 그래서 두 제품이 받을 변경은 이 절과 같다.
|
||||
|
||||
### 먼저 할 일 (BREAKING)
|
||||
|
||||
복사한 프로젝트가 이 묶음을 받을 때 순서대로 한다. 단계 끝의 괄호는 아래 표의 근거 행이다. 두 다운스트림에서 읽은 모양(memento-frontend `d3810a0`, tech-log-frontend `7a4e201a`, 2026-11-05)을 단계마다 적었다. 템플릿은 이 안내를 두 제품 코드에 적용해 게이트를 돌려 보지는 않았다(알려진 제한).
|
||||
|
||||
#### 옮기기 전
|
||||
|
||||
1. 기준점을 확인한다. memento는 `.template-origin`, tech-log는 `template.lock.json`의 `sourceRevision`에 있다. 둘 다 `af3d8e6`이다.
|
||||
2. 제품이 고친 템플릿 파일을 뽑는다. 이 묶음은 그 일을 받을 제품 소유 파일을 새로 둔다(옮기는 법 2단계). 템플릿 파일을 고친 채로 두면 동기화마다 충돌한다.
|
||||
- memento: `src/bootstrap/runtime-adapters.ts`, `src/features/feature-adapter-contribution.ts`(capability `offsetUpload`·`runtime`), `src/contracts/rest-profiles.ts`(`MEMENTO_BFF_READ`·`MEMENTO_BFF_WRITE`), `src/contracts/external-contract-runtime.ts`(출처 종류 `PRODUCT_LOCAL_CONTRACT`), `src/features/installed-feature-contracts.ts`(`APP_HOME` 다리), `src/features/installed-runtime-capabilities.ts`(Service Worker `ACTIVE`), `src/presentation/routes/app-router.tsx`(`ownsShell` 다리).
|
||||
- tech-log: `src/contracts/env.ts`(`TECH_LOG_STUDIO_SOURCE`·`TECH_LOG_PUBLIC_SOURCE` 행), `src/bootstrap/create-runtime-composition.ts`(부트 전 BFF 세션 owner), `src/contracts/rest-profiles.ts`(`TECH_LOG_STUDIO_SESSION`·`TECH_LOG_STUDIO_BOOTSTRAP`), `src/bootstrap/runtime-adapters.ts`, `src/bootstrap/runtime-config-schema.ts`, `src/features/installed-*` 다섯 개(TechLog 직접 조립. 그중 `installed-feature-runtimes.tsx`는 템플릿이 지웠다), `src/presentation/routes/app-router.tsx`(PUBLIC/STUDIO 라우터).
|
||||
3. 기능마다 HTTP descriptor를 센다. method, `retrySemantics`, `responseEnvelope`, 입력·응답·실패 검증기의 schemaId, 그 검증기가 zod인지. 옮기는 법 4·5단계의 작업량이 이 숫자로 정해진다.
|
||||
- memento-web: descriptor 29개. 입력·응답 schemaId 42개와 실패 본문 `MementoProblem` 1개. 검증기는 zod가 아니라 손으로 쓴 `isRecord` 검사다. `responseEnvelope`는 없다. GET은 `SAFE`, 쓰기는 `KEYED`·`IDEMPOTENT`·`NEVER`다.
|
||||
- TechLog: 검증기는 `zodValidator`다. 출력은 Envelope 뼈대만 검사하고 본문은 통과시킨다. `responseEnvelope`는 없다. GET은 `SAFE`, 쓰기는 `KEYED`나 `NEVER`(둘 다 `retryBudget` 0)다.
|
||||
4. 지금 게이트 결과를 남긴다. 동기화 뒤의 실패가 원래 있던 것인지 가르는 데 쓴다. 두 제품의 지난 동기화 기록(`docs/operations/template-sync-2026-09-29.md`)과 같은 목록이면 된다.
|
||||
|
||||
#### 옮기는 법
|
||||
|
||||
1. **기능이 아닌 폴더의 표시.** `src/features/<dir>/NOT_INSTALLED`를 같은 자리의 `NOT_A_FEATURE`로 바꾼다. 생성기는 `NOT_INSTALLED`를 더는 읽지 않는다. 표시와 `feature-module.ts`가 한 폴더에 있으면 생성기가 실패한다.
|
||||
- memento: `local-draft-feature`. 템플릿 폴더라 병합으로 바뀐다.
|
||||
- tech-log: `tech-log`, `reference-feature`, `local-draft-feature`. `reference-feature`는 템플릿이 그 폴더에 둔 `feature-module.ts`·`feature-runtime.ts`·`context-routes.ts`를 받지 않는다.
|
||||
(1103/09-09)
|
||||
2. **제품 코드를 제품 소유 파일로 옮긴다.** 템플릿은 아래 파일을 비워서 내보내고, 복사한 뒤에는 고치지 않는다. 제품 코드를 여기로 옮기고 "옮기기 전" 2단계의 템플릿 파일은 템플릿 것으로 되돌린다.
|
||||
- `src/contracts/product-contracts.ts`
|
||||
- `PRODUCT_REST_AUTH_PROFILES`: 제품 인증 프로필. memento의 `MEMENTO_BFF_READ`·`MEMENTO_BFF_WRITE`, tech-log의 `TECH_LOG_STUDIO_SESSION`·`TECH_LOG_STUDIO_BOOTSTRAP`이 여기 온다. 템플릿 프로필과 id가 겹치면 모듈 로드가 실패한다.
|
||||
- `PRODUCT_RUNTIME_CONFIG_FIELDS`와 `PRODUCT_ENV_REGISTRY`: 제품 런타임 설정 키(zod, `.default()`나 `.optional()`)와 그 FE-REG-ENV 행(`as const`). 키마다 행이 있어야 하고 행의 `required`·`defaultValue`가 스키마와 같아야 한다(`tests/unit/env-registry-coverage.test.ts`, `test:unit`). tech-log의 `TECH_LOG_*_SOURCE` 두 키가 여기 온다.
|
||||
- `src/bootstrap/product-composition.ts`
|
||||
- `composeProductSessionOwner(context)`: 부트 전 세션 owner. `AUTH_MODE=external`일 때만 불린다. tech-log가 `create-runtime-composition.ts`에서 host 전역에 넣던 BFF owner가 여기 온다. context의 `fetch`는 필수 칸이다(마감 `REQUEST_TIMEOUT_MS`, 본문 64 KiB, redirect 거부). 이 context를 직접 만드는 제품 테스트는 `fetch`를 더한다. 짝 백엔드 두 인증 모드의 owner 예시는 `recipes/session-owners/`에 있다.
|
||||
- `composeProduct(context)`: `capabilities`(memento `offsetUpload`·`runtime`, tech-log Studio 소스·HTTP), `credentialProviders`(인증 프로필별 자격증명. memento는 `x-xsrf-token`, tech-log는 `x-csrf-token`), 선택 칸 `onCredentialRejected`와 `scopeParticipants`.
|
||||
- 401 처리가 바뀌었다. 제품 provider가 자격증명을 낸 요청의 401은 템플릿 세션을 로그아웃시키지 않고 `onCredentialRejected`로만 온다. 두 제품처럼 provider와 세션 owner가 한 쿠키 세션을 쓰면 여기서 owner에 알린다(예: owner의 `notifyUnauthenticated`). 알리지 않으면 템플릿 세션은 그 401을 모른다.
|
||||
- `scopeParticipants`: 로그아웃·계정 전환 때 FENCED와 READY 사이에서 닫을 제품 자원. 닫기가 실패하면 READY로 가지 않는다.
|
||||
- `src/features/product-capabilities.ts`
|
||||
- `ProductFeaturePlatformCapabilities`: 제품 capability의 타입. `feature-adapter-contribution.ts`의 `FeaturePlatformCapabilities`에 `declare module`로 붙이던 보강을 여기로 옮긴다. 템플릿이 만드는 키(`http`, `telemetry`, `indexedDb`)는 다시 선언할 수 없다.
|
||||
- `PRODUCT_RUNTIME_CAPABILITY_SELECTION`: Service Worker·realtime·web worker·offline command 선택. memento가 `installed-runtime-capabilities.ts`에 적은 Service Worker `ACTIVE` 선택이 여기 온다.
|
||||
- `config/ci/product-gates.json`: 배포(`deployment`)와 제품 merge 검사(`mergeGates`, ID `PRODUCT-GATE-NNN`). 배포 슬롯을 `config/ci/gates.json`에서 채웠다면 여기로 옮긴다. `deployment`에는 package script 이름과 `vars.*`·`secrets.*` 바인딩만 적는다. 승격 후보를 받아 digest를 확인하고 푸는 단계는 템플릿이 만들고, `secrets.*`는 deploy 단계에만 간다.
|
||||
- 기능 어댑터 기여는 실행 중에도 `needs`에 적은 capability만 받는다. cast로 다른 capability를 읽던 코드는 `undefined`를 받는다.
|
||||
(1101/09-02, 1103/09-01, 1103/09-02, 1103/09-03, 1103/09-05, 1103/09-08, 1103/02-01, 1103/12-07, 1103/13-05)
|
||||
3. **기능을 선언과 실행부로 나눈다.** 기능 하나가 초기 JS에 약 3.9 KB gzip을 더해서 나눴다. 완성된 모양은 `src/features/reference-feature/`다.
|
||||
- 선언(`feature-module.ts`, `FeatureModule`): 초기 청크에 남는다. `id`, `contracts`(route 표, route runtime 계약, invalidation, topic version, `contractPackages`), `routes`, `messages`, `loadRuntime`만 가진다.
|
||||
- 실행부(`feature-runtime.ts`, `defineFeatureRuntime({ featureId, schemas, adapters, contractContributions })`): 그 기능의 route에 처음 들어갈 때 router가 `application.features.load(featureId)`로 적재한다.
|
||||
|
||||
순서:
|
||||
|
||||
1. 기능 계약에서 V2 칸 `apiOperations`·`runtimeSchemas`·`mappers`를 지운다. 스키마 메타데이터 `schemas`는 별도 파일로 빼서 `defineFeatureRuntime`에 넘긴다(참조: `contracts/reference-schema-metadata.ts`). memento-web에는 `*-api-contract.ts`가 없다. 이 칸들은 `contracts/memento-feature-contract.ts`에 있다. `apiOperations`와 `mappers`는 비어 있어 지우기만 한다. `runtimeSchemas`(`MEMENTO_RUNTIME_SCHEMA_CODECS`, 라우트 codec 7개)는 3번으로, `schemas`(라우트 행 7개)는 새 메타데이터 파일로 간다.
|
||||
2. 선언 계약에 `contractPackages`를 더한다. 기능의 `EXTERNAL_PACKAGE` 계약 기여가 고정하는 패키지 신원 목록이다. 없으면 `Object.freeze([])`. 부팅 때 release manifest를 이 목록과 맞춰 본다. 계약 기여의 출처는 `EXTERNAL_PACKAGE`이고, `TEMPLATE_FIXTURE`는 참조 기능 전용이다. memento가 템플릿 파일에 더한 `PRODUCT_LOCAL_CONTRACT`는 조립이 `unknown contribution source kind`로 거절한다. `EXTERNAL_PACKAGE`로 바꾸고 신원(패키지 이름·정확한 버전·`sha256:` digest·revision)을 준다. 자리표시자 신원은 로컬·개발 빌드에서는 되지만 staging·production 승인(FE-GATE-027)이 거절한다. 선택 기준은 `docs/manual/02-decision-tables.md` 2절이다.
|
||||
3. route codec을 `context-routes.ts`의 각 route `handle.codecs`로 옮긴다(참조: `presentation/reference-route-codecs.ts`의 `REFERENCE_FEATURE_ROUTE_CODECS`). 플랫폼 codec과 같은 id는 쓸 수 없다. `*-runtime-descriptor.ts`와 `src/features/installed-feature-runtimes.tsx`는 없어졌다.
|
||||
4. `feature-runtime.ts`를 만들고, `feature-module.ts`에서 `adapters`·`contractContributions`·`runtimes`를 지운 뒤 `loadRuntime: async () => (await import("./feature-runtime.ts")).FEATURE_RUNTIME`을 넣는다. `feature-runtime.ts`를 어디서도 정적으로 import하지 않는다. 그러면 실행부가 다시 초기 청크에 들어간다. `featureId`가 모듈 id와 다르면 적재 때 실패한다.
|
||||
5. runtime descriptor에 붙인 제품 칸은 context로 옮긴다. memento-web의 `ownsShell: true`와 `app-router.tsx` 다리는 `src/contexts/memento-context/context-layout.tsx`의 `CONTEXT_LAYOUT`이 대신한다. 레이아웃은 skip link와 `<main id="main-content" tabIndex={-1}>` 하나를 그린다. `tests/component/layout-landmarks.test.tsx`가 설치된 레이아웃을 모두 검사한다. memento-web은 이미 route id `APP_HOME`을 선언하므로 그것만으로 플랫폼 홈을 대신한다. `installed-feature-contracts.ts`의 `FEATURE_REPLACEABLE_PLATFORM_ROUTE_IDS` 다리는 지운다.
|
||||
6. 기능 input(`application.features.get(id)`)은 적재 뒤에만 있다. 그 기능의 route 밖에서 읽는 코드는 먼저 `await application.features.load(id)`를 부른다. `ApplicationApi.features`를 직접 구현하거나 fake로 만든 코드는 `load`를 더한다. 모든 기능의 실행부가 필요한 화면은 `loadInstalledFeatureRuntimeRegistries()`를, Node 스크립트와 테스트는 `src/features/loaded-feature-runtimes.ts`를 쓴다. `src/`에서 이 파일을 import하면 아키텍처 규칙 `boot-does-not-load-every-feature-runtime`이 막는다.
|
||||
7. `vite.config.ts`의 청크 그룹(`feature-declarations`, `feature-platform`, `react-dom`)을 가져간다. 없으면 기능마다 선언 청크가 하나씩 는다.
|
||||
|
||||
**직접 조립 제품(tech-log).** TechLog는 `feature-module.ts` 없이 `installed-*` 파일에 직접 조립된다. 이 묶음에는 그 자리가 없다. `installed-feature-runtimes.tsx`가 없어졌고, route codec은 context route handle에 실리고, 계약 기여는 기능 실행부를 적재할 때 설치되고, FE-REG-API·FE-REG-SCHEMA는 생성기가 설치한 기능만 본다. 템플릿이 준비한 길은 TechLog를 기능 모듈로 바꾸는 것이다. PUBLIC 묶음은 루트 `*`에 자기 레이아웃과 `APP_HOME`을 가진 context가 되고, 필요하면 같은 레이아웃을 쓰는 두 번째 루트 context(예: `topics/*`)를 둔다. STUDIO 묶음은 자기 레이아웃을 가진 `studio` context가 된다. 이 모양은 `tests/helpers/fixture-layout-product.tsx`가 선언하고 `tests/component/context-layouts.test.tsx`와 `layout-landmarks.test.tsx`가 실행한다. 바꾸면 TechLog descriptor에도 4·5단계가 적용된다. 직접 조립을 유지하면 `installed-*`와 라우터를 제품이 계속 고쳐야 하고, 템플릿은 그 경로를 검사하지 않는다(알려진 제한).
|
||||
(1101/15-01, 1101/07-04, 1101/09-03, 1101/16-04)
|
||||
4. **HTTP descriptor 조립 규칙.** 계약 조립(`composeContractContributions`)이 아래를 어기는 기여를 거절한다. 메시지는 `Installed contract contribution is not composable: <reason>`이다.
|
||||
- GET·HEAD의 `retrySemantics`는 `SAFE`나 `IDEMPOTENT`다. 재시도를 막으려면 `retryBudget: 0`.
|
||||
- POST·PUT·PATCH·DELETE에는 `SAFE`를 쓸 수 없다. `IDEMPOTENT`, `KEYED`(`commandRecovery` 필요), `NEVER`(`retryBudget` 0) 중 하나다.
|
||||
- 계약 기여 하나 안의 operation은 모두 같은 `responseEnvelope`를 읽는다. 값이 없는 것과 `"NONE"`은 같다. 두 백엔드를 쓰면 기여를 나눈다.
|
||||
- 쿠키 인증 프로필로 쓰기를 하면 그 프로필이 `x-csrf-token`이나 `x-xsrf-token`을 `requiredCredentialHeaders`로 요구해야 한다.
|
||||
- `commandEffect.refusedBeforeWrite`(쓰기 전에 나는 업무 거절 code 목록)는 `responseEnvelope: "ENVELOPE_V1"` operation에만 쓴다. `IDEMPOTENT_*`·`IDEMPOTENCY_*` code는 적을 수 없다.
|
||||
|
||||
두 다운스트림의 지금 descriptor는 앞의 넷을 지킨다. memento의 쓰기 프로필 `MEMENTO_BFF_WRITE`는 `x-xsrf-token`을, TechLog의 `TECH_LOG_STUDIO_SESSION`은 `x-csrf-token`을 요구한다. `responseEnvelope`가 없는 operation의 적용 여부는 지금처럼 `classifyProblem`이 정한다.
|
||||
|
||||
뮤테이션: `useApplicationMutation`은 `useServerStateScope()`의 scope를 담은 `BoundMutation`만 받는다. memento-web의 뮤테이션 8곳과 TechLog는 이미 그 모양이다. `operationId`·`requiresIdempotencyKey`는 `commandMutationIdentity(<descriptor>)`로 받을 수 있고, 그러면 오타를 타입 검사가 잡는다. `BoundMutation.owner`와 `QueryDefinition.owner`·`operationId`는 `@deprecated` 선택 칸이 됐고 다음 릴리스에서 지운다.
|
||||
(1103/07-01, 1103/03-03, 1103/16-01, 1103/07-02, 1103/03-01, 1101/08-03, 1103/16-05, 1103/16-06)
|
||||
5. **레지스트리 행과 기준선.**
|
||||
- FE-REG-API 행은 설치된 기능의 모든 V3 descriptor에서 뽑는다(22칸). V2 API 행이 없던 기능도 descriptor마다 행이 새로 생긴다. memento-web은 29행이다.
|
||||
- 각 행의 `requestSchema`·`responseSchema`·`problemSchema`는 FE-REG-SCHEMA 행을 가리켜야 한다. 그 기능의 `schemas`에 schemaId마다 행을 더한다. memento-web은 지금 라우트 행 7개뿐이라 43행(입력·응답 42, `MementoProblem` 1)을 더한다. 없으면 `check:registries`가 operation마다 `FE-REG-API.<operationId>.requestSchema references unknown FE-REG-SCHEMA.schemaId=<id>`로 실패한다.
|
||||
- 행의 칸: `boundary`는 쓰인 자리대로 적는다(`api-request` 입력, `api-response` 응답, `api-problem` 실패 본문, `route-params`, `route-search`, `route-search-api-request`). `direction`은 입력이 `REQUEST`, 응답·실패 본문이 `RESPONSE`다. `unknownFieldPolicy`는 적으면 검증기 동작과 같아야 한다. `tests/unit/schema-metadata-policy.test.ts`(`test:unit`)가 설치된 기능 전부를 대조한다.
|
||||
- `runtime`은 `"zod"`만 받는다. 손으로 쓴 검증기를 그대로 두고 `"zod"`라고 적으면 행이 사실과 다르다. memento-web의 검증기는 `zodValidator(schemaId, schema)`(`src/contracts/zod-validator.ts`)로 옮긴다. 지금 검사하는 만큼(객체인지, `items`가 배열인지)만 옮겨도 된다. 일부러 검증하지 않을 칸은 `unvalidatedPayload(schemaId, reason)`로 바꾼다. 그 칸은 FE-REG-API 행의 `unvalidated`와 플랫폼 구성 화면에 드러난다. governance의 `runtime` 허용값을 제품 쪽에서 넓히지 않는다.
|
||||
- 다 맞춘 뒤 기준선을 한 번 다시 승인한다. FE-REG-API governance가 바뀌어 동기화 직후 `check:registries`가 `contract-field-changed`로 실패하기 때문이다. `REGISTRY_BASELINE_OWNER=<owner> REGISTRY_BASELINE_REASON="<이유>" corepack pnpm update:registry-baseline`. 지금 diff와 맞지 않는 옛 breaking 증거 행도 이 명령이 지운다.
|
||||
(1103/07-01, 1103/16-04, 1103/07-03, 1101/07-03, 0929/07-01)
|
||||
6. **쓰는 곳이 있을 때만.**
|
||||
- V2 HTTP 클라이언트와 V2 API 행에서 지운 이름(아래 `048f490`·`12f3bb7` 행). 두 다운스트림은 앱 코드에서 V2 클라이언트를 부르지 않는다. 부르는 곳은 템플릿의 `tests/unit/runtime-adapters.test.ts`뿐이고 그 파일은 템플릿 것으로 바뀐다.
|
||||
- realtime: `BoundedPollOperationContract`를 지웠다. SSE·poll이 서버에 닿지 못한 실패는 `OFFLINE` 대신 `PROVIDER_UNAVAILABLE`이다.
|
||||
- 예제 화면 3개(`EXAMPLES_UI`·`EXAMPLES_STATES`·`EXAMPLES_AUTH`)가 `platform-examples-feature`로 옮겼다. 예제를 지운 제품(tech-log)은 이 기능 폴더와 `src/contexts/platform-examples-context/`를 지운다. 예제 화면을 여는 제품 테스트는 그 기능을 설치해 두거나 제품 화면으로 옮긴다. memento의 `production-csp.spec.ts`·`old-tab-chunk-recovery.spec.ts`가 `/examples/states`·`/examples/ui`에서 시작한다. `/examples/platform`(플랫폼 구성 화면)은 플랫폼 라우트로 남는다.
|
||||
- 포트를 직접 구현한 코드: `OpfsJournalPort.countPartitionTransactions`·`removePartition`, worker gateway의 `removePartition`, `PublicCacheInspection.activePointer`가 필수 칸이다.
|
||||
- offline-indexeddb recipe 타입: `src`와 이름이 같은 34개가 `src` 타입을 다시 내보낸다.
|
||||
(1103/04-01, 1103/04-04, 1103/09-04, 1103/05-01, 0929/05-01, 1103/02-05, 0929/05-03)
|
||||
7. **초기 JS 예산.** 예산은 gzip 204,800 B와 초기 파일 26개다(`config/performance/budgets.json`, merge 게이트 FE-GATE-012의 `check:bundle`). 템플릿 자체가 202,927 B를 쓴다. 여유는 1,873 B다. 측정용 기능 복사본 하나를 같은 context에 더하면 +768 B, 새 context 하나는 +233 B다(`config/scale/feature-shape-ceilings.json`. `tests/unit/feature-shape-growth.test.ts`가 기능 1 KiB·context 512 B로 막는다). 제품 기능의 선언(라우트 표, 문구)은 초기 청크에 들어간다. memento-web(라우트 14개)과 기능 모듈로 바꾼 TechLog의 크기는 템플릿이 재지 않았다. `build` 뒤 `check:bundle`이 넘은 한도와 초과량을 적는다. 예산을 올릴 때는 `docs/operations/performance-evidence.md`대로 기준선·새 측정값·이유를 같은 변경에 적는다. 초기 파일 수는 HTTP/2 서빙이 전제다.
|
||||
(1101/15-01, 1103/15-02, 1103/15-03, 1103/15-04, 1103/15-05)
|
||||
|
||||
#### 옮긴 뒤 확인
|
||||
|
||||
1. 로컬 merge 게이트 14개를 돈다(README "CI and evidence"의 반복문). `config/ci/product-gates.json`에 적은 `PRODUCT-GATE-NNN`은 workflow의 `product_merge_gate` job이 돈다.
|
||||
2. 그중 이 묶음 때문에 먼저 볼 것:
|
||||
- `check:registries`: `11 registries PASS`. 기준선을 다시 승인한 뒤에는 `compatibility=none`.
|
||||
- `test:unit`: `schema-metadata-policy`, `env-registry-coverage`, `feature-shape-growth`.
|
||||
- `test:component`: `layout-landmarks`, `context-layouts`.
|
||||
- `build` 뒤 `check:bundle`: 예산 안.
|
||||
- `verify:documentation`(FE-GATE-017): 참조 기능을 지운 제품도 통과한다.
|
||||
- `test:sample-removal -- --feature=<제품 기능 id>`: 그 기능을 지운 사본이 게이트를 통과한다.
|
||||
3. 배포가 있는 제품: FE-GATE-019는 TLS ALPN `h2`와 entry 응답의 `Content-Encoding`(br·gzip·zstd)을 요구한다. HTTP/1.1이나 압축하지 않는 호스트는 FAIL이다.
|
||||
|
||||
### 보안·계약 변경
|
||||
|
||||
#### 기능 구조와 조립
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] **BREAKING** | 기능을 선언(`feature-module.ts`)과 실행부(`feature-runtime.ts`)로 나눴다. 위 "먼저 할 일" 3단계. `ApplicationApi.features`에 `load(featureId)`가 생겼다. `*-runtime-descriptor.ts`와 `src/features/installed-feature-runtimes.tsx`는 없다 (1101/15-01) | `src/features/`, `src/application/ports/in/application-api.ts`, `src/presentation/routes/`, `vite.config.ts`, `.dependency-cruiser.json` | `298201f` |
|
||||
| [계약] **BREAKING** | 기능이 아닌 폴더의 표시는 `NOT_A_FEATURE`다. `NOT_INSTALLED`는 읽지 않는다. 표시와 `feature-module.ts`가 함께 있으면 생성기가 실패한다 (1103/09-09) | `scripts/generate-product-feature-index.ts`, `src/features/*/NOT_A_FEATURE` | `9edc830` |
|
||||
| [계약] | 제품 코드는 템플릿 파일이 아니라 제품 소유 파일에 둔다. `src/bootstrap/product-composition.ts`(capability, 인증 프로필별 자격증명 provider, `composeProductSessionOwner`, 선택 `onCredentialRejected`·`scopeParticipants`), `src/contracts/product-contracts.ts`(제품 인증 프로필, 런타임 설정 키, 그 FE-REG-ENV 행), `src/features/product-capabilities.ts`(capability 타입 `ProductFeaturePlatformCapabilities`, 선택 런타임 `PRODUCT_RUNTIME_CAPABILITY_SELECTION`). 자격증명 순서는 scope fence → ANONYMOUS → 제품 provider → 세션 → fence 재확인이다. 제품 설정 키는 `.default()`나 `.optional()`이어야 템플릿 테스트가 통과한다 (1101/09-02, 1103/09-02, 1103/09-05) | `src/bootstrap/product-composition.ts`, `src/bootstrap/product-composition-contract.ts`, `src/contracts/product-contracts.ts`, `src/features/product-capabilities.ts`, `src/features/installed-runtime-capabilities.ts` | `da1e128`, `ece944d`, `245f428`, `2f6df14`, `2963c6f` |
|
||||
| [계약] | 런타임 설정 키마다 FE-REG-ENV 행이 있어야 하고, 행의 `required`·`defaultValue`가 스키마와 같아야 한다(`tests/unit/env-registry-coverage.test.ts`). 템플릿 행 `RELEASE_ID`·`BUILD_ID`를 더했고 `TELEMETRY_ENABLED`·`AUTH_MODE`·`RELEASE_MANIFEST_URL`·`CAPABILITY_OVERRIDES`·`FEATURE_OVERRIDES` 행을 스키마에 맞췄다. `defaultValue`는 객체일 수 있다 (1101/09-02, 1103/13-04) | `src/contracts/env.ts`, `config/contracts/registry-governance.json`, `tests/unit/env-registry-coverage.test.ts` | `d0414c8`, `a144b57` |
|
||||
| [계약] | 기능 어댑터 기여는 실행 중에도 `needs`에 적은 capability만 받는다. cast로 다른 capability를 읽던 기능은 `undefined`를 받는다 (1103/09-08) | `src/features/feature-adapter-contribution.ts` | `e7d6358` |
|
||||
| [계약] | 기능 계약이 route id `APP_HOME`을 선언하면 플랫폼 홈을 대신한다. 둘이 선언하면 두 기능 id를 적고 실패한다. `src/contexts/<context>/context-layout.tsx`가 `CONTEXT_LAYOUT`을 내보내면 그 context의 라우트가 AppShell 대신 그 레이아웃 아래에 놓인다. 레이아웃은 skip link와 `<main id="main-content" tabIndex={-1}>` 하나를 그려야 하고, `tests/component/layout-landmarks.test.tsx`가 설치된 레이아웃을 모두 실행해 본다 (1101/09-03) | `src/contracts/routes.ts`, `src/contexts/bounded-context-module.ts`, `scripts/generate-product-feature-index.ts`, `tests/component/layout-landmarks.test.tsx` | `ca16187`, `27f4523` |
|
||||
| [계약] | 앱 조립이 닿지 않는 기능 라우트를 앱 모듈을 평가할 때 throw로 거절한다. 소유 context 루트 밖의 라우트, 계약에 없는 route handle, 플랫폼 라우트가 먼저 받는 경로, 다른 기능과 같은 경로(파라미터 이름만 다른 것과 대소문자·끝 슬래시만 다른 것 포함)다. 시작할 런타임이 없는 선택 capability(realtime·webWorkers·offlineCommands)도 거절한다 (1101/09-06, 1101/09-07, 1103/08-04, 1101 README 14.4) | `src/apps/deployable-app-module.ts`, `src/contexts/bounded-context-module.ts`, `src/bootstrap/` | `7139c7c`, `d6e4e51`, `7d85589`, `8469554`, `851fded`, `48a4074` |
|
||||
| [계약] **BREAKING** | 예제 화면 `EXAMPLES_UI`·`EXAMPLES_STATES`·`EXAMPLES_AUTH`가 끌 수 있는 기능 `platform-examples-feature`(context `platform-examples-context`, 루트 `examples/*`)로 옮겼다. 페이지 파일은 그 기능의 `presentation/`에 있다. `PLATFORM_ROUTE_REGISTRY`·`PLATFORM_ROUTE_RUNTIME_CONTRACT`·`PLATFORM_ROUTE_RUNTIME`에서 키가 빠졌다. 홈 문구 `home.starter.platform`·`ui`·`states`는 `home.starter.open({title})`로 바뀌었다. 예제를 지운 제품은 이 기능 폴더와 context를 지운다. `/examples/platform`은 플랫폼 라우트로 남는다 (1103/09-04) | `src/features/platform-examples-feature/`, `src/contexts/platform-examples-context/`, `src/contracts/routes.ts` | `b96d61d` |
|
||||
| [계약] | 계약 기여의 출처는 `EXTERNAL_PACKAGE`이고, `TEMPLATE_FIXTURE`는 참조 기능만 하나 쓸 수 있다. 다른 출처 종류는 `unknown contribution source kind`로 거절한다 (1101/07-04) | `src/contracts/external-contract-runtime.ts` | `c063389` |
|
||||
| [계약] **BREAKING** | `useApplicationMutation`은 raw `{ execute, definitionId }`를 받지 않는다. `useServerStateScope()`의 scope로 만든 `BoundMutation`을 넘기고 `execute(input, { signal, intent })`로 부른다. `commandMutationIdentity(<descriptor>)`가 `operationId`·`requiresIdempotencyKey`를 descriptor에서 준다. `QueryDefinition.owner`·`operationId`와 `BoundMutation.owner`는 아무도 읽지 않아 `@deprecated` 선택 칸으로 바꿨고 다음 릴리스에서 지운다. raw query는 남았다. 세션이 바뀌면 이전 결과가 보이지 않는다(JSDoc에 위험 표기) (1101/08-03, 1103/16-05, 1101/03-03, 1103/16-06) | `src/presentation/adapters/query/application-query.ts`, `src/presentation/adapters/query/` | `1fa5f3e`, `f59a806`, `68f94f5` |
|
||||
|
||||
#### HTTP와 계약
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] **BREAKING** | V2 HTTP 클라이언트를 지웠다. HTTP 경로는 V3 실행기 하나다. 배럴(`src/adapters/http/index.ts`)에서 `createHttpClient`, `HttpClient`, `HttpClientDependencies`, `HttpFailure`, `HttpResult`, `LegacyHttpInput`, `Scheduler`, `OperationRequestInput`가, `src/bootstrap/runtime-adapters.ts`에서 `createRuntimeHttpClient`, `RuntimeHttpContract`가 없어졌다. 지운 파일: `client.ts`, `bounded-json.ts`, `request-builder.ts`, `resource-mapper.ts`, `retry-policy.ts`, `schema-registry.ts`(`src/adapters/http/`). Envelope 스키마는 `backend-envelope.ts`에 있다. V2 클라이언트를 부르는 코드는 그 operation의 V3 descriptor를 만들어 `createFeatureHttpBinding`으로 실행한다 | `src/adapters/http/`, `src/bootstrap/runtime-adapters.ts`, `scripts/drill-runbook.ts` | `048f490` |
|
||||
| [계약] **BREAKING** | 기능마다 적던 V2 API 행을 지웠다. FE-REG-API 행은 contract contribution의 V3 descriptor에서 뽑는다(`src/contracts/api-operations.ts`의 `projectApiOperationRows`, 22칸: operation·경로·인증·재시도 의미·본문 모양·Envelope·스키마 세 개·`acceptedStatuses`·`emptyBodyStatuses`·`unvalidated`·바이트 상한 둘·`totalDeadlineMs`·`retryBudget`·`traffic`·`commandEffect`·`commandRecovery`). `problemSchema`도 FE-REG-SCHEMA를 참조하고, 그 행의 `boundary`는 새 값 `api-problem`이다. `problemSchema`·`unvalidated` 변경과 status 값 제거는 breaking이다. `FeatureRuntime`은 `apiContract` 대신 `schemas`(FE-REG-SCHEMA 행)를 받는다. 지운 이름: `defineRestOperation`, `ApiOperation`, `RestOperationV2`, `composeApiOperations`, `validateApiRuntimeBindings`, `getApiOperation`, contracts의 `API_OPERATIONS`; `rest-profiles.ts`의 `createRestProviderProfile`, `RestProviderProfile`, `resolveRestSecurityProfiles`, `validateRestProfileBindings`, `REST_CSRF_PROFILES`, `RestCsrfProfile`; `loaded-feature-runtimes.ts`의 `RUNTIME_SCHEMA_CODECS`, `MAPPER_REGISTRY`, `REST_PROFILE_BINDINGS_VALID`, `API_RUNTIME_BINDINGS_VALID`. realtime `apiOperations` 바인딩은 `ApiOperationRow`를 받고, snapshot operation을 `method: "GET"`과 `SAFE`·`IDEMPOTENT`로 본다. 옮기는 법은 위 "먼저 할 일" 3·5단계 (1103/07-01, 1103/16-04) | `src/contracts/api-operations.ts`, `src/contracts/schema-registry.ts`, `src/features/feature-module.ts`, `src/features/installed-feature-runtime-registries.ts`, `config/contracts/`, `scripts/create-feature.ts` | `12f3bb7`, `08ed0a0`, `3b40f73` |
|
||||
| [계약] **BREAKING** | 재시도 의미를 조립 때 검사한다. GET·HEAD는 `SAFE`·`IDEMPOTENT`만, POST·PUT·PATCH·DELETE는 `SAFE`를 쓸 수 없다 (1103/07-01, 1103/03-03) | `src/contracts/external-contract-runtime.ts` | `e4caafd`, `61f70cb` |
|
||||
| [계약] | 계약 기여 하나 안의 operation이 서로 다른 `responseEnvelope`를 읽으면 조립이 거절한다. 두 백엔드는 기여를 나눈다 (1103/16-01) | `src/contracts/external-contract-runtime.ts` | `3f7e10c` |
|
||||
| [보안] [계약] | 쿠키 인증 프로필(`SAME_ORIGIN_COOKIE`)로 쓰기(GET·HEAD 밖)를 하는 operation은 그 프로필이 `x-csrf-token`이나 `x-xsrf-token`을 `requiredCredentialHeaders`로 요구해야 한다. 아니면 조립이 거절한다. POST·PUT·PATCH·DELETE × 두 헤더 표로 테스트한다 (1103/07-02) | `src/contracts/external-contract-runtime.ts` | `365d8c3`, `a94006b` |
|
||||
| [계약] | V3 descriptor의 선택 칸 `responseEnvelope: "ENVELOPE_V1"`이면 실행기가 짝 백엔드 Envelope(`{success, data\|error, meta}`)를 읽는다. `outputValidator`는 `data`(키가 없으면 `null`), `problemValidator`는 `error`를 받는다. `meta.requestId`·`traceId`는 선택이다. 성공 status의 Envelope 아닌 본문은 새 위반 `ENVELOPE_MISMATCH`다(`HttpContractViolationKind`에 추가). `create:feature`가 만든 기능은 이 값을 선언한다. 참조 기능과 값이 없는 descriptor는 DTO와 problem details를 읽는다 (1101 README 14.3) | `src/contracts/external-contract-runtime.ts`, `src/adapters/http/`, `scripts/create-feature.ts`, `tests/mocks/handlers/http-scenarios.ts` | `7db32e1`, `bd83b49` |
|
||||
| [계약] | Envelope operation의 400·409·422와 백엔드가 정한 5xx 넷은 `classifyProblem` 대신 백엔드 기준 표(`backend-envelope.ts`, 근거는 계약 문서 6.1절)가 정한다. 적용 안 됨(`NOT_APPLIED`)은 400 `VALIDATION_FAILED`(details 모양과 상관없음), 400 `IDEMPOTENCY_KEY_INVALID`, 422 `IDEMPOTENT_REQUEST_MISMATCH`와 그 operation의 `refusedBeforeWrite` code다. 그 밖의 400·409·422는 결과 불명이다. 503 `IDEMPOTENCY_UNAVAILABLE`, 503 `IDEMPOTENCY_COMPLETION_UNKNOWN`, 500 `IDEMPOTENCY_RECOVERY_REQUIRED`, 503 `REQUEST_TIMEOUT`은 분류기와 상관없이 결과 불명이고 키를 지킨다. KEYED operation은 503 `IDEMPOTENCY_UNAVAILABLE`을 `retryBudget` 안에서 같은 키로 다시 보낸다. 필드 목록이 있는 거절은 `VALIDATION_REJECTED`와 필드 오류, 필드 목록 없는 422는 `UNKNOWN_CLIENT_FAILURE`다. 진단은 두 멱등성 거절에 `reason`을 싣는다 (1101 README 14.4, 1103/03-04, 1103/08-05) | `src/adapters/http/backend-envelope.ts`, `src/adapters/http/http-execution-v3.ts`, `docs/architecture/backend-api-and-server-state-contract.md` | `3261208`, `c05f41a`, `3761507`, `613c1cf` |
|
||||
| [계약] | `CommandEffectDescriptor.refusedBeforeWrite`(선택, Envelope operation 전용): 그 엔드포인트가 쓰기 전에만 내는 업무 거절 code. 적은 code의 400·409·422는 `NOT_APPLIED`라 폼에서 값을 고쳐 다시 저장할 수 있다. 멱등성 code를 적거나 Envelope가 아닌 operation에 적으면 조립이 거절한다 (1103/03-01) | `src/contracts/external-contract-runtime.ts`, `src/adapters/http/backend-envelope.ts`, `src/contracts/api-operations.ts` | `1e8b3d0`, `3fba68b` |
|
||||
| [계약] | 짝 백엔드 계약 기준점을 기계가 읽는다. `config/contracts/backend-contract-pin.json`(백엔드 `45d2a478`)과 백엔드 `docs/web/http-contract.md` §2 답 표(`config/contracts/backend-idempotency-answers.json`)를 `tests/unit/backend-contract-pin.test.ts`가 프론트 판정 표와 대조한다. `check:backend-contract-drift --backend <백엔드 checkout>`(로컬, 게이트 밖)이 pin 뒤의 백엔드 변경을 알린다 (1103/12-06) | `config/contracts/`, `scripts/check-backend-contract-drift.ts`, `src/adapters/http/backend-envelope.ts` | `ba2b4f4`, `5379c80` |
|
||||
| [계약] | 성공 결과에 Envelope `meta.page`가 `page`로 실리고, `mapSuccess` 두 번째 인자 `FeatureHttpSuccessContext { page }`로 받는다(배럴 `EnvelopePage`). bulk `results`는 지원하지 않는다. 실패 Envelope의 `meta.traceId`는 `AppFailure.traceId`가 된다. 실행 결과의 선택 칸 `sentRequestId`: 서버가 `x-correlation-id`를 돌려주지 않으면 `AppFailure.requestId`는 보낸 값이고, 결과 불명·조회 실패 화면에 "지원 참조" 줄이 보인다 (1103/03-02, 1103/03-06, 0929/03-04) | `src/adapters/http/` | `49a0986`, `631ce33`, `849d000` |
|
||||
| [계약] | 결과 불명 쓰기의 진단·텔레메트리에 `effect_certainty`가, 진단 `reason`에 `UnknownEffectReason`이 실린다 (1103/03-05) | `src/adapters/http/`, `config/contracts/` | `39c1de2` |
|
||||
| [계약] | 키 없는(`NEVER`) 결과 불명 요청에는 "같은 요청으로 다시 보내기"가 없다. mutation 컨트롤러 `canResendUnknownEffect`, `AsyncState.unknownEffectResendable`. 처리 중 409의 `Retry-After`는 `retryAfterMs`로 실리고, 결과 불명 요청을 같은 키로 다시 보낼 때 그 시각까지(최대 5초) 기다린다 (0929/03-03, 백엔드 리뷰 1101/02-01) | `src/presentation/adapters/query/application-query.ts`, `src/presentation/components/async-surface.tsx` | `2017ef7`, `47fec5c` |
|
||||
| [계약] | 전송 전 거절의 원인이 진단에 남는다. 연결 실수·멱등 키 위반은 `UNKNOWN_CLIENT_FAILURE`이고 화면 문구는 "요청을 처리할 수 없습니다."다 (1101/03-02) | `src/adapters/http/` | `4da0466` |
|
||||
| [계약] | 참조 기능의 생성 분류기가 409를 problem code로 나눈다. 선언한 충돌 code(`CONFLICT`)만 적용 안 됨이고, `IDEMPOTENT_IN_FLIGHT`·code 없는 409·모르는 409는 결과 불명이라 다음 전송이 같은 멱등 키를 쓴다 (0929/03-01) | `src/features/reference-feature/contracts/reference-feature-contract-contribution.ts` | `112c870` |
|
||||
| [계약] | 인증 프로필 `REFERENCE_EXTERNAL_BEARER`의 새 이름은 `EXTERNAL_BEARER`다. 옛 이름은 한 릴리스 동안 `@deprecated` 별칭으로 남는다. `CREDENTIAL_HEADER_NAMES`에 짝 백엔드 CSRF 헤더 `x-xsrf-token`을 더했다 (1101/16-03, 1101/09-02) | `src/contracts/rest-profiles.ts` | `6c5818f`, `183a4a3` |
|
||||
| [계약] | `zodValidator`(`src/contracts/zod-validator.ts`)가 zod 스키마를 `RuntimeValidator`로 바꾼다. 검증을 일부러 생략할 때는 `unvalidatedPayload(schemaId, reason)`를 쓴다. `listUnvalidatedPayloads(composed)`가 생략 목록을 만들어 플랫폼 구성 화면이 보여 준다 (1101/07-03) | `src/contracts/zod-validator.ts`, `src/contracts/unvalidated-payload.ts` | `d3ddc89`, `8b7c6eb` |
|
||||
| [계약] | 폐기 별칭 `MappingResult`(`boundary-mapper.ts`)와 `ApiFailure`(`errors.ts`)는 export로 남지만 lint가 `src`·`tests`의 import를 막는다. `BoundaryMappingResult`, `AppFailure`로 바꾼다 (1101/07-01) | `eslint.config.ts`, `src/contracts/boundary-mapper.ts`, `src/contracts/errors.ts` | `fc303d8` |
|
||||
|
||||
#### 레지스트리
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] | breaking 증거(`config/contracts/registry-change-evidence.json`)에 `after`가 필요하고 diff의 after 값과 같아야 한다. 지금 diff와 맞지 않는 증거 행은 `check:registries`가 적고 실패하며, `update:registry-baseline`이 그런 행을 지운다 (0929/07-01) | `scripts/lib/registry-compatibility.ts`, `scripts/update-registry-baseline.ts`, `docs/operations/ci-quality-gates.md` | `5e6be9a`, `4ada84e` |
|
||||
| [계약] | 분류기가 덜 깐깐해졌다. 선언 타입 안의 null ↔ 값 전환은 `breakingFields`로 등급을 정하고(보통 behavior-change), `allowedValues`에 값을 더하기만 하면 additive다. 무효화 그래프에 원소를 더하기만 한 변경도 additive다. 빼거나 바꾸면 그대로 breaking이다 (0929/07-02) | `scripts/lib/registry-compatibility.ts`, `scripts/check-registries.ts` | `82c9e59`, `605fd17` |
|
||||
| [계약] | FE-REG-ROUTE가 `paramsSchema`·`searchSchema`를 허용 목록으로 보지 않고, `loadingSurface`는 kebab-case 형식만 본다. 기능 라우트를 더해도 governance를 고치지 않는다. 다운스트림은 목록에 더해 둔 값을 지운다 (0929/07-03) | `config/contracts/registry-governance.json`, `scripts/check-registries.ts` | `e8d7fb4` |
|
||||
| [계약] | `StorageBackend`에 `"external"`이 생겼다. cross-context pulse 키는 외부 소유라 StoragePort로 읽고 쓰면 `*_UNAVAILABLE`로 거절된다. exhaustive switch는 분기를 더한다 (1101/05-01) | `src/contracts/storage-keys.ts`, `config/contracts/` | `e98a980`, `65ea208` |
|
||||
| [계약] | 진단 `ui.render.failed`의 `route_id`: 등록 라우트가 없는 URL의 적재 실패는 `NOT_FOUND` 대신 `UNREGISTERED_ROUTE`, 복구하지 못한 context 라우트 청크 실패는 context id 대신 그 라우트 id다. 이 값으로 거르는 대시보드·알림은 고친다 (1101 README 14.3) | `src/presentation/routes/`, `src/contracts/routes.ts` | `7c8cb19` |
|
||||
|
||||
#### 세션·인증
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] | 401은 그 요청의 자격증명을 낸 쪽에만 알린다. 템플릿 세션이 낸 자격증명의 401만 세션을 로그아웃시키고 캐시를 비운다. ANONYMOUS 요청과 제품 provider 요청의 401은 `ProductComposition.onCredentialRejected`(선택)로 간다 (1103/09-01) | `src/bootstrap/runtime-adapters.ts`, `src/bootstrap/product-composition-contract.ts` | `0aada28` |
|
||||
| [계약] | 인증 프로필이 ANONYMOUS인 요청은 세션 상태와 상관없이 자격증명 없이 나간다. 전에는 어느 세션 상태에서도 보내지 않았다 (1101/09-01) | `src/bootstrap/runtime-adapters.ts` | `ddf411e` |
|
||||
| [계약] | `ProductSessionOwnerContext`에 `fetch`(필수. 마감 `REQUEST_TIMEOUT_MS`, 본문 64 KiB, redirect 거부), `page`(`href`, `replaceUrl`, `assign`), `redirectStorage`, `readCookie`가 생겼다. 짝 백엔드 두 인증 모드의 owner recipe는 `recipes/session-owners/`(`oidc-pkce-session-owner.ts`, `cookie-session-owner.ts`)이고 매뉴얼은 `docs/manual/04-paired-backend-session.md`다. `src`가 이 recipe를 import하면 `check:optional-recipes`가 `PRODUCTION_IMPORTS_RECIPE`로 거절한다 (1103/09-03) | `src/bootstrap/product-composition-contract.ts`, `recipes/session-owners/`, `scripts/check-optional-recipes.ts` | `d02efe7`, `05958bb`, `f3fd10f` |
|
||||
| [계약] | 세션 상태 전이: 복구 성공은 authenticated, no-session은 unauthenticated(또는 integration-failed), 거절은 상태 유지다. "세션 복구" 화면은 no-session이면 로그인 버튼을 보인다 (1103/09-11) | `src/adapters/auth/external-session-adapter.ts`, `src/presentation/providers/session-provider.tsx` | `d7c6cb4` |
|
||||
| [계약] | `ProductComposition.scopeParticipants`(선택): 로그아웃·계정 전환 때 FENCED와 READY 사이에서 닫을 제품 자원. 닫기가 실패하면 READY로 가지 않는다. 예시는 `recipes/frontend-capabilities/browser-file-session-capability.ts` (1103/02-01) | `src/bootstrap/product-composition-contract.ts`, `src/bootstrap/runtime-adapters.ts`, `recipes/frontend-capabilities/` | `f485e51` |
|
||||
|
||||
#### 저장소·파일·전송
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] | OPFS journal 목록이 손상 행을 건너뛰고 `corruptRows`로 센다. reconcile은 `corruptTransactions`, 소속 partition이 없는 손상 행은 선택 칸 `unattributedRows`·`unattributedCorruptTransactions`로 따로 세고 DEGRADED 관측에서 뺀다. 승인된 LOGOUT·ACCOUNT_DELETION purge는 끝나지 않은 행을 보면 진행 중인 put을 기다린 뒤 partition을 지우고 `partitionDeleted`를 보고한다. partition 삭제는 partition Web Lock으로 다른 탭의 put과 겹치지 않는다. `OpfsJournalPort`의 `countPartitionTransactions(scope)`·`removePartition`과 worker gateway `removePartition`은 필수 메서드다 (0929/05-01, 1103/05-01, 1103/05-03) | `src/adapters/storage/opfs/`, `src/application/ports/browser-file-storage/` | `72edb55`, `e5b7b3e`, `d13a393`, `fd6b631` |
|
||||
| [계약] | OPFS partition lock을 기다리는 put·remove는 자기 abort로 `ABORTED`, `mutationLockWaitTimeoutMs`를 넘으면 `BLOCKED`(retryable)다. 정책의 `putIdleTimeoutMs`가 `mutationLockWaitTimeoutMs` 이상이면 조립이 거절한다 (1103/05-02, 0929/05-09) | `src/adapters/storage/opfs/` | `7b55f0f`, `f6b74ed` |
|
||||
| [계약] **BREAKING** | recipe의 browser-file·OPFS·storage durability·cache 타입 중 `src`와 이름이 같은 34개는 `src` 타입을 다시 내보낸다. fake는 `src` port를 구현하고 `BrowserDataResult`를 돌려준다. `MemoryDurableObjectStore` 생성자가 바뀌었고 `DurableObjectDataClass`·`DurableObjectIntegrity`·`DurableObjectRead`·`ObjectStoreRecoverySummary`는 지웠다. 이 fake의 reconcile은 `FILES_READY` put을 runtime처럼 commit하고 LOGOUT·ACCOUNT_DELETION은 멈춘 행도 지운다. offline-indexeddb recipe를 쓰는 프로젝트만 해당 (0929/05-03, 1103/05-04) | `recipes/frontend-capabilities/` | `e1a4580`, `36ff633` |
|
||||
| [계약] | `PublicCacheInspection.activePointer`가 필수 칸이다. 손상 pointer에서도 inspect가 상태와 후보를 보여 준다. 포트를 직접 구현한 쪽은 채운다 (1103/02-05) | `src/adapters/cache-storage/public-response-cache-adapter.ts`, `src/application/ports/browser-file-storage/cache-storage-ports.ts` | `7e7614f` |
|
||||
| [보안] | download 정책의 `safeExtension`이 위험 확장자이거나 그것으로 끝나면 조립이 거절한다 (1101/02-02) | `src/adapters/browser-files/` | `4f78890` |
|
||||
| [계약] | 업로드 part 발급·PUT이 서버의 `Retry-After`를 기다린다. `maxRetryAfterMs`를 넘으면 다시 보내지 않고 `upload()`·`abort()`가 `RESUME`·`retryable: false`를 준다. 실패 결과에 대기 시간이 붙도록 포트 반환 타입이 넓어졌다(추가만). upload 실패 번역은 HTTP 상태와 code로 recovery를 고르고, part 발급(BFF)의 401/403은 `NONE`(`retryable: false`)이다. file-transfer recipe를 쓰는 프로젝트만 해당 (1101/01-01, 1103/01-02, 0929/01-01) | `src/adapters/browser-transfer/` | `95e4445`, `c695898`, `9142390`, `c5f87aa` |
|
||||
|
||||
#### realtime·Service Worker·Web Push
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] **BREAKING** | `BoundedPollOperationContract`(V2 어휘)를 지웠다. `createBoundedPollCoordinator`의 operation과 `assertBoundedPollOperation`의 둘째 인자는 V3 descriptor(`BoundedPollOperation`)다. 조립된 행을 넘기고, `frontend.retryBudget` 0인 poll 전용 operation을 등록한다. 0이 아니면 생성 때 거절한다 (1103/04-01) | `src/adapters/realtime/` | `a65df74` |
|
||||
| [계약] **BREAKING** | SSE의 fetch·reader 거절과 bounded poll의 execute 거절은 `OFFLINE` 대신 `PROVIDER_UNAVAILABLE`(retryable)로 끝난다. 브라우저가 online이면 online 이벤트를 기다리지 않고 backoff로 다시 시도하고 상한에서 끝난다. poll은 던지는 execute도 lease 안에서 다시 시도한다. `OFFLINE`은 환경 신호에서만 나온다 (1103/04-04, 0929/04-01) | `src/adapters/realtime/` | `af00067`, `4d27b20` |
|
||||
| [계약] | stream coordinator와 live-poll handoff coordinator의 마감 실패가 `IDLE_TIMEOUT` 대신 `APPLY_FAILED`·`PROVIDER_UNAVAILABLE`로 나온다. stream coordinator의 `RealtimeObservation.reason`도 같다. `IDLE_TIMEOUT`은 전송 idle에만 쓴다 (1101/04-02) | `src/adapters/realtime/stream-coordinator.ts`, `src/adapters/realtime/` | `1196b86`, `17fa8d1` |
|
||||
| [계약] | realtime 배럴이 결과 생성 함수 `realtimeSuccess`·`realtimeFailure`를 내보낸다. 동결이 필요한 경계에 직접 만든 결과를 넘기던 코드는 이 함수로 바꾼다 (1101/04-01) | `src/adapters/realtime/index.ts` | `3fe28de` |
|
||||
| [계약] | Service Worker 빌드가 `public/`을 다시 복사하지 않는다(`publicDir: false`). 전에는 SW를 켠 빌드의 `dist/config.json`이 local 문서로 덮어써졌다 (0929/06-01) | `vite.service-worker.config.ts`, `scripts/build-frontend.ts` | `c7b9cb8` |
|
||||
| [계약] | 라우터 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` |
|
||||
| [보안] | Web Push registry가 URL로 해석하면 바뀌는 path(`..`, `%2e%2e`, `.`)를 생성 때 거절한다 (1103/06-02) | `src/adapters/web-push/` | `a145f30` |
|
||||
|
||||
#### 화면·문구·디자인 시스템
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] | `check:design-system` 규칙 4개: 두 테마에서 `--color-focus`가 표면 토큰 8종 모두와 3:1 이상, `color-mix()`는 `in oklab`만, 계약의 컴포넌트 토큰은 스타일 하나 이상이 `var(--name)`으로 읽음, `--font-sans` 첫 글꼴은 기본 키워드이거나 `@font-face`로 싣는 글꼴이거나 `PRODUCT_LOADED_FONT_FAMILIES`(`token-contract.ts`)에 있는 글꼴. deg 색상각과 시스템 글꼴 이름은 받는다 (UI-01, UI-02, UI-03, UI-05, 1101/12-01, 1101/12-02, 1101/12-04) | `scripts/check-design-system.ts`, `scripts/lib/design-system-rules.ts`, `src/presentation/design-system/tokens/token-contract.ts` | `35b183b`, `bfa7dd9`, `165ed19`, `8576ce1`, `49d8675`, `e714c0d`, `b4ccada` |
|
||||
| [계약] | design-system primitive가 `src/presentation/design-system/primitives/<컴포넌트>.tsx`로 나뉘었다. `design-system/index.ts`의 export 목록은 같다. 파일을 직접 import하던 코드는 경로를 바꾼다 (1101/08-08) | `src/presentation/design-system/primitives/`, `vite.config.ts` | `6dd4bc1`, `51941a5` |
|
||||
| [계약] | `MessageArguments<Key>`가 catalog 문자열의 `{이름}`에서 파라미터를 만든다(값은 string 또는 number). `check:i18n`은 catalog parity와 raw backend 메시지만 보고, 화면 문구 literal은 ESLint `screenTextSelectors`가 잡는다(template literal·삼항식·객체 prop 문구는 못 본다) (0929/08-03, 0929/08-02) | `src/presentation/i18n/message-contract.ts`, `eslint.config.ts`, `scripts/check-i18n.ts` | `ff33d58`, `855d22a` |
|
||||
|
||||
#### 빌드·배포·CI
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] | 번들 예산 게이트 FE-GATE-012가 merge 단계에서 돈다. 예산은 gzip 204,800 B와 초기 파일 26개(`initialJsFiles`)다. `check:bundle`은 넘은 한도와 초과량을 적고, `bundle.json`에 `initialJsFiles`·`initialFilesPassed`가 있다. 초기 JS 기준선은 `config/scale/feature-shape-ceilings.json`의 `initialJavascript`(지금 202,927 B, 26개, 기능 하나 +768 B, context 하나 +233 B)이고 `test:unit`이 빌드와 대조한다 (1101/15-01, 1103/15-05, 1103/15-03, 1103/15-02, 1103/15-04) | `config/ci/gates.json`, `config/performance/budgets.json`, `scripts/check-bundle.ts`, `config/scale/` | `f41e3d5`, `46dfe23`, `1b8cb12`, `c9e7bab`, `f887817` |
|
||||
| [계약] | 호스팅 계약: 파일이 없는 모든 경로에 그 release의 `index.html`을 HTML 헤더로 준다(SPA fallback, `appRoute`). 워커를 싣는 빌드의 `service-worker.js`는 `no-cache`다. live probe는 사전 캐시 확장자마다 `Content-Type`을 확인한다. nginx 예시는 `docs/operations/release-cache-rollback.md` (1101/13-04, 1103/06-03) | `config/hosting/cache-policy.json`, `scripts/lib/hosting-probe.ts`, `scripts/verify-hosting-headers.ts` | `629c8f0`, `0f58abb` |
|
||||
| [계약] | FE-GATE-019(production 단계)는 workflow의 `deployment` 슬롯이 배포한 승격 release를 본다. 슬롯이 비어 있으면 `UNVERIFIED`다. 배포된 `release-manifest.json`의 buildId·releaseId, `config.json`(비상 스위치 제외), `index.html` entry가 후보와 다르면 FAIL이다. TLS ALPN `h2`와 entry `Content-Encoding`(br·gzip·zstd)을 요구한다(`config/hosting/cache-policy.json`). HTTP/1.1이나 비압축 호스트는 FAIL이다. nginx 예시가 http2·gzip을 켠다 (1101/13-01, 1103/13-01, 1103/13-02) | `.gitea/workflows/quality-gates.yml`, `config/ci/gates.json`, `config/hosting/cache-policy.json`, `scripts/verify-hosting-headers.ts` | `de379ea`, `4bce8bf`, `2e12d2f` |
|
||||
| [계약] | 제품 소유 `config/ci/product-gates.json`: 배포(`deployment`, package script와 `vars.*`·`secrets.*` 바인딩)와 제품 merge 검사(`PRODUCT-GATE-NNN`, job `product_merge_gate`). 템플릿은 승격 후보를 받아 `CANDIDATE_ARCHIVE_SHA256`으로 확인하고 푸는 단계를 만든다. 배포 슬롯은 `gates.json`이 아니라 여기서 채운다 (1103/12-07, 1103/13-01) | `config/ci/product-gates.json`, `scripts/contracts/product-ci-overlay.ts`, `scripts/generate-ci-workflow.ts` | `4c4248a`, `2e12d2f` |
|
||||
| [보안] | 배포 슬롯의 `secrets.*`는 deploy 단계 env에만 간다 (1103/13-05) | `scripts/generate-ci-workflow.ts`, `scripts/contracts/ci-gates.ts` | `2e12d2f` |
|
||||
| [계약] | staging·production 승인(FE-GATE-027)이 `example.com`·`example.net`·`example.org`와 그 하위 도메인, `.example`·`.invalid`·`.test` endpoint와 자리표시자 계약 신원(digest `PLACEHOLDER_CONTRACT_PACKAGE_DIGEST`)을 거절한다. `findAdmissionViolations`가 세 번째 인자로 계약 패키지를 받는다. CI에서 endpoint는 `config/runtime/<profile>.json`에 커밋한다 (1101/13-02, 1101/16-01) | `src/contracts/deployment-admission.ts`, `scripts/check-release-admission.ts` | `7b34756`, `1269992` |
|
||||
| [보안] | release 단계 FE-GATE-027이 `scan:dependency-advisories`로 의존성 advisory를 템플릿 정책에 따라 판정해 남긴다(막지 않음). `renovate.json`을 더했다. 개발 의존성의 high·critical advisory를 범위 안에서 고쳤다(storybook 10.6.5, vite 8.1.6, vitest 4.1.12) (1103/13-03) | `scripts/scan-dependency-advisories.ts`, `renovate.json`, `package.json`, `pnpm-lock.yaml` | `eeb6f92`, `26ca2fd` |
|
||||
| [보안] | provider 샌드박스가 `.git` 파일(worktree·서브모듈)을 `/dev/null` 읽기 전용 bind로 가린다. worktree에서도 `test:system`이 돈다 (1103/11-04) | `scripts/run-and-validate-provider.ts` | `0edc3fc` |
|
||||
| [계약] | `create:feature <id> [--context <ctx>] [--with-create [--keyed]] [--package <name@version> --digest <sha256> --revision <hex>]`가 기능 뼈대를 만든다. 목록 경로는 짝 백엔드 `new-feature.sh`와 같은 `/<plural>`이고 결과 수는 `meta.page.total`이다. `--with-create`는 짝 백엔드 생성기와 같은 상세 GET·작성 POST(기본 `NEVER`, `--keyed`면 `KEYED`)·폼·결과 불명 화면·백엔드 본문 테스트를 더한다. FE-GATE-020의 `test:feature-scaffold`는 생성한 기능으로 `gates.json`의 merge 단계 명령을 돌고(브라우저 게이트·`test:system`·`verify:lockfile`·제거 드릴은 이유와 함께 뺀다) 그 기능의 제거 드릴도 돈다 (1101/16-01, 1103/03-07, 1103/09-06, 1103/12-02, 1103/16-02) | `scripts/create-feature.ts`, `scripts/create-feature-write-slice.ts`, `scripts/test-feature-scaffold.ts`, `config/ci/gates.json` | `d166aa3`, `2ec9d56`, `e1b4e28`, `7411d4a` |
|
||||
| [계약] | `verify:documentation`(FE-GATE-017)이 입구 문서 4개의 src 최상위 폴더 설명과 `layers.md`의 아키텍처 규칙 이름을 검사한다(`sourceStructure`). `docs/README.md` 1절 현재 계약 문서의 repo 경로·명령 안 경로·링크·package script·FE-GATE ID와 짝 백엔드 참조를 검사한다(`documentReferences`, 짝 저장소가 옆에 없으면 `unverifiedLinks`). 수동 접근성 범위는 라우트별 기록 파일로 검사한다. 참조 기능 경로와 그 전용 script는 문서에 백틱 없이 적어, 참조 기능을 지워도 통과한다 (1101/14-03, 1101/14-05, 1103/12-05, 1103/14-04) | `scripts/verify-documentation-readiness.ts`, `docs/README.md`, `docs/manual/` | `61baf96`, `16202fd`, `b4e4f98`, `c4d5870`, `fd11d08` |
|
||||
| [계약] | 규모 설계서는 `docs/architecture/scale-architecture.md`(현재 계약, 절 번호 유지)다. 코드 주석 `Spec §N`은 `scale-architecture.md §N`이고, 문서 이름 없는 `spec §` 참조는 `tests/unit/deletable-history-documents.test.ts`가 막는다. `docs/reviews/adapters/`는 지울 수 있는 기록이 아니다 (1101/14-01) | `docs/architecture/scale-architecture.md`, `README.md`, `docs/README.md` | `0a7fbed`, `b26517e` |
|
||||
| [계약] | 쓰지 않는 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` | `98b9682` |
|
||||
| [계약] | Vitest가 CI에서 skip·todo·only가 남은 실행을 실패시킨다(`-t`나 `file:line`으로 좁힌 실행은 제외). quarantine 주석이 붙은 skip도 실패한다 (1101/10-04) | `vitest.config.ts`, `tests/support/` | `95e7d11` |
|
||||
| [계약] | 시각 테스트: `tests/visual/fonts.conf`로 글꼴을 고정하고 스크린샷 전에 실제 글꼴을 검사한다(Linux 전용). CI 브라우저 설치 단계가 글꼴 4종(`fonts-noto-core fonts-noto-cjk fonts-noto-cjk-extra fonts-liberation`)을 설치한다. 허용치는 절대 50 px다. 골든은 설치된 기능의 링크·목록·계약 다이제스트를 가리고 찍어, 기능을 더해도 다시 찍지 않는다 (1101/11-02, 1103/11-02, 1101/11-03, 1103/12-01) | `tests/visual/`, `playwright.visual.config.ts`, `.gitea/workflows/quality-gates.yml` | `08b5ccc`, `b0195e3`, `5ce3db9`, `0a6ff6e` |
|
||||
| [계약] | 레시피 번들 예산: file-transfer 57,800, offline-indexeddb 38,500, realtime 42,200, service-worker-pwa 10,100 B. 측정값 + 3%를 100 B 단위로 올린 값이고, 3%를 넘는 증가는 커밋 본문에 이유를 적는다. 규칙은 `docs/architecture/optional-adapter-recipes.md` (0929/05-04) | `config/recipes/frontend-capability-recipes.json` | `313f9ba` |
|
||||
|
||||
### 그 밖의 수정
|
||||
|
||||
- 화면: 라이트 포커스 링 대비, oklab 색 혼합, 기본 버튼·현재 메뉴가 컴포넌트 토큰을 읽음, `--font-sans`가 실제로 그려지는 시스템 글꼴, 테마·언어 선택 상자 폭, 예제 머리글의 반복 "예제" 라벨 삭제, 표 스크롤 영역 이름, 입력란 테두리가 `--field-border`를 읽음 (UI-01, UI-02, UI-03, UI-04, UI-05, UI-06, UI-08, 1101/12-01)
|
||||
- 화면: 좁은 화면(48rem 미만)에서 머리글이 숨기던 테마 선택과 세션 상태를 메뉴 서랍에 둔다. 셸 문구가 DOM에 두 벌이라 페이지 전체에서 `getByText`로 찾는 테스트는 범위를 좁혀야 한다 (1101/08-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)
|
||||
- 폼: 짝 백엔드 필드 검증 code(`NOT_BLANK`, `SIZE` 등 20개)마다 문구가 있다. 모르는 code는 기본 문구다 (`8a09c90`, 1101 README 14.4). `constructor` 같은 필드 code는 기본 문구다 (1103/08-03). 키보드 저장이 결과 불명·429 등 필드 오류가 아닌 실패로 끝나면 포커스가 실패 상태로 간다(`FormPage` `feedbackId`, 저장 버튼 pending) (1103/08-02)
|
||||
- 진단: context·feature 오류 경계와 라우트 모듈 실패가 진단에 남고 지원 참조가 `build:incident` 형식이다 (1101/09-09). 계약 조립 오류 메시지가 `reason`을 싣는다 (1103/09-07). 문제 응답 분류기 실패는 `CLASSIFIER_FAILED` (1101/03-05). 어느 무효화 topic도 닿지 않는 조회 namespace를 진단으로 한 번 알린다 (1101/03-01)
|
||||
- 저장소: 진단 `storage.operation.failed`에 `reason`이 붙는다 (1101/05-02). lifecycle 리스너 주인 규칙과 테스트 (1101/05-03). OPFS purge가 객체를 못 지우면 완료와 chunk sweep을 보고하지 않는다 (0929/05-02). 여러 페이지를 다 지운 purge는 한 번에 끝났다고 보고한다 (`c4052f0`, 1101 README 13.6)
|
||||
- 브라우저 파일·캐시: preview·download의 dispose가 자기 lease만 푼다 (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). Cache Storage 활성화의 본문 읽기 일시 오류는 손상이 아니라 `UNAVAILABLE`·`RETRY`다 (1103/02-02). browser-files vault에서 inspect 중에 놓은 ref는 `NOT_FOUND`·`RESELECT`다 (1103/02-04)
|
||||
- 전송: 재조정에서 checkpoint 삭제가 실패해도 `upload()`가 `resourceId`를 준다 (0929/01-02). `FILE_BYTE_SOURCE` 이어 올리기는 수락된 part를 다시 해시하지 않는다 (1101/01-02). 짝 백엔드 Fileserver `POST /v1/files` 한 번 업로드 client `createFileserverUploadClient`(`src/adapters/http` 배럴, 201·202, 실패 Envelope, `Idempotency-Key`, `Retry-After`)를 더했다. 413·415·422 파일 거절은 `VALIDATION_REJECTED`, 같은 키 불일치 422는 공통 판정이다. presigned 업로드 레시피가 짝 백엔드와 맞지 않음을 문서에 적었다 (1103/01-01)
|
||||
- 운영: 배포된 `config.json`의 비상 스위치(`CAPABILITY_OVERRIDES`, `FEATURE_OVERRIDES`)를 바꾸기 전에 `check:release-admission --config <고친 사본> --original <배포된 원본>`으로 검사한다. 두 스위치 밖의 필드가 바뀌면 거절한다. 절차는 `docs/runbooks/FE-RB-001.md` (1101/13-05). 워커 스크립트 헤더 검사 범위 (1103/06-01), waiting 기간의 소유 캐시 누적 (1103/06-04), 워커 제거 1단계 유지 기간 (0929/06-06)을 운영 문서에 적었다
|
||||
- realtime 문서: 짝 백엔드 실시간 출구와 프론트 transport 대응표 (1103/04-02), 레지스트리 세 바인딩의 출처 (1103/04-06), heartbeat를 멈춘 WebSocket (0929/04-04), Service Worker 레시피가 오프라인 셸을 약속하지 않음 (0929/06-03). WebSocket 구독별 초당 event 상한 (1101/04-03)과 워커 보호 장치 4개 (1101/06-04)를 테스트로 고정했다
|
||||
- 빌드: react-dom과 scheduler를 자기 청크로 빼 build id만 바뀐 release의 캐시 손실을 줄였다 (1103/15-06). 운영 빌드가 react-router의 운영 빌드를 싣는다 (1103/15-07). 폐기 예정 `build.rollupOptions`를 `rolldownOptions`로 바꿨다 (0929/13-07). pnpm 설치 정책 키가 빠지거나 약해지면 테스트가 실패한다 (0929/13-08). README 변수 표에 `VITE_BUILD_ID`가 staging·production에서 필수임을 적었다 (0929/13-09). 갤러리 전용 primitive를 초기 청크에서 뺐다 (1101/08-08)
|
||||
- 성능: 플랫폼 구성 화면이 제목과 선언 정보를 먼저 그리고 실행부 표만 나중에 채운다. lab 게이트 FE-GATE-026이 다시 통과한다. `PlatformOverviewPage`의 `contracts` prop은 Promise다 (1103/15-01). 성능 문서의 번들 기준선과 분류 규칙을 지금 빌드에 맞췄다 (1101/15-02, 1103/15-02)
|
||||
- 레지스트리 도구: `check:registries`가 조립 실패의 `reason`을 적고, 읽지 못한 레지스트리를 지운 것으로 세지 않는다 (1103/14-06). FE-REG-SCHEMA 행의 `direction`·`unknownFieldPolicy`·`boundary`를 검증기·쓰임과 대조한다 (1103/07-03, 1103/16-04). 금지 조각이 든 런타임 설정 키를 `test:unit`이 이름과 함께 막는다 (1103/07-04). `check:feature-index` 예외 이유를 실제 사용처로 고쳤다 (1101/12-05)
|
||||
- 아키텍처 검사: zod 하위 경로(`zod/v4` 등) import도 `src/contracts/zod.ts`를 거쳐야 한다 (`64f19ac`, 1103 07 영역 P-07-06). 금지 fixture를 그 계층의 운영 ESLint 설정으로 검사하고 fixture 전용 블록을 지웠다 (1103/12-04). adapter kernel 설명을 실제 `platform` 폴더 내용에 맞췄다 (`3f72ae7`). 두 오류 어휘(`AppFailure`·`AppError`)와 `commandRecovery`를 누가 읽는지 타입 옆에 적었다 (1101/07-05, 1101/07-07)
|
||||
- 게이트·드릴: coverage 증거 검사(FE-GATE-005)가 istanbul summary의 `branchesTrue`를 받는다 (1103/12-09). compact smoke e2e가 빌드에 준 `VITE_BUILD_ID`를 기대해 CI 값에서 FE-GATE-008이 항상 실패하지 않는다 (1103/11-06). vitest와 dev server를 띄우는 Playwright 설정(capabilities, dev)이 CI의 `VITE_BUILD_ID`·`VITE_COMMIT_SHA`를 물려받지 않는다. 전에는 CI env에서 앱을 local-build fixture로 조립하는 테스트와 capability e2e가 `CONFIG_BUILD_MISMATCH`로 떨어져 FE-GATE-005·006·007·008·020이 항상 실패했다 (1103/11-07). 테스트가 만드는 로컬 빌드(fixture 빌드, 시각 골든 build, 브라우저 테스트의 dev server)는 `CI=true`에서도 release 빌드로 검사되지 않는다(`localBuildEnvironment`, `LOCAL_BUILD_IDENTITY`). 전에는 workflow env에서 FE-GATE-005·008·020이 실패했다 (1103/11-08). 브라우저 테스트의 strict fixture가 WebKit의 "preload했지만 몇 초 안에 쓰지 않았다" 경고 문구만 무시하고, 대신 preload된 build script가 실제로 실행됐는지를 세 엔진에서 검사한다(`preloadunused:`, `tests/support/browser/preload-use.ts`). WebKit은 load 3초 뒤 한 번 추정해서, 곧 쓰일 청크를 preload한 화면에서 FE-GATE-008이 가끔 떨어졌고 정말 안 쓴 preload는 놓쳤다. build script를 직접 fulfill하는 test는 `fulfillBuildScript`를 쓴다 (1103/11-09). browser capability의 파일 선택·다운로드 test가 붙이는 버튼을 앱 위 고정 층에 둔다. 앱이 그리는 도중 내용이 자라 클릭 사이에 버튼이 움직였고, 클릭이 버튼에 닿지 않아 firefox에서 FE-GATE-008이 가끔 30초 시간 초과로 떨어졌다 (1103/11-10). capability 제거 드릴 3개가 문서 테스트 `ENOENT`로 항상 실패하던 것을 고쳤다. 문서를 읽는 테스트 목록은 `scripts/lib/removal-fixture.ts` 한 곳이다 (1103/02-06). `test:sample-removal`이 문서를 복사해 `lint`·`verify:documentation`·`check:i18n`·`check:design-system`을 돈다 (1103/14-04). 제품 기능 제거 드릴이 CI 기준선 사유 공백으로 멈추지 않는다 (1103/16-02). `test:system` provider 묶음 30초 예산 (1103/11-03), scope wrapper EOF 테스트 (1103/10-01)와 IndexedDB 차단 업그레이드 테스트 (1103/11-05)의 부하 원인을 없앴다. `artifacts/**/*.log`를 추적하지 않는다 (1103/12-08)
|
||||
- 기능 추가 뒤 검증(리뷰 조치 X2): [계약] `create:feature`와 기능 제거 드릴이 dev server의 manifest(`public/release-manifest.json`)의 contract set을 설치된 기능으로 다시 쓴다(`node scripts/write-dev-release-manifest.ts`). 기능과 함께 커밋한다. 낡으면 `tests/unit/dev-release-manifest.test.ts`가 실패한다. 전에는 `create:feature` 직후 dev server와 dev server를 쓰는 capability e2e가 `CONTRACT_SET_PACKAGE_MISSING`으로 부팅하지 못했다 (1103/16-09). dev server가 `artifacts/`·`dist/`·`.tmp/`를 감시하지 않는다. 기능 제거 드릴(`test:sample-removal -- --feature=<id>`)이 지운 뒤 초기 JS 기록을 다시 쓴다 (1103/15-02). 초기 JS 파일 상한이 32다(템플릿 26 + 여유) (1103/15-05). Fileserver 업로드 client가 browser-file-storage 포트를 import하지 않아 그 런타임을 지워도 남는다(`FileserverByteSource`) (1103/01-01). 제품 확장 타입 검사 탐침이 예약 이름(`typecheck-probe-*`)을 쓰고 제품의 capability 선언을 덮어쓰지 않는다 (1103/09-02). 시각 골든 build와 storybook workshop spec이 CI 식별값·a11y 애드온 자동 검사와 겹치지 않는다 (1103/11-07)
|
||||
- 테스트: Testing Library 대기 기한을 `tests/setup.ts` 한 곳에서 5초로 정했다 (0929/10-01). `npx vitest`나 npm을 거친 IDE 실행기로 돌려도 실패하지 않는다 (1101/15-05). cgroup 시스템 테스트가 실행 단계가 남긴 PID·argv 기록을 읽는다 (1101/11-01). exact-five CLI 테스트가 실제 출력 문구를 기대한다 (0929/11-01). guardian이 실패하면 stdin을 기다리지 않고 끝난다 (`3c175a5`). 계약 조립기의 쓰기 API 규칙 5개 (1101/07-06), 이벤트 계약 검증 (1101/10-01), Envelope 판정 경계와 처리 중 409 무재전송 (1103/10-02), `MAX_RETRY_ATTEMPTS` 전달과 signal listener 정리 (1103/10-04)를 테스트로 고정했다. 규모 측정 기준선을 다시 쟀고 측정용 기능 복사본은 외부 패키지를 고정한다 (`9333595`, 1101/07-04). 설치 기능이 0개여도 타입 검사와 커버리지가 통과한다 (`e4ace51`, 1101/15-01)
|
||||
- 테스트: 플랫폼 component 테스트가 스타터 화면 대신 테스트 전용 페이지(`tests/helpers/fixture-feature.tsx`)를 쓴다. 스타터 화면을 바꾸는 제품은 `tests/component/starter-*.test.tsx`를 함께 지운다. HTTP 시나리오 증거(FE-GATE-007)와 기능 API 타입 음성 fixture(FE-GATE-003)는 샘플을 지워도 남는다 (0929/10-02). 기능 테스트는 `createHttpScenarioHandler(<설치 계약>, { scenario, payload })`로 공유 MSW 시나리오를 쓰고, `tests/mocks/**`는 플랫폼 소유다 (1101/16-02, 1101/16-01). SW e2e가 제품이 켠 worker와 빌드가 만든 사전 캐시 목록을 쓴다 (0929/11-03, 0929/06-04). 접근성 e2e가 설치된 descriptor의 경로와 `responseEnvelope`로 빈 목록을 답하고 목록 화면에 경고 상자가 없음을 단언한다. 기능을 더해도 spec을 고치지 않는다 (1103/11-01, 1103/16-03)
|
||||
- 참조 기능: 샘플 페이지가 `referenceRouteUrl(routeId, input)`으로 링크를 만들고 route 입력 cast를 없앴다. `REFERENCE_FEATURE_ROUTE_CODECS`는 `presentation/reference-route-codecs.ts`에 있다. 목록 링크 href는 `?limit=20`이 붙은 정식 URL이다 (1101/16-04). `create:feature --context reference-context`로 만들어도 참조 라우팅 테스트가 깨지지 않는다 (`e8c4197`)
|
||||
- 문서: 새 기능 추가 매뉴얼 `docs/manual/`(한국어)을 더했다. 단계마다 정할 것, 판단 기준, 잡는 검사와 못 잡는 것을 적고, 결정표·기능 폴더 밖 파일·`create:feature` 인자·전역 ID·패턴·오류 메시지 참조를 둔다. 두 템플릿 공통 원칙은 design-docs repo `conventions/feature-design-principles.md`에 있다 (1101/16-01). 짝 백엔드 생성 기능의 쓰기 값 넷 결정표 (1103/16-07), 업무 거절 code를 `refusedBeforeWrite`에 적는 안내 (1103/03-01), 짝 백엔드 세션에 처음 붙이기 `docs/manual/04-paired-backend-session.md` (1103/09-03), 기능 실행부 설명 네 곳 (1103/09-10, 1103/07-05)
|
||||
- 문서: 목표 설계 문서 VD-23·VD-24와 `api-contract-schema-mapper-and-server-state.md`의 V2 상태를 `REMOVED`로 바꾸고, VD-23의 401 문장을 정본 8.4("401 뒤 숨은 refresh-and-replay 없음")에 맞췄다. 쓰기 전 거절 표(계약 문서 6.1절)는 `docs/README.md` 1절이 링크해 경로 검사를 받는다 (1103/14-03). 정본 표가 제품 설정 키의 FE-REG-ENV 행을 요구하는 테스트를 적는다 (1103/14-05). `PRODUCT.md`를 더하고 예제 제거 주장을 드릴 범위에 맞췄다 (1101/14-04). 리뷰 ID에 라운드를 붙인다 (1101/14-02). `verify:documentation`이 실패하면 실패한 검사 이름과 고칠 문서·빠진 route ID를 적는다 (1101/14-06)
|
||||
|
||||
### 알려진 제한
|
||||
|
||||
이 절을 쓴 끝 커밋(`f887817`)에서 사실인 것만 적었다.
|
||||
|
||||
- 다운스트림 이행: 위 안내를 두 제품 코드에 적용해 게이트를 돌려 보지 않았다. memento-web의 숫자(descriptor 29개, schemaId 42개 + `MementoProblem`)는 memento `d3810a0`을 정적으로 센 값이다.
|
||||
- 직접 조립 제품(tech-log의 TechLog): 템플릿에 그 자리가 없다. 기능 모듈로 바꾸는 길은 fixture(`tests/helpers/fixture-layout-product.tsx`)로만 검사했고 TechLog 화면으로는 해 보지 않았다. 직접 조립을 유지하면 FE-REG-API·FE-REG-SCHEMA와 스키마 메타 대조 테스트가 TechLog descriptor를 보지 않는다.
|
||||
- 제품 안에 적은 계약(memento `PRODUCT_LOCAL_CONTRACT`)에 줄 출처 종류가 없다. `EXTERNAL_PACKAGE` 신원을 어떻게 정할지(패키지 없이 digest를 붙이는 법)는 템플릿이 정하지 않았다.
|
||||
- 참조 기능은 `responseEnvelope`를 선언하지 않아 DTO와 problem details만 읽는다. 짝 백엔드에 붙는 완성 예시는 `create:feature --with-create`가 만드는 기능이다.
|
||||
- 짝 백엔드 생성기(`new-feature.sh`)에 목록 GET이 없다. `create:feature` 목록 화면은 백엔드가 `GET /<plural>`을 더한 뒤에야 닿는다 (1103/03-07).
|
||||
- 짝 백엔드 계약 pin은 `45d2a478`(2026-11-05)이다. 그 뒤 백엔드가 바뀌면 `check:backend-contract-drift --backend <백엔드 checkout>`가 알린다. 이 검사는 게이트 밖이라 CI는 알리지 않는다.
|
||||
- 업로드: 백엔드 `POST /v1/files`는 `Idempotency-Key`를 읽지 않는다. 결과 불명 뒤 같은 키로 다시 보내도 파일이 둘 생길 수 있다. client의 code 목록은 백엔드 기준점에 묶여 있다. `EXTERNAL_BEARER`로 올리려면 제품 provider가 필요하다. 실제 백엔드 업로드와 firefox·webkit은 돌리지 않았다.
|
||||
- 세션 owner recipe는 실제 Keycloak·Redis와 붙여 보지 않았다. jwt 모드: 백엔드 realm에 브라우저용 public client가 없어 제품이 더한다(매뉴얼 04에 JSON). redis-session 모드: 백엔드 운영 코드에 로그인·로그아웃·세션 조회·CSRF 발급 엔드포인트가 없어 owner가 URL을 기본값 없이 받는다. OIDC owner는 토큰을 메모리에 두어 새로고침하면 로그아웃되고, ID token 서명을 검사하지 않는다.
|
||||
- 플랫폼 구성 화면(`EXAMPLES_PLATFORM`, `/examples/platform`)은 플랫폼 라우트라 끌 수 없고 FE-GATE-028 서명 대상이다. 예제 기능을 뺀 제품에서 예제 화면을 여는 e2e·visual spec은 실패한다 (1103/09-04).
|
||||
- 기능 라우트 첫 진입(실행부 청크, 약 430 ms)은 어느 게이트도 재지 않는다.
|
||||
- 초기 JS 여유가 1,873 B다. `--with-create` 기능 하나(약 +964 B)를 넣으면 약 900 B가 남는다.
|
||||
- 운영 의존성 high advisory 2건이 남았다: `zod` 4.4.3 GHSA-mrhx-c7xc-m3w5(고치는 버전은 초기 JS 약 +7 KB로 예산을 넘는다), `react-router` 7.18.1 GHSA-qwww-vcr4-c8h2(약 +470 B). 둘 다 owner와 다른 reviewer의 `config/security/dependency-change-evidence.json` 항목이 필요하다. moderate 2건(`minimatch`, `glob`)은 major 범위 밖이다.
|
||||
- 실제 Gitea runner, 실제 HTTPS 호스트, nginx 예시에서는 돌리지 않았다. FE-GATE-019 배포 슬롯은 주입한 fetcher로만 시험했다.
|
||||
- `test:feature-scaffold` 한 번이 513~866초 걸린다(부하에 따라). FE-GATE-020 job 상한은 45분이다. 브라우저 게이트는 scaffold 드릴 밖이다. 짝 저장소 참조(1103/12-05)는 CI와 중첩 worktree에서 `not verified`다.
|
||||
- Service Worker를 켠 제품의 `composeProduct` 쪽 칸(SW blocker·observe)은 없다 (1103/09-05). SW e2e와 실제 live probe는 이 묶음에서 돌리지 않았다.
|
||||
- OPFS: `logicalKey`까지 깨진 행은 staging에 남을 틈이 있고, 같은 lock 대기 상한이 partition 삭제에도 걸린다. `dispose()`는 `scopeParticipants`를 부르지 않는다. 실제 로그아웃 E2E는 없다.
|
||||
- 라우트 계약의 `title`·`navigationLabel`은 화면이 읽지 않는다(catalog가 읽는다) (1103/16-06). 키보드 저장 실패 포커스는 스크린리더로 확인하지 않았다 (1103/08-02).
|
||||
|
||||
## 0.2.0 — 태그 `v0.2.0` (2026-09-27)
|
||||
|
||||
@@ -21,61 +286,61 @@
|
||||
|
||||
| 표시 | 변경 | 영향 경로 | 커밋 |
|
||||
|---|---|---|---|
|
||||
| [계약] | 모든 V3 HTTP 요청이 논리 실행마다 `x-correlation-id` 헤더를 하나 보낸다. 다른 origin API는 preflight `Access-Control-Allow-Headers`에 이 헤더를 넣어야 요청이 나간다. 응답의 같은 헤더를 읽으려면 `Access-Control-Expose-Headers`에도 넣는다 (03-03) | `src/adapters/http/http-execution-v3.ts`, `src/adapters/http/feature-http-binding.ts`, `src/bootstrap/runtime-adapters.ts`, `docs/operations/api-contract-and-server-state-recovery.md` | `c5da3cf`, `f0a6495` |
|
||||
| [계약] | 결과를 모르는 쓰기(응답 유실)를 다시 보낼 때 처음의 멱등 키를 그대로 쓴다. 백엔드는 같은 키의 재전송을 한 번만 적용해야 한다 (03-01, 08-03) | `src/presentation/adapters/query/application-query.ts`, `src/presentation/forms/use-app-form.ts`, `src/presentation/components/async-surface.tsx` | `dfb1b9e` |
|
||||
| [계약] | 명령의 401/403/429를 기능 패키지가 분류할 수 있다(`classifyStatus`, 선택 필드). 재로그인이 먼저다 (03-02) | `src/adapters/http/http-effect-certainty.ts`, `src/adapters/http/http-execution-v3.ts`, `src/contracts/errors.ts`, `src/contracts/external-contract-runtime.ts` | `2afee67` |
|
||||
| [계약] | 422 problem body의 필드 오류(`path`, `code`)를 폼까지 전달한다 (03-04) | `src/adapters/http/feature-http-binding.ts`, `src/features/reference-feature/contracts/reference-schemas.ts` | `479acd5` |
|
||||
| [계약] | 텔레메트리 수집기 이벤트마다 `build_id`, `release_id`가 붙는다. 한 번에 보내는 본문은 60KiB 아래로 나뉜다 (13-11, 03-05) | `src/adapters/telemetry/telemetry-collector.ts`, `src/bootstrap/runtime-adapters.ts` | `43e47f4`, `e14c613` |
|
||||
| [보안] | 번들이 읽지 않는 `VITE_*` 값까지 통째로 넣던 문제를 고쳤다. 값은 키로만 읽고, `ENV_REGISTRY`에 없는 `VITE_*` 이름은 빌드를 멈춘다 (13-06) | `src/contracts/env.ts`, `vite.config.ts`, `eslint.config.ts` | `2ec59ad` |
|
||||
| [보안] | 로그아웃·계정 삭제 purge가 손상된 IndexedDB 때문에 열리지 않으면 그 파티션의 DB를 지운다. OPFS purge는 남은 chunk를 바로 지운다 (05-03, 05-04) | `src/adapters/platform/indexeddb-connection.ts`, `src/adapters/storage/indexeddb/indexeddb-runtime.ts`, `src/adapters/storage/opfs/opfs-byte-store-adapter.ts`, `src/application/ports/browser-file-storage/` | `3e37fbf`, `6ab564f` |
|
||||
| [계약] | `RELEASE_TARGET`이 `APP_PROFILE`과 다르면 배포 승인이 거절된다 (12-02, 13-01) | `scripts/check-release-admission.ts`, `.gitea/workflows/quality-gates.yml` | `239b22a` |
|
||||
| [계약] | 설정·매니페스트 URL이 `VITE_ROUTER_BASE_PATH`를 따른다. base 밖의 설정 URL은 빌드를 멈춘다 (13-07) | `scripts/generate-runtime-config.ts`, `src/contracts/env.ts`, `vite.config.ts` | `e215c84` |
|
||||
| [계약] | `VITE_PRODUCT_FEATURES`는 생성기에서 적용되고, 모르는 기능 ID는 빌드를 멈춘다 (09-02) | `scripts/generate-product-feature-index.ts`, `src/contracts/product-features.ts` | `a8111f7` |
|
||||
| [계약] | `src/features/<id>/`에 `feature-module.ts`도 `NOT_INSTALLED` 표식도 없으면 생성기가 실패한다. 기능 제거 검사는 `--feature=<id>`를 받는다 (09-07, 14-03) | `scripts/generate-product-feature-index.ts`, `scripts/test-sample-removal.ts`, `config/contracts/registry-governance.json`, `docs/architecture/starter-experience.md` | `ad0e83c` |
|
||||
| [계약] | 기능 루트·context·app 파일은 `src/adapters`를 import할 수 없다. presentation은 app·context를 import할 수 없다(`app-router.tsx` 예외) (12-03) | `scripts/check-architecture.ts`, `.dependency-cruiser.json`, `docs/architecture/layers.md` | `f8b6a36` |
|
||||
| [계약] | CI 계약의 게이트 수·해시가 `config/ci/contract-baseline.json`으로 옮겨졌다. 게이트를 바꾸면 `update:ci-contract-baseline`로 갱신한다 (14-02) | `config/ci/contract-baseline.json`, `scripts/check-ci-contract.ts` | `0114b1e` |
|
||||
| [계약] | 모든 테스트 파일은 어떤 게이트가 돌리거나 `config/ci/ungated-tests.json`에 이유가 있어야 한다 (12-04, 09-11, 11-03) | `config/ci/gates.json`, `config/ci/ungated-tests.json`, `scripts/lib/ungated-tests.ts` | `840de45`, `45ee231` |
|
||||
| [계약] | 게이트 판정 변경: 서명된 수동 접근성 검토는 release 게이트 FE-GATE-028로, runbook drill은 관측하지 못한 단계를 `UNVERIFIED`(exit 3)로, FE-GATE-016은 폐지, FE-GATE-019는 배포 뒤 production 단계에서 돈다 (08-06, 11-01, 13-03, 13-05) | `config/ci/gates.json`, `.gitea/workflows/quality-gates.yml`, `scripts/drill-runbook.ts`, `docs/operations/ci-quality-gates.md` | `7298275`, `7f889a6`, `a263d8c` |
|
||||
| [계약] | `engineStrict`, `saveExact`를 `pnpm-workspace.yaml`로 옮겼다. 지원하지 않는 Node에서 설치가 실패한다 (13-09) | `pnpm-workspace.yaml`, `.npmrc` | `a5dc851` |
|
||||
| [계약] | 폼 저장 실패에 재로그인·권한 없음·나중에 재시도 상태가 따로 생겼다 (08-01) | `src/presentation/forms/form-contracts.ts`, `src/presentation/forms/use-app-form.ts`, `src/presentation/forms/form-components.tsx` | `9894a70` |
|
||||
| [계약] | browser-transfer 포트: `upload()` 실패의 recovery 값이 다섯 개로 정리됐고, 완료된 업로드는 `resourceId`를 잃지 않는다. 시간 제한이 바이트 수에 비례한다 (01-01~01-11). file-transfer recipe를 쓰는 프로젝트만 해당 | `src/application/ports/browser-transfer/`, `src/adapters/browser-transfer/` | `648fe4e`, `7b2cefb`, `5a6665a`, `426b6b8` 외 |
|
||||
| [계약] | IndexedDB·OPFS 포트: 미래 스키마는 `INCOMPATIBLE`, 빈 receipt는 없음으로 본다 (05-01~05-14). offline-indexeddb recipe를 쓰는 프로젝트만 해당 | `src/application/ports/browser-file-storage/`, `src/adapters/storage/` | `7f45afa`, `47cf040`, `8fc816e` 외 |
|
||||
| [계약] | 모든 V3 HTTP 요청이 논리 실행마다 `x-correlation-id` 헤더를 하나 보낸다. 다른 origin API는 preflight `Access-Control-Allow-Headers`에 이 헤더를 넣어야 요청이 나간다. 응답의 같은 헤더를 읽으려면 `Access-Control-Expose-Headers`에도 넣는다 (0925/03-03) | `src/adapters/http/http-execution-v3.ts`, `src/adapters/http/feature-http-binding.ts`, `src/bootstrap/runtime-adapters.ts`, `docs/operations/api-contract-and-server-state-recovery.md` | `c5da3cf`, `f0a6495` |
|
||||
| [계약] | 결과를 모르는 쓰기(응답 유실)를 다시 보낼 때 처음의 멱등 키를 그대로 쓴다. 백엔드는 같은 키의 재전송을 한 번만 적용해야 한다 (0925/03-01, 0925/08-03) | `src/presentation/adapters/query/application-query.ts`, `src/presentation/forms/use-app-form.ts`, `src/presentation/components/async-surface.tsx` | `dfb1b9e` |
|
||||
| [계약] | 명령의 401/403/429를 기능 패키지가 분류할 수 있다(`classifyStatus`, 선택 필드). 재로그인이 먼저다 (0925/03-02) | `src/adapters/http/http-effect-certainty.ts`, `src/adapters/http/http-execution-v3.ts`, `src/contracts/errors.ts`, `src/contracts/external-contract-runtime.ts` | `2afee67` |
|
||||
| [계약] | 422 problem body의 필드 오류(`path`, `code`)를 폼까지 전달한다 (0925/03-04) | `src/adapters/http/feature-http-binding.ts`, `src/features/reference-feature/contracts/reference-schemas.ts` | `479acd5` |
|
||||
| [계약] | 텔레메트리 수집기 이벤트마다 `build_id`, `release_id`가 붙는다. 한 번에 보내는 본문은 60KiB 아래로 나뉜다 (0925/13-11, 0925/03-05) | `src/adapters/telemetry/telemetry-collector.ts`, `src/bootstrap/runtime-adapters.ts` | `43e47f4`, `e14c613` |
|
||||
| [보안] | 번들이 읽지 않는 `VITE_*` 값까지 통째로 넣던 문제를 고쳤다. 값은 키로만 읽고, `ENV_REGISTRY`에 없는 `VITE_*` 이름은 빌드를 멈춘다 (0925/13-06) | `src/contracts/env.ts`, `vite.config.ts`, `eslint.config.ts` | `2ec59ad` |
|
||||
| [보안] | 로그아웃·계정 삭제 purge가 손상된 IndexedDB 때문에 열리지 않으면 그 파티션의 DB를 지운다. OPFS purge는 남은 chunk를 바로 지운다 (0925/05-03, 0925/05-04) | `src/adapters/platform/indexeddb-connection.ts`, `src/adapters/storage/indexeddb/indexeddb-runtime.ts`, `src/adapters/storage/opfs/opfs-byte-store-adapter.ts`, `src/application/ports/browser-file-storage/` | `3e37fbf`, `6ab564f` |
|
||||
| [계약] | `RELEASE_TARGET`이 `APP_PROFILE`과 다르면 배포 승인이 거절된다 (0925/12-02, 0925/13-01) | `scripts/check-release-admission.ts`, `.gitea/workflows/quality-gates.yml` | `239b22a` |
|
||||
| [계약] | 설정·매니페스트 URL이 `VITE_ROUTER_BASE_PATH`를 따른다. base 밖의 설정 URL은 빌드를 멈춘다 (0925/13-07) | `scripts/generate-runtime-config.ts`, `src/contracts/env.ts`, `vite.config.ts` | `e215c84` |
|
||||
| [계약] | `VITE_PRODUCT_FEATURES`는 생성기에서 적용되고, 모르는 기능 ID는 빌드를 멈춘다 (0925/09-02) | `scripts/generate-product-feature-index.ts`, `src/contracts/product-features.ts` | `a8111f7` |
|
||||
| [계약] | `src/features/<id>/`에 `feature-module.ts`도 `NOT_INSTALLED` 표식도 없으면 생성기가 실패한다. 기능 제거 검사는 `--feature=<id>`를 받는다 (0925/09-07, 0925/14-03) | `scripts/generate-product-feature-index.ts`, `scripts/test-sample-removal.ts`, `config/contracts/registry-governance.json`, `docs/architecture/starter-experience.md` | `ad0e83c` |
|
||||
| [계약] | 기능 루트·context·app 파일은 `src/adapters`를 import할 수 없다. presentation은 app·context를 import할 수 없다(`app-router.tsx` 예외) (0925/12-03) | `scripts/check-architecture.ts`, `.dependency-cruiser.json`, `docs/architecture/layers.md` | `f8b6a36` |
|
||||
| [계약] | CI 계약의 게이트 수·해시가 `config/ci/contract-baseline.json`으로 옮겨졌다. 게이트를 바꾸면 `update:ci-contract-baseline`로 갱신한다 (0925/14-02) | `config/ci/contract-baseline.json`, `scripts/check-ci-contract.ts` | `0114b1e` |
|
||||
| [계약] | 모든 테스트 파일은 어떤 게이트가 돌리거나 `config/ci/ungated-tests.json`에 이유가 있어야 한다 (0925/12-04, 0925/09-11, 0925/11-03) | `config/ci/gates.json`, `config/ci/ungated-tests.json`, `scripts/lib/ungated-tests.ts` | `840de45`, `45ee231` |
|
||||
| [계약] | 게이트 판정 변경: 서명된 수동 접근성 검토는 release 게이트 FE-GATE-028로, runbook drill은 관측하지 못한 단계를 `UNVERIFIED`(exit 3)로, FE-GATE-016은 폐지, FE-GATE-019는 배포 뒤 production 단계에서 돈다 (0925/08-06, 0925/11-01, 0925/13-03, 0925/13-05) | `config/ci/gates.json`, `.gitea/workflows/quality-gates.yml`, `scripts/drill-runbook.ts`, `docs/operations/ci-quality-gates.md` | `7298275`, `7f889a6`, `a263d8c` |
|
||||
| [계약] | `engineStrict`, `saveExact`를 `pnpm-workspace.yaml`로 옮겼다. 지원하지 않는 Node에서 설치가 실패한다 (0925/13-09) | `pnpm-workspace.yaml`, `.npmrc` | `a5dc851` |
|
||||
| [계약] | 폼 저장 실패에 재로그인·권한 없음·나중에 재시도 상태가 따로 생겼다 (0925/08-01) | `src/presentation/forms/form-contracts.ts`, `src/presentation/forms/use-app-form.ts`, `src/presentation/forms/form-components.tsx` | `9894a70` |
|
||||
| [계약] | browser-transfer 포트: `upload()` 실패의 recovery 값이 다섯 개로 정리됐고, 완료된 업로드는 `resourceId`를 잃지 않는다. 시간 제한이 바이트 수에 비례한다 (0925/01-01~01-11). file-transfer recipe를 쓰는 프로젝트만 해당 | `src/application/ports/browser-transfer/`, `src/adapters/browser-transfer/` | `648fe4e`, `7b2cefb`, `5a6665a`, `426b6b8` 외 |
|
||||
| [계약] | IndexedDB·OPFS 포트: 미래 스키마는 `INCOMPATIBLE`, 빈 receipt는 없음으로 본다 (0925/05-01~05-14). offline-indexeddb recipe를 쓰는 프로젝트만 해당 | `src/application/ports/browser-file-storage/`, `src/adapters/storage/` | `7f45afa`, `47cf040`, `8fc816e` 외 |
|
||||
| [계약] | 외부 세션 owner의 `readSubject()`와 `SessionGateway.getSubject()`가 필수가 됐다. `readSubject`가 없는 owner는 `integration-failed`로 닫힌다. 토큰 갱신마다 서버 상태 캐시가 비워지던 문제를 막는다 | `src/adapters/auth/external-session-adapter.ts`, `src/application/ports/`, `docs/architecture/starter-experience.md` | `c6300e9` |
|
||||
| [보안] | 운영 CSP(`unsafe-eval` 없음) 아래에서 zod가 eval을 시험하지 않는다. `src/`의 코드는 zod를 `src/contracts/zod.ts`로만 가져온다(dependency-cruiser 규칙) (13-08, F-7) | `src/contracts/zod.ts`, `.dependency-cruiser.json`, `tests/e2e/production-csp.spec.ts` | `9dc95ca` |
|
||||
| [계약] | 레지스트리 호환성 분류기가 모르는 스키마 변경을 breaking으로 본다. 런타임 설정 스키마도 기준선과 비교한다(FE-GATE-014) (07-02, 13-10) | `src/contracts/compatibility.ts`, `scripts/check-registries.ts`, `config/contracts/` | `17d617a` |
|
||||
| [계약] | 오류 레지스트리에서 읽지 않는 필드를 뺐다. 호환 별칭과 V1 reader에 `@deprecated`와 제거 조건을 붙였다 (07-04, 07-07) | `src/contracts/errors.ts`, `src/contracts/` | `aff5f43`, `9e616d3` |
|
||||
| [계약] | staging·production 빌드는 `VITE_BUILD_ID`가 없으면 실패한다 (13-15, F-6) | `scripts/generate-runtime-config.ts`, `src/contracts/env.ts` | `063375e` |
|
||||
| [계약] | Service Worker 빌드가 `public/config.json` 대신 프로필에서 만든 `dist/config.json`을 읽고, `APP_ENV`가 `APP_PROFILE`과 다르면 빌드를 멈춘다 (06-10, F-8) | `vite.service-worker.config.ts`, `scripts/lib/service-worker-build-input.ts` | `cefb0b2` |
|
||||
| [계약] | Web Push: 탭 사이 구독 제어를 Web Lock으로 직렬화하고, 새 세션이 다른 계정의 push fence를 넘겨받는다. `REMOVE_REGISTRATION`은 스스로 등록을 해지하는 worker를 배포한다 (06-02, 06-06, 06-03) | `src/adapters/web-push/`, `scripts/lib/self-unregistering-service-worker.ts`, `docs/runbooks/` | `e6c683e`, `996a959`, `9f2305a` |
|
||||
| [계약] | realtime: 세션이 끝날 때마다 재시도 예산을 초기화하고 offline 동안 멈춘다. SSE `Retry-After`를 따른다. 등록되지 않은 이벤트 종류는 registry mismatch로 끝난다 (04-01~04-08). realtime recipe를 쓰는 프로젝트만 해당. 레시피 번들 예산은 40,900 bytes로 올렸다 | `src/adapters/realtime/`, `config/recipes/frontend-capability-recipes.json` | `bcad7b0`, `02d3fdf`, `7e37660`, `2c5e268` 외 |
|
||||
| [계약] | browser-files 포트: 같은 턴의 abort는 `ABORTED`, 닫은 선택 창은 `DISMISSED`, 소진된 object URL lease는 재시도 가능으로 보고한다. Cache Storage는 후보 항목을 검증한 뒤에만 verified로 보고한다 (02-01~02-09). browser-files recipe를 쓰는 프로젝트만 해당 | `src/adapters/browser-file-storage/`, `src/adapters/cache-storage/` | `c9be8d6`, `d76653b`, `0b41cb3`, `55c0bf5` 외 |
|
||||
| [계약] | 샘플 상세 경로가 `/examples/reference-resources/items/:resourceId`로 옮겨졌다. ID가 `new`·`status`인 항목도 상세가 열린다 (08-13) | `src/features/reference-feature/contracts/reference-feature-contract.ts`, `config/contracts/registry-change-evidence.json` | `d7b81c6` |
|
||||
| [계약] | `tsconfig.base.json`에 `noUnusedLocals`를 켰다. 복사한 프로젝트의 쓰지 않는 import·변수가 `check:types`에서 실패한다 (12-12) | `tsconfig.base.json` | `49413af` |
|
||||
| [보안] | 운영 CSP(`unsafe-eval` 없음) 아래에서 zod가 eval을 시험하지 않는다. `src/`의 코드는 zod를 `src/contracts/zod.ts`로만 가져온다(dependency-cruiser 규칙) (0925/13-08, 0925/F-7) | `src/contracts/zod.ts`, `.dependency-cruiser.json`, `tests/e2e/production-csp.spec.ts` | `9dc95ca` |
|
||||
| [계약] | 설정 스키마 호환성 분류기(`classifyObjectSchemaChange`)가 모르는 스키마 변경을 breaking으로 본다. 런타임 설정 스키마도 기준선과 비교한다(FE-GATE-014, `verify:compatibility`). 레지스트리 분류기(`scripts/lib/registry-compatibility.ts`)와는 다른 것이다 (0925/07-02, 0925/13-10) | `src/contracts/compatibility.ts`, `scripts/check-compatibility.ts`, `config/compatibility/` | `17d617a` |
|
||||
| [계약] | 오류 레지스트리에서 읽지 않는 필드를 뺐다. 호환 별칭과 V1 reader에 `@deprecated`와 제거 조건을 붙였다 (0925/07-04, 0925/07-07) | `src/contracts/errors.ts`, `src/contracts/` | `aff5f43`, `9e616d3` |
|
||||
| [계약] | staging·production 빌드는 `VITE_BUILD_ID`가 없으면 실패한다 (0925/13-15, 0925/F-6) | `scripts/generate-runtime-config.ts`, `src/contracts/env.ts` | `063375e` |
|
||||
| [계약] | Service Worker 빌드가 `public/config.json` 대신 프로필에서 만든 `dist/config.json`을 읽고, `APP_ENV`가 `APP_PROFILE`과 다르면 빌드를 멈춘다 (0925/06-10, 0925/F-8) | `vite.service-worker.config.ts`, `scripts/lib/service-worker-build-input.ts` | `cefb0b2` |
|
||||
| [계약] | Web Push: 탭 사이 구독 제어를 Web Lock으로 직렬화하고, 새 세션이 다른 계정의 push fence를 넘겨받는다. `REMOVE_REGISTRATION`은 스스로 등록을 해지하는 worker를 배포한다 (0925/06-02, 0925/06-06, 0925/06-03) | `src/adapters/web-push/`, `scripts/lib/self-unregistering-service-worker.ts`, `docs/runbooks/` | `e6c683e`, `996a959`, `9f2305a` |
|
||||
| [계약] | realtime: 세션이 끝날 때마다 재시도 예산을 초기화하고 offline 동안 멈춘다. SSE `Retry-After`를 따른다. 등록되지 않은 이벤트 종류는 registry mismatch로 끝난다 (0925/04-01~04-08). realtime recipe를 쓰는 프로젝트만 해당. 레시피 번들 예산은 40,900 bytes로 올렸다 | `src/adapters/realtime/`, `config/recipes/frontend-capability-recipes.json` | `bcad7b0`, `02d3fdf`, `7e37660`, `2c5e268` 외 |
|
||||
| [계약] | browser-files 포트: 같은 턴의 abort는 `ABORTED`, 닫은 선택 창은 `DISMISSED`, 소진된 object URL lease는 재시도 가능으로 보고한다. Cache Storage는 후보 항목을 검증한 뒤에만 verified로 보고한다 (0925/02-01~02-09). browser-files recipe를 쓰는 프로젝트만 해당 | `src/adapters/browser-file-storage/`, `src/adapters/cache-storage/` | `c9be8d6`, `d76653b`, `0b41cb3`, `55c0bf5` 외 |
|
||||
| [계약] | 샘플 상세 경로가 `/examples/reference-resources/items/:resourceId`로 옮겨졌다. ID가 `new`·`status`인 항목도 상세가 열린다 (0925/08-13) | `src/features/reference-feature/contracts/reference-feature-contract.ts`, `config/contracts/registry-change-evidence.json` | `d7b81c6` |
|
||||
| [계약] | `tsconfig.base.json`에 `noUnusedLocals`를 켰다. 복사한 프로젝트의 쓰지 않는 import·변수가 `check:types`에서 실패한다 (0925/12-12) | `tsconfig.base.json` | `49413af` |
|
||||
|
||||
### 그 밖의 수정
|
||||
|
||||
- 부트: 앱 모듈 평가 실패, 분류되지 않은 오류, 재시도 가능한 실패에 오류 화면을 보여 준다 (09-03, 09-04, 09-10). `src/bootstrap/`, `src/presentation/boundaries/boot-error-shell.tsx`
|
||||
- 부트: `FEATURE_OVERRIDES`의 모르는 키를 진단으로 남긴다 (09-09). `src/bootstrap/runtime-adapters.ts`, `scripts/check-release-admission.ts`
|
||||
- 빌드: `dist` 파일을 다른 사용자도 읽을 수 있게 한다 (13-02). `scripts/lib/dist-permissions.ts`
|
||||
- 공급망: 번들에 들어간 패키지 목록과 각 증거의 범위를 남긴다. 승격된 릴리스를 나중에 다시 검증한다 (13-12, 13-04). `scripts/lib/vite-module-inventory.ts`, `scripts/verify-exact-promotion-bundle.ts`
|
||||
- 아키텍처 검사: dependency-cruiser 실행을 멈추고 import graph 하나로 검사한다. 경계 예외를 좁히고, 위반 메시지에 이유와 갈 곳을 적는다 (12-05~12-11). `scripts/check-architecture.ts`
|
||||
- 기능 조립: `needs` 검사, 기능 두 개 설치 시 타입 유지, local-draft 샘플 정리 (09-01, 09-05, 09-06, 09-08, 09-12, 00-02). `src/features/`, `src/bootstrap/runtime-adapters.ts`
|
||||
- 테스트 보강: production CSP 아래 빌드 smoke, 멱등 키 재사용, IndexedDB fake, KEYED 재시도 (13-08, 01-04, 05-08, 10-03)
|
||||
- 샘플 제거: `test:sample-removal`이 다시 통과한다. 플랫폼 테스트가 샘플 대신 테스트 전용 기능을 쓴다 (14-01, 14-08, 00-01, 10-01). `scripts/test-sample-removal.ts`, `scripts/lib/removal-fixture.ts`
|
||||
- 문서: README에 런타임 프로필·배포 변수·우선순위를 적고 `verify:documentation`이 변수 목록을 검사한다 (13-15). 성능 예산, 공급망, 운영 runbook 문서를 코드에 맞췄다 (13-13, 13-14, 03-06, 03-08).
|
||||
- 부트: 앱 모듈 평가 실패, 분류되지 않은 오류, 재시도 가능한 실패에 오류 화면을 보여 준다 (0925/09-03, 0925/09-04, 0925/09-10). `src/bootstrap/`, `src/presentation/boundaries/boot-error-shell.tsx`
|
||||
- 부트: `FEATURE_OVERRIDES`의 모르는 키를 진단으로 남긴다 (0925/09-09). `src/bootstrap/runtime-adapters.ts`, `scripts/check-release-admission.ts`
|
||||
- 빌드: `dist` 파일을 다른 사용자도 읽을 수 있게 한다 (0925/13-02). `scripts/lib/dist-permissions.ts`
|
||||
- 공급망: 번들에 들어간 패키지 목록과 각 증거의 범위를 남긴다. 승격된 릴리스를 나중에 다시 검증한다 (0925/13-12, 0925/13-04). `scripts/lib/vite-module-inventory.ts`, `scripts/verify-exact-promotion-bundle.ts`
|
||||
- 아키텍처 검사: dependency-cruiser 실행을 멈추고 import graph 하나로 검사한다. 경계 예외를 좁히고, 위반 메시지에 이유와 갈 곳을 적는다 (0925/12-05~12-11). `scripts/check-architecture.ts`
|
||||
- 기능 조립: `needs` 검사, 기능 두 개 설치 시 타입 유지, local-draft 샘플 정리 (0925/09-01, 0925/09-05, 0925/09-06, 0925/09-08, 0925/09-12, 0925/00-02). `src/features/`, `src/bootstrap/runtime-adapters.ts`
|
||||
- 테스트 보강: production CSP 아래 빌드 smoke, 멱등 키 재사용, IndexedDB fake, KEYED 재시도 (0925/13-08, 0925/01-04, 0925/05-08, 0925/10-03)
|
||||
- 샘플 제거: `test:sample-removal`이 다시 통과한다. 플랫폼 테스트가 샘플 대신 테스트 전용 기능을 쓴다 (0925/14-01, 0925/14-08, 0925/00-01, 0925/10-01). `scripts/test-sample-removal.ts`, `scripts/lib/removal-fixture.ts`
|
||||
- 문서: README에 런타임 프로필·배포 변수·우선순위를 적고 `verify:documentation`이 변수 목록을 검사한다 (0925/13-15). 성능 예산, 공급망, 운영 runbook 문서를 코드에 맞췄다 (0925/13-13, 0925/13-14, 0925/03-06, 0925/03-08).
|
||||
|
||||
- 화면: 오류 종류마다 문구가 있고, 실패 화면에 지원 참조와 다음 행동이 나온다. 언어를 바꾸면 폼 오류도 다시 번역된다. 조회 실패의 인증·권한·없음 화면이 갤러리와 같은 컴포넌트다. 수정키 클릭은 브라우저에 맡긴다. 스크롤·해시 이동을 복원한다 (07-01, 08-02, 08-04, 08-07~08-12, F-10). `src/presentation/`, `src/presentation/i18n/`
|
||||
- 접근성·visual 검사가 로그인 뒤 실제 화면을 상태별로 검사한다 (08-05, 11-02). `tests/e2e/accessibility.spec.ts`
|
||||
- 계약 테스트: V2/V3 일치, 두 번째 기능의 레지스트리 통과, validator 결과 검사 (07-03, 07-05, 07-06, 09-07, F-3). `tests/unit/`, `src/contracts/`
|
||||
- Service Worker: 알림 클릭, kill switch, drain 시간 초과, 이전 릴리스 fallback, 거절 클릭 경로, 시작 실패 텔레메트리 (06-01, 06-04, 06-05, 06-07~06-09). `src/adapters/web-push/`, `src/adapters/service-worker/`, `src/bootstrap/`
|
||||
- 테스트 체계: 부하에 강한 대기, 커버리지 정책, 파일 하나 실행, 실제 타이머 복원, 포커스 테스트 금지, reference 데이터 E2E, 실제 모양 기능 규모 측정, SW 없는 구 탭 청크 복구, 성능 측정 중앙값, 모듈 평가 실패 부트 화면 (10-02, 10-04~10-07, 11-04~11-08, F-2). `tests/`, `scripts/scale/`, `scripts/lib/lab-performance.ts`
|
||||
- 테스트 fixture가 공유 `node_modules`를 다시 쓰지 않고, 임시 폴더를 지운다 (F-4, F-12, 00-03). `scripts/lib/removal-fixture.ts`, `tests/unit/`
|
||||
- 문서: 손으로 적은 게이트 수와 LOC를 지우고 `verify:documentation`의 검사 범위를 적었다 (14-07)
|
||||
- 화면: 오류 종류마다 문구가 있고, 실패 화면에 지원 참조와 다음 행동이 나온다. 언어를 바꾸면 폼 오류도 다시 번역된다. 조회 실패의 인증·권한·없음 화면이 갤러리와 같은 컴포넌트다. 수정키 클릭은 브라우저에 맡긴다. 스크롤·해시 이동을 복원한다 (0925/07-01, 0925/08-02, 0925/08-04, 0925/08-07~08-12, 0925/F-10). `src/presentation/`, `src/presentation/i18n/`
|
||||
- 접근성·visual 검사가 로그인 뒤 실제 화면을 상태별로 검사한다 (0925/08-05, 0925/11-02). `tests/e2e/accessibility.spec.ts`
|
||||
- 계약 테스트: V2/V3 일치, 두 번째 기능의 레지스트리 통과, validator 결과 검사 (0925/07-03, 0925/07-05, 0925/07-06, 0925/09-07, 0925/F-3). `tests/unit/`, `src/contracts/`
|
||||
- Service Worker: 알림 클릭, kill switch, drain 시간 초과, 이전 릴리스 fallback, 거절 클릭 경로, 시작 실패 텔레메트리 (0925/06-01, 0925/06-04, 0925/06-05, 0925/06-07~06-09). `src/adapters/web-push/`, `src/adapters/service-worker/`, `src/bootstrap/`
|
||||
- 테스트 체계: 부하에 강한 대기, 커버리지 정책, 파일 하나 실행, 실제 타이머 복원, 포커스 테스트 금지, reference 데이터 E2E, 실제 모양 기능 규모 측정, SW 없는 구 탭 청크 복구, 성능 측정 중앙값, 모듈 평가 실패 부트 화면 (0925/10-02, 0925/10-04~10-07, 0925/11-04~11-08, 0925/F-2). `tests/`, `scripts/scale/`, `scripts/lib/lab-performance.ts`
|
||||
- 테스트 fixture가 공유 `node_modules`를 다시 쓰지 않고, 임시 폴더를 지운다 (0925/F-4, 0925/F-12, 0925/00-03). `scripts/lib/removal-fixture.ts`, `tests/unit/`
|
||||
- 문서: 손으로 적은 게이트 수와 LOC를 지우고 `verify:documentation`의 검사 범위를 적었다 (0925/14-07)
|
||||
|
||||
### 알려진 제한
|
||||
|
||||
- Playwright spec은 chromium·firefox·webkit에서 확인했다. WebKit에서만 난 실패 1건(구 탭 청크 복구 spec의 콘솔 문구 허용 목록)은 `b1a36ab`로 고쳤다.
|
||||
- 사용자 몫(SPEC "범위 밖" U-1~U-5, F-11)은 이 버전에 들어 있지 않다.
|
||||
- 사용자 몫(SPEC "범위 밖" U-1~U-5, 0925/F-11)은 이 버전에 들어 있지 않다.
|
||||
|
||||
## 0.1.0 — `main` `4626b73` (2026-09-24)
|
||||
|
||||
|
||||
+56
@@ -0,0 +1,56 @@
|
||||
# Product
|
||||
|
||||
<!-- impeccable:product-schema 1 -->
|
||||
|
||||
## Platform
|
||||
|
||||
web
|
||||
|
||||
## Users
|
||||
|
||||
- **템플릿을 가져다 쓰는 개발자**: 이 템플릿으로 새 서비스를 빠르게 시작하는 사람입니다. 예제 화면(홈, 플랫폼 구성, UI 구성요소, 화면 상태, 인증 연동, Reference feature)은 이 사람이 실행 구조와 공통 동작을 확인하는 용도입니다.
|
||||
- **파생 서비스의 최종 사용자**: 디자인 시스템(토큰, 프리미티브, 패턴, 레이아웃, 페이지 템플릿)은 이 템플릿으로 만든 서비스를 실제로 쓰는 사람을 기준으로 합니다.
|
||||
|
||||
## Product Purpose
|
||||
|
||||
도메인·비즈니스·DB 로직을 뺀 공통 기능을 모두 갖춘 React/Vite 프론트엔드 출발점입니다. 아키텍처 경계, 연동 동작, 릴리스 정합성, 접근성, 성능, 운영을 관례가 아니라 실행되는 계약으로 둡니다. 성공 기준은 이 템플릿에서 도메인만 추가해 서비스를 빠르게 만들고, 운영 중인 desktop 서버에 바로 띄워 출시할 수 있는 것입니다.
|
||||
|
||||
## Positioning
|
||||
|
||||
화면 품질 규칙(접근성, 상태 표현, 반응형, 토큰 사용)이 문서가 아니라 게이트로 강제됩니다. 시각 회귀 골든, 아키텍처 검사, 접근성 테스트가 그 게이트입니다. 그래서 파생 서비스가 템플릿을 고쳐도 기준이 조용히 낮아지지 않습니다.
|
||||
|
||||
## Operating Context
|
||||
|
||||
- 실행 형태는 브라우저 SPA + 정적 호스팅 + Service Worker입니다. SSR은 없습니다.
|
||||
- 파생 서비스는 운영 중인 desktop 서버에 배포됩니다.
|
||||
- 예제 앱 셸에는 테마 전환(시스템/라이트/다크), 언어 전환(한국어/영어), 로그인 상태 표시가 있습니다.
|
||||
|
||||
## Capabilities and Constraints
|
||||
|
||||
- 하나의 디자인 시스템으로 세 종류의 서비스를 받칩니다. 업무용·관리 도구(대시보드, 어드민, 설정), 일반 사용자용 웹 서비스, 소개·랜딩 페이지입니다.
|
||||
- 디자인 시스템 위치는 `src/presentation/design-system/`입니다. 토큰은 primitive → semantic → component 세 단계로 파생됩니다(`tokens/primitive.css`, `semantic.css`, `component.css`).
|
||||
- 시각 회귀 골든이 `tests/visual/__snapshots__/`에 있습니다. 화면을 바꾸면 골든도 의도적으로 갱신해야 합니다.
|
||||
- 참조 기능(`src/features/reference-feature/`)은 `test:sample-removal`로 지울 수 있습니다. 예제 라우트 4개(`/examples/platform`, `ui`, `states`, `auth`)와 홈은 기본 구성이고 제거 드릴이 없습니다. 그래서 예제 화면에만 넣은 디자인은 파생 서비스에 그대로 남습니다.
|
||||
- 어떤 서비스가 먼저 만들어질지, 서비스별 우선순위는 아직 정하지 않았습니다.
|
||||
|
||||
## Brand Commitments
|
||||
|
||||
브랜드는 중립으로 유지합니다. 템플릿에는 브랜드 이름·로고·고유 톤을 넣지 않고, 서비스마다 토큰을 바꿔 브랜드를 입힙니다. 현재 표시 이름 "Frontend Skeleton"은 자리표시자입니다.
|
||||
|
||||
## Evidence on Hand
|
||||
|
||||
- 실제 고객, 사용 후기, 로고, 지표, 가격 정보는 없습니다. 지어내지 않습니다.
|
||||
- 예제 문구는 템플릿 기능 설명뿐입니다(`src/presentation/i18n/catalog.ts`).
|
||||
- 현재 화면 기록: `tests/visual/__snapshots__/platform.visual.spec.ts-snapshots/`, Storybook(`src/presentation/design-system/design-system.stories.tsx`).
|
||||
|
||||
## Product Principles
|
||||
|
||||
1. 디자인 시스템은 최종 사용자를 위한 것이고, 예제 화면은 개발자를 위한 것입니다. 둘을 섞지 않습니다.
|
||||
2. 브랜드는 토큰으로만 바꿉니다. 컴포넌트에 브랜드 값을 직접 넣지 않습니다.
|
||||
3. 업무 도구, 일반 서비스, 랜딩을 모두 받쳐야 하므로 밀도와 표현 폭은 토큰과 페이지 템플릿에서 조절합니다. 컴포넌트를 서비스 종류별로 복제하지 않습니다.
|
||||
4. 접근성과 상태 표현(로딩, 빈 상태, 오류, 권한 없음)은 기능이 아니라 기본값입니다.
|
||||
5. 한국어가 기본이고 영어를 함께 지원합니다. 두 언어의 문구 길이 차이를 견디는 레이아웃이어야 합니다.
|
||||
|
||||
## Accessibility & Inclusion
|
||||
|
||||
WCAG 2.2 AA를 기준으로 합니다. 키보드 탐색, 포커스 이동과 복원, 색에만 의존하지 않는 상태 표현, 라이트·다크 테마 모두에서 대비를 지킵니다. 릴리스 후보 하나로 라우트를 사람이 직접 접근성 검토하는 절차가 따로 있습니다(`docs/accessibility/manual-checklist.md`).
|
||||
@@ -41,9 +41,9 @@ Build and deploy variables, lowest precedence first:
|
||||
| Variable | Sets | Default |
|
||||
| --- | --- | --- |
|
||||
| `APP_PROFILE` | which `config/runtime/<profile>.json` is used | `local`; an empty value fails the build |
|
||||
| `RUNTIME_API_BASE_URL` | `API_BASE_URL`, overriding the profile | the profile value |
|
||||
| `RUNTIME_TELEMETRY_ENDPOINT` | `TELEMETRY_ENDPOINT`, overriding the profile | the profile value |
|
||||
| `VITE_BUILD_ID` | `BUILD_ID` in the runtime config and the release manifest | `local-build` |
|
||||
| `RUNTIME_API_BASE_URL` | `API_BASE_URL`, overriding the profile; the CI workflow cannot pass it (see below) | the profile value |
|
||||
| `RUNTIME_TELEMETRY_ENDPOINT` | `TELEMETRY_ENDPOINT`, overriding the profile; the CI workflow cannot pass it (see below) | the profile value |
|
||||
| `VITE_BUILD_ID` | `BUILD_ID` in the runtime config and the release manifest | `local-build` for `local` and `development`; a `staging` or `production` build fails without it |
|
||||
| `RELEASE_ID` | `RELEASE_ID` in the runtime config and the release manifest | `local-release` |
|
||||
| `RELEASE_TARGET` | the environment FE-GATE-027 admits the build to; must equal `APP_PROFILE` | none; admission refuses without it |
|
||||
|
||||
@@ -52,14 +52,23 @@ admission reads (`scripts/verify-documentation-readiness.ts`).
|
||||
|
||||
Only the two `RUNTIME_*` values can differ from the reviewed profile. Anything
|
||||
else changes by editing the profile file. Staging and production reject demo
|
||||
auth and non-HTTPS endpoints.
|
||||
auth, non-HTTPS endpoints and the names reserved for examples and tests
|
||||
(`example.com`, `example.net`, `example.org` and their subdomains, `.example`,
|
||||
`.invalid`, `.test`). The shipped `staging` and `production` profiles use
|
||||
`*.example.com`, so admission refuses them until a project sets its own
|
||||
endpoints.
|
||||
|
||||
A production build and its admission check:
|
||||
In CI the only way to set the endpoints is to commit them to
|
||||
`config/runtime/<profile>.json`. The CI contract binds just `APP_PROFILE` and
|
||||
`RELEASE_TARGET` to the build job (`scripts/contracts/ci-gates.ts`), so a
|
||||
`RUNTIME_*` repository variable never reaches the build.
|
||||
|
||||
A local production build and its admission check:
|
||||
|
||||
```bash
|
||||
APP_PROFILE=production \
|
||||
RUNTIME_API_BASE_URL=https://api.example.com/ \
|
||||
RUNTIME_TELEMETRY_ENDPOINT=https://telemetry.example.com/v1/events \
|
||||
RUNTIME_API_BASE_URL=<your-api-origin>/ \
|
||||
RUNTIME_TELEMETRY_ENDPOINT=<your-telemetry-endpoint> \
|
||||
VITE_BUILD_ID=<unique build id> RELEASE_ID=<unique release id> \
|
||||
corepack pnpm build
|
||||
APP_PROFILE=production RELEASE_TARGET=production corepack pnpm check:release-admission
|
||||
@@ -73,16 +82,14 @@ list is in [`docs/operations/ci-quality-gates.md`](docs/operations/ci-quality-ga
|
||||
## Included starter experience
|
||||
|
||||
The default build mounts a domain-neutral application shell with a header,
|
||||
responsive sidebar, route focus management, session integration status, and a
|
||||
persistent `system` / `light` / `dark` theme selector.
|
||||
responsive sidebar, route focus management, session integration status, a
|
||||
persistent `system` / `light` / `dark` theme selector, and a language selector.
|
||||
|
||||
| Route | Purpose |
|
||||
| --- | --- |
|
||||
| `/` | implementation readiness and starter links |
|
||||
| `/examples/ui` | buttons, fields, cards, alerts, badges, modal, and tokens |
|
||||
| `/examples/states` | loading, refresh, empty, error, auth, forbidden, and not-found states |
|
||||
| `/examples/auth` | reactive external-auth integration seam |
|
||||
| `/examples/reference-resources` | removable, session-required reference feature |
|
||||
The route list is `ROUTE_REGISTRY` (`src/features/installed-feature-contracts.ts`):
|
||||
the platform routes of `src/contracts/routes.ts` plus the routes of every
|
||||
installed feature, the removable reference feature included. The platform
|
||||
overview page (`/examples/platform`) shows the composed list at runtime, so
|
||||
this README keeps no copy of it and adding a feature does not edit it.
|
||||
|
||||
`AUTH_MODE=demo` is credential-free and accepted only in local/development
|
||||
environments. Deployments use `AUTH_MODE=external` and provide the opaque auth
|
||||
@@ -114,7 +121,7 @@ and
|
||||
| `COMPOSED` | capability ledger, design documents | wired into the default production path | Default |
|
||||
| `INSTALLED` | a project's own recipe catalog (step 10 of the recipe procedure) | the project added the recipe | Default, for that project |
|
||||
| `RECIPE_AVAILABLE` | recipe catalog `status` | a recipe exists to copy; nothing is installed | Optional |
|
||||
| `NOT_INSTALLED` | recipe catalog `defaultStatus`; a `src/features/<id>/NOT_INSTALLED` marker file | not part of the build | Optional (recipe) or Experimental (feature) |
|
||||
| `NOT_INSTALLED` | recipe catalog `defaultStatus`; a declared feature the build or `FEATURE_OVERRIDES` left out. A sample directory that is no feature at all carries a `src/features/<dir>/NOT_A_FEATURE` marker file instead | not part of the build | Optional (recipe) or Experimental (feature) |
|
||||
| `AVAILABLE_NOT_COMPOSED` | capability ledger; recipe `referenceRuntime.status` | code and tests exist; the default build leaves it out | Optional |
|
||||
| `DESIGNED_NOT_IMPLEMENTED` | capability ledger, design documents | design approved, runtime missing | Experimental |
|
||||
| `NOT_SELECTED` | capability ledger, design documents | deliberately not chosen | Not supported |
|
||||
@@ -137,20 +144,37 @@ This repository is a **Frontend Application Foundation**: a starter/composition
|
||||
skeleton plus a reusable capability platform. Platform capabilities stay
|
||||
horizontal while product business features use vertical slices.
|
||||
|
||||
Dependencies point inward:
|
||||
`src/` has nine top-level folders. The descriptions match the table in
|
||||
`docs/architecture/layers.md`, which also names every import rule:
|
||||
|
||||
- `src/bootstrap` — the composition root: runtime configuration, concrete adapter construction and the React mount
|
||||
- `src/apps` — deployable apps: each `app-module.ts` declares an app and its context budget; `template-app.ts` is the app this build produces
|
||||
- `src/contexts` — bounded contexts: each `context-module.ts` declares its app, route root and feature budget
|
||||
- `src/features` — removable vertical slices (`src/features/<id>/{domain,application,contracts,adapters,presentation}`) and the installed-feature catalogs (`src/features/*.ts`)
|
||||
- `src/presentation` — generic UI and the inbound adapter: routes, layouts, the design system, pages and providers
|
||||
- `src/adapters` — reusable capability runtimes that implement application ports: HTTP, auth, storage, query cache, telemetry, workers and more
|
||||
- `src/application` — generic use cases, ports, policies and view-models
|
||||
- `src/contracts` — shared vocabulary and registries read by several layers, the workers and the build and release scripts
|
||||
- `src/platform` — product-neutral primitives any folder may use: budgets, execution context, resilience, the telemetry pipeline, error envelopes and release coherence
|
||||
|
||||
Dependencies point inward. Every folder may also import `contracts` and
|
||||
`platform`:
|
||||
|
||||
```text
|
||||
presentation -> application -> domain
|
||||
presentation -> application -> contracts -> platform
|
||||
adapters -----^
|
||||
bootstrap composes concrete adapters
|
||||
apps -> contexts -> features (an app deploys contexts; a context owns features)
|
||||
feature use case -> feature port <- feature-owned capability binding
|
||||
```
|
||||
|
||||
Domain code lives inside each feature; there is no top-level domain folder.
|
||||
|
||||
See
|
||||
`docs/architecture/frontend-application-foundation.md`,
|
||||
`docs/architecture/overview.md`, `docs/architecture/layers.md`, and
|
||||
`docs/architecture/starter-experience.md`. The removable vertical slice is
|
||||
under `src/features/reference-feature`; its domain, application input, HTTP
|
||||
the reference sample, src/features/reference-feature; its domain, application input, HTTP
|
||||
binding, contracts, route runtime, and presentation own their contributions.
|
||||
The central installed catalogs only aggregate selected contributions. The
|
||||
generic starter routes continue to typecheck, test, and build after that
|
||||
@@ -188,6 +212,8 @@ and executable gates pass.
|
||||
|
||||
[`docs/README.md`](docs/README.md) sorts the documents into current contracts,
|
||||
target designs and work history.
|
||||
[`docs/manual/`](docs/manual/README.md) is the step-by-step guide (Korean) for
|
||||
adding a feature, starting from `corepack pnpm create:feature <id>`.
|
||||
|
||||
### Files you can delete after copying
|
||||
|
||||
@@ -198,9 +224,10 @@ reads them, except the one file noted below
|
||||
| Path | Contents |
|
||||
| --- | --- |
|
||||
| `docs/superpowers/` | past plans and specs |
|
||||
| `docs/reviews/` | reviews and the review guide. Keep `docs/reviews/adapters/INVENTORY.md`: `check:adapter-inventory` (FE-GATE-010) reads it |
|
||||
| `docs/reviews/` | reviews and the review guide. Keep `docs/reviews/adapters/`: `check:adapter-inventory` (FE-GATE-010) reads its `INVENTORY.md`, whose rows link to the adapter reviews beside it, and `docs/operations/adapter-remediation-ledger.md` cites those reviews |
|
||||
| `SPEC.md`, `tasks/` | requirements and task list of the 2026-09-25 review fix round |
|
||||
| `CLAUDE.md` | review instructions for the template repository itself; replace it with your own |
|
||||
| `PRODUCT.md` | product context of the template itself (users, purpose, principles) for design tools; replace it with your product's |
|
||||
|
||||
The reference feature is not in this list: deleting its directory alone
|
||||
leaves tests, policy entries and CI scripts behind that fail the gates.
|
||||
@@ -268,20 +295,22 @@ corepack pnpm exec playwright install --with-deps chromium firefox webkit
|
||||
Two gates intentionally need external evidence:
|
||||
|
||||
- `review:a11y-manual` (release gate FE-GATE-028) needs a signed human
|
||||
keyboard/focus/screen-reader review for all ten registered routes: `APP_HOME`, `EXAMPLES_PLATFORM`,
|
||||
`EXAMPLES_UI`, `EXAMPLES_STATES`, `EXAMPLES_AUTH`, `NOT_FOUND`,
|
||||
`REFERENCE_RESOURCE_LIST`, `REFERENCE_RESOURCE_DETAIL`,
|
||||
`REFERENCE_RESOURCE_FORM` and `REFERENCE_RESOURCE_STATUS`.
|
||||
`verify:documentation` derives that list from the route registry and fails if
|
||||
this paragraph falls behind it. The merge gate FE-GATE-009 runs only
|
||||
keyboard/focus/screen-reader review of every registered route, one record
|
||||
per route at `artifacts/tests/a11y-manual/<ROUTE_ID>.md`. The routes are
|
||||
`ROUTE_REGISTRY`; `verify:documentation` fails, naming the route ID, when a
|
||||
registered route has no record. The merge gate FE-GATE-009 runs only
|
||||
`review:a11y-manual -- --format-only`, which checks that every route record
|
||||
keeps the template's fields, reviewed or still pending.
|
||||
- `collect:web-vitals-evidence` stays `FAIL_UNVERIFIED` until a reviewed minimum
|
||||
eligible-sample threshold and 28 days of production data exist.
|
||||
|
||||
Live hosting verification (FE-GATE-019, production stage) requires
|
||||
`HOSTING_BASE_URL` and a deployed promoted release; without it the result is
|
||||
`UNVERIFIED`, not `PASS`.
|
||||
`HOSTING_BASE_URL` and the promoted release deployed by the workflow's
|
||||
`deployment` job. That job is an empty slot until the project fills it in
|
||||
`config/ci/product-gates.json`
|
||||
([`docs/operations/ci-quality-gates.md`](docs/operations/ci-quality-gates.md));
|
||||
until then the result is `UNVERIFIED`, not `PASS`. A host serving another
|
||||
release fails, and so does one without HTTP/2 or entry compression.
|
||||
|
||||
## CI and evidence
|
||||
|
||||
@@ -297,15 +326,29 @@ MERGE_READY -> RELEASE_READY -> PROD_PROMOTION_READY -> FIELD_SLO_READY
|
||||
The workflow runs on pull requests, pushes to `main` and `develop`, and `v*`
|
||||
tags. The Git host of this repository may not have Actions enabled, so a pull
|
||||
request can show no gate status at all; no status is not a pass. Until the
|
||||
host runs the workflow and marks the merge gates as required checks, run the 13
|
||||
host runs the workflow and marks the merge gates as required checks, run the 14
|
||||
merge gates locally before merging (FE-GATE-008 and 009 need Playwright
|
||||
browsers):
|
||||
browsers; FE-GATE-012 builds the app first). Product checks listed in
|
||||
`config/ci/product-gates.json` (`PRODUCT-GATE-NNN`) run in the workflow's own
|
||||
`product_merge_gate` job:
|
||||
|
||||
```bash
|
||||
for gate in 001 002 003 004 005 006 007 008 009 010 011 013 020; do
|
||||
for gate in 001 002 003 004 005 006 007 008 009 010 011 012 013 020; do
|
||||
corepack pnpm ci:gate -- "FE-GATE-$gate" || break
|
||||
done
|
||||
```
|
||||
|
||||
To run them as the workflow does, give the workflow's environment first.
|
||||
`CI=true` makes the runner and the release build require the CI build
|
||||
identity; builds a test makes of a copy (fixture builds, the visual goldens'
|
||||
build, the dev servers of the browser tests) run as local builds whatever this
|
||||
says (`localBuildEnvironment` in `scripts/lib/build-environment.ts`). Run it in
|
||||
a clean clone: `ci:gate` stops a gate at its first failing command.
|
||||
|
||||
```bash
|
||||
export CI=true VITE_COMMIT_SHA="$(git rev-parse HEAD)" VITE_BUILD_ID=local-ci-1 \
|
||||
RELEASE_ID=local-ci-1 CI_RUNNER_IMAGE="local/runner@sha256:$(printf 'a%.0s' $(seq 64))"
|
||||
```
|
||||
Machine-readable evidence is written below `artifacts/`; generated evidence is
|
||||
ignored by Git while `.gitkeep` files preserve the taxonomy.
|
||||
|
||||
@@ -317,7 +360,9 @@ Operational details are in `docs/operations/`, with incident procedures in
|
||||
Template versions are Git tags `vX.Y.Z`. [`CHANGELOG.md`](CHANGELOG.md) lists
|
||||
the changes between tags, marks security fixes **[보안]** and contract changes
|
||||
**[계약]** (backend, deployment, CI or feature code must change too), and names
|
||||
the affected paths.
|
||||
the affected paths. Its unreleased section summarizes one sync range (the
|
||||
section head names the base commit and the branch); take that range as a whole
|
||||
and do its "먼저 할 일" (BREAKING) steps in order before running the gates.
|
||||
|
||||
Record where you started. Right after copying, commit a one-line
|
||||
`.template-origin` file at the root of your project with the template tag (or
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
$ node scripts/check-architecture.ts
|
||||
Static import graph: 330 modules, 984 dependencies, all imports resolved
|
||||
Architecture graph fixtures: 16 regression checks PASS
|
||||
TypeScript-only source policy: PASS (src, scripts, tests, .storybook, recipes; no fixture exceptions)
|
||||
Architecture fixtures: allowed PASS, 9 forbidden rejected
|
||||
@@ -1 +0,0 @@
|
||||
$ tsc --project tsconfig.app.json
|
||||
@@ -1 +0,0 @@
|
||||
$ tsc --project tsconfig.test.json
|
||||
@@ -1,20 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/unit/http-retry-lifecycle.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 4[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/realtime/bounded-polling-policy.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/realtime/realtime-reconnect-policy.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/retry-policy.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/realtime/bounded-poll-coordinator.test.ts [2m([22m[2m16 tests[22m[2m)[22m[32m 25[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/realtime/live-poll-handoff-coordinator.test.ts [2m([22m[2m13 tests[22m[2m)[22m[32m 71[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/resumable-upload-runtime.test.ts [2m([22m[2m18 tests[22m[2m)[22m[32m 87[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/realtime/realtime-reconnect-coordinator.test.ts [2m([22m[2m25 tests[22m[2m)[22m[32m 32[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/tanstack-cache-coordinator.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 168[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/resumable-upload-runtime-teardown.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 163[2mms[22m[39m
|
||||
[32m✓[39m tests/unit/realtime/stream-coordinator.test.ts [2m([22m[2m36 tests[22m[2m)[22m[33m 625[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m11 passed[39m[22m[90m (11)[39m
|
||||
[2m Tests [22m [1m[32m138 passed[39m[22m[90m (138)[39m
|
||||
[2m Start at [22m 08:27:14
|
||||
[2m Duration [22m 1.40s[2m (transform 1.56s, setup 3.50s, import 2.09s, tests 1.19s, environment 2ms)[22m
|
||||
|
||||
@@ -1,37 +0,0 @@
|
||||
contract set: 0 package(s) sha256:ad6aab71fea6a9ff87cbd170b984b339965afc90d85bb57f87801c9e0c020da2
|
||||
vite v8.1.5 building client environment for production...
|
||||
[2K
|
||||
transforming...✓ 2113 modules transformed.
|
||||
rendering chunks...
|
||||
computing gzip size...
|
||||
dist/index.html 1.12 kB │ gzip: 0.45 kB
|
||||
dist/.vite/manifest.json 8.11 kB │ gzip: 1.04 kB
|
||||
dist/.vite/module-inventory.json 21.94 kB │ gzip: 3.15 kB
|
||||
dist/assets/index-C0p5zoj4.css 39.62 kB │ gzip: 8.51 kB
|
||||
dist/assets/installed-contract-contributions-CFHdeDEf.js 0.16 kB │ gzip: 0.15 kB
|
||||
dist/assets/not-found-page-CHQA5rw5.js 0.45 kB │ gzip: 0.30 kB
|
||||
dist/assets/reference-resource-status-page-t3RWROLD.js 0.51 kB │ gzip: 0.45 kB
|
||||
dist/assets/use-reference-failure-action-BYb2UYeT.js 0.57 kB │ gzip: 0.37 kB
|
||||
dist/assets/session-provider-CIR3Mmin.js 0.60 kB │ gzip: 0.39 kB
|
||||
dist/assets/application-provider-_OkSTAcq.js 0.61 kB │ gzip: 0.34 kB
|
||||
dist/assets/reference-resource-page-1-Q0DGen.js 1.21 kB │ gzip: 0.77 kB
|
||||
dist/assets/reference-resource-detail-page-D5mbWw2a.js 1.23 kB │ gzip: 0.72 kB
|
||||
dist/assets/async-state-CfvFHl3I.js 1.53 kB │ gzip: 0.49 kB
|
||||
dist/assets/auth-example-page-htVwyPYW.js 1.78 kB │ gzip: 0.94 kB
|
||||
dist/assets/context-routes-CEM0c3Wb.js 1.80 kB │ gzip: 0.70 kB
|
||||
dist/assets/server-state-DQADfngu.js 2.24 kB │ gzip: 0.90 kB
|
||||
dist/assets/home-page-a_jMrdst.js 2.37 kB │ gzip: 1.27 kB
|
||||
dist/assets/state-gallery-page-CunviFji.js 2.70 kB │ gzip: 1.22 kB
|
||||
dist/assets/reference-resource-form-page-BHq_gRJf.js 2.77 kB │ gzip: 1.50 kB
|
||||
dist/assets/installed-feature-contracts-DgTAlLr2.js 4.52 kB │ gzip: 1.43 kB
|
||||
dist/assets/ui-gallery-page-Ru0CrH32.js 8.09 kB │ gzip: 2.90 kB
|
||||
dist/assets/platform-overview-page-BgxC-c_W.js 11.90 kB │ gzip: 4.08 kB
|
||||
dist/assets/route-input-DpW3PpRj.js 19.72 kB │ gzip: 6.27 kB
|
||||
dist/assets/use-reference-feature-DkrwJNPz.js 23.75 kB │ gzip: 8.06 kB
|
||||
dist/assets/preload-helper-ChbRSsLi.js 101.06 kB │ gzip: 27.93 kB
|
||||
dist/assets/design-system-Bd1NzELd.js 213.52 kB │ gzip: 65.78 kB
|
||||
dist/assets/index-zhAbJ8ef.js 294.86 kB │ gzip: 91.72 kB
|
||||
|
||||
✓ built in 361ms
|
||||
runtime config: local profile written to dist/config.json (APP_ENV=local, AUTH_MODE=demo)
|
||||
service worker mode null: skipping worker build
|
||||
@@ -1,2 +0,0 @@
|
||||
app build input: app=template-app contexts=1 features=1 generatedImports=1 bundle=1 feature dirs PASS
|
||||
$ node scripts/check-app-build-input.ts --require-bundle
|
||||
@@ -1,2 +0,0 @@
|
||||
app build input: app=template-app contexts=1 features=1 generatedImports=1 bundle=not checked PASS
|
||||
$ node scripts/check-app-build-input.ts
|
||||
@@ -1,5 +0,0 @@
|
||||
Static import graph: 363 modules, 1043 dependencies, all imports resolved
|
||||
Architecture graph fixtures: 16 regression checks PASS
|
||||
TypeScript-only source policy: PASS (src, scripts, tests, .storybook, recipes; no fixture exceptions)
|
||||
Architecture fixtures: allowed PASS, 9 forbidden rejected
|
||||
$ node scripts/check-architecture.ts
|
||||
@@ -1,2 +0,0 @@
|
||||
Diagnostics contract: 8 diagnostics and 5 telemetry producers PASS
|
||||
$ node scripts/check-diagnostics.ts
|
||||
@@ -1 +0,0 @@
|
||||
$ node scripts/generate-product-feature-index.ts --check
|
||||
@@ -1,23 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-port.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/redact-telemetry.test.ts [2m([22m[2m14 tests[22m[2m)[22m[32m 17[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-buffer.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 22[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/validation/validation-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-deduplicator.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 13[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/observability-boundaries.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 142[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/errors/platform-errors.test.ts [2m([22m[2m16 tests[22m[2m)[22m[32m 23[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/trace-context.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 63[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/validation/bounded-json.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 107[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/errors/app-error.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/errors/failure-boundary.test.tsx [2m([22m[2m4 tests[22m[2m)[22m[32m 55[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-pipeline.test.ts [2m([22m[2m9 tests[22m[2m)[22m[33m 785[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds network sends during a repeated error storm [33m 718[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m12 passed[39m[22m[90m (12)[39m
|
||||
[2m Tests [22m [1m[32m99 passed[39m[22m[90m (99)[39m
|
||||
[2m Start at [22m 13:29:27
|
||||
[2m Duration [22m 1.58s[2m (transform 1.38s, setup 3.81s, import 1.84s, tests 1.25s, environment 902ms)[22m
|
||||
|
||||
$ node scripts/run-vitest.ts run tests/platform/errors tests/platform/validation tests/platform/telemetry tests/architecture/observability-boundaries.test.ts --reporter=default
|
||||
@@ -1,2 +0,0 @@
|
||||
Registry governance: 11 registries PASS; compatibility=breaking
|
||||
$ node scripts/check-registries.ts
|
||||
@@ -1,16 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/release/release-coherence.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/release/release-mismatch-recovery.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 14[2mms[22m[39m
|
||||
[32m✓[39m tests/release/old-asset-reachability.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/release/cache-policy.test.ts [2m([22m[2m5 tests[22m[2m)[22m[32m 39[2mms[22m[39m
|
||||
[32m✓[39m tests/release/release-matrix.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 48[2mms[22m[39m
|
||||
[32m✓[39m tests/release/mixed-replica.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 69[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m6 passed[39m[22m[90m (6)[39m
|
||||
[2m Tests [22m [1m[32m43 passed[39m[22m[90m (43)[39m
|
||||
[2m Start at [22m 13:29:30
|
||||
[2m Duration [22m 914ms[2m (transform 1.31s, setup 1.45s, import 2.18s, tests 187ms, environment 1ms)[22m
|
||||
|
||||
$ node scripts/run-vitest.ts run tests/platform/release tests/release --reporter=default
|
||||
@@ -1,3 +0,0 @@
|
||||
request fan-out: 77 files scanned, 0 per-row dispatches PASS
|
||||
request fan-out fixtures: forbidden 3 rejected in 3 files, allowed 0 violations PASS
|
||||
$ node scripts/check-request-fanout.ts && node scripts/check-request-fanout.ts --fixture
|
||||
@@ -1,4 +0,0 @@
|
||||
compatibility: structural=true compiler=true timing=true
|
||||
axes: absolute 28 (ok), growth 8 (ok), relative 16 compiler + 12 timing
|
||||
scale baseline gate: PASSED (artifacts/scale/baseline-comparison.json)
|
||||
$ node scripts/scale/check-scale-baseline.ts
|
||||
@@ -1,10 +0,0 @@
|
||||
PASSED main:architecture-topology (3173ms)
|
||||
PASSED main:traffic-budgets (1489ms)
|
||||
PASSED main:scale-units (2433ms)
|
||||
PASSED main:composition-s0-s1 (91ms)
|
||||
PASSED main:composition-s0-s2 (232ms)
|
||||
PASSED main:composition-scale-suite (941ms)
|
||||
PASSED main:typescript-diagnostics (1543ms)
|
||||
PASSED main:baseline-regression (1739ms)
|
||||
scale tier main: PASSED (artifacts/scale/main/summary.json)
|
||||
$ node scripts/scale/run-scale-profile.ts main
|
||||
@@ -1,14 +0,0 @@
|
||||
PASSED nightly:architecture-topology (3175ms)
|
||||
PASSED nightly:traffic-budgets (1393ms)
|
||||
PASSED nightly:scale-units (2435ms)
|
||||
PASSED nightly:composition-s0-s1 (90ms)
|
||||
PASSED nightly:composition-s0-s2 (226ms)
|
||||
PASSED nightly:composition-scale-suite (861ms)
|
||||
PASSED nightly:typescript-diagnostics (1552ms)
|
||||
PASSED nightly:baseline-regression (1750ms)
|
||||
PASSED nightly:topology-s3-s4 (6995ms)
|
||||
PASSED nightly:telemetry-storm (3703ms)
|
||||
PASSED nightly:session-cycles (1703ms)
|
||||
PASSED nightly:browser-soak (121407ms)
|
||||
scale tier nightly: PASSED (artifacts/scale/nightly/summary.json)
|
||||
$ node scripts/scale/run-scale-profile.ts nightly
|
||||
@@ -1,6 +0,0 @@
|
||||
PASSED pr:architecture-topology (4307ms)
|
||||
PASSED pr:traffic-budgets (1446ms)
|
||||
PASSED pr:scale-units (2377ms)
|
||||
PASSED pr:composition-s0-s1 (87ms)
|
||||
scale tier pr: PASSED (artifacts/scale/pr/summary.json)
|
||||
$ node scripts/scale/run-scale-profile.ts pr
|
||||
@@ -1,13 +0,0 @@
|
||||
PASSED release:release-coherence (1123ms)
|
||||
PASSED release:architecture-topology (3142ms)
|
||||
PASSED release:traffic-budgets (1432ms)
|
||||
PASSED release:scale-units (2318ms)
|
||||
PASSED release:composition-s0-s1 (95ms)
|
||||
PASSED release:composition-s0-s2 (235ms)
|
||||
PASSED release:composition-scale-suite (843ms)
|
||||
PASSED release:typescript-diagnostics (1499ms)
|
||||
PASSED release:baseline-regression (1820ms)
|
||||
PASSED release:topology-s3-s4 (7137ms)
|
||||
PASSED release:telemetry-storm (3364ms)
|
||||
scale tier release: PASSED (artifacts/scale/release/summary.json)
|
||||
$ node scripts/scale/run-scale-profile.ts release
|
||||
@@ -1,19 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/cardinality/cardinality-budget.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/compose-unique-record.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/context-lazy-loading.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/routing/context-route-module.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/topology-cardinality.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 13[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/extreme-scale-registry.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 2363[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps 10k -> 100k composition growth below a quadratic regression budget [33m 391[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps one million lookups bounded on a 100k-entry runtime registry [33m 1515[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects and resolves 100k feature ids within the membership budget [33m 455[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m6 passed[39m[22m[90m (6)[39m
|
||||
[2m Tests [22m [1m[32m21 passed[39m[22m[90m (21)[39m
|
||||
[2m Start at [22m 13:29:21
|
||||
[2m Duration [22m 2.94s[2m (transform 231ms, setup 1.63s, import 305ms, tests 2.41s, environment 1ms)[22m
|
||||
|
||||
$ node scripts/run-vitest.ts run tests/architecture/topology-cardinality.test.ts tests/architecture/context-lazy-loading.test.ts tests/platform/cardinality tests/platform/routing --reporter=default
|
||||
@@ -1,21 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/traffic/request-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 17[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/retry-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/deadline.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/concurrency-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/execution/execution-context.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-budget.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/operation-traffic-policy.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-fanout.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 49[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 47[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/http-budget-integration.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 130[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-amplification.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 391[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m11 passed[39m[22m[90m (11)[39m
|
||||
[2m Tests [22m [1m[32m69 passed[39m[22m[90m (69)[39m
|
||||
[2m Start at [22m 13:29:25
|
||||
[2m Duration [22m 1.34s[2m (transform 858ms, setup 4.17s, import 1.44s, tests 690ms, environment 2ms)[22m
|
||||
|
||||
$ node scripts/run-vitest.ts run tests/platform/execution tests/platform/traffic tests/platform/resilience --reporter=default
|
||||
@@ -1 +0,0 @@
|
||||
$ tsc --project tsconfig.app.json
|
||||
@@ -1 +0,0 @@
|
||||
$ tsc --project tsconfig.test.json
|
||||
@@ -1,7 +0,0 @@
|
||||
$ corepack pnpm check:types:app && corepack pnpm check:types:node && corepack pnpm check:types:test && corepack pnpm check:types:recipes && corepack pnpm check:types:web-worker && corepack pnpm check:types:service-worker
|
||||
$ tsc --project tsconfig.app.json
|
||||
$ tsc --project tsconfig.node.json
|
||||
$ tsc --project tsconfig.test.json
|
||||
$ node scripts/check-optional-recipe-types.ts
|
||||
$ tsc --project tsconfig.web-worker.json
|
||||
$ tsc --project tsconfig.service-worker.json
|
||||
@@ -1 +0,0 @@
|
||||
$ eslint src scripts tests recipes .storybook vite.config.ts vitest.config.ts playwright*.config.ts --max-warnings=0
|
||||
@@ -1,23 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scripts/generate-product-feature-index.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 41[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 54[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-fanout.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 56[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/request-fanout.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 194[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 50[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-request-fanout.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 68[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/app-build-input.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 2380[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m accepts the production generator's output and an app-local bundle [33m 771[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a generator regression that imports every discovered feature [33m 673[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a production bundle that contains another app's feature [33m 643[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/global-local-independence.test.ts [2m([22m[2m7 tests[22m[2m)[22m[33m 7755[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps App A's generated indexes and reachable source graph identical from S0 to S2 on disk [33m 5260[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects another app from the same repository without App A's features [33m 982[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m8 passed[39m[22m[90m (8)[39m
|
||||
[2m Tests [22m [1m[32m43 passed[39m[22m[90m (43)[39m
|
||||
[2m Start at [22m 13:29:12
|
||||
[2m Duration [22m 8.30s[2m (transform 919ms, setup 1.94s, import 1.61s, tests 10.60s, environment 1ms)[22m
|
||||
|
||||
$ node scripts/run-vitest.ts run tests/scale/global-local-independence.test.ts tests/architecture/app-build-input.test.ts tests/architecture/request-fanout.test.ts tests/platform/traffic/request-fanout.test.ts tests/platform/traffic/request-deduplication.test.ts tests/features/reference-feature/reference-request-fanout.test.ts tests/features/reference-feature/reference-request-deduplication.test.ts tests/scripts/generate-product-feature-index.test.ts --reporter=default
|
||||
@@ -1,55 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/architecture/app-build-input.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 9429[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m accepts the production generator's output and an app-local bundle [33m 1340[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a generator regression that imports every discovered feature [33m 5122[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a production bundle that contains another app's feature [33m 2464[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/extreme-scale-registry.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 3975[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps 10k -> 100k composition growth below a quadratic regression budget [33m 634[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps one million lookups bounded on a 100k-entry runtime registry [33m 2331[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects and resolves 100k feature ids within the membership budget [33m 1007[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-pipeline.test.ts [2m([22m[2m9 tests[22m[2m)[22m[33m 1077[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds network sends during a repeated error storm [33m 961[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-amplification.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 558[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps physical requests bounded when every dispatch fails [33m 307[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/request-fanout.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 344[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m finds no per-row dispatch in feature code or application use cases [33m 330[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/observability-boundaries.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 235[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/http-budget-integration.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 133[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/validation/bounded-json.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 140[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/trace-context.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 82[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/errors/failure-boundary.test.tsx [2m([22m[2m4 tests[22m[2m)[22m[32m 87[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-fanout.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 75[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 74[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/release/cache-policy.test.ts [2m([22m[2m5 tests[22m[2m)[22m[32m 40[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/errors/platform-errors.test.ts [2m([22m[2m16 tests[22m[2m)[22m[32m 19[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-buffer.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 20[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/redact-telemetry.test.ts [2m([22m[2m14 tests[22m[2m)[22m[32m 14[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/release/release-mismatch-recovery.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 12[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/topology-cardinality.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-deduplicator.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/concurrency-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/execution/execution-context.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 12[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-budget.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/validation/validation-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/operation-traffic-policy.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/routing/context-route-module.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/release/release-coherence.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 13[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/compose-unique-record.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-port.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/retry-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/errors/app-error.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/cardinality-budget.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/context-lazy-loading.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/deadline.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/module-hierarchy.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m35 passed[39m[22m[90m (35)[39m
|
||||
[2m Tests [22m [1m[32m223 passed[39m[22m[90m (223)[39m
|
||||
[2m Start at [22m 13:29:32
|
||||
[2m Duration [22m 33.44s[2m (transform 977ms, setup 7.36s, import 2.52s, tests 16.46s, environment 1.01s)[22m
|
||||
|
||||
JUNIT report written to /shared/codebase/clean-architecture-frontend-template/artifacts/tests/platform.xml
|
||||
$ node scripts/run-vitest.ts run tests/platform tests/architecture --no-file-parallelism --reporter=default --reporter=junit --outputFile.junit=artifacts/tests/platform.xml
|
||||
@@ -1,30 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/features/reference-feature/reference-error.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 102[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-telemetry.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 55[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-http-problem-mapping.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 12[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 112[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-request-fanout.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 189[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-traffic-policy.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/installed-context-routing.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 108[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-contract.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 35[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/feature-module.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-http-gateway.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-installed-executor.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-diagnostics.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 81[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-runtime-composition.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 201[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-production-vertical.test.tsx [2m([22m[2m1 test[22m[2m)[22m[33m 1243[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m traverses bootstrap, router, application, HTTP schema/mapper and query cache [33m 1237[2mms[22m[39m
|
||||
[32m✓[39m tests/features/reference-feature/reference-page.test.tsx [2m([22m[2m11 tests[22m[2m)[22m[33m 3248[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m mounts list and detail keys under the installed governed namespace [33m 1035[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m renders backend forbidden even when the client access hint allowed entry [33m 423[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m deduplicates create, preserves input and surfaces a conflict [33m 584[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m15 passed[39m[22m[90m (15)[39m
|
||||
[2m Tests [22m [1m[32m54 passed[39m[22m[90m (54)[39m
|
||||
[2m Start at [22m 13:30:06
|
||||
[2m Duration [22m 7.80s[2m (transform 13.26s, setup 7.90s, import 20.03s, tests 5.42s, environment 2.84s)[22m
|
||||
|
||||
JUNIT report written to /shared/codebase/clean-architecture-frontend-template/artifacts/tests/reference-feature.xml
|
||||
$ node scripts/run-vitest.ts run tests/features/reference-feature --reporter=default --reporter=junit --outputFile.junit=artifacts/tests/reference-feature.xml --passWithNoTests
|
||||
@@ -1,25 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/cardinality/cardinality-budget.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/compose-unique-record.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/module-hierarchy.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/context-lazy-loading.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/routing/context-route-module.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/topology-cardinality.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/observability-boundaries.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 97[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/request-fanout.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 206[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/extreme-scale-registry.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 2005[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps 10k -> 100k composition growth below a quadratic regression budget [33m 407[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps one million lookups bounded on a 100k-entry runtime registry [33m 1229[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects and resolves 100k feature ids within the membership budget [33m 366[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/app-build-input.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 2215[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m accepts the production generator's output and an app-local bundle [33m 714[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a generator regression that imports every discovered feature [33m 626[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a production bundle that contains another app's feature [33m 613[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m10 passed[39m[22m[90m (10)[39m
|
||||
[2m Tests [22m [1m[32m34 passed[39m[22m[90m (34)[39m
|
||||
[2m Start at [22m 13:30:24
|
||||
[2m Duration [22m 2.82s[2m (transform 645ms, setup 2.94s, import 949ms, tests 4.57s, environment 2ms)[22m
|
||||
|
||||
@@ -1,3 +0,0 @@
|
||||
compatibility: structural=true compiler=true timing=true
|
||||
axes: absolute 28 (ok), growth 8 (ok), relative 16 compiler + 12 timing
|
||||
scale baseline gate: PASSED (artifacts/scale/main/baseline-regression.json)
|
||||
@@ -1,5 +0,0 @@
|
||||
PASS registry-composition:growth (exponents 0.00)
|
||||
PASS product-feature-selection:growth (exponents 0.00)
|
||||
PASS product-feature-resolution:growth (exponents 0.00)
|
||||
PASS context-hierarchy-composition:growth (exponents 0.00)
|
||||
composition scale artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/main/composition-s0-s1.json
|
||||
@@ -1,5 +0,0 @@
|
||||
PASS registry-composition:growth (exponents 0.00, 0.64)
|
||||
PASS product-feature-selection:growth (exponents 0.00, 0.83)
|
||||
PASS product-feature-resolution:growth (exponents 0.00, 0.83)
|
||||
PASS context-hierarchy-composition:growth (exponents 0.00, 0.34)
|
||||
composition scale artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/main/composition-s0-s2.json
|
||||
@@ -1,11 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/tsc-diagnostics-parser.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/composition-scale.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 232[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m2 passed[39m[22m[90m (2)[39m
|
||||
[2m Tests [22m [1m[32m9 passed[39m[22m[90m (9)[39m
|
||||
[2m Start at [22m 13:30:31
|
||||
[2m Duration [22m 596ms[2m (transform 94ms, setup 326ms, import 114ms, tests 239ms, environment 0ms)[22m
|
||||
|
||||
@@ -1,17 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/growth-regression.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/retry-after-jitter.test.ts [2m([22m[2m5 tests[22m[2m)[22m[32m 38[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/amplification-metrics.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/benchmark.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/synthetic-topology.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/scale-baseline.test.ts [2m([22m[2m11 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/failure-scenarios.test.ts [2m([22m[2m5 tests[22m[2m)[22m[33m 1420[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds physical requests when all upstream calls fail [33m 896[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m7 passed[39m[22m[90m (7)[39m
|
||||
[2m Tests [22m [1m[32m46 passed[39m[22m[90m (46)[39m
|
||||
[2m Start at [22m 13:30:29
|
||||
[2m Duration [22m 2.04s[2m (transform 695ms, setup 1.76s, import 808ms, tests 1.50s, environment 1ms)[22m
|
||||
|
||||
@@ -1,20 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/resilience/deadline.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 4[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/retry-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/concurrency-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-budget.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/execution/execution-context.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/operation-traffic-policy.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-fanout.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 59[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 47[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/http-budget-integration.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 124[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-amplification.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 379[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m11 passed[39m[22m[90m (11)[39m
|
||||
[2m Tests [22m [1m[32m69 passed[39m[22m[90m (69)[39m
|
||||
[2m Start at [22m 13:30:27
|
||||
[2m Duration [22m 1.13s[2m (transform 1.01s, setup 3.62s, import 1.55s, tests 663ms, environment 2ms)[22m
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
tsc app: files=827 types=279186 instantiations=700415
|
||||
PASS tsc:types (exponents 0.84, 0.96)
|
||||
PASS tsc:symbols (exponents 0.51, 0.80)
|
||||
PASS tsc:instantiations (exponents 0.97, 0.99)
|
||||
tsc diagnostics artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/main/typescript-diagnostics.json
|
||||
@@ -1,25 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/cardinality/compose-unique-record.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/cardinality-budget.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/module-hierarchy.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/context-lazy-loading.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/routing/context-route-module.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/topology-cardinality.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 13[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/observability-boundaries.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 109[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/request-fanout.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 151[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/extreme-scale-registry.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 1946[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps 10k -> 100k composition growth below a quadratic regression budget [33m 378[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps one million lookups bounded on a 100k-entry runtime registry [33m 1201[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects and resolves 100k feature ids within the membership budget [33m 365[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/app-build-input.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 2219[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m accepts the production generator's output and an app-local bundle [33m 671[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a generator regression that imports every discovered feature [33m 648[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a production bundle that contains another app's feature [33m 649[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m10 passed[39m[22m[90m (10)[39m
|
||||
[2m Tests [22m [1m[32m34 passed[39m[22m[90m (34)[39m
|
||||
[2m Start at [22m 13:30:41
|
||||
[2m Duration [22m 2.82s[2m (transform 580ms, setup 3.20s, import 787ms, tests 4.47s, environment 2ms)[22m
|
||||
|
||||
@@ -1,3 +0,0 @@
|
||||
compatibility: structural=true compiler=true timing=true
|
||||
axes: absolute 28 (ok), growth 8 (ok), relative 16 compiler + 12 timing
|
||||
scale baseline gate: PASSED (artifacts/scale/nightly/baseline-regression.json)
|
||||
@@ -1,12 +0,0 @@
|
||||
browser soak: passed classification=stable samples=24 cycles=2012
|
||||
PASS cycles (2012 >= 200)
|
||||
PASS post-warmup samples (18 >= 3)
|
||||
PASS navigation (0 failures)
|
||||
PASS heap slope (stable)
|
||||
PASS listeners (stable, delta 2)
|
||||
PASS timers (delta 0, max 2)
|
||||
PASS in-flight settles (final 0, max 0)
|
||||
PASS storage growth (keys 0, bytes 0)
|
||||
PASS backend failure exercised (68 settled visits, 479 API requests, 24 telemetry events)
|
||||
PASS request amplification (479 requests / 336 visits)
|
||||
PASS telemetry rate (max 14/min, 24 posts, 24 events)
|
||||
@@ -1,5 +0,0 @@
|
||||
PASS registry-composition:growth (exponents 0.00)
|
||||
PASS product-feature-selection:growth (exponents 0.00)
|
||||
PASS product-feature-resolution:growth (exponents 0.00)
|
||||
PASS context-hierarchy-composition:growth (exponents 0.00)
|
||||
composition scale artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/nightly/composition-s0-s1.json
|
||||
@@ -1,5 +0,0 @@
|
||||
PASS registry-composition:growth (exponents 0.00, 0.64)
|
||||
PASS product-feature-selection:growth (exponents 0.00, 0.85)
|
||||
PASS product-feature-resolution:growth (exponents 0.00, 0.83)
|
||||
PASS context-hierarchy-composition:growth (exponents 0.00, 0.34)
|
||||
composition scale artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/nightly/composition-s0-s2.json
|
||||
@@ -1,11 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/tsc-diagnostics-parser.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/composition-scale.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 191[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m2 passed[39m[22m[90m (2)[39m
|
||||
[2m Tests [22m [1m[32m9 passed[39m[22m[90m (9)[39m
|
||||
[2m Start at [22m 13:30:48
|
||||
[2m Duration [22m 514ms[2m (transform 78ms, setup 296ms, import 81ms, tests 197ms, environment 0ms)[22m
|
||||
|
||||
@@ -1,17 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/traffic/retry-after-jitter.test.ts [2m([22m[2m5 tests[22m[2m)[22m[32m 34[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/amplification-metrics.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/benchmark.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/growth-regression.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/synthetic-topology.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/scale-baseline.test.ts [2m([22m[2m11 tests[22m[2m)[22m[32m 14[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/failure-scenarios.test.ts [2m([22m[2m5 tests[22m[2m)[22m[33m 1453[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds physical requests when all upstream calls fail [33m 896[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m7 passed[39m[22m[90m (7)[39m
|
||||
[2m Tests [22m [1m[32m46 passed[39m[22m[90m (46)[39m
|
||||
[2m Start at [22m 13:30:45
|
||||
[2m Duration [22m 2.07s[2m (transform 436ms, setup 1.74s, import 563ms, tests 1.53s, environment 1ms)[22m
|
||||
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/session/network-flap.test.ts [2m([22m[2m2 tests[22m[2m)[22m[33m 324[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/session/long-session.test.ts [2m([22m[2m1 test[22m[2m)[22m[33m 921[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m returns timers, listeners, leases, buffers and cache entries to a stable bound [33m 919[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m2 passed[39m[22m[90m (2)[39m
|
||||
[2m Tests [22m [1m[32m3 passed[39m[22m[90m (3)[39m
|
||||
[2m Start at [22m 13:31:03
|
||||
[2m Duration [22m 1.37s[2m (transform 228ms, setup 296ms, import 363ms, tests 1.24s, environment 0ms)[22m
|
||||
|
||||
@@ -1,19 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-port.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-deduplicator.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-buffer.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 15[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/redact-telemetry.test.ts [2m([22m[2m14 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/trace-context.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 43[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/telemetry/telemetry-pipeline.test.ts [2m([22m[2m9 tests[22m[2m)[22m[33m 669[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds network sends during a repeated error storm [33m 609[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/telemetry/telemetry-storm.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 2882[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m does not turn 100000 identical failures into 100000 sends [33m 748[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds sends and buffer when a storm has many distinct fingerprints [33m 2099[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m7 passed[39m[22m[90m (7)[39m
|
||||
[2m Tests [22m [1m[32m52 passed[39m[22m[90m (52)[39m
|
||||
[2m Start at [22m 13:30:59
|
||||
[2m Duration [22m 3.35s[2m (transform 427ms, setup 1.75s, import 534ms, tests 3.64s, environment 1ms)[22m
|
||||
|
||||
@@ -1,16 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/cardinality/extreme-scale-registry.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 1822[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps 10k -> 100k composition growth below a quadratic regression budget [33m 313[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps one million lookups bounded on a 100k-entry runtime registry [33m 1163[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects and resolves 100k feature ids within the membership budget [33m 345[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/global-local-independence.test.ts [2m([22m[2m7 tests[22m[2m)[22m[33m 6311[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps App A's generated indexes and reachable source graph identical from S0 to S2 on disk [33m 4764[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects another app from the same repository without App A's features [33m 583[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m2 passed[39m[22m[90m (2)[39m
|
||||
[2m Tests [22m [1m[32m10 passed[39m[22m[90m (10)[39m
|
||||
[2m Start at [22m 13:30:52
|
||||
[2m Duration [22m 6.64s[2m (transform 87ms, setup 327ms, import 80ms, tests 8.13s, environment 0ms)[22m
|
||||
|
||||
@@ -1,20 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/traffic/concurrency-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/deadline.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 4[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/retry-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-budget.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/execution/execution-context.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/operation-traffic-policy.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-fanout.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 41[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 40[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/http-budget-integration.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 121[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-amplification.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 316[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m11 passed[39m[22m[90m (11)[39m
|
||||
[2m Tests [22m [1m[32m69 passed[39m[22m[90m (69)[39m
|
||||
[2m Start at [22m 13:30:44
|
||||
[2m Duration [22m 1.04s[2m (transform 890ms, setup 3.40s, import 1.40s, tests 570ms, environment 2ms)[22m
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
tsc app: files=827 types=279186 instantiations=700415
|
||||
PASS tsc:types (exponents 0.84, 0.96)
|
||||
PASS tsc:symbols (exponents 0.51, 0.80)
|
||||
PASS tsc:instantiations (exponents 0.97, 0.99)
|
||||
tsc diagnostics artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/nightly/typescript-diagnostics.json
|
||||
@@ -1,25 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/architecture/module-hierarchy.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 14[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/topology-cardinality.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 37[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/observability-boundaries.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 210[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/context-lazy-loading.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 18[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/cardinality-budget.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 22[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/compose-unique-record.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 12[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/routing/context-route-module.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/request-fanout.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 234[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/extreme-scale-registry.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 2791[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps 10k -> 100k composition growth below a quadratic regression budget [33m 721[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps one million lookups bounded on a 100k-entry runtime registry [33m 1649[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects and resolves 100k feature ids within the membership budget [33m 420[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/app-build-input.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 2872[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m accepts the production generator's output and an app-local bundle [33m 996[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a generator regression that imports every discovered feature [33m 897[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a production bundle that contains another app's feature [33m 723[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m10 passed[39m[22m[90m (10)[39m
|
||||
[2m Tests [22m [1m[32m34 passed[39m[22m[90m (34)[39m
|
||||
[2m Start at [22m 13:30:15
|
||||
[2m Duration [22m 3.81s[2m (transform 625ms, setup 4.78s, import 1.11s, tests 6.22s, environment 2ms)[22m
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
PASS registry-composition:growth (exponents 0.00)
|
||||
PASS product-feature-selection:growth (exponents 0.00)
|
||||
PASS product-feature-resolution:growth (exponents 0.00)
|
||||
PASS context-hierarchy-composition:growth (exponents 0.00)
|
||||
composition scale artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/pr/composition-s0-s1.json
|
||||
@@ -1,17 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/traffic/amplification-metrics.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/growth-regression.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/retry-after-jitter.test.ts [2m([22m[2m5 tests[22m[2m)[22m[32m 38[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/benchmark.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/synthetic-topology.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/scale-baseline.test.ts [2m([22m[2m11 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/failure-scenarios.test.ts [2m([22m[2m5 tests[22m[2m)[22m[33m 1429[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds physical requests when all upstream calls fail [33m 919[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m7 passed[39m[22m[90m (7)[39m
|
||||
[2m Tests [22m [1m[32m46 passed[39m[22m[90m (46)[39m
|
||||
[2m Start at [22m 13:30:21
|
||||
[2m Duration [22m 2.02s[2m (transform 485ms, setup 1.52s, import 646ms, tests 1.51s, environment 1ms)[22m
|
||||
|
||||
@@ -1,20 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/traffic/request-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/deadline.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/concurrency-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/retry-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/execution/execution-context.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-budget.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/operation-traffic-policy.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-fanout.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 44[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 40[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/http-budget-integration.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 127[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-amplification.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 328[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m11 passed[39m[22m[90m (11)[39m
|
||||
[2m Tests [22m [1m[32m69 passed[39m[22m[90m (69)[39m
|
||||
[2m Start at [22m 13:30:20
|
||||
[2m Duration [22m 1.09s[2m (transform 1.03s, setup 3.64s, import 1.52s, tests 590ms, environment 2ms)[22m
|
||||
|
||||
@@ -1,25 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/cardinality/compose-unique-record.test.ts [2m([22m[2m2 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/context-lazy-loading.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/routing/context-route-module.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/cardinality-budget.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/module-hierarchy.test.ts [2m([22m[2m1 test[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/topology-cardinality.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 12[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/observability-boundaries.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 101[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/request-fanout.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 155[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/cardinality/extreme-scale-registry.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 1941[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps 10k -> 100k composition growth below a quadratic regression budget [33m 383[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps one million lookups bounded on a 100k-entry runtime registry [33m 1177[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects and resolves 100k feature ids within the membership budget [33m 379[2mms[22m[39m
|
||||
[32m✓[39m tests/architecture/app-build-input.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 2191[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m accepts the production generator's output and an app-local bundle [33m 659[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a generator regression that imports every discovered feature [33m 635[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m rejects a production bundle that contains another app's feature [33m 660[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m10 passed[39m[22m[90m (10)[39m
|
||||
[2m Tests [22m [1m[32m34 passed[39m[22m[90m (34)[39m
|
||||
[2m Start at [22m 13:33:08
|
||||
[2m Duration [22m 2.80s[2m (transform 512ms, setup 3.13s, import 681ms, tests 4.43s, environment 2ms)[22m
|
||||
|
||||
@@ -1,3 +0,0 @@
|
||||
compatibility: structural=true compiler=true timing=true
|
||||
axes: absolute 28 (ok), growth 8 (ok), relative 16 compiler + 12 timing
|
||||
scale baseline gate: PASSED (artifacts/scale/release/baseline-regression.json)
|
||||
@@ -1,5 +0,0 @@
|
||||
PASS registry-composition:growth (exponents 0.00)
|
||||
PASS product-feature-selection:growth (exponents 0.00)
|
||||
PASS product-feature-resolution:growth (exponents 0.00)
|
||||
PASS context-hierarchy-composition:growth (exponents 0.00)
|
||||
composition scale artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/release/composition-s0-s1.json
|
||||
@@ -1,5 +0,0 @@
|
||||
PASS registry-composition:growth (exponents 0.00, 0.65)
|
||||
PASS product-feature-selection:growth (exponents 0.00, 0.90)
|
||||
PASS product-feature-resolution:growth (exponents 0.00, 0.85)
|
||||
PASS context-hierarchy-composition:growth (exponents 0.00, 0.44)
|
||||
composition scale artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/release/composition-s0-s2.json
|
||||
@@ -1,11 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/tsc-diagnostics-parser.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/composition-scale.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 186[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m2 passed[39m[22m[90m (2)[39m
|
||||
[2m Tests [22m [1m[32m9 passed[39m[22m[90m (9)[39m
|
||||
[2m Start at [22m 13:33:15
|
||||
[2m Duration [22m 494ms[2m (transform 86ms, setup 297ms, import 80ms, tests 193ms, environment 0ms)[22m
|
||||
|
||||
@@ -1,15 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/release/release-coherence.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 8[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/release/release-mismatch-recovery.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 14[2mms[22m[39m
|
||||
[32m✓[39m tests/release/old-asset-reachability.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/release/cache-policy.test.ts [2m([22m[2m5 tests[22m[2m)[22m[32m 29[2mms[22m[39m
|
||||
[32m✓[39m tests/release/release-matrix.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 39[2mms[22m[39m
|
||||
[32m✓[39m tests/release/mixed-replica.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 67[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m6 passed[39m[22m[90m (6)[39m
|
||||
[2m Tests [22m [1m[32m43 passed[39m[22m[90m (43)[39m
|
||||
[2m Start at [22m 13:33:06
|
||||
[2m Duration [22m 780ms[2m (transform 1.11s, setup 1.22s, import 1.79s, tests 163ms, environment 1ms)[22m
|
||||
|
||||
@@ -1,17 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/traffic/amplification-metrics.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/growth-regression.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/retry-after-jitter.test.ts [2m([22m[2m5 tests[22m[2m)[22m[32m 27[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/benchmark.test.ts [2m([22m[2m4 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/synthetic-topology.test.ts [2m([22m[2m8 tests[22m[2m)[22m[32m 13[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/scale-baseline.test.ts [2m([22m[2m11 tests[22m[2m)[22m[32m 11[2mms[22m[39m
|
||||
[32m✓[39m tests/scale/traffic/failure-scenarios.test.ts [2m([22m[2m5 tests[22m[2m)[22m[33m 1362[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds physical requests when all upstream calls fail [33m 874[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m7 passed[39m[22m[90m (7)[39m
|
||||
[2m Tests [22m [1m[32m46 passed[39m[22m[90m (46)[39m
|
||||
[2m Start at [22m 13:33:12
|
||||
[2m Duration [22m 1.96s[2m (transform 513ms, setup 1.59s, import 672ms, tests 1.44s, environment 1ms)[22m
|
||||
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/telemetry/telemetry-storm.test.ts [2m([22m[2m4 tests[22m[2m)[22m[33m 2705[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m does not turn 100000 identical failures into 100000 sends [33m 672[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m bounds sends and buffer when a storm has many distinct fingerprints [33m 1998[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m1 passed[39m[22m[90m (1)[39m
|
||||
[2m Tests [22m [1m[32m4 passed[39m[22m[90m (4)[39m
|
||||
[2m Start at [22m 13:33:26
|
||||
[2m Duration [22m 3.01s[2m (transform 58ms, setup 146ms, import 52ms, tests 2.71s, environment 0ms)[22m
|
||||
|
||||
@@ -1,12 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/scale/global-local-independence.test.ts [2m([22m[2m7 tests[22m[2m)[22m[33m 6484[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m keeps App A's generated indexes and reachable source graph identical from S0 to S2 on disk [33m 4707[2mms[22m[39m
|
||||
[33m[2m✓[22m[39m selects another app from the same repository without App A's features [33m 646[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m1 passed[39m[22m[90m (1)[39m
|
||||
[2m Tests [22m [1m[32m7 passed[39m[22m[90m (7)[39m
|
||||
[2m Start at [22m 13:33:19
|
||||
[2m Duration [22m 6.79s[2m (transform 53ms, setup 145ms, import 49ms, tests 6.48s, environment 0ms)[22m
|
||||
|
||||
@@ -1,20 +0,0 @@
|
||||
|
||||
[1m[30m[46m RUN [49m[39m[22m [36mv4.1.10 [39m[90m/shared/codebase/clean-architecture-frontend-template[39m
|
||||
|
||||
[32m✓[39m tests/platform/traffic/request-budget.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/concurrency-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 10[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/retry-budget.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 5[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/resilience/deadline.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 6[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-budget.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 9[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/execution/execution-context.test.ts [2m([22m[2m10 tests[22m[2m)[22m[32m 13[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/operation-traffic-policy.test.ts [2m([22m[2m7 tests[22m[2m)[22m[32m 7[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-fanout.test.ts [2m([22m[2m6 tests[22m[2m)[22m[32m 47[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/request-deduplication.test.ts [2m([22m[2m3 tests[22m[2m)[22m[32m 50[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/http-budget-integration.test.ts [2m([22m[2m9 tests[22m[2m)[22m[32m 121[2mms[22m[39m
|
||||
[32m✓[39m tests/platform/traffic/traffic-amplification.test.ts [2m([22m[2m3 tests[22m[2m)[22m[33m 331[2mms[22m[39m
|
||||
|
||||
[2m Test Files [22m [1m[32m11 passed[39m[22m[90m (11)[39m
|
||||
[2m Tests [22m [1m[32m69 passed[39m[22m[90m (69)[39m
|
||||
[2m Start at [22m 13:33:11
|
||||
[2m Duration [22m 1.08s[2m (transform 940ms, setup 3.62s, import 1.46s, tests 603ms, environment 2ms)[22m
|
||||
|
||||
@@ -1,5 +0,0 @@
|
||||
tsc app: files=827 types=279186 instantiations=700415
|
||||
PASS tsc:types (exponents 0.84, 0.96)
|
||||
PASS tsc:symbols (exponents 0.51, 0.80)
|
||||
PASS tsc:instantiations (exponents 0.97, 0.99)
|
||||
tsc diagnostics artifact: /shared/codebase/clean-architecture-frontend-template/artifacts/scale/release/typescript-diagnostics.json
|
||||
@@ -1,11 +1,11 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"owner": "frontend-platform",
|
||||
"reason": "13-03: production_gate downloads the promoted archive and FE-GATE-021..025 drill it with --release-root instead of rebuilding",
|
||||
"owner": "DongHyeonka",
|
||||
"reason": "1103/13-03: FE-GATE-027 also runs scan:dependency-advisories, a non-blocking release-stage advisory signal",
|
||||
"gates": 27,
|
||||
"commands": 98,
|
||||
"commandReferences": 103,
|
||||
"artifacts": 109,
|
||||
"commands": 100,
|
||||
"commandReferences": 104,
|
||||
"artifacts": 110,
|
||||
"stages": 5,
|
||||
"gateShapeSha256": "630e801239de5d175fd1049b2527851dabe06f139ba8ff6a98de7f09f7a257c2"
|
||||
"gateShapeSha256": "6225494d6447a2065d921a34597a744d180a7a68e601119e32f8fc42e18eb1c1"
|
||||
}
|
||||
|
||||
+55
-5
@@ -505,6 +505,11 @@
|
||||
{
|
||||
"id": "verify-hosting-headers",
|
||||
"script": "verify:hosting-headers",
|
||||
"args": [
|
||||
"--",
|
||||
"--release-root",
|
||||
".release/promoted-release"
|
||||
],
|
||||
"expect": "pass"
|
||||
},
|
||||
{
|
||||
@@ -512,6 +517,11 @@
|
||||
"script": "test:sample-removal",
|
||||
"expect": "pass"
|
||||
},
|
||||
{
|
||||
"id": "test-feature-scaffold",
|
||||
"script": "test:feature-scaffold",
|
||||
"expect": "pass"
|
||||
},
|
||||
{
|
||||
"id": "test-optional-recipe-removal",
|
||||
"script": "test:optional-recipe-removal",
|
||||
@@ -585,6 +595,11 @@
|
||||
"id": "check-release-admission",
|
||||
"script": "check:release-admission",
|
||||
"expect": "pass"
|
||||
},
|
||||
{
|
||||
"id": "scan-dependency-advisories",
|
||||
"script": "scan:dependency-advisories",
|
||||
"expect": "pass"
|
||||
}
|
||||
],
|
||||
"artifactSchemas": [
|
||||
@@ -1599,6 +1614,15 @@
|
||||
"test-sample-removal"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "artifact-artifacts-tests-feature-scaffold-xml",
|
||||
"path": "artifacts/tests/feature-scaffold.xml",
|
||||
"schemaId": "junit",
|
||||
"production": "command-generated",
|
||||
"producerCommandIds": [
|
||||
"test-feature-scaffold"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "artifact-artifacts-tests-optional-recipe-removal-xml",
|
||||
"path": "artifacts/tests/optional-recipe-removal.xml",
|
||||
@@ -2073,7 +2097,6 @@
|
||||
"id": "FE-GATE-019",
|
||||
"name": "hosting-header",
|
||||
"commandIds": [
|
||||
"build",
|
||||
"verify-hosting-headers"
|
||||
],
|
||||
"logArtifactId": "artifact-artifacts-quality-gates-FE-GATE-019-txt",
|
||||
@@ -2090,6 +2113,7 @@
|
||||
"name": "removability",
|
||||
"commandIds": [
|
||||
"test-sample-removal",
|
||||
"test-feature-scaffold",
|
||||
"test-optional-recipe-removal",
|
||||
"test-browser-file-storage-removal",
|
||||
"test-realtime-removal"
|
||||
@@ -2097,6 +2121,7 @@
|
||||
"logArtifactId": "artifact-artifacts-quality-gates-FE-GATE-020-txt",
|
||||
"evidenceArtifactIds": [
|
||||
"artifact-artifacts-tests-sample-removal-xml",
|
||||
"artifact-artifacts-tests-feature-scaffold-xml",
|
||||
"artifact-artifacts-tests-optional-recipe-removal-xml",
|
||||
"artifact-artifacts-tests-browser-file-storage-runtime-removal-xml",
|
||||
"artifact-artifacts-tests-realtime-runtime-removal-xml"
|
||||
@@ -2180,7 +2205,8 @@
|
||||
"id": "FE-GATE-027",
|
||||
"name": "release-admission",
|
||||
"commandIds": [
|
||||
"check-release-admission"
|
||||
"check-release-admission",
|
||||
"scan-dependency-advisories"
|
||||
],
|
||||
"logArtifactId": "artifact-artifacts-quality-gates-FE-GATE-027-txt",
|
||||
"evidenceArtifactIds": [
|
||||
@@ -2224,6 +2250,7 @@
|
||||
"FE-GATE-009",
|
||||
"FE-GATE-010",
|
||||
"FE-GATE-011",
|
||||
"FE-GATE-012",
|
||||
"FE-GATE-013",
|
||||
"FE-GATE-020"
|
||||
]
|
||||
@@ -2235,7 +2262,6 @@
|
||||
"merge"
|
||||
],
|
||||
"gateIds": [
|
||||
"FE-GATE-012",
|
||||
"FE-GATE-014",
|
||||
"FE-GATE-015",
|
||||
"FE-GATE-026",
|
||||
@@ -2297,6 +2323,7 @@
|
||||
"FE-GATE-009",
|
||||
"FE-GATE-010",
|
||||
"FE-GATE-011",
|
||||
"FE-GATE-012",
|
||||
"FE-GATE-013",
|
||||
"FE-GATE-020"
|
||||
],
|
||||
@@ -2342,7 +2369,6 @@
|
||||
"condition": "release",
|
||||
"timeoutMinutes": 45,
|
||||
"gateIds": [
|
||||
"FE-GATE-012",
|
||||
"FE-GATE-014",
|
||||
"FE-GATE-026",
|
||||
"FE-GATE-028"
|
||||
@@ -2765,13 +2791,33 @@
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "deployment",
|
||||
"displayName": "deploy-promoted-release",
|
||||
"kind": "deployment",
|
||||
"needs": [
|
||||
"immutable_build",
|
||||
"promotion"
|
||||
],
|
||||
"condition": "production",
|
||||
"timeoutMinutes": 45,
|
||||
"gateIds": [],
|
||||
"browserGateIds": [],
|
||||
"environment": [],
|
||||
"steps": [
|
||||
{
|
||||
"kind": "deploy"
|
||||
}
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "production_gate",
|
||||
"displayName": "${{ matrix.gate }} / ${{ matrix.name }}",
|
||||
"kind": "gate-matrix",
|
||||
"needs": [
|
||||
"immutable_build",
|
||||
"promotion"
|
||||
"promotion",
|
||||
"deployment"
|
||||
],
|
||||
"condition": "production",
|
||||
"timeoutMinutes": 45,
|
||||
@@ -2792,6 +2838,10 @@
|
||||
{
|
||||
"name": "CANDIDATE_ARCHIVE_SHA256",
|
||||
"value": "${{ needs.immutable_build.outputs.archive_sha256 }}"
|
||||
},
|
||||
{
|
||||
"name": "RELEASE_DEPLOYED",
|
||||
"value": "${{ needs.deployment.outputs.deployed }}"
|
||||
}
|
||||
],
|
||||
"steps": [
|
||||
|
||||
@@ -0,0 +1,5 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"deployment": null,
|
||||
"mergeGates": []
|
||||
}
|
||||
@@ -1,9 +1,13 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"entries": [
|
||||
{
|
||||
"script": "check:backend-contract-drift",
|
||||
"reason": "1103/12-06. Compares the paired backend checkout next to this repository with the commit config/contracts/backend-contract-pin.json pins. CI checks out this repository alone, so a gate has no backend to read; with no checkout the script reports skipped. The gated half of the pin is tests/unit/backend-contract-pin.test.ts (test:unit), which holds the Envelope table to the copied backend answer table. Run this before moving the pin."
|
||||
},
|
||||
{
|
||||
"script": "check:feature-index",
|
||||
"reason": "The generated indexes (src/.generated/) are not committed, and every gate script regenerates them first (generate-product-feature-index.ts), so --check can only tell a developer that the local copy is stale."
|
||||
"reason": "Local check that the generated indexes (src/.generated/, not committed) are current, and the first step of verify:extreme-scale (scripts/verify-extreme-scale.ts), itself a local run. A gate gains nothing from it: every gate script regenerates the indexes first (generate-product-feature-index.ts)."
|
||||
},
|
||||
{
|
||||
"script": "check:http-scenario-evidence",
|
||||
@@ -15,7 +19,7 @@
|
||||
},
|
||||
{
|
||||
"script": "check:remediation-ledger",
|
||||
"reason": "Checks the prose ledger of the 2026-08-14 adapter re-review (docs/operations/adapter-remediation-ledger.md) against test-file markers and the file-transfer bundle budget. Later fixes removed those markers and the budget is re-set at integration, so the check reports stale claims at this commit. It is a history record run by hand, not a current contract; wiring it into a gate first needs the ledger or the markers brought up to date."
|
||||
"reason": "Checks the prose ledger of the 2026-08-14 adapter re-review (docs/operations/adapter-remediation-ledger.md) against test-file markers and the file-transfer bundle budget. It is a history record run by hand, not a current contract: it fails when a product removes the optional file-transfer recipe or when a test split moves a marked test to another file, and neither should block a merge. Run it after moving those tests or changing that budget, and point the ledger rows at the new files."
|
||||
},
|
||||
{
|
||||
"script": "check:scale:baseline",
|
||||
|
||||
@@ -0,0 +1,19 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"backend": {
|
||||
"repository": "clean-architecture-backend-template",
|
||||
"commit": "45d2a478b800586f1d84151723629a560265d58e",
|
||||
"document": "docs/web/http-contract.md",
|
||||
"sectionsCompared": ["1", "2", "4"]
|
||||
},
|
||||
"frontend": {
|
||||
"contractDocument": "docs/architecture/backend-api-and-server-state-contract.md",
|
||||
"contractSections": ["4.1", "6", "6.1"],
|
||||
"readers": ["src/adapters/http/backend-envelope.ts"]
|
||||
},
|
||||
"tables": {
|
||||
"idempotencyAnswers": "config/contracts/backend-idempotency-answers.json"
|
||||
},
|
||||
"owner": "frontend-platform",
|
||||
"comparedOn": "2026-11-04"
|
||||
}
|
||||
@@ -0,0 +1,59 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"source": {
|
||||
"repository": "clean-architecture-backend-template",
|
||||
"commit": "45d2a478b800586f1d84151723629a560265d58e",
|
||||
"document": "docs/web/http-contract.md"
|
||||
},
|
||||
"answers": [
|
||||
{
|
||||
"section": "2",
|
||||
"code": "IDEMPOTENT_IN_FLIGHT",
|
||||
"status": 409,
|
||||
"refusedBeforeWrite": false,
|
||||
"sameKeyResend": true
|
||||
},
|
||||
{
|
||||
"section": "2",
|
||||
"code": "IDEMPOTENT_REQUEST_MISMATCH",
|
||||
"status": 422,
|
||||
"refusedBeforeWrite": true,
|
||||
"sameKeyResend": false
|
||||
},
|
||||
{
|
||||
"section": "2",
|
||||
"code": "IDEMPOTENCY_KEY_INVALID",
|
||||
"status": 400,
|
||||
"refusedBeforeWrite": true,
|
||||
"sameKeyResend": false
|
||||
},
|
||||
{
|
||||
"section": "2",
|
||||
"code": "IDEMPOTENCY_UNAVAILABLE",
|
||||
"status": 503,
|
||||
"refusedBeforeWrite": true,
|
||||
"sameKeyResend": true
|
||||
},
|
||||
{
|
||||
"section": "2",
|
||||
"code": "IDEMPOTENCY_COMPLETION_UNKNOWN",
|
||||
"status": 503,
|
||||
"refusedBeforeWrite": false,
|
||||
"sameKeyResend": true
|
||||
},
|
||||
{
|
||||
"section": "2",
|
||||
"code": "IDEMPOTENCY_RECOVERY_REQUIRED",
|
||||
"status": 500,
|
||||
"refusedBeforeWrite": false,
|
||||
"sameKeyResend": true
|
||||
},
|
||||
{
|
||||
"section": "4",
|
||||
"code": "REQUEST_TIMEOUT",
|
||||
"status": 503,
|
||||
"refusedBeforeWrite": false,
|
||||
"sameKeyResend": false
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"snapshotDigest": "83d11f848b8b2f67bcb657403f112d4baaf05481ab6bcee94ebc6851c32e2159",
|
||||
"owner": "frontend-platform",
|
||||
"reason": "07-04: FE-REG-ERROR drops severity, telemetryEvent and redaction, which nothing read",
|
||||
"approvedAt": "2026-09-25T15:11:58.763Z"
|
||||
"snapshotDigest": "319a798ca3c9a87d7e2943177d952b13941622f4faec23c28f36024196a9e91d",
|
||||
"owner": "DongHyeonka",
|
||||
"reason": "1103/16-04 FE-REG-API problemSchema가 FE-REG-SCHEMA api-problem 행을 참조한다",
|
||||
"approvedAt": "2026-11-04T14:04:44.377Z"
|
||||
}
|
||||
|
||||
@@ -43,24 +43,6 @@
|
||||
"public",
|
||||
"session-required"
|
||||
],
|
||||
"paramsSchema": [
|
||||
null,
|
||||
"NotFoundSplat",
|
||||
"ReferenceResourceParams"
|
||||
],
|
||||
"searchSchema": [
|
||||
null,
|
||||
"ReferenceResourceListQuery"
|
||||
],
|
||||
"loadingSurface": [
|
||||
"app-shell",
|
||||
"example-page",
|
||||
"reference-resource-list",
|
||||
"reference-resource-detail",
|
||||
"reference-resource-form",
|
||||
"reference-resource-status",
|
||||
"none"
|
||||
],
|
||||
"errorSurface": [
|
||||
"route-boundary",
|
||||
"feature-boundary",
|
||||
@@ -92,7 +74,10 @@
|
||||
"searchSchema",
|
||||
"access",
|
||||
"chunkId"
|
||||
]
|
||||
],
|
||||
"fieldPatterns": {
|
||||
"loadingSurface": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
|
||||
}
|
||||
},
|
||||
"rows": {
|
||||
"APP_HOME": {
|
||||
@@ -181,7 +166,7 @@
|
||||
"navigationLabel": null,
|
||||
"navigationOrder": null,
|
||||
"paramsSchema": "ReferenceResourceParams",
|
||||
"path": "/examples/reference-resources/:resourceId",
|
||||
"path": "/examples/reference-resources/items/:resourceId",
|
||||
"routeId": "REFERENCE_RESOURCE_DETAIL",
|
||||
"searchSchema": null,
|
||||
"title": "Reference detail"
|
||||
@@ -341,34 +326,56 @@
|
||||
{
|
||||
"registryId": "FE-REG-API",
|
||||
"owner": "feature-frontend-api-client-response-envelope-contract",
|
||||
"source": "src/features/installed-feature-contracts.ts",
|
||||
"source": "src/features/loaded-feature-runtimes.ts",
|
||||
"rowCount": 3,
|
||||
"contract": {
|
||||
"requiredFields": [
|
||||
"operationId",
|
||||
"featureId",
|
||||
"method",
|
||||
"path",
|
||||
"operationId",
|
||||
"auth",
|
||||
"timeoutMs",
|
||||
"idempotency",
|
||||
"retry",
|
||||
"requestSource",
|
||||
"authProfileId",
|
||||
"retrySemantics",
|
||||
"requestBody",
|
||||
"responseBody",
|
||||
"responseEnvelope",
|
||||
"requestSchema",
|
||||
"responseSchema",
|
||||
"owner"
|
||||
"problemSchema",
|
||||
"acceptedStatuses",
|
||||
"emptyBodyStatuses",
|
||||
"unvalidated",
|
||||
"requestByteLimit",
|
||||
"responseByteLimit",
|
||||
"totalDeadlineMs",
|
||||
"retryBudget",
|
||||
"traffic",
|
||||
"commandEffect",
|
||||
"commandRecovery"
|
||||
],
|
||||
"fieldTypes": {
|
||||
"operationId": "string",
|
||||
"featureId": "string",
|
||||
"method": "string",
|
||||
"path": "string",
|
||||
"operationId": "string",
|
||||
"auth": "string",
|
||||
"timeoutMs": "integer|null",
|
||||
"idempotency": "string",
|
||||
"retry": "string",
|
||||
"requestSource": "string",
|
||||
"authProfileId": "string",
|
||||
"retrySemantics": "string",
|
||||
"requestBody": "string",
|
||||
"responseBody": "string",
|
||||
"responseEnvelope": "string",
|
||||
"requestSchema": "string",
|
||||
"responseSchema": "string",
|
||||
"owner": "string"
|
||||
"problemSchema": "string",
|
||||
"acceptedStatuses": "array",
|
||||
"emptyBodyStatuses": "array",
|
||||
"unvalidated": "array",
|
||||
"requestByteLimit": "integer",
|
||||
"responseByteLimit": "integer",
|
||||
"totalDeadlineMs": "integer",
|
||||
"retryBudget": "integer",
|
||||
"traffic": "object|null",
|
||||
"commandEffect": "object|null",
|
||||
"commandRecovery": "object|null"
|
||||
},
|
||||
"uniqueFields": [
|
||||
"operationId"
|
||||
@@ -376,28 +383,30 @@
|
||||
"allowedValues": {
|
||||
"method": [
|
||||
"GET",
|
||||
"HEAD",
|
||||
"POST",
|
||||
"PUT",
|
||||
"PATCH",
|
||||
"DELETE"
|
||||
],
|
||||
"auth": [
|
||||
"none",
|
||||
"external-session"
|
||||
"retrySemantics": [
|
||||
"SAFE",
|
||||
"IDEMPOTENT",
|
||||
"KEYED",
|
||||
"NEVER"
|
||||
],
|
||||
"idempotency": [
|
||||
"safe",
|
||||
"keyed",
|
||||
"none"
|
||||
"requestBody": [
|
||||
"NONE",
|
||||
"JSON"
|
||||
],
|
||||
"retry": [
|
||||
"runtime",
|
||||
"never"
|
||||
"responseBody": [
|
||||
"REQUIRED_JSON",
|
||||
"OPTIONAL_JSON",
|
||||
"NONE"
|
||||
],
|
||||
"requestSource": [
|
||||
"none",
|
||||
"search",
|
||||
"body"
|
||||
"responseEnvelope": [
|
||||
"NONE",
|
||||
"ENVELOPE_V1"
|
||||
]
|
||||
},
|
||||
"references": [
|
||||
@@ -410,126 +419,135 @@
|
||||
"field": "responseSchema",
|
||||
"registryId": "FE-REG-SCHEMA",
|
||||
"targetField": "schemaId"
|
||||
},
|
||||
{
|
||||
"field": "problemSchema",
|
||||
"registryId": "FE-REG-SCHEMA",
|
||||
"targetField": "schemaId"
|
||||
}
|
||||
],
|
||||
"keyField": "operationId",
|
||||
"breakingFields": [
|
||||
"operationId",
|
||||
"method",
|
||||
"path",
|
||||
"operationId",
|
||||
"auth",
|
||||
"idempotency",
|
||||
"requestSource",
|
||||
"authProfileId",
|
||||
"retrySemantics",
|
||||
"requestBody",
|
||||
"responseBody",
|
||||
"responseEnvelope",
|
||||
"requestSchema",
|
||||
"responseSchema"
|
||||
"responseSchema",
|
||||
"problemSchema",
|
||||
"unvalidated"
|
||||
]
|
||||
},
|
||||
"rows": {
|
||||
"CREATE_REFERENCE_RESOURCE": {
|
||||
"auth": "external-session",
|
||||
"authProfileId": "REFERENCE_EXTERNAL_BEARER",
|
||||
"contractVersion": 2,
|
||||
"csrfProfileId": "NO_CSRF_BEARER",
|
||||
"idempotency": "keyed",
|
||||
"idempotencyKeyPolicy": "REQUIRED",
|
||||
"mapperId": "ReferenceResourceMapper",
|
||||
"maxEncodedSearchBytes": 0,
|
||||
"maxResponseBytes": 32768,
|
||||
"method": "POST",
|
||||
"operationId": "CREATE_REFERENCE_RESOURCE",
|
||||
"owner": "feature-frontend-reference-feature-vertical-slice",
|
||||
"path": "/api/reference-resources",
|
||||
"pathParameterNames": [],
|
||||
"pathSchema": "NoRequest",
|
||||
"protocol": "REST",
|
||||
"providerId": "PRIMARY_API",
|
||||
"replayPolicy": "KEYED_COMMAND",
|
||||
"requestSchema": "CreateReferenceResourceCommand",
|
||||
"requestSource": "body",
|
||||
"responseMediaTypes": [
|
||||
"application/json"
|
||||
],
|
||||
"responseSchema": "ReferenceResourcePayload",
|
||||
"retry": "runtime",
|
||||
"semantics": "COMMAND",
|
||||
"successStatuses": [
|
||||
"acceptedStatuses": [
|
||||
200,
|
||||
201
|
||||
],
|
||||
"timeoutMs": null
|
||||
"authProfileId": "EXTERNAL_BEARER",
|
||||
"commandEffect": {
|
||||
"classifiesStatus": true
|
||||
},
|
||||
"commandRecovery": {
|
||||
"mode": "IDEMPOTENCY_REPLAY",
|
||||
"operationIdentityField": "idempotencyKey"
|
||||
},
|
||||
"emptyBodyStatuses": [],
|
||||
"featureId": "reference-feature",
|
||||
"method": "POST",
|
||||
"operationId": "CREATE_REFERENCE_RESOURCE",
|
||||
"path": "/api/reference-resources",
|
||||
"problemSchema": "ReferenceProblem",
|
||||
"requestBody": "JSON",
|
||||
"requestByteLimit": 32768,
|
||||
"requestSchema": "CreateReferenceResourceCommand",
|
||||
"responseBody": "REQUIRED_JSON",
|
||||
"responseByteLimit": 32768,
|
||||
"responseEnvelope": "NONE",
|
||||
"responseSchema": "ReferenceResourcePayload",
|
||||
"retryBudget": 0,
|
||||
"retrySemantics": "KEYED",
|
||||
"totalDeadlineMs": 10000,
|
||||
"traffic": {
|
||||
"maxConcurrentRequests": 1,
|
||||
"maxPhysicalRequests": 1,
|
||||
"maxQueuedRequests": 0,
|
||||
"maxRetries": 0
|
||||
},
|
||||
"unvalidated": []
|
||||
},
|
||||
"GET_REFERENCE_RESOURCE": {
|
||||
"auth": "external-session",
|
||||
"authProfileId": "REFERENCE_EXTERNAL_BEARER",
|
||||
"contractVersion": 2,
|
||||
"csrfProfileId": "NO_CSRF_BEARER",
|
||||
"idempotency": "safe",
|
||||
"idempotencyKeyPolicy": "NONE",
|
||||
"mapperId": "ReferenceResourceMapper",
|
||||
"maxEncodedSearchBytes": 0,
|
||||
"maxResponseBytes": 32768,
|
||||
"acceptedStatuses": [
|
||||
200
|
||||
],
|
||||
"authProfileId": "EXTERNAL_BEARER",
|
||||
"commandEffect": null,
|
||||
"commandRecovery": null,
|
||||
"emptyBodyStatuses": [],
|
||||
"featureId": "reference-feature",
|
||||
"method": "GET",
|
||||
"operationId": "GET_REFERENCE_RESOURCE",
|
||||
"owner": "feature-frontend-reference-feature-vertical-slice",
|
||||
"path": "/api/reference-resources/{resourceId}",
|
||||
"pathParameterNames": [
|
||||
"resourceId"
|
||||
],
|
||||
"pathSchema": "ReferenceResourceParams",
|
||||
"protocol": "REST",
|
||||
"providerId": "PRIMARY_API",
|
||||
"replayPolicy": "SAFE",
|
||||
"requestSchema": "NoRequest",
|
||||
"requestSource": "none",
|
||||
"responseMediaTypes": [
|
||||
"application/json"
|
||||
],
|
||||
"problemSchema": "ReferenceProblem",
|
||||
"requestBody": "NONE",
|
||||
"requestByteLimit": 0,
|
||||
"requestSchema": "ReferenceResourceParams",
|
||||
"responseBody": "REQUIRED_JSON",
|
||||
"responseByteLimit": 32768,
|
||||
"responseEnvelope": "NONE",
|
||||
"responseSchema": "ReferenceResourcePayload",
|
||||
"retry": "runtime",
|
||||
"semantics": "QUERY",
|
||||
"successStatuses": [
|
||||
200
|
||||
],
|
||||
"timeoutMs": null
|
||||
"retryBudget": 2,
|
||||
"retrySemantics": "SAFE",
|
||||
"totalDeadlineMs": 10000,
|
||||
"traffic": {
|
||||
"maxConcurrentRequests": 1,
|
||||
"maxPhysicalRequests": 3,
|
||||
"maxQueuedRequests": 0,
|
||||
"maxRetries": 2
|
||||
},
|
||||
"unvalidated": []
|
||||
},
|
||||
"LIST_REFERENCE_RESOURCES": {
|
||||
"auth": "external-session",
|
||||
"authProfileId": "REFERENCE_EXTERNAL_BEARER",
|
||||
"contractVersion": 2,
|
||||
"csrfProfileId": "NO_CSRF_BEARER",
|
||||
"idempotency": "safe",
|
||||
"idempotencyKeyPolicy": "NONE",
|
||||
"mapperId": "ReferenceResourceListMapper",
|
||||
"maxEncodedSearchBytes": 4096,
|
||||
"maxResponseBytes": 262144,
|
||||
"method": "GET",
|
||||
"operationId": "LIST_REFERENCE_RESOURCES",
|
||||
"owner": "feature-frontend-reference-feature-vertical-slice",
|
||||
"path": "/api/reference-resources",
|
||||
"pathParameterNames": [],
|
||||
"pathSchema": "NoRequest",
|
||||
"protocol": "REST",
|
||||
"providerId": "PRIMARY_API",
|
||||
"replayPolicy": "SAFE",
|
||||
"requestSchema": "ReferenceResourceListQuery",
|
||||
"requestSource": "search",
|
||||
"responseMediaTypes": [
|
||||
"application/json"
|
||||
],
|
||||
"responseSchema": "ReferenceResourceListPayload",
|
||||
"retry": "runtime",
|
||||
"semantics": "QUERY",
|
||||
"successStatuses": [
|
||||
"acceptedStatuses": [
|
||||
200
|
||||
],
|
||||
"timeoutMs": null
|
||||
"authProfileId": "EXTERNAL_BEARER",
|
||||
"commandEffect": null,
|
||||
"commandRecovery": null,
|
||||
"emptyBodyStatuses": [],
|
||||
"featureId": "reference-feature",
|
||||
"method": "GET",
|
||||
"operationId": "LIST_REFERENCE_RESOURCES",
|
||||
"path": "/api/reference-resources",
|
||||
"problemSchema": "ReferenceProblem",
|
||||
"requestBody": "NONE",
|
||||
"requestByteLimit": 0,
|
||||
"requestSchema": "ReferenceResourceListQuery",
|
||||
"responseBody": "REQUIRED_JSON",
|
||||
"responseByteLimit": 262144,
|
||||
"responseEnvelope": "NONE",
|
||||
"responseSchema": "ReferenceResourceListPayload",
|
||||
"retryBudget": 2,
|
||||
"retrySemantics": "SAFE",
|
||||
"totalDeadlineMs": 10000,
|
||||
"traffic": {
|
||||
"maxConcurrentRequests": 1,
|
||||
"maxPhysicalRequests": 3,
|
||||
"maxQueuedRequests": 0,
|
||||
"maxRetries": 2
|
||||
},
|
||||
"unvalidated": []
|
||||
}
|
||||
}
|
||||
},
|
||||
{
|
||||
"registryId": "FE-REG-SCHEMA",
|
||||
"owner": "feature-frontend-contract-schema-registry",
|
||||
"source": "src/features/installed-feature-contracts.ts",
|
||||
"source": "src/features/loaded-feature-runtimes.ts",
|
||||
"rowCount": 8,
|
||||
"contract": {
|
||||
"requiredFields": [
|
||||
@@ -553,7 +571,8 @@
|
||||
"route-search",
|
||||
"route-search-api-request",
|
||||
"api-request",
|
||||
"api-response"
|
||||
"api-response",
|
||||
"api-problem"
|
||||
],
|
||||
"runtime": [
|
||||
"zod"
|
||||
@@ -583,21 +602,21 @@
|
||||
"runtime": "zod",
|
||||
"schemaId": "none"
|
||||
},
|
||||
"NoRequest": {
|
||||
"boundary": "api-request",
|
||||
"direction": "REQUEST",
|
||||
"owner": "feature-frontend-reference-feature-vertical-slice",
|
||||
"runtime": "zod",
|
||||
"schemaId": "NoRequest",
|
||||
"schemaVersion": 1,
|
||||
"unknownFieldPolicy": "REJECT_UNKNOWN"
|
||||
},
|
||||
"NotFoundSplat": {
|
||||
"boundary": "route-params",
|
||||
"owner": "feature-frontend-routing-release-recovery-runtime",
|
||||
"runtime": "zod",
|
||||
"schemaId": "NotFoundSplat"
|
||||
},
|
||||
"ReferenceProblem": {
|
||||
"boundary": "api-problem",
|
||||
"direction": "RESPONSE",
|
||||
"owner": "feature-frontend-reference-feature-vertical-slice",
|
||||
"runtime": "zod",
|
||||
"schemaId": "ReferenceProblem",
|
||||
"schemaVersion": 1,
|
||||
"unknownFieldPolicy": "STRIP_UNKNOWN"
|
||||
},
|
||||
"ReferenceResourceListPayload": {
|
||||
"boundary": "api-response",
|
||||
"direction": "RESPONSE",
|
||||
@@ -640,7 +659,7 @@
|
||||
"registryId": "FE-REG-ENV",
|
||||
"owner": "feature-frontend-env-runtime-config-contract",
|
||||
"source": "src/contracts/env.ts",
|
||||
"rowCount": 16,
|
||||
"rowCount": 18,
|
||||
"contract": {
|
||||
"requiredFields": [
|
||||
"phase",
|
||||
@@ -652,7 +671,7 @@
|
||||
"phase": "string",
|
||||
"classification": "string",
|
||||
"required": "boolean",
|
||||
"defaultValue": "string|integer|boolean|null"
|
||||
"defaultValue": "string|integer|boolean|object|null"
|
||||
},
|
||||
"uniqueFields": [],
|
||||
"allowedValues": {
|
||||
@@ -690,13 +709,24 @@
|
||||
},
|
||||
"AUTH_MODE": {
|
||||
"classification": "public",
|
||||
"defaultValue": "external",
|
||||
"defaultValue": null,
|
||||
"phase": "runtime",
|
||||
"required": true
|
||||
},
|
||||
"BUILD_ID": {
|
||||
"classification": "public-metadata",
|
||||
"defaultValue": null,
|
||||
"phase": "runtime",
|
||||
"required": false
|
||||
},
|
||||
"CAPABILITY_OVERRIDES": {
|
||||
"classification": "public",
|
||||
"defaultValue": null,
|
||||
"defaultValue": {
|
||||
"OFFLINE_COMMANDS": "DEFAULT",
|
||||
"REALTIME": "DEFAULT",
|
||||
"SERVICE_WORKER": "DEFAULT",
|
||||
"WEB_WORKER": "DEFAULT"
|
||||
},
|
||||
"phase": "runtime",
|
||||
"required": false
|
||||
},
|
||||
@@ -708,7 +738,7 @@
|
||||
},
|
||||
"FEATURE_OVERRIDES": {
|
||||
"classification": "public",
|
||||
"defaultValue": null,
|
||||
"defaultValue": {},
|
||||
"phase": "runtime",
|
||||
"required": false
|
||||
},
|
||||
@@ -718,11 +748,17 @@
|
||||
"phase": "runtime",
|
||||
"required": false
|
||||
},
|
||||
"RELEASE_ID": {
|
||||
"classification": "public-metadata",
|
||||
"defaultValue": null,
|
||||
"phase": "runtime",
|
||||
"required": false
|
||||
},
|
||||
"RELEASE_MANIFEST_URL": {
|
||||
"classification": "public",
|
||||
"defaultValue": "/release-manifest.json",
|
||||
"phase": "runtime",
|
||||
"required": true
|
||||
"required": false
|
||||
},
|
||||
"REQUEST_TIMEOUT_MS": {
|
||||
"classification": "public",
|
||||
@@ -732,7 +768,7 @@
|
||||
},
|
||||
"TELEMETRY_ENABLED": {
|
||||
"classification": "public",
|
||||
"defaultValue": false,
|
||||
"defaultValue": null,
|
||||
"phase": "runtime",
|
||||
"required": true
|
||||
},
|
||||
@@ -744,7 +780,7 @@
|
||||
},
|
||||
"VITE_BUILD_ID": {
|
||||
"classification": "public-metadata",
|
||||
"defaultValue": null,
|
||||
"defaultValue": "local-build",
|
||||
"phase": "build",
|
||||
"required": true
|
||||
},
|
||||
@@ -812,7 +848,8 @@
|
||||
"sessionStorage",
|
||||
"localStorage",
|
||||
"disabled",
|
||||
"forbidden"
|
||||
"forbidden",
|
||||
"external"
|
||||
],
|
||||
"classification": [
|
||||
"public-preference",
|
||||
@@ -860,7 +897,7 @@
|
||||
"valueCodec": "none"
|
||||
},
|
||||
"CACHE_INVALIDATION_PULSE": {
|
||||
"backend": "localStorage",
|
||||
"backend": "external",
|
||||
"classification": "opaque-cache",
|
||||
"logicalName": "CACHE_INVALIDATION_PULSE",
|
||||
"migration": "discard",
|
||||
@@ -870,7 +907,7 @@
|
||||
"schemaVersion": 1,
|
||||
"scope": "cache-invalidation",
|
||||
"ttl": null,
|
||||
"valueCodec": "opaque-string-v1"
|
||||
"valueCodec": "none"
|
||||
},
|
||||
"CHUNK_RELOAD_GUARD": {
|
||||
"backend": "sessionStorage",
|
||||
@@ -1327,7 +1364,7 @@
|
||||
"registryId": "FE-REG-TELEMETRY",
|
||||
"owner": "feature-frontend-diagnostics-telemetry-runtime",
|
||||
"source": "src/contracts/telemetry.ts",
|
||||
"rowCount": 5,
|
||||
"rowCount": 6,
|
||||
"contract": {
|
||||
"requiredFields": [
|
||||
"eventName",
|
||||
@@ -1385,6 +1422,7 @@
|
||||
],
|
||||
"optionalAttributes": [
|
||||
"duration_bucket",
|
||||
"effect_certainty",
|
||||
"operation_id"
|
||||
],
|
||||
"requiredAttributes": [
|
||||
@@ -1450,6 +1488,32 @@
|
||||
"sampling": "all",
|
||||
"trigger": "release tuple mismatch"
|
||||
},
|
||||
"service-worker.start.failed": {
|
||||
"delivery": "best-effort",
|
||||
"eventName": "service-worker.start.failed",
|
||||
"forbiddenAttributes": [
|
||||
"access_token",
|
||||
"authorization_header",
|
||||
"cookie",
|
||||
"email",
|
||||
"query_string",
|
||||
"raw_url",
|
||||
"raw_user_id",
|
||||
"refresh_token",
|
||||
"request_body",
|
||||
"response_body",
|
||||
"stack_in_user_message",
|
||||
"storage_value",
|
||||
"user_name"
|
||||
],
|
||||
"optionalAttributes": [],
|
||||
"requiredAttributes": [
|
||||
"build_id",
|
||||
"error_kind"
|
||||
],
|
||||
"sampling": "all",
|
||||
"trigger": "Service Worker start ended FAILED or INCOMPATIBLE"
|
||||
},
|
||||
"telemetry.delivery.dropped": {
|
||||
"delivery": "best-effort",
|
||||
"eventName": "telemetry.delivery.dropped",
|
||||
|
||||
@@ -1,125 +1,4 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"changes": [
|
||||
{
|
||||
"changeId": "FE-REG-ENV:API_CONTRACT_VERSION:*:removed",
|
||||
"versionBump": "Runtime Config V2 (CONFIG_SCHEMA_VERSION 2.0) removes the scalar API contract version.",
|
||||
"migration": "Release Manifest V2 contractSet replaces the scalar: the compiled external contract package set is canonicalized and digested, and boot compares it against the manifest.",
|
||||
"compatibilityWindow": "The V1 config and V1 manifest readers stay in place for one release. A V1 document may still carry the scalar; a V2 document is rejected if it does.",
|
||||
"rollback": "Restore the V1 writer in scripts/generate-build-manifest.ts and the scalar key in public/config.json; the V1 reader is still present.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-QUERY:*:*:removed",
|
||||
"versionBump": "Query invalidation composition moves from the legacy flat query registry to the bounded many-to-many invalidation graph.",
|
||||
"migration": "Installed feature contracts now contribute topics, namespace identities, edges, and separate wire versions; bootstrap validates and indexes those contributions before constructing coordinators.",
|
||||
"compatibilityWindow": "Cross-context envelopes remain opaque topic/version pairs and release cache epochs isolate mixed releases; no query keys or cached values cross contexts.",
|
||||
"rollback": "Restore the flat QUERY_REGISTRY composition and its coordinator adapter together with the prior governance entry.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-QUERY:$contract:allowedValues:contract-field-changed",
|
||||
"versionBump": "Cross-context invalidation wire protocol starts at version 1.",
|
||||
"migration": "Every installed query row declares invalidate-only; older tabs remain local-only.",
|
||||
"compatibilityWindow": "Mixed releases are isolated by release cacheEpoch and never exchange query keys or values.",
|
||||
"rollback": "Remove the coordinator composition and the two query registry fields.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-QUERY:$contract:breakingFields:contract-field-changed",
|
||||
"versionBump": "Cross-context invalidation wire protocol starts at version 1.",
|
||||
"migration": "Every installed query row declares its opaque topic and transport policy.",
|
||||
"compatibilityWindow": "A release cacheEpoch rejects messages from a different deployed contract.",
|
||||
"rollback": "Remove the coordinator composition and restore the prior query registry contract.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-QUERY:$contract:fieldTypes:contract-field-changed",
|
||||
"versionBump": "Cross-context invalidation wire protocol starts at version 1.",
|
||||
"migration": "The installed reference query row and all consumers were updated atomically.",
|
||||
"compatibilityWindow": "Old clients do not consume the new fields; new clients validate them before boot.",
|
||||
"rollback": "Restore the previous query registry field types and local-only invalidation.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-QUERY:$contract:requiredFields:contract-field-changed",
|
||||
"versionBump": "Cross-context invalidation wire protocol starts at version 1.",
|
||||
"migration": "Missing topics now fail registry validation instead of silently degrading at runtime.",
|
||||
"compatibilityWindow": "Only a fully built release consumes its own installed registry snapshot.",
|
||||
"rollback": "Remove the newly required fields and cross-context composition together.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-QUERY:$contract:uniqueFields:contract-field-changed",
|
||||
"versionBump": "Cross-context invalidation wire protocol starts at version 1.",
|
||||
"migration": "Existing query namespaces received unique registry-issued opaque topics.",
|
||||
"compatibilityWindow": "Topics are scoped by release cacheEpoch, so mixed releases cannot collide.",
|
||||
"rollback": "Drop invalidationTopic uniqueness after removing the transport consumer.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-RELEASE:apiContractVersion:compatibilityRole:field-changed",
|
||||
"versionBump": "The release token registry adds contractSetDigest and demotes apiContractVersion to a legacy V1 scalar.",
|
||||
"migration": "compareReleaseToRuntime no longer sources the scalar from Runtime Config; when neither side declares it there is nothing to compare and contractSet verification owns contract coherence.",
|
||||
"compatibilityWindow": "A V1 manifest still supplies apiContractVersion and is still compared against a V1 config that declares one.",
|
||||
"rollback": "Restore the previous compatibilityRole text and remove the contractSetDigest token together with the V2 manifest writer.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-STORAGE:$contract:allowedValues:contract-field-changed",
|
||||
"versionBump": "Web Storage value codec contracts start at version 1.",
|
||||
"migration": "Existing keys retain their physical schema version; values outside the selected codec are discarded.",
|
||||
"compatibilityWindow": "Valid existing color-scheme and opaque-string records remain readable.",
|
||||
"rollback": "Restore the previous registry contract; no physical key deletion is required.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-STORAGE:$contract:breakingFields:contract-field-changed",
|
||||
"versionBump": "Web Storage value codec contracts start at version 1.",
|
||||
"migration": "Each existing row received an explicit codec; executable migration was never consumed and is now forbidden.",
|
||||
"compatibilityWindow": "Schema-versioned physical keys and the envelope shape remain unchanged.",
|
||||
"rollback": "Remove valueCodec enforcement and restore the prior metadata declaration.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-STORAGE:$contract:fieldTypes:contract-field-changed",
|
||||
"versionBump": "Web Storage value codec contracts start at version 1.",
|
||||
"migration": "The dead function migration union was narrowed to the only implemented discard policy.",
|
||||
"compatibilityWindow": "All installed definitions already used discard before this contract change.",
|
||||
"rollback": "Restore the former type metadata without rewriting persisted records.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-STORAGE:$contract:requiredFields:contract-field-changed",
|
||||
"versionBump": "Web Storage value codec contracts start at version 1.",
|
||||
"migration": "All installed storage rows now declare their closed value codec.",
|
||||
"compatibilityWindow": "Existing valid envelopes continue to decode; invalid values fail closed.",
|
||||
"rollback": "Remove the required codec field and runtime codec dispatch together.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-ERROR:QUERY_CACHE_FAILURE:telemetryEvent:field-changed",
|
||||
"versionBump": "Error taxonomy observability references became the closed union of registered diagnostic and telemetry event ids (extreme-scale Phase 4 ledger, 2026-09-23).",
|
||||
"migration": "QUERY_CACHE_FAILURE pointed at the unregistered event id query.cache.failed; it now references the registered cache.operation.failed diagnostic event that the query cache adapter actually emits.",
|
||||
"compatibilityWindow": "No wire, storage or runtime-config format changes: the old id was never emitted by any producer, so no consumer could observe it.",
|
||||
"rollback": "Restore the previous telemetryEvent string on QUERY_CACHE_FAILURE in src/contracts/errors.ts and widen ErrorObservationEvent back to string.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-ENV:VITE_BUILD_ID:defaultValue:field-type-changed",
|
||||
"versionBump": "F-6 (13-15): the registry now records the local-build fallback that getBuildConfig and the build scripts already applied; the value itself did not change.",
|
||||
"migration": "None for local builds. A staging or production build without VITE_BUILD_ID now fails in scripts/generate-runtime-config.ts instead of shipping the placeholder that admission refused.",
|
||||
"compatibilityWindow": "No runtime document or wire format changes: BUILD_ID was already local-build whenever VITE_BUILD_ID was unset.",
|
||||
"rollback": "Restore defaultValue null on VITE_BUILD_ID in src/contracts/env.ts and drop the public-target check in scripts/generate-runtime-config.ts.",
|
||||
"owner": "frontend-platform"
|
||||
},
|
||||
{
|
||||
"changeId": "FE-REG-ROUTE:REFERENCE_RESOURCE_DETAIL:path:field-changed",
|
||||
"versionBump": "The reference detail route moves from /examples/reference-resources/:resourceId to /examples/reference-resources/items/:resourceId (maturity review 08-13), so a server id equal to the static segments new or status opens its detail instead of the form or status screen.",
|
||||
"migration": "The only in-app link (reference-resource-page.tsx) builds the new path from the contract route. The reference feature is a sample; downstream features that copied it keep their own paths.",
|
||||
"compatibilityWindow": "None for bookmarked sample detail URLs: an old /examples/reference-resources/<id> URL no longer matches the detail route; new and status keep opening the form and status screens.",
|
||||
"rollback": "Restore the previous path in src/features/reference-feature/contracts/reference-feature-contract.ts and the link in reference-resource-page.tsx, then drop this entry.",
|
||||
"owner": "frontend-platform"
|
||||
}
|
||||
]
|
||||
"changes": []
|
||||
}
|
||||
|
||||
@@ -41,23 +41,15 @@
|
||||
"uniqueFields": ["routeId", "path", "chunkId"],
|
||||
"allowedValues": {
|
||||
"access": ["public", "session-required"],
|
||||
"paramsSchema": [null, "NotFoundSplat", "ReferenceResourceParams"],
|
||||
"searchSchema": [null, "ReferenceResourceListQuery"],
|
||||
"loadingSurface": [
|
||||
"app-shell",
|
||||
"example-page",
|
||||
"reference-resource-list",
|
||||
"reference-resource-detail",
|
||||
"reference-resource-form",
|
||||
"reference-resource-status",
|
||||
"none"
|
||||
],
|
||||
"errorSurface": [
|
||||
"route-boundary",
|
||||
"feature-boundary",
|
||||
"not-found"
|
||||
]
|
||||
},
|
||||
"fieldPatterns": {
|
||||
"loadingSurface": "^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$"
|
||||
},
|
||||
"references": [
|
||||
{
|
||||
"field": "routeId",
|
||||
@@ -141,43 +133,89 @@
|
||||
},
|
||||
{
|
||||
"registryId": "FE-REG-API",
|
||||
"path": "src/features/installed-feature-contracts.ts",
|
||||
"path": "src/features/loaded-feature-runtimes.ts",
|
||||
"exportName": "API_OPERATIONS",
|
||||
"owner": "feature-frontend-api-client-response-envelope-contract",
|
||||
"keyField": "operationId",
|
||||
"requiredFields": [
|
||||
"operationId",
|
||||
"featureId",
|
||||
"method",
|
||||
"path",
|
||||
"operationId",
|
||||
"auth",
|
||||
"timeoutMs",
|
||||
"idempotency",
|
||||
"retry",
|
||||
"requestSource",
|
||||
"authProfileId",
|
||||
"retrySemantics",
|
||||
"requestBody",
|
||||
"responseBody",
|
||||
"responseEnvelope",
|
||||
"requestSchema",
|
||||
"responseSchema",
|
||||
"owner"
|
||||
"problemSchema",
|
||||
"acceptedStatuses",
|
||||
"emptyBodyStatuses",
|
||||
"unvalidated",
|
||||
"requestByteLimit",
|
||||
"responseByteLimit",
|
||||
"totalDeadlineMs",
|
||||
"retryBudget",
|
||||
"traffic",
|
||||
"commandEffect",
|
||||
"commandRecovery"
|
||||
],
|
||||
"fieldTypes": {
|
||||
"operationId": "string",
|
||||
"featureId": "string",
|
||||
"method": "string",
|
||||
"path": "string",
|
||||
"operationId": "string",
|
||||
"auth": "string",
|
||||
"timeoutMs": "integer|null",
|
||||
"idempotency": "string",
|
||||
"retry": "string",
|
||||
"requestSource": "string",
|
||||
"authProfileId": "string",
|
||||
"retrySemantics": "string",
|
||||
"requestBody": "string",
|
||||
"responseBody": "string",
|
||||
"responseEnvelope": "string",
|
||||
"requestSchema": "string",
|
||||
"responseSchema": "string",
|
||||
"owner": "string"
|
||||
"problemSchema": "string",
|
||||
"acceptedStatuses": "array",
|
||||
"emptyBodyStatuses": "array",
|
||||
"unvalidated": "array",
|
||||
"requestByteLimit": "integer",
|
||||
"responseByteLimit": "integer",
|
||||
"totalDeadlineMs": "integer",
|
||||
"retryBudget": "integer",
|
||||
"traffic": "object|null",
|
||||
"commandEffect": "object|null",
|
||||
"commandRecovery": "object|null"
|
||||
},
|
||||
"uniqueFields": ["operationId"],
|
||||
"uniqueFields": [
|
||||
"operationId"
|
||||
],
|
||||
"allowedValues": {
|
||||
"method": ["GET", "POST", "PUT", "PATCH", "DELETE"],
|
||||
"auth": ["none", "external-session"],
|
||||
"idempotency": ["safe", "keyed", "none"],
|
||||
"retry": ["runtime", "never"],
|
||||
"requestSource": ["none", "search", "body"]
|
||||
"method": [
|
||||
"GET",
|
||||
"HEAD",
|
||||
"POST",
|
||||
"PUT",
|
||||
"PATCH",
|
||||
"DELETE"
|
||||
],
|
||||
"retrySemantics": [
|
||||
"SAFE",
|
||||
"IDEMPOTENT",
|
||||
"KEYED",
|
||||
"NEVER"
|
||||
],
|
||||
"requestBody": [
|
||||
"NONE",
|
||||
"JSON"
|
||||
],
|
||||
"responseBody": [
|
||||
"REQUIRED_JSON",
|
||||
"OPTIONAL_JSON",
|
||||
"NONE"
|
||||
],
|
||||
"responseEnvelope": [
|
||||
"NONE",
|
||||
"ENVELOPE_V1"
|
||||
]
|
||||
},
|
||||
"references": [
|
||||
{
|
||||
@@ -189,6 +227,11 @@
|
||||
"field": "responseSchema",
|
||||
"registryId": "FE-REG-SCHEMA",
|
||||
"targetField": "schemaId"
|
||||
},
|
||||
{
|
||||
"field": "problemSchema",
|
||||
"registryId": "FE-REG-SCHEMA",
|
||||
"targetField": "schemaId"
|
||||
}
|
||||
],
|
||||
"consumerIdentityField": "operationId",
|
||||
@@ -197,19 +240,23 @@
|
||||
"src/features/*/application"
|
||||
],
|
||||
"breakingFields": [
|
||||
"operationId",
|
||||
"method",
|
||||
"path",
|
||||
"operationId",
|
||||
"auth",
|
||||
"idempotency",
|
||||
"requestSource",
|
||||
"authProfileId",
|
||||
"retrySemantics",
|
||||
"requestBody",
|
||||
"responseBody",
|
||||
"responseEnvelope",
|
||||
"requestSchema",
|
||||
"responseSchema"
|
||||
"responseSchema",
|
||||
"problemSchema",
|
||||
"unvalidated"
|
||||
]
|
||||
},
|
||||
{
|
||||
"registryId": "FE-REG-SCHEMA",
|
||||
"path": "src/features/installed-feature-contracts.ts",
|
||||
"path": "src/features/loaded-feature-runtimes.ts",
|
||||
"exportName": "SCHEMA_REGISTRY",
|
||||
"owner": "feature-frontend-contract-schema-registry",
|
||||
"keyField": "schemaId",
|
||||
@@ -227,7 +274,8 @@
|
||||
"route-search",
|
||||
"route-search-api-request",
|
||||
"api-request",
|
||||
"api-response"
|
||||
"api-response",
|
||||
"api-problem"
|
||||
],
|
||||
"runtime": ["zod"]
|
||||
},
|
||||
@@ -249,7 +297,7 @@
|
||||
"phase": "string",
|
||||
"classification": "string",
|
||||
"required": "boolean",
|
||||
"defaultValue": "string|integer|boolean|null"
|
||||
"defaultValue": "string|integer|boolean|object|null"
|
||||
},
|
||||
"allowedValues": {
|
||||
"phase": ["build", "runtime"],
|
||||
@@ -307,7 +355,8 @@
|
||||
"sessionStorage",
|
||||
"localStorage",
|
||||
"disabled",
|
||||
"forbidden"
|
||||
"forbidden",
|
||||
"external"
|
||||
],
|
||||
"classification": [
|
||||
"public-preference",
|
||||
@@ -366,7 +415,7 @@
|
||||
},
|
||||
"consumers": [
|
||||
{
|
||||
"path": "src/adapters/http/client.ts",
|
||||
"path": "src/adapters/http/feature-http-binding.ts",
|
||||
"token": "failure("
|
||||
}
|
||||
],
|
||||
|
||||
@@ -1,5 +1,8 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"transport": {
|
||||
"alpnProtocols": ["h2"]
|
||||
},
|
||||
"surfaces": {
|
||||
"index": {
|
||||
"path": "/",
|
||||
@@ -23,10 +26,24 @@
|
||||
"pathPattern": "/assets/*",
|
||||
"cacheControl": "public, max-age=31536000, immutable",
|
||||
"contentTypes": ["text/javascript", "application/javascript"],
|
||||
"contentEncodings": ["br", "gzip", "zstd"],
|
||||
"securityHeaders": false
|
||||
},
|
||||
"sourceMap": {
|
||||
"public": false
|
||||
},
|
||||
"appRoute": {
|
||||
"path": "/__probe/deep-link",
|
||||
"cacheControl": "no-cache",
|
||||
"contentTypes": ["text/html"],
|
||||
"securityHeaders": true
|
||||
},
|
||||
"serviceWorker": {
|
||||
"path": "/service-worker.js",
|
||||
"requiredWhen": "service-worker-shipped",
|
||||
"cacheControl": "no-cache",
|
||||
"contentTypes": ["text/javascript", "application/javascript"],
|
||||
"securityHeaders": false
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
@@ -33,6 +33,21 @@
|
||||
},
|
||||
"hashedAsset": {
|
||||
"cache-control": "public, max-age=31536000, immutable",
|
||||
"content-type": "text/javascript; charset=utf-8",
|
||||
"content-encoding": "gzip"
|
||||
},
|
||||
"appRoute": {
|
||||
"cache-control": "no-cache",
|
||||
"content-type": "text/html; charset=utf-8",
|
||||
"content-security-policy": "default-src 'self'; base-uri 'self'; object-src 'none'; frame-ancestors 'none'; form-action 'self'; script-src 'self'; style-src 'self'; img-src 'self' data:; connect-src 'self' https:; font-src 'self'; upgrade-insecure-requests",
|
||||
"strict-transport-security": "max-age=31536000; includeSubDomains",
|
||||
"x-frame-options": "DENY",
|
||||
"referrer-policy": "strict-origin-when-cross-origin",
|
||||
"x-content-type-options": "nosniff",
|
||||
"permissions-policy": "camera=(), microphone=(), geolocation=()"
|
||||
},
|
||||
"serviceWorker": {
|
||||
"cache-control": "no-cache",
|
||||
"content-type": "text/javascript; charset=utf-8"
|
||||
}
|
||||
}
|
||||
|
||||
@@ -2,6 +2,7 @@
|
||||
"schemaVersion": 1,
|
||||
"bundle": {
|
||||
"initialJsGzipBytes": 204800,
|
||||
"initialJsFiles": 32,
|
||||
"lazyChunkGzipBytes": 122880
|
||||
},
|
||||
"lab": {
|
||||
|
||||
@@ -67,7 +67,7 @@
|
||||
"lifecycleMethods": ["close-or-dispose", "unsubscribe", "cancel-via-AbortSignal", "bounded-poll-lease", "revoke-push-association"],
|
||||
"owner": "project-owner-required",
|
||||
"securityPrivacy": ["Validate every event envelope and closed transport frame before application effects.", "Bind stream state to the current opaque scope generation and advance checkpoints only after committed effects or authoritative recovery.", "Use fixed same-origin endpoints and an exact WebSocket subprotocol; never place credentials, cursors, subscription material or scope bindings in URLs or telemetry.", "Treat Web Push as a notification hint, fence registration and revocation with one durable compare-and-swap control record, and allow only registry-owned notification and route intents.", "Keep every queue, parser, reconnect, poll, notification and storage operation bounded and abortable."],
|
||||
"bundleBudgetGzipBytes": 40900,
|
||||
"bundleBudgetGzipBytes": 42200,
|
||||
"fallback": "Bounded polling or explicitly stale UI.",
|
||||
"removal": ["Disable admission and close active readers, sockets, poll leases and worker handlers.", "Revoke and purge only the owned Web Push association and notification state.", "Remove composition, registries, adapters and any selected vendor dependency.", "Run realtime boundary, runtime-removal and production-bundle gates."],
|
||||
"serverStatePolicy": "query-cache-owned"
|
||||
@@ -104,12 +104,12 @@
|
||||
"forbiddenWhen": ["The data contains credentials.", "The browser would connect directly to a server database or object store.", "A normal HTTP cache is sufficient.", "Partition, retention, quota and recovery ownership are undefined."],
|
||||
"boundary": "feature-specific async repository with registry-issued opaque dataset scope and immutable full-policy binding, plus an OPFS large-object sidecar whose logical commit authority and bidirectional scope binding are owned by an IndexedDB journal",
|
||||
"port": "IndexedDbRepositoryPort / IndexedDbMaintenancePort / DurableObjectStorePort / DurableObjectMaintenancePort / StorageDurabilityPort",
|
||||
"fake": "MemoryStructuredOfflineStore / MemoryDurableObjectStore / MemoryStorageDurabilityAdapter",
|
||||
"fake": "MemoryDurableObjectStore / MemoryStorageDurabilityAdapter (no recipe fake implements IndexedDbRepositoryPort; run the reference runtime on tests/helpers/memory-indexeddb.ts)",
|
||||
"failureKinds": ["open-blocked", "versionchange", "quota", "corruption", "migration-rollback", "revision-conflict", "storage-eviction", "partial-object-write", "dataset-binding-mismatch", "dataset-budget-exceeded", "lifecycle-authorization-denied", "expired-resource"],
|
||||
"lifecycleMethods": ["close", "cancel-via-AbortSignal", "enforce-bounded-lifecycle-batch", "prune-expired-receipts", "reconcile", "enforcePolicies-with-composition-authority"],
|
||||
"owner": "project-owner-required",
|
||||
"securityPrivacy": ["Classify every persisted field and binary namespace.", "Encrypting in the same client is not a credential protection boundary.", "Keep database schema and record codec versions separate.", "Derive the physical IndexedDB name only from registry-issued authority, namespace and partition tokens; readable namespace, business and account IDs are forbidden.", "Persist and revalidate an immutable scope plus full BrowserStoragePolicy binding during upgrade, post-open and maintenance; missing or mismatched existing bindings fail closed.", "Use the actual IndexedDB wire split: StoredRecord contains only key, codecVersion, revision and payload; writtenAtEpochMs, synchronization, measuredBytes and eligibleAtEpochMs belong to the retention sidecar, while idempotency receipts and governance binding/budget use separate stores.", "Include every store registered in lifecycleMetadataStores in bounded full-partition purge while retaining immutable governance identity.", "Measure conservative logical bytes through the codec and atomically enforce dataset usedBytes plus receiptCount with record, lifecycle and migration writes.", "Enforce TTL before sweep visibility, delete UNTIL_SYNCED only after explicit confirmation, and require a composition-authorized short-lived proof for every deleting IndexedDB lifecycle batch.", "Bound idempotency receipt retention to 31 days and configured count to the implementation ceiling of 1000000; bound migration to old-writer-drained batches no larger than 500 rows or 30000ms.", "Bind OPFS readable and physical scopes in both directions and use only /ca-frontend-opfs-v1/authorities/<authorityToken>/<namespaceToken>/<partitionToken>/ for physical dataset layout.", "For OPFS LOGOUT, UNTIL_SYNCED and ACCOUNT_DELETION maintenance, composition must provide both requestMaintenanceAuthority and consumeMaintenanceAuthority; issue a fresh proof bound to the exact frozen reason, scope and policy for at most five minutes, then atomically consume it to reject replay.", "Never expose an OPFS authority proof through the application request, persistence, diagnostics or telemetry.", "Never place user file names or identifiers in OPFS paths or diagnostics."],
|
||||
"bundleBudgetGzipBytes": 36900,
|
||||
"bundleBudgetGzipBytes": 38500,
|
||||
"fallback": "Read-only or online-only query path; OPFS may degrade to a size-capped IndexedDB Blob only when the product policy approves it.",
|
||||
"removal": ["Stop writes and background migration.", "Reconcile or export unsynced data, then purge only governance-bound owned partitions and OPFS namespaces through authorized bounded lifecycle operations.", "Close all database, channel, worker and file handles.", "Remove repository composition and dependency."],
|
||||
"serverStatePolicy": "reference-or-command-only"
|
||||
@@ -137,16 +137,16 @@
|
||||
],
|
||||
"productionComposition": false
|
||||
},
|
||||
"trigger": "Installability, a measured offline-shell requirement, or an explicitly owned public HTTP representation cache is approved.",
|
||||
"trigger": "Installability or an explicitly owned public HTTP representation cache is approved. The reference worker keeps navigation network-only and has no offline shell; an offline document is a separate product capability (closed deep design 18.8).",
|
||||
"forbiddenWhen": ["Hosting cache and worker cache ownership conflict.", "Update and rollback UX is undefined.", "Authenticated, private, opaque or personal responses would be cached.", "Cache freshness, byte and entry limits are undefined."],
|
||||
"boundary": "bootstrap update controller plus platform-local public Request/Response cache administration",
|
||||
"port": "ServiceWorkerUpdatePort / PublicResponseCacheAdmin recipe / PublicResponseCachePort / PublicResponseCacheAdminPort reference runtime",
|
||||
"fake": "FakeServiceWorkerUpdateAdapter / MemoryPublicResponseCache",
|
||||
"failureKinds": ["stale-worker", "update-loop", "offline-fallback", "incomplete-candidate", "integrity-mismatch", "cache-policy-rejection", "quota"],
|
||||
"failureKinds": ["stale-worker", "update-loop", "offline-navigation-network-error", "incomplete-candidate", "integrity-mismatch", "cache-policy-rejection", "quota"],
|
||||
"lifecycleMethods": ["unregister", "rollback", "delete-owned-caches"],
|
||||
"owner": "project-owner-required",
|
||||
"securityPrivacy": ["Cache only explicit same-origin public GET representations.", "Never cache authenticated, cookie-dependent, private, no-store, opaque or personal responses.", "Bind candidate cache names to release identity and a canonical manifest digest that includes normalized expectedContentType, exact request identity, expected byte length and integrity digest.", "Reject a response whose normalized Content-Type differs from manifest expectedContentType even when body integrity matches.", "Derive cleanup retention only from the verified active pointer and composition retainedPreviousReleaseCount; cleanup callers cannot submit cache names, release registry IDs or any retain set.", "Read active-pointer and release-marker control JSON through a strict UTF-8 stream capped at exactly 2 MiB (2097152 bytes), cancel on overflow and fail closed before parsing oversized metadata.", "Keep exact query and Vary semantics; ignoreSearch and ignoreVary are forbidden.", "Fail closed on malformed update metadata or integrity mismatch."],
|
||||
"bundleBudgetGzipBytes": 10000,
|
||||
"bundleBudgetGzipBytes": 10100,
|
||||
"fallback": "Normal network application with hosting cache headers.",
|
||||
"removal": ["Deploy an unregister migration.", "Delete only parsed, owned cache namespaces after old controlled clients drain.", "Remove worker registration, cache metadata and manifest."],
|
||||
"serverStatePolicy": "network-cache-policy-only"
|
||||
@@ -195,8 +195,8 @@
|
||||
"lifecycleMethods": ["release-file-ref", "release-or-dispose-preview-leases", "cancel-via-AbortSignal", "reconcile-or-explicitly-abort-upload", "close-checkpoint-store", "dispose-capability-and-image-runtime", "dispose-browser-file-runtime-on-logout-or-account-switch"],
|
||||
"owner": "project-owner-required",
|
||||
"securityPrivacy": ["Treat file name, extension, MIME and lastModified as untrusted metadata.", "Resolve only exact composition-issued file and image policy object identities; callers cannot raise byte, candidate, pixel, quality, format, lifetime or origin ceilings.", "Use opaque file references and verification receipts bound to an inspected immutable file snapshot and the exact registered profile; reject replay through another profile even when an inspection rule ID matches.", "Treat presigned URLs as bearer capabilities; bind exact method, resource or upload part, offset, length, media type, checksum, origin, path, query, headers and expiry in an in-memory identity vault.", "Use credentials omit, redirect error, no-referrer and no-store for direct data-plane fetch; never persist or observe URL, query, signed header, capability, file name or raw backend message, and never emit digest, raw ETag or receipt values to diagnostics or telemetry.", "A strict account-partitioned upload checkpoint may persist only the protocol-defined SHA-256 file fingerprint, per-part checksum and bounded opaque non-authorizing part receipt token required for server reconciliation; no bearer token or raw signed capability is allowed.", "Persist only strict non-authorizing upload checkpoints and reconcile them with server-authoritative status and re-hashed local parts before completion.", "Require a synchronous server-issued browser-managed download capability whose receipt exactly equals the caller's branded capability receipt and whose resource, media type, safe extension, maximum bytes, optional digest and expiry all match before handoff.", "Expose File, OPFS, Cache and transfer byte streams only as chunk-level closed Results; stop after the first failure, cancel native readers and never throw a raw native exception across the port.", "Accept Image CDN assets only through immutable allowlisted or signature-verified descriptors and registered preset identities; reject active formats, arbitrary transforms, pixel/decode-budget overflow and unsafe cache policy.", "Upload completion remains QUARANTINED until backend scan and promotion; client capability checks are not an authorization boundary.", "Active content preview requires isolation or download-only treatment."],
|
||||
"bundleBudgetGzipBytes": 55700,
|
||||
"fallback": "Accessible native file input, same-origin authorized server upload/download and a single bounded server-selected image rendition; generated artifacts above the buffer budget move to server-side generation.",
|
||||
"bundleBudgetGzipBytes": 57800,
|
||||
"fallback": "Accessible native file input, same-origin authorized server upload/download and a single bounded server-selected image rendition; generated artifacts above the buffer budget move to server-side generation. The paired backend template has no presigned or direct multipart server (removed 2026-09-25): with it, upload through its Fileserver (POST /v1/files) with createFileserverUploadClient from src/adapters/http.",
|
||||
"removal": ["Stop new capability and upload-session issuance, then cancel active reads and transfers.", "Reconcile or explicitly abort active multipart sessions and let backend TTL cleanup remove ambiguous orphans.", "Remove non-secret checkpoints according to account and retention policy.", "Release file references, revoke preview object-URL leases and dispose file, capability and image runtimes.", "Remove transfer/image feature facades and composition, then prove browser-transfer sources are absent from the production module inventory."],
|
||||
"serverStatePolicy": "query-cache-metadata-only"
|
||||
},
|
||||
|
||||
@@ -9,7 +9,7 @@
|
||||
"axes": [
|
||||
{
|
||||
"axis": "Typecheck of one app",
|
||||
"verified": "Linear, about 115k instantiations and 37 MB of tsc memory per feature, up to 100 features",
|
||||
"verified": "Linear, about 117k instantiations and 36 MB of tsc memory per feature, up to 100 features",
|
||||
"condition": "Reference-shaped features, tsconfig.app.json, the host recorded in the baseline",
|
||||
"notVerified": "200 features (one full context) and beyond; 4,000 (20 x 200) would need on the order of 150 GB by the same slope"
|
||||
},
|
||||
@@ -21,13 +21,13 @@
|
||||
},
|
||||
{
|
||||
"axis": "Initial JavaScript",
|
||||
"verified": "Grows by about 2.9 KB gzip and one file per feature: every installed feature's contracts and module load at boot",
|
||||
"condition": "Same",
|
||||
"notVerified": "The initial budget (204,800 B, config/performance/budgets.json) is exceeded after a few more reference-shaped features, far below the context ceiling"
|
||||
"verified": "15-01: only each feature's declaration (route table, messages, invalidation identities) loads at boot; its runtime half loads with its routes, and a copy adds no initial file. initialJavascript below is the current template build, what one more feature in an existing context adds (perFeatureGzipBytes) and what a new context adds (perContextGzipBytes); tests/unit/feature-shape-growth.test.ts measures them on every unit run, bounds a feature at 1 KiB and a context at 512 B, and fails when the record no longer matches the build. The 25- and 100-copy runs are in the baseline at its source commit (before 15-01: +3,922 B per copy)",
|
||||
"condition": "Same; the feature-declarations and feature-platform chunk groups in vite.config.ts",
|
||||
"notVerified": "How many more features fit: the initial budget (config/performance/budgets.json) minus initialJavascript.gzipBytes, divided by perFeatureGzipBytes (plus perContextGzipBytes per new context). The platform itself takes most of the budget"
|
||||
},
|
||||
{
|
||||
"axis": "Lazy JavaScript",
|
||||
"verified": "About 6.8 KB gzip and six files per feature, every file far below the 120 KiB lazy-chunk budget",
|
||||
"verified": "About 8.5 KB gzip and eight files per feature, every file far below the 120 KiB lazy-chunk budget",
|
||||
"condition": "Same",
|
||||
"notVerified": "Download cost of many lazy files"
|
||||
},
|
||||
@@ -37,5 +37,11 @@
|
||||
"condition": "Same",
|
||||
"notVerified": "Router matching cost at runtime"
|
||||
}
|
||||
]
|
||||
],
|
||||
"initialJavascript": {
|
||||
"gzipBytes": 202927,
|
||||
"files": 26,
|
||||
"perFeatureGzipBytes": 768,
|
||||
"perContextGzipBytes": 233
|
||||
}
|
||||
}
|
||||
|
||||
@@ -1,17 +1,24 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"measuredAt": "2026-09-27T04:03:00.821Z",
|
||||
"measuredAt": "2026-11-01T14:29:42.148Z",
|
||||
"command": "node scripts/scale/measure-feature-shape-growth.ts --sizes=0,25,100 --repeats=2",
|
||||
"environment": {
|
||||
"node": "24.14.0",
|
||||
"platform": "linux",
|
||||
"arch": "x64",
|
||||
"cpuModel": "Intel(R) Core(TM) i5-10400F CPU @ 2.90GHz",
|
||||
"logicalCpus": 12,
|
||||
"availableParallelism": 12,
|
||||
"cpuModel": "Intel(R) Core(TM) Ultra 7 155H",
|
||||
"logicalCpus": 22,
|
||||
"availableParallelism": 22,
|
||||
"typescript": "Version 7.0.2",
|
||||
"vite": "vite/8.1.5 linux-x64 node-v24.14.0"
|
||||
},
|
||||
"source": {
|
||||
"commit": "373b27b09c7c24c50ea81fca0238138f6b8189a8",
|
||||
"modifiedPaths": [
|
||||
"scripts/scale/measure-feature-shape-growth.ts",
|
||||
"tests/unit/feature-shape-growth.test.ts"
|
||||
]
|
||||
},
|
||||
"sourceFeature": "src/features/reference-feature",
|
||||
"runs": [
|
||||
{
|
||||
@@ -21,29 +28,29 @@
|
||||
"tsc": {
|
||||
"passed": true,
|
||||
"firstError": null,
|
||||
"files": 840,
|
||||
"types": 284678,
|
||||
"symbols": 802946,
|
||||
"instantiations": 712089,
|
||||
"memoryKb": 520454,
|
||||
"wallMs": 3408
|
||||
"files": 844,
|
||||
"types": 287435,
|
||||
"symbols": 794593,
|
||||
"instantiations": 721205,
|
||||
"memoryKb": 521732,
|
||||
"wallMs": 811
|
||||
},
|
||||
"build": {
|
||||
"wallMs": 1208,
|
||||
"initialJavascriptFiles": 13,
|
||||
"initialJavascriptGzipBytes": 200001,
|
||||
"lazyJavascriptFiles": 14,
|
||||
"lazyJavascriptGzipBytes": 24938
|
||||
"wallMs": 428,
|
||||
"initialJavascriptFiles": 16,
|
||||
"initialJavascriptGzipBytes": 203816,
|
||||
"lazyJavascriptFiles": 17,
|
||||
"lazyJavascriptGzipBytes": 28413
|
||||
},
|
||||
"loadBefore": [
|
||||
25.05,
|
||||
16.88,
|
||||
7.75
|
||||
2.97,
|
||||
7.82,
|
||||
8.57
|
||||
],
|
||||
"loadAfter": [
|
||||
26.4,
|
||||
17.3,
|
||||
7.93
|
||||
2.97,
|
||||
7.82,
|
||||
8.57
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -53,29 +60,29 @@
|
||||
"tsc": {
|
||||
"passed": true,
|
||||
"firstError": null,
|
||||
"files": 840,
|
||||
"types": 284678,
|
||||
"symbols": 802946,
|
||||
"instantiations": 712089,
|
||||
"memoryKb": 520395,
|
||||
"wallMs": 3930
|
||||
"files": 844,
|
||||
"types": 287435,
|
||||
"symbols": 794593,
|
||||
"instantiations": 721205,
|
||||
"memoryKb": 521779,
|
||||
"wallMs": 789
|
||||
},
|
||||
"build": {
|
||||
"wallMs": 1526,
|
||||
"initialJavascriptFiles": 13,
|
||||
"initialJavascriptGzipBytes": 200001,
|
||||
"lazyJavascriptFiles": 14,
|
||||
"lazyJavascriptGzipBytes": 24938
|
||||
"wallMs": 400,
|
||||
"initialJavascriptFiles": 16,
|
||||
"initialJavascriptGzipBytes": 203816,
|
||||
"lazyJavascriptFiles": 17,
|
||||
"lazyJavascriptGzipBytes": 28413
|
||||
},
|
||||
"loadBefore": [
|
||||
26.4,
|
||||
17.3,
|
||||
7.93
|
||||
2.97,
|
||||
7.82,
|
||||
8.57
|
||||
],
|
||||
"loadAfter": [
|
||||
27.65,
|
||||
17.71,
|
||||
8.12
|
||||
2.97,
|
||||
7.82,
|
||||
8.57
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -85,29 +92,29 @@
|
||||
"tsc": {
|
||||
"passed": true,
|
||||
"firstError": null,
|
||||
"files": 1366,
|
||||
"types": 1055723,
|
||||
"symbols": 2831441,
|
||||
"instantiations": 3579093,
|
||||
"memoryKb": 1422337,
|
||||
"wallMs": 8121
|
||||
"files": 1395,
|
||||
"types": 1062647,
|
||||
"symbols": 2897351,
|
||||
"instantiations": 3645516,
|
||||
"memoryKb": 1438408,
|
||||
"wallMs": 2362
|
||||
},
|
||||
"build": {
|
||||
"wallMs": 1676,
|
||||
"initialJavascriptFiles": 39,
|
||||
"initialJavascriptGzipBytes": 274493,
|
||||
"lazyJavascriptFiles": 165,
|
||||
"lazyJavascriptGzipBytes": 171638
|
||||
"wallMs": 556,
|
||||
"initialJavascriptFiles": 16,
|
||||
"initialJavascriptGzipBytes": 219508,
|
||||
"lazyJavascriptFiles": 218,
|
||||
"lazyJavascriptGzipBytes": 239901
|
||||
},
|
||||
"loadBefore": [
|
||||
27.65,
|
||||
17.71,
|
||||
8.12
|
||||
3.13,
|
||||
7.78,
|
||||
8.55
|
||||
],
|
||||
"loadAfter": [
|
||||
27.17,
|
||||
17.93,
|
||||
8.29
|
||||
3.13,
|
||||
7.78,
|
||||
8.55
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -117,29 +124,29 @@
|
||||
"tsc": {
|
||||
"passed": true,
|
||||
"firstError": null,
|
||||
"files": 1366,
|
||||
"types": 1055723,
|
||||
"symbols": 2831441,
|
||||
"instantiations": 3579093,
|
||||
"memoryKb": 1422431,
|
||||
"wallMs": 8714
|
||||
"files": 1395,
|
||||
"types": 1062647,
|
||||
"symbols": 2897351,
|
||||
"instantiations": 3645516,
|
||||
"memoryKb": 1438614,
|
||||
"wallMs": 2453
|
||||
},
|
||||
"build": {
|
||||
"wallMs": 2140,
|
||||
"initialJavascriptFiles": 39,
|
||||
"initialJavascriptGzipBytes": 274493,
|
||||
"lazyJavascriptFiles": 165,
|
||||
"lazyJavascriptGzipBytes": 171638
|
||||
"wallMs": 546,
|
||||
"initialJavascriptFiles": 16,
|
||||
"initialJavascriptGzipBytes": 219508,
|
||||
"lazyJavascriptFiles": 218,
|
||||
"lazyJavascriptGzipBytes": 239901
|
||||
},
|
||||
"loadBefore": [
|
||||
27.17,
|
||||
17.93,
|
||||
8.29
|
||||
3.13,
|
||||
7.78,
|
||||
8.55
|
||||
],
|
||||
"loadAfter": [
|
||||
27.55,
|
||||
18.46,
|
||||
8.62
|
||||
3.2,
|
||||
7.71,
|
||||
8.52
|
||||
]
|
||||
},
|
||||
{
|
||||
@@ -149,61 +156,61 @@
|
||||
"tsc": {
|
||||
"passed": true,
|
||||
"firstError": null,
|
||||
"files": 2941,
|
||||
"types": 3349868,
|
||||
"symbols": 8940533,
|
||||
"instantiations": 12157304,
|
||||
"memoryKb": 4195900,
|
||||
"wallMs": 31315
|
||||
"files": 3045,
|
||||
"types": 3373621,
|
||||
"symbols": 9115707,
|
||||
"instantiations": 12392128,
|
||||
"memoryKb": 4264554,
|
||||
"wallMs": 8403
|
||||
},
|
||||
"build": {
|
||||
"wallMs": 6010,
|
||||
"initialJavascriptFiles": 114,
|
||||
"initialJavascriptGzipBytes": 490658,
|
||||
"lazyJavascriptFiles": 615,
|
||||
"lazyJavascriptGzipBytes": 704938
|
||||
"wallMs": 944,
|
||||
"initialJavascriptFiles": 16,
|
||||
"initialJavascriptGzipBytes": 264841,
|
||||
"lazyJavascriptFiles": 818,
|
||||
"lazyJavascriptGzipBytes": 873479
|
||||
},
|
||||
"loadBefore": [
|
||||
27.43,
|
||||
18.59,
|
||||
3.2,
|
||||
7.71,
|
||||
8.52
|
||||
],
|
||||
"loadAfter": [
|
||||
6.72,
|
||||
8.32,
|
||||
8.71
|
||||
]
|
||||
},
|
||||
{
|
||||
"repeat": 2,
|
||||
"addedFeatures": 100,
|
||||
"routes": 410,
|
||||
"tsc": {
|
||||
"passed": true,
|
||||
"firstError": null,
|
||||
"files": 3045,
|
||||
"types": 3373621,
|
||||
"symbols": 9115707,
|
||||
"instantiations": 12392128,
|
||||
"memoryKb": 4263823,
|
||||
"wallMs": 9717
|
||||
},
|
||||
"build": {
|
||||
"wallMs": 933,
|
||||
"initialJavascriptFiles": 16,
|
||||
"initialJavascriptGzipBytes": 264841,
|
||||
"lazyJavascriptFiles": 818,
|
||||
"lazyJavascriptGzipBytes": 873479
|
||||
},
|
||||
"loadBefore": [
|
||||
6.72,
|
||||
8.32,
|
||||
8.71
|
||||
],
|
||||
"loadAfter": [
|
||||
29.72,
|
||||
20.12,
|
||||
9.64
|
||||
]
|
||||
},
|
||||
{
|
||||
"repeat": 2,
|
||||
"addedFeatures": 100,
|
||||
"routes": 410,
|
||||
"tsc": {
|
||||
"passed": true,
|
||||
"firstError": null,
|
||||
"files": 2941,
|
||||
"types": 3349868,
|
||||
"symbols": 8940533,
|
||||
"instantiations": 12157304,
|
||||
"memoryKb": 4195704,
|
||||
"wallMs": 43234
|
||||
},
|
||||
"build": {
|
||||
"wallMs": 3702,
|
||||
"initialJavascriptFiles": 114,
|
||||
"initialJavascriptGzipBytes": 490658,
|
||||
"lazyJavascriptFiles": 615,
|
||||
"lazyJavascriptGzipBytes": 704938
|
||||
},
|
||||
"loadBefore": [
|
||||
29.72,
|
||||
20.12,
|
||||
9.64
|
||||
],
|
||||
"loadAfter": [
|
||||
35.75,
|
||||
22.97,
|
||||
11.09
|
||||
6.3,
|
||||
8.17,
|
||||
8.66
|
||||
]
|
||||
}
|
||||
]
|
||||
|
||||
@@ -1,7 +1,7 @@
|
||||
{
|
||||
"schemaVersion": 1,
|
||||
"snapshotDigest": "ce4fa9b7944f27553067228bd6c9e73e7dc05875c283255b50d7eb3ad2923f6d",
|
||||
"owner": "frontend-platform",
|
||||
"reason": "RP-11-initial-transitive-inventory",
|
||||
"approvedAt": "2026-07-26T08:27:17.874Z"
|
||||
"snapshotDigest": "1be535686bed2315cc986f51b991b269c359ce1dca34d47faee6d35b0d57cfd3",
|
||||
"owner": "DongHyeonka",
|
||||
"reason": "1103/13-03 dev-only advisory fixes: vite 8.1.6, vitest and coverage-v8 4.1.12, storybook 10.6.5, in-range updates of undici, brace-expansion, nanoid, source-map-js, postcss",
|
||||
"approvedAt": "2026-11-04T13:27:48.076Z"
|
||||
}
|
||||
|
||||
+1294
-1292
File diff suppressed because it is too large
Load Diff
@@ -19,16 +19,6 @@
|
||||
"branches": 90
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "src/adapters/http/bounded-json.ts",
|
||||
"owner": "http-runtime",
|
||||
"minimum": {
|
||||
"lines": 85,
|
||||
"statements": 84,
|
||||
"functions": 95,
|
||||
"branches": 78
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "src/adapters/http/http-execution-v3.ts",
|
||||
"owner": "http-runtime",
|
||||
@@ -39,26 +29,6 @@
|
||||
"branches": 52
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "src/adapters/http/request-builder.ts",
|
||||
"owner": "http-runtime",
|
||||
"minimum": {
|
||||
"lines": 85,
|
||||
"statements": 85,
|
||||
"functions": 95,
|
||||
"branches": 82
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "src/adapters/http/retry-policy.ts",
|
||||
"owner": "http-runtime",
|
||||
"minimum": {
|
||||
"lines": 80,
|
||||
"statements": 78,
|
||||
"functions": 95,
|
||||
"branches": 78
|
||||
}
|
||||
},
|
||||
{
|
||||
"path": "src/adapters/query-cache/server-state-scope-runtime.ts",
|
||||
"owner": "server-state-runtime",
|
||||
@@ -212,10 +182,7 @@
|
||||
],
|
||||
"highRiskPaths": [
|
||||
"src/adapters/http/bounded-body-reader.ts",
|
||||
"src/adapters/http/bounded-json.ts",
|
||||
"src/adapters/http/http-execution-v3.ts",
|
||||
"src/adapters/http/request-builder.ts",
|
||||
"src/adapters/http/retry-policy.ts",
|
||||
"src/adapters/query-cache/server-state-scope-runtime.ts",
|
||||
"src/adapters/service-worker/service-worker-lifecycle.ts",
|
||||
"src/adapters/storage/browser-storage-adapter.ts",
|
||||
|
||||
@@ -2,7 +2,7 @@
|
||||
"schemaVersion": 2,
|
||||
"scenarioCatalogs": [
|
||||
{
|
||||
"owner": "reference-feature",
|
||||
"owner": "platform",
|
||||
"path": "tests/mocks/scenarios/catalog.ts",
|
||||
"expectationExport": "HTTP_SCENARIO_EXPECTATIONS",
|
||||
"receiptPath": "artifacts/tests/http-scenario-executions.json",
|
||||
@@ -11,8 +11,8 @@
|
||||
],
|
||||
"sourceContracts": [
|
||||
{
|
||||
"owner": "reference-feature",
|
||||
"path": "tests/mocks/handlers/reference-resources.ts",
|
||||
"owner": "platform",
|
||||
"path": "tests/mocks/handlers/test-entities.ts",
|
||||
"requiredTokens": [
|
||||
"assertOperationScenario",
|
||||
"../scenarios/catalog.ts"
|
||||
|
||||
+15
-2
@@ -29,7 +29,10 @@ README와 입구 문서는 영어, recipe·ledger·스타일 문서는 한국어
|
||||
|
||||
입구 문서가 가리키는 세부 규칙:
|
||||
|
||||
- 새 기능 추가 매뉴얼(작업 순서, 단계별 판단 기준, `create:feature`): [`manual/`](manual/), [`manual/reference/`](manual/reference/). 한국어다
|
||||
- 규모 설계(구조·소유·실행·트래픽·오류·검증·텔레메트리·릴리스 일관성)와 코드 주석 `scale-architecture.md §N`의 근거: [`architecture/scale-architecture.md`](architecture/scale-architecture.md). 절마다 현재 계약인지 기록만인지 머리말 표에 적었다
|
||||
- 계약 소유와 호환성: [`architecture/contract-ownership.md`](architecture/contract-ownership.md), [`contracts/compatibility.md`](contracts/compatibility.md)
|
||||
- 짝 백엔드 Envelope 판정과 쓰기 전 거절 표(지금 실행 규칙, `src/adapters/http/backend-envelope.ts`의 근거): [`architecture/backend-api-and-server-state-contract.md`](architecture/backend-api-and-server-state-contract.md) 4.1·6·6.1절. 기준 커밋은 [`../config/contracts/backend-contract-pin.json`](../config/contracts/backend-contract-pin.json). 같은 문서의 나머지 절은 목표 설계다
|
||||
- 정적 배포와 런타임 설정: [`architecture/static-delivery.md`](architecture/static-delivery.md)
|
||||
- 기능 개발자가 알아야 하는 양: [`architecture/capability-consumer-experience.md`](architecture/capability-consumer-experience.md)
|
||||
- 운영·복구: [`operations/`](operations/), [`runbooks/`](runbooks/)
|
||||
@@ -37,11 +40,21 @@ README와 입구 문서는 영어, recipe·ledger·스타일 문서는 한국어
|
||||
- 디자인 토큰과 수동 접근성 검토: [`styling/design-tokens.md`](styling/design-tokens.md), [`accessibility/manual-checklist.md`](accessibility/manual-checklist.md)
|
||||
- 버전별 변경: [`../CHANGELOG.md`](../CHANGELOG.md)
|
||||
|
||||
`verify:documentation`은 이 파일과 이 절에서 링크한 문서(폴더 링크는 그 안의 `.md` 전부)에
|
||||
적힌 repo 경로·링크·package script·FE-GATE ID가 실제로 있는지 검사한다. 명령(인라인 코드와
|
||||
셸 코드 블록) 안의 경로 인자도 본다. 짝 백엔드 템플릿(`clean-architecture-backend-template`)의
|
||||
경로와 링크는 그 checkout이 이 checkout 옆에 있을 때만 확인하고, 없으면 실패 대신 확인하지
|
||||
못한 것으로 출력과 `artifacts/quality/documentation-review.json`에 남긴다. `CHANGELOG.md`는
|
||||
지난 상태를 적는 문서라 빼고, git이 무시하는 생성 산출물과 복사한 프로젝트가 지운 작업 이력은
|
||||
없어도 된다. 설명·수치가 코드와 맞는지는 검사하지 않는다. 규칙과 예외의 정본은
|
||||
`scripts/verify-documentation-readiness.ts`다.
|
||||
|
||||
게이트가 직접 읽는 파일이라 지우거나 옮기면 게이트가 실패한다.
|
||||
|
||||
| 파일 | 읽는 명령 |
|
||||
|---|---|
|
||||
| `architecture/review-ledger.json`, `architecture/review-evidence.md`, `accessibility/manual-checklist.md` | `verify:documentation` (FE-GATE-017) |
|
||||
| 이 파일, `architecture/review-ledger.json`, `architecture/review-evidence.md` | `verify:documentation` (FE-GATE-017) |
|
||||
| repo 루트의 `artifacts/tests/a11y-manual/` 라우트별 기록 | `verify:documentation` (FE-GATE-017), `review:a11y-manual` (FE-GATE-009, FE-GATE-028) |
|
||||
| `reviews/adapters/INVENTORY.md` | `check:adapter-inventory` (FE-GATE-010) |
|
||||
| `operations/adapter-remediation-ledger.md`, `operations/adapter-remediation-dispositions.json` | `check:remediation-ledger` (게이트 밖. 이유는 `config/ci/ungated-scripts.json`) |
|
||||
|
||||
@@ -68,5 +81,5 @@ README와 입구 문서는 영어, recipe·ledger·스타일 문서는 한국어
|
||||
| 경로 | 내용 |
|
||||
|---|---|
|
||||
| [`superpowers/`](superpowers/) | 과거 작업 계획과 스펙 |
|
||||
| [`reviews/`](reviews/) | 리뷰 결과와 리뷰 가이드. `reviews/adapters/INVENTORY.md`만 게이트가 읽는다 |
|
||||
| [`reviews/`](reviews/) | 리뷰 결과와 리뷰 가이드. `reviews/adapters/INVENTORY.md`만 게이트가 읽는다. `reviews/adapters/`는 지우지 않는다: INVENTORY의 행과 `operations/adapter-remediation-ledger.md`가 그 안의 리뷰로 링크한다 |
|
||||
| [`../SPEC.md`](../SPEC.md), [`../tasks/`](../tasks/) | 2026-09-25 리뷰 수정 라운드의 요구사항과 작업 목록. 이 라운드가 쓰는 중이라 `docs/` 밖에 그대로 둔다 |
|
||||
|
||||
@@ -1,14 +1,12 @@
|
||||
# Manual accessibility review checklist
|
||||
|
||||
Automated axe checks do not establish WCAG conformance. A human reviewer must
|
||||
review all ten route records in `artifacts/tests/a11y-manual/` against one
|
||||
release candidate and sign them. The required scope is derived from the route
|
||||
registry: `APP_HOME`, `EXAMPLES_PLATFORM`, `EXAMPLES_UI`, `EXAMPLES_STATES`,
|
||||
`EXAMPLES_AUTH`, `NOT_FOUND`, `REFERENCE_RESOURCE_LIST`,
|
||||
`REFERENCE_RESOURCE_DETAIL`, `REFERENCE_RESOURCE_FORM` and
|
||||
`REFERENCE_RESOURCE_STATUS`. Copy the template fields exactly; the gate rejects
|
||||
blank identity/timestamp/signature fields, pending verdicts, mismatched release
|
||||
IDs, or missing routes.
|
||||
review every route record in `artifacts/tests/a11y-manual/` against one
|
||||
release candidate and sign them. The required scope is the route registry
|
||||
(`ROUTE_REGISTRY` in `src/features/installed-feature-contracts.ts`): one
|
||||
record per route, named `<ROUTE_ID>.md`. Copy the template fields exactly; the
|
||||
gate rejects blank identity/timestamp/signature fields, pending verdicts,
|
||||
mismatched release IDs, or missing routes.
|
||||
|
||||
The signed review is the release gate FE-GATE-028 (`review:a11y-manual`), so
|
||||
it is required once per release candidate, not on every merge. The merge gate
|
||||
@@ -16,11 +14,11 @@ FE-GATE-009 runs `review:a11y-manual -- --format-only`: each record must keep
|
||||
the fields below with `pending`, `pass` or `not-applicable (<reason>)` verdicts,
|
||||
and a record marked `reviewed` must be complete.
|
||||
|
||||
This list is not maintained by hand: `verify:documentation` compares it against
|
||||
the installed route registry and fails when a registered route is absent. It
|
||||
said six routes while ten were registered, which put the platform overview and
|
||||
the three reference-resource screens outside the declared manual review scope
|
||||
without anyone deciding they should be.
|
||||
This document keeps no route list. A list here once said six routes while ten
|
||||
were registered, and keeping it current made every new feature edit this file.
|
||||
Instead `verify:documentation` fails, naming the route ID, when a registered
|
||||
route has no record file. A new route starts from a copy of a pending record
|
||||
with its title and `Route ID` changed.
|
||||
|
||||
Allowed item verdicts:
|
||||
|
||||
@@ -70,9 +68,14 @@ What the automated run scans:
|
||||
never lands on the app shell's loading surface
|
||||
(`tests/e2e/accessibility.spec.ts`). A public route's `h1` must equal its
|
||||
catalog title.
|
||||
- Protected routes after the demo sign-in, never the sign-in prompt. Their API
|
||||
calls answer an empty list there.
|
||||
- Protected routes after the demo sign-in, never the sign-in prompt. A list
|
||||
read answers an empty list in the frame its descriptor declares (inside the
|
||||
Envelope for `responseEnvelope: "ENVELOPE_V1"`), and the scan runs only once
|
||||
no alert box is on screen, so a list page is scanned in its empty state. A
|
||||
read of one resource (a detail page) has no generic answer: that route is
|
||||
scanned in its failure state and the run records an `a11y-data-state`
|
||||
annotation.
|
||||
- The reference sample's list in its success, empty and error states, its
|
||||
detail, its form with submit errors and its status page, each after that
|
||||
state is on screen (`tests/e2e/reference-form.spec.ts`, removed with the
|
||||
state is on screen (tests/e2e/reference-form.spec.ts, removed with the
|
||||
sample).
|
||||
|
||||
@@ -81,8 +81,8 @@ PromotionEvidence
|
||||
| capability | primary current status | 현재 증거 | 목표 또는 잔여 |
|
||||
| --- | --- | --- | --- |
|
||||
| installed REST reference vertical | `COMPOSED` | operation registry → request schema → HTTP → envelope/payload schema → mapper → application input → Query 화면 경로 | 아래 REST hardening delta와 실제 제품 provider 계약 |
|
||||
| shared REST JSON executor | `COMPOSED` | path/search/body codec projection, shared deadline/retry-sleep budget, AbortSignal, bounded auth recovery, exact envelope/media/status, safe failure와 diagnostics | 204/304/412 execution join과 actual provider conformance |
|
||||
| REST v2 security/execution baseline | `COMPOSED` | collision-aware operation composition, path placeholder↔codec key exact join, prefix-preserving HTTPS/loopback provider, named bearer/CSRF profile와 credential-mode ceiling, auth fail-before-fetch, bounded JSON, outbound correlation/status·physical-attempt 관측 | cookie-CSRF/CORS provider evidence, 204/304/412 conditional execution과 compatibility artifact |
|
||||
| shared REST JSON executor (V3 contract executor) | `COMPOSED` | `src/adapters/http/http-execution-v3.ts`: descriptor 하나로 실행, shared deadline/retry 예산, AbortSignal, exact media/status, 짝 백엔드 Envelope 판정(`backend-envelope.ts`), safe failure와 diagnostics. 401은 끝이고 숨은 auth recovery는 없다(정본 8.4) | 204/304/412 등 남은 REST hardening delta |
|
||||
| REST v2 security/execution baseline | `REMOVED` | 2026-11-03 V2 HTTP 경로 삭제(`048f490`·`12f3bb7`). V2 provider·CSRF 프로필 해석도 함께 지웠다 | 지금 경로는 V3 contract executor(아래 행) |
|
||||
| GraphQL provider-neutral reference adapter | `DESIGNED_NOT_IMPLEMENTED` | source/dependency/codegen/runtime 없음 | persisted-operation-only transport, GraphQL response decoder, mapper binding과 contract harness |
|
||||
| product GraphQL composition | `NOT_SELECTED` | endpoint/schema/persisted manifest/owner 없음 | 제품 query가 REST보다 GraphQL aggregation을 정당화할 때 선택 |
|
||||
| GraphQL batching, subscription, `@defer`/`@stream` | `NOT_SELECTED` | 없음 | 각각 독립 ADR, proxy/browser lifecycle과 cache semantics 필요 |
|
||||
@@ -98,7 +98,7 @@ PromotionEvidence
|
||||
| Protobuf REST Gateway reference contract/harness | `DESIGNED_NOT_IMPLEMENTED` | HttpRule/transcoder/OpenAPI/provider fixture 없음 | selected kind의 deterministic/provider conformance |
|
||||
| product Protobuf REST Gateway composition | `NOT_SELECTED` | route/provider/owner 없음 | curated BFF, grpc-gateway 또는 Envoy transcoder 중 하나와 public HTTP contract 승인 |
|
||||
| feature runtime request/response Schema | `COMPOSED` | Zod request/payload schemas와 installed schema registry가 reference feature에 연결 | byte/depth/node ceiling, unknown-field profile, schema artifact/digest와 multi-protocol source governance |
|
||||
| schema/mapper v2 reference baseline | `COMPOSED` | collision-aware schema codec/mapper contribution install, operation schema/mapper reference resolution, request reject/response strip 방향, bounded collection, typed no-throw mapping result와 operation별 cast-free result guard | actual codec fingerprint, source provenance와 multi-protocol compatibility policy |
|
||||
| schema/mapper v2 reference baseline | `REMOVED` | 2026-11-03 삭제(`12f3bb7`). schema는 descriptor 검증기와 FE-REG-SCHEMA 행, mapping은 descriptor `mapSuccess`다 | — |
|
||||
| generated contract artifact governance | `DESIGNED_NOT_IMPLEMENTED` | `generated-api` recipe만 있고 generator/provider 선택 없음 | OpenAPI/GraphQL/proto source authentication, pinned generation, drift/breaking gate와 N/N-1 |
|
||||
| feature boundary Mapper | `COMPOSED` | installed mapper metadata composer와 response-schema exact join 뒤 typed no-throw MappingResult → immutable domain/application view 실행 | numeric/date/null/enum canonical rules와 generated-artifact join |
|
||||
| TanStack Query memory Server State | `COMPOSED` | QueryClient, cancellation, stale-degraded UI, session-generation cancel/clear fence와 invalidation coordinator | account identity projection과 bounded topic↔namespace many-to-many registry |
|
||||
@@ -264,9 +264,10 @@ registry validation은 다음을 build/boot 전에 거절한다.
|
||||
Connect/gRPC-Web operation↔provider의 runtime/wire/status/capability tuple
|
||||
mismatch
|
||||
|
||||
현재 installed reference operation은 REST v2 metadata를 사용한다. operation,
|
||||
runtime schema codec과 mapper contribution은 object spread가 아니라 각각의
|
||||
collision-aware composer로 설치되며 duplicate ID를 덮어쓰기 전에 거절한다.
|
||||
현재 installed reference operation은 V3 descriptor 하나로 적는다(REST v2 metadata는
|
||||
2026-11-03에 지웠다). contract contribution은 object spread가 아니라 collision-aware
|
||||
composer로 설치되며 duplicate ID를 덮어쓰기 전에 거절한다. 아래 binding 검증 서술은
|
||||
V2 기록이 섞여 있다. 지금 규칙은 `src/contracts/external-contract-runtime.ts`가 정본이다.
|
||||
boot-time binding 검증은 path placeholder와 codec key, provider/auth/CSRF profile,
|
||||
path/request/response schema와 mapper input schema를 exact resolve한 뒤 immutable
|
||||
registry를 발행한다. GraphQL/Connect/gRPC-Web discriminant와 protocol-specific
|
||||
|
||||
@@ -8,7 +8,7 @@
|
||||
> 본 문서의 해당 서술이 정본과 충돌하면 정본을 따른다.
|
||||
|
||||
|
||||
- 상태: frontend handoff design accepted, backend implementation/evidence pending
|
||||
- 상태: frontend handoff design accepted, backend implementation/evidence pending. 단 4.1·6·6.1절(Envelope 읽기, effect 판정, 쓰기 전 거절 표)은 지금 실행 규칙이다(`COMPOSED`, `src/adapters/http/backend-envelope.ts`)
|
||||
- 기준일: 2026-07-28
|
||||
- 대상: Web API/BFF, application service, persistence, identity, GraphQL router,
|
||||
Connect/gRPC-Web gateway, Protobuf REST Gateway와 운영 owner
|
||||
@@ -160,57 +160,46 @@ authorization을 다시 수행한다.
|
||||
|
||||
### 4.1 JSON envelope
|
||||
|
||||
모든 현재 JSON success/failure는 다음 envelope를 사용한다.
|
||||
Envelope의 모양과 키 존재 규칙은 짝 백엔드 템플릿 문서가 정본이다. 이
|
||||
문서에 표를 다시 적지 않는다.
|
||||
|
||||
```json
|
||||
{
|
||||
"success": true,
|
||||
"data": {},
|
||||
"meta": {
|
||||
"requestId": "server-request-id",
|
||||
"traceId": "server-trace-id",
|
||||
"correlationId": "client-correlation-id"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
```json
|
||||
{
|
||||
"success": false,
|
||||
"error": {
|
||||
"code": "STABLE_MACHINE_CODE",
|
||||
"category": "optional-safe-category",
|
||||
"message": "optional non-sensitive copy",
|
||||
"retryable": false,
|
||||
"details": {}
|
||||
},
|
||||
"meta": {
|
||||
"requestId": "server-request-id",
|
||||
"traceId": "server-trace-id",
|
||||
"correlationId": "client-correlation-id"
|
||||
}
|
||||
}
|
||||
```
|
||||
|
||||
Envelope 최상위 unknown field는 현재 거절된다. ordinary resource DTO의 unknown
|
||||
field는 frontend schema에서 strip되지만 additive compatibility는 contract
|
||||
review와 fixture를 먼저 통과해야 한다.
|
||||
|
||||
`requestId`, `traceId`, `correlationId`는 각각 1..128 범위의 안전한 opaque
|
||||
identifier다. credential, user data, cursor, validator와 database key를
|
||||
identifier에 encode하지 않는다.
|
||||
- 정본: [`clean-architecture-backend-template/docs/web/http-contract.md`](../../../clean-architecture-backend-template/docs/web/http-contract.md)
|
||||
1절 "Envelope 키 존재 규칙"
|
||||
- 기준 커밋: 백엔드 `45d2a478`. 기계가 읽는 정본은
|
||||
`config/contracts/backend-contract-pin.json`(repo, 전체 SHA, 대조한 절 §1·§2·§4,
|
||||
담당)이다. 백엔드 §2 표와 §4 `REQUEST_TIMEOUT`은
|
||||
`config/contracts/backend-idempotency-answers.json`에 code·status·쓰기 전 거절·같은 키
|
||||
재전송 열로 옮겨 두었다. `tests/unit/backend-contract-pin.test.ts`가 그 표와
|
||||
`backend-envelope.ts`의 판정을 양방향으로 대조한다. 값이 null인 필드는 키째
|
||||
생략한다. 백엔드 기준 커밋을 올리면 pin, 답 표 JSON, 6.1절 표를 같은 변경에서
|
||||
다시 확인한다. 형제 디렉터리에 백엔드 checkout이 있으면
|
||||
`corepack pnpm check:backend-contract-drift`가 pin 뒤 `http-contract.md`가
|
||||
바뀌었는지 알려 준다(게이트 밖).
|
||||
- 프론트에서 Envelope를 읽는 곳: `src/adapters/http/backend-envelope.ts`(스키마와
|
||||
해석). V3 실행기는 descriptor가 `responseEnvelope: "ENVELOPE_V1"`일 때 쓴다.
|
||||
`create:feature`가 만든 기능은 이 값을 선언한다. 참조 기능은 선언하지 않고
|
||||
DTO와 problem details를 검증한다.
|
||||
- 실패 Envelope의 `error.code`가 "적용 안 됨"인지는 6.1절이 정한다.
|
||||
- 페이지 목록의 `meta.page`(`number`·`size`·`total`·`sort`)는 기능의
|
||||
`mapSuccess(value, { page })` 두 번째 인자로 간다(`FeatureHttpSuccessContext`).
|
||||
`outputValidator`는 지금처럼 `data`만 본다. 백엔드 범위(정수, `size` 1~100) 밖의
|
||||
`page`는 버리고 응답은 그대로 읽는다. 목록 화면의 전체 수는 `page.total`이다.
|
||||
배열 길이는 첫 페이지 크기(기본 20)일 뿐이다.
|
||||
- bulk 응답(`results`, `BATCH_PARTIAL_FAILURE`)은 지원하지 않는다. 성공 status의
|
||||
`results` Envelope는 `ENVELOPE_MISMATCH`다. bulk 엔드포인트를 붙이려면
|
||||
`responseEnvelope`를 빼고 기능 스키마가 본문 전체를 읽는다.
|
||||
|
||||
### 4.2 Status와 error
|
||||
|
||||
| HTTP status | 의미 |
|
||||
| --- | --- |
|
||||
| `400` | malformed request 또는 closed request contract 위반 |
|
||||
| `400` | malformed request 또는 closed request contract 위반. 짝 백엔드의 필드 검증 실패는 400 `VALIDATION_FAILED`(필드 목록 `details`)다. 적용 여부는 6.1절 |
|
||||
| `401` | 인증 없음/만료. 이미 적용된 command를 401로 반환하지 않음 |
|
||||
| `403` | authenticated principal에게 권한 없음 |
|
||||
| `404` | authorization 정책상 공개 가능한 not-found |
|
||||
| `409` | idempotency fingerprint, domain revision 또는 semantic conflict |
|
||||
| `409` | domain revision 또는 semantic conflict. 멱등성 응답(409·422·400)은 6절 |
|
||||
| `412` | selected conditional write의 `If-Match` precondition 실패 |
|
||||
| `422` | field validation. bounded `details.issues[]`만 허용 |
|
||||
| `422` | 짝 백엔드에서는 field validation이 아니다. 기본 배포는 `IDEMPOTENT_REQUEST_MISMATCH`(6절)만, fileserver 모듈은 쓰기 뒤에도 나오는 code를 422로 보낸다. 프론트는 `IDEMPOTENT_REQUEST_MISMATCH`만 적용 안 됨으로 보고, 폼 필드 오류는 `details.issues[]`가 있으면 읽는다. 필드 목록이 없는 422는 입력 오류가 아니라 `UNKNOWN_CLIENT_FAILURE`다(폼은 지원 참조가 있는 실패 상태를 보인다). 적용 여부는 6.1절 |
|
||||
| `429` | rate limit. 유효한 `Retry-After`와 operation 정책 제공 |
|
||||
| `500/502/503/504` | server/provider failure. command effect certainty 별도 |
|
||||
|
||||
@@ -255,7 +244,9 @@ Cross-origin bearer provider 최소 CORS:
|
||||
`X-Correlation-ID`, 향후 `If-None-Match`, `If-Match` 허용
|
||||
- 필요한 경우 `ETag`, `Retry-After`, request/trace header만 expose.
|
||||
`X-Correlation-ID`를 expose하면 V3 실패의 `AppFailure.requestId`가 된다
|
||||
(`src/adapters/http/feature-http-binding.ts`)
|
||||
(`src/adapters/http/feature-http-binding.ts`). expose하지 않거나 응답이 없으면
|
||||
클라이언트가 보낸 값이 된다. Envelope operation의 실패 본문 `meta.traceId`는
|
||||
`AppFailure.traceId`가 된다(헤더가 아니라 본문이라 CORS expose와 상관없다)
|
||||
- redirect login page, HTML error body와 wildcard credential 금지
|
||||
|
||||
## 6. Command와 idempotency
|
||||
@@ -263,53 +254,119 @@ Cross-origin bearer provider 최소 CORS:
|
||||
`CREATE_REFERENCE_RESOURCE`는 keyed command다. frontend memory single-flight는
|
||||
backend idempotency를 대체하지 않는다.
|
||||
|
||||
idempotency identity:
|
||||
멱등성 응답의 status·`error.code`·`retryable`·`Retry-After`와 키 문법은 짝
|
||||
백엔드 템플릿 문서가 정본이다. 이 문서에 표를 다시 적지 않는다.
|
||||
|
||||
```text
|
||||
principal/tenant
|
||||
+ semantic operation ID and contract version
|
||||
+ Idempotency-Key
|
||||
+ canonical request fingerprint
|
||||
```
|
||||
- 정본: [`clean-architecture-backend-template/docs/web/http-contract.md`](../../../clean-architecture-backend-template/docs/web/http-contract.md)
|
||||
2절 "멱등성 응답", 4절 "web 전용 오류 코드"
|
||||
- 기준 커밋: 4.1절과 같다(백엔드 `45d2a478`, `config/contracts/backend-contract-pin.json`).
|
||||
- 프론트가 그 응답을 읽는 곳:
|
||||
- 키 생성·검사: `src/contracts/mutation-intent.ts` `isValidIdempotencyKey`
|
||||
- 결과 불명 재전송이 같은 키를 쓰고 `Retry-After`까지 기다리는 곳:
|
||||
`src/presentation/adapters/query/application-query.ts`
|
||||
- Envelope operation의 거절 판정: `src/adapters/http/backend-envelope.ts`
|
||||
`REFUSED_BEFORE_WRITE`(6.1절 표)
|
||||
- 참조 기능(Envelope 없음) 판정: src/features/reference-feature/contracts/reference-feature-contract-contribution.ts
|
||||
(effect), src/features/reference-feature/adapters/reference-http-gateway.ts
|
||||
(code)
|
||||
|
||||
권장 record:
|
||||
### 6.1 거절 code와 적용 여부
|
||||
|
||||
```text
|
||||
IdempotencyRecord
|
||||
principalFingerprint
|
||||
operationId
|
||||
contractVersion
|
||||
idempotencyKeyHash
|
||||
requestFingerprint
|
||||
state = IN_PROGRESS | COMMITTED | FAILED_SAFE | EFFECT_UNKNOWN
|
||||
responseStatus
|
||||
responseEnvelopeReference
|
||||
resourceRevision | null
|
||||
leaseOwner + leaseExpiry
|
||||
retentionExpiry
|
||||
createdAt + completedAt
|
||||
```
|
||||
mutation이 400·409·422로 실패하면 프론트는 그 요청이 적용됐는지 정해야 한다.
|
||||
|
||||
불변조건:
|
||||
- `NOT_APPLIED`: 쓰기 전에 거절됐다. 다음 저장은 새 `Idempotency-Key`를 쓴다.
|
||||
- `MAYBE_APPLIED`: 쓰기 뒤에도 나올 수 있다. mutation 코디네이터가 키를 붙들고
|
||||
결과 불명으로 보인다. effect가 없는 실패도 이 값이다.
|
||||
|
||||
- claim과 command transaction의 관계가 원자적이거나 crash reconciliation
|
||||
가능해야 한다.
|
||||
- 같은 key와 같은 fingerprint replay는 같은 authoritative receipt를 반환한다.
|
||||
- 같은 key와 다른 fingerprint는 `409 IDEMPOTENCY_KEY_REUSED`다.
|
||||
- concurrent replay는 하나만 실행하고 나머지는 같은 result를 기다리거나
|
||||
bounded `IN_PROGRESS` 결과를 받는다.
|
||||
- commit 뒤 response 유실은 새 resource를 만들지 않는다.
|
||||
- `EFFECT_UNKNOWN`은 새 key로 자동 재시도하지 않고 status/reconcile endpoint로
|
||||
확인한다.
|
||||
- retention은 frontend retry/recovery 최대 window보다 길고 quota/abuse limit이
|
||||
있다.
|
||||
- key 원문과 request body를 log/metric label에 넣지 않는다.
|
||||
백엔드 `http-contract.md`는 code가 어느 단계에서 나오는지 적지 않는다. 아래 표는
|
||||
프론트가 백엔드 코드를 읽고 정한 판정이다. `5786126c`에서 읽었고, `bbe944bd`에서
|
||||
바뀐 파일(`GlobalExceptionHandler`, `IdempotencyExecutor`, `PersistenceExceptionTranslator`,
|
||||
`FailureCategory`, `DomainExceptionHandler`)을 다시 읽었다. 판정은 바뀌지 않았고 줄
|
||||
번호만 옮겼다. `c508b1ba`에서는 바뀐 `IdempotencyExecutor`(늦게 끝난 실행 기록)를 다시
|
||||
읽었다. 처리 중·불일치 판정은 그대로 action 전이고 줄 번호만 옮겼다. `45d2a478`에서는
|
||||
바뀐 `GlobalExceptionHandler`(로그 줄 정리)와 `IdempotencyExecutor`를 다시 읽었다. 인용한
|
||||
블록의 내용은 그대로이고 줄 번호만 옮겼다. §2는 처리 중(PostgreSQL 저장소는 409 대신
|
||||
기다림)과 `IDEMPOTENCY_UNAVAILABLE`(lease 만료로 시작 거절) 설명만 늘었고 code·status·재시도는 같다. 같은 code가 쓰기 전과
|
||||
뒤에서 모두 나오면 "쓰기 뒤 가능"으로 둔다. 프론트는 code만 보고 둘을 가를 수
|
||||
없다.
|
||||
|
||||
Database unique constraint 또는 durable compare-and-set이 최종 중복 방지
|
||||
authority여야 한다. process-local map/lock만 사용하지 않는다.
|
||||
| code (status) | 나오는 곳 | 단계 | 프론트 결과 | 백엔드 파일:줄 |
|
||||
| --- | --- | --- | --- | --- |
|
||||
| `VALIDATION_FAILED` (400), details = 필드 목록 | 요청 본문 `@Valid` 실패, 컨트롤러 파라미터 제약 실패. 컨트롤러 메서드가 불리기 전 | 쓰기 전 | `NOT_APPLIED` | `GlobalExceptionHandler.java:205-218`, `:333-355` |
|
||||
| `VALIDATION_FAILED` (400), details = 필드 목록 | `ConstraintViolationException`. 어느 층에서 던져도 이 handler가 받는다. 요청 경로에서 던지는 코드는 없다(application bean에 `@Validated` 없음, JPA entity에 Bean Validation 제약 없음, 직접 throw 없음) | 쓰기 전(현재 출처 없음) | `NOT_APPLIED` | `GlobalExceptionHandler.java:101-106` |
|
||||
| `VALIDATION_FAILED` (400), details = `{cause}` 또는 없음 | 본문을 읽지 못함(`HttpMessageNotReadableException`) | 쓰기 전 | `NOT_APPLIED` | `GlobalExceptionHandler.java:220-238` |
|
||||
| `VALIDATION_FAILED` (400), details = `{field, code}` | 페이지·정렬 파라미터. 목록 GET 컨트롤러가 use case 전에 검사한다 | 쓰기 전 | `NOT_APPLIED` | `GlobalExceptionHandler.java:149-153`, `PageParams.java:27-33`, `SortParam.java:16-43` |
|
||||
| `IDEMPOTENCY_KEY_INVALID` (400) | KEYED 컨트롤러 첫 줄의 키 파싱 | 쓰기 전 | `NOT_APPLIED` | `IdempotencyKeyHeader.java:32-38`, `PosterImagePublicationController.java:64` |
|
||||
| `IDEMPOTENT_REQUEST_MISMATCH` (422) | 멱등성 executor가 action 전에 판정 | 쓰기 전 | `NOT_APPLIED` | `IdempotencyExecutor.java:127-128`, `:166-167` |
|
||||
| `IDEMPOTENT_IN_FLIGHT` (409) | 멱등성 executor가 action 전에 판정. 같은 키의 앞선 요청이 실행 중이다 | 이번 요청은 쓰기 전. 앞선 요청은 적용될 수 있다 | `MAYBE_APPLIED` | `IdempotencyExecutor.java:129-130`, `:168-169` |
|
||||
| `BAD_PARAMETER` (400) | 타입 변환 실패, 필수 파라미터·헤더 없음(쓰기 전). **어느 층이든 `IllegalArgumentException`**(use case·domain 포함) | 쓰기 뒤 가능 | `MAYBE_APPLIED` | `GlobalExceptionHandler.java:92-99`, `:108-116`, `:384-404`, `HttpStatusErrorCodes.java:33-34` |
|
||||
| `MAPPING_FAILED` (400) | web 매퍼(쓰기 전), outbound ACL 매퍼(use case 안), 멱등성 응답 직렬화(action이 끝난 뒤) | 쓰기 뒤 가능 | `MAYBE_APPLIED` | `WorkLogWebMapper.java:36`, `RepoStatsAclMapper.java:14`, `JsonIdempotentResponseCodec.java:32`, `IdempotencyExecutor.java:276` |
|
||||
| `DB_SERIALIZATION_FAILURE`, `DB_DEADLOCK`, `DB_LOCK_TIMEOUT`, `DB_NULL_VIOLATION`, `DB_FK_VIOLATION`, `DB_UNIQUE_VIOLATION`, `DB_CHECK_VIOLATION`, `DB_OPTIMISTIC_CONFLICT` (409) | persistence 어댑터가 SQL·JPA 실패를 바꾼 것. 트랜잭션 안이나 commit에서 | 쓰기 뒤 가능 | `MAYBE_APPLIED` | `FailureCategory.java:86-102`, `StandardSqlStateErrorMapping.java:46-52`, `PersistenceExceptionTranslator.java:133` |
|
||||
| `LOCK_ACQUISITION_TIMEOUT` (409) | 분산 락 대기 초과. use case 안 | 쓰기 뒤 가능 | `MAYBE_APPLIED` | `LockRegistryDistributedLock.java:50`, `:53` |
|
||||
| 참조 도메인 `WORKLOG_INVALID`, `POSTER_INVALID_STATE`, `POSTER_IMAGE_REQUIRED` (400), `WORKLOG_CONFLICT`, `POSTER_ALREADY_EXISTS`, `POSTER_IMAGE_ALREADY_PUBLISHED` (409) | application·domain 예외 | 쓰기 뒤 가능 | `MAYBE_APPLIED` | `DomainExceptionHandler.java:52-90` |
|
||||
| 선택 모듈 web-advanced `PATCH_REJECTED` (400), `PATCH_TEST_FAILED` (409) | patch 라이브러리. 부르는 코드가 단계를 정한다 | 쓰기 뒤 가능 | `MAYBE_APPLIED` | `clean-architecture-backend-template/src/adapter/inbound/web-advanced/README.md` 「오류 응답」 |
|
||||
| 선택 모듈 fileserver `BAD_REQUEST` (400), `FILE_ALREADY_EXISTS`, `FILE_NOT_READY`, `UPLOAD_OFFSET_MISMATCH`, `CONCURRENT_MODIFICATION` (409), `INTEGRITY_MISMATCH`, `MALWARE_DETECTED`, `INVALID_PATH`, `PATH_OUTSIDE_NAMESPACE` (422) | application·outbound 층. `INTEGRITY_MISMATCH`·`MALWARE_DETECTED`는 레코드를 `REJECTED`로 쓴 뒤 던진다 | 쓰기 뒤 가능 | `MAYBE_APPLIED` | `FileserverErrorCode.java:26-44`, `FinalizeUploadApplicationUseCase.java:211-224`, `:336-341` |
|
||||
|
||||
- application-notification의 `VALIDATION_FAILED`(`NotificationFailureCode`)는
|
||||
`ApiErrorCarrier`가 아니다. HTTP로는 500 `INTERNAL_ERROR`로 나가므로 표에 없다.
|
||||
- 표에 없는 400·409·422 code는 `MAYBE_APPLIED`로 본다.
|
||||
- 400·409·422 밖에서 백엔드 계약이 직접 정한 답 넷도 status와 code가 함께
|
||||
맞으면 기능 분류기와 상관없이 `MAYBE_APPLIED`다(`backend-envelope.ts`
|
||||
`MAYBE_APPLIED_ANSWERS`). `http-contract.md` §2의 503 `IDEMPOTENCY_UNAVAILABLE`,
|
||||
503 `IDEMPOTENCY_COMPLETION_UNKNOWN`(백엔드 `bbe944bd`부터), 500
|
||||
`IDEMPOTENCY_RECOVERY_REQUIRED`, §4의 503 `REQUEST_TIMEOUT`이다. 실행기가
|
||||
자동으로 다시 보내는 것은 KEYED 명령의 503 `IDEMPOTENCY_UNAVAILABLE`뿐이다.
|
||||
나머지는 결과 불명 화면에서 사용자가 같은 키로 다시 보낸다.
|
||||
- 파일 위치(백엔드 repo `clean-architecture-backend-template` 기준):
|
||||
- `GlobalExceptionHandler.java`, `HttpStatusErrorCodes.java`: `clean-architecture-backend-template/src/adapter/inbound/web/src/main/java/dev/caskeleton/adapter/inbound/web/error/`
|
||||
- `PageParams.java`, `SortParam.java`: 같은 모듈 `.../web/pagination/`
|
||||
- `IdempotencyKeyHeader.java`: 같은 모듈 `.../web/http/`
|
||||
- `IdempotencyExecutor.java`: `clean-architecture-backend-template/src/application-core/src/main/java/dev/caskeleton/application/idempotency/`
|
||||
- `JsonIdempotentResponseCodec.java`: `clean-architecture-backend-template/src/adapter/inbound/web-advanced/.../advanced/idempotency/`
|
||||
- `FailureCategory.java`, `StandardSqlStateErrorMapping.java`,
|
||||
`PersistenceExceptionTranslator.java`, `LockRegistryDistributedLock.java`:
|
||||
`clean-architecture-backend-template/src/adapter/outbound/persistence-jpa/`
|
||||
- `PosterImagePublicationController.java`, `WorkLogWebMapper.java`,
|
||||
`RepoStatsAclMapper.java`, `DomainExceptionHandler.java`: `clean-architecture-backend-template/src/sample-portfolio/`
|
||||
- `FileserverErrorCode.java`, `FinalizeUploadApplicationUseCase.java`:
|
||||
`clean-architecture-backend-template/src/application-fileserver/`
|
||||
|
||||
**operation이 선언하는 쓰기 전 거절**(1103/03-01): 업무 code는 엔드포인트마다
|
||||
단계가 달라 위 표에 "쓰기 뒤 가능"으로 둔다. 쓰기 전에만 그 code를 내는 엔드포인트를
|
||||
아는 사람은 기능 작성자다. 그 사람이 descriptor의
|
||||
`commandEffect.refusedBeforeWrite`에 code를 적는다.
|
||||
|
||||
- 그 code로 온 400·409·422는 `NOT_APPLIED`다. 적지 않은 code는 그대로 `MAYBE_APPLIED`다.
|
||||
- 짝 백엔드 생성 기능의 create는 이름 규칙을 `build(command)`에서 트랜잭션 전에
|
||||
검사하고 400 `<FEATURE>_INVALID`를 준다(`Create__Feature__UseCase.java.tmpl`,
|
||||
`__Feature__ErrorCode.java.tmpl`). 이 code는 적는다.
|
||||
- 위 표의 code(`VALIDATION_FAILED` 등)는 적어도 표의 status 규칙을 따른다.
|
||||
`IDEMPOTENT_*`·`IDEMPOTENCY_*`는 적을 수 없다. 계약 조립이 거절하고, 실행기도
|
||||
무시한다. 409 `IDEMPOTENT_IN_FLIGHT`의 앞선 요청은 적용될 수 있기 때문이다.
|
||||
- `responseEnvelope: "ENVELOPE_V1"`가 아닌 operation에는 적을 수 없다. 실행기가
|
||||
백엔드 code를 읽지 않는다.
|
||||
- 판정은 `src/adapters/http/backend-envelope.ts` `envelopeFailureEffect`, 조립 검사는
|
||||
`src/contracts/external-contract-runtime.ts` `assertRefusedBeforeWrite`다.
|
||||
|
||||
프론트 판정과 표가 다른 곳(고치면 이 줄을 지운다):
|
||||
|
||||
- 참조 기능 분류기(`classifyProblem`)는 참조 fixture(problem+json)용이라
|
||||
400·422를 모두 `NOT_APPLIED`로 본다. 참조 기능은 Envelope operation이 아니라
|
||||
이 표의 대상이 아니다. 짝 백엔드에 붙이는 Envelope operation은
|
||||
`src/adapters/http/backend-envelope.ts`의 표가 400·409·422를 정한다(`3261208`).
|
||||
|
||||
남은 위험: "쓰기 전"은 현재 코드에서 그 handler에 닿는 출처를 센 결과다. 백엔드가
|
||||
application bean에 `@Validated`를 달거나 JPA entity에 Bean Validation 제약을
|
||||
넣으면, 필드 목록이 있는 400 `VALIDATION_FAILED`가 use case 안에서도 나온다.
|
||||
백엔드에는 이것을 막는 검사가 없다.
|
||||
|
||||
## 7. Cursor pagination과 snapshot
|
||||
|
||||
짝 백엔드 템플릿의 페이지 목록은 이 절의 cursor가 아니라 offset이다(`PageParams`,
|
||||
`meta.page`, 4.1절). 프론트는 그 `meta.page`를 읽어 기능에 넘길 뿐이고, 아래
|
||||
`CursorPage` 계약은 cursor를 고른 백엔드를 위한 것이다. 백엔드가 cursor로 바꾸면
|
||||
이 절로 합친다.
|
||||
|
||||
Backend가 pagination을 선택할 때 새 response schema/operation version으로 다음
|
||||
contract를 제공한다.
|
||||
|
||||
@@ -600,12 +657,12 @@ query invalidate hint로만 쓸지 operation별 reducer contract가 필요하다
|
||||
같은 이름의 정책이라도 전송마다 동작이 다르다. operation을 다른 전송으로 옮기면
|
||||
이 표로 동작 변화를 확인한다.
|
||||
|
||||
| 규칙 | V3 contract executor (기본 경로) | V2 client (기본 조합에 없음) | Browser RPC |
|
||||
|---|---|---|---|
|
||||
| KEYED 명령 자동 재시도 | 전송 전 실패만 재시도한다. 전송 뒤 실패는 재시도하지 않고 `MAYBE_APPLIED`다. 응답(5xx·429)으로는 재시도하지 않는다 (`src/adapters/http/http-retry-lifecycle.ts` `canRetryTransport`, `isRetryableSemantics`) | 네트워크·타임아웃·429·408/425/502/503/504 뒤 같은 키로 다시 보낸다. 전송 여부를 보지 않는다 (`src/adapters/http/retry-policy.ts` `shouldRetry`) | `KEYED_COMMAND`는 유효한 키가 있고 profile `retryOwner`가 `FRONTEND_ADAPTER`면 `retryableFailures`에서 같은 키로 다시 보낸다 (`src/adapters/browser-rpc/browser-rpc-runtime.ts` `shouldRetry`) |
|
||||
| 재시도 횟수 상한 | min(계약 `retryBudget`, `MAX_RETRY_ATTEMPTS`, 2) (`http-execution-v3.ts` `retryCeiling`) | `MAX_RETRY_ATTEMPTS`, 기본 2 (`client.ts` `maxRetryAttempts`) | profile `maxAttempts`(시도 횟수), 하드 상한 4 (`src/contracts/browser-rpc.ts` `BROWSER_RPC_HARD_LIMITS`) |
|
||||
| `Retry-After` | 5초를 넘으면 재시도하지 않는다. 이하면 hint에 jitter를 더해 기다린다 (`http-retry-lifecycle.ts` `retryDelayFor`) | 30초를 넘으면 재시도하지 않는다. 이하면 max(backoff, hint)만큼 기다린다 (`retry-policy.ts`) | profile `maxRetryAfterMs`로 잘라 max(backoff, hint)만큼 기다린다. 하드 상한 60초 (`browser-rpc-runtime.ts` `retryDelay`) |
|
||||
| `REQUEST_TIMEOUT_MS` | 상한이다. 계약 `totalDeadlineMs`를 줄이기만 한다 (`runtime-adapters.ts` `requestDeadlineCeilingMs`) | 기본값이다. operation `timeoutMs`가 있으면 그 값을 쓰고, 더 길 수도 있다 (`client.ts` `defaultTimeoutMs`) | 쓰지 않는다. operation `totalDeadlineMs`만 쓴다. 하드 상한 30분 |
|
||||
| 규칙 | V3 contract executor | Browser RPC |
|
||||
|---|---|---|
|
||||
| KEYED 명령 자동 재시도 | 전송 전 실패만 재시도한다. 전송 뒤 실패는 재시도하지 않고 `MAYBE_APPLIED`다. 응답으로는 재시도하지 않는다. 예외: Envelope operation이 503 `IDEMPOTENCY_UNAVAILABLE`(실행 전 거절, 백엔드 §2가 같은 키 재전송을 요구)을 받으면 `retryBudget` 안에서 같은 키로 다시 보낸다 (`src/adapters/http/http-retry-lifecycle.ts` `canRetryTransport`, `isRetryableSemantics`, `backend-envelope.ts` `invitesKeyedResend`) | `KEYED_COMMAND`는 유효한 키가 있고 profile `retryOwner`가 `FRONTEND_ADAPTER`면 `retryableFailures`에서 같은 키로 다시 보낸다 (`src/adapters/browser-rpc/browser-rpc-runtime.ts` `shouldRetry`) |
|
||||
| 재시도 횟수 상한 | min(계약 `retryBudget`, `MAX_RETRY_ATTEMPTS`, 2) (`http-execution-v3.ts` `retryCeiling`) | profile `maxAttempts`(시도 횟수), 하드 상한 4 (`src/contracts/browser-rpc.ts` `BROWSER_RPC_HARD_LIMITS`) |
|
||||
| `Retry-After` | 5초를 넘으면 재시도하지 않는다. 이하면 hint에 jitter를 더해 기다린다 (`http-retry-lifecycle.ts` `retryDelayFor`) | profile `maxRetryAfterMs`로 잘라 max(backoff, hint)만큼 기다린다. 하드 상한 60초 (`browser-rpc-runtime.ts` `retryDelay`) |
|
||||
| `REQUEST_TIMEOUT_MS` | 상한이다. 계약 `totalDeadlineMs`를 줄이기만 한다 (`runtime-adapters.ts` `requestDeadlineCeilingMs`) | 쓰지 않는다. operation `totalDeadlineMs`만 쓴다. 하드 상한 30분 |
|
||||
|
||||
결과 불명 뒤 사용자 재전송은 전송과 무관하게 같은 intent·같은 키를 쓴다
|
||||
(`src/presentation/adapters/query/application-query.ts` `resendUnknownEffect`).
|
||||
|
||||
@@ -351,25 +351,38 @@ digest 또는 별도 검토된 streaming hash adapter를 사용한다.
|
||||
|
||||
- preview 대상 교체, load error, unmount에서 정확히 한 번 revoke한다.
|
||||
- one-shot 작은 download는 click handoff 뒤 cross-engine scheduling을 위해 기본
|
||||
30초 grace를 두고 revoke한다. feature/runtime dispose는 grace를 기다리지 않고
|
||||
30초 grace를 두고 revoke한다. runtime dispose는 grace를 기다리지 않고
|
||||
모든 active lease를 즉시 revoke한다.
|
||||
- preview와 download는 runtime 하나의 lease registry를 같이 쓴다
|
||||
(`src/adapters/browser-files/create-browser-file-runtime.ts:154`, `:163`).
|
||||
lease 개수나 합계 바이트 한도가 차면 둘 다 `LIMIT_EXCEEDED`를
|
||||
`retryable: true`, `recovery: "RETRY"`로 반환한다
|
||||
(`src/adapters/browser-files/object-url-lease.ts:48-73`, `:131-139`). download
|
||||
lease는 grace(`download-delivery-adapter.ts:149`)가 끝나면 풀리므로 잠시 뒤
|
||||
(`src/adapters/browser-files/object-url-lease.ts:48-71`, `:143-151`). download
|
||||
lease는 grace(`download-delivery-adapter.ts:150`)가 끝나면 풀리므로 잠시 뒤
|
||||
다시 시도하면 된다. Blob 하나가 단일 lease 상한을 넘으면 재시도 불가다.
|
||||
- 한도는 같이 쓰지만 해제 권한은 나뉜다. `runtime.previews.dispose()`와
|
||||
download의 `dispose()`는 각자 만든 lease만 revoke한다(`ObjectUrlLeaseScope`).
|
||||
registry 전체를 비우는 것은 `runtime.dispose()`뿐이다. `previews.dispose()`
|
||||
뒤에는 그 runtime의 preview가 계속 `UNAVAILABLE`이므로 route 정리에는 쓰지
|
||||
않고 lease마다 `release()`한다.
|
||||
- URL을 global state, IndexedDB, query cache, log, analytics에 보관하지 않는다.
|
||||
- Service Worker에서 object URL을 사용하지 않는다.
|
||||
- 로그아웃·계정 전환에서는 runtime 전체를 dispose한다. browser file runtime은
|
||||
세션을 모른다(`src/adapters/browser-files/create-browser-file-runtime.ts:93`).
|
||||
`runtime.dispose()`(`:177-185`)가 이전 사용자가 고른 File 참조, preview lease,
|
||||
진행 중 download(`download-delivery-adapter.ts:385-391`)를 한 번에 닫는다.
|
||||
runtime을 route·feature보다 오래 사는 곳에서 만들었다면 server-state scope
|
||||
reset participant(`src/adapters/query-cache/server-state-scope-runtime.ts:19`,
|
||||
등록 예 `src/bootstrap/runtime-adapters.ts:410-416`)로 `dispose()`를 등록하고
|
||||
다음 세대에서 새 runtime을 만든다. dispose한 runtime은 다시 쓸 수 없다.
|
||||
`runtime.dispose()`(`:177-188`)가 이전 사용자가 고른 File 참조, preview lease,
|
||||
진행 중 download(`download-delivery-adapter.ts:390-396`)를 한 번에 닫는다.
|
||||
runtime을 route·feature보다 오래 사는 곳(`product-composition.ts`의
|
||||
capability)에서 만들었다면 제품 소유 파일만 고친다. `composeProduct`가
|
||||
`scopeParticipants`로 `dispose()`를 돌려주면 템플릿이 로그아웃·계정 전환마다
|
||||
FENCED와 READY 사이에서 부르고, 실패하면 READY로 가지 않는다
|
||||
(`ProductScopeParticipant`, `src/bootstrap/product-composition-contract.ts`).
|
||||
`composeProduct`는 부팅 때 한 번만 불리므로 기능에는 runtime 대신 getter를
|
||||
주고 그 뒤에서 세대마다 새 runtime을 만든다. 예제는
|
||||
`recipes/frontend-capabilities/browser-file-session-capability.ts`이고
|
||||
`tests/recipes/browser-file-session-capability.test.ts`가 계정 전환 뒤 이전
|
||||
runtime의 읽기가 `UNAVAILABLE`, 진행 중 download가 `ABORTED`(handoff 0회),
|
||||
다음 세대의 파일 선택이 성공함을 확인한다(2026-11-03 02-01). dispose한
|
||||
runtime은 다시 쓸 수 없다.
|
||||
- SVG, HTML, untrusted PDF 같은 active content를 same-origin object URL iframe에
|
||||
직접 preview하지 않는다. 별도 격리 origin 또는 안전한 decode/re-encode 결과,
|
||||
아니면 attachment-only 정책을 사용한다.
|
||||
@@ -434,7 +447,10 @@ stream-to-file에서 integrity를 close 전에 확인해야 하면 writable을
|
||||
`INTEGRITY_FAILED` 또는 partial-save failure를 반환한다.
|
||||
|
||||
전략, media type, safe extension, integrity mode와 최대 bytes는 composition
|
||||
registry가 소유한다. caller는 composition이 등록한 정확한
|
||||
registry가 소유한다. registry는 사용자 파일명에서 지우는 위험 확장자
|
||||
(`.exe`, `.html`, `.js` 등)이거나 그것으로 끝나는 safe extension을 조립 때
|
||||
거절한다(2026-11-01 02-02). media type과 확장자가 서로 맞는지는 아직 보지
|
||||
않는다. caller는 composition이 등록한 정확한
|
||||
`FilePolicyReference` 객체, 아래 source union의 최소 입력, filename과 limit
|
||||
reduction만 전달한다. `policyKey`/`intention`이 같은 새 객체나 raw 전략을
|
||||
제출할 수 없다. source는 다음처럼 분리한다.
|
||||
@@ -971,6 +987,17 @@ preflight와 정확히 2 MiB(2,097,152 bytes) cap의 stream reader로 완전히
|
||||
strict UTF-8와 runtime schema를 검증하며, cap을 넘으면 reader를 cancel하고
|
||||
`CORRUPT_DATA`로 fail-closed한다.
|
||||
|
||||
active pointer의 rollback 목록 길이는 읽을 때 현재
|
||||
`retainedPreviousReleaseCount`와 비교하지 않는다. 더 큰 값으로 쓴 pointer도
|
||||
정상으로 읽고, 다음 activation이 목록을 현재 값으로 자른다. 읽을 수 없는
|
||||
pointer(`CORRUPT_DATA`: 손상, 또는 지금 정책으로 허용되지 않는 ID)는 조회와
|
||||
cleanup을 계속 막지만, 다음 `activateRelease`가 전체 재검증을 통과한 후보로
|
||||
rollback 목록 없이 덮어쓴다. pointer 읽기의 일시 오류는 activation을 멈춘다
|
||||
(0929/02-01). 그동안 `inspect()`는 멈추지 않고 `activePointer: "UNREADABLE"`과
|
||||
남은 후보 목록을 돌려준다. 운영자는 다음 activation이 무엇을 덮어쓰고 그 뒤
|
||||
cleanup이 무엇을 지울지 볼 수 있다. 일시 오류에서는 inspect도 실패한다
|
||||
(2026-11-03 02-05).
|
||||
|
||||
현재 `cleanupOwned()`와 `inspect()`는 위 ownership/integrity 경계를 지키지만
|
||||
cache count에 대한 cursor, per-invocation max count와 deadline은 제공하지 않는다.
|
||||
따라서 cache 수에 비례한 unbounded maintenance를 production boot path에
|
||||
|
||||
@@ -80,22 +80,26 @@ delivery/cleanup을 검증한다. 다만 production QueryClient/coordinator까
|
||||
account transition, bfcache/StrictMode lifecycle E2E는 없고, 현재 보존 artifact도
|
||||
Chromium/Firefox만 통과해 WebKit을 포함한 promotion evidence는 충족하지 않는다.
|
||||
localStorage fallback physical key는 storage registry의
|
||||
`CACHE_INVALIDATION_PULSE` 항목에서 온다(`src/contracts/storage-keys.ts:102`,
|
||||
`CACHE_INVALIDATION_PULSE` 항목에서 온다(`src/contracts/storage-keys.ts:112`,
|
||||
`src/adapters/cross-context-invalidation/browser-cross-context-host.ts:36-37`).
|
||||
값은 envelope 없는 wire JSON이라 이 항목은 `backend: "external"`이다.
|
||||
registry는 이름만 갖고, StoragePort는 이 key를 거절한다(05-01).
|
||||
host facade는 native `StorageEvent.storageArea`를 캡처한 `localStorage` 객체와
|
||||
동일성으로 비교하고(`browser-cross-context-host.ts:286-296`), core는
|
||||
`EXPECTED_LOCAL_STORAGE`로 표시된 pulse만 받는다
|
||||
(`browser-cross-context-invalidation.ts:197-201`).
|
||||
|
||||
현재 epoch는 release 하나다. `cacheEpoch`는 release ID의 64-bit FNV-1a digest를
|
||||
`release.<16자리 hex>`로 쓴 값이다(`browser-cross-context-host.ts:45-51`, 조립
|
||||
`src/bootstrap/runtime-adapters.ts:364-366`). 세션 identity가 바뀌면 scope
|
||||
`release.<16자리 hex>`로 쓴 값이다(`browser-cross-context-host.ts`
|
||||
`crossContextCacheEpochForRelease`, 조립은 `src/bootstrap/runtime-adapters.ts`의
|
||||
`createServerStateGenerationStore` 콜백). 세션 identity가 바뀌면 scope
|
||||
runtime이 다음 server-state generation을 열고
|
||||
(`src/adapters/query-cache/server-state-scope-runtime.ts:148`), generation마다
|
||||
새 `QueryClient`와 새 cross-context transport(새 `sourceId`·`sourceEpoch`)를
|
||||
만든다(`src/bootstrap/server-state-generation-store.ts:50-57`,
|
||||
`runtime-adapters.ts:359-372`). 이전 generation의 transport는 coordinator
|
||||
dispose에서 닫힌다(`src/adapters/query-cache/tanstack-cache-coordinator.ts:276-280`).
|
||||
(`src/adapters/query-cache/server-state-scope-runtime.ts`의
|
||||
`activateNextGeneration` 호출), generation마다 새 `QueryClient`와 새
|
||||
cross-context transport(새 `sourceId`·`sourceEpoch`)를 만든다
|
||||
(`src/bootstrap/server-state-generation-store.ts:50-57`, 같은 콜백). 이전
|
||||
generation의 transport는 coordinator `dispose()`에서 닫힌다
|
||||
(`src/adapters/query-cache/tanstack-cache-coordinator.ts`).
|
||||
session/account epoch, opaque account partition과 durable namespace epoch는
|
||||
아직 없다. wire event에 사용자·세션 scope가 없으므로 현재 cross-tab event는 같은
|
||||
release의 등록 query topic을 빠르게 stale 처리하는 용도에 한정된다.
|
||||
@@ -464,6 +468,13 @@ normative key layout:
|
||||
non-finite number, DOM/native object를 fail-closed로 거절한다.
|
||||
- array 순서는 의미가 있으므로 유지한다.
|
||||
- query namespace는 arbitrary caller string이 아니라 registry reference다.
|
||||
현재 구현(03-01): `QueryDefinition.namespace`에 무효화 registry의
|
||||
`QueryNamespaceIdentity` 객체를 그대로 넘긴다(참조 기능이 이렇게 한다).
|
||||
예전 형태인 문자열 id와 `namespaceVersion` 쌍도 아직 받는다. 어느 등록
|
||||
topic도 닿지 않는 namespace로 bound query가 만들어지면 cache coordinator가
|
||||
namespace당 한 번 `cache.operation.failed`(`operation:
|
||||
unregistered-query-namespace`) 진단을 남긴다. 저장으로 무효화할 일이 없는
|
||||
정적 조회는 `invalidation: "NONE"`으로 선언해 이 진단에서 뺀다.
|
||||
- cross-tab event에는 전체 query key나 filter를 넣지 않는다.
|
||||
|
||||
현재 `src/contracts/query-keys.ts`의 `canonicalize()`는 object key order는
|
||||
|
||||
@@ -19,6 +19,9 @@ The placement rule is:
|
||||
- one feature owner -> keep it under that feature,
|
||||
- one reusable capability owner -> keep it under that adapter/capability and
|
||||
export it through the capability public entry point,
|
||||
- a product-neutral primitive any layer may call, with no product vocabulary
|
||||
in it (a budget, deadline, retry, execution context, telemetry pipeline step
|
||||
or error envelope) -> `src/platform`,
|
||||
- multiple independent capability/layer owners -> `src/contracts`,
|
||||
- browser/build/release wire or artifact authority -> `src/contracts` even
|
||||
when the browser source graph alone looks small.
|
||||
@@ -26,6 +29,17 @@ The placement rule is:
|
||||
Consumer count alone is not sufficient. Scripts, generated artifacts and
|
||||
release gates are semantic consumers too.
|
||||
|
||||
`src/platform` and `src/contracts` differ in what they hold. `src/contracts`
|
||||
holds the product's shared vocabulary: registries, schemas and wire formats
|
||||
such as routes, API operations, storage keys and release artifacts.
|
||||
`src/platform` holds mechanisms that work without that vocabulary, plus the
|
||||
few error kinds no feature owns (network, deadline, cancellation, response
|
||||
bounds). Today `src/contracts` imports `src/platform` and not the other way
|
||||
round. `platform-kernel-is-product-neutral` stops `src/platform` from importing
|
||||
any feature, context, app, adapter, bootstrap, presentation or application
|
||||
module. A primitive that needs a route, an API operation or a feature's
|
||||
vocabulary is not product-neutral: put it in `src/contracts` or with its owner.
|
||||
|
||||
## Audit result
|
||||
|
||||
The September 2026 architecture review triggered an import-graph audit of all
|
||||
|
||||
@@ -21,9 +21,11 @@ JavaScript에 분산돼 있었다. 날짜는 일부 application mapper에서 고
|
||||
2. `MessageKey`는 한국어 canonical catalog에서 도출하며 영어와 RTL smoke
|
||||
catalog는 `satisfies Record<MessageKey, string>`으로 compile-time parity를
|
||||
강제한다.
|
||||
3. 보간이 필요한 key는 `MessageParameters`에 key별 parameter object를
|
||||
선언한다. 잘못된 key, 누락·초과 parameter는 TypeScript negative fixture가
|
||||
거절한다.
|
||||
3. 보간 parameter는 catalog 문자열의 `{이름}`에서 도출한다(0929/08-03).
|
||||
값 타입은 `string | number`다. 값 타입을 좁히고 싶은 key만
|
||||
`MessageParameters`에 key별 parameter object를 선언한다. 기능 catalog의
|
||||
key도 같은 규칙을 쓰므로 기능이 이 파일을 고치지 않는다. 잘못된 key,
|
||||
누락·초과 parameter는 TypeScript negative fixture가 거절한다.
|
||||
4. 기본 locale은 `ko-KR`, fallback locale도 `ko-KR`이다. 알려지지 않은 locale은
|
||||
language fallback 후 `ko-KR`로 정규화한다. 알려지지 않은 key와 누락 보간은
|
||||
raw key나 외부 값을 출력하지 않고 안전한 공통 fallback을 반환한다.
|
||||
@@ -66,13 +68,22 @@ route/form/failure 의미 값
|
||||
|
||||
## 검증
|
||||
|
||||
- `check:i18n`은 catalog key와 placeholder parity, 화면 코드의 한국어 literal,
|
||||
backend message JSX 렌더링과 raw HTML 사용을 검사한다. 검사 범위는 공통 UI
|
||||
디렉터리, `src/presentation/pages`, 모든 `src/features/*/presentation`이다.
|
||||
컴포넌트 갤러리 `src/presentation/examples`는 일부러 뺐다
|
||||
(`scripts/check-i18n.ts`의 `commonDirectories`, `featurePresentationDirectories`).
|
||||
- `check:i18n:fixture`는 같은 탐색 규칙을 `tests/fixtures/i18n/forbidden` 트리에
|
||||
돌린다. fixture 파일 하나라도 거절되지 않으면 종료 코드 2로 실패한다.
|
||||
- `check:i18n`은 catalog key와 placeholder parity, backend message JSX 렌더링을
|
||||
검사한다. 검사 범위는 공통 UI 디렉터리, `src/presentation/pages`, 모든
|
||||
`src/features/*/presentation`이다. 플랫폼 구성 화면
|
||||
`src/presentation/examples`와 예제 화면
|
||||
`src/features/platform-examples-feature/presentation`(1103/09-04)은 화면
|
||||
문구 ESLint 규칙에서 일부러 뺐다(`eslint.config.ts`).
|
||||
- 화면 문구가 catalog에서 오는지는 ESLint `no-restricted-syntax`가 본다
|
||||
(`eslint.config.ts`의 `screenTextSelectors`, 0929/08-02). 대상은 글자가 든
|
||||
`JSXText`와 표시·접근성 속성(`aria-label`, `title`, `placeholder`, `alt`,
|
||||
`label` 등)의 문자열 literal이다. 주석은 AST에 없어 걸리지 않는다. 범위는 위와
|
||||
같고 stories는 뺐다. 제품은 이 선택자를 자기 설정으로 덮어쓸 수 있다.
|
||||
raw HTML은 FE-OC-019 ESLint 규칙이 거절한다.
|
||||
- `check:i18n:fixture`는 같은 탐색 규칙과 위 ESLint 규칙을
|
||||
`tests/fixtures/i18n/forbidden` 트리에 돌린다. fixture 파일 하나라도 거절되지
|
||||
않으면 종료 코드 2로 실패한다. `tests/fixtures/i18n/allowed` 트리(한국어 주석,
|
||||
구두점, catalog 문구)가 거절돼도 종료 코드 2로 실패한다.
|
||||
- `tests/unit/i18n-contract.test.ts`는 `ERROR_REGISTRY`의 모든 `userMessageKey`가
|
||||
ko-KR·en-US catalog에 있는지 확인한다.
|
||||
- type negative fixture는 unknown key와 잘못된 parameter shape를 거절한다.
|
||||
|
||||
@@ -43,13 +43,27 @@ vendor 결정 전에는 안전한 기본값이 아니다.
|
||||
`createHttpObservationProjector`가 유일한 projection authority다. observation은
|
||||
arbitrary context map이 아니며 projector는 `route_id`, `operation_id`,
|
||||
`operation`, `outcome`, `error_kind`, `http_status_group`,
|
||||
`attempt_count_bucket`, `duration_bucket`만 사용한다. diagnostics에만
|
||||
`attempt_count_bucket`, `duration_bucket`, `effect_certainty`만 사용한다.
|
||||
`effect_certainty`는 V3 `HttpEffectCertainty` 다섯 값(`NOT_APPLICABLE`,
|
||||
`NOT_STARTED`, `NOT_APPLIED`, `APPLIED_CONFIRMED`, `MAYBE_APPLIED`)만 받는 닫힌
|
||||
value policy(`isEffectCertainty`)를 두 sink가 함께 쓴다. 결과 불명 쓰기의 수를
|
||||
세기 위해서다(1103/03-05). diagnostics에만
|
||||
`correlation_id`(서버가 돌려준 `x-correlation-id`, 없으면 실행이 보낸 요청 ID)를
|
||||
더한다. telemetry에는 넣지 않는다(03-03, `createHttpObservationProjector`). raw attempt count,
|
||||
더한다. telemetry에는 넣지 않는다(03-03, `createHttpObservationProjector`).
|
||||
실행이 observation의 `diagnosticReason`(닫힌 집합 `HttpDiagnosticReason`)을
|
||||
남기면 diagnostics에만 `reason`으로 더한다. 값은 넷 중 하나다. 기능 패키지의
|
||||
`classifyProblem`이 throw하거나 집합 밖 값을 돌려줘 효과를 `MAYBE_APPLIED`로
|
||||
떨어뜨린 `CLASSIFIER_FAILED`(03-05), 전송 전에 거절한 요청의 원인
|
||||
`HttpRequestRejectionReason`(입력 검증 실패, 요청 조립 실패, 최종 불변식 실패,
|
||||
미설치 계약 `CONTRACT_NOT_INSTALLED`, 03-02), Envelope 백엔드가 멱등 키를
|
||||
거절한 `IdempotencyRefusalReason`, 그리고 Envelope 명령의 결과를 모르게 된
|
||||
원인 `UnknownEffectReason`(`IN_FLIGHT`, `IDEMPOTENCY_UNAVAILABLE`,
|
||||
`COMPLETION_UNKNOWN`, `RECOVERY_REQUIRED`, `SERVER_TIMEOUT`, `STAGE_UNKNOWN`,
|
||||
1103/03-05)이다. 백엔드 `error.code` 원문은 싣지 않는다. 미설치 계약은 실행기를
|
||||
거치지 않으므로 조립 지점이 같은 projector로 관측 1건을 직접 남긴다.
|
||||
raw attempt count,
|
||||
duration, status, URL, intent, key, input identity와 내부 `terminalReason`은
|
||||
sink로 나가지 않는다. effect certainty가 운영상 필요해지면 `effect_certainty`
|
||||
key와 닫힌 value policy를 contract·fixture·이 ADR에 동시에 추가한 뒤에만
|
||||
전달한다.
|
||||
sink로 나가지 않는다.
|
||||
5-2. caller cancellation과 scope fence는 API failure가 아니다. diagnostics는 한
|
||||
번 남기고 `api.request.failed`는 발행하지 않는다. 자격증명이 없어 한 번도
|
||||
보내지 않은 `UNAUTHENTICATED`(응답 status 없음)도 같다(03-07,
|
||||
|
||||
@@ -1,9 +1,17 @@
|
||||
# VD-23: API transport selection과 REST execution
|
||||
|
||||
- 상태: Accepted — REST v2 security/execution baseline composed, advanced profiles pending
|
||||
> **정본 안내 (non-authoritative for runtime capability decisions)**
|
||||
>
|
||||
> Runtime Config/boot, Fetch HTTP client, Router, Query/Mutation, realtime 공통 경계, Web Worker,
|
||||
> Service Worker, offline command와 Background Sync의 구현 결정은
|
||||
> [프론트엔드 런타임 Capability 저장소 정합형 구현 결정 폐쇄 상세 설계](../2026-07-30-frontend-runtime-capability-repository-aligned-implementation-closed-deep-design.md)가 정본이다.
|
||||
> 본 결정의 해당 서술이 정본과 충돌하면 정본을 따른다.
|
||||
|
||||
- 상태: Accepted — REST v2 실행 경로는 2026-11-03에 지웠다(`048f490`·`12f3bb7`). 지금 REST 실행은 V3 contract executor다. advanced profiles pending
|
||||
- 결정일: 2026-07-28
|
||||
- installed REST reference vertical: `COMPOSED`
|
||||
- REST v2 security/execution baseline: `COMPOSED`
|
||||
- REST v2 security/execution baseline: `REMOVED` (2026-11-03, `048f490`·`12f3bb7`)
|
||||
- V3 contract executor(descriptor → FE-REG-API 행 투영, 짝 백엔드 Envelope 판정): `COMPOSED`
|
||||
- provider/path/auth profile baseline: `COMPOSED`
|
||||
- conditional execution/provider-conformance delta: `DESIGNED_NOT_IMPLEMENTED`
|
||||
- GraphQL/Connect/gRPC-Web/REST Gateway product selection: `NOT_SELECTED`
|
||||
@@ -23,8 +31,9 @@ TanStack Query까지 실제 production composition에 연결된다. 따라서 RE
|
||||
현재 reference operation은 v2 metadata, collision-aware composition, allowlisted
|
||||
credential patch, auth fail-before-fetch, prefix-preserving target, shared logical
|
||||
deadline, exact JSON media/success status, bounded decoder와 typed mapping failure를
|
||||
실행한다. correlation header, success status group과 401 replay를 포함한 physical
|
||||
attempt도 terminal observation에 연결한다.
|
||||
실행한다. correlation header와 success status group을 포함한 physical attempt도
|
||||
terminal observation에 연결한다. 401은 끝이다. 숨은 refresh-and-replay는 하지 않는다
|
||||
(정본 8.4, FRT-D016). 이 절의 "v2 metadata" 서술은 2026-11-03 V2 삭제 전의 기록이다.
|
||||
|
||||
operation은 path placeholder↔codec key exact join, named provider/bearer/CSRF
|
||||
profile, provider credential-mode ceiling과 encoded query byte ceiling도 실행한다.
|
||||
@@ -61,6 +70,10 @@ feature use case
|
||||
|
||||
### 2. REST operation은 실행 source와 정적 manifest를 분리하지 않는다
|
||||
|
||||
> 2026-11-03: 아래 `defineRestOperation`(V2 행)은 지웠다(`12f3bb7`). 지금 operation은
|
||||
> contract contribution의 V3 descriptor 하나로 적고, FE-REG-API 행은 그 descriptor에서
|
||||
> 뽑는다(`src/contracts/api-operations.ts`).
|
||||
|
||||
목표 API는 feature가 generic이 연결된 definition을 만든다.
|
||||
|
||||
```text
|
||||
@@ -303,7 +316,7 @@ allowed/required credential header 집합을 독립적으로 재검증한다.
|
||||
|
||||
`AUTH_MODE=demo`는 profile을 약화시키지 않는다. `createDemoSessionAdapter`가
|
||||
고정된 비밀 아닌 `DEMO_AUTHORIZATION_MARKER` proof header를 제공하여 strict
|
||||
`REFERENCE_EXTERNAL_BEARER`를 그대로 만족시킨다. 진짜 anonymous backend는 별도
|
||||
`EXTERNAL_BEARER`(16-03 전 이름 `REFERENCE_EXTERNAL_BEARER`)를 그대로 만족시킨다. 진짜 anonymous backend는 별도
|
||||
anonymous contract/profile을 composition에서 선택해야 한다.
|
||||
|
||||
credential collaborator는 `AuthOperationContext { signal, deadlineAtMonotonicMs }`를
|
||||
@@ -419,9 +432,10 @@ network failure
|
||||
- schema, mapper, 4xx validation/authz/conflict와 redirect failure는 retry하지 않는다.
|
||||
- caller cancel, navigation supersede, runtime teardown, attempt timeout과 logical
|
||||
deadline을 다른 safe failure로 유지한다.
|
||||
- 401 recovery는 auth-required이면서 replay-safe한 operation만 한 번 수행한다.
|
||||
- 동시 401은 session owner의 single-flight recovery를 공유한다.
|
||||
- physical attempt, logical retry와 auth replay를 따로 관측한다.
|
||||
- 401 response 뒤 숨은 refresh-and-replay를 하지 않는다. command를 새 credential로
|
||||
자동 replay하지 않는다(정본 8.4, FRT-D016). 자격 증명 owner가 보내기 전에
|
||||
credential을 준비하고, 401은 그 요청의 끝이다.
|
||||
- physical attempt와 logical retry를 따로 관측한다.
|
||||
|
||||
### 9. Closed execution
|
||||
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user