aiag-cli 2.2.3 → 2.4.0

package/dist/utils/sessionManager.js

@@ -0,0 +1,372 @@
+/**
+ * 암시적 세션 관리 모듈
+ *
+ * 세션 라이프사이클:
+ * 1. 시작: work, auto 명령 실행 시 자동 생성 (서버 연동 시 서버에도 알림)
+ * 2. 활동 기록: work, complete, commit 실행 시 자동 기록
+ * 3. 종료: 24시간 비활성 후 새 명령 실행 시 자동 종료 (서버에도 요약 전송)
+ *
+ * 서버 연동:
+ * - aiag-adp 서버에 연결된 경우, 세션 시작/종료 시 서버와 동기화
+ * - 서버 연결 실패 시에도 로컬 세션은 정상 작동
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { appendToProgress } from './progress.js';
+import { getProgress } from './featureList.js';
+import { loadConnection } from './connection.js';
+import { getApiClient } from '../api/client.js';
+const AIAG_DIR = '.aiag';
+const SESSION_FILE = 'current_session.json';
+const SESSION_TIMEOUT_HOURS = 24;
+// ============================================================================
+// 세션 파일 I/O
+// ============================================================================
+/**
+ * 세션 파일 경로 반환
+ */
+function getSessionPath(baseDir) {
+    return path.join(baseDir, AIAG_DIR, SESSION_FILE);
+}
+/**
+ * 현재 세션 로드
+ */
+export function loadSessionState(baseDir) {
+    const sessionPath = getSessionPath(baseDir);
+    if (!fs.existsSync(sessionPath)) {
+        return null;
+    }
+    try {
+        const content = fs.readFileSync(sessionPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 세션 저장
+ */
+function saveSessionState(baseDir, session) {
+    const sessionPath = getSessionPath(baseDir);
+    const aiagDir = path.join(baseDir, AIAG_DIR);
+    // .aiag 디렉토리가 없으면 생성
+    if (!fs.existsSync(aiagDir)) {
+        fs.mkdirSync(aiagDir, { recursive: true });
+    }
+    fs.writeFileSync(sessionPath, JSON.stringify(session, null, 2), 'utf-8');
+}
+/**
+ * 세션 파일 삭제
+ */
+function clearSessionState(baseDir) {
+    const sessionPath = getSessionPath(baseDir);
+    if (fs.existsSync(sessionPath)) {
+        fs.unlinkSync(sessionPath);
+    }
+}
+// ============================================================================
+// 세션 ID 생성
+// ============================================================================
+/**
+ * 세션 ID 생성 (YYYYMMDD-HHMMSS 형식)
+ */
+function generateSessionId(date = new Date()) {
+    const y = date.getFullYear();
+    const m = String(date.getMonth() + 1).padStart(2, '0');
+    const d = String(date.getDate()).padStart(2, '0');
+    const h = String(date.getHours()).padStart(2, '0');
+    const min = String(date.getMinutes()).padStart(2, '0');
+    const s = String(date.getSeconds()).padStart(2, '0');
+    return `${y}${m}${d}-${h}${min}${s}`;
+}
+// ============================================================================
+// 세션 만료 체크
+// ============================================================================
+/**
+ * 세션 만료 여부 확인
+ */
+function isSessionStale(session) {
+    const lastActivity = new Date(session.lastActivityAt);
+    const now = new Date();
+    const hoursDiff = (now.getTime() - lastActivity.getTime()) / (1000 * 60 * 60);
+    return hoursDiff > SESSION_TIMEOUT_HOURS;
+}
+// ============================================================================
+// 시간 포맷팅
+// ============================================================================
+/**
+ * 두 시간 사이의 duration 계산 (초)
+ */
+function calculateDurationSeconds(startIso, endIso) {
+    const start = new Date(startIso);
+    const end = new Date(endIso);
+    return Math.floor((end.getTime() - start.getTime()) / 1000);
+}
+/**
+ * 초를 사람이 읽기 쉬운 형식으로 변환
+ */
+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}h ${minutes}m`;
+    }
+    else if (minutes > 0) {
+        return `${minutes}m ${secs}s`;
+    }
+    else {
+        return `${secs}s`;
+    }
+}
+// ============================================================================
+// 서버 연동
+// ============================================================================
+/**
+ * 서버에 세션 시작 알림 (비동기, 실패 시 무시)
+ */
+async function notifyServerSessionStart(baseDir, session) {
+    const connection = loadConnection(baseDir);
+    const client = getApiClient();
+    if (!connection || !client) {
+        return undefined;
+    }
+    try {
+        const response = await client.startSession(connection.projectId, {
+            agentType: 'cli',
+            notes: `Session ${session.id} started (mode: ${session.mode})`,
+        });
+        return response.id;
+    }
+    catch {
+        // 서버 연결 실패 시 무시 - 로컬 세션은 계속 작동
+        return undefined;
+    }
+}
+/**
+ * 서버에 세션 종료 알림 (비동기, 실패 시 무시)
+ */
+async function notifyServerSessionEnd(baseDir, session, reason) {
+    const connection = loadConnection(baseDir);
+    const client = getApiClient();
+    // 서버 세션 ID가 없으면 무시
+    if (!connection || !client || !session.serverId) {
+        return;
+    }
+    try {
+        const duration = calculateDurationSeconds(session.startedAt, session.lastActivityAt);
+        const progress = getProgress(baseDir);
+        const summary = {
+            workDone: session.featuresCompleted.map((id) => `Completed ${id}`),
+            commits: session.commits.map((c) => `${c.hash} ${c.message}`),
+            nextSteps: session.featuresWorked
+                .filter((id) => !session.featuresCompleted.includes(id))
+                .map((id) => `Continue work on ${id}`),
+            notes: [
+                `Mode: ${session.mode}`,
+                `Closed by: ${reason}`,
+                `Progress: ${session.initialProgress}% → ${progress.percentage}%`,
+            ],
+            duration,
+        };
+        await client.endSession(session.serverId, summary);
+    }
+    catch {
+        // 서버 연결 실패 시 무시 - 로컬 요약은 이미 저장됨
+    }
+}
+// ============================================================================
+// 세션 생성 및 종료
+// ============================================================================
+/**
+ * 새 세션 생성 (동기 버전, 서버 알림은 별도 처리)
+ */
+function createNewSession(baseDir, mode = 'manual') {
+    const progress = getProgress(baseDir);
+    const now = new Date();
+    const session = {
+        id: generateSessionId(now),
+        startedAt: now.toISOString(),
+        lastActivityAt: now.toISOString(),
+        featuresWorked: [],
+        featuresCompleted: [],
+        commits: [],
+        initialProgress: progress.percentage,
+        mode,
+    };
+    saveSessionState(baseDir, session);
+    // 서버 세션 시작 (비동기로 백그라운드 처리)
+    notifyServerSessionStart(baseDir, session)
+        .then((serverId) => {
+        if (serverId) {
+            // 서버 ID 저장
+            const current = loadSessionState(baseDir);
+            if (current && current.id === session.id) {
+                current.serverId = serverId;
+                saveSessionState(baseDir, current);
+            }
+        }
+    })
+        .catch(() => {
+        // 무시
+    });
+    return session;
+}
+/**
+ * 세션 종료 처리 (progress.md에 요약 기록 + 서버 알림)
+ */
+export function finalizeSession(baseDir, session, reason) {
+    const progress = getProgress(baseDir);
+    const duration = calculateDurationSeconds(session.startedAt, session.lastActivityAt);
+    // 서버에 세션 종료 알림 (비동기, 실패 무시)
+    notifyServerSessionEnd(baseDir, session, reason).catch(() => {
+        // 무시
+    });
+    // 세션 요약 생성
+    const featuresWorkedList = session.featuresWorked.length > 0
+        ? session.featuresWorked.map((id) => `- ${id}`).join('\n')
+        : '- (none)';
+    const featuresCompletedList = session.featuresCompleted.length > 0
+        ? session.featuresCompleted.map((id) => `- [x] ${id}`).join('\n')
+        : '- (none)';
+    const commitsList = session.commits.length > 0
+        ? session.commits.map((c) => `- \`${c.hash}\` ${c.message}`).join('\n')
+        : '- (none)';
+    // 서버 ID 포함 여부
+    const serverSync = session.serverId
+        ? `- **Server Session**: ${session.serverId.slice(0, 8)}... (synced)`
+        : '- **Server Session**: (not connected)';
+    const summary = `
+---
+
+## Session: ${session.id}
+
+### Metrics
+- **Started**: ${session.startedAt}
+- **Ended**: ${session.lastActivityAt}
+- **Duration**: ${formatDuration(duration)}
+- **Mode**: ${session.mode}
+- **Closed by**: ${reason}
+- **Progress**: ${session.initialProgress}% → ${progress.percentage}%
+${serverSync}
+
+### Features Worked (${session.featuresWorked.length})
+${featuresWorkedList}
+
+### Features Completed (${session.featuresCompleted.length})
+${featuresCompletedList}
+
+### Commits (${session.commits.length})
+${commitsList}
+
+`;
+    appendToProgress(baseDir, summary);
+    clearSessionState(baseDir);
+}
+// ============================================================================
+// 공개 API
+// ============================================================================
+/**
+ * 세션 확보 (없으면 생성, 만료되었으면 갱신)
+ *
+ * @param baseDir 프로젝트 루트 디렉토리
+ * @param mode 세션 모드 (manual: 수동 작업, auto: 자동 모드)
+ * @returns 현재 세션 상태
+ */
+export function ensureSession(baseDir, mode = 'manual') {
+    const existing = loadSessionState(baseDir);
+    if (existing) {
+        if (isSessionStale(existing)) {
+            // 만료된 세션 종료 처리 후 새 세션 생성
+            finalizeSession(baseDir, existing, 'timeout');
+            return createNewSession(baseDir, mode);
+        }
+        // 기존 세션 활동 시간 갱신
+        existing.lastActivityAt = new Date().toISOString();
+        saveSessionState(baseDir, existing);
+        return existing;
+    }
+    return createNewSession(baseDir, mode);
+}
+/**
+ * 활동 기록
+ *
+ * @param baseDir 프로젝트 루트 디렉토리
+ * @param type 활동 유형
+ * @param data 활동 데이터
+ */
+export function recordActivity(baseDir, type, data) {
+    const session = ensureSession(baseDir);
+    switch (type) {
+        case 'work_started':
+            if (data.featureId && !session.featuresWorked.includes(data.featureId)) {
+                session.featuresWorked.push(data.featureId);
+            }
+            break;
+        case 'completed':
+            if (data.featureId && !session.featuresCompleted.includes(data.featureId)) {
+                session.featuresCompleted.push(data.featureId);
+            }
+            break;
+        case 'commit':
+            if (data.commitHash) {
+                const commitRecord = {
+                    hash: data.commitHash,
+                    message: data.commitMessage || '',
+                    timestamp: new Date().toISOString(),
+                    featureId: data.featureId,
+                };
+                session.commits.push(commitRecord);
+            }
+            break;
+    }
+    session.lastActivityAt = new Date().toISOString();
+    saveSessionState(baseDir, session);
+}
+/**
+ * 세션 강제 종료
+ *
+ * @param baseDir 프로젝트 루트 디렉토리
+ * @param reason 종료 사유
+ * @returns 종료된 세션 (없었으면 null)
+ */
+export function closeSession(baseDir, reason = 'manual') {
+    const session = loadSessionState(baseDir);
+    if (!session) {
+        return null;
+    }
+    finalizeSession(baseDir, session, reason);
+    return session;
+}
+/**
+ * 현재 세션 존재 여부 확인
+ */
+export function hasActiveSession(baseDir) {
+    const session = loadSessionState(baseDir);
+    return session !== null && !isSessionStale(session);
+}
+/**
+ * 세션 통계 조회
+ */
+export function getSessionStats(baseDir) {
+    const session = loadSessionState(baseDir);
+    if (!session) {
+        return {
+            active: false,
+            session: null,
+            duration: null,
+            progressDelta: null,
+        };
+    }
+    const isActive = !isSessionStale(session);
+    const progress = getProgress(baseDir);
+    const duration = calculateDurationSeconds(session.startedAt, isActive ? new Date().toISOString() : session.lastActivityAt);
+    return {
+        active: isActive,
+        session,
+        duration: formatDuration(duration),
+        progressDelta: progress.percentage - session.initialProgress,
+    };
+}
+//# sourceMappingURL=sessionManager.js.map

