aiag-cli 2.12.0 → 2.13.0

package/dist/commands/sync.js

@@ -1,31 +1,31 @@
 /**
- * sync 명령어
+ * sync 명령어 (GitHub 중심)
  *
- * aiag-adp 웹 플랫폼과 로컬 feature_list.json 양방향 동기화
+ * GitHub를 Single Source of Truth로 두고 자동으로 동기화합니다.
  *
  * 사용법:
- *   aiag sync                     기본 동기화 (로컬 → 서버)
- *   aiag sync --pull              서버 → 로컬 동기화
- *   aiag sync --force             충돌 시 로컬 우선
- *   aiag sync --watch             실시간 이벤트 스트리밍
- *   aiag sync --status            동기화 상태 확인
+ *   aiag sync              Git 상태 감지 후 자동 pull/push
+ *   aiag sync --status     동기화 상태 확인
+ *   aiag sync --reset      GitHub 상태로 로컬 초기화 (원격 우선)
+ *   aiag sync --watch      실시간 이벤트 스트리밍
  *
- * 동기화 방향:
- *   - 기본: 로컬 변경사항을 서버에 반영
- *   - --pull: 서버 상태를 로컬에 반영
- *   - 양방향: 충돌 감지 및 해결 옵션 제공
+ * 동작 방식:
+ *   - up-to-date: "이미 최신 상태"
+ *   - behind: git pull 자동 실행
+ *   - ahead: git push 자동 실행
+ *   - diverged: 경고 메시지 + --reset 권장
  */
 import chalk from 'chalk';
 import ora from 'ora';
-import { isLoggedIn } from '../auth/credentials.js';
-import { isConnected, loadConnection, updateLastSyncAt, isProjectInitialized, loadPendingSync, clearPendingSync, getPendingSyncCount, } from '../utils/connection.js';
-import { readFeatureList, writeFeatureList, getProgress, } from '../utils/featureList.js';
-import { readProgress } from '../utils/progress.js';
-import { getApiClient, ApiError, NetworkError } from '../api/client.js';
-import { printError, printWarning, printInfo } from '../utils/output.js';
+import { isLoggedIn, loadCredentials } from '../auth/credentials.js';
+import { isConnected, loadConnection, updateLastSyncAt, isProjectInitialized, } from '../utils/connection.js';
+import { getApiClient } from '../api/client.js';
+import { printError, printSuccess, printWarning, printInfo } from '../utils/output.js';
 import { messages } from '../utils/messages.js';
 import { SSEClient, formatSSEEvent } from '../utils/sseClient.js';
-import { getRemoteSyncStatus, gitPull, gitPush } from '../utils/git.js';
+import { getRemoteSyncStatus, gitPull, gitPush, gitFetch, gitResetHard, } from '../utils/git.js';
+import { readProgress } from '../utils/progress.js';
+import { getProgress } from '../utils/featureList.js';
 // ============================================
 // 메인 명령어 함수
 // ============================================
