Files
clean-architecture-frontend…/scripts
DongHyeonka 3c175a5429 fix(provider): guardian이 실패하면 stdin을 기다리지 않고 끝난다 (G-1)
문제
guardian은 fd 0을 fs.createReadStream으로 읽는다. 이 스트림은 libuv
스레드 풀의 스레드 하나를 read(2)에 세워 둔다. process.exit()는 종료
전에 스레드 풀을 join하므로, 그 read가 돌아올 때까지(부모가 stdin을
닫을 때까지) 끝나지 않는다. 그래서 가드를 거부하거나 link가 실패하면
failClosed가 진단을 바로 쓰고도 프로세스는 남는다. 클라이언트는 stdin을
연 채 READY를 기다리므로 거부가 즉시 오지 않고 고정 5초 뒤 "READY timed
out"으로 끝난다. 같은 종류 guardian 두 개 테스트의 패자가 이 경로다.
탐침: 같은 종료 코드를 fs 스트림은 stdin을 닫은 2,008ms에, net 소켓은
228ms에 냈다(200ms 뒤 exit 호출).

고른 방법
- liveness 입력을 process.stdin으로 바꾼다. pipe면 Node가 이벤트 루프로
  읽는 net.Socket을 만든다. 스레드 풀 read가 없어 exit가 바로 끝난다.
  data/end/error 처리, removeAllListeners·destroy, closeSync(0)는 그대로다
  (libuv는 fd 0~2를 destroy에서 닫지 않는다).
- 동시 guardian 테스트에 붙였던 PROCESS_HEAVY_TIMEOUT_MS와 그 주석을
  뺀다. 패자가 link 실패 즉시 끝나 테스트가 5.14초에서 0.16~0.54초가 됐다.
버린 대안
- provider-scope-wrapper.ts처럼 new Socket({ fd: 0 }): fd 0이 pipe가
  아니면 생성자가 throw한다. guardian은 그 시점에 이미 private alias를
  묶었고 failClosed는 liveness가 있어야 돈다. process.stdin은 pipe에서는
  같은 Socket이고, 그 밖의 fd에서는 throw 대신 end/error로 기존 실패
  경로(125)를 탄다.
- 실패 때 SIGKILL로 자신을 죽이기: 종료 코드 124~126 계약이 사라진다.

위험·한계
- pipe인 fd 0에 O_NONBLOCK이 걸린다. 읽기 끝은 guardian만 가진다
  (클라이언트는 stdio "pipe"로 띄운다).
- lease 마감 경로는 원래 SIGKILL을 쓰므로 바뀌지 않는다.

검증
- RED(수정 전): 새 테스트 "exits on a rejected guard while the parent
  still holds its input open"이 "rejected-guard guardian exit timed out"
  (5,122ms)으로 실패. 다른 nonce의 가드를 보내 시계와 무관하게 거부시킨다.
- GREEN: tests/integration/provider-guardian-transaction.test.ts 22/22
  통과, 3회 반복 통과(새 테스트 65~333ms). tests/unit/task3-selective-
  integration 7/7. tsc(tsconfig.node, tsconfig.test) 통과, 바꾼 파일
  eslint 통과.
- 미실행: tests/system/ci-runner/ci-artifact-contract.test.ts의 provider
  체인 테스트. fixture가 corepack pnpm으로 빌드해서 이 worktree에서는
  돌리지 않았다.

Refs: commit c862004 위험·한계의 "따로 남는 결함"
2026-11-01 22:16:26 +09:00
..