Skip to main content
CHANGELOG

What shipped

Released versions of Harmony only, read from the product's Keep a Changelog file. Unreleased work is not listed here: if it is not in a version heading, it has not shipped.

Latest released v3.25.8 · · 65 releases

Download the current build from /download. Channel and exact version always come from the live release manifest.

Releases 56–60 of 65

Page 12 of 13

v2.8.3

License Bundling + Third-Party Notices Attribution

wmux 빌드 산출물에 부족했던 attribution 의무를 정리한 patch. THIRD_PARTY_NOTICES 가 Playwright 하나만 적혀 있었지만 실제 runtime 번들은 110 packages (16 직접 deps + Electron + ~93 transitive) 를 포함하고 있었다. MIT/ISC/BSD/Apache-2.0 의 "all copies or substantial portions" 조항을 모두 충족하도록 재구성. 코드 동작 변경 없음 — 사용자 가시 변경은 tray 메뉴에 라이선스 진입점 3 개 신설.

Added

  • 자동 생성 스크립트 scripts/generate-notices.mjs — npm run notices 로 production deps tree 전체를 walk 해서 THIRD_PARTY_NOTICES 를 재생성한다. 외부 의존성 0 개 (npm ls --prod --all --json + node:fs 만 사용). 추가 install 없이 CI 에서도 그대로 실행 가능. dependency 변경 시 즉시 갱신.
  • Tray 컨텍스트 메뉴 라이선스 진입점 3 개 — About wmux (네이티브 About 패널), License (wmux) (MIT 본문 직접 열기), Third-party licenses (THIRD_PARTY_NOTICES 직접 열기). shell.openPath 로 OS 기본 텍스트 앱에서 열고, 연결된 앱 없으면 showItemInFolder fallback. 그동안 wmux 는 application menu 자체가 없어서 사용자가 라이선스 파일에 도달할 경로가 0 이었다.
  • app.setAboutPanelOptions — 네이티브 About 다이얼로그에 wmux 버전 / MIT copyright pointer / project URL metadata 설정. macOS 는 앱 메뉴에서 자동 표시, Windows/Linux 는 신규 tray 항목 "About wmux" 가 트리거.

Fixed

  • THIRD_PARTY_NOTICES 의 109 packages 누락 — 이전 파일은 Playwright 1 개만 적혀 있어 사실상 MIT/ISC/BSD/Apache-2.0 attribution 의무 (carry copyright notice in "all copies") 가 부분 미준수 상태였다. 자동 생성으로 110 packages 모두 채움. 라이선스 분포: 98 MIT, 7 ISC, 2 Apache-2.0 (electron-squirrel-startup, playwright-core), 2 BSD-3-Clause, 1 BSD-2-Clause. Zero copyleft, zero unknown — 재배포 권리 위험 0.
  • wmux 자체 LICENSE 가 빌드 산출물에 누락 — forge.config.ts 의 extraResource 에 ./LICENSE 추가. 빌드 후 <install>/resources/LICENSE 에 위치하여 wmux 의 MIT 본문도 exe distribution 과 함께 carry. (Electron 본체 LICENSE — Chromium / V8 / Node 커버 — 는 electron-packager 가 install root 의 wmux.exe 옆에 자동 emit, 이미 충족됨.)

Migration Notes

  • 자동. 사용자 액션 불필요. 외부 MCP 통합 측에 변경 없음. 빌드 자체에 영향 없는 데이터 + UI 보조 작업.

v2.8.2

Session Cap Headroom + Silent-Failure Fix

@alphabeen 이 v2.8.1 출시 직후 PR #25 로 보고한 두 문제를 한 patch 에 묶는다. v2.8.1 의 startup brick 픽스 이후에도 runtime accumulation 시나리오 (X close 후 daemon 이 유지하는 detached 세션이 며칠에 걸쳐 누적) 에서는 hard cap 50 에 다시 도달했고, 더 나쁜 건 cap throw 가 renderer 의 Ctrl+T 핸들러에서 silent 하게 묻혀 단축키가 무반응처럼 보이던 결함이다. v2.8.1 사용자는 즉시 업그레이드 권장.

