vibe-collab 0.8.11 → 0.8.14

package/README.md

@@ -17,7 +17,7 @@
     ← JWT 토큰 발급 ←──────────────────────
     → ~/.vibe/auth.json 저장
 
-  Claude Code / Cursor / VS Code
+  Claude Code / Cursor / Gemini CLI / Antigravity ...
     → MCP 도구 호출 (vibe_start_session 등)
     → AI 요청 ──────────────────────────→ /api/ai/complete (JWT 인증)
     ← AI 응답 ←────────────────────────── Anthropic API 호출 후 반환
@@ -25,47 +25,52 @@
 
 - **AI API 키 불필요** — 서버(vibeorchestratorserver.vercel.app)가 관리합니다
 - **GitHub 로그인 한 번** — 이후 모든 AI 기능 자동 사용
-- **MCP 자동 연결** — `vibe init` 한 번으로 Claude Code, Cursor, VS Code 동시 설정
+- **10개 MCP 도구** — git commit/push까지 AI가 직접 실행, 사용자는 채팅만
 
 ---
 
 ## 빠른 시작
 
-### 1단계 — 설치
+### 프로젝트 팀장 (최초 1회)
 
 ```bash
 npm install -g vibe-collab
-```
 
-### 2단계 — 로그인
+vibe auth login          # GitHub 로그인
+cd /path/to/your/project
+vibe init                # CHARTER.md + .vibe/ 생성
+vibe connect             # AI 도구 자동 감지 + MCP 설정
 
-```bash
-vibe auth login
+git add .vibe CHARTER.md
+git commit -m "chore: init vibe"
+git push
 ```
 
-브라우저가 열리면 GitHub 계정으로 로그인하세요. 완료되면 터미널로 돌아옵니다.
-
-### 3단계 — 프로젝트 초기화
+### 새 협업자 합류 (최초 1회)
 
 ```bash
-cd /path/to/your/project
-vibe init
-```
+npm install -g vibe-collab
 
-GitHub 레포 URL을 입력하면 자동으로 설정됩니다:
-- `CHARTER.md` — AI가 분석한 레포 컨벤션
-- `.vibe/state.json` — 팀 협업 상태
-- `.claude/settings.json` — Claude Code MCP 설정
-- `.vscode/mcp.json` — VS Code MCP 설정
+git clone <repo-url>     # .vibe/ 폴더도 함께 옴
+vibe auth login          # 본인 GitHub 계정으로 로그인
+vibe connect             # AI 도구에 MCP 설정 추가
+```
 
-### 4단계 — 작업 시작
+> `vibe init`은 다시 실행하지 않아도 됩니다. `.vibe/config.json`과 `CHARTER.md`는 이미 레포에 있습니다.
 
-Claude Code, Cursor 등 AI 도구에서 `vibe_start_session`을 호출하면 팀 컨텍스트가 자동으로 주입됩니다.
+### 매일 작업 (자동)
 
-```bash
-# CLI로도 직접 시작 가능
-vibe start
 ```
+AI 채팅창 열기
+→ AI가 vibe_start_session 자동 호출 (팀 현황 파악)
+→ "~~ 기능 추가해줘" 요청
+→ AI가 vibe_analyze_request → vibe_start_work 자동 진행
+   (기존 이슈 브랜치면 git fetch + checkout + pull도 자동)
+→ 코드 작업 → vibe_record_checkpoint → vibe_git_push
+   (git commit & push도 AI가 MCP를 통해 자동 실행)
+```
+
+**git pull, vibe init, vibe start 같은 명령어를 매번 실행할 필요 없습니다.**
 
 ---
 
@@ -76,18 +81,13 @@ vibe start
 | `vibe auth login` | GitHub OAuth 로그인 |
 | `vibe auth logout` | 로그아웃 |
 | `vibe auth status` | 로그인 상태 및 만료일 확인 |
-| `vibe init` | 프로젝트 초기화 (CHARTER, state.json 생성 + MCP 자동 감지) |
-| `vibe connect` | 프로젝트 내 AI 도구 자동 감지 후 MCP 설정 추가 |
-| `vibe connect --ai <tool>` | 특정 AI 도구에 MCP 설정 추가 (해당 도구의 수동 설정 가이드만 표시) |
-| `vibe start` | 작업 시작 또는 이어서 진행 |
+| `vibe init` | 프로젝트 초기화 — **팀장이 최초 1회만 실행** |
+| `vibe connect` | AI 도구 자동 감지 후 MCP 설정 추가 |
+| `vibe connect --ai <tool>` | 특정 AI 도구에 MCP 설정 추가 |
 | `vibe status` | 팀 현황 출력 |
 | `vibe serve` | MCP 서버 시작 (AI 도구에서 자동 실행됨) |
-| `vibe update` | vibe-collab을 최신 버전으로 업데이트 |
-
-### `vibe connect --ai` 지원 도구
 
