Commit Graph
8 Commits
Author SHA1 Message Date
DongHyeonka 0bb1f0afc0 perf(coverage): 위험 커버리지 모듈 목록을 Babel 파서와 동기 fs로 만든다
문제: `buildProductionModuleInventory`가 `src/` 모듈 375개를 하나씩
`@babel/eslint-parser`로 읽고, 파일마다 lstat→realpath→open→stat→
read→close 여섯 비동기 호출을 차례로 기다린다. runner에서 이 목록을
만드는 시험(「historical 14-file summary」)이 unit 8.2초·coverage
9.8초였다(run 113). check:risk-coverage도 같은 목록을 만든다.

고른 방법:
- 파서: @babel/core `parseSync`(babelrc·configFile 끔)로 Babel AST를
  읽는다. eslint-parser는 같은 파서를 돈 뒤 트리와 토큰 전체를 ESTree로
  바꾼다. 여기서 보는 최상위 문장의 type·declare·const·importKind·
  declaration·body는 두 트리에서 같다. repo 모듈 375개 전부에서 두
  파서의 문장 모양을 대조해 차이 0을 확인했다. 시간 845 → 305ms.
  `scripts/check-architecture.ts`가 같은 방식을 이미 쓴다.
- fs: 기본 구현이 같은 호출을 같은 순서로 동기로 한다. 부하가 큰
  기계에서는 호출마다 thread pool을 거쳐 event loop 차례를 기다리는
  시간이 일보다 컸다. 주입하는 fs(경쟁 시험용)는 그대로 async다.
  symlink·파일 바꿔치기 검사와 오류 순서는 바뀌지 않는다.
- 버린 대안: 파일을 병렬로 처리하기. 대기는 줄지만 여러 파일이
  잘못됐을 때 어느 오류를 내는지가 달라진다. 시험 timeout 늘리기는
  규칙 밖이다.

위험·한계: 목록을 만드는 동안 event loop를 잡는다(desktop 약 0.7초).
gate CLI와 시험만 부른다.

검증(desktop, 같은 세션에서 고치기 전·후를 번갈아 3회):
- 부하 11~12: 그 시험 1,913/1,420/1,938 → 715/642/742ms.
- coverage + CPU 소모 프로세스 12개(부하 6~16): 8,033/8,493/10,347 →
  4,703/5,039/6,121ms.
- risk-coverage·risk-coverage-files 시험 47개 통과,
  check:coverage:fixture는 전처럼 기준 미달로 rc=1, check:types·eslint
  rc=0. 로그 /tmp/claude-gates/w2fe2-slow3·5·6/, w2fe2-parse1/.
2026-11-12 22:17:32 +09:00
DongHyeonka bca5fc2796 fix(ci): coverage 증거 검사가 summary의 branchesTrue를 받는다
문제
FE-GATE-005의 증거 검사(scripts/lib/ci-artifact-validator.ts)는
coverage-summary.json 항목마다 lines·statements·functions·branches만
허용하는 .strict() schema를 쓴다. istanbul-lib-coverage 3.2.2는 빈
summary에 branchesTrue를 항상 넣으므로 total에 그 키가 있다. 그래서
테스트가 모두 통과해도 증거 단계에서 게이트가 실패한다. 같은 파일을
읽는 risk-coverage 게이트는 이 키를 허용해 두 검사기가 갈라져 있었다.

고른 방법
- 키 목록을 scripts/lib/coverage-summary-metrics.ts 한 곳에 두고 두
  검사기가 같이 쓴다. 평가하는 네 지표와, 보고기가 더할 수 있는 선택
  지표(branchesTrue)를 나눴다. 선택 지표도 counter 형식(pct 정확성
  포함)은 그대로 검사한다.
- 버린 대안: validator schema에만 branchesTrue를 더하기. 지금 고장의
  원인(두 목록)이 그대로 남는다. 상수를 risk-coverage.ts에서
  export하기. validator가 @babel/eslint-parser까지 읽게 된다.

위험·한계
- 다른 미지의 키는 여전히 거절한다(의도). 보고기를 올리면 새 키가 생길
  수 있다.
- ci:gate FE-GATE-005 전체는 이 커밋에서 돌리지 않았다.

검증
- RED: 새 tests/unit/coverage-summary-artifact.test.ts 3건 중 2건 실패
  (Unrecognized key: "branchesTrue").
- 수정 뒤 coverage-summary-artifact·risk-coverage·risk-coverage-files
  44건 통과. check:types 통과, 바꾼 파일 eslint 통과.

