Skip to content

Commit 523bfbf

Browse files
committed
docs(devlog): record the server/index.ts outcome and the three defects verification caught
1 parent e7df217 commit 523bfbf

1 file changed

Lines changed: 48 additions & 0 deletions

File tree

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
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

Comments
 (0)