-각 도구별로 올바른 설정 파일 경로와 형식을 자동으로 적용합니다.
-`--ai <tool>` 지정 시 해당 도구의 수동 설정 가이드만 출력됩니다.
+### `vibe connect` 지원 도구
 
 | 명령어 | 도구 | 설정 파일 |
 |--------|------|-----------|
@@ -97,53 +97,98 @@ vibe start
 | `vibe connect --ai copilot` | Copilot | `.vscode/mcp.json` |
 | `vibe connect --ai kiro` | Kiro | `.kiro/settings/mcp.json` |
 | `vibe connect --ai roocode` | Roo Code | `.roo/mcp.json` |
-| `vibe connect --ai trae` | Trae | `.trae/mcp.json` (배열 형식) |
+| `vibe connect --ai trae` | Trae | `.trae/mcp.json` |
 | `vibe connect --ai continue` | Continue | `.continue/mcpServers/mcp.json` |
-| `vibe connect --ai opencode` | OpenCode | `.opencode/config.toml` |
-| `vibe connect --ai codex` | Codex CLI | `.codex/config.toml` |
-| `vibe connect --ai qoder` | Qoder | `.qoder/mcp.json` |
-| `vibe connect --ai codebuddy` | CodeBuddy | `.codebuddy/mcp.json` |
-| `vibe connect --ai droid` | Droid | `.droid/mcp.json` |
 | `vibe connect --ai windsurf` | Windsurf | `~/.codeium/windsurf/mcp_config.json` (전역) |
 | `vibe connect --ai gemini` | Gemini CLI | `~/.gemini/settings.json` (전역) |
 | `vibe connect --ai antigravity` | Antigravity | `~/.gemini/antigravity/mcp_config.json` (전역) |
-| `vibe connect --ai all` | 위 전체 설정 | — |
+| `vibe connect --ai all` | 위 전체 | — |
 
-> **Windsurf / Gemini CLI / Antigravity**: 전역 설정 파일에 기록됩니다 (프로젝트 디렉토리 불필요). 기존 설정 파일의 형식(객체/배열)이 다를 경우 자동으로 호환 처리합니다.
+> **Windsurf / Gemini CLI / Antigravity**: 전역 설정에 기록됩니다. `--cwd <프로젝트 경로>`가 자동으로 주입되어 어느 디렉토리에서 실행해도 올바른 프로젝트를 찾습니다.
 
 ---
 
-## MCP 도구 (8개)
+## MCP 도구 (10개)
 
-Claude Code, Cursor, VS Code 등 MCP를 지원하는 모든 AI 도구에서 사용할 수 있습니다.
+Claude Code, Cursor, Gemini CLI 등 MCP를 지원하는 모든 AI 도구에서 사용할 수 있습니다.
 
 | 도구 | 설명 |
 |------|------|
-| `vibe_start_session` | 세션 시작 — CHARTER, 팀 현황, 내 상태 반환 |
-| `vibe_analyze_request` | 요청을 분석해 관련 이슈 연결 또는 신규 제안 |
-| `vibe_start_work` | 브랜치 준비 및 작업 시작 |
-| `vibe_record_checkpoint` | 단계 완료 기록 |
-| `vibe_request_qa` | 코드 리뷰 요청 (정적 분석 + AI 검사) |
+| `vibe_start_session` | 세션 시작 — CHARTER, 팀 현황, 워크플로우 규칙 반환 |
+| `vibe_analyze_request` | 요청 분석 → 관련 이슈 연결 또는 신규 제안, 이전 대화 기록 복원 |
+| `vibe_start_work` | 작업 시작 — 기존 브랜치면 자동 checkout+pull, 신규면 브랜치 생성 |
+| `vibe_record_checkpoint` | 단계 완료 기록 (code_complete, qa_passed 등) |
+| `vibe_git_push` | git add -A → commit → push 자동 실행 (state.json 포함) |
+| `vibe_save_context` | 결정/진행 상황/피드백을 이슈별로 저장 → 다음 세션에서 자동 복원 |
+| `vibe_request_qa` | 코드 리뷰 (정적 분석 + AI 검사) |
 | `vibe_create_pr` | PR 자동 생성 |
 | `vibe_request_merge_review` | 머지 전 충돌 검사 |
 | `vibe_execute_merge` | Squash merge + CHARTER 자동 갱신 |
 
+### AI가 따르는 워크플로우
+
+```
+① 사용자 요청 → vibe_analyze_request
+② 작업 확정   → vibe_start_work (기존 브랜치 자동 checkout+pull)
+③ 코드 완료   → vibe_record_checkpoint(stage: "code_complete")
+④ 커밋+푸시   → vibe_git_push (state.json 포함 전체 자동)
+⑤ 코드 검토   → vibe_request_qa
+⑥ 검토 통과  → vibe_create_pr
+```
+
+---
+
+## 세션 간 대화 기록 유지 (`vibe_save_context`)
+
+AI가 중요한 결정이나 피드백을 `.vibe/logs/{issueNumber}.md`에 저장합니다.
+
+```markdown
+# 이슈 #5 작업 로그
+
+## [2026-03-01 14:30] alice (claude-code) — 결정
+JWT 방식 채택. Session 방식은 서버 부하 문제로 기각.
+
+## [2026-03-02 09:00] bob (gemini-cli) — 사용자 피드백
+에러 메시지를 더 친절하게 바꿔달라고 함.
+```
+
+같은 이슈를 다음 세션이나 다른 AI 에이전트가 이어받을 때, `vibe_analyze_request`가 이 기록을 자동으로 읽어서 컨텍스트에 포함합니다.
+
 ---
 
 ## 여러 AI 동시 협업 예시
 
