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:
DongHyeonka
2026-11-07 19:02:47 +09:00
parent 85f941c44c
commit 0805910c47
4 changed files with 0 additions and 177 deletions
@@ -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
}