Fixed

  • 데몬 세션 hard cap 50 → 200 상향 — #25, @alphabeen. v2.8.0 의 세션 영속화 이후 cap 의 의미가 "한 세션 동안 최대 동시 PTY" → "lifetime 누적 detached PTY 총합" 으로 바뀐 결과, multi-workspace + 빈번한 split 사용자는 며칠 내 50 에 재도달. 50 자체는 commit 989dd8a 의 보안 하드닝 단계에서 정한 DoS 휴리스틱이었고 200 도 같은 카테고리 안. soft cap 40 (recovery) / 7-day suspended TTL 정책은 무변경. 헤드룸 10 → 160. 근본 해결 (orphan detached GC) 은 v2.9 트랙으로 별도 검토. 구현: src/daemon/DaemonSessionManager.ts, src/daemon/index.ts 주석 동기화.
  • pty.create rejection 이 묻혀 단축키 무반응처럼 보이던 회귀 — @alphabeen 이 PR #25 description 에서 짚어준 두 번째 문제. cap 도달 시 daemon 이 actionable 에러 (Cannot create new terminal: 200 active sessions already running. Close some panes (or restart wmux) and try again.) 를 throw 하는데 renderer 의 세 호출 지점 (useKeyboard Ctrl+T 핸들러 / AppLayout empty-leaf 자동 PTY / FloatingPane 첫 열림) 모두 .then() 만 달고 .catch() 누락 (또는 silent catch) 이라 rejection 이 묻히고 단축키가 무반응처럼 보였다. v2.8.1 Bug 1 의 actionable error 의도가 무력화되던 결함.
    • 신규 IPC 에러 코드 RESOURCE_EXHAUSTED — wrapHandler 의 classifyError 가 cap 메시지 패턴 (cannot create new terminal + active sessions already running) 을 감지해 분류. 메시지에 [RESOURCE_EXHAUSTED] prefix 가 stamp 되어 renderer 가 분기 가능.
    • useIpc 매핑 — DEFAULT_MESSAGES['RESOURCE_EXHAUSTED'] = "터미널 세션 한도에 도달했습니다. 일부 pane을 닫거나 wmux를 재시작한 뒤 다시 시도해주세요.", level 'warn'. UNKNOWN 으로 매핑되어 generic "알 수 없는 오류" 토스트가 뜨던 path 차단.
    • 세 호출 지점 모두 ipcInvoke wrap 으로 통일 — useKeyboard Ctrl+T (ref 패턴으로 once-on-mount effect 안에서 사용), AppLayout empty-leaf 자동 PTY effect, FloatingPane 첫 PTY 생성. 모두 result.ok 분기 + 실패 시 toast 자동 게재.
    • Electron invoke envelope wrap 처리 — codex P2 review 에서 잡힌 결함. ipcRenderer.invoke 가 main side 에러를 renderer 로 전달할 때 메시지를 Error invoking remote method 'X': Error: <orig> 형태로 감싸서, useIpc 의 MESSAGE_CODE_PREFIX 가 ^ anchor 였던 탓에 [RESOURCE_EXHAUSTED] stamp 가 envelope 뒤로 밀려 매칭 실패 → 모든 coded error 가 다시 UNKNOWN 으로 떨어지던 path 차단. renderer regex 만 anchor 제거 (main side 는 자기 raw output 매칭이라 anchor 유지). 알phabeen 이 PR #25 description 에서 짚어준 결함이 두 번 일어나지 않도록 회귀 테스트 추가.
    • 구현: src/main/ipc/wrapHandler.ts, src/renderer/hooks/useIpc.ts, src/renderer/hooks/useKeyboard.ts, src/renderer/components/Layout/AppLayout.tsx, src/renderer/components/Terminal/FloatingPane.tsx. 6 unit tests 추가 (wrapHandler RESOURCE_EXHAUSTED classification + message prefix stamping + useIpc default 매핑 + Electron-wrapped envelope classification).

Migration Notes

  • 자동. 클라이언트 / 외부 MCP 통합 측에 변경 없음. 신규 RESOURCE_EXHAUSTED 코드는 내부 IPC 경계 안쪽에서만 사용 (renderer ↔ main).

