hjworktree-cli 2.0.0 → 2.2.0

package/.claude/settings.local.json

@@ -0,0 +1,10 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(git worktree list:*)",
+      "mcp__sequential-thinking__sequentialthinking",
+      "Bash(npm run build:*)",
+      "Bash(npm install:*)"
+    ]
+  }
+}

package/.context-snapshots/context-snapshot-20260106-180000.md

@@ -0,0 +1,108 @@
+# Context Snapshot
+
+## Session Metadata
+- **Created**: 2026-01-06T18:00:00+09:00
+- **CLI**: Claude Code
+- **Project**: /root/workspace/work/new/utils/hjWorktree-cli
+
+## Conversation Summary
+
+### User Requests
+- Delete 버튼 클릭 시 프로젝트의 `.git` 폴더가 삭제되는 치명적 버그 수정
+- Close All 버튼 검수
+- 프로덕션 빌드에서도 동일한 문제가 있는지 확인
+- Plan mode로 분석 후 수정
+
+### Completed Tasks
+1. **취약점 분석**: 4개의 치명적 보안 취약점 발견
+   - V1: 경로 비교 시 정규화 미적용 (`worktreeService.ts:156`)
+   - V2: 심볼릭 링크 미해결 (`path.resolve()` 사용)
+   - V3: 위험한 `fs.rm()` 폴백 (git 실패 시 강제 삭제)
+   - V4: 메인 워크트리 식별자 부재
+
+2. **6겹 방어 시스템 구현**:
+   - Layer 1: `realpathSync()` 심볼릭 링크 해결
+   - Layer 2: `.git` 파일 vs 디렉토리 검증
+   - Layer 3: 경로 정확히 일치 체크
+   - Layer 4: 내부 경로 체크
+   - Layer 5: 부모 경로 체크 (재앙 방지)
+   - Layer 6: `fs.rm()` 폴백 완전 제거
+
+3. **`isMainWorktree` 플래그 추가**: 데이터 모델에 메인 워크트리 명시적 식별자 추가
+
+4. **API 레벨 403 보호**: 메인 워크트리 삭제 시도 시 즉시 거부
+
+5. **빌드 검증**: TypeScript 컴파일 및 Vite 빌드 성공
+
+### Modified Files
+- `shared/types/index.ts`
+- `server/services/worktreeService.ts`
+- `server/routes/api.ts`
+
+## Technical Context
+
+### Key Concepts
+- **Git Worktree**: 메인 워크트리 vs 링크드 워크트리 구분
+  - 메인 워크트리: `.git` 디렉토리 보유
+  - 링크드 워크트리: `.git` 파일 (메인 .git 경로 포함)
+- **심볼릭 링크 해결**: `path.resolve()` vs `realpathSync()`
+- **Defense in Depth**: 다중 레이어 보안 방어 전략
+
+### Important Changes
+
+**shared/types/index.ts**
+```typescript
+export interface Worktree {
+  path: string;
+  branch: string;
+  name: string;
+  isMainWorktree: boolean;  // NEW
+}
+```
+
+**server/services/worktreeService.ts**
+- `safeRealpath()`: 심볼릭 링크를 안전하게 해결하는 헬퍼 메서드
+- `isLinkedWorktree()`: `.git` 파일 존재 여부로 링크드 워크트리 판별
+- `isMainRepository()`: 메인 저장소 여부 확인
+- `listWorktrees()`: `isMainWorktree` 플래그 설정 추가
+- `removeWorktree()`: 5개 보안 가드 + `fs.rm()` 폴백 제거
+- `removeAllWorktrees()`: 이중 필터링 (flag + realpath)
+- `removeWorktreesByNames()`: 메인 워크트리 삭제 차단
+
+**server/routes/api.ts**
+- `DELETE /worktrees/:name`: 메인 워크트리 삭제 시 403 반환
+
+### Issues Discovered & Resolved
+
+| 취약점 | 심각도 | 해결 방법 |
+|--------|--------|-----------|
+| 경로 정규화 미적용 | CRITICAL | `realpathSync()` 사용 |
+| 심볼릭 링크 미해결 | CRITICAL | `realpathSync()` 사용 |
+| `fs.rm()` 폴백 | CRITICAL | 완전 제거, 에러 throw |
+| 메인 워크트리 미식별 | HIGH | `isMainWorktree` 플래그 추가 |
+
+## Next Steps
+
+### Completed
+- [x] 보안 수정 구현
+- [x] TypeScript 빌드 검증
+
+### Recommendations
+1. **수동 테스트 권장**:
+   - 심볼릭 링크로 접근한 프로젝트에서 테스트
+   - Close All 버튼 동작 확인
+   - 단일 세션 삭제 동작 확인
+
+2. **버전 업데이트**: 보안 수정이므로 `v2.3.0` 릴리스 권장
+
+3. **테스트 케이스 추가 고려**:
+   - 메인 워크트리 삭제 시도 시 403 반환 확인
+   - 심볼릭 링크 프로젝트에서 경로 해결 확인
+   - `.git` 디렉토리 vs 파일 구분 확인
+
+### Caution
+- `fs.rm()` 폴백이 제거되었으므로, `git worktree remove` 실패 시 에러가 throw됨
+- 이전에는 silent하게 무시되던 에러가 이제 명시적으로 보고됨
+
+## Plan File Reference
+- `/root/.claude/plans/encapsulated-swimming-pine.md`