@@ -33,7 +33,7 @@ import { getRemoteSyncStatus, gitPull, gitPush } from '../utils/git.js';
  * sync 명령어 실행
  */
 export async function sync(options) {
-    // 1. 동기화 상태 확인
+    // 1. 상태 확인
     if (options.status) {
         await handleSyncStatus();
         return;
@@ -43,240 +43,165 @@ export async function sync(options) {
         await handleWatch();
         return;
     }
-    // 3. 사전 조건 확인
-    if (!checkPrerequisites()) {
+    // 3. GitHub 상태로 초기화
+    if (options.reset) {
+        await handleReset();
         return;
     }
-    // 4. Git 상태 확인 및 처리 (--skip-git이 아닌 경우)
-    if (!options.skipGit) {
-        const gitHandled = await handleGitSync(options);
-        if (!gitHandled) {
-            // Git 동기화 실패 또는 사용자가 중단
-            return;
-        }
-    }
-    // 5. 동기화 방향에 따른 처리
-    if (options.pull) {
-        await handlePullSync(options);
-    }
-    else {
-        await handlePushSync(options);
-    }
+    // 4. 자동 동기화 (기본 동작)
+    await handleAutoSync();
 }
 // ============================================
-// 사전 조건 확인
+// 자동 동기화 (기본 동작)
 // ============================================
 /**
- * 동기화 전제 조건 확인
+ * Git 상태를 감지하여 자동으로 pull/push 수행
  */
-function checkPrerequisites() {
+async function handleAutoSync() {
     // 프로젝트 초기화 확인
     if (!isProjectInitialized()) {
         printError(messages.common.notInitialized);
         console.log(chalk.gray(messages.common.runInitFirst));
         process.exitCode = 1;
-        return false;
+        return;
     }
-    // 로그인 확인
-    if (!isLoggedIn()) {
-        printError(messages.login.serverRequired);
-        console.log(chalk.gray('먼저 로그인하세요: aiag login'));
-        process.exitCode = 1;
-        return false;
+    const spinner = ora('Git 상태 확인 중...').start();
+    try {
+        // Git fetch로 원격 상태 동기화
+        await gitFetch();
+        const status = await getRemoteSyncStatus();
+        spinner.stop();
+        // 상태 출력
+        printGitSyncStatus(status);
+        switch (status.status) {
+            case 'no-remote':
+                printInfo('원격 저장소가 설정되지 않았습니다.');
+                console.log(chalk.gray('  git remote add origin <url> 로 원격 저장소를 설정하세요.'));
+                break;
+            case 'no-upstream':
+                printInfo('원격 브랜치 트래킹이 설정되지 않았습니다.');
+                console.log(chalk.gray('  git push -u origin ' + (status.branch || 'main') + ' 로 설정하세요.'));
+                break;
+            case 'up-to-date':
+                printSuccess('이미 최신 상태입니다.');
+                await notifyServerCache();
+                break;
+            case 'behind':
+                await performGitPull(status);
+                break;
+            case 'ahead':
+                await performGitPush(status);
+                break;
+            case 'diverged':
+                printDivergedWarning(status);
+                break;
+        }
     }
-    // 프로젝트 연결 확인
-    if (!isConnected()) {
-        printError('웹 플랫폼에 연결되지 않았습니다.');
-        console.log(chalk.gray('먼저 연결하세요: aiag connect <project-url>'));
+    catch (error) {
+        spinner.stop();
+        if (error instanceof Error) {
+            printError(`Git 동기화 실패: ${error.message}`);
+        }
+        else {
+            printError('Git 동기화 중 오류가 발생했습니다.');
+        }
         process.exitCode = 1;
-        return false;
     }
-    return true;
 }
 // ============================================
-// Push 동기화 (로컬 → 서버)
+// Reset 처리 (GitHub 상태로 초기화)
 // ============================================
 /**
- * 로컬 → 서버 동기화
+ * GitHub 상태로 로컬 초기화 (--reset)
  */
-async function handlePushSync(options) {
-    const connection = loadConnection();
-    const featureList = readFeatureList();
-    if (!featureList) {
-        printError('feature_list.json을 읽을 수 없습니다.');
+async function handleReset() {
+    if (!isProjectInitialized()) {
+        printError(messages.common.notInitialized);
+        console.log(chalk.gray(messages.common.runInitFirst));
         process.exitCode = 1;
         return;
     }
-    const spinner = ora('동기화 준비 중...').start();
+    const spinner = ora('GitHub 상태 확인 중...').start();
     try {
-        const client = getApiClient();
-        if (!client) {
-            spinner.fail();
-            printError('API 클라이언트를 초기화할 수 없습니다.');
+        // Git fetch로 원격 상태 동기화
+        await gitFetch();
+        const status = await getRemoteSyncStatus();
+        if (status.status === 'no-remote') {
+            spinner.fail('원격 저장소가 설정되지 않았습니다.');
             process.exitCode = 1;
             return;
         }
-        // 로컬 Feature를 동기화 데이터로 변환
-        const syncData = featureList.features.map(localToSyncFeature);
-        if (options.dryRun) {
-            spinner.stop();
-            printDryRunResult(syncData);
+        if (status.status === 'no-upstream') {
+            spinner.fail('원격 브랜치 트래킹이 설정되지 않았습니다.');
+            process.exitCode = 1;
             return;
         }
-        spinner.text = `${syncData.length}개 Feature 동기화 중...`;
-        // 서버에 동기화 요청
-        const response = await client.syncFeatures(connection.projectId, {
-            features: syncData,
-            forceOverwrite: options.force,
-        });
-        spinner.succeed('동기화 완료');
-        // 결과 출력
-        printSyncResult(response, 'push');
-        // 충돌 처리
-        if (response.conflicts.length > 0 && !options.force) {
-            printConflicts(response.conflicts);
+        const branch = status.branch || 'main';
+        spinner.text = `GitHub 상태로 초기화 중... (origin/${branch})`;
+        // git reset --hard origin/{branch}
+        const result = await gitResetHard(`origin/${branch}`);
+        if (result.success) {
+            spinner.succeed(`GitHub 상태로 초기화 완료 (origin/${branch})`);
+            await notifyServerCache();
         }
-        // 서버 Feature로 로컬 업데이트 (서버에서 생성된 ID 등 반영)
-        if (response.serverFeatures.length > 0) {
-            updateLocalFromServer(featureList, response.serverFeatures);
-        }
-        // Progress.md 동기화
-        await syncProgressToServer(client, connection.projectId, spinner);
-        // 마지막 동기화 시간 업데이트
-        updateLastSyncAt();
-        // 미동기화 항목 정리
-        clearPendingSync();
-    }
-    catch (error) {
-        spinner.fail();
-        handleSyncError(error);
-    }
-}
-// ============================================
-// Pull 동기화 (서버 → 로컬)
-// ============================================
-/**
- * 서버 → 로컬 동기화
- */
-async function handlePullSync(options) {
-    const connection = loadConnection();
-    const localFeatureList = readFeatureList();
-    const spinner = ora('서버에서 데이터 가져오는 중...').start();
-    try {
-        const client = getApiClient();
-        if (!client) {
-            spinner.fail();
-            printError('API 클라이언트를 초기화할 수 없습니다.');
+        else {
+            spinner.fail('초기화 실패');
+            if (result.stderr) {
+                printError(result.stderr);
+            }
             process.exitCode = 1;
-            return;
         }
-        // 서버에서 프로젝트 컨텍스트 조회
-        const context = await client.getProjectContext(connection.projectId);
-        const serverFeatures = context.features;
-        if (options.dryRun) {
-            spinner.stop();
-            printPullDryRunResult(serverFeatures, localFeatureList);
-            return;
-        }
-        spinner.text = `${serverFeatures.length}개 Feature 동기화 중...`;
-        // 서버 Feature를 로컬 형식으로 변환
-        const localFeatures = serverFeatures.map(serverToLocalFeature);
-        // 로컬 feature_list.json 업데이트
-        const updatedFeatureList = {
-            project: localFeatureList?.project ?? {
-                name: context.project.name,
-                version: '1.0.0',
-                description: context.project.description ?? '',
-                totalFeatures: serverFeatures.length,
-                completedFeatures: serverFeatures.filter(f => f.passes).length,
-            },
-            features: localFeatures,
-        };
-        // 프로젝트 정보 업데이트
-        updatedFeatureList.project.totalFeatures = localFeatures.length;
-        updatedFeatureList.project.completedFeatures = localFeatures.filter(f => f.passes).length;
-        writeFeatureList(updatedFeatureList);
-        spinner.succeed('동기화 완료');
-        // 결과 출력
-        console.log('');
-        console.log(`  ${chalk.green('가져옴:')} ${serverFeatures.length}개 Feature`);
-        console.log(`  ${chalk.blue('완료:')} ${updatedFeatureList.project.completedFeatures}개`);
-        console.log(`  ${chalk.gray('대기:')} ${updatedFeatureList.project.totalFeatures - updatedFeatureList.project.completedFeatures}개`);
-        // 마지막 동기화 시간 업데이트
-        updateLastSyncAt();
-        clearPendingSync();
     }
     catch (error) {
-        spinner.fail();
-        handleSyncError(error);
+        spinner.fail('초기화 중 오류 발생');
+        if (error instanceof Error) {
+            printError(error.message);
+        }
+        process.exitCode = 1;
     }
 }
 // ============================================
 // 동기화 상태 확인
 // ============================================
 /**
- * 동기화 상태 표시
+ * 동기화 상태 표시 (--status)
  */
 async function handleSyncStatus() {
     if (!isProjectInitialized()) {
         printInfo('프로젝트가 초기화되지 않았습니다.');
         return;
     }
-    const connection = loadConnection();
-    const pendingCount = getPendingSyncCount();
-    const pendingItems = loadPendingSync();
     console.log('');
-    console.log(chalk.bold('동기화 상태'));
+    console.log(chalk.bold('📊 동기화 상태'));
     console.log('');
-    if (!connection) {
-        console.log(`  ${chalk.yellow('⚠')} 웹 플랫폼에 연결되지 않음`);
-        console.log(chalk.gray('  연결하려면: aiag connect <project-url>'));
-        return;
+    // Git 상태 확인
+    const spinner = ora('Git 상태 확인 중...').start();
+    try {
+        await gitFetch();
+        const status = await getRemoteSyncStatus();
+        spinner.stop();
+        printGitSyncStatus(status);
+        printStatusSummary(status);
     }
-    // 연결 정보
-    console.log(`  프로젝트: ${chalk.cyan(connection.projectName)}`);
-    console.log(`  서버: ${chalk.gray(connection.serverUrl)}`);
-    console.log(`  마지막 동기화: ${chalk.gray(formatDate(connection.lastSyncAt))}`);
-    // 미동기화 항목
-    console.log('');
-    if (pendingCount > 0) {
-        console.log(`  ${chalk.yellow('⚠')} 미동기화 항목: ${chalk.yellow(pendingCount)}개`);
-        console.log('');
-        for (const item of pendingItems.slice(0, 5)) {
-            const actionIcon = item.action === 'create' ? '+' : item.action === 'update' ? '~' : '✓';
-            const actionColor = item.action === 'create' ? chalk.green : item.action === 'update' ? chalk.yellow : chalk.blue;
-            console.log(`    ${actionColor(actionIcon)} ${item.featureId} (${item.action})`);
-        }
-        if (pendingItems.length > 5) {
-            console.log(chalk.gray(`    ... 외 ${pendingItems.length - 5}개`));
+    catch (error) {
+        spinner.stop();
+        printWarning('Git 상태 확인 실패');
+        if (error instanceof Error) {
+            console.log(chalk.gray(`  ${error.message}`));
         }
-        console.log('');
-        console.log(chalk.gray('  동기화하려면: aiag sync'));
     }
-    else {
-        console.log(`  ${chalk.green('✓')} 모든 변경사항이 동기화됨`);
+    // 서버 연결 상태
+    const connection = loadConnection();
+    console.log('');
+    console.log(chalk.bold('🔗 서버 연결'));
+    if (connection && isConnected()) {
+        console.log(`  프로젝트: ${chalk.cyan(connection.projectName)}`);
+        console.log(`  서버: ${chalk.gray(connection.serverUrl)}`);
+        console.log(`  마지막 동기화: ${chalk.gray(formatDate(connection.lastSyncAt))}`);
     }
-    // 서버 연결 상태 확인
-    if (isLoggedIn()) {
-        const spinner = ora('서버 상태 확인 중...').start();
-        try {
-            const client = getApiClient();
-            if (client) {
-                const context = await client.getProjectContext(connection.projectId);
-                spinner.stop();
-                console.log('');
-                console.log(chalk.bold('서버 상태'));
-                console.log(`  총 Feature: ${chalk.yellow(context.stats.totalFeatures)}개`);
-                console.log(`  완료: ${chalk.green(context.stats.completedFeatures)}개`);
-                console.log(`  진행률: ${chalk.cyan(context.stats.completionRate.toFixed(1))}%`);
-            }
-            else {
-                spinner.warn('서버 연결 필요');
-            }
-        }
-        catch {
-            spinner.warn('서버 상태 확인 실패');
-        }
+    else {
+        console.log(chalk.gray('  연결되지 않음'));
+        console.log(chalk.gray('  연결하려면: aiag connect'));
     }
     console.log('');
 }
@@ -284,32 +209,40 @@ async function handleSyncStatus() {
 // 실시간 이벤트 스트리밍
 // ============================================
 /**
- * 실시간 이벤트 스트리밍 (watch 모드)
+ * 실시간 이벤트 스트리밍 (--watch)
  */
 async function handleWatch() {
-    if (!checkPrerequisites()) {
+    // 사전 조건 확인
+    if (!isProjectInitialized()) {
+        printError(messages.common.notInitialized);
+        process.exitCode = 1;
         return;
     }
-    const connection = loadConnection();
-    const client = getApiClient();
-    if (!client) {
-        printError('API 클라이언트를 초기화할 수 없습니다.');
+    if (!isLoggedIn()) {
+        printError(messages.login.serverRequired);
+        console.log(chalk.gray('먼저 로그인하세요: aiag login'));
         process.exitCode = 1;
         return;
     }
-    console.log('');
-    console.log(chalk.bold('실시간 이벤트 스트리밍'));
-    console.log(chalk.gray(`프로젝트: ${connection.projectName}`));
-    console.log(chalk.gray('종료하려면 Ctrl+C를 누르세요.'));
-    console.log('');
-    // SSE 클라이언트 생성
-    const { loadCredentials } = await import('../auth/credentials.js');
+    if (!isConnected()) {
+        printError('웹 플랫폼에 연결되지 않았습니다.');
+        console.log(chalk.gray('먼저 연결하세요: aiag connect'));
+        process.exitCode = 1;
+        return;
+    }
+    const connection = loadConnection();
     const credentials = loadCredentials();
     if (!credentials) {
         printError('인증 정보를 찾을 수 없습니다.');
         process.exitCode = 1;
         return;
     }
+    console.log('');
+    console.log(chalk.bold('📡 실시간 이벤트 스트리밍'));
+    console.log(chalk.gray(`프로젝트: ${connection.projectName}`));
+    console.log(chalk.gray('종료하려면 Ctrl+C를 누르세요.'));
+    console.log('');
+    // SSE 클라이언트 설정
     const sseClient = new SSEClient({
         serverUrl: connection.serverUrl,
         projectId: connection.projectId,
@@ -330,35 +263,23 @@ async function handleWatch() {
         console.log(chalk.red(`✗ 에러: ${error.message}`));
     });
     // Feature 이벤트
-    sseClient.on('feature_claimed', (event) => {
-        console.log(formatSSEEvent(event));
-    });
-    sseClient.on('feature_progress', (event) => {
-        console.log(formatSSEEvent(event));
-    });
-    sseClient.on('feature_completed', (event) => {
-        console.log(chalk.green(formatSSEEvent(event)));
-    });
-    sseClient.on('feature_failed', (event) => {
-        console.log(chalk.red(formatSSEEvent(event)));
-    });
+    sseClient.on('feature_claimed', (event) => console.log(formatSSEEvent(event)));
+    sseClient.on('feature_progress', (event) => console.log(formatSSEEvent(event)));
+    sseClient.on('feature_completed', (event) => console.log(chalk.green(formatSSEEvent(event))));
+    sseClient.on('feature_failed', (event) => console.log(chalk.red(formatSSEEvent(event))));
     // 세션 이벤트
-    sseClient.on('session_started', (event) => {
-        console.log(chalk.blue(formatSSEEvent(event)));
-    });
-    sseClient.on('session_ended', (event) => {
-        console.log(chalk.blue(formatSSEEvent(event)));
-    });
+    sseClient.on('session_started', (event) => console.log(chalk.blue(formatSSEEvent(event))));
+    sseClient.on('session_ended', (event) => console.log(chalk.blue(formatSSEEvent(event))));
     // 로그 이벤트
+    const levelColors = {
+        info: chalk.blue,
+        warn: chalk.yellow,
+        error: chalk.red,
+        debug: chalk.gray,
+    };
     sseClient.on('log', (event) => {
-        const levelColorMap = {
-            info: chalk.blue,
-            warn: chalk.yellow,
-            error: chalk.red,
-            debug: chalk.gray,
-        };
-        const levelColor = levelColorMap[event.level] ?? chalk.white;
-        console.log(levelColor(formatSSEEvent(event)));
+        const color = levelColors[event.level] ?? chalk.white;
+        console.log(color(formatSSEEvent(event)));
     });
     // Ctrl+C 핸들링
     process.on('SIGINT', () => {
@@ -377,177 +298,158 @@ async function handleWatch() {
     }
 }
 // ============================================
-// 데이터 변환 함수
+// Git 작업 실행
 // ============================================
 /**
- * 로컬 Feature를 동기화 데이터로 변환
- */
-function localToSyncFeature(feature) {
-    return {
-        localId: feature.id,
-        category: feature.category,
-        priority: feature.priority,
-        description: feature.description,
-        acceptanceCriteria: feature.acceptanceCriteria,
-        testCommand: feature.testCommand,
-        passes: feature.passes,
-        lastTestedAt: feature.lastTestedAt ?? undefined,
-        implementedBy: feature.implementedBy ?? undefined,
-        notes: feature.notes,
-        dependsOn: feature.dependsOn,
-    };
-}
-/**
- * 서버 Feature를 로컬 형식으로 변환
+ * Git pull 자동 실행
  */
-function serverToLocalFeature(serverFeature) {
-    return {
-        id: serverFeature.localId,
-        category: serverFeature.category,
-        priority: serverFeature.priority,
-        description: serverFeature.description,
-        acceptanceCriteria: serverFeature.acceptanceCriteria,
-        testCommand: serverFeature.testCommand,
-        passes: serverFeature.passes,
-        lastTestedAt: serverFeature.lastTestedAt ?? null,
-        implementedBy: serverFeature.implementedBy ?? null,
-        notes: serverFeature.notes,
-        dependsOn: serverFeature.dependsOn,
-    };
+async function performGitPull(status) {
+    console.log(chalk.yellow(`  ⬇️  원격에 ${status.behind}개의 새 커밋이 있습니다.`));
+    // 커밋 목록 표시 (최대 5개)
+    for (const commit of status.behindCommits.slice(0, 5)) {
+        console.log(chalk.gray(`     - ${commit}`));
+    }
+    if (status.behind > 5) {
+        console.log(chalk.gray(`     ... 외 ${status.behind - 5}개`));
+    }
+    console.log('');
+    const spinner = ora('git pull 실행 중...').start();
+    const result = await gitPull();
+    if (result.success) {
+        spinner.succeed('git pull 완료');
+        await notifyServerCache();
+    }
+    else {
+        spinner.fail('git pull 실패');
+        if (result.stderr) {
+            printError(result.stderr);
+            if (result.stderr.includes('conflict')) {
+                printWarning('충돌이 발생했습니다. 수동으로 해결해주세요.');
+            }
+        }
+        process.exitCode = 1;
+    }
 }
 /**
- * 서버 응답으로 로컬 Feature 업데이트
+ * Git push 자동 실행
  */
-function updateLocalFromServer(localList, serverFeatures) {
-    const serverMap = new Map(serverFeatures.map(f => [f.localId, f]));
-    for (const localFeature of localList.features) {
-        const serverFeature = serverMap.get(localFeature.id);
-        if (serverFeature) {
-            // 서버에서 업데이트된 정보 반영 (passes, lastTestedAt 등)
-            localFeature.passes = serverFeature.passes;
-            if (serverFeature.lastTestedAt) {
-                localFeature.lastTestedAt = serverFeature.lastTestedAt;
-            }
+async function performGitPush(status) {
+    console.log(chalk.yellow(`  ⬆️  로컬에 ${status.ahead}개의 커밋이 있습니다.`));
+    // 커밋 목록 표시 (최대 5개)
+    for (const commit of status.aheadCommits.slice(0, 5)) {
+        console.log(chalk.gray(`     - ${commit}`));
+    }
+    if (status.ahead > 5) {
+        console.log(chalk.gray(`     ... 외 ${status.ahead - 5}개`));
+    }
+    console.log('');
+    const spinner = ora('git push 실행 중...').start();
+    const result = await gitPush();
+    if (result.success) {
+        spinner.succeed('git push 완료');
+        await notifyServerCache();
+    }
+    else {
+        spinner.fail('git push 실패');
+        if (result.error) {
+            printError(result.error);
         }
+        process.exitCode = 1;
     }
-    writeFeatureList(localList);
 }
 // ============================================
-// 결과 출력 함수
+// 서버 캐시 알림 (선택적)
 // ============================================
 /**
- * 동기화 결과 출력
+ * 서버에 동기화 완료 알림 (서버 캐시 갱신 트리거)
+ * GitHub Webhook이 처리하므로 필수는 아님
  */
-function printSyncResult(response, direction) {
-    console.log('');
-    const directionText = direction === 'push' ? '서버에 반영' : '로컬에 반영';
-    if (response.synced > 0) {
-        console.log(`  ${chalk.green('✓')} ${response.synced}개 Feature ${directionText}`);
-    }
-    if (response.created > 0) {
-        console.log(`  ${chalk.blue('+')} ${response.created}개 생성됨`);
-    }
-    if (response.updated > 0) {
-        console.log(`  ${chalk.yellow('~')} ${response.updated}개 업데이트됨`);
-    }
-    if (response.conflicts.length > 0) {
-        console.log(`  ${chalk.red('!')} ${response.conflicts.length}개 충돌`);
+async function notifyServerCache() {
+    // 서버 연결이 되어 있으면 마지막 동기화 시간 업데이트
+    if (isConnected() && isLoggedIn()) {
+        try {
+            updateLastSyncAt();
+            // 선택적: 서버에 동기화 요청 (GitHub Webhook이 이미 처리하므로 불필요할 수 있음)
+            // 하지만 연결 상태 확인 및 프로젝트 존재 확인에 유용
+            const connection = loadConnection();
+            const client = getApiClient();
+            if (connection && client) {
+                // 간단한 health check 수준
+                await client.getProject(connection.projectId).catch(() => {
+                    // 무시 (서버 연결 안 되어도 Git 동기화는 성공)
+                });
+            }
+        }
+        catch {
+            // 서버 알림 실패해도 Git 동기화는 성공으로 처리
+        }
     }
-    console.log('');
 }
+// ============================================
+// 출력 유틸리티
+// ============================================
 /**
- * 충돌 정보 출력
+ * Git 동기화 상태 출력
  */
-function printConflicts(conflicts) {
-    console.log(chalk.yellow('충돌이 발생했습니다:'));
+function printGitSyncStatus(status) {
     console.log('');
-    for (const conflict of conflicts.slice(0, 5)) {
-        console.log(`  ${chalk.yellow('!')} ${conflict.featureId}.${conflict.field}`);
-        console.log(`    로컬: ${chalk.gray(String(conflict.localValue))}`);
-        console.log(`    서버: ${chalk.gray(String(conflict.serverValue))}`);
-    }
-    if (conflicts.length > 5) {
-        console.log(chalk.gray(`  ... 외 ${conflicts.length - 5}개 충돌`));
+    console.log(chalk.bold('🔄 Git 상태'));
+    if (!status.hasRemote) {
+        console.log(chalk.gray('  원격 저장소 없음'));
+        return;
     }
-    console.log('');
-    console.log(chalk.gray('충돌 해결 옵션:'));
-    console.log(chalk.gray('  --force: 로컬 변경사항으로 덮어쓰기'));
-    console.log(chalk.gray('  --pull: 서버 상태로 덮어쓰기'));
+    console.log(chalk.gray(`  브랜치: ${status.branch || 'unknown'}`));
+    console.log(chalk.gray(`  로컬:   ${status.localCommit?.slice(0, 7) || 'N/A'}`));
+    console.log(chalk.gray(`  원격:   ${status.remoteCommit?.slice(0, 7) || 'N/A'}`));
     console.log('');
 }
 /**
- * Dry-run 결과 출력 (push)
+ * 상태 요약 출력
  */
-function printDryRunResult(syncData) {
-    console.log('');
-    console.log(chalk.bold('[Dry Run] 동기화 예정 항목:'));
-    console.log('');
-    const completed = syncData.filter(f => f.passes);
-    const pending = syncData.filter(f => !f.passes);
-    console.log(`  총 Feature: ${syncData.length}개`);
-    console.log(`  ${chalk.green('완료:')} ${completed.length}개`);
-    console.log(`  ${chalk.gray('대기:')} ${pending.length}개`);
-    console.log('');
-    if (syncData.length <= 10) {
-        for (const feature of syncData) {
-            const icon = feature.passes ? chalk.green('✓') : chalk.gray('○');
-            console.log(`  ${icon} ${feature.localId}: ${feature.description.slice(0, 50)}...`);
-        }
+function printStatusSummary(status) {
+    switch (status.status) {
+        case 'up-to-date':
+            console.log(chalk.green('  ✓ 최신 상태'));
+            break;
+        case 'behind':
+            console.log(chalk.yellow(`  ⬇️ 원격에 ${status.behind}개 커밋 뒤처짐`));
+            console.log(chalk.gray('     aiag sync 로 pull 하세요.'));
+            break;
+        case 'ahead':
+            console.log(chalk.yellow(`  ⬆️ 로컬에 ${status.ahead}개 커밋 앞섬`));
+            console.log(chalk.gray('     aiag sync 로 push 하세요.'));
+            break;
+        case 'diverged':
+            console.log(chalk.red(`  ⚠️ 로컬과 원격이 분기됨`));
+            console.log(chalk.gray(`     로컬 +${status.ahead}, 원격 +${status.behind}`));
+            console.log(chalk.gray('     aiag sync --reset 으로 GitHub 상태로 초기화하세요.'));
+            break;
+        case 'no-remote':
+            console.log(chalk.gray('  원격 저장소가 설정되지 않음'));
+            break;
+        case 'no-upstream':
+            console.log(chalk.gray('  원격 브랜치 트래킹이 설정되지 않음'));
+            break;
     }
-    console.log('');
-    console.log(chalk.gray('실제 동기화하려면 --dry-run 옵션을 제거하세요.'));
-    console.log('');
 }
 /**
- * Dry-run 결과 출력 (pull)
+ * 분기 경고 출력
  */
-function printPullDryRunResult(serverFeatures, localList) {
+function printDivergedWarning(status) {
+    console.log(chalk.red('  ⚠️  로컬과 원격이 분기되었습니다:'));
+    console.log(chalk.yellow(`     - 로컬에 ${status.ahead}개 커밋 (푸시 안 됨)`));
+    console.log(chalk.yellow(`     - 원격에 ${status.behind}개 커밋 (E2B 등에서 생성)`));
     console.log('');
-    console.log(chalk.bold('[Dry Run] 서버에서 가져올 항목:'));
+    console.log(chalk.cyan('  💡 해결 방법:'));
     console.log('');
-    const localCount = localList?.features.length ?? 0;
-    console.log(`  서버 Feature: ${serverFeatures.length}개`);
-    console.log(`  로컬 Feature: ${localCount}개`);
-    if (serverFeatures.length !== localCount) {
-        console.log(`  ${chalk.yellow('변경:')} ${Math.abs(serverFeatures.length - localCount)}개 차이`);
-    }
+    console.log(chalk.gray('  1. GitHub 상태로 초기화 (로컬 변경 삭제):'));
+    console.log(chalk.white('     aiag sync --reset'));
     console.log('');
-    console.log(chalk.gray('실제 동기화하려면 --dry-run 옵션을 제거하세요.'));
+    console.log(chalk.gray('  2. 수동으로 rebase 후 push:'));
+    console.log(chalk.white('     git pull --rebase origin ' + (status.branch || 'main')));
+    console.log(chalk.white('     git push'));
     console.log('');
 }
-// ============================================
-// 에러 처리
-// ============================================
-/**
- * 동기화 에러 처리
- */
-function handleSyncError(error) {
-    if (error instanceof ApiError) {
-        if (error.code === 'NOT_FOUND' || error.status === 404) {
-            printError('프로젝트를 찾을 수 없습니다. 연결을 다시 확인하세요.');
-        }
-        else if (error.status === 403) {
-            printError('이 프로젝트에 대한 동기화 권한이 없습니다.');
-        }
-        else if (error.code === 'CONFLICT') {
-            printError('동기화 충돌이 발생했습니다. --force 옵션을 사용하거나 수동으로 해결하세요.');
-        }
-        else {
-            printError(`동기화 실패: ${error.message}`);
-        }
-    }
-    else if (error instanceof NetworkError) {
-        printError(`네트워크 오류: ${error.message}`);
-        printInfo('오프라인 상태에서 변경한 내용은 나중에 동기화됩니다.');
-    }
-    else {
-        printError(`알 수 없는 오류: ${error instanceof Error ? error.message : String(error)}`);
-    }
-    process.exitCode = 1;
-}
-// ============================================
-// 유틸리티 함수
-// ============================================
 /**
  * 날짜 포맷팅
  */
@@ -562,7 +464,7 @@ function formatDate(isoString) {
     });
 }
 // ============================================
-// Progress.md 동기화
+// Progress.md 동기화 (서버 모니터링용)
 // ============================================
 /**
  * Progress.md를 서버에 동기화
@@ -651,171 +553,5 @@ function truncateProgressContent(content, maxSize) {
     }
     return result;
 }
-// ============================================
-// Git 동기화 처리
-// ============================================
-/**
- * Git 원격 저장소 동기화 상태 확인 및 처리
- * @returns true면 계속 진행, false면 중단
- */
-async function handleGitSync(options) {
-    const spinner = ora('Git 상태 확인 중...').start();
-    try {
-        const status = await getRemoteSyncStatus();
-        spinner.stop();
-        // 출력
-        printGitSyncStatus(status);
-        // 상태별 처리
-        const shouldAutoPull = options.autoPull || options.autoGit;
-        const shouldAutoPush = options.autoPush || options.autoGit;
-        switch (status.status) {
-            case 'no-remote':
-                printInfo('원격 저장소가 설정되지 않았습니다. Feature 동기화만 진행합니다.');
-                return true;
-            case 'no-upstream':
-                printInfo('원격 브랜치 트래킹이 설정되지 않았습니다. Feature 동기화만 진행합니다.');
-                return true;
-            case 'up-to-date':
-                console.log(chalk.green('  ✓ Git 저장소가 최신 상태입니다.\n'));
-                return true;
-            case 'behind':
-                // 원격에 새 커밋이 있음 → pull 권장
-                if (shouldAutoPull) {
-                    return await performGitPull();
-                }
-                else {
-                    printGitPullSuggestion(status);
-                    return true; // Feature 동기화는 계속 진행
-                }
-            case 'ahead':
-                // 로컬에 푸시되지 않은 커밋이 있음 → push 권장
-                if (shouldAutoPush) {
-                    return await performGitPush();
-                }
-                else {
-                    printGitPushSuggestion(status);
-                    return true; // Feature 동기화는 계속 진행
-                }
-            case 'diverged':
-                // 로컬과 원격이 분기됨 → 수동 해결 필요
-                printGitDivergedWarning(status);
-                return true; // Feature 동기화는 계속 진행 (경고만)
-            default:
-                return true;
-        }
-    }
-    catch (error) {
-        spinner.stop();
-        if (error instanceof Error) {
-            printWarning(`Git 상태 확인 실패: ${error.message}`);
-        }
-        // Git 확인 실패해도 Feature 동기화는 계속
-        return true;
-    }
-}
-/**
- * Git 동기화 상태 출력
- */
-function printGitSyncStatus(status) {
-    console.log();
-    console.log(chalk.bold('📊 Git 동기화 상태'));
-    if (!status.hasRemote) {
-        console.log(chalk.gray('  원격 저장소 없음'));
-        return;
-    }
-    console.log(chalk.gray(`  브랜치: ${status.branch || 'unknown'}`));
-    console.log(chalk.gray(`  로컬:   ${status.localCommit || 'N/A'}`));
-    console.log(chalk.gray(`  원격:   ${status.remoteCommit || 'N/A'}`));
-    console.log();
-}
-/**
- * Git pull 제안 출력
- */
-function printGitPullSuggestion(status) {
-    console.log(chalk.yellow(`  ⬇️  원격에 ${status.behind}개의 새 커밋이 있습니다:`));
-    // 최대 5개만 표시
-    const commits = status.behindCommits.slice(0, 5);
-    for (const commit of commits) {
-        console.log(chalk.gray(`     - ${commit}`));
-    }
-    if (status.behind > 5) {
-        console.log(chalk.gray(`     ... 외 ${status.behind - 5}개`));
-    }
-    console.log();
-    console.log(chalk.cyan('  💡 권장: git pull 실행'));
-    console.log(chalk.gray('     또는: aiag sync --auto-pull'));
-    console.log();
-}
-/**
- * Git push 제안 출력
- */
-function printGitPushSuggestion(status) {
-    console.log(chalk.yellow(`  ⬆️  로컬에 ${status.ahead}개의 푸시되지 않은 커밋이 있습니다:`));
-    // 최대 5개만 표시
-    const commits = status.aheadCommits.slice(0, 5);
-    for (const commit of commits) {
-        console.log(chalk.gray(`     - ${commit}`));
-    }
-    if (status.ahead > 5) {
-        console.log(chalk.gray(`     ... 외 ${status.ahead - 5}개`));
-    }
-    console.log();
-    console.log(chalk.cyan('  💡 권장: git push 실행'));
-    console.log(chalk.gray('     또는: aiag sync --auto-push'));
-    console.log();
-}
-/**
- * Git 분기 경고 출력
- */
-function printGitDivergedWarning(status) {
-    console.log(chalk.red('  ⚠️  로컬과 원격이 분기되었습니다:'));
-    console.log(chalk.yellow(`     - 로컬에 ${status.ahead}개 커밋 (푸시 안 됨)`));
-    console.log(chalk.yellow(`     - 원격에 ${status.behind}개 커밋 (E2B 등에서 생성)`));
-    console.log();
-    console.log(chalk.cyan('  💡 권장 조치:'));
-    console.log(chalk.gray('     1. git pull --rebase origin ' + (status.branch || 'main')));
-    console.log(chalk.gray('     2. git push'));
-    console.log();
-    console.log(chalk.gray('  또는 로컬 변경 무시:'));
-    console.log(chalk.gray('     git reset --hard origin/' + (status.branch || 'main')));
-    console.log();
-}
-/**
- * Git pull 자동 실행
- */
-async function performGitPull() {
-    const spinner = ora('git pull 실행 중...').start();
-    const result = await gitPull();
-    if (result.success) {
-        spinner.succeed('git pull 완료');
-        return true;
-    }
-    else {
-        spinner.fail('git pull 실패');
-        printError(result.stderr || 'pull 실패');
-        if (result.stderr?.includes('conflict')) {
-            printWarning('충돌이 발생했습니다. 수동으로 해결해주세요.');
-        }
-        return true; // Feature 동기화는 계속 진행
-    }
-}
-/**
- * Git push 자동 실행
- */
-async function performGitPush() {
-    const spinner = ora('git push 실행 중...').start();
-    const result = await gitPush();
-    if (result.success) {
-        spinner.succeed('git push 완료');
-        return true;
-    }
-    else {
-        spinner.fail('git push 실패');
-        if (result.error) {
-            printError(result.error);
-        }
-        return true; // Feature 동기화는 계속 진행
-    }
-}
 export default sync;
 //# sourceMappingURL=sync.js.map