v2.8.1

Session Recovery Stability Hotfix

@alphabeen 이 v2.8.0 출시 직후 보고한 세 가지 회귀 — 시간이 갈수록 wmux 가 사용 불가 상태로 빠지던 critical, recovered pane 출력이 깨지던 high, 매 시작마다 generic 에러 토스트가 뜨던 medium — 을 한 릴리스에 묶어 수정한다. v2.8.0 사용자는 즉시 업그레이드 권장 — 자동 마이그레이션이 누적된 sessions.json 을 첫 실행 시 정리한다.

Fixed

  • 세션 누적으로 인한 brick 상태 (Critical) — v2.8.0 에서 도입된 데몬 세션 영속화는 사용자가 X 로 종료한 모든 live pane 을 suspended 로 저장하고 다음 시작 시 복구한다. 그런데 (1) 복구 횟수에 상한이 없었고, (2) 종료 시점에 사용자가 명시적으로 닫지 않은 세션은 영원히 sessions.json 에 남아 누적됐다. 4–5 회 재시작이면 데몬의 하드 PTY 캡 (MAX_SESSIONS=50) 을 모두 소진하여 startup recovery 가 새 pane 슬롯을 못 만들고, UI 는 Ctrl+T 도 안 먹히고 generic "알 수 없는 오류" 토스트만 도배되는 상태에 빠진다. 자가복구 불가능 (재시작해도 같은 시나리오 반복).

    • Suspended 7-day TTL — StateWriter.load 가 이제 dead 세션뿐 아니라 7 일 이상 inactive 한 suspended 도 함께 prune. v2.8.0 에서 누적된 기존 sessions.json 도 첫 v2.8.1 실행 시 자동 정리된다.
    • Recovery soft cap 40 — 신규 MAX_RECOVER_SESSIONS=40. 복구 후보를 lastActivity 내림차순 정렬해 상위 40 개만 PTY 로 재생성하고 나머지는 그대로 suspended 로 남는다. 다음 launch 에서 활성 카운트가 줄면 자동으로 복구 후보에 다시 들어오며, 7 일 TTL 이 그래도 정체된 것을 reap. 이로써 hard cap 50 에 도달해도 항상 신규 pane 헤드룸 10 슬롯이 보장된다.
    • createSession 에러 메시지 사용자 친화적 변경 — Maximum session limit (50) reached → Cannot create new terminal: 50 active sessions already running. Close some panes (or restart wmux) and try again.. RPC 응답으로 그대로 노출되어 향후 토스트가 generic 이 아닌 actionable 메시지로 보임.
    • 구현: src/daemon/StateWriter.ts, src/daemon/index.ts, src/daemon/DaemonSessionManager.ts, src/daemon/recoverySelector.ts (신규 — pure 함수로 cap 정책을 분리해 unit-test 가능). 9 unit tests 추가.
  • 복구된 pane 출력 interleave (High) — v2.8.0 은 종료 시점의 PTY cols/rows 를 저장하고 복구 시 그 값으로 ConPTY 를 spawn 한다. 사용자가 윈도우 사이즈를 바꾸고 재시작하면 ConPTY 는 옛 geometry 로 출력하는데 xterm 은 새 geometry 로 그려서 같은 줄에 두 paint 의 문자가 interleave 된다 (예: Accessing workspace: → Accessingwworkspace:).

    • Deferred output mode — DaemonPTYBridge 에 setMuted(bool) 추가. recovery 경로에서 createSession({deferOutput: true}) 면 bridge 가 muted 로 시작하여 PTY 데이터 path 가 ring buffer 에 쓰지 않는다 (exit 알림은 muted 와 무관하게 정상 동작). renderer 가 첫 daemon.resizeSession 을 호출하면 PTY 가 진짜 geometry 로 resize 되고 DEFERRED_UNMUTE_DELAY_MS=100 후 자동 unmute. ConPTY 가 옛 geometry 에서 큐잉했던 출력은 100 ms 동안 drain 되고 버려진다. 저장된 scrollback (buffer dump) 은 ring buffer 에 직접 pre-fill 되므로 muted path 와 무관하게 보존된다.
    • 구현: src/daemon/DaemonPTYBridge.ts, src/daemon/DaemonSessionManager.ts, src/daemon/index.ts (recoverSessions 의 createSession 호출 3 곳 모두 deferOutput: true). 5 unit tests 추가 (drop while muted / scrollback 보존 / resize-then-unmute / 비-deferred regression / muted 중 exit 발화).
  • 시작 시 generic 에러 토스트 폭주 (Medium) — main process 가 daemon connect 를 비동기로 시도하는 동안 renderer 가 이미 IPC 호출을 던져, handler swap (cleanupHandlers() → registerAllHandlers(...)) 의 sub-millisecond 무등록 윈도우에 떨어진 호출이 No handler registered for ... 로 실패해 useIpc 가 UNKNOWN → "알 수 없는 오류가 발생했습니다." 토스트를 5–10 회 띄우던 문제.

    • main 이 단일 IPC handler daemon:get-ready-state 를 등록 (registerAllHandlers swap cycle 바깥이라 무등록 race 불가). connect 시도가 끝나면 markDaemonReady() 가 그동안 큐잉된 invoke 를 해제. 이후 invoke 는 즉시 현재 daemonClient 상태로 응답.
    • preload 의 electronAPI.daemon.whenReady() 가 ipcRenderer.invoke('daemon:get-ready-state') 를 호출 (one-shot event 가 아니라 query). renderer crash recovery 의 mainWindow.reload() 로 새로 로드된 preload 인스턴스도 정상 응답을 받아 deadlock 안 됨 (codex review fix — 초기 event-based 설계의 P2 결함 보강).
    • AppLayout 의 첫 reconcile 이 daemon.whenReady() 를 await 하여 handler 가 안정된 뒤에야 pty.list / pty.reconnect 를 호출. 토스트 폭주 사라짐.
    • 구현: src/main/index.ts, src/preload/preload.ts, src/renderer/components/Layout/AppLayout.tsx.
  • Split 후 빈 pane 이 영구 placeholder 로 남던 문제 — AppLayout 의 auto-PTY effect 가 activeWorkspace.id 만 deps 로 가져 split 으로 추가된 새 leaf 가 surfaces=[] 인 채 effect 재실행을 유발하지 못했다. 결과적으로 분할된 새 pane 이 "빈 창" placeholder 로 굳어 PTY 가 영영 안 붙었다. collectEmptyLeaves 를 effect 바깥으로 끌어올리고 빈 leaf id 들의 join 키를 deps 에 추가해 split 이 즉시 PTY 생성을 트리거하도록 수정. paneSlice 에 회귀 테스트 추가 (src/renderer/stores/slices/__tests__/paneSlice.test.ts).

  • 한글 IME 상태에서 Ctrl+D / Ctrl+Shift+D split 단축키 미작동 — Hangul 레이아웃에서 e.key 가 'ㅇ' 또는 'Process' 가 되어 useKeyboard 의 key === 'd' 매칭이 빗나가고, useTerminal 의 xterm allowlist 도 같은 이유로 빠져 단축키가 xterm 에 흘러갔다. 두 곳 모두 e.code === 'KeyD' (물리 키 코드) 도 함께 매칭하도록 수정 — 기존 Ctrl+B / Ctrl+M 등의 cross-layout 패턴과 일관. 구현: src/renderer/hooks/useKeyboard.ts, src/renderer/hooks/useTerminal.ts.

  • 분할 pane 을 키보드/마우스로 닫을 수 없던 문제 — Ctrl+W 가 closeSurface 만 호출해 마지막 surface 닫혀도 pane 이 collapse 안 되고, 단일 surface pane 에서는 SurfaceTabs 가 strip 자체를 숨겨 X 버튼도 없었다. (1) Ctrl+W 가 마지막 surface 닫힐 때 closePane cascade 호출 (Pane.tsx X-button 동작 미러), (2) SurfaceTabs 가 surfaces.length === 1 이어도 strip 렌더, (3) 신규 Ctrl+Shift+Q (tmux kill-pane equivalent) 추가 + BUILTIN_KEYS 로 보호, (4) SettingsPanel 의 Ctrl+W 라벨이 실제 동작과 어긋났던 것을 closeSurface / closePane 두 줄로 분리해 i18n 4개 로케일 (en/ko/ja/zh) 모두 수정. 구현: src/renderer/hooks/useKeyboard.ts, src/renderer/components/Pane/SurfaceTabs.tsx, src/renderer/components/Settings/SettingsPanel.tsx.

  • Reconnect 후 출력이 두 줄로 중복되던 문제 — pty.handler.ts 의 PTY_CREATE 와 PTY_RECONNECT 가 매번 새 daemonClient.on('session:data', listener) 를 등록하면서 이전 listener 를 떼지 않아 누적됐다. 한 세션을 reconnect 한번만 해도 두 listener 가 같은 chunk 를 두 번 forward 해 renderer xterm 에 중복 출력. per-session listener map 으로 분리하여 같은 ptyId 의 이전 listener 를 항상 정리한 뒤에만 새 listener 등록. 구현: src/main/ipc/handlers/pty.handler.ts.