-```bash
-# 터미널 A — Claude Code로 작업 중
-# vibe_start_session { userName: "김지혁", githubId: "jihyuk-kim" }
+```
+[Claude Code — alice]               [Gemini CLI — bob]
+vibe_start_session                  vibe_start_session
+→ 이슈 #5 담당                       → 이슈 #6 담당
 
-# 터미널 B — Cursor로 다른 기능 동시 작업
-# vibe_start_session { userName: "이민수", githubId: "minsoo-lee" }
+코드 수정                            코드 수정
+vibe_record_checkpoint               vibe_record_checkpoint
+vibe_git_push                        vibe_git_push
 
-# 두 세션이 동일한 state.json을 공유 → 충돌 없이 병렬 개발
+두 세션이 동일한 .vibe/state.json 공유 → 충돌 없이 병렬 개발
 ```
 
 ---
 
+## 협업 시 `.vibe` 폴더 관리
+
+`.vibe/` 폴더는 반드시 Git으로 관리해야 합니다.
+
+```
+.vibe/
+  config.json      ← GitHub 레포 정보 (vibe init 1회)
+  state.json       ← 팀 협업 상태 (매 작업마다 업데이트)
+  intents/         ← 이슈별 분석 기록
+  logs/            ← 이슈별 대화 기록 (vibe_save_context)
+CHARTER.md         ← 레포 컨벤션 (vibe init 1회, merge 시 자동 갱신)
+```
+
+> `state.json`은 `vibe_git_push`가 자동으로 커밋에 포함합니다.
+
+---
+
 ## 프록시 서버
 
 AI 요청은 **https://vibeorchestratorserver.vercel.app** 을 통해 처리됩니다.
@@ -151,7 +196,6 @@ AI 요청은 **https://vibeorchestratorserver.vercel.app** 을 통해 처리됩
 - `/api/ai/complete` — JWT 인증 후 Anthropic API 호출
 - `/api/auth/cli-token` — GitHub OAuth 후 CLI 토큰 발급
 
-
 ---
 
 ## 라이선스

package/dist/cli/commands/auth.js

@@ -139,10 +139,11 @@ export async function authCommand(action) {
         case 'login': {
             const existing = readAuthData();
             if (existing) {
-                console.log(chalk.yellow(`이미 로그인되어 있습니다: @${existing.user.login}\n` +
+                console.log(chalk.yellow(`현재 로그인: @${existing.user.login} (${existing.user.name})\n` +
                     `만료: ${new Date(existing.expiresAt).toLocaleString('ko-KR')}\n\n` +
-                    `재로그인하려면: vibe auth logout 후 vibe auth login`));
-                return;
+                    `다른 계정으로 전환하려면 계속 진행하세요...`));
+                // 기존 토큰 제거 후 재로그인 (계정 전환 지원)
+                deleteAuthData();
             }
             await loginFlow();
             process.exit(0);

package/dist/mcp/server.js

@@ -11,6 +11,8 @@ import { requestQA } from './tools/requestQA.js';
 import { createPR } from './tools/createPR.js';
 import { requestMergeReview } from './tools/requestMergeReview.js';
 import { executeMerge } from './tools/executeMerge.js';
+import { gitPush } from './tools/gitPush.js';
+import { saveContext } from './tools/saveContext.js';
 // cwd에서 위로 올라가며 .vibe/state.json이 있는 프로젝트 루트를 탐색
 function findProjectRoot(startDir) {
     let dir = startDir;
@@ -239,6 +241,49 @@ export async function startMCPServer(explicitPath) {
                     required: ['prNumber', 'actor'],
                 },
             },
+            {
+                name: 'vibe_git_push',
+                description: '코드 변경 후 반드시 이 도구로 커밋&푸시하세요. git add -A (state.json 포함) → commit → push를 자동 실행합니다. 터미널 git 명령 사용 금지.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        commitMessage: {
+                            type: 'string',
+                            description: '커밋 메시지',
+                        },
+                    },
+                    required: ['commitMessage'],
+                },
+            },
+            {
+                name: 'vibe_save_context',
+                description: '중요한 결정, 진행 상황, 사용자 피드백을 이슈별로 저장합니다. 다음 세션이나 다른 AI가 이어받을 때 이 기록이 자동으로 복원됩니다. 중요한 대화 내용이 있을 때마다 호출하세요.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        issueNumber: { type: 'number', description: '이슈 번호' },
+                        actor: {
+                            type: 'object',
+                            properties: {
+                                name: { type: 'string' },
+                                githubId: { type: 'string' },
+                                agent: { type: 'string' },
+                            },
+                            required: ['name', 'githubId', 'agent'],
+                        },
+                        type: {
+                            type: 'string',
+                            enum: ['decision', 'progress', 'user_feedback'],
+                            description: 'decision: 기술적 결정, progress: 진행 상황, user_feedback: 사용자 의견',
+                        },
+                        content: {
+                            type: 'string',
+                            description: '저장할 내용 (간결하게 요약)',
+                        },
+                    },
+                    required: ['issueNumber', 'actor', 'type', 'content'],
+                },
+            },
         ],
     }));
     // CallTool 핸들러
@@ -271,6 +316,12 @@ export async function startMCPServer(explicitPath) {
                 case 'vibe_execute_merge':
                     result = await executeMerge(repoPath, args);
                     break;
+                case 'vibe_git_push':
+                    result = await gitPush(repoPath, args);
+                    break;
+                case 'vibe_save_context':
+                    result = await saveContext(repoPath, args);
+                    break;
                 default:
                     result = JSON.stringify({ error: `알 수 없는 도구: ${name}` });
             }

package/dist/mcp/tools/_actor.d.ts

@@ -0,0 +1,6 @@
+import type { Actor } from '../../state/types.js';
+/**
+ * AI가 넘긴 actor 파라미터를 ~/.vibe/auth.json으로 override.
+ * 로그인된 계정 정보가 있으면 무조건 그걸 사용 (AI가 틀린 정보 넘겨도 무시).
+ */
+export declare function resolveActor(input: Actor): Actor;

package/dist/mcp/tools/_actor.js

@@ -0,0 +1,16 @@
+import { readAuthData } from '../../cli/commands/auth.js';
+/**
+ * AI가 넘긴 actor 파라미터를 ~/.vibe/auth.json으로 override.
+ * 로그인된 계정 정보가 있으면 무조건 그걸 사용 (AI가 틀린 정보 넘겨도 무시).
+ */
+export function resolveActor(input) {
+    const auth = readAuthData();
+    if (!auth)
+        return input;
+    return {
+        name: auth.user.name || auth.user.login || input.name,
+        githubId: auth.user.login || input.githubId,
+        agent: input.agent,
+    };
+}
+//# sourceMappingURL=_actor.js.map

package/dist/mcp/tools/analyzeRequest.js

@@ -1,7 +1,10 @@
 import { callAI, getAIProvider } from '../../ai/client.js';
-import { readState } from '../../state/reader.js';
+import { readState, readContextLog } from '../../state/reader.js';
+import { saveIntentLog } from '../../state/writer.js';
+import { resolveActor } from './_actor.js';
 export async function analyzeRequest(repoPath, input) {
-    const { userRequest, actor } = input;
+    const { userRequest } = input;
+    const actor = resolveActor(input.actor);
     const state = await readState(repoPath);
     const openIssues = state.issues.filter((i) => i.status === 'open' || i.status === 'in_progress');
     // 이슈 없으면 바로 new 반환
@@ -33,6 +36,19 @@ export async function analyzeRequest(repoPath, input) {
         if (parsed.matched && parsed.confidence >= 0.7 && parsed.issueNumber) {
             const matchedIssue = openIssues.find((i) => i.number === parsed.issueNumber);
             if (matchedIssue) {
+                // intent 로그 저장 + 기존 컨텍스트 로그 읽기
+                const [, contextLog] = await Promise.all([
+                    saveIntentLog(repoPath, {
+                        issueNumber: matchedIssue.number,
+                        author: actor,
+                        timestamp: new Date().toISOString(),
+                        decided: [`사용자 요청: ${userRequest.substring(0, 200)}`],
+                        rejected: [],
+                        warnings: [],
+                        nextSteps: [`vibe_start_work(issueNumber: ${matchedIssue.number}) 호출`],
+                    }),
+                    readContextLog(repoPath, matchedIssue.number),
+                ]);
                 return JSON.stringify({
                     type: 'existing',
                     issue: {
@@ -40,8 +56,10 @@ export async function analyzeRequest(repoPath, input) {
                         title: matchedIssue.title,
                         branch: matchedIssue.branch,
                         stage: matchedIssue.stage,
+                        assignee: matchedIssue.assignee,
                     },
-                    checkpointMessage: `관련된 작업 항목이 있습니다:\n\n  #${matchedIssue.number} "${matchedIssue.title}"\n  현재 상태: ${matchedIssue.status === 'in_progress' ? '작업 중' : '시작 전'}\n\n이 작업에 이어서 작업할까요, 아니면 새로 시작할까요?\n  [1] 이어서 작업\n  [2] 새로 시작`,
+                    previousContext: contextLog || '이전 대화 기록 없음',
+                    checkpointMessage: `관련된 작업 항목이 있습니다:\n\n  #${matchedIssue.number} "${matchedIssue.title}"\n  현재 상태: ${matchedIssue.status === 'in_progress' ? '작업 중' : '시작 전'}${matchedIssue.assignee ? ` (담당: ${matchedIssue.assignee})` : ''}${contextLog ? `\n\n이전 대화 기록:\n${contextLog}` : ''}\n\n이 작업에 이어서 작업할까요, 아니면 새로 시작할까요?\n  [1] 이어서 작업\n  [2] 새로 시작`,
                 });
             }
         }

