From 0805910c47c5f248ec72221343ab2918d4d7aa9b Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sat, 7 Nov 2026 18:27:33 +0900 Subject: [PATCH] =?UTF-8?q?chore(config):=20=EC=95=84=EB=AC=B4=EB=8F=84=20?= =?UTF-8?q?=EC=9D=BD=EC=A7=80=20=EC=95=8A=EB=8A=94=20config/schemas?= =?UTF-8?q?=EC=9D=98=20JSON=20Schema=204=EA=B0=9C=EB=A5=BC=20=EC=A7=80?= =?UTF-8?q?=EC=9A=B4=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 문제: config/schemas/에 산출물 JSON Schema 4개가 있다. 코드·테스트· workflow·문서 어디서도 경로나 $id(ART-FE-FIELD-WEB-VITALS@1, ART-FE-LAB@1, ART-FE-003@1, ART-FE-RUNBOOK-DRILL@2)로 읽지 않는다 (git grep, CHANGELOG·리뷰 기록 제외). 산출물을 실제로 검사하는 것은 scripts/contracts/release-artifacts.ts의 zod schema다. 그런데도 81701ad(2026-11-05)가 lab 칸을 더하면서 이 파일도 손으로 고쳤다. 읽는 곳 없는 사본을 맞추는 일이 생긴다. schemas/의 생성 스키마와 비교: scripts/generate-artifact-schemas.ts가 만드는 4개(build-manifest, dependency-inventory, registry-snapshot, supply-chain-verification)와 이름·대상이 겹치는 것이 없다. 그래서 각 파일을 그 산출물의 zod 정본과 대조했다. - field-web-vitals ↔ fieldWebVitalsArtifactSchema: 최상위 칸 9개와 context 칸 9개가 같다. zod가 더 엄격하다(window.days = 28, consentRequired = true, 숫자 범위, 하위 객체 strict). - lab-performance ↔ labPerformanceArtifactSchema: zod는 context·metrics를 아무 객체로 받는다. JSON만 context 필수 칸 7개, metrics 필수 칸 5개, fixtures 2개 이상을 적었다. context 칸 7개는 scripts/lib/performance-budgets.ts evaluateLabBudget가 없으면 실패로 판정한다. metrics 5칸과 fixtures 3개는 scripts/test-performance.ts가 늘 만든다. - release-verification ↔ releaseVerificationArtifactSchema: zod가 더 엄격하다(artifact.releaseId 필수, fixture 칸 strict). JSON만 fixtures 2개 이상을 적었다. scripts/verify-release.ts는 config/release/coherence-fixtures.json의 4개를 쓴다. - runbook-drill-record ↔ runbookRecordArtifactSchema: 칸이 같다. zod는 result가 판정들의 합과 맞는지도 본다. JSON만 recoveryAssertions 4개 이상을 적었다. scripts/drill-runbook.ts의 runbook 5개는 모두 4개를 만든다. JSON에만 있는 최소 개수 셋은 지금 만드는 쪽이 늘 채우지만 아무도 검사하지 않는다. 이 파일도 읽는 곳이 없어 지워도 검사가 줄지 않는다. 버린 대안: schemas/로 옮기거나 zod에서 생성하기. 읽는 곳이 없는 파일을 옮기거나 생성하면 지킬 것 없는 사본이 하나 더 생긴다. 스키마 자리를 한 곳으로 모으는 일은 3단계(schemas/ → config/schemas/)다. 위험·한계: 다운스트림이 이 파일을 외부 도구에 물렸다면 그쪽이 끊긴다. 템플릿 안에는 그런 곳이 없다. 검증: git grep으로 경로와 $id 넷을 찾아 0건(CHANGELOG·리뷰 기록 제외). desktop(네 커밋의 끝 30a379f, 로그 ~/l1-layout-cleanup-logs/): check:types, test:unit(212 files, 3091 tests), check:ci, lint exit 0. Refs: design-docs repo-structure/04-frontend-layout.md 2.1절, 9.2절 --- config/schemas/field-web-vitals.schema.json | 78 ------------------- config/schemas/lab-performance.schema.json | 30 ------- .../schemas/release-verification.schema.json | 17 ---- .../schemas/runbook-drill-record.schema.json | 52 ------------- 4 files changed, 177 deletions(-) delete mode 100644 config/schemas/field-web-vitals.schema.json delete mode 100644 config/schemas/lab-performance.schema.json delete mode 100644 config/schemas/release-verification.schema.json delete mode 100644 config/schemas/runbook-drill-record.schema.json diff --git a/config/schemas/field-web-vitals.schema.json b/config/schemas/field-web-vitals.schema.json deleted file mode 100644 index b49b2b87..00000000 --- a/config/schemas/field-web-vitals.schema.json +++ /dev/null @@ -1,78 +0,0 @@ -{ - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$id": "ART-FE-FIELD-WEB-VITALS@1", - "type": "object", - "required": [ - "schemaVersion", - "generatedAt", - "window", - "context", - "metrics", - "thresholds", - "eligibility", - "status", - "passed" - ], - "properties": { - "schemaVersion": { "const": 1 }, - "generatedAt": { "type": "string", "format": "date-time" }, - "window": { "type": "object", "required": ["days", "start", "end"] }, - "context": { - "type": "object", - "required": [ - "source", - "sourceSystem", - "exportId", - "network", - "routeAggregation", - "releaseId", - "privacyApprovalRef", - "thresholdDecisionRef", - "validationFailures" - ], - "properties": { - "source": { "type": "string" }, - "sourceSystem": { "type": ["string", "null"] }, - "exportId": { "type": ["string", "null"] }, - "network": { "const": "production-real-user" }, - "routeAggregation": { "const": "route-id-only" }, - "releaseId": { "type": ["string", "null"] }, - "privacyApprovalRef": { "type": ["string", "null"] }, - "thresholdDecisionRef": { "type": ["string", "null"] }, - "validationFailures": { - "type": "array", - "items": { "type": "string" } - } - }, - "additionalProperties": false - }, - "thresholds": { - "type": "object", - "required": [ - "p75LcpMs", - "p75Cls", - "p75InpMs", - "minimumEligibleSamples" - ] - }, - "metrics": { - "type": "object", - "required": ["p75LcpMs", "p75Cls", "p75InpMs"] - }, - "eligibility": { - "type": "object", - "required": [ - "consentRequired", - "totalSamples", - "eligibleSamples", - "minimumEligibleSamples", - "routeSamples" - ] - }, - "status": { - "enum": ["PASS", "FAIL_THRESHOLD", "FAIL_UNVERIFIED"] - }, - "passed": { "type": "boolean" } - }, - "additionalProperties": false -} diff --git a/config/schemas/lab-performance.schema.json b/config/schemas/lab-performance.schema.json deleted file mode 100644 index 7d0297f0..00000000 --- a/config/schemas/lab-performance.schema.json +++ /dev/null @@ -1,30 +0,0 @@ -{ - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$id": "ART-FE-LAB@1", - "type": "object", - "required": [ - "schemaVersion", - "generatedAt", - "context", - "metrics", - "thresholds", - "fixtures", - "passed" - ], - "properties": { - "schemaVersion": { "const": 1 }, - "generatedAt": { "type": "string", "format": "date-time" }, - "context": { - "type": "object", - "required": ["runner", "browser", "viewport", "network", "cpu", "cache", "build"] - }, - "metrics": { - "type": "object", - "required": ["lcpMs", "cls", "namedInteractionMs", "targetDeepLinkCls", "featureRouteInteractionMs"] - }, - "thresholds": { "type": "object" }, - "fixtures": { "type": "array", "minItems": 2 }, - "passed": { "type": "boolean" } - }, - "additionalProperties": false -} diff --git a/config/schemas/release-verification.schema.json b/config/schemas/release-verification.schema.json deleted file mode 100644 index 29e5ff78..00000000 --- a/config/schemas/release-verification.schema.json +++ /dev/null @@ -1,17 +0,0 @@ -{ - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$id": "ART-FE-003@1", - "type": "object", - "required": ["schemaVersion", "generatedAt", "artifact", "fixtures", "passed"], - "properties": { - "schemaVersion": { "const": 1 }, - "generatedAt": { "type": "string", "format": "date-time" }, - "artifact": { - "type": "object", - "required": ["checked", "compatible", "mismatches"] - }, - "fixtures": { "type": "array", "minItems": 2 }, - "passed": { "type": "boolean" } - }, - "additionalProperties": false -} diff --git a/config/schemas/runbook-drill-record.schema.json b/config/schemas/runbook-drill-record.schema.json deleted file mode 100644 index 9affe249..00000000 --- a/config/schemas/runbook-drill-record.schema.json +++ /dev/null @@ -1,52 +0,0 @@ -{ - "$schema": "https://json-schema.org/draft/2020-12/schema", - "$id": "ART-FE-RUNBOOK-DRILL@2", - "type": "object", - "required": [ - "schemaVersion", - "runbookId", - "releaseId", - "drillTimestamp", - "triggerInjected", - "triggerAsserted", - "containmentAsserted", - "escalationPathAsserted", - "recoveryAssertions", - "negativeFixtureFailedAsExpected", - "windowObservedBucket", - "providerVerificationRequired", - "result" - ], - "$defs": { - "verdict": { "enum": ["PASS", "FAIL", "UNVERIFIED"] } - }, - "properties": { - "schemaVersion": { "const": 2 }, - "runbookId": { "pattern": "^FE-RB-00[1-5]$" }, - "releaseId": { "type": "string", "minLength": 1 }, - "drillTimestamp": { "type": "string", "format": "date-time" }, - "triggerInjected": { "type": "string" }, - "triggerAsserted": { "$ref": "#/$defs/verdict" }, - "containmentAsserted": { "$ref": "#/$defs/verdict" }, - "escalationPathAsserted": { "$ref": "#/$defs/verdict" }, - "recoveryAssertions": { - "type": "array", - "minItems": 4, - "items": { - "type": "object", - "required": ["assertion", "evidence", "result"], - "properties": { - "assertion": { "type": "string", "minLength": 1 }, - "evidence": { "type": "string", "minLength": 1 }, - "result": { "$ref": "#/$defs/verdict" } - }, - "additionalProperties": false - } - }, - "negativeFixtureFailedAsExpected": { "$ref": "#/$defs/verdict" }, - "windowObservedBucket": { "type": "string" }, - "providerVerificationRequired": { "type": "boolean" }, - "result": { "$ref": "#/$defs/verdict" } - }, - "additionalProperties": false -}