feat: 테마 5종 + 설치 시 갱신 주기 입력 + 세션 캐시 격리 버그 수정

[ictechgy]

개요

설치 사용자가 테마를 고르고 갱신 주기를 입력할 수 있게 하고, 여러 Claude 터미널을 동시에 쓸 때 다른 터미널 값이 statusline에 새던 버그를 수정한다. 설계는 ralplan 합의(Planner→Architect→Critic)로 수립했고(themes 5라운드 / cache 3라운드 APPROVE), 구현 후 verifier·code-reviewer·security-reviewer 3중 검토와 fix 루프를 거쳤다.

변경 내용

1. 테마 5종 (feat)

• 신규 src/themes.rs: calm(기본)·mono·vivid·ember·emoji 프리셋.
• config.toml theme = "name" 이름 참조, 해석 우선순위 사용자 키 > 프리셋 > calm.
• render.rs/theme.rs 무변경(필드 구체값 유지 → 다운스트림 0 변경).
• 명령: understatus install --theme <name> / 대화형 / understatus theme <name>(전환) / understatus themes(목록).
• COLOR-ONCE(색은 글리프에만, 숫자 무색) 유지. 모든 글리프 틴트 #0e1017 대비 ≥3:1(WCAG 실측).

2. 설치 시 갱신 주기 입력 (feat)

• install --interval N + TTY 프롬프트(둘 다, --yes로 생략), 기본 5.
• 재설치 시 기존 interval_seconds 승계(플래그 > 기존 > 5) — 조용한 리셋 방지.
• 호흡 불변식(pulse_period/interval ≥ 6) 위반 시 경고.

3. 세션 캐시 격리 (fix — 제보된 버그)

• chain_output/pulse_state/net_counters를 sessions/<살균_session_id>/로 격리.
• 증상 해결: 다른 터미널의 OMC HUD 값(예: ctx 85%)이 현재 터미널 체인 부분에 새던 문제.
• battery는 머신 전역 유지. session_id 살균(경로 traversal 차단) + FNV-1a 결정론적 해시.

4. 보안 (fix(security))

• read_branch_from_git_dir: stdin workspace.git_worktree의 .. traversal 거부 + canonicalize 심볼릭 링크 검증.

검증

• cargo test: 159 passed, 0 failed (94 → +65), 모든 명령 rustup ~/.cargo/bin/cargo 사용.
• cargo clippy --all-targets -- -D warnings: clean.
• cargo build --release: green.
• 5개 테마 실제 렌더 스모크 + 세션 격리 + traversal 차단 + CLI 서브커맨드 실증.
• 하위호환: theme 키 없으면 calm = 현행 동일, 단일 세션 캐시 동작 동일.

호환성/주의

• macOS 전용 불변. settings.json 백업/멱등/uninstall 라운드트립 안전 유지.
• pulse_style="bold"는 현재 no-op이라 전 테마 calm 호흡(향후 실제 bold 펄스는 별도).

🤖 Generated with Claude Code