aiag-cli 2.2.3 → 2.4.0

package/dist/commands/prd.js

@@ -0,0 +1,179 @@
+/**
+ * aiag prd 명령어
+ *
+ * prd-taskmaster 스킬을 사용하여 PRD를 생성합니다.
+ * --from 옵션으로 기존 요구사항 문서를 Taskmaster PRD로 변환할 수 있습니다.
+ */
+import { spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+import chalk from 'chalk';
+import ora from 'ora';
+import { skillExists } from '../skills/loader.js';
+import { installSkillIfNeeded } from '../skills/installer.js';
+import { runPrdSkill } from '../skills/runner.js';
+import { printHeader, printSuccess, printError, printWarning, printInfo } from '../utils/output.js';
+import { getPrdInfo } from '../utils/prd.js';
+/**
+ * TaskMaster 설치 확인
+ */
+async function checkTaskMasterInstalled() {
+    return new Promise((resolve) => {
+        // CLI 버전 확인
+        const child = spawn('taskmaster', ['--version'], {
+            stdio: 'pipe',
+            shell: true,
+        });
+        child.on('close', (code) => {
+            resolve(code === 0);
+        });
+        child.on('error', () => {
+            resolve(false);
+        });
+        // 타임아웃
+        setTimeout(() => {
+            child.kill();
+            resolve(false);
+        }, 5000);
+    });
+}
+/**
+ * PRD 생성 명령어
+ */
+export async function prd(options = {}) {
+    const baseDir = process.cwd();
+    const outputPath = options.output || '.taskmaster/docs/prd.md';
+    const template = options.template || 'comprehensive';
+    const fromPath = options.from;
+    // 모드 결정: 변환 모드 vs 대화형 모드
+    const isConversionMode = !!fromPath;
+    printHeader(isConversionMode ? 'AIAG PRD Converter' : 'AIAG PRD Generator');
+    console.log();
+    // 1. --from 옵션: 기존 문서 로딩
+    let existingDocContent;
+    let existingDocPath;
+    if (isConversionMode) {
+        const fullFromPath = path.isAbsolute(fromPath) ? fromPath : path.join(baseDir, fromPath);
+        if (!fs.existsSync(fullFromPath)) {
+            printError(`파일을 찾을 수 없습니다: ${fromPath}`);
+            process.exit(1);
+        }
+        const docInfo = getPrdInfo(fullFromPath);
+        printInfo(`기존 문서 로드: ${docInfo.relativePath} (${docInfo.sizeKB} KB)`);
+        existingDocContent = fs.readFileSync(fullFromPath, 'utf-8');
+        existingDocPath = fromPath;
+        if (existingDocContent.length < 100) {
+            printWarning('문서 내용이 매우 짧습니다. 충분한 정보가 포함되어 있는지 확인하세요.');
+        }
+        console.log();
+    }
+    // 2. TaskMaster 확인 (필수)
+    const spinner = ora('TaskMaster 확인 중...').start();
+    const taskMasterInstalled = await checkTaskMasterInstalled();
+    if (!taskMasterInstalled) {
+        spinner.fail('TaskMaster가 설치되어 있지 않습니다.');
+        console.log();
+        printError('TaskMaster는 필수 의존성입니다.');
+        console.log();
+        printInfo('설치 방법:');
+        console.log(chalk.gray('  npm install -g task-master-ai'));
+        console.log(chalk.gray('  또는 Claude Code MCP 설정에 TaskMaster 추가'));
+        console.log();
+        process.exit(1);
+    }
+    spinner.succeed('TaskMaster 설치 확인됨');
+    // 3. prd-taskmaster 스킬 확인 및 설치
+    spinner.start('prd-taskmaster 스킬 확인 중...');
+    if (!skillExists('prd-taskmaster')) {
+        spinner.text = 'prd-taskmaster 스킬 설치 중...';
+        const installResult = installSkillIfNeeded('prd-taskmaster');
+        if (installResult.status === 'failed') {
+            spinner.fail('스킬 설치 실패');
+            printError(installResult.error || '알 수 없는 오류');
+            process.exit(1);
+        }
+        spinner.succeed('prd-taskmaster 스킬 설치됨');
+    }
+    else {
+        spinner.succeed('prd-taskmaster 스킬 확인됨');
+    }
+    // 4. 기존 PRD 확인
+    const fullOutputPath = path.join(baseDir, outputPath);
+    if (fs.existsSync(fullOutputPath)) {
+        console.log();
+        printWarning(`기존 PRD 발견: ${outputPath}`);
+        printInfo('새 PRD 생성 시 기존 파일이 백업됩니다.');
+        console.log();
+    }
+    // 5. Dry run 모드
+    if (options.dryRun) {
+        console.log();
+        printInfo('[DRY RUN] PRD 생성 시뮬레이션');
+        console.log(chalk.gray(`  모드: ${isConversionMode ? '변환 모드' : '대화형 모드'}`));
+        if (isConversionMode) {
+            console.log(chalk.gray(`  소스 문서: ${fromPath}`));
+        }
+        console.log(chalk.gray(`  출력 경로: ${outputPath}`));
+        console.log(chalk.gray(`  템플릿: ${template}`));
+        console.log(chalk.gray(`  작업 디렉토리: ${baseDir}`));
+        return;
+    }
+    // 6. PRD 생성 실행
+    console.log();
+    if (isConversionMode) {
+        printInfo('PRD 변환을 시작합니다...');
+        printInfo('기존 문서를 분석하고, 누락된 정보가 있으면 질문합니다.');
+    }
+    else {
+        printInfo('PRD 생성을 시작합니다...');
+        printInfo('prd-taskmaster 스킬의 질문에 답변해주세요.');
+    }
+    console.log();
+    const result = await runPrdSkill({
+        workingDirectory: baseDir,
+        template,
+        verbose: options.verbose,
+        existingDocContent,
+        existingDocPath,
+        onProgress: (message) => {
+            if (options.verbose) {
+                console.log(chalk.gray(`[진행] ${message}`));
+            }
+        },
+    });
+    console.log();
+    // 7. 결과 처리
+    if (result.success) {
+        printSuccess(isConversionMode ? 'PRD 변환 완료!' : 'PRD 생성 완료!');
+        console.log();
+        if (result.filesCreated && result.filesCreated.length > 0) {
+            printInfo('생성된 파일:');
+            for (const file of result.filesCreated) {
+                console.log(chalk.gray(`  • ${file}`));
+            }
+        }
+        if (result.numTurns) {
+            console.log(chalk.gray(`  턴 수: ${result.numTurns}`));
+        }
+        if (result.costUsd) {
+            console.log(chalk.gray(`  비용: $${result.costUsd.toFixed(4)}`));
+        }
+        if (result.durationMs) {
+            const minutes = Math.floor(result.durationMs / 60000);
+            const seconds = Math.floor((result.durationMs % 60000) / 1000);
+            console.log(chalk.gray(`  소요 시간: ${minutes}분 ${seconds}초`));
+        }
+        console.log();
+        printInfo('다음 단계:');
+        console.log(chalk.cyan('  aiag feature    ') + chalk.gray('# PRD에서 Feature 목록 생성'));
+        console.log(chalk.cyan('  aiag validate   ') + chalk.gray('# Feature 목록 검증'));
+    }
+    else {
+        printError(isConversionMode ? 'PRD 변환 실패' : 'PRD 생성 실패');
+        if (result.error) {
+            console.log(chalk.red(`  ${result.error}`));
+        }
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=prd.js.map

package/dist/commands/prd.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prd.js","sourceRoot":"","sources":["../../src/commands/prd.ts"],"names":[],"mappings":"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"}

package/dist/commands/session.d.ts

@@ -1,11 +1,40 @@
+/**
+ * 세션 명령어 (재정의)
+ *
+ * 암시적 세션 관리 도입으로 session start/end는 deprecated.
+ * 새로운 역할: 세션 상태 조회 및 유틸리티
+ *
+ * 사용법:
+ *   aiag session          # 현재 세션 상태 표시
+ *   aiag session list     # 최근 세션 목록 (progress.md에서)
+ *   aiag session close    # 현재 세션 강제 종료
+ *
+ * Deprecated (하위 호환성):
+ *   aiag session start    # → work 명령 사용 권장
+ *   aiag session end      # → session close 또는 자동 종료
+ */
+interface SessionOptions {
+    count?: number;
+    force?: boolean;
+}
+/**
+ * 세션 상태 표시 (기본 명령)
+ */
+export declare function session(subcommand?: string, options?: SessionOptions): Promise<void>;
 interface SessionStartOptions {
     offline?: boolean;
     notes?: string;
 }
+/**
+ * @deprecated Use `aiag work` instead. Sessions start automatically.
+ */
 export declare function sessionStart(featureId?: string, options?: SessionStartOptions): Promise<void>;
 interface SessionEndOptions {
     offline?: boolean;
 }
+/**
+ * @deprecated Use `aiag session close` instead. Sessions end automatically after 24h inactivity.
+ */
 export declare function sessionEnd(options?: SessionEndOptions): Promise<void>;
 export {};
 //# sourceMappingURL=session.d.ts.map

package/dist/commands/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/commands/session.ts"],"names":[],"mappings":"AAcA,UAAU,mBAAmB;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,wBAAsB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqEvG;AAED,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiF/E"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/commands/session.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AA4BH,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,wBAAsB,OAAO,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA2C9F;AA2ND,UAAU,mBAAmB;IAC3B,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,GAAE,mBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+CvG;AAED,UAAU,iBAAiB;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ/E"}

package/dist/commands/session.js

@@ -1,26 +1,259 @@
-import { updateLastUpdated } from '../utils/progress.js';
+/**
+ * 세션 명령어 (재정의)
+ *
+ * 암시적 세션 관리 도입으로 session start/end는 deprecated.
+ * 새로운 역할: 세션 상태 조회 및 유틸리티
+ *
+ * 사용법:
+ *   aiag session          # 현재 세션 상태 표시
+ *   aiag session list     # 최근 세션 목록 (progress.md에서)
+ *   aiag session close    # 현재 세션 강제 종료
+ *
+ * Deprecated (하위 호환성):
+ *   aiag session start    # → work 명령 사용 권장
+ *   aiag session end      # → session close 또는 자동 종료
+ */
+import { updateLastUpdated, readProgress } from '../utils/progress.js';
 import { getProgress, getNextFeature } from '../utils/featureList.js';
-import { printHeader, printSection, colors, icons, printInfo, printSuccess, printWarning } from '../utils/output.js';
+import { printHeader, printSection, colors, icons, printInfo, printSuccess, printWarning, printError, } from '../utils/output.js';
 import { clearSessionContext, hasInterruptedWork } from '../utils/sessionContext.js';
-import { loadConnection, saveCurrentSession, loadCurrentSession, clearCurrentSession, } from '../utils/connection.js';
+import { loadConnection, saveCurrentSession } from '../utils/connection.js';
 import { getApiClient } from '../api/client.js';
-export async function sessionStart(featureId, options = {}) {
+import { syncProgressToServer } from './sync.js';
+import { loadSessionState, closeSession, getSessionStats, } from '../utils/sessionManager.js';
+/**
+ * 세션 상태 표시 (기본 명령)
+ */
+export async function session(subcommand, options = {}) {
     const baseDir = process.cwd();
-    printHeader('Session Start');
-    const progress = getProgress();
-    const nextFeature = featureId ? null : getNextFeature();
-    // Display current state
-    printSection('Current Progress');
-    console.log(`  ${progress.completed}/${progress.total} features complete (${progress.percentage}%)`);
-    if (featureId) {
-        printSection('Target Feature');
-        console.log(`  ${icons.arrow} ${featureId}`);
+    switch (subcommand) {
+        case undefined:
+        case 'status':
+            await showSessionStatus(baseDir);
+            break;
+        case 'list':
+            await listRecentSessions(baseDir, options.count || 5);
+            break;
+        case 'close':
+            await closeCurrentSession(baseDir, options.force);
+            break;
+        // Deprecated 명령어 (하위 호환성)
+        case 'start':
+            printWarning('⚠ "session start" is deprecated.');
+            console.log(colors.dim('  세션은 work/auto 명령 실행 시 자동으로 시작됩니다.'));
+            console.log(colors.dim('  작업을 시작하려면: aiag work'));
+            console.log('');
+            break;
+        case 'end':
+            printWarning('⚠ "session end" is deprecated.');
+            console.log(colors.dim('  세션은 24시간 비활성 후 자동으로 종료됩니다.'));
+            console.log(colors.dim('  강제 종료가 필요하면: aiag session close'));
+            console.log('');
+            // 하위 호환성을 위해 close 실행
+            await closeCurrentSession(baseDir, options.force);
+            break;
+        default:
+            printError(`Unknown subcommand: ${subcommand}`);
+            console.log('');
+            console.log('Usage:');
+            console.log('  aiag session           현재 세션 상태 표시');
+            console.log('  aiag session list      최근 세션 목록');
+            console.log('  aiag session close     현재 세션 강제 종료');
+            console.log('');
     }
-    else if (nextFeature) {
-        printSection('Recommended Feature');
-        console.log(`  ${icons.arrow} ${nextFeature.id}: ${nextFeature.description}`);
+}
+/**
+ * 현재 세션 상태 표시
+ */
+async function showSessionStatus(baseDir) {
+    const stats = getSessionStats(baseDir);
+    const progress = getProgress(baseDir);
+    printHeader('Session Status');
+    console.log('');
+    if (!stats.session) {
+        console.log(colors.dim('No active session.'));
+        console.log('');
+        console.log(colors.dim('세션은 다음 명령 실행 시 자동으로 시작됩니다:'));
+        console.log(colors.info('  aiag work'));
+        console.log(colors.info('  aiag auto'));
+        console.log('');
+        return;
+    }
+    const session = stats.session;
+    const statusIcon = stats.active ? colors.success('●') : colors.warning('○');
+    const statusText = stats.active ? 'Active' : 'Stale (will close on next command)';
+    // 세션 정보
+    printSection('Current Session');
+    console.log(`  ${colors.bold('ID:')}        ${session.id}`);
+    console.log(`  ${colors.bold('Status:')}    ${statusIcon} ${statusText}`);
+    console.log(`  ${colors.bold('Mode:')}      ${session.mode}`);
+    console.log(`  ${colors.bold('Started:')}   ${formatRelativeTime(session.startedAt)}`);
+    console.log(`  ${colors.bold('Duration:')}  ${stats.duration}`);
+    console.log('');
+    // 작업 통계
+    printSection('Activity');
+    console.log(`  ${colors.bold('Features worked:')}    ${session.featuresWorked.length}`);
+    console.log(`  ${colors.bold('Features completed:')} ${session.featuresCompleted.length}`);
+    console.log(`  ${colors.bold('Commits:')}            ${session.commits.length}`);
+    console.log('');
+    // 진행률 변화
+    const progressDelta = stats.progressDelta || 0;
+    const deltaText = progressDelta > 0
+        ? colors.success(`+${progressDelta}%`)
+        : progressDelta < 0
+            ? colors.error(`${progressDelta}%`)
+            : colors.dim('0%');
+    printSection('Progress');
+    console.log(`  ${session.initialProgress}% → ${progress.percentage}% (${deltaText})`);
+    console.log('');
+    // 작업한 features
+    if (session.featuresWorked.length > 0) {
+        printSection('Features Worked');
+        session.featuresWorked.forEach((id) => {
+            const completed = session.featuresCompleted.includes(id);
+            const icon = completed ? icons.success : icons.arrow;
+            console.log(`  ${icon} ${id}`);
+        });
+        console.log('');
+    }
+    // 커밋
+    if (session.commits.length > 0) {
+        printSection('Commits');
+        session.commits.slice(-5).forEach((commit) => {
+            console.log(`  ${colors.dim(commit.hash)} ${commit.message.substring(0, 50)}`);
+        });
+        if (session.commits.length > 5) {
+            console.log(colors.dim(`  ... and ${session.commits.length - 5} more`));
+        }
+        console.log('');
+    }
+    // 중단된 작업 확인
+    if (hasInterruptedWork(baseDir)) {
+        printWarning('⚠ There is interrupted work in session_context.md');
+        console.log(colors.dim('  Resume with: aiag work'));
+        console.log(colors.dim('  Or clear with: aiag session close --force'));
+        console.log('');
+    }
+}
+/**
+ * 최근 세션 목록 표시
+ */
+async function listRecentSessions(baseDir, count) {
+    const progressContent = readProgress(baseDir);
+    if (!progressContent) {
+        printError('No progress.md found.');
+        return;
+    }
+    printHeader('Recent Sessions');
+    console.log('');
+    // progress.md에서 세션 파싱
+    const sessionPattern = /## Session: (\S+)\s*\n([\s\S]*?)(?=\n## Session:|\n---\s*$|$)/g;
+    const sessions = [];
+    let match;
+    while ((match = sessionPattern.exec(progressContent)) !== null) {
+        sessions.push({
+            id: match[1],
+            content: match[2],
+        });
+    }
+    if (sessions.length === 0) {
+        console.log(colors.dim('No session history found.'));
+        console.log('');
+        return;
+    }
+    // 최근 N개 세션 표시
+    const recentSessions = sessions.slice(0, count);
+    recentSessions.forEach((session, index) => {
+        // 메트릭 파싱
+        const durationMatch = session.content.match(/\*\*Duration\*\*:\s*(.+)/);
+        const progressMatch = session.content.match(/\*\*Progress\*\*:\s*(.+)/);
+        const modeMatch = session.content.match(/\*\*Mode\*\*:\s*(.+)/);
+        const completedMatch = session.content.match(/Features Completed \((\d+)\)/);
+        const duration = durationMatch ? durationMatch[1] : 'unknown';
+        const progressChange = progressMatch ? progressMatch[1] : '-';
+        const mode = modeMatch ? modeMatch[1] : '-';
+        const completedCount = completedMatch ? completedMatch[1] : '0';
+        console.log(`${colors.bold(`${index + 1}. ${session.id}`)}`);
+        console.log(`   Duration: ${duration}  |  Mode: ${mode}  |  Completed: ${completedCount}`);
+        console.log(`   Progress: ${progressChange}`);
+        console.log('');
+    });
+    if (sessions.length > count) {
+        console.log(colors.dim(`... and ${sessions.length - count} more sessions in progress.md`));
+        console.log('');
+    }
+}
+/**
+ * 현재 세션 강제 종료
+ *
+ * 참고: 서버 세션 종료는 sessionManager.ts의 finalizeSession()에서 자동 처리
+ */
+async function closeCurrentSession(baseDir, force) {
+    const session = loadSessionState(baseDir);
+    if (!session) {
+        printInfo('No active session to close.');
+        return;
+    }
+    printHeader('Closing Session');
+    console.log('');
+    // 세션 종료 (서버 알림 포함)
+    closeSession(baseDir, 'manual');
+    const serverSynced = session.serverId ? ' (server synced)' : '';
+    printSuccess(`Session ${session.id} closed.${serverSynced}`);
+    console.log(colors.dim('  Session summary recorded in progress.md'));
+    console.log('');
+    // Progress 자동 동기화 (연결된 경우)
+    const connection = loadConnection(baseDir);
+    const client = getApiClient();
+    if (connection && client) {
+        await syncProgressToServer(client, connection.projectId, undefined, true).catch(() => {
+            // 동기화 실패 시 무시 - 다음 sync 명령에서 재시도
+        });
+    }
+    // 중단된 작업 클리어 (force 옵션)
+    if (force && hasInterruptedWork(baseDir)) {
+        clearSessionContext(baseDir);
+        printSuccess('Cleared interrupted work from session_context.md');
+        console.log('');
+    }
+    updateLastUpdated(baseDir);
+}
+// ============================================================================
+// 유틸리티 함수
+// ============================================================================
+/**
+ * 상대 시간 포맷팅
+ */
+function formatRelativeTime(isoString) {
+    const date = new Date(isoString);
+    const now = new Date();
+    const diffMs = now.getTime() - date.getTime();
+    const diffSeconds = Math.floor(diffMs / 1000);
+    const diffMinutes = Math.floor(diffSeconds / 60);
+    const diffHours = Math.floor(diffMinutes / 60);
+    const diffDays = Math.floor(diffHours / 24);
+    if (diffDays > 0) {
+        return `${diffDays} day${diffDays > 1 ? 's' : ''} ago`;
+    }
+    else if (diffHours > 0) {
+        return `${diffHours} hour${diffHours > 1 ? 's' : ''} ago`;
+    }
+    else if (diffMinutes > 0) {
+        return `${diffMinutes} minute${diffMinutes > 1 ? 's' : ''} ago`;
+    }
+    else {
+        return 'just now';
     }
-    // 서버에 세션 시작 알림 (연결된 경우)
+}
+/**
+ * @deprecated Use `aiag work` instead. Sessions start automatically.
+ */
+export async function sessionStart(featureId, options = {}) {
+    printWarning('⚠ sessionStart() is deprecated.');
+    console.log(colors.dim('  세션은 work/auto 명령 실행 시 자동으로 시작됩니다.'));
+    console.log('');
+    const baseDir = process.cwd();
+    // 하위 호환성: 서버 세션은 여전히 시작
     const connection = loadConnection(baseDir);
     const client = getApiClient();
     if (connection && client && !options.offline) {
@@ -29,124 +262,41 @@ export async function sessionStart(featureId, options = {}) {
                 agentType: 'cli',
                 notes: options.notes,
             });
-            // 현재 세션 정보 저장
             saveCurrentSession({
                 id: sessionInfo.id,
                 projectId: sessionInfo.projectId,
                 startedAt: sessionInfo.startedAt,
                 agentType: 'cli',
             }, baseDir);
-            printInfo(colors.dim(`세션 시작됨 (ID: ${sessionInfo.id.slice(0, 8)}...)`));
-            // 세션 시작 로그 전송
-            if (featureId) {
-                await client.sendLog(featureId, {
-                    type: 'started',
-                    message: `Session started for feature ${featureId}`,
-                });
-            }
+            printInfo(colors.dim(`서버 세션 시작됨 (ID: ${sessionInfo.id.slice(0, 8)}...)`));
         }
-        catch (error) {
-            printWarning('서버 세션 등록 실패 (로컬 세션으로 계속)');
+        catch {
+            printWarning('서버 세션 등록 실패');
         }
     }
-    // Checklist
-    printSection('Session Start Checklist');
-    console.log(`  ${icons.checkbox.checked} pwd - Confirm directory`);
-    console.log(`  ${icons.checkbox.checked} Read progress.md`);
-    console.log(`  ${icons.checkbox.checked} Read feature_list.json`);
-    console.log(`  ${icons.checkbox.unchecked} git log --oneline -10`);
-    console.log(`  ${icons.checkbox.unchecked} .aiag/init.sh`);
-    console.log(`  ${icons.checkbox.unchecked} Identify next feature`);
-    console.log('');
-    printInfo('Session started. Remember: ONE feature at a time!');
-    if (connection) {
-        console.log(colors.dim(`  연결된 프로젝트: ${connection.projectName}`));
-    }
-    console.log('');
-}
-export async function sessionEnd(options = {}) {
-    const baseDir = process.cwd();
-    printHeader('Session End');
-    const progress = getProgress();
-    const startProgress = progress; // 세션 시작 시점의 진행률 (실제로는 저장해두어야 함)
-    // Check if there's interrupted work and clear it
-    const hadInterruptedWork = hasInterruptedWork(baseDir);
-    if (hadInterruptedWork) {
-        clearSessionContext(baseDir);
-        console.log('');
-        printSuccess('✓ Cleared interrupted work from session context');
+    const progress = getProgress(baseDir);
+    const nextFeature = featureId ? null : getNextFeature();
+    printSection('Current Progress');
+    console.log(`  ${progress.completed}/${progress.total} features (${progress.percentage}%)`);
+    if (nextFeature) {
         console.log('');
+        console.log(colors.dim('Next recommended feature:'));
+        console.log(`  ${icons.arrow} ${nextFeature.id}: ${nextFeature.description}`);
     }
-    // Get session summary
-    printSection('Session Summary');
-    console.log(`  Progress: ${progress.completed}/${progress.total} features (${progress.percentage}%)`);
-    // 서버에 세션 종료 알림 (연결된 경우)
-    const connection = loadConnection(baseDir);
-    const client = getApiClient();
-    const currentSession = loadCurrentSession(baseDir);
-    if (connection && client && currentSession && !options.offline) {
-        try {
-            const sessionDuration = Math.floor((Date.now() - new Date(currentSession.startedAt).getTime()) / 1000);
-            // 세션 요약 생성
-            const summary = {
-                workDone: [], // 실제로는 progress.md에서 파싱해야 함
-                commits: [], // git log에서 가져올 수 있음
-                nextSteps: [],
-                notes: [],
-                duration: sessionDuration,
-            };
-            await client.endSession(currentSession.id, summary);
-            printInfo(colors.dim(`세션 종료됨 (${formatDuration(sessionDuration)})`));
-            // 현재 세션 정보 삭제
-            clearCurrentSession(baseDir);
-        }
-        catch (error) {
-            printWarning('서버 세션 종료 알림 실패');
-        }
-    }
-    // Checklist
-    printSection('Session End Checklist');
-    console.log(`  ${icons.checkbox.unchecked} Feature complete OR clean state`);
-    console.log(`  ${icons.checkbox.unchecked} All tests passing`);
-    console.log(`  ${icons.checkbox.unchecked} progress.md updated`);
-    console.log(`  ${icons.checkbox.unchecked} feature_list.json updated`);
-    console.log(`  ${icons.checkbox.unchecked} All changes committed`);
-    console.log(`  ${icons.checkbox.unchecked} git status clean`);
-    // Update last updated
-    updateLastUpdated();
-    console.log('');
-    printInfo('Remember to update progress.md with your session summary!');
     console.log('');
-    console.log(colors.dim('Template for progress.md:'));
-    console.log(colors.dim('---'));
-    console.log(colors.dim(`## Session: ${new Date().toISOString()}`));
-    console.log(colors.dim(''));
-    console.log(colors.dim('### Work Done'));
-    console.log(colors.dim('- [x] Completed task'));
-    console.log(colors.dim(''));
-    console.log(colors.dim('### Commits'));
-    console.log(colors.dim('- `hash` commit message'));
-    console.log(colors.dim(''));
-    console.log(colors.dim('### Next Session'));
-    console.log(colors.dim('- Continue with FEATURE-ID'));
-    console.log(colors.dim('---'));
+    console.log(colors.dim('To start working:'));
+    console.log(colors.info('  aiag work'));
     console.log('');
 }
 /**
- * 시간 포맷팅
+ * @deprecated Use `aiag session close` instead. Sessions end automatically after 24h inactivity.
  */
-function formatDuration(seconds) {
-    const hours = Math.floor(seconds / 3600);
-    const minutes = Math.floor((seconds % 3600) / 60);
-    const secs = seconds % 60;
-    if (hours > 0) {
-        return `${hours}시간 ${minutes}분`;
-    }
-    else if (minutes > 0) {
-        return `${minutes}분 ${secs}초`;
-    }
-    else {
-        return `${secs}초`;
-    }
+export async function sessionEnd(options = {}) {
+    printWarning('⚠ sessionEnd() is deprecated.');
+    console.log(colors.dim('  세션은 24시간 비활성 후 자동으로 종료됩니다.'));
+    console.log(colors.dim('  강제 종료: aiag session close'));
+    console.log('');
+    const baseDir = process.cwd();
+    await closeCurrentSession(baseDir, true);
 }
 //# sourceMappingURL=session.js.map