Migration Notes

  • 자동. 첫 v2.8.1 실행 시 StateWriter.load 가 7 일 이상 묵힌 suspended 세션을 prune 한다. 추가 액션 불필요. v2.8.0 에서 이미 brick 된 사용자도 업그레이드 후 첫 실행에서 정상 복구된다 (alphabeen 이 가이드한 수동 sessions.json/daemon-pipe/daemon.lock/daemon.pid 삭제 절차는 더 이상 필요 없음).
  • 외부 MCP 통합 측에 변경 없음 — 모든 변경은 daemon 내부 + main↔renderer IPC 가드.

v2.8.0

External Tooling Surface + Cross-Pane Search

외부 AI 도구(Claude Code, 서드파티 MCP)가 wmux 위에 워크플로우를 빌드할 수 있도록 세 개의 신규 surface를 동시 도입한 minor 릴리스다. @alphabeen 의 RFC #15 가 직접적인 트리거이며, 그 결과로 (1) pane 단위 metadata API, (2) cursor 기반 JSON-RPC event bus, (3) cross-pane search 가 묶음으로 들어온다. 모든 신규 필드는 optional 이라 기존 클라이언트는 영향 없으며, system.capabilities().features 의 새 키 (paneMetadata, events) 로 신규 표면을 감지할 수 있다.