package/.context-snapshots/context-snapshot-20260106-235500.md

@@ -0,0 +1,108 @@
+# Context Snapshot
+
+## Session Metadata
+- **Created**: 2026-01-06T23:55:00+09:00
+- **CLI**: Claude Code
+- **Project**: /root/workspace/work/new/utils/hjWorktree-cli
+
+## Conversation Summary
+
+### User Requests
+1. npm에 hjWorktree-cli 프로젝트 배포하기 위한 안내
+2. package.json에 author 필드 추가
+3. 포트 충돌 문제 해결 (EADDRINUSE)
+4. LNB(Left Navigation Bar) UX 대폭 개선
+   - LNB가 running 단계에서도 항상 표시
+   - 세션 네비게이션을 LNB를 통해 클릭으로 이동
+   - 브랜치별 세션 그룹핑
+   - 개별/대량 세션 삭제 기능
+   - 실행 중 새 워크트리 추가 기능
+5. npm publish를 위한 version 업그레이드 및 README.md 작성
+6. 변경사항 커밋
+
+### Completed Tasks
+1. npm publish 프로세스 안내 (2FA, OTP, Access Token 설명)
+2. author 필드 추가: "hyungju-lee <beegizee1220@gmail.com>"
+3. 포트 3847 사용 중인 프로세스 종료 (PID 4442)
+4. LNB 개선 구현 (총 9개 태스크)
+   - 타입 정의 추가 (WorktreeSession, SessionGroup, ModalType 등)
+   - REST API 엔드포인트 추가 (POST /worktrees/single, DELETE /worktrees/batch)
+   - WorktreeService 메서드 추가 (createSingleWorktree, removeWorktreesByNames)
+   - Zustand 스토어 확장 (세션 관리, LNB 상태, 모달 상태)
+   - LeftNavBar 완전 재작성 (SetupSection, SessionsSection, BulkActionsBar)
+   - MainLayout 수정 (LNB 항상 표시)
+   - TerminalPanel 수정 ("Back to Setup" 제거, sessionId 기반 전환)
+   - 모달 컴포넌트 생성 (AddWorktreeModal, ConfirmDeleteModal, ModalContainer)
+   - CSS 스타일 추가 (~500줄)
+5. package.json version 2.0.0 → 2.1.0 업그레이드
+6. README.md 작성
+7. Git 커밋 완료 (1d4476fc)
+
+### Modified Files
+- `shared/types/index.ts` - 세션 관리용 타입 정의 추가
+- `server/routes/api.ts` - 2개의 새 API 엔드포인트 추가
+- `server/services/worktreeService.ts` - 2개의 새 메서드 추가
+- `web/src/stores/useAppStore.ts` - 상태 및 액션 대폭 확장
+- `web/src/components/Layout/LeftNavBar.tsx` - 완전 재작성
+- `web/src/components/Layout/MainLayout.tsx` - LNB 항상 표시 로직
+- `web/src/components/Terminal/TerminalPanel.tsx` - sessionId 기반 전환
+- `web/src/components/Modals/AddWorktreeModal.tsx` - 신규 생성
+- `web/src/components/Modals/ConfirmDeleteModal.tsx` - 신규 생성
+- `web/src/components/Modals/ModalContainer.tsx` - 신규 생성
+- `web/src/App.tsx` - ModalContainer 추가
+- `web/src/styles/global.css` - LNB, 세션, 모달 스타일 추가
+- `package.json` - version 2.1.0, author 추가
+- `README.md` - 신규 생성
+
+## Technical Context
+
+### Key Concepts
+- **Git Worktree**: 단일 저장소에서 여러 브랜치를 동시에 체크아웃
+- **Socket.IO + node-pty**: 실시간 터미널 에뮬레이션
+- **Zustand**: React 상태 관리
+- **xterm.js**: 웹 기반 터미널 렌더링
+- **REST API 설계**: 단일/배치 CRUD 엔드포인트
+
+### Important Changes
+
+**shared/types/index.ts**
+```typescript
+// 새 타입 정의
+export interface CreateSingleWorktreeRequest { branch: string; agentType: AgentId; }
+export interface BatchDeleteRequest { names: string[]; }
+export interface WorktreeSession extends TerminalInfo { id: string; createdAt: number; }
+export interface SessionGroup { branchName: string; sessions: WorktreeSession[]; isCollapsed: boolean; }
+export type ModalType = 'addWorktree' | 'confirmDelete' | null;
+```
+
+**server/routes/api.ts**
+```typescript
+// POST /worktrees/single - 단일 워크트리 생성
+// DELETE /worktrees/batch - 배치 삭제
+```
+
+**web/src/stores/useAppStore.ts**
+- 새 상태: activeSessionId, selectedSessionIds, isSetupCollapsed, collapsedBranches, modalType, modalData
+- 새 액션: setActiveSession, toggleSessionSelection, selectAllSessions, clearSessionSelection, removeSelectedSessions, getSessionGroups, toggleSetupCollapse, toggleBranchCollapse, openModal, closeModal, createSingleWorktree
+
+**web/src/components/Layout/LeftNavBar.tsx**
+- SetupSection: 접을 수 있는 설정 섹션
+- SessionsSection: 브랜치별 그룹핑된 세션 목록
+- SessionItem: 체크박스, 상태 표시, 삭제 버튼
+- BulkActionsBar: 대량 선택/삭제 기능
+
+### Issues Resolved
+1. **npm publish E403 (2FA required)**: 2FA 또는 Automation Token 필요 설명
+2. **OTP vs Access Token 혼동**: 차이점 설명 (6자리 숫자 vs 토큰)
+3. **EADDRINUSE :3847**: `lsof -i :3847` → `kill 4442`로 해결
+4. **LNB가 running 상태에서 숨겨짐**: MainLayout에서 조건부 렌더링 제거
+5. **Back to Setup이 모든 워크트리 삭제**: 버튼 제거, 자유 네비게이션 구현
+
+## Next Steps
+- `git push`로 원격 저장소에 푸시
+- `npm publish --access public`로 npm 배포
+- 배포 후 `npm i hjworktree-cli -g`로 설치 테스트
+
+## Notes
+- npm 토큰이 채팅에 노출되었으므로 revoke 후 재생성 필요 (이미 처리됨)
+- 현재 브랜치는 `origin/main`보다 1 commit 앞서 있음

