@silbaram/artifact-driven-agent 0.1.2 → 0.1.4

package/src/utils/sessionState.js

@@ -0,0 +1,350 @@
+import fs from 'fs-extra';
+import path from 'path';
+import { getWorkspaceDir } from './files.js';
+
+/**
+ * .ada-status.json 파일 경로 반환
+ */
+export function getStatusFilePath() {
+  return path.join(getWorkspaceDir(), '.ada-status.json');
+}
+
+/**
+ * 상태 파일 템플릿
+ */
+function getEmptyStatus() {
+  return {
+    version: '1.0',
+    updatedAt: new Date().toISOString(),
+    currentPhase: 'planning',
+    activeSessions: [],
+    pendingQuestions: [],
+    taskProgress: {},
+    notifications: [],
+    locks: {}
+  };
+}
+
+/**
+ * 상태 파일 읽기 (없으면 초기화)
+ * 동시 접근 시 재시도 로직 포함
+ */
+export function readStatus(retries = 3) {
+  const statusFile = getStatusFilePath();
+
+  for (let i = 0; i < retries; i++) {
+    try {
+      if (!fs.existsSync(statusFile)) {
+        const initialStatus = getEmptyStatus();
+        fs.writeFileSync(statusFile, JSON.stringify(initialStatus, null, 2));
+        return initialStatus;
+      }
+
+      const content = fs.readFileSync(statusFile, 'utf-8');
+      const status = JSON.parse(content);
+
+      // 스키마 검증 및 누락된 필드 추가
+      const emptyStatus = getEmptyStatus();
+      Object.keys(emptyStatus).forEach(key => {
+        if (status[key] === undefined) {
+          status[key] = emptyStatus[key];
+        }
+      });
+
+      return status;
+    } catch (err) {
+      if (i === retries - 1) {
+        console.error('⚠️  상태 파일 읽기 실패:', err.message);
+        return getEmptyStatus();
+      }
+      // 짧은 대기 후 재시도
+      const delay = Math.random() * 100;
+      const start = Date.now();
+      while (Date.now() - start < delay) { /* busy wait */ }
+    }
+  }
+
+  return getEmptyStatus();
+}
+
+/**
+ * 상태 파일 쓰기
+ * 동시 접근 시 재시도 로직 포함
+ */
+export function writeStatus(status, retries = 3) {
+  const statusFile = getStatusFilePath();
+  status.updatedAt = new Date().toISOString();
+
+  for (let i = 0; i < retries; i++) {
+    try {
+      // 임시 파일에 먼저 쓰고 atomic rename
+      const tempFile = `${statusFile}.tmp`;
+      fs.writeFileSync(tempFile, JSON.stringify(status, null, 2));
+      fs.renameSync(tempFile, statusFile);
+      return true;
+    } catch (err) {
+      if (i === retries - 1) {
+        console.error('⚠️  상태 파일 쓰기 실패:', err.message);
+        return false;
+      }
+      // 짧은 대기 후 재시도
+      const delay = Math.random() * 100;
+      const start = Date.now();
+      while (Date.now() - start < delay) { /* busy wait */ }
+    }
+  }
+
+  return false;
+}
+
+/**
+ * 세션 등록
+ */
+export function registerSession(sessionId, role, tool) {
+  const status = readStatus();
+
+  // 기존 세션 중복 확인
+  const existing = status.activeSessions.find(s => s.sessionId === sessionId);
+  if (existing) {
+    return status;
+  }
+
+  status.activeSessions.push({
+    sessionId,
+    role,
+    tool,
+    startedAt: new Date().toISOString(),
+    status: 'active'
+  });
+
+  writeStatus(status);
+  return status;
+}
+
+/**
+ * 세션 제거
+ */
+export function unregisterSession(sessionId) {
+  const status = readStatus();
+
+  status.activeSessions = status.activeSessions.filter(s => s.sessionId !== sessionId);
+
+  // 해당 세션이 보유한 잠금 해제
+  Object.keys(status.locks).forEach(file => {
+    if (status.locks[file].holder === sessionId) {
+      delete status.locks[file];
+    }
+  });
+
+  writeStatus(status);
+  return status;
+}
+
+/**
+ * 세션 상태 업데이트
+ */
+export function updateSessionStatus(sessionId, newStatus) {
+  const status = readStatus();
+
+  const session = status.activeSessions.find(s => s.sessionId === sessionId);
+  if (session) {
+    session.status = newStatus;
+    session.lastUpdate = new Date().toISOString();
+    writeStatus(status);
+  }
+
+  return status;
+}
+
+/**
+ * 질문 추가
+ */
+export function addQuestion(from, to, question, options = [], priority = 'normal') {
+  const status = readStatus();
+
+  const questionId = `Q${from.substring(0, 1).toUpperCase()}${String(status.pendingQuestions.length + 1).padStart(3, '0')}`;
+
+  const newQuestion = {
+    id: questionId,
+    from,
+    to,
+    question,
+    options,
+    priority,
+    status: 'waiting',
+    createdAt: new Date().toISOString()
+  };
+
+  status.pendingQuestions.push(newQuestion);
+
+  // 알림 추가
+  addNotificationInternal(status, 'question', from, `새 질문 [${questionId}]: ${question}`);
+
+  writeStatus(status);
+  return questionId;
+}
+
+/**
+ * 질문 응답
+ */
+export function answerQuestion(questionId, answer) {
+  const status = readStatus();
+
+  const question = status.pendingQuestions.find(q => q.id === questionId);
+  if (question) {
+    question.status = 'answered';
+    question.answer = answer;
+    question.answeredAt = new Date().toISOString();
+
+    // 알림 추가
+    addNotificationInternal(status, 'info', 'manager', `질문 ${questionId} 응답됨: ${answer}`);
+
+    writeStatus(status);
+  }
+
+  return status;
+}
+
+/**
+ * Task 진행률 업데이트
+ */
+export function updateTaskProgress(taskId, updates) {
+  const status = readStatus();
+
+  if (!status.taskProgress[taskId]) {
+    status.taskProgress[taskId] = {};
+  }
+
+  Object.assign(status.taskProgress[taskId], updates, {
+    lastUpdate: new Date().toISOString()
+  });
+
+  writeStatus(status);
+  return status;
+}
+
+/**
+ * 알림 추가 (내부용)
+ */
+function addNotificationInternal(status, type, from, message) {
+  const notificationId = `N${String(status.notifications.length + 1).padStart(3, '0')}`;
+
+  status.notifications.push({
+    id: notificationId,
+    type,
+    from,
+    message,
+    read: false,
+    createdAt: new Date().toISOString()
+  });
+
+  // 알림은 최근 50개만 유지
+  if (status.notifications.length > 50) {
+    status.notifications = status.notifications.slice(-50);
+  }
+}
+
+/**
+ * 알림 추가 (외부용)
+ */
+export function addNotification(type, from, message) {
+  const status = readStatus();
+  addNotificationInternal(status, type, from, message);
+  writeStatus(status);
+  return status;
+}
+
+/**
+ * 파일 잠금 획득
+ */
+export function acquireLock(sessionId, filePath, timeoutMs = 30000) {
+  const status = readStatus();
+
+  // 기존 잠금 확인
+  if (status.locks[filePath]) {
+    const lock = status.locks[filePath];
+    const lockAge = Date.now() - new Date(lock.acquiredAt).getTime();
+
+    // 타임아웃 초과 시 강제 해제
+    if (lockAge > timeoutMs) {
+      addNotificationInternal(status, 'warning', 'system',
+        `파일 잠금 타임아웃: ${filePath} (${lock.holder})`);
+      delete status.locks[filePath];
+    } else {
+      // 다른 세션이 잠금 보유 중
+      return false;
+    }
+  }
+
+  // 잠금 획득
+  status.locks[filePath] = {
+    holder: sessionId,
+    acquiredAt: new Date().toISOString()
+  };
+
+  writeStatus(status);
+  return true;
+}
+
+/**
+ * 파일 잠금 해제
+ */
+export function releaseLock(sessionId, filePath) {
+  const status = readStatus();
+
+  if (status.locks[filePath] && status.locks[filePath].holder === sessionId) {
+    delete status.locks[filePath];
+    writeStatus(status);
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * 읽지 않은 알림 개수
+ */
+export function getUnreadNotificationCount() {
+  const status = readStatus();
+  return status.notifications.filter(n => !n.read).length;
+}
+
+/**
+ * 활성 세션 목록
+ */
+export function getActiveSessions() {
+  const status = readStatus();
+  return status.activeSessions;
+}
+
+/**
+ * 대기 중인 질문 목록
+ */
+export function getPendingQuestions() {
+  const status = readStatus();
+  return status.pendingQuestions.filter(q => q.status === 'waiting');
+}
+
+/**
+ * 좀비 세션 정리 (오래된 세션 제거)
+ */
+export function cleanupZombieSessions(maxAgeMinutes = 60) {
+  const status = readStatus();
+  const now = Date.now();
+
+  const originalCount = status.activeSessions.length;
+
+  status.activeSessions = status.activeSessions.filter(session => {
+    const age = now - new Date(session.startedAt).getTime();
+    return age < maxAgeMinutes * 60 * 1000;
+  });
+
+  const removedCount = originalCount - status.activeSessions.length;
+
+  if (removedCount > 0) {
+    addNotificationInternal(status, 'info', 'system', `좀비 세션 ${removedCount}개 정리됨`);
+    writeStatus(status);
+  }
+
+  return removedCount;
+}

package/docs/feature-structure.md

@@ -1,36 +0,0 @@
-# Feature 단위 Artifacts 구조
-
-> 대규모 프로젝트에서 병렬 개발을 위한 Feature 분리 구조
-
-## 📁 구조
-
-```
-ai-dev-team/artifacts/features/
-├── F001-user-auth/
-│   ├── spec.md      # Feature 스펙
-│   ├── api.md       # Feature API
-│   ├── ui.md        # Feature UI
-│   ├── review.md    # 리뷰 기록
-│   └── qa.md        # QA 기록
-└── _template/       # 템플릿
-```
-
-## 🎯 언제 사용하는가?
-
-### 사용 권장
-- 프로젝트 규모 M 이상
-- 기능 3개 이상
-- 병렬 개발 필요
-
-### 사용 불필요
-- 프로젝트 규모 S
-- 기능 2개 이하
-- 순차 개발
-
-## 📋 명명 규칙
-
-```
-<Feature-ID>-<feature-name>/
-```
-
-예시: `F001-user-auth/`, `F002-dashboard/`