릴리스 본문이 큰 만큼 데이터 마이그레이션은 없다. 다만 외부 MCP 통합 코드를 작성한 사람은 "Migration Notes" 의 bootId / asOfSeq 항목을 한 번 읽고 캐시 무효화 경로를 확인할 것.

Added

  • Pane metadata API — #16. PaneLeaf 에 optional PaneMetadata { label?, role?, status?, custom?: Record<string,string>, updatedAt? } 부착. RPC 3 개 (pane.setMetadata/getMetadata/clearMetadata) + MCP tool 2 개 (pane_set_metadata, pane_get_metadata). 8 KB 직렬화 캡, label ≤ 64, role ≤ 64, status ≤ 128, custom ≤ 32 entries × 64-char keys. 외부 MCP 의 cross-workspace 하이재킹은 workspaceId 자동 스코프 + slice 레벨 검증으로 차단 (v2.7.2 mcp.claimWorkspace fix 와 같은 클래스 패턴). custom 맵은 merge=true 일 때 1 단계 deep-merge — 협력하는 두 MCP 가 서로의 키를 덮어쓰지 않는다. 구현: src/shared/types.ts, src/shared/rpc.ts, src/main/pipe/handlers/pane.rpc.ts, src/renderer/stores/slices/paneSlice.ts, src/renderer/hooks/useRpcBridge.ts, src/mcp/index.ts.

  • JSON-RPC event bus — #21 (resubmit of #17, base-deleted artifact). WmuxEventType union: pane.created / pane.closed / pane.focused / pane.metadata.changed / workspace.metadata.changed / process.started / process.exited. In-memory ring (1024 events) + monotonic seq cursor. RPC events.poll({cursor, types?, workspaceId?, max?}) + MCP tool wmux_events_poll. 외부 도구는 자기 워크스페이스 이벤트만 자동 스코프. bootId (UUIDv4 / EventBus 인스턴스마다 변경) 가 events.poll / system.capabilities / pane.list 응답에 모두 노출되어 데몬 재시작 시 클라이언트 캐시(pane id, pty id, cursor) 를 깨끗이 무효화할 수 있다. pane.list 는 envelope {asOfSeq, bootId, panes} 로 변경되어 resync 후 reconcile 의 frame of reference 를 명확히 한다. polling 만 — push/SSE 는 stdio MCP transport 와 안 맞아 deferred. 구현: src/shared/events.ts, src/main/events/EventBus.ts, src/main/pipe/handlers/events.rpc.ts, src/renderer/events/publisher.ts, src/renderer/stores/slices/searchSlice.ts.

  • Cross-pane search — #20. wmux 의 첫 cross-pane primitive. Ctrl+F 의 "All Panes" 토글로 현재 워크스페이스 모든 live pane 의 xterm.js 버퍼를 on-demand grep 한다. 결과 ≤ 10 개는 search bar dropdown, > 10 개는 하단 panel 자동 확장 (progressive disclosure UX with hysteresis: open at > 10, close at ≤ 5, sticky bit until session reset). 결과 클릭 → 해당 pane focus + scrollToLine(physicalBaseY) 로 wrapped line 까지 정확히 jump. regex 모드 + 잘못된 패턴 visual error (red border + tooltip, no toast). MCP tool wmux_search_panes(query, regex?) 로 외부 AI 도 자율 추론 가능 ("JWT 에러 단 pane" 같은). 200-result cap, 20k lines/pane scan cap, 500-char line truncation. cross-workspace 검색은 v2 deferred (RPC-layer caller-identity gate 추가 설계 필요). 구현: src/renderer/utils/searchEngine.ts, src/renderer/components/Terminal/SearchBar.tsx, src/renderer/components/Search/SearchResultsPanel.tsx, src/renderer/stores/slices/searchSlice.ts, src/mcp/index.ts. i18n: en/ko/ja/zh 4 locale 모두 신규 키 추가.

