clitrigger 0.1.0 → 0.1.3

package/.env.example

@@ -1,7 +1,7 @@
 # production으로 설정 시 CORS_ORIGIN에 명시된 도메인만 허용 (미설정 시 모든 origin 허용)
 NODE_ENV=
 PORT=3000
-AUTH_PASSWORD=changeme
+AUTH_PASSWORD=changeme          # 필수 — 웹 UI 로그인 비밀번호
 SESSION_SECRET=
 CORS_ORIGIN=http://localhost:5173,http://localhost:3000
 TUNNEL_ENABLED=false

package/README.md

@@ -1,6 +1,10 @@
 <div align="center">
 
-# CLITrigger
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="src/client/public/logo.svg">
+  <source media="(prefers-color-scheme: light)" srcset="src/client/public/logo.svg">
+  <img alt="CLITrigger" src="src/client/public/logo.svg" width="360">
+</picture>
 
 **AI-Powered Parallel Worktree Automation**
 
@@ -25,6 +29,11 @@
 > 하지만 **이해 없는 바이브 코딩**은 결국 한계에 부딪힌다.  
 > CLITrigger는 AI를 병렬로 돌리면서도, 개발자가 맥락을 잃지 않도록 설계되었다.
 
+<div align="center">
+  <img src="docs/images/screenshot-tasks.png" alt="Tasks — 병렬 워크트리 실행" width="800">
+  <p><em>병렬 워크트리에서 AI CLI가 동시에 작업을 처리하는 모습</em></p>
+</div>
+
 ---
 
 ## 왜 CLITrigger인가?
@@ -67,9 +76,19 @@ TODO를 작성하면 각 작업마다 격리된 git worktree가 자동 생성된
 ### 다중 AI 토론 (Discussion)
 아키텍트, 개발자, 리뷰어 등 역할이 다른 AI 에이전트들이 라운드 방식으로 토론한 뒤, 합의된 내용을 바탕으로 자동 구현까지 이어진다. 단일 AI의 판단보다 훨씬 검증된 설계 결과물이 나온다.
 
+<div align="center">
+  <img src="docs/images/screenshot-discussions.png" alt="Discussions — 다중 AI 토론" width="800">
+  <p><em>여러 AI 에이전트가 역할별로 토론하는 Discussion 화면</em></p>
+</div>
+
 ### 예약 실행 (Scheduler)
 토큰 한도를 피해 새벽이나 특정 시각에 작업을 예약 실행할 수 있다. cron 기반 반복 스케줄과 일회성 예약 모두 지원한다.
 
+<div align="center">
+  <img src="docs/images/screenshot-schedules.png" alt="Schedules — 예약 실행" width="800">
+  <p><em>cron 기반 반복·일회성 예약 실행 설정 화면</em></p>
+</div>
+
 ### 파이프라인 (Pipeline)
 여러 작업을 순차 또는 병렬로 묶어 다단계 실행 흐름을 구성한다. 복잡한 릴리스 절차도 자동화할 수 있다.
 
