frontend-quality-gates / merge / static checks (pull_request) Successful in 1m19s
frontend-quality-gates / merge / tests (pull_request) Successful in 18m24s
frontend-quality-gates / merge / browser tests (pull_request) Successful in 5m20s
frontend-quality-gates / FE-GATE-017 / diagram-review (pull_request) Skipped
frontend-quality-gates / main / self-tests and removal drills (pull_request) Skipped
frontend-quality-gates / FE-GATE-014 / config-compatibility (pull_request) Skipped
frontend-quality-gates / FE-GATE-028 / manual-accessibility-review (pull_request) Skipped
frontend-quality-gates / FE-GATE-026 / lab-performance (pull_request) Skipped
frontend-quality-gates / FE-GATE-015 / immutable-release-candidate (pull_request) Skipped
frontend-quality-gates / external-vulnerability-provider (pull_request) Skipped
frontend-quality-gates / external-provenance-provider (pull_request) Skipped
frontend-quality-gates / promote-verified-immutable-candidate (pull_request) Skipped
frontend-quality-gates / deploy-promoted-release (pull_request) Skipped
frontend-quality-gates / FE-GATE-019 / hosting-header (pull_request) Skipped
frontend-quality-gates / FE-GATE-021 / runbook-boot-config (pull_request) Skipped
frontend-quality-gates / FE-GATE-022 / runbook-chunk-mismatch (pull_request) Skipped
frontend-quality-gates / FE-GATE-023 / runbook-api-degradation (pull_request) Skipped
frontend-quality-gates / FE-GATE-024 / runbook-telemetry (pull_request) Skipped
frontend-quality-gates / FE-GATE-025 / runbook-release-rollback (pull_request) Skipped
frontend-quality-gates / FE-GATE-018 / field-web-vitals (pull_request) Skipped
main e98d8ee9에서 FE-GATE-005가 실패한다. `tests/unit/feature-shape-growth.test.ts`가 기록 `config/scale/feature-shape-ceilings.json`의 `perContextGzipBytes`를 28, 빌드를 7로 본다. 허용 폭은 max(10%, 16 B)라 21 B 차이는 넘는다. main push run 308의 `merge / tests`(FE-GATE-005)와 `main / self-tests and removal drills`(FE-GATE-030, 레시피 제거 사본의 같은 시험)가 이 한 줄로 빨갛다. 첫 빨강은 #56 병합(e98d8ee9)이다. 기록 28을 쓴 d5083f86은 #56 가지의 커밋이고, 그 가지는 #51·#53 전 main(7e5a0bb8) 위에 있다. 가지 위에서는 맞는 값이었고, #51·#53과 합친 트리에서 낡았다(desktop, 측정 스크립트 `--initial-baseline`, 커밋마다 따로 잼): 커밋 기록 perContext 잰 값cfb32a66(#51 병합) 21 9 통과271f11d0(#53 병합) 21 14 통과91b3aaac(#56 head) 28 28 통과e98d8ee9(#56 병합) 28 7 실패 7이 맞는 측정인 근거: e98d8ee9를 build id가 다른 세 번(desktop 둘, runner #58 하나) 재어 다섯 칸이 바이트까지 같다 (`{"gzipBytes":194339,"files":15,"firstFeatureGzipBytes":6221, "perFeatureGzipBytes":521,"perContextGzipBytes":7}`). context 하나가 더하는 양이 줄어든 것이라 회귀가 아니고, 상한 512 B 안이다. 고른 방법: 저장소가 정한 재측정 명령 `node scripts/scale/measure-feature-shape-growth.ts --initial-baseline --write` (desktop, `scripts/verify.sh exec --apply-back`)가 쓴 그대로 넣는다. 손으로 고친 숫자는 없다. 같은 명령이 `gzipBytes` 194143 → 194339(#53이 더한 boot 코드, 허용 256 B 안이었지만 여유가 60 B였다)와 `firstFeatureGzipBytes` 6192 → 6221도 맞춘다. `serviceWorkerPrecache`는 빌드와 같아 바뀌지 않았다. 버린 대안: 허용 폭을 넓힌다(게이트 기준을 낮추는 일이라 하지 않는다). 위험·한계: context 비용은 몇 바이트라 gzip 정렬만으로 커밋마다 7~28 B를 오간다. 초기 청크를 건드리는 두 PR이 각자 base에서 기록을 쓰면 합친 뒤 다시 낡을 수 있다. 측정 방식을 바꾸는 일은 이 커밋에서 하지 않았다. 검증(desktop, 이 커밋의 트리44cff6f2): `scripts/verify.sh gate FE-GATE-005` rc=0(143초), `scripts/verify.sh gate FE-GATE-030` rc=0 (279초). runner merge job은 PR run에서 본다. Refs: main run 308
61 lines
4.6 KiB
JSON
61 lines
4.6 KiB
JSON
{
|
|
"schemaVersion": 1,
|
|
"baseline": "config/scale/feature-shape-growth.json",
|
|
"ceilings": {
|
|
"contextMaxFeatures": 200,
|
|
"appMaxContexts": 20
|
|
},
|
|
"summary": "상한은 개수를 제한할 뿐, 검증된 수용량이 아니다. 앱 하나의 실제 한계는 먼저 초기 JavaScript budget이고, 그다음 typecheck 메모리다. Service Worker를 켜면(SERVICE_WORKER: ACTIVE) 그 전에 precache 자산 수 상한(SERVICE_WORKER_BOUNDS.assets)이 올 수 있다. 기능마다 lazy 청크가 늘고 그 전부를 precache하기 때문이다. 기능 하나가 더하는 파일 수는 아래 serviceWorkerPrecache에 있다. 400개 feature는 재지 않았다(D-18이 선택 사항으로 둔다).",
|
|
"axes": [
|
|
{
|
|
"axis": "Typecheck of one app",
|
|
"verified": "100개 feature까지 선형이다. feature 하나에 instantiation 약 101k, tsc 메모리 31 MB",
|
|
"condition": "create:feature가 --with-create --keyed로 만드는 feature의 사본(2026-11-07부터. 그 전에는 참조 샘플 사본), tsconfig.app.json, 기준선에 기록된 host",
|
|
"notVerified": "200개 feature(context 하나를 꽉 채운 수)와 그 이상. 같은 기울기라면 4,000개(20 x 200)에는 125 GB 규모가 필요하다"
|
|
},
|
|
{
|
|
"axis": "Production build",
|
|
"verified": "100개 feature에서 몇 초 안에 끝난다",
|
|
"condition": "위와 같음",
|
|
"notVerified": "100개 초과"
|
|
},
|
|
{
|
|
"axis": "Initial JavaScript",
|
|
"verified": "15-01: boot 때는 각 feature의 선언(route 표, 메시지, 무효화 식별자)만 로드된다. runtime 쪽 절반은 그 feature의 route와 함께 로드된다. 아래 initialJavascript에는 네 가지가 있다. feature가 없는 지금 템플릿 빌드, 첫 feature가 한 번 더하는 크기(firstFeatureGzipBytes: 모든 feature가 함께 쓰는 코드가 초기 chunk에 들어간다), 기존 context에 feature 하나를 더할 때 늘어나는 크기(perFeatureGzipBytes), 두 번째 context가 더하는 크기(perContextGzipBytes)다. tests/unit/feature-shape-growth.test.ts가 unit 실행마다 이것을 잰다. feature 하나는 1 KiB, context 하나는 512 B로 제한하고, 기록이 빌드와 맞지 않으면 실패한다. 25개·100개 사본 측정은 source commit 시점의 기준선에 있다(15-01 전: 사본 하나당 +3,922 B)",
|
|
"condition": "위와 같음. 여기에 vite.config.ts의 feature-declarations·feature-platform chunk 그룹",
|
|
"notVerified": "feature가 몇 개 들어가는지. 초기 budget(config/performance/budgets.json)에서 initialJavascript.gzipBytes와 firstFeatureGzipBytes를 빼고 perFeatureGzipBytes로 나눈 값이다(새 context마다 perContextGzipBytes를 더한다). platform 자체가 budget 대부분을 쓴다"
|
|
},
|
|
{
|
|
"axis": "Lazy JavaScript",
|
|
"verified": "feature 하나에 gzip 약 6.7 KB, 파일 9개. 모든 파일이 lazy chunk budget 120 KiB보다 훨씬 작다",
|
|
"condition": "위와 같음",
|
|
"notVerified": "lazy 파일이 많을 때의 다운로드 비용"
|
|
},
|
|
{
|
|
"axis": "Service Worker precache",
|
|
"verified": "Service Worker를 켜면(SERVICE_WORKER: ACTIVE) dist/assets의 해시 파일을 모두 precache한다. 아래 serviceWorkerPrecache에 지금 템플릿 빌드의 파일 수(assets), 첫 feature가 한 번 더하는 수(firstFeatureAssets), 기존 context에 feature 하나를 더할 때 느는 수(perFeatureAssets), 두 번째 context가 더하는 수(perContextAssets)가 있다. tests/unit/feature-shape-growth.test.ts가 unit 실행마다 Initial JavaScript와 같은 빌드로 잰다",
|
|
"condition": "Initial JavaScript와 같은 빌드. 그 빌드는 Service Worker를 끈 것이라, 켠 빌드는 등록 코드의 파일만큼 더 많다",
|
|
"notVerified": "feature가 몇 개까지 precache 자산 수 상한(src/contracts/service-worker.ts의 SERVICE_WORKER_BOUNDS.assets) 안에 드는지. 상한에서 assets와 firstFeatureAssets를 빼고 perFeatureAssets로 나눈 값이다(새 context마다 perContextAssets를 더한다). 상한과 precache 범위는 Service Worker 계약이다"
|
|
},
|
|
{
|
|
"axis": "Routes",
|
|
"verified": "feature 하나에 3개(list, detail, create). 충돌 없이 조합된다",
|
|
"condition": "위와 같음",
|
|
"notVerified": "runtime의 router 매칭 비용"
|
|
}
|
|
],
|
|
"initialJavascript": {
|
|
"gzipBytes": 194339,
|
|
"files": 15,
|
|
"firstFeatureGzipBytes": 6221,
|
|
"perFeatureGzipBytes": 521,
|
|
"perContextGzipBytes": 7
|
|
},
|
|
"serviceWorkerPrecache": {
|
|
"assets": 22,
|
|
"firstFeatureAssets": 14,
|
|
"perFeatureAssets": 12,
|
|
"perContextAssets": 0
|
|
}
|
|
}
|