Changed

  • pane.list 응답 형태 — PaneListEntry[] → {asOfSeq: number, bootId: string, panes: PaneListEntry[]} envelope. resync 시 클라이언트가 "이 스냅샷 이후 events" 를 정확히 결정할 수 있다. panes[] 는 기존 키 그대로 + 새 metadata?: PaneMetadata 필드 추가. 기존 클라이언트는 envelope unwrap 후 .panes 만 사용하면 되며, metadata 는 optional 이라 무시해도 됨.

  • system.capabilities 응답 확장 — methods: RpcMethod[] 만 있던 응답에 features: { paneMetadata: true, events: { types, maxRingSize, bootId } } 추가. 기존 methods 배열은 변경 없이 신규 method 들이 자동 추가된다 ('pane.setMetadata', 'pane.getMetadata', 'pane.clearMetadata', 'pane.search', 'events.poll').

Security

  • Cross-workspace pane.search 누출 차단 — RPC handler 가 caller 가 보낸 workspaceId 를 우선 사용하고 fallback 으로만 active workspace 를 쓴다. 외부 MCP 가 자기 ws 컨텍스트로 검색 호출 시, 사용자가 다른 ws 를 보고 있어도 caller 의 ws 결과만 받는다. v2.7.2 mcp.claimWorkspace fix 와 동일 클래스의 보안 게이트.
  • Pane metadata cross-ws 하이재킹 차단 — pane.setMetadata / pane.clearMetadata 도 workspaceId 스코프 강제. 외부 MCP 가 사용자 보는 ws 에 임의 metadata 작성 불가.