package/dist/mcp/tools/gitPush.d.ts

@@ -0,0 +1,3 @@
+export declare function gitPush(repoPath: string, input: {
+    commitMessage: string;
+}): Promise<string>;

package/dist/mcp/tools/gitPush.js

@@ -0,0 +1,40 @@
+import { execSync } from 'child_process';
+export async function gitPush(repoPath, input) {
+    const { commitMessage } = input;
+    try {
+        // 1. 모든 변경 파일 스테이징 (.vibe/state.json 포함)
+        execSync('git add -A', { cwd: repoPath, stdio: 'pipe' });
+        // 2. 스테이징된 변경 사항 확인
+        const staged = execSync('git status --porcelain', {
+            cwd: repoPath,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        if (!staged) {
+            return JSON.stringify({ success: true, message: '커밋할 변경 사항이 없습니다.' });
+        }
+        // 3. 커밋
+        const safeMessage = commitMessage.replace(/"/g, '\\"').replace(/`/g, '\\`');
+        execSync(`git commit -m "${safeMessage}"`, { cwd: repoPath, stdio: 'pipe' });
+        // 4. 푸시 (업스트림 자동 설정)
+        execSync('git push -u origin HEAD', { cwd: repoPath, stdio: 'pipe' });
+        // 5. 커밋 해시 조회
+        const sha = execSync('git rev-parse --short HEAD', {
+            cwd: repoPath,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        return JSON.stringify({
+            success: true,
+            sha,
+            message: `커밋 및 푸시 완료 (${sha}): ${commitMessage}`,
+        });
+    }
+    catch (error) {
+        const raw = error instanceof Error ? error.message : String(error);
+        // stderr 내용 추출
+        const msg = raw.split('\n').slice(0, 3).join(' ').trim();
+        return JSON.stringify({ error: `git 작업 실패: ${msg}` });
+    }
+}
+//# sourceMappingURL=gitPush.js.map

package/dist/mcp/tools/recordCheckpoint.js

@@ -1,5 +1,7 @@
+import { execSync } from 'child_process';
 import { readState } from '../../state/reader.js';
 import { appendWorkLog, updateIssueStage, setActiveWork } from '../../state/writer.js';
+import { resolveActor } from './_actor.js';
 function stageToKorean(stage) {
     const map = {
         not_started: '시작 전',
@@ -15,14 +17,45 @@ function stageToKorean(stage) {
     };
     return map[stage] ?? stage;
 }
-function buildCheckpointMessage(stage, details) {
+/**
+ * code_complete 시 자동으로 git add -A → commit → push 실행.
+ * state.json이 항상 커밋에 포함됨.
+ */
+function autoGitPush(repoPath, commitMessage) {
+    try {
+        execSync('git add -A', { cwd: repoPath, stdio: 'pipe' });
+        const staged = execSync('git status --porcelain', {
+            cwd: repoPath,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        if (!staged) {
+            return '(커밋할 변경 사항 없음)';
+        }
+        const safeMsg = commitMessage.replace(/"/g, '\\"').replace(/`/g, '\\`');
+        execSync(`git commit -m "${safeMsg}"`, { cwd: repoPath, stdio: 'pipe' });
+        execSync('git push -u origin HEAD', { cwd: repoPath, stdio: 'pipe' });
+        const sha = execSync('git rev-parse --short HEAD', {
+            cwd: repoPath,
+            encoding: 'utf-8',
+            stdio: 'pipe',
+        }).trim();
+        return `커밋 & 푸시 완료 (${sha})`;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message.split('\n')[0] : String(error);
+        return `git 자동 푸시 실패 (수동으로 vibe_git_push 호출하세요): ${msg}`;
+    }
+}
+function buildCheckpointMessage(stage, details, gitResult) {
     const { filesChanged, violations, retryCount, notes } = details;
     switch (stage) {
         case 'code_complete': {
             const filesText = filesChanged && filesChanged.length > 0
                 ? `\n변경된 파일:\n${filesChanged.map((f) => `  · ${f}`).join('\n')}`
                 : '';
-            return `✅ 코드 작성 완료${filesText}\n\n⚠️ 지금 바로 .vibe/state.json을 포함한 모든 변경 파일을 git commit & push 하세요.\n  커밋 명령: git add -A && git commit -m "..." && git push\n  (.vibe/state.json이 커밋에 빠지면 팀 기록이 누락됩니다)\n\n커밋 완료 후 검토를 시작하겠습니다. 계속할까요?\n  [예, 검토해주세요]  [아니오, 나중에 할게요]`;
+            const gitText = gitResult ? `\n\n📦 자동 커밋 결과: ${gitResult}` : '';
+            return `✅ 코드 작성 완료 — 커밋 & 푸시 자동 완료${filesText}${gitText}\n\n검토를 시작하겠습니다. 계속할까요?\n  [예, 검토해주세요]  [아니오, 나중에 할게요]`;
         }
         case 'qa_passed':
             return `✅ 검토 완료 — 팀 공유 준비됨\n\n검토 결과:\n  · 요청하신 기능이 모두 구현됐습니다 ✓\n  · 기존 기능에 영향 없음 ✓\n  · 코드 규칙 준수 ✓\n\n지금 팀에 공유하시겠습니까?\n  [예, 공유하기]  [아니오, 나중에]`;
@@ -48,7 +81,8 @@ function buildCheckpointMessage(stage, details) {
     }
 }
 export async function recordCheckpoint(repoPath, input) {
-    const { stage, actor, issueNumber, details } = input;
+    const { stage, issueNumber, details } = input;
+    const actor = resolveActor(input.actor);
     // 1. workLog 추가
     await appendWorkLog(repoPath, {
         actor,
@@ -69,8 +103,15 @@ export async function recordCheckpoint(repoPath, input) {
     }
     // 3. issues stage 업데이트
     await updateIssueStage(repoPath, issueNumber, { stage });
-    // 4. 체크포인트 메시지 생성
-    const checkpointMessage = buildCheckpointMessage(stage, details);
-    return JSON.stringify({ checkpointMessage });
+    // 4. code_complete 시 자동 git push (state.json 포함)
+    let gitResult;
+    if (stage === 'code_complete') {
+        const commitMsg = details.commitMessage
+            || `[Vibe] #${issueNumber} 코드 완료`;
+        gitResult = autoGitPush(repoPath, commitMsg);
+    }
+    // 5. 체크포인트 메시지 생성
+    const checkpointMessage = buildCheckpointMessage(stage, details, gitResult);
+    return JSON.stringify({ checkpointMessage, gitResult });
 }
 //# sourceMappingURL=recordCheckpoint.js.map

package/dist/mcp/tools/saveContext.d.ts

@@ -0,0 +1,9 @@
+import type { Actor } from '../../state/types.js';
+type ContextType = 'decision' | 'progress' | 'user_feedback';
+export declare function saveContext(repoPath: string, input: {
+    issueNumber: number;
+    actor: Actor;
+    type: ContextType;
+    content: string;
+}): Promise<string>;
+export {};

package/dist/mcp/tools/saveContext.js

@@ -0,0 +1,30 @@
+import { mkdir, appendFile, readFile } from 'fs/promises';
+import path from 'path';
+import { resolveActor } from './_actor.js';
+const typeLabel = {
+    decision: '결정',
+    progress: '진행 상황',
+    user_feedback: '사용자 피드백',
+};
+export async function saveContext(repoPath, input) {
+    const { issueNumber, type, content } = input;
+    const actor = resolveActor(input.actor);
+    const logsDir = path.join(repoPath, '.vibe', 'logs');
+    await mkdir(logsDir, { recursive: true });
+    const logPath = path.join(logsDir, `${issueNumber}.md`);
+    // 파일이 없으면 헤더 먼저 생성
+    try {
+        await readFile(logPath, 'utf-8');
+    }
+    catch {
+        await appendFile(logPath, `# 이슈 #${issueNumber} 작업 로그\n`, 'utf-8');
+    }
+    const now = new Date().toLocaleString('ko-KR');
+    const entry = `\n## [${now}] ${actor.githubId} (${actor.agent}) — ${typeLabel[type]}\n${content}\n`;
+    await appendFile(logPath, entry, 'utf-8');
+    return JSON.stringify({
+        success: true,
+        message: `컨텍스트 저장 완료 (이슈 #${issueNumber}, ${typeLabel[type]})`,
+    });
+}
+//# sourceMappingURL=saveContext.js.map

package/dist/mcp/tools/startSession.js

@@ -73,6 +73,15 @@ export async function startSession(repoPath, input) {
         : '일시중단된 작업 없음';
     return `=== VIBE ORCHESTRATOR 컨텍스트 로드 완료 ===
 
+╔══════════════════════════════════════════╗
+║  AI 필독 — 이 세션의 절대 규칙           ║
+╠══════════════════════════════════════════╣
+║ • 모든 작업 시작 전 vibe_ 도구 호출 필수  ║
+║ • git commit/push → vibe_git_push 사용   ║
+║ •  터미널 git 명령으로 커밋 절대 금지     ║
+║ • vibe_ 없이 진행 = 팀 기록 파괴         ║
+╚══════════════════════════════════════════╝
+
 [프로젝트]
 이름: ${state.project || '(미설정)'}
 최종 업데이트: ${state.lastUpdated || '(없음)'}
@@ -97,17 +106,24 @@ ${pausedText}
 
 [필수 워크플로우 — 순서 위반 금지]
 ① 사용자 요청 접수 → vibe_analyze_request 호출
-② 작업 항목 확정 → vibe_start_work 호출
+② 작업 항목 확정 → vibe_start_work 호출 (기존 브랜치 자동 checkout+pull 포함)
 ③ 코드 수정 완료 → vibe_record_checkpoint(stage: "code_complete") 즉시 호출 ← 절대 생략 금지
-④ vibe_record_checkpoint 완료 직후 → git add .vibe/state.json (코드 파일과 함께) → git commit → git push ← state.json 반드시 포함
+   → code_complete 호출 시 git commit & push가 자동으로 실행됩니다 (별도 git 명령 불필요)
 ⑤ 코드 검토 → vibe_request_qa 호출
 ⑥ 검토 통과 → vibe_create_pr 호출
 ⑦ 각 단계 완료 후 사용자에게 결과 전달 및 다음 단계 확인
 
+[추가 권장 — 언제든지]
+• 사용자가 중요한 피드백을 줄 때 → vibe_save_context(type: "user_feedback")
+• 기술적 결정을 내릴 때 → vibe_save_context(type: "decision")
+• 작업 중단 전 → vibe_save_context(type: "progress")로 진행 상황 요약
+  → 이 기록은 다음 세션/다른 AI가 이어받을 때 자동 복원됩니다
+
 [절대 금지]
-- 코드를 수정한 뒤 vibe_record_checkpoint를 호출하지 않는 것 (팀 기록 누락)
-- git commit 전에 vibe_record_checkpoint를 건너뛰는 것 (state.json이 커밋에서 누락됨)
-- .vibe/state.json을 git add/commit에서 제외하는 것 (팀 기록 손실)
+- vibe_ 도구 없이 코드 수정 또는 git 작업 진행 (팀 기록 파괴)
+- 코드 수정 후 vibe_record_checkpoint 건너뜀 (누락 금지)
+- 터미널로 git commit/push 직접 실행 (vibe_record_checkpoint가 자동 처리)
+- .vibe/state.json을 커밋에서 제외 (팀 기록 손실)
 - CHARTER 규칙 위반 코드 작성
 - Issue, PR, Merge, Branch 같은 기술 용어 사용자에게 노출
 ==========================================`;

package/dist/mcp/tools/startWork.js

@@ -1,7 +1,9 @@
-import { readState, readIntentLog, readConfig } from '../../state/reader.js';
+import { execSync } from 'child_process';
+import { readState, readIntentLog, readConfig, readContextLog } from '../../state/reader.js';
 import { writeState, setActiveWork, updateIssueStage, appendWorkLog, } from '../../state/writer.js';
 import { branchExists, createBranch, getRecentCommits, getChangedFiles } from '../../github/branches.js';
 import { createIssue } from '../../github/issues.js';
+import { resolveActor } from './_actor.js';
 function slugify(title) {
     return (title
         .toLowerCase()
@@ -10,8 +12,22 @@ function slugify(title) {
         .replace(/^-|-$/g, '')
         .substring(0, 30) || 'task');
 }
+/** 로컬 git으로 브랜치 전환 + pull. 실패해도 에러 문자열 반환 (throw 안 함) */
+function gitCheckoutAndPull(repoPath, branch) {
+    try {
+        execSync('git fetch origin', { cwd: repoPath, stdio: 'pipe' });
+        execSync(`git checkout ${branch}`, { cwd: repoPath, stdio: 'pipe' });
+        execSync(`git pull origin ${branch}`, { cwd: repoPath, stdio: 'pipe' });
+        return `브랜치 "${branch}"로 전환 및 최신 코드 반영 완료`;
+    }
+    catch (error) {
+        const msg = error instanceof Error ? error.message.split('\n')[0] : String(error);
+        return `브랜치 자동 전환 실패 (수동으로 실행: git checkout ${branch} && git pull): ${msg}`;
+    }
+}
 export async function startWork(repoPath, input) {
-    const { actor, createNew, newIssueTitle } = input;
+    const actor = resolveActor(input.actor);
+    const { createNew, newIssueTitle } = input;
     let { issueNumber } = input;
     const config = await readConfig(repoPath);
     if (!config) {
@@ -23,7 +39,6 @@ export async function startWork(repoPath, input) {
     if (createNew && newIssueTitle) {
         issueNumber = await createIssue(owner, repo, newIssueTitle, '');
         issueTitle = newIssueTitle;
-        // state에 추가
         const st = await readState(repoPath);
         st.issues.push({
             number: issueNumber,
@@ -42,27 +57,43 @@ export async function startWork(repoPath, input) {
         const issue = st.issues.find((i) => i.number === issueNumber);
         issueTitle = issue?.title ?? `이슈 #${issueNumber}`;
     }
-    // 2. 브랜치명 생성
-    const branchName = `vibe/${actor.githubId}/${issueNumber}/${slugify(issueTitle)}`;
-    // 3. 브랜치 없으면 생성
-    const exists = await branchExists(owner, repo, branchName);
-    if (!exists) {
-        await createBranch(owner, repo, branchName, defaultBranch);
+    // 2. 기존 이슈에 브랜치가 이미 있는지 확인
+    const currentState = await readState(repoPath);
+    const existingIssue = currentState.issues.find((i) => i.number === issueNumber);
+    const existingBranch = existingIssue?.branch ?? null;
+    let branchName;
+    let gitStatusMessage;
+    if (existingBranch) {
+        // 기존 브랜치 그대로 사용 + 로컬에서 checkout & pull
+        branchName = existingBranch;
+        gitStatusMessage = gitCheckoutAndPull(repoPath, existingBranch);
     }
-    // 4. 기존 커밋/변경 파일
+    else {
+        // 새 브랜치 생성
+        branchName = `vibe/${actor.githubId}/${issueNumber}/${slugify(issueTitle)}`;
+        const exists = await branchExists(owner, repo, branchName);
+        if (!exists) {
+            await createBranch(owner, repo, branchName, defaultBranch);
+        }
+        gitStatusMessage = `새 브랜치 생성됨: ${branchName}`;
+    }
+    // 3. 기존 커밋/변경 파일
     const [commits, changedFiles] = await Promise.all([
-        getRecentCommits(owner, repo, branchName, 5),
-        getChangedFiles(owner, repo, branchName, defaultBranch),
+        getRecentCommits(owner, repo, branchName, 5).catch(() => []),
+        getChangedFiles(owner, repo, branchName, defaultBranch).catch(() => []),
     ]);
     const existingChanges = commits.length > 0
         ? `이미 ${commits.length}개 저장이 있습니다:\n${commits.map((c) => `  · ${c}`).join('\n')}`
         : '이전 저장 없음';
-    // 5. intent 로그
-    const intentLog = await readIntentLog(repoPath, issueNumber);
+    // 4. intent 로그 + 채팅 컨텍스트 로그
+    const [intentLog, contextLog] = await Promise.all([
+        readIntentLog(repoPath, issueNumber),
+        readContextLog(repoPath, issueNumber),
+    ]);
     const intentText = intentLog
         ? `결정 사항: ${intentLog.decided.join(', ')}\n거절된 방안: ${intentLog.rejected.join(', ')}`
         : '없음 (새 작업)';
-    // 6. state 업데이트
+    // 5. state 업데이트
     await setActiveWork(repoPath, {
         issueNumber,
         actor: actor.githubId,
@@ -78,7 +109,7 @@ export async function startWork(repoPath, input) {
         assignee: actor.githubId,
         stage: 'work_started',
     });
-    // 7. workLog
+    // 6. workLog
     await appendWorkLog(repoPath, {
         actor,
         stage: 'work_started',
@@ -89,9 +120,12 @@ export async function startWork(repoPath, input) {
     });
     return JSON.stringify({
         branchName,
+        gitStatus: gitStatusMessage,
         existingChanges,
         intentLog: intentText,
-        readyMessage: `작업 공간이 준비됐습니다.\n브랜치: ${branchName}\n\n코드 작성을 시작하세요.`,
+        contextLog: contextLog || '이전 대화 기록 없음',
+        assignee: actor.githubId,
+        readyMessage: `작업 공간이 준비됐습니다.\n브랜치: ${branchName}\n${gitStatusMessage}\n\n코드 작성을 시작하세요. 완료 후 vibe_record_checkpoint → vibe_git_push 순으로 호출하세요.\n중요한 결정이나 사용자 피드백이 있으면 vibe_save_context로 기록하세요.`,
     });
 }
 //# sourceMappingURL=startWork.js.map

package/dist/state/reader.d.ts

@@ -3,3 +3,4 @@ export declare function readState(repoPath: string): Promise<VibeState>;
 export declare function readIntentLog(repoPath: string, issueNumber: number): Promise<IntentLog | null>;
 export declare function readCharter(repoPath: string): Promise<string>;
 export declare function readConfig(repoPath: string): Promise<VibeConfig | null>;
+export declare function readContextLog(repoPath: string, issueNumber: number): Promise<string>;

package/dist/state/reader.js

@@ -47,4 +47,15 @@ export async function readConfig(repoPath) {
         return null;
     }
 }
+export async function readContextLog(repoPath, issueNumber) {
+    const logPath = path.join(repoPath, '.vibe', 'logs', `${issueNumber}.md`);
+    try {
+        const content = await readFile(logPath, 'utf-8');
+        // 너무 길면 마지막 3000자만 (컨텍스트 과부하 방지)
+        return content.length > 3000 ? '...(이전 내용 생략)\n' + content.slice(-3000) : content;
+    }
+    catch {
+        return '';
+    }
+}
 //# sourceMappingURL=reader.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibe-collab",
-  "version": "0.8.11",
+  "version": "0.8.14",
   "description": "누가 어떤 AI를 써도, 항상 한 팀처럼 작동하는 바이브 코딩 협업 도구",
   "type": "module",
   "bin": {
@@ -39,4 +39,4 @@
     "tsx": "^4.19.0",
     "typescript": "^5.7.0"
   }
-}
+}