# v0.2.18 — 세션 팝아웃 안정화 + macOS 빈 터미널 수정

릴리즈 일자: 2026-06-08
이전 버전: v0.2.17

## 요약 (TL;DR)

- 터미널을 **별도 창(팝아웃)으로 빼둔 뒤 다른 창에 가려 한참 두면 저절로 메인 창 안으로 다시 들어가던** 문제를 고쳤습니다.
- macOS에서 새 세션이 **빈 터미널로 뜨던** 문제를 수정했습니다.
- 분할(split-root) 그룹도 팝아웃 / 티어아웃이 가능해졌습니다.

## 주요 변경

### 백그라운드 팝아웃이 멋대로 복귀하던 문제 수정

별도 창으로 빼낸 터미널을 다른 창 뒤에 둔 채 5분 이상 방치하면, 메인 창이 그 창을 "죽었다"고 오판해 자동으로 회수(메인 안 플로팅 창으로 복귀)하는 일이 있었습니다.

원인은 브라우저/Electron이 백그라운드 창의 타이머를 강하게 늦추면서(intensive throttling) 생존 신호(heartbeat)가 늦게 도착한 것이었습니다. 이제 throttling의 영향을 받지 않는 Web Locks로 실제 생존 여부를 확인해, **살아있는 창은 더 이상 자동으로 복귀하지 않습니다.** 창을 실제로 닫거나 비정상 종료된 경우에만 정상적으로 회수됩니다. (브라우저·데스크탑 공통)

### macOS 새 세션 빈 터미널 수정

macOS에서 세션을 시작하면 터미널이 비어 있는 채로 뜨는 경우가 있었습니다. node-pty 헬퍼의 실행 권한이 누락된 것이 원인으로, 권한을 복원해 정상적으로 출력되도록 했습니다.

### 분할 그룹 팝아웃 / 티어아웃 허용

기존에는 분할(split-root) 레이아웃 그룹을 별도 창으로 빼내거나 떼어낼 수 없었는데, 이제 일반 그룹과 동일하게 팝아웃 / 티어아웃할 수 있습니다.

## 설치 / 업데이트

```bash
npm i -g clitrigger@0.2.18
```

데스크탑 앱: GitHub Release 자산의 `.exe` / `.dmg` / `.AppImage` 사용.

## 전체 커밋 목록

- cff02a6 WIP(session-window): Web Locks로 throttle된 팝아웃 오인 회수 방지
- b5a2d4f fix: macOS 세션 빈 터미널 — node-pty spawn-helper 실행권한 복원
- 62a0d05 WIP(session-window): split-root 그룹도 팝아웃/티어아웃 허용
- 63df6c8 docs(readme-kr): 주요 기능을 1줄로 축약 + 한국어 Wiki 딥링크
- 54f092d docs(readme): Features 항목을 1줄로 축약 + Wiki 딥링크
- ebd45a7 docs(readme): Features 섹션 간결화 + 상세 매뉴얼은 Wiki로 위임

## 관련 문서

- [상세 changelog](../changelog/) — 날짜별 기술 결정 기록
