|
| 1 | +# 060 wp5 결과 기록: src/server/index.ts |
| 2 | + |
| 3 | +## 최종 수치 |
| 4 | + |
| 5 | +파사드 893줄. 리프 5개: bounded-request 88, startup-warnings 205, websocket-handler 335, |
| 6 | +live-sideband 540, serve-options 1,766. |
| 7 | + |
| 8 | +## 계약서와 달라진 점 |
| 9 | + |
| 10 | +040_server_index.md 는 리프 4개(bounded-request, live-sideband, startup-warnings, route-guards)와 |
| 11 | +serveOptions 추출을 예정했다. 실제로는 route-guards 를 만들지 않았다. serveOptions 를 빼내면 파사드가 |
| 12 | +893줄이 되어 route-guards 를 옮길 이유가 사라졌고, 옮기지 않은 쪽이 변경 면적이 작다. |
| 13 | + |
| 14 | +대신 계약서에 없던 websocket-handler 리프가 생겼다. serveOptions 를 그대로 빼면 리프가 2,010줄이 되어 |
| 15 | +ratchet 의 NEW_OVERSIZED 에 걸린다. 임계값은 2,000 이고 `updateBaseline` 은 기준선 파일이 없을 때만 |
| 16 | +새 파일에 캡을 심으므로, 2,000 을 넘는 새 리프는 캡을 받지 못하고 그대로 위반이 된다. websocket 핸들러 |
| 17 | +244줄을 별도 리프로 빼서 1,766 으로 내렸다. |
| 18 | + |
| 19 | +## 순수 이동이 아닌 부분 |
| 20 | + |
| 21 | +캡처 24개 중 21개는 팩토리에서 구조 분해해 본문을 그대로 뒀다. 가변 3개(`server`, `boundPort`, |
| 22 | +`remoteWorkspaceStopping`)는 구조 분해하면 생성 시점의 `undefined`/`null`/`false` 로 굳으므로 |
| 23 | +파사드가 getter 로 넘기고 본문 7줄을 `ctx.x` 로 바꿨다. 이 7줄이 순수 이동에서 벗어난 전부다. |
| 24 | + |
| 25 | +`startupCacheInvalidationWrote` 는 추가 조정이 필요했다. 파사드가 두 곳에서 이 값에 대입하는데 |
| 26 | +변수는 리프로 갔고 ES import 바인딩은 읽기 전용이라 컴파일되지 않는다. 변수와 그것을 읽고 지우는 |
| 27 | +`consumeStartupCacheInvalidationWrite` 를 한 모듈에 유지하고 setter 를 export 했다. |
| 28 | + |
| 29 | +## 검증이 잡은 결함 3건 |
| 30 | + |
| 31 | +계약서 초안이 route-guards 범위를 1191-1329 로 적었는데 `runAdmittedHttpTurn` 의 닫는 중괄호는 1330 이다. |
| 32 | +괄호 깊이 검증기가 거부했다. 결과적으로 그 리프를 만들지 않았지만, 검증기가 비-vacuous 하다는 증거는 남았다. |
| 33 | + |
| 34 | +코드모드가 `startup-warnings.ts` 에 `import { startServer } from "../index"` 를 넣었다. 그 이름은 |
| 35 | +JSDoc 문단에만 나온다. 주석을 사용처로 오인한 버그다. 그 한 줄이 파사드와 리프를 값 순환으로 만들어 |
| 36 | +`server/index.ts` 와 무관한 테스트까지 red 가 됐다. CI 가 잡았다. |
| 37 | + |
| 38 | +파사드가 `startupCacheInvalidationWrote` 에 대입하는 문제는 로컬 `--ignoreConfig` tsc 가 못 봤고 |
| 39 | +CI typecheck 가 잡았다. 이 워크트리에 node_modules 가 없는 한 이 계열은 CI 가 유일한 오라클이다. |
| 40 | + |
| 41 | +## 오라클 |
| 42 | + |
| 43 | +`src/server/index.ts` 를 텍스트로 읽는 테스트 8개 중 4개를 재지정했다. 단언 문자열은 하나만 바꿨다 |
| 44 | +(ws-endpoint 의 `websocket: {` → `websocket: createWebsocketHandler(ctx),`). 그런데도 같은 파일 안 |
| 45 | +세 번째 describe 를 시뮬레이션이 빠뜨려 감사자가 잡았다. 손으로 목록을 만드는 방식의 한계이고, |
| 46 | +core.ts 쪽이 쓴 "모듈 목록 상수 + 목록과 import 그래프 일치 단언" 방식이 이 문제를 구조적으로 닫는다. |
| 47 | +다음 라운드는 그 방식을 먼저 쓴다. |
| 48 | + |
0 commit comments