@@ -118,6 +137,9 @@ clitrigger config password     # 비밀번호 변경
 ```
 
 > **사전 요구사항**: Node.js 20+, Git, 사용할 AI CLI (Claude / Gemini / Codex 중 하나 이상)
+>
+> **지원 플랫폼**: Windows · macOS · Linux — 모든 핵심 코드가 크로스 플랫폼 대응되어 있다.
+> macOS에서는 네이티브 모듈 빌드를 위해 `xcode-select --install`이 필요할 수 있다.
 
 ### 소스에서 직접 실행 (개발용)
 
@@ -154,6 +176,17 @@ npm run dev
 | `start-tunnel.bat` | 터널 모드 실행 |
 | `test.bat` | 전체 테스트 |
 
+#### macOS / Linux
+
+`npm run` 명령어가 모든 플랫폼에서 동일하게 동작한다. `.bat` 스크립트 대신 터미널에서 직접 실행하면 된다.
+
+```bash
+npm run dev        # 개발 모드
+npm run build      # 빌드
+npm run start      # 프로덕션 실행
+npm test           # 테스트
+```
+
 </details>
 
 ### 외부 접속 (Cloudflare Tunnel)

package/bin/clitrigger.js

@@ -4,6 +4,7 @@ import fs from 'fs';
 import path from 'path';
 import os from 'os';
 import { createInterface } from 'readline/promises';
+import { execSync, spawn } from 'child_process';
 
 const CONFIG_DIR = path.join(os.homedir(), '.clitrigger');
 const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
@@ -15,7 +16,10 @@ if (args[0] === 'config') {
 } else if (args[0] === '--help' || args[0] === '-h') {
   printHelp();
 } else {
-  await startServer();
+  const updated = await checkAutoUpdate();
+  if (!updated) {
+    await startServer();
+  }
 }
 
 async function startServer() {
@@ -26,29 +30,69 @@ async function startServer() {
     console.log('Welcome to CLITrigger!\n');
     const rl = createInterface({ input: process.stdin, output: process.stdout });
 
-    const setPassword = await rl.question('비밀번호를 설정하시겠습니까? (y/N): ');
     let password = '';
-    if (setPassword.toLowerCase() === 'y') {
-      password = await rl.question('비밀번호: ');
+    while (!password) {
+      password = await rl.question('비밀번호를 설정해주세요: ');
+      if (!password) console.log('비밀번호는 필수입니다.');
     }
     rl.close();
 
-    const config = { port: 3000, password };
+    const config = { port: 3000, password, tunnel: true };
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
     console.log(`\n✅ 설정 완료! (${CONFIG_FILE})`);
   }
 
   // config 읽고 env 설정
   const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+
+  // 기존 config에 비밀번호가 없으면 설정 강제
+  if (!config.password) {
+    console.log('⚠️  비밀번호가 설정되지 않았습니다.\n');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    let password = '';
+    while (!password) {
+      password = await rl.question('비밀번호를 설정해주세요: ');
+      if (!password) console.log('비밀번호는 필수입니다.');
+    }
+    rl.close();
+    config.password = password;
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    console.log('✅ 비밀번호가 설정되었습니다.\n');
+  }
+
   process.env.PORT = String(config.port || 3000);
-  if (config.password) process.env.AUTH_PASSWORD = config.password;
+  process.env.AUTH_PASSWORD = config.password;
   process.env.DB_PATH = path.join(CONFIG_DIR, 'clitrigger.db');
+  // tunnel defaults to true (auto-enable for new and existing users)
+  if (config.tunnel !== false) {
+    process.env.TUNNEL_ENABLED = 'true';
+  }
+  if (config.tunnelName) {
+    process.env.TUNNEL_NAME = config.tunnelName;
+  }
 
   // 서버 시작
   await import('../dist/server/index.js');
 }
 
 async function handleConfig(args) {
+  if (args[0] === 'clear') {
+    if (!fs.existsSync(CONFIG_DIR)) {
+      console.log('삭제할 설정이 없습니다.');
+      return;
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    const answer = await rl.question(`⚠️  ${CONFIG_DIR} 의 모든 설정과 데이터가 삭제됩니다. 계속하시겠습니까? (y/N) `);
+    rl.close();
+    if (answer.toLowerCase() === 'y') {
+      fs.rmSync(CONFIG_DIR, { recursive: true, force: true });
+      console.log('✅ 설정 및 데이터가 삭제되었습니다.');
+    } else {
+      console.log('취소되었습니다.');
+    }
+    return;
+  }
+
   fs.mkdirSync(CONFIG_DIR, { recursive: true });
 
   if (!fs.existsSync(CONFIG_FILE)) {
@@ -73,21 +117,107 @@ async function handleConfig(args) {
     console.log(`✅ 포트가 ${port}으로 변경되었습니다.`);
   } else if (args[0] === 'password') {
     const rl = createInterface({ input: process.stdin, output: process.stdout });
-    const password = await rl.question('새 비밀번호 (빈 값 = 비밀번호 해제): ');
+    let password = '';
+    while (!password) {
+      password = await rl.question('새 비밀번호: ');
+      if (!password) console.log('비밀번호는 필수입니다.');
+    }
     rl.close();
     config.password = password;
     fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
-    if (password) {
-      console.log('✅ 비밀번호가 변경되었습니다.');
-    } else {
-      console.log('✅ 비밀번호가 해제되었습니다.');
-    }
+    console.log('✅ 비밀번호가 변경되었습니다.');
   } else if (args[0] === 'path') {
     console.log(CONFIG_DIR);
+  } else if (args[0] === 'tunnel') {
+    if (!args[1]) {
+      console.log(`터널: ${config.tunnel ? '활성화' : '비활성화'}${config.tunnelName ? ` (이름: ${config.tunnelName})` : ''}`);
+      return;
+    }
+    if (args[1] === 'on') {
+      config.tunnel = true;
+      if (args[2]) config.tunnelName = args[2];
+      fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+      console.log(`✅ 터널이 활성화되었습니다.${config.tunnelName ? ` (이름: ${config.tunnelName})` : ''}`);
+    } else if (args[1] === 'off') {
+      config.tunnel = false;
+      delete config.tunnelName;
+      fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+      console.log('✅ 터널이 비활성화되었습니다.');
+    } else {
+      console.log('사용법: clitrigger config tunnel [on [이름] | off]');
+    }
   } else {
     console.log(`현재 설정 (${CONFIG_FILE}):`);
     console.log(`  포트: ${config.port || 3000}`);
     console.log(`  비밀번호: ${config.password ? '설정됨' : '없음'}`);
+    console.log(`  터널: ${config.tunnel ? '활성화' : '비활성화'}${config.tunnelName ? ` (이름: ${config.tunnelName})` : ''}`);
+  }
+}
+
+function isNewerVersion(latest, current) {
+  const a = latest.split('.').map(Number);
+  const b = current.split('.').map(Number);
+  for (let i = 0; i < 3; i++) {
+    if ((a[i] || 0) > (b[i] || 0)) return true;
+    if ((a[i] || 0) < (b[i] || 0)) return false;
+  }
+  return false;
+}
+
+async function checkAutoUpdate() {
+  // 업데이트 직후 재시작된 프로세스면 스킵
+  if (process.env.CLITRIGGER_UPDATED === '1') {
+    delete process.env.CLITRIGGER_UPDATED;
+    return false;
+  }
+
+  try {
+    if (!fs.existsSync(CONFIG_FILE)) return false;
+
+    const config = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+
+    // 24시간 이내에 체크했으면 스킵
+    const now = Date.now();
+    const lastCheck = config.lastUpdateCheck || 0;
+    if (now - lastCheck < 24 * 60 * 60 * 1000) return false;
+
+    // 체크 시간 저장 (네트워크 실패 시에도 반복 체크 방지)
+    config.lastUpdateCheck = now;
+    fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+
+    // 현재 버전 읽기
+    const pkgPath = new URL('../package.json', import.meta.url);
+    const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf-8'));
+    const currentVersion = pkg.version;
+
+    // npm registry에서 최신 버전 조회 (5초 타임아웃)
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 5000);
+    const res = await fetch('https://registry.npmjs.org/clitrigger/latest', {
+      signal: controller.signal,
+    });
+    clearTimeout(timeout);
+
+    if (!res.ok) return false;
+    const data = await res.json();
+    const latestVersion = data.version;
+
+    if (!isNewerVersion(latestVersion, currentVersion)) return false;
+
+    console.log(`\n🔄 새 버전 발견: v${currentVersion} → v${latestVersion}, 업데이트 중...`);
+    execSync('npm i -g clitrigger@latest', { stdio: 'inherit' });
+    console.log(`✅ v${latestVersion} 업데이트 완료! 재시작합니다...\n`);
+
+    // 업데이트된 코드로 재시작
+    const child = spawn(process.argv[0], process.argv.slice(1), {
+      stdio: 'inherit',
+      env: { ...process.env, CLITRIGGER_UPDATED: '1' },
+    });
+    child.on('exit', (code) => process.exit(code ?? 0));
+    return true;
+  } catch {
+    // 네트워크 오류, 타임아웃 등 — 무시하고 현재 버전으로 계속
+    return false;
   }
 }
 
@@ -100,7 +230,11 @@ Usage:
   clitrigger config             현재 설정 보기
   clitrigger config port <n>    포트 변경
   clitrigger config password    비밀번호 변경
+  clitrigger config tunnel on   Cloudflare 터널 활성화
+  clitrigger config tunnel on <name>  Named 터널 활성화
+  clitrigger config tunnel off  터널 비활성화
   clitrigger config path        설정 디렉토리 경로 출력
+  clitrigger config clear       설정 및 데이터 완전 삭제
   clitrigger --help             이 도움말 표시
 `.trim());
 }

package/bin/postuninstall.js

@@ -0,0 +1,19 @@
+#!/usr/bin/env node
+
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+
+const CONFIG_DIR = path.join(os.homedir(), '.clitrigger');
+
+if (fs.existsSync(CONFIG_DIR)) {
+  console.log(`
+CLITrigger가 제거되었습니다.
+
+설정 및 데이터가 아래 경로에 남아 있습니다:
+  ${CONFIG_DIR}
+
+완전히 제거하려면 해당 폴더를 수동으로 삭제해주세요:
+  rm -rf ${CONFIG_DIR}
+`.trim());
+}