Fixed

  • Clipboard selection 잔존 fix — #19. v2.7.4 에서 도입한 selection-preserving fit 가드가 isVisible useEffect 와 document.fonts.ready 콜백 두 곳에 누락돼 워크스페이스 전환 직후나 폰트 로드 직후 selection 이 wipe 되던 문제. 또 selection 후 명시적 Ctrl+C 사이에 PTY 출력으로 selection 이 자연 클리어되어 SIGINT 가 가던 문제. fix: 두 가드 추가 + terminal.onSelectionChange 기반 자동 복사 (150 ms debounce, main-IPC 경유로 1 MB cap·Win32 lock retry·error toast 모두 보존). 해당 layer 9 unit tests 추가. 구현: src/renderer/hooks/useTerminal.ts, src/renderer/utils/autoSelectionCopy.ts (신규).

Migration Notes

  • 외부 MCP 통합 코드 는 wmux_search_panes / wmux_events_poll / pane_get_metadata 등 신규 도구를 즉시 사용할 수 있다. 신규 surface 감지는 system.capabilities().features.paneMetadata 와 features.events 키로.
  • pane.list 호출자 는 응답이 envelope 으로 바뀐 점을 반영해야 한다. 기존 코드가 panes[0].id 처럼 직접 인덱싱했다면 result.panes[0].id 로. 단, MCP pane_list tool 은 envelope 그대로 반환하므로 AI 에이전트는 자연어로 처리 가능.
  • 이벤트 폴링 클라이언트 는 매 응답의 bootId 를 비교하고, 변경됐다면 cached pane id / pty id / cursor 를 모두 폐기하고 pane.list 로 reconcile. cursor > latestSeq() 또는 resync: true 도 동일하게 처리.

v1 deferred → v2 candidates

다음 항목들은 본 릴리스 범위 밖으로 명시 deferred — 트래킹 #18 :

  • Cross-workspace search 및 metadata write (현재 caller ws 만 — explicit setting + RPC-layer caller-identity gate 설계 필요)
Show the other 3 changes in v2.8.0
  • Push / SSE event delivery (stdio MCP 와 어울리지 않음, 폴링 latency 가 UX 문제 될 때 재검토)
  • Dead session scrollback dump 검색 (live pane 만 v1)
  • Optimistic concurrency (expectedVersion) on meta.set — 다중 도구 contention 시 last-writer-wins 를 깨끗이 분리

v2.7.4

Terminal Stability (4-bug Fix)

v2.7.0 의 UI 확장 후 누적된 터미널 안정성 4 건을 묶은 patch. 모두 사용자 가시 회귀라 우선 ship. 데이터 마이그레이션 없음.

Fixed

  • Hang / CPU 풀가동 (큰 출력) — PTYBridge.ts onData 에 8 ms micro-batch 도입. OscParser.ts 가 slice 기반(O(n²) → O(n)). ActivityMonitor.ts 가 100 ms 타임스탬프 가드.
  • Ctrl+V paste 일부 누락 — useTerminal.ts 의 Ctrl+V / Ctrl+Shift+V 핸들러에 4096 청킹 추가 (우클릭 path 와 동일). pty.handler.ts 100 K silent drop backstop 은 유지하되 console.warn 추가.
  • Copy 완전 안 됨 — clipboard.handler.ts silent return 3 건을 typed throw (CLIPBOARD_INVALID_TYPE / CLIPBOARD_TOO_LARGE / CLIPBOARD_WRITE_FAILED) 로 변환. 4 호출부 (useTerminal ×3 + Terminal.tsx) 가 await + try/catch, 실패 시 selection 유지 + showCopyErrorToast (i18n 4 locale).
  • 마지막 문단만 복사 — useTerminal.ts ResizeObserver / font-theme effect 에 hasSelection() 가드 + windowsPty: { backend: 'conpty', buildNumber: 21376 } 옵션으로 ConPTY reflow 활성화 (xterm.js 6 의 SelectionService unconditional clear 우회).

Changed

  • IPC.CLIPBOARD_WRITE invoke 가 실패 시 throw — renderer 는 await + try/catch 필수.
  • IPC.PTY_DATA 송신 빈도가 청크 단위 → 8 ms batch 단위 (데이터 내용 / 순서 동일).
  • IPC.PTY_WRITE 100K 초과 silent drop backstop 은 유지 — renderer 가 청킹으로 회피해야 함.

Migration Notes

스키마 변경 없음. clipboardAPI.writeText 를 호출하는 신규 코드는 await + try/catch 필수.