# Release Notes — v0.1.202 (30th stable seal)

**날짜**: 2026-05-17 18:52 KST
**스코프**: 하네스 자동화 + critic-gate hook + parts-visibility .twn + critic 중대 3건 fix
**누적 사이클**: 3 (v0.1.200 -> v0.1.202)
**zip**: [factory00-windows-x64-v0.1.202-harness-critic-stable.zip](../../downloads/stable/factory00-windows-x64-v0.1.202-harness-critic-stable.zip) (50 MB)

---

## 핵심 변경

### v0.1.200 — critic 중대 4건 일괄 처리
1. **Bootstrap.OnDestroy 3 panel Unsubscribe** — Modbus Mapping / Modbus TCP Inspector / MC Protocol Inspector dead handler 회피
2. **ModbusAddressMapWrapper SSOT 이동** — Bootstrap inline -> Modbus 네임스페이스 (`ModbusAddressMap.cs` file-scope)
3. **단축키 inventory wiki SSOT** — `keyboard-shortcuts-inventory.md` 신규 (14 평문 키 사용 + 10 미사용 영역 명시)
4. **McProtocolClient false alarm 확정** — 5파일 모두 존재 (IMcProtocolDriver/McProtocolTcpDriver/Events/PlcDeviceMap/DriverComponent/InspectorPanel)

### v0.1.201 — 하네스 개선 3건 + parts-visibility P2
1. **capture-unity-1920.sh retry 추가** — MAX_RETRY=2 + schtasks 재실행 (이전 사이클 3회 실패 패턴 차단)
2. **publish-build-auto.sh zip 생성 전 Stop-Process 선행** — Permission denied 회피
3. **`/bump-version` 스킬 신설** — bundleVersion + build-title.txt 원자적 처리 (매 사이클 2단계 -> 1명령)
4. **parts-visibility .twn 직렬화** — ExtensionBlock `parts-visibility:v1` + `PartVisibilityMapWrapper` (Bootstrap Save/Apply 양방향)

### v0.1.202 — critic-gate hook + critic 중대 3건 fix
1. **critic-gate.sh hook 신설 (경고 모드)** — bundleVersion sed / Compress-Archive / publish-build-auto.sh 호출 직전 critic 호출 여부 검증 -> 미호출 시 stderr 경고. 환경변수 `CRITIC_GATE_BLOCK=1` 설정 시 차단 모드 전환
2. **parts-visibility Apply atomic 교체 패턴** — (critic 중대 #1·#2) `_partHidden.Clear()` 후 rollback 없음 -> 새 dict 구성 -> 성공 시에만 일괄 교체
3. **critic-gate 패턴 정제** — (critic 중대 #3) 단순 grep/read 명령 false positive 제거 (`sed -i.*bundleVersion` + `Compress-Archive.*\.zip` + `publish-build-auto.sh` 만 매칭)
4. **다중 block 중복 회피** — parts-visibility:v1 ExtensionBlock 첫 발견 후 break

---

## 협업자 spec 진행도

| 카테고리 | 완료 | 잔존 |
|---|---|---|
| Tier A (3 모듈) | [완료] 3/3 | — |
| Tier B (3 탭) | [완료] 3/3 | — |
| Tier C (6 모듈) | [완료] 5/6 | [!] Modbus Serial 실 활성 (ApiCompatibilityLevel 합의 필요) |
| 스튜디오 parts-visibility | [완료] 14/14 checklist (.twn 직렬화 P2 포함) | — |
| **즉시 가능 합계** | **13 / 14 = 93%** | — |
| SDK 대기 (제외) | — | MxBridge + 위치결정 |

---

## 자가 검증
- 외부 URL HTTP 200 검증: index.html / latest-builds.html / zip [완료]
- 1920x1080 캡처: 회귀 0건
- critic 호출 (v0.1.200~202 누적) — 치명 0 / 중대 3 모두 fix 완료
- critic-gate hook test PASS (경고 모드 정상 동작 + false positive 0)
- /bump-version skill 등록 PASS (Skill list에 표시)

## 하네스 효과 측정 (v0.1.196~v0.1.200 vs v0.1.201~v0.1.202)

| 항목 | 이전 5 사이클 평균 | 최근 2 사이클 평균 |
|---|---|---|
| publish 재시도 | 2~3회 | 0~1회 (B fix 적용) |
| capture 재시도 | 1~2회 | 0회 (A fix 적용) |
| 사이클당 시간 | ~5분 | ~3분 |
| critic 누락 위험 | 12사이클 누적 | hook 경고 즉시 알림 |