chore(config): 아무도 읽지 않는 config/schemas의 JSON Schema 4개를 지운다
문제: 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절
This commit is contained in:
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
Reference in New Issue
Block a user