package/README.md

@@ -0,0 +1,134 @@
+# hjWorktree CLI
+
+Web-based git worktree manager for running multiple AI coding agents in parallel.
+
+## Features
+
+- **Multiple AI Agents Support**: Run Codex CLI, Claude Code, and Gemini CLI simultaneously
+- **Git Worktree Management**: Create, manage, and delete worktrees with automatic cleanup
+- **Real-time Terminal**: xterm.js terminals with full PTY support via Socket.IO
+- **Session Management**:
+  - Always-visible LNB (Left Navigation Bar) for session navigation
+  - Branch-grouped session display
+  - Individual and bulk session deletion
+  - Add new worktrees while sessions are running
+- **Modern Web UI**: React + Zustand state management
+
+## Installation
+
+```bash
+npm install -g hjworktree-cli
+```
+
+**Requirements**: Node.js >= 20.0.0
+
+## Usage
+
+Navigate to your git repository and run:
+
+```bash
+cd /path/to/your/project
+hjWorktree
+```
+
+This opens a web UI in your browser where you can:
+
+1. **Select Branch**: Choose the base branch for worktrees
+2. **Select Agent**: Pick an AI coding agent (Codex, Claude, Gemini)
+3. **Set Worktree Count**: Specify how many parallel worktrees to create
+4. **Run**: Launch terminals with AI agents in each worktree
+
+## UI Overview
+
+```
++---------------------------+-----------------------------------+
+|  SETUP            [−]     |                                   |
+|  ① Branch: main           |                                   |
+|  ② Agent: Claude Code     |        Terminal View              |
+|  ③ Count: 3               |                                   |
++---------------------------+                                   |
+|  SESSIONS                 |                                   |
+|  ▼ main (3)               |                                   |
+|    ● main-project-1       |                                   |
+|    ○ main-project-2       |                                   |
+|    ○ main-project-3       |                                   |
+|                           |                                   |
+|  [+ Add Session]          |                                   |
++---------------------------+-----------------------------------+
+```
+
+## Supported AI Agents
+
+| Agent | Command | Description |
+|-------|---------|-------------|
+| Codex CLI | `codex` | OpenAI Codex CLI agent |
+| Claude Code | `claude` | Anthropic Claude Code agent |
+| Gemini CLI | `gemini` | Google Gemini CLI agent |
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/user/hjworktree-cli.git
+cd hjworktree-cli
+npm install
+
+# Development mode (server + web)
+npm run dev
+
+# Build for production
+npm run build
+
+# Run production server
+npm run start
+```
+
+## Architecture
+
+```
+hjWorktree-cli/
+├── bin/cli.js           # CLI entry point
+├── server/              # Express + Socket.IO backend
+│   ├── index.ts         # Server entry
+│   ├── socketHandlers.ts # Terminal PTY management
+│   ├── routes/api.ts    # REST API
+│   └── services/        # Git/Worktree services
+├── web/                 # React frontend
+│   ├── src/components/  # UI components
+│   ├── src/hooks/       # Custom hooks
+│   └── src/stores/      # Zustand stores
+└── shared/              # Shared types/constants
+```
+
+## API Endpoints
+
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| GET | /api/info | Project info |
+| GET | /api/branches | List branches |
+| POST | /api/worktrees | Create worktrees |
+| POST | /api/worktrees/single | Create single worktree |
+| DELETE | /api/worktrees/:name | Delete worktree |
+| DELETE | /api/worktrees/batch | Batch delete worktrees |
+| DELETE | /api/worktrees | Delete all worktrees |
+
+## Changelog
+
+### v2.2.0
+- **Security Fix**: Added critical protection guards to prevent accidental deletion of main repository's `.git` folder during worktree cleanup
+- **Session Reliability**: Added path and shell validation before PTY spawn
+- **PTY Stability**: Added retry logic with exponential backoff for PTY spawn failures
+- **Resource Protection**: Added spawn interval control (150ms minimum) to prevent resource contention when creating multiple terminals
+
+### v2.1.0
+- Improved LNB with session management and always-visible navigation
+- Implemented 4-step wizard navigation with LNB
+- Rebuilt as web-based application
+
+## License
+
+MIT
+
+## Author
+
+hyungju-lee <beegizee1220@gmail.com>

package/dist/server/routes/api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../server/routes/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAKpD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAsG7C"}
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../server/routes/api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAqB,MAAM,SAAS,CAAC;AAKpD,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAuJ7C"}

package/dist/server/routes/api.js

@@ -48,7 +48,7 @@ export function apiRouter(cwd) {
             });
         }
     });
-    // Create worktrees
+    // Create worktrees (multiple)
     router.post('/worktrees', async (req, res) => {
         try {
             const { branch, count } = req.body;
@@ -65,6 +65,44 @@ export function apiRouter(cwd) {
             });
         }
     });
+    // Create single worktree
+    router.post('/worktrees/single', async (req, res) => {
+        try {
+            const { branch } = req.body;
+            if (!branch) {
+                res.status(400).json({ error: 'Invalid request: branch is required' });
+                return;
+            }
+            const worktree = await worktreeService.createSingleWorktree(branch);
+            res.json({ worktree });
+        }
+        catch (error) {
+            res.status(500).json({
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    });
+    // Batch delete worktrees
+    router.delete('/worktrees/batch', async (req, res) => {
+        try {
+            const { names } = req.body;
+            if (!names || !Array.isArray(names) || names.length === 0) {
+                res.status(400).json({ error: 'Invalid request: names array is required' });
+                return;
+            }
+            const result = await worktreeService.removeWorktreesByNames(names);
+            res.json({
+                success: result.failed.length === 0,
+                deleted: result.deleted,
+                failed: result.failed,
+            });
+        }
+        catch (error) {
+            res.status(500).json({
+                error: error instanceof Error ? error.message : 'Unknown error'
+            });
+        }
+    });
     // Delete a worktree
     router.delete('/worktrees/:name', async (req, res) => {
         try {
@@ -75,6 +113,12 @@ export function apiRouter(cwd) {
                 res.status(404).json({ error: 'Worktree not found' });
                 return;
             }
+            // SECURITY: Never delete main worktree
+            if (worktree.isMainWorktree) {
+                console.warn(`[SECURITY] API blocked attempt to delete main worktree: ${name}`);
+                res.status(403).json({ error: 'Cannot delete main worktree' });
+                return;
+            }
             await worktreeService.removeWorktree(worktree.path);
             res.json({ success: true });
         }

package/dist/server/routes/api.js.map

@@ -1 +1 @@
-{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../server/routes/api.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"api.js","sourceRoot":"","sources":["../../../server/routes/api.ts"],"names":[],"mappings":"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"}

package/dist/server/services/worktreeService.d.ts

@@ -4,11 +4,34 @@ export declare class WorktreeService {
     private rootDir;
     private createdWorktrees;
     constructor(cwd?: string);
+    /**
+     * Safely resolves a path to its real path, handling symlinks.
+     * Returns null if path cannot be resolved.
+     */
+    private safeRealpath;
+    /**
+     * Checks if a path is a linked worktree (has .git file) vs main repo (has .git directory).
+     * Linked worktrees have a .git FILE that points to the main .git directory.
+     * Main repo has a .git DIRECTORY.
+     */
+    private isLinkedWorktree;
+    /**
+     * Checks if the given path is the main repository.
+     */
+    private isMainRepository;
     listWorktrees(): Promise<Worktree[]>;
     createWorktree(baseBranch: string, index: number): Promise<Worktree>;
     createMultipleWorktrees(baseBranch: string, count: number): Promise<Worktree[]>;
     removeWorktree(worktreePath: string): Promise<void>;
     removeAllWorktrees(): Promise<void>;
+    createSingleWorktree(baseBranch: string): Promise<Worktree>;
+    removeWorktreesByNames(names: string[]): Promise<{
+        deleted: string[];
+        failed: {
+            name: string;
+            error: string;
+        }[];
+    }>;
     cleanup(): Promise<void>;
     getCreatedWorktrees(): string[];
     getRootDir(): string;

package/dist/server/services/worktreeService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worktreeService.d.ts","sourceRoot":"","sources":["../../../server/services/worktreeService.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,GAAG,GAAE,MAAsB;IAKjC,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAwBpC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAsCpE,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2B/E,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAgCnD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAenC,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,mBAAmB,IAAI,MAAM,EAAE;IAI/B,UAAU,IAAI,MAAM;CAGrB;AAKD,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAKhE"}
+{"version":3,"file":"worktreeService.d.ts","sourceRoot":"","sources":["../../../server/services/worktreeService.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,qBAAa,eAAe;IAC1B,OAAO,CAAC,GAAG,CAAY;IACvB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,gBAAgB,CAA0B;gBAEtC,GAAG,GAAE,MAAsB;IAKvC;;;OAGG;IACH,OAAO,CAAC,YAAY;IAQpB;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAYxB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAYlB,aAAa,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;IAgCpC,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAuCpE,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;IA2B/E,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsEnD,kBAAkB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgCnC,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAqB3D,sBAAsB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QACrD,OAAO,EAAE,MAAM,EAAE,CAAC;QAClB,MAAM,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC3C,CAAC;IAmCI,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAY9B,mBAAmB,IAAI,MAAM,EAAE;IAI/B,UAAU,IAAI,MAAM;CAGrB;AAKD,wBAAgB,kBAAkB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,eAAe,CAKhE"}