seogitan 1.4.0 → 1.4.2

package/dist/commands/setup.js

@@ -7,55 +7,76 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 const BUNDLED_SKILLS_DIR = join(__dirname, "..", "..", "skills");
 // 설치 대상: ~/.claude/skills/
 const TARGET_SKILLS_DIR = join(homedir(), ".claude", "skills");
-const SEOGITAN_SKILLS = ["record", "meetings", "summary", "upload"];
+const SEOGITAN_SKILLS = ["record", "meetings", "summary", "upload", "doctor"];
 export function registerSetupCommand(program) {
     program
         .command("setup")
         .description("Claude Code 스킬을 설치합니다")
         .option("--force", "기존 스킬을 덮어씁니다")
+        .option("--debug", "디버그 정보 출력", false)
         .action(async (opts) => {
-        console.log("🔧 Seogitan 설치를 시작합니다...\n");
-        // 1. 스킬 설치
-        if (!existsSync(BUNDLED_SKILLS_DIR)) {
-            console.error("❌ 번들된 스킬을 찾을 수 없습니다. 패키지가 손상되었을 수 있습니다.");
-            process.exit(1);
-        }
-        mkdirSync(TARGET_SKILLS_DIR, { recursive: true });
-        let installed = 0;
-        let skipped = 0;
-        for (const skill of SEOGITAN_SKILLS) {
-            const src = join(BUNDLED_SKILLS_DIR, skill);
-            const dest = join(TARGET_SKILLS_DIR, `seogitan-${skill}`);
-            if (!existsSync(src)) {
-                console.log(`  ⚠ ${skill} 스킬을 찾을 수 없습니다 (건너뜀)`);
-                continue;
+        try {
+            console.log("Seogitan setup\n");
+            if (opts.debug) {
+                console.log("[debug] skills dir:", BUNDLED_SKILLS_DIR);
+                console.log("[debug] target dir:", TARGET_SKILLS_DIR);
+                console.log("[debug] skills dir exists:", existsSync(BUNDLED_SKILLS_DIR));
             }
-            if (existsSync(dest) && !opts.force) {
-                console.log(`  ✓ seogitan-${skill} (이미 설치됨)`);
-                skipped++;
-                continue;
+            // 1. 스킬 설치
+            if (!existsSync(BUNDLED_SKILLS_DIR)) {
+                console.error("ERROR: 번들된 스킬을 찾을 수 없습니다.");
+                console.error("패키지가 손상되었을 수 있습니다. npm i -g seogitan@latest 로 재설치하세요.");
+                if (opts.debug)
+                    console.error("[debug] expected path:", BUNDLED_SKILLS_DIR);
+                process.exit(1);
             }
-            cpSync(src, dest, { recursive: true });
-            console.log(`  ✓ seogitan-${skill} 설치 완료`);
-            installed++;
-        }
-        console.log(`\n📦 스킬 설치: ${installed}개 설치, ${skipped}개 기존 유지`);
-        // 2. ffmpeg 확인
-        try {
-            const { checkFfmpegInstalled } = await import("../lib/audio.js");
-            checkFfmpegInstalled();
-            console.log("\n✓ ffmpeg 사용 가능");
+            mkdirSync(TARGET_SKILLS_DIR, { recursive: true });
+            let installed = 0;
+            let skipped = 0;
+            for (const skill of SEOGITAN_SKILLS) {
+                const src = join(BUNDLED_SKILLS_DIR, skill);
+                const dest = join(TARGET_SKILLS_DIR, `seogitan-${skill}`);
+                if (!existsSync(src)) {
+                    console.log(`  [skip] ${skill}`);
+                    continue;
+                }
+                if (existsSync(dest) && !opts.force) {
+                    console.log(`  [ok] seogitan-${skill} (already installed)`);
+                    skipped++;
+                    continue;
+                }
+                cpSync(src, dest, { recursive: true });
+                console.log(`  [ok] seogitan-${skill} installed`);
+                installed++;
+            }
+            console.log(`\nSkills: ${installed} installed, ${skipped} skipped`);
+            // 2. ffmpeg 확인
+            try {
+                const { checkFfmpegInstalled } = await import("../lib/audio.js");
+                checkFfmpegInstalled();
+                console.log("[ok] ffmpeg available");
+            }
+            catch {
+                console.log("[warn] ffmpeg not found. Required for recording.");
+                if (process.platform === "darwin")
+                    console.log("  brew install ffmpeg");
+                else if (process.platform === "win32")
+                    console.log("  winget install ffmpeg OR choco install ffmpeg");
+                else
+                    console.log("  sudo apt install ffmpeg");
+            }
+            // 3. 로그인 안내
+            console.log("\nNext steps:");
+            console.log("  1. seogitan login     -- Google login");
+            console.log("  2. seogitan record    -- Start recording");
+            console.log("  3. Use /seogitan-record, /seogitan-meetings, /seogitan-summary in Claude Code");
+            console.log("");
         }
-        catch {
-            console.log("\n⚠ ffmpeg를 찾을 수 없습니다. 녹음 기능을 사용하려면 설치가 필요합니다.");
-            console.log("  macOS: brew install ffmpeg");
-            console.log("  Ubuntu/Debian: sudo apt install ffmpeg");
+        catch (err) {
+            console.error("Setup failed:", err instanceof Error ? err.message : String(err));
+            if (opts.debug && err instanceof Error)
+                console.error(err.stack);
+            process.exit(1);
         }
-        // 3. 로그인 안내
-        console.log("\n📋 다음 단계:");
-        console.log("  1. seogitan login     — Google 계정으로 로그인");
-        console.log("  2. seogitan record    — 회의 녹음 시작");
-        console.log("  3. Claude Code에서 /seogitan-record, /seogitan-meetings, /seogitan-summary 사용 가능");
-        console.log("");
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "seogitan",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "type": "module",
   "bin": {
     "seogitan": "dist/index.js"
@@ -19,7 +19,7 @@
     "commander": "^13.0.0",
     "ffmpeg-static": "^5.3.0",
     "open": "^10.0.0",
-    "seogitan-core": "^1.1.0",
+    "seogitan-core": "^1.1.1",
     "zod": "^3.24.3"
   },
   "devDependencies": {

package/skills/doctor/SKILL.md

@@ -0,0 +1,72 @@
+---
+name: doctor
+description: "서기탄이 시스템의 에러를 진단하고 해결합니다. 녹음/전사/요약/업로드 중 에러가 발생했을 때, 또는 사용자가 '에러', '오류', '안돼', '실패', 'doctor', '진단' 등을 언급할 때 사용. 다른 서기탄이 스킬에서 에러 발생 시 이 스킬로 위임됩니다."
+---
+
+# /doctor — 서기탄이 에러 진단
+
+## 진단 절차
+
+1. 로그 확인: `tail -20 /tmp/seogitan-record.log`
+2. 에러 메시지를 아래 매뉴얼에서 매칭
+3. 해결 방법 안내
+
+## 에러 매뉴얼
+
+### 인증/토큰
+| 에러 메시지 | 원인 | 해결 |
+|------------|------|------|
+| "로그인이 필요합니다" | 미로그인 또는 토큰 만료 | `seogitan login` 실행 |
+| "Invalid token" / "Invalid JWT" | 토큰 만료 | `seogitan login` 실행 |
+| "Google token refresh failed" | Google 인증 만료 | `seogitan login`으로 재인증 |
+| "Unauthorized" / "401" | 권한 없음 | `seogitan login` 실행 |
+
+**주의: `seogitan auth`라는 명령어는 존재하지 않음. 반드시 `seogitan login`**
+
+### 녹음/ffmpeg
+| 에러 메시지 | 원인 | 해결 |
+|------------|------|------|
+| "ffmpeg가 설치되어 있지 않습니다" | ffmpeg 미설치 | `seogitan setup` 실행 |
+| "No such device" / "Device not found" | 오디오 장치 없음 | `seogitan record --list-devices`로 확인 후 `--device <index>` 지정 |
+| "ffmpeg 응답 없음, 강제 종료" | ffmpeg 비정상 종료 | 재시도. 반복되면 `brew install ffmpeg`로 시스템 ffmpeg 설치 |
+
+### 전사/n8n
+| 에러 메시지 | 원인 | 해결 |
+|------------|------|------|
+| "Edge Function 호출 실패 (401)" | Supabase JWT 만료 | `seogitan login` 실행 |
+| "Edge Function 호출 실패 (500)" | Edge Function 서버 에러 | 잠시 후 재시도 |
+| 전사가 안 됨 (로그에 에러 없음) | n8n 워크플로우 비활성화 | n8n 대시보드에서 워크플로우 활성 상태 확인 |
+
+### 삭제
+| 에러 메시지 | 원인 | 해결 |
+|------------|------|------|
+| "회의 삭제 실패" | RLS 정책 (본인 회의만 삭제 가능) | 본인이 생성한 회의만 삭제 가능 |
+| "Direct deletion from storage tables" | Storage 트리거 문제 | CLI `seogitan meetings delete <id>` 사용 |
+
+### 설치
+| 에러 메시지 | 원인 | 해결 |
+|------------|------|------|
+| "EACCES: permission denied" | npm 글로벌 설치 권한 없음 | `sudo npm i -g seogitan` 또는 nvm 사용 |
+| "번들된 스킬을 찾을 수 없습니다" | 패키지 손상 | `npm i -g seogitan@latest` 재설치 |
+
+## CLI 명령어 레퍼런스
+
+```
+seogitan login          # Google OAuth 로그인
+seogitan logout         # 로그아웃
+seogitan setup          # 스킬 설치 + ffmpeg 확인
+seogitan record [title] # 녹음 시작
+seogitan upload <file>  # 파일 업로드
+seogitan meetings list  # 회의 목록
+seogitan meetings show <id>    # 상세 조회
+seogitan meetings delete <id>  # 삭제
+seogitan meetings tag <id> <tags...>  # 태그 설정
+seogitan summarize <id>        # 요약 생성
+```
+
+## 진단이 안 되는 경우
+
+위 매뉴얼에 없는 에러면:
+1. `seogitan --version`으로 버전 확인 → 최신이 아니면 `npm i -g seogitan@latest`
+2. `seogitan setup --force`로 재설정
+3. 그래도 안 되면 에러 메시지 전문을 사용자에게 보여주고 GitHub 이슈로 안내

package/skills/meetings/SKILL.md

@@ -30,3 +30,7 @@ seogitan meetings search "키워드" --json
 ## 결과 처리
 
 JSON 결과에서 각 회의의 ID, 제목, 날짜, 상태를 추출하여 보기 좋게 정리해서 보여준다.
+
+## 에러 대응
+
+에러 발생 시 `/doctor` 스킬을 호출하여 진단합니다.

package/skills/record/SKILL.md

@@ -5,15 +5,16 @@ description: "터미널에서 회의 녹음을 시작합니다. ffmpeg로 마이
 
 # /record — 회의 녹음 시작
 
-$ARGUMENTS가 제공되면 회의 제목으로 사용합니다.
+## 핵심 원칙: 녹음은 즉시 시작
 
-## 실행 전: 캘린더 확인
+녹음 요청을 받으면 **질문 없이 바로 실행**합니다. 회의는 기다려주지 않습니다.
 
-**반드시** 녹음 시작 전에 사용자에게 캘린더 연결 여부를 물어보세요:
-- "캘린더 일정에 자동 연결할까요, 아니면 제목을 직접 지정할까요?"
-- 자동 연결 → 제목 없이 `seogitan record` 실행 (진행 중인 일정 자동 매칭)
-- 제목 지정 → 사용자가 알려준 제목으로 `seogitan record "제목"` 실행
-- 빠르게 시작하고 싶다면 → 제목 없이 실행 (캘린더 자동 연결)
+## 캘린더 연결 판단 (녹음 시작 전, 질문하지 않음)
+
+사용자의 요청 문맥에서 판단:
+- "회의 녹음해줘", "스터디 녹음" 등 **일정과 연관된 언급** → 제목 없이 실행 (캘린더 자동 연결)
+- "녹음해줘", "녹음 시작" 등 **단순 녹음 요청** → 제목 "새 녹음"으로 실행 (캘린더 연결 안 됨)
+- $ARGUMENTS에 명시적 제목이 있으면 → 그 제목으로 실행
 
 ## 실행
 
@@ -31,16 +32,31 @@ nohup seogitan record "제목" > /tmp/seogitan-record.log 2>&1 &
 echo "PID: $!"
 ```
 
+실행 직후 3초 대기 후 로그 확인:
+```bash
+sleep 3 && cat /tmp/seogitan-record.log
+```
+
 실행 후 사용자에게 알려줄 내용:
 - "녹음이 백그라운드에서 시작되었습니다"
 - "종료하려면 별도 터미널에서 `kill -INT <PID>` 실행"
 - "로그 확인: `tail -f /tmp/seogitan-record.log`"
 - 녹음 중에도 대화를 계속할 수 있습니다
 
-## 녹음 종료 후 확인
+## 녹음 종료 후
 
 사용자가 녹음을 종료했다고 하면:
 ```bash
 tail -5 /tmp/seogitan-record.log
 ```
-로그에서 Meeting ID를 찾아 `/summary` 스킬로 요약을 조회합니다.
+
+1. 로그에서 Meeting ID를 찾는다
+2. 캘린더 자동 연결이 된 경우, 사용자에게 **연결 유지할지 확인**:
+   - "캘린더 [일정명]에 연결되었습니다. 유지할까요?"
+   - 유지 → 그대로 둠
+   - 연결 해제 → `seogitan meetings link <id> ""` 로 calendar_event_id 제거
+3. `/summary` 스킬로 요약 조회
+
+## 에러 대응
+
+로그에서 에러가 발견되면 `/doctor` 스킬을 호출하여 진단합니다.

package/skills/summary/SKILL.md

@@ -33,3 +33,7 @@ seogitan meetings show "$ARGUMENTS" --full --json
 - "레퍼럴 관련 결정사항 자세히 알려줘" → 1단계 후 2단계 (전사록에서 관련 부분 찾기)
 - "누가 뭐라고 했는지 알려줘" → 바로 2단계 (전사록 필요)
 - "액션아이템 담당자 누구야?" → 2단계 (전사록에서 맥락 파악)
+
+## 에러 대응
+
+에러 발생 시 `/doctor` 스킬을 호출하여 진단합니다.

package/skills/upload/SKILL.md

@@ -41,3 +41,7 @@ seogitan upload "<파일>" --calendar-search "레퍼럴" --calendar-index 1
 ```
 
 검색 결과가 여러 개면 목록을 보여주고 사용자에게 번호를 물어본 후 `--calendar-index`로 재실행.
+
+## 에러 대응
+
+에러 발생 시 `/doctor` 스킬을 호출하여 진단합니다.