package/dist/utils/sessionManager.js.map

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

package/dist/utils/taskmasterConverter.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Taskmaster → aiag Feature 변환기
+ *
+ * prd-taskmaster에서 파싱된 TaskmasterRequirement 객체를
+ * aiag의 Feature 객체로 변환합니다.
+ */
+import type { Feature, FeatureCategory, FeaturePriority, FeatureList, TaskmasterRequirement, TaskmasterPriority, TaskmasterConversionOptions, ParsedPrd } from '../types.js';
+/**
+ * 파싱된 PRD를 FeatureList로 변환합니다
+ *
+ * @param parsedPrd 파싱된 PRD 결과
+ * @param options 변환 옵션
+ * @returns FeatureList 객체
+ */
+export declare function convertPrdToFeatureList(parsedPrd: ParsedPrd, options?: Partial<TaskmasterConversionOptions>): FeatureList;
+/**
+ * TaskmasterRequirement 배열을 Feature 배열로 변환합니다
+ *
+ * @param requirements 파싱된 요구사항 배열
+ * @param options 변환 옵션
+ * @returns Feature 배열
+ */
+export declare function convertToFeatures(requirements: TaskmasterRequirement[], options?: TaskmasterConversionOptions): Feature[];
+/**
+ * 제목과 설명에서 카테고리를 추론합니다
+ *
+ * @param title 요구사항 제목
+ * @param description 요구사항 설명
+ * @returns 추론된 카테고리
+ */
+export declare function inferCategory(title: string, description: string): FeatureCategory;
+/**
+ * Taskmaster 우선순위를 aiag 우선순위로 변환합니다
+ *
+ * @param priority Taskmaster 우선순위 (P0, P1, P2)
+ * @returns aiag 우선순위
+ */
+export declare function convertPriority(priority: TaskmasterPriority): FeaturePriority;
+/**
+ * Feature ID를 생성합니다
+ *
+ * @param category 카테고리
+ * @param index 순서 번호
+ * @returns 생성된 ID (예: AUTH-001)
+ */
+export declare function generateFeatureId(category: FeatureCategory, index: number): string;
+/**
+ * Acceptance Criteria와 카테고리를 기반으로 testCommand를 생성합니다
+ *
+ * @param criteria Acceptance Criteria 목록
+ * @param category 카테고리
+ * @returns 생성된 testCommand
+ */
+export declare function generateTestCommand(criteria: string[], category: FeatureCategory): string;
+/**
+ * 의존성 그래프를 분석하여 순환 의존성을 감지합니다
+ *
+ * @param features Feature 배열
+ * @returns 순환 의존성이 있으면 해당 ID 쌍, 없으면 null
+ */
+export declare function detectCircularDependencies(features: Feature[]): [string, string][] | null;
+/**
+ * 변환 결과 통계를 반환합니다
+ */
+export declare function getConversionStats(features: Feature[]): {
+    total: number;
+    byCategory: Record<string, number>;
+    byPriority: Record<FeaturePriority, number>;
+    withDependencies: number;
+    withTestCommands: number;
+};
+//# sourceMappingURL=taskmasterConverter.d.ts.map

package/dist/utils/taskmasterConverter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"taskmasterConverter.d.ts","sourceRoot":"","sources":["../../src/utils/taskmasterConverter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EACV,OAAO,EACP,eAAe,EACf,eAAe,EACf,WAAW,EACX,qBAAqB,EACrB,kBAAkB,EAClB,2BAA2B,EAC3B,SAAS,EACV,MAAM,aAAa,CAAC;AAsJrB;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,SAAS,EACpB,OAAO,GAAE,OAAO,CAAC,2BAA2B,CAAM,GACjD,WAAW,CAcb;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,YAAY,EAAE,qBAAqB,EAAE,EACrC,OAAO,GAAE,2BAA6C,GACrD,OAAO,EAAE,CA0BX;AAwCD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,eAAe,CA2BjF;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,kBAAkB,GAAG,eAAe,CAE7E;AAED;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,eAAe,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAIlF;AAED;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,EAAE,EAClB,QAAQ,EAAE,eAAe,GACxB,MAAM,CA4BR;AAmBD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,OAAO,EAAE,GAClB,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,GAAG,IAAI,CA0C3B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,OAAO,EAAE,GAAG;IACvD,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC5C,gBAAgB,EAAE,MAAM,CAAC;IACzB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAqCA"}