@sooink/ai-session-tidy 0.1.2 → 0.1.4

package/src/core/service.ts

@@ -6,6 +6,8 @@ import { execSync } from 'child_process';
 
 const SERVICE_LABEL = 'sooink.ai-session-tidy.watcher';
 const PLIST_FILENAME = `${SERVICE_LABEL}.plist`;
+const BIN_NAME = 'ai-session-tidy';
+const BUNDLE_IDENTIFIER = 'io.github.sooink.ai-session-tidy';
 
 export type ServiceStatus = 'running' | 'stopped' | 'not_installed';
 
@@ -20,13 +22,26 @@ function getPlistPath(): string {
   return join(homedir(), 'Library', 'LaunchAgents', PLIST_FILENAME);
 }
 
+function getBinPath(): string | null {
+  try {
+    const binPath = execSync(`which ${BIN_NAME}`, {
+      encoding: 'utf-8',
+      stdio: ['pipe', 'pipe', 'pipe'],
+    }).trim();
+    if (binPath && existsSync(binPath)) {
+      return binPath;
+    }
+  } catch {
+    // not found in PATH
+  }
+  return null;
+}
+
 function getNodePath(): string {
-  // Get absolute path to node executable
   return process.execPath;
 }
 
 function getScriptPath(): string {
-  // Get absolute path to the CLI script
   const scriptPath = process.argv[1];
   if (scriptPath && existsSync(scriptPath)) {
     return scriptPath;
@@ -34,27 +49,57 @@ function getScriptPath(): string {
   throw new Error('Could not determine script path');
 }
 
+/**
+ * Build ProgramArguments for the LaunchAgent plist.
+ *
+ * Prefers the bin command path (e.g. /usr/local/bin/ai-session-tidy) so that
+ * macOS attributes the background activity to "ai-session-tidy" instead of
+ * "Node.js Foundation". Falls back to [node, script] if the bin is not found.
+ *
+ * @see https://developer.apple.com/forums/thread/735065
+ */
+function getProgramArgs(args: string[]): string[] {
+  const binPath = getBinPath();
+  if (binPath) {
+    return [binPath, ...args];
+  }
+  return [getNodePath(), getScriptPath(), ...args];
+}
+
 function generatePlist(options: {
   label: string;
-  nodePath: string;
-  scriptPath: string;
-  args: string[];
+  programArgs: string[];
 }): string {
-  const allArgs = [options.nodePath, options.scriptPath, ...options.args];
-  const argsXml = allArgs.map((arg) => `    <string>${arg}</string>`).join('\n');
+  const argsXml = options.programArgs
+    .map((arg) => `    <string>${arg}</string>`)
+    .join('\n');
 
   const home = homedir();
 
+  // Include PATH so that shebang (#!/usr/bin/env node) can locate the node binary.
+  // This is necessary for nvm/fnm users where node is not in the default system PATH.
+  const nodeBinDir = dirname(process.execPath);
+  const systemPath = process.env['PATH'] ?? '/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin';
+  const envPath = systemPath.includes(nodeBinDir)
+    ? systemPath
+    : `${nodeBinDir}:${systemPath}`;
+
   return `<?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
 <plist version="1.0">
 <dict>
   <key>Label</key>
   <string>${options.label}</string>
+  <key>AssociatedBundleIdentifiers</key>
+  <array>
+    <string>${BUNDLE_IDENTIFIER}</string>
+  </array>
   <key>EnvironmentVariables</key>
   <dict>
     <key>HOME</key>
     <string>${home}</string>
+    <key>PATH</key>
+    <string>${envPath}</string>
   </dict>
   <key>ProgramArguments</key>
   <array>
@@ -108,9 +153,7 @@ export class ServiceManager {
 
     const plistContent = generatePlist({
       label: SERVICE_LABEL,
-      nodePath: getNodePath(),
-      scriptPath: getScriptPath(),
-      args: ['watch', 'run'],
+      programArgs: getProgramArgs(['watch', 'run']),
     });
 
     await writeFile(this.plistPath, plistContent, 'utf-8');
@@ -131,6 +174,17 @@ export class ServiceManager {
       throw new Error('Service not installed. Run "watch start" to install and start.');
     }
 
+    // Clear old log files before starting
+    const logDir = join(homedir(), '.ai-session-tidy');
+    const stdoutPath = join(logDir, 'watcher.log');
+    const stderrPath = join(logDir, 'watcher.error.log');
+    if (existsSync(stdoutPath)) {
+      await writeFile(stdoutPath, '', 'utf-8');
+    }
+    if (existsSync(stderrPath)) {
+      await writeFile(stderrPath, '', 'utf-8');
+    }
+
     try {
       execSync(`launchctl load "${this.plistPath}"`, { stdio: 'pipe' });
     } catch (error) {

package/src/scanners/claude-code.ts

@@ -11,6 +11,7 @@ import {
   getClaudeSessionEnvDir,
   getClaudeTodosDir,
   getClaudeFileHistoryDir,
+  getClaudeTasksDir,
 } from '../utils/paths.js';
 import { getDirectorySize } from '../utils/size.js';
 
@@ -36,6 +37,7 @@ export interface ClaudeCodeScannerOptions {
   sessionEnvDir?: string | null; // null to disable session-env scanning
   todosDir?: string | null; // null to disable todos scanning
   fileHistoryDir?: string | null; // null to disable file-history scanning
+  tasksDir?: string | null; // null to disable tasks scanning
 }
 
 export class ClaudeCodeScanner implements Scanner {
@@ -45,6 +47,7 @@ export class ClaudeCodeScanner implements Scanner {
   private readonly sessionEnvDir: string | null;
   private readonly todosDir: string | null;
   private readonly fileHistoryDir: string | null;
+  private readonly tasksDir: string | null;
 
   constructor(projectsDirOrOptions?: string | ClaudeCodeScannerOptions) {
     if (typeof projectsDirOrOptions === 'string') {
@@ -54,6 +57,7 @@ export class ClaudeCodeScanner implements Scanner {
       this.sessionEnvDir = null;
       this.todosDir = null;
       this.fileHistoryDir = null;
+      this.tasksDir = null;
     } else if (projectsDirOrOptions) {
       this.projectsDir = projectsDirOrOptions.projectsDir ?? getClaudeProjectsDir();
       this.configPath = projectsDirOrOptions.configPath === undefined
@@ -68,12 +72,16 @@ export class ClaudeCodeScanner implements Scanner {
       this.fileHistoryDir = projectsDirOrOptions.fileHistoryDir === undefined
         ? getClaudeFileHistoryDir()
         : projectsDirOrOptions.fileHistoryDir;
+      this.tasksDir = projectsDirOrOptions.tasksDir === undefined
+        ? getClaudeTasksDir()
+        : projectsDirOrOptions.tasksDir;
     } else {
       this.projectsDir = getClaudeProjectsDir();
       this.configPath = getClaudeConfigPath();
       this.sessionEnvDir = getClaudeSessionEnvDir();
       this.todosDir = getClaudeTodosDir();
       this.fileHistoryDir = getClaudeFileHistoryDir();
+      this.tasksDir = getClaudeTasksDir();
     }
   }
 
@@ -148,6 +156,10 @@ export class ClaudeCodeScanner implements Scanner {
     const fileHistorySessions = await this.scanFileHistoryDir(validSessionIds);
     sessions.push(...fileHistorySessions);
 
+    // 7. Scan ~/.claude/tasks for orphaned folders
+    const tasksSessions = await this.scanTasksDir(validSessionIds);
+    sessions.push(...tasksSessions);
+
     const totalSize = sessions.reduce((sum, s) => sum + s.size, 0);
 
     return {
@@ -360,6 +372,49 @@ export class ClaudeCodeScanner implements Scanner {
     return orphanedHistories;
   }
 
+  /**
+   * Detect orphaned folders from ~/.claude/tasks
+   * Folder name is the session UUID, contains .lock file
+   */
+  private async scanTasksDir(validSessionIds: Set<string>): Promise<OrphanedSession[]> {
+    if (!this.tasksDir) {
+      return [];
+    }
+
+    const orphanedTasks: OrphanedSession[] = [];
+
+    try {
+      await access(this.tasksDir);
+      const entries = await readdir(this.tasksDir, { withFileTypes: true });
+
+      for (const entry of entries) {
+        if (!entry.isDirectory()) continue;
+
+        const sessionId = entry.name;
+
+        // Orphan if not in valid session IDs
+        if (!validSessionIds.has(sessionId)) {
+          const taskPath = join(this.tasksDir, entry.name);
+          const size = await getDirectorySize(taskPath);
+          const taskStat = await stat(taskPath);
+
+          orphanedTasks.push({
+            toolName: this.name,
+            sessionPath: taskPath,
+            projectPath: sessionId, // Session UUID
+            size,
+            lastModified: taskStat.mtime,
+            type: 'tasks',
+          });
+        }
+      }
+    } catch {
+      // Ignore if directory doesn't exist or access fails
+    }
+
+    return orphanedTasks;
+  }
+
   /**
    * Extract project path (cwd) from JSONL file
    */

package/src/scanners/types.ts

@@ -1,6 +1,6 @@
 export type ToolName = 'claude-code' | 'cursor';
 
-export type SessionType = 'session' | 'config' | 'session-env' | 'todos' | 'file-history';
+export type SessionType = 'session' | 'config' | 'session-env' | 'todos' | 'file-history' | 'tasks';
 
 export interface ConfigStats {
   lastCost?: number;

package/src/utils/paths.ts

@@ -1,3 +1,4 @@
+import { existsSync } from 'fs';
 import { homedir } from 'os';
 import { join } from 'path';
 
@@ -14,13 +15,45 @@ export function encodePath(path: string): string {
 
 /**
  * Decode Claude Code encoded path to Unix path
- * -home-user-project → /home/user/project
+ * Handles hyphenated folder names by checking filesystem
+ *
+ * -Users-kory-my-project → /Users/kory/my-project (if exists)
+ * -Users-kory-my-project → /Users/kory/my/project (fallback)
  */
 export function decodePath(encoded: string): string {
   if (encoded === '') return '';
-  // Treat as Unix encoding if it starts with a dash
   if (!encoded.startsWith('-')) return encoded;
-  return encoded.replace(/-/g, '/');
+
+  // Split by dash (remove leading dash first)
+  const parts = encoded.slice(1).split('-');
+
+  // Try to reconstruct path by checking filesystem
+  return reconstructPath(parts, '');
+}
+
+/**
+ * Recursively reconstruct path by trying different combinations
+ */
+function reconstructPath(parts: string[], currentPath: string): string {
+  if (parts.length === 0) return currentPath;
+
+  // Try combining segments (longest first to prefer hyphenated names)
+  for (let len = parts.length; len >= 1; len--) {
+    const segment = parts.slice(0, len).join('-');
+    const testPath = currentPath + '/' + segment;
+
+    if (existsSync(testPath)) {
+      // Found existing path, continue with remaining parts
+      const result = reconstructPath(parts.slice(len), testPath);
+      // Verify the final path exists (or is the best we can do)
+      if (existsSync(result) || parts.slice(len).length === 0) {
+        return result;
+      }
+    }
+  }
+
+  // No existing path found, use simple decode for remaining parts
+  return currentPath + '/' + parts.join('/');
 }
 
 /**
@@ -79,6 +112,13 @@ export function getClaudeFileHistoryDir(): string {
   return join(homedir(), '.claude', 'file-history');
 }
 
+/**
+ * Claude Code tasks directory path (~/.claude/tasks)
+ */
+export function getClaudeTasksDir(): string {
+  return join(homedir(), '.claude', 'tasks');
+}
+
 /**
  * Replace home directory with ~ for display
  * /Users/user/.ai-session-tidy → ~/.ai-session-tidy

package/README.ko.md

@@ -1,176 +0,0 @@
-<div align="center">
-
-# AI Session Tidy
-
-**AI 코딩 도구의 방치된 세션을 정리합니다**
-
-[![npm version](https://img.shields.io/npm/v/@sooink/ai-session-tidy.svg?style=flat-square)](https://www.npmjs.com/package/@sooink/ai-session-tidy)
-[![node](https://img.shields.io/badge/node-%3E%3D24-brightgreen?style=flat-square)](https://nodejs.org/)
-[![platform](https://img.shields.io/badge/platform-macOS-blue?style=flat-square)](https://github.com/sooink/ai-session-tidy)
-[![License: MIT](https://img.shields.io/badge/license-MIT-yellow.svg?style=flat-square)](https://opensource.org/licenses/MIT)
-
-[English](README.md) · [한국어](README.ko.md)
-
-</div>
-
----
-
-## 문제점
-
-**Claude Code**나 **Cursor** 같은 AI 코딩 도구는 세션 데이터를 로컬에 저장합니다—대화 기록, 파일 스냅샷, Todo 등.
-
-프로젝트를 삭제, 이동, 이름 변경하면 세션 데이터가 방치됩니다:
-
-```
-~/.claude/
-├── projects/
-│   ├── -Users-you-deleted-project/  # 👈 지난주 삭제한 프로젝트
-│   ├── -Users-you-temp-worktree/    # 👈 제거한 worktree
-│   └── -Users-you-renamed-project/  # 👈 이름 바꾼 프로젝트
-├── todos/                           # 방치된 Todo 파일
-└── file-history/                    # 방치된 Rewind 스냅샷
-```
-
-Claude Code는 30일 후 오래된 세션을 삭제하지만, **Cursor는 자동 정리 기능이 없습니다.** Claude Code도 30일간은 방치된 데이터가 남아있습니다.
-
-**이 도구는 방치된 세션을 즉시 찾아서 정리합니다.**
-
-## 빠른 시작
-
-```bash
-npm install -g @sooink/ai-session-tidy
-
-ai-session-tidy              # 방치된 세션 스캔
-ai-session-tidy clean        # 휴지통으로 이동
-ai-session-tidy watch start  # 자동 정리 데몬
-```
-
-![Demo](assets/demo.gif)
-
-## 활용 사례
-
-### Git Worktree 워크플로우
-
-[Git worktree](https://git-scm.com/docs/git-worktree)로 여러 브랜치에서 동시에 작업할 수 있습니다. 하지만 worktree를 제거해도 세션 데이터는 남습니다.
-
-```bash
-git worktree add ../feature-branch feature
-cd ../feature-branch && claude  # 세션 데이터 생성
-
-git worktree remove ../feature-branch
-# ~/.claude/projects/-...-feature-branch/ 가 그대로 남음
-```
-
-**watch 모드를 사용하면** 자동으로 정리됩니다:
-
-```bash
-ai-session-tidy watch start     # 한 번 실행, 로그인 시 자동 시작
-
-git worktree remove ../feature  # watch가 감지 → 5분 후 정리
-```
-
-### 멀티 에이전트 오케스트레이션
-
-[최신 AI 워크플로우](https://www.anthropic.com/engineering/multi-agent-research-system)는 여러 에이전트를 병렬로 실행하며, 각각 격리된 worktree에서 작업합니다.
-
-이로 인해 세션 데이터 축적이 배가됩니다. watch 모드가 시스템을 자동으로 깔끔하게 유지합니다.
-
-## 지원 도구
-
-| 도구 | 상태 |
-|-----|------|
-| Claude Code | ✅ 지원 |
-| Cursor | ✅ 지원 |
-
-## 명령어
-
-### `scan` (기본)
-
-삭제 없이 방치된 세션을 찾습니다.
-
-```bash
-ai-session-tidy              # 기본 스캔
-ai-session-tidy -v           # 상세 출력
-ai-session-tidy --json       # JSON 출력
-```
-
-### `clean`
-
-방치된 세션을 삭제합니다.
-
-```bash
-ai-session-tidy clean        # 휴지통으로 이동 (확인 필요)
-ai-session-tidy clean -i     # 대화형 선택
-ai-session-tidy clean -f     # 확인 생략
-ai-session-tidy clean -n     # 드라이런 (삭제 대상만 표시)
-```
-
-![Interactive Clean](assets/demo-interactive.gif)
-
-### `watch`
-
-감시하고 자동으로 정리합니다.
-
-```bash
-ai-session-tidy watch            # 포그라운드 모드
-ai-session-tidy watch start      # 백그라운드 데몬 (로그인 시 자동 시작)
-ai-session-tidy watch stop       # 데몬 중지
-ai-session-tidy watch status     # 상태 확인
-ai-session-tidy watch status -l  # 최근 로그 표시
-```
-
-### `config`
-
-설정을 관리합니다.
-
-```bash
-ai-session-tidy config show                   # 전체 설정 보기
-ai-session-tidy config path add ~/projects    # 감시 경로 추가
-ai-session-tidy config path list              # 감시 경로 목록
-ai-session-tidy config ignore add ~/backup    # 제외 경로 추가
-ai-session-tidy config ignore list            # 제외 경로 목록
-ai-session-tidy config delay 1                # 정리 딜레이 설정 (분)
-ai-session-tidy config depth 5                # 감시 깊이 설정
-ai-session-tidy config reset                  # 기본값으로 초기화
-```
-
-> [!TIP]
-> 숨김 폴더 (`.git`, `.cache` 등)와 macOS 시스템 폴더 (`Library`, `Music` 등)는 자동으로 제외됩니다.
-
-## 정리 대상
-
-### Claude Code
-
-| 위치 | 설명 | 조건 |
-|-----|------|-----|
-| `~/.claude/projects/{path}/` | 세션 폴더 | 프로젝트 삭제됨 |
-| `~/.claude.json` | Config 항목 | 프로젝트 삭제됨 |
-| `~/.claude/session-env/{uuid}/` | 세션 환경 | 빈 폴더 |
-| `~/.claude/todos/{uuid}-*.json` | Todo 파일 | 세션 없음 |
-| `~/.claude/file-history/{uuid}/` | Rewind 스냅샷 | 세션 없음 |
-
-### Cursor
-
-| 위치 | 설명 | 조건 |
-|-----|------|-----|
-| `~/Library/.../workspaceStorage/{hash}/` | 워크스페이스 데이터 | 프로젝트 삭제됨 |
-
-## 안전장치
-
-> [!NOTE]
-> 모든 작업은 기본적으로 안전합니다—명시적 조치 없이는 영구 삭제되지 않습니다.
-
-- **스캔은 읽기 전용** — `scan`은 아무것도 삭제하지 않음
-- **휴지통 우선** — `clean`은 휴지통으로 이동 (복구 가능)
-- **확인 필요** — `-f` 없이는 삭제 전 확인
-- **5분 딜레이** — watch 모드는 정리 전 대기 (설정 가능)
-
-## 개발
-
-```bash
-git clone https://github.com/sooink/ai-session-tidy.git
-cd ai-session-tidy
-pnpm install
-pnpm build
-pnpm test
-```