Refs: docs/reviews/2026-11-03-maturity-review/README.md 12-09
2026-11-04 20:22:13 +09:00
DongHyeonka 048f490ada refactor(http)!: V2 HTTP 클라이언트를 지우고 V3 실행기 하나만 남긴다
문제
HTTP 실행 경로가 둘이다. V3 실행기(createContractHttpExecutor)가 모든 기능을
실행하고, V2 클라이언트(createHttpClient)는 bootstrap의
createRuntimeHttpClient에서만 만들어지는데 그 함수를 앱 안에서 부르는 곳이
없다(테스트만 부른다). tech-log·memento도 같다. 그런데도 V2는 초기 청크에
들어가고, 짝 백엔드 해석(7db32e1~3261208)과 테스트를 두 벌로 유지하게 했다.
사용자 지시: 레거시를 두지 말고 최신 경로 하나만 남긴다.

고른 방법
- src/adapters/http/의 client.ts, bounded-json.ts, request-builder.ts,
  resource-mapper.ts, retry-policy.ts, schema-registry.ts를 지웠다. Envelope
  스키마는 backend-envelope.ts로 옮겼다. V3가 retry-policy.ts에서 쓰던
  parseRetryAfter는 그것이 감싸던 platform/retry-after.ts의
  parseRetryAfterDelay를 직접 부른다.
- 배럴의 V2 export와 bootstrap의 createRuntimeHttpClient·RuntimeHttpContract를
  지웠다.
- V2 전용 테스트(http-client, http-diagnostics, auth-recovery,
  legacy-http-credential-authority, bounded-json-compatibility,
  request-builder, retry-policy)와 tests/helpers/http-contract-fixture.ts를
  지웠다. 섞인 파일(http-execution-contract, runtime-adapters,
  boundary-mapper)은 V2 블록만 지웠다.
- V2로 돌던 폼 테스트(form-foundation)는 Envelope을 읽는 V3 keyed create
  계약으로 옮겼다. 400 VALIDATION_FAILED 필드 오류, {cause} 뒤 다시 저장,
  422 뒤 저장 꺼짐을 그대로 검사한다. http-execution-v3-envelope 테스트는 V2와
  비교하던 행을 기대 판정을 직접 적는 행으로 바꿨다.
- drill:runbook FE-RB-003은 V2 shouldRetry 대신 V3 실행기를 실제로 돌려
  보낸 요청 수를 센다(NEVER 503: 1회, SAFE 503: 재시도, SAFE 스키마 불일치:
  1회).
- check:diagnostics의 http 이벤트 생산자, registry-governance의 오류 표 소비자,
  risk-coverage 고위험 경로, 아키텍처 금지 fixture, adapter INVENTORY, 문서의
  경로를 V3 파일로 바꿨다.

버린 대안
- V2를 @deprecated로 한 릴리스 남기기: 템플릿과 두 다운스트림 모두 부르는
  곳이 없어 옮겨 갈 사용자가 없다. 남기면 초기 JS와 두 벌 유지 비용만 남는다.

위험·한계
- BREAKING: 배럴과 bootstrap의 V2 이름을 쓰던 제품 코드는 컴파일이 깨진다.
  CHANGELOG에 옮기는 방법을 적었다.
- V2에만 있던 동작이 사라졌다: 401 뒤 세션 복구 후 한 번 재전송, KEYED 503
  자동 재시도. V3는 401을 UNAUTHENTICATED로 넘기고 KEYED 요청은 보낸 뒤
  재시도하지 않는다.
- 기능마다 적는 V2 API 행(*-api-contract.ts, check:registries가 읽음)은 이
  커밋에서 지우지 않았다. 다음 커밋이 지운다.

검증
- check:types, lint, check:architecture(금지 fixture 9건 거절),
  check:adapter-inventory(140 files), check:diagnostics, check:registries,
  check:ci, verify:documentation 통과.
- test:unit 2,585, test:integration 114, test:component 245, test:contract 23,
  test:runtime-schema 56, tests/features 101 통과.
- drill:runbook FE-RB-003: no local check failed.
- check:bundle 통과. 초기 JS 203,354 → 201,598 B(−1,756 B).

BREAKING CHANGE: src/adapters/http/index.ts가 createHttpClient, HttpClient,
HttpClientDependencies, HttpFailure, HttpResult, LegacyHttpInput, Scheduler,
OperationRequestInput를, src/bootstrap/runtime-adapters.ts가
createRuntimeHttpClient, RuntimeHttpContract를 내보내지 않는다. 그 operation의
V3 descriptor를 만들어 createFeatureHttpBinding으로 실행한다.
2026-11-03 21:12:34 +09:00
DongHyeonka 5cecbb9820 refactor: align coverage counter provenance 2026-08-02 09:31:28 +09:00
DongHyeonka 6e05a35790 fix: reject empty coverage counters 2026-08-02 09:10:35 +09:00
DongHyeonka 8d6fbb97e9 fix: close coverage evidence races 2026-08-02 08:43:44 +09:00
DongHyeonka 67cd37659d fix: harden repository coverage evidence 2026-08-02 08:20:25 +09:00
DongHyeonka 5a73f7a1b5 fix: measure repository-wide risk coverage 2026-08-02 07:52:46 +09:00