문제: docs/registries/error-codes.yaml의 log_level 칸은 읽는 코드가 없다. 로그 레벨은 오류 코드가 아니라 실패의 종류와 경로가 정한다 (ServerFailureLog, AuthErrorResponseWriter). 그래서 그 코드를 내는 곳이 있는 47행 중 33행이 실제 레벨과 달랐고, 런북 2곳이 틀린 레벨을 증상으로 적었다. 고른 방법: 칸을 지우고, 머리말이 레벨을 정하는 코드를 가리킨다(설계 메모 안 A, 소유자 결정 2026-11-06). 칸이 다시 생기지 않게 OperationalErrorRegistryContractTest에 단언을 둔다. client_safe_message를 코드에 고정한 테스트가 있는 자리다. 모든 레지스트리의 공통 스키마를 보는 ContractRegistrySchemaGovernanceTest는 한 레지스트리의 칸 뜻을 다루지 않아 고르지 않았다. 런북은 실제 로그 줄을 증상으로 적는다. 결정 색인 2.3절과 설계 메모 10절에 결정을 남겼다. 버린 대안: 칸을 코드에 맞추고 테스트로 고정(B) — 규칙의 손 사본이 생기고, 템플릿이 내지 않는 13행은 고정할 값이 없다. 칸을 규범으로 만들어 코드가 읽기(C) — 4xx를 남기지 않는 설계를 뒤집고 로그 양이 는다. 위험·한계: 자기 error-codes.yaml 행에 log_level을 둔 파생 서비스는 merge 뒤 mainCheck(documentContractTest)가 실패한다. upgrade 안내 「반드시 할 일」 17과 B-44에 적었다. repo 밖에서 이 칸을 읽는 도구는 없는 것으로 본다(소유자 결정 4). 검증(desktop, 공유 잠금, 로그는 desktop ~/t3-loglevel-logs/): - RED: 기준 yaml로 OperationalErrorRegistryContractTest 3건 중 noRegistryRowCarriesALogLevel 1건 실패(log_level이 있는 행 목록 출력). rc=1, red-registry.log - GREEN: :app-bootstrap:documentContractTest rc=0, 66건 실패 0 (RunbookCoverageContractTest 포함). green-doc-contract.log - :app-bootstrap:testQualityCheck :app-bootstrap:spotlessCheck rc=0. green-quality.log - python3 scripts/check-work-docs.py rc=0, --links docs 깨진 링크 0 BREAKING CHANGE: error-codes.yaml 행에 log_level이 있으면 OperationalErrorRegistryContractTest가 실패한다. 파생 서비스는 자기 행에서 log_level: 줄을 지운다. 레벨을 바꾸려면 그 실패를 로그로 남기는 코드를 고친다.
1021 B
1021 B
title, category, error_codes, severity, owner, last_updated, status
| title | category | error_codes | severity | owner | last_updated | status | |
|---|---|---|---|---|---|---|---|
| Runbook — AUTHZ_TENANT_MISMATCH (테넌트 cross-access 시도) | AUTHZ |
|
P1 | oncall | 2026-11-06 | stub |
Runbook: AUTHZ_TENANT_MISMATCH (runbook://authz/tenant-mismatch)
Symptoms
- HTTP 403 with
error.code=AUTHZ_TENANT_MISMATCH - The template does not emit this code; the service that decides cross-tenant access does. A 403
carrier is answered without a log line (
ServerFailureLog), so that service logscode=AUTHZ_TENANT_MISMATCHwhere it decides, if this runbook is to find the attempt
Diagnosis
- Extract
traceId, checkX-Tenant-Idvs token tenant claim - Determine if this is misconfigured client or intentional attack
Action
- Block repeat offenders at gateway level
- Alert security team for investigation
Escalation
- P1 if confirmed malicious cross-tenant access attempt
Stub: Phase D2 — author body after domain adoption. (feature-operational-runbook-contract D9)