Repository navigation
v0.34.0
이번 판의 두 축은 「다시 쓰지 않는다」와 「사람이 기억하지 않는다」다. 그림 옆 설명을 사람이 다시 옮겨 적던 일을 없앴고, 배포 전에 사람이 기억해서 돌리던 검사를 CI 로 옮겼다.
설명을 글로 — 그림과 같은 번호로 (#108)
그림은 문서에 바로 붙는데, 그 옆 칸의 설명은 사람이 정의서를 보고 다시 옮겨 적었다. 두 벌이 되고 옮기며 문장이 달라진다 — 「그걸 또 가공하면 screenspec 을 검토할 이유가 없다」(PM 실측). 정의서를 검토하는 이유가 그 글이 그대로 문서가 되기 때문이라면, 옮기는 단계에 사람이 끼면 안 된다.
- 내보내기 대화상자에 「설명 복사」. 그림과 같은 설정(화면 위 번호 · 주요 항목만 · 개발 정의 포함 · 머리말)으로, 글자는 그대로 두고 형식만 바꾼다
- 클립보드에 두 벌 —
text/html(컨플루언스 새 편집기·노션이 목록·표로 받는다) +text/plain(마크다운). 어디에 붙여도 선다 - 번호는 그림 마커 그대로. 「주요 항목만」이어도 다시 매기지 않는다 — 상위기획의 4번과 상세기획의 4번이 같은 것을 가리켜야 번호로 대조할 수 있다(#106 과 같은 원칙). 개요·섹션은 제목만
- 줄·하위 줄 → 목록·안쪽 목록 · 이유 → ↳ · 표 → 표 · 순서도 → 코드 블록 · 출처 → 각주 + 링크 · 개발 레이어 → 켰을 때만 「DEV」
- 깊이는 두 단 — 요약(제목 + 이유) / 전체. 「제목만」이 없는 이유: 상위기획 독자는 「왜 그렇게 정했나」를 보는 사람이라 이유가 빠지면 문서가 안 된다
처음엔 「항목만 걸러도 충분하다, 깊이 선택은 과하다」고 판단했다. #106 의 정정 댓글(마커 12개 중 9개가 주요)이 그 근거를 무너뜨렸다 — 12 → 9 는 줄어든 게 아니다. 판단을 뒤집었다.
호스트에서 직접: window.ScreenSpec.exportText({ markers, major, head, layer, depth }) → { html, text }.
구성 스타일시트도 그림에 (#113)
CSS 를 걷는 자리가 document.styleSheets 만 훑었다. 구성 스타일시트(adoptedStyleSheets)로만 스타일을 주는 앱은 그 규칙이 그림에서 통째로 빠졌다 — div 도 button 도 가리지 않고. #109 를 조사하다 찾았다(그 원인은 아니었다). 이제 둘을 합쳐 걷는다.
게이트를 사람 손에서 뗀다 (#112)
배포 전 게이트 셋(전체 e2e · 전체 돌연변이 · --grid)이 사람이 기억해서 손으로 돌리는 자리에 있었다. 그래서 두 번 놓쳤다 — #91(grid 가 다섯 판 동안 빨간 채), 그리고 v0.33 직전(#107 이 죽인 돌연변이 둘이 v0.32 로 나갔다). 사람이 기억하는 규칙은 결국 안 지켜진다.
실측: CI 6분 4초 중 e2e 가 4분 59초(82%)였고, 그 e2e 안은 waitForTimeout 519회 · 224초 — 약 75%가 「그냥 기다리는」 시간이었다. 돌연변이는 e2e 를 N번 돌리므로 그 낭비가 곱해졌다.
- 고정 대기 465회 →
settle(ms). 「라이브러리가 미룬 일이 0 이고 DOM 이 80ms 조용하면 그때, 아니면 원래 ms」 — 느려질 수는 없고 빨라질 수만 있다. 제품의 시간(자동저장 1.2초·파일감시 3초)을 기다리는 54회는 그대로 둔다 — 그건 기다려야 할 시간이지 가라앉기가 아니다 - 라이브러리가 미룬 일을 센다 — 마커 자리잡기·화면 감지·누락 판정·배치를
ssDefer/ssFrame/ssClear로 걸고window.ScreenSpec.busy()로 내준다 - 돌연변이가 CI 로 갔다 —
--shard=k/3으로 세 대에 나눠 e2e 잡과 나란히. 벽시계는 max(e2e, 한 샤드) --grid를 늘 켠다 — 26초짜리를 선택 실행으로 둘 이유가 없었다- 배포 스크립트의 「셋을 돌렸나?」 프롬프트가 「마지막 CI 가 초록인가?」로 바뀌었다
그리고 settle 의 통계가 남은 낭비를 정확히 가리켰다. 「끝난 이유」를 세어 보니 대기 96회가 상한까지 갔고, 흔든 표적은 SPAN.ss-wpx(68회)와 손잡이 style(28회)이었다 — 배치가 매 프레임 같은 값을 다시 쓰고 있었다. 크기 표시는 innerHTML 로 매번 다시 파싱했다. style·innerHTML 은 값이 같아도 「변경」으로 기록돼 DOM 이 영영 조용해지지 않는다(마커 추적이 안 멎던 v0.30 사고와 같은 계열).
- 바뀔 때만 쓴다 — 지시선·배치·손잡이·크기 표시 전부. 시험이 빨라지는 것보다 제품이 매 프레임 헛일을 안 하게 된 것이 크다
- 실측: 배율·무대·프리셋·fold 네 섹션에서
dom대기가 0회가 됐다
로컬 전체 e2e(--grid 포함): 5분 29초 → 3분 12초. 같은 기계에서 잰 값이다.
아직 남은 것도 통계가 말해 준다. 전체로 보면 dom 대기 143회가 그대로인데, ss-wpx 가 사라지자 그 뒤에 가려져 있던 **마커의 style 쓰기(95회)**가 드러났다. 마커도 매 프레임 자리를 다시 쓴다 — v0.30 에서 「움직였나」 비교는 고쳤지만 쓰기 자체는 남았다. 같은 병의 마지막 조각이라 다음 판으로 미뤘다.
lint 25번이 곧바로 값을 했다. 이 변경이 돌연변이 넷의 겨냥점을 죽였는데, 15분짜리 전체 판이 아니라 커밋 앞 0초 검사가 잡아 줬다. 넣은 지 한 판 만에 그 검사가 존재 이유를 증명했다.