@silbaram/artifact-driven-agent 0.1.5 → 0.1.6

package/src/utils/files.js

@@ -1,134 +1,134 @@
-import fs from 'fs-extra';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-/**
- * 패키지 루트 디렉토리 반환
- */
-export function getPackageRoot() {
-  return path.resolve(__dirname, '../..');
-}
-
-/**
- * 작업 디렉토리 (ai-dev-team) 경로 반환
- */
-export function getWorkspaceDir() {
-  return path.join(process.cwd(), 'ai-dev-team');
-}
-
-/**
- * 세션 디렉토리 경로 반환
- */
-export function getSessionsDir() {
-  return path.join(getWorkspaceDir(), '.sessions');
-}
-
-/**
- * 로그 디렉토리 경로 반환
- */
-export function getLogsDir() {
-  return path.join(getWorkspaceDir(), '.sessions', 'logs');
-}
-
-/**
- * 현재 템플릿 파일 경로 반환
- */
-export function getCurrentTemplateFile() {
-  return path.join(getWorkspaceDir(), '.current-template');
-}
-
-/**
- * 현재 세팅된 템플릿 반환
- */
-export function getCurrentTemplate() {
-  const templateFile = getCurrentTemplateFile();
-  if (fs.existsSync(templateFile)) {
-    return fs.readFileSync(templateFile, 'utf-8').trim();
-  }
-  return null;
-}
-
-/**
- * 세션 ID 생성
- */
-export function generateSessionId() {
-  const now = new Date();
-  const date = now.toISOString().slice(0, 10).replace(/-/g, '');
-  const time = now.toTimeString().slice(0, 8).replace(/:/g, '');
-  const random = Math.random().toString(16).slice(2, 10);
-  return `${date}-${time}-${random}`;
-}
-
-/**
- * 타임스탬프 생성
- */
-export function getTimestamp() {
-  return new Date().toISOString().replace('T', ' ').slice(0, 19);
-}
-
-/**
- * 사용 가능한 템플릿 목록
- */
-export function getAvailableTemplates() {
-  const templatesDir = path.join(getPackageRoot(), 'templates');
-  if (!fs.existsSync(templatesDir)) {
-    return [];
-  }
-  return fs.readdirSync(templatesDir).filter(f => {
-    return fs.statSync(path.join(templatesDir, f)).isDirectory();
-  });
-}
-
-/**
- * 사용 가능한 역할 목록
- */
-export function getAvailableRoles() {
-  const workspaceRoles = path.join(getWorkspaceDir(), 'roles');
-  if (!fs.existsSync(workspaceRoles)) {
-    return [];
-  }
-  return fs.readdirSync(workspaceRoles)
-    .filter(f => f.endsWith('.md'))
-    .map(f => f.replace('.md', ''));
-}
-
-/**
- * 사용 가능한 도구 목록
- */
-export function getAvailableTools() {
-  return ['claude', 'codex', 'gemini', 'copilot'];
-}
-
-/**
- * 워크스페이스가 세팅되어 있는지 확인
- */
-export function isWorkspaceSetup() {
-  const workspace = getWorkspaceDir();
-  const rolesDir = path.join(workspace, 'roles');
-  return fs.existsSync(rolesDir) && fs.readdirSync(rolesDir).filter(f => f.endsWith('.md')).length > 0;
-}
-
-/**
- * 디렉토리 복사 (머지)
- */
-export function copyDirMerge(src, dest) {
-  if (!fs.existsSync(src)) return;
-  
-  fs.ensureDirSync(dest);
-  const items = fs.readdirSync(src);
-  
-  for (const item of items) {
-    const srcPath = path.join(src, item);
-    const destPath = path.join(dest, item);
-    const stat = fs.statSync(srcPath);
-    
-    if (stat.isDirectory()) {
-      copyDirMerge(srcPath, destPath);
-    } else {
-      fs.copyFileSync(srcPath, destPath);
-    }
-  }
-}
+import fs from 'fs-extra';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+/**
+ * 패키지 루트 디렉토리 반환
+ */
+export function getPackageRoot() {
+  return path.resolve(__dirname, '../..');
+}
+
+/**
+ * 작업 디렉토리 (ai-dev-team) 경로 반환
+ */
+export function getWorkspaceDir() {
+  return path.join(process.cwd(), 'ai-dev-team');
+}
+
+/**
+ * 세션 디렉토리 경로 반환
+ */
+export function getSessionsDir() {
+  return path.join(getWorkspaceDir(), '.sessions');
+}
+
+/**
+ * 로그 디렉토리 경로 반환
+ */
+export function getLogsDir() {
+  return path.join(getWorkspaceDir(), '.sessions', 'logs');
+}
+
+/**
+ * 현재 템플릿 파일 경로 반환
+ */
+export function getCurrentTemplateFile() {
+  return path.join(getWorkspaceDir(), '.current-template');
+}
+
+/**
+ * 현재 세팅된 템플릿 반환
+ */
+export function getCurrentTemplate() {
+  const templateFile = getCurrentTemplateFile();
+  if (fs.existsSync(templateFile)) {
+    return fs.readFileSync(templateFile, 'utf-8').trim();
+  }
+  return null;
+}
+
+/**
+ * 세션 ID 생성
+ */
+export function generateSessionId() {
+  const now = new Date();
+  const date = now.toISOString().slice(0, 10).replace(/-/g, '');
+  const time = now.toTimeString().slice(0, 8).replace(/:/g, '');
+  const random = Math.random().toString(16).slice(2, 10);
+  return `${date}-${time}-${random}`;
+}
+
+/**
+ * 타임스탬프 생성
+ */
+export function getTimestamp() {
+  return new Date().toISOString().replace('T', ' ').slice(0, 19);
+}
+
+/**
+ * 사용 가능한 템플릿 목록
+ */
+export function getAvailableTemplates() {
+  const templatesDir = path.join(getPackageRoot(), 'templates');
+  if (!fs.existsSync(templatesDir)) {
+    return [];
+  }
+  return fs.readdirSync(templatesDir).filter(f => {
+    return fs.statSync(path.join(templatesDir, f)).isDirectory();
+  });
+}
+
+/**
+ * 사용 가능한 역할 목록
+ */
+export function getAvailableRoles() {
+  const workspaceRoles = path.join(getWorkspaceDir(), 'roles');
+  if (!fs.existsSync(workspaceRoles)) {
+    return [];
+  }
+  return fs.readdirSync(workspaceRoles)
+    .filter(f => f.endsWith('.md'))
+    .map(f => f.replace('.md', ''));
+}
+
+/**
+ * 사용 가능한 도구 목록
+ */
+export function getAvailableTools() {
+  return ['claude', 'codex', 'gemini', 'copilot'];
+}
+
+/**
+ * 워크스페이스가 세팅되어 있는지 확인
+ */
+export function isWorkspaceSetup() {
+  const workspace = getWorkspaceDir();
+  const rolesDir = path.join(workspace, 'roles');
+  return fs.existsSync(rolesDir) && fs.readdirSync(rolesDir).filter(f => f.endsWith('.md')).length > 0;
+}
+
+/**
+ * 디렉토리 복사 (머지)
+ */
+export function copyDirMerge(src, dest) {
+  if (!fs.existsSync(src)) return;
+  
+  fs.ensureDirSync(dest);
+  const items = fs.readdirSync(src);
+  
+  for (const item of items) {
+    const srcPath = path.join(src, item);
+    const destPath = path.join(dest, item);
+    const stat = fs.statSync(srcPath);
+    
+    if (stat.isDirectory()) {
+      copyDirMerge(srcPath, destPath);
+    } else {
+      fs.copyFileSync(srcPath, destPath);
+    }
+  }
+}

package/src/utils/sessionState.js

@@ -40,18 +40,37 @@ export function readStatus(retries = 3) {
         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];
+      let content = fs.readFileSync(statusFile, 'utf-8');
+      try {
+        const status = JSON.parse(content);
+        // 스키마 검증 및 누락된 필드 추가
+        const emptyStatus = getEmptyStatus();
+        Object.keys(emptyStatus).forEach(key => {
+          if (status[key] === undefined) {
+            status[key] = emptyStatus[key];
+          }
+        });
+        return status;
+      } catch (parseError) {
+        if (parseError instanceof SyntaxError && parseError.message.includes('JSON')) {
+          // 파일 내용에서 백슬래시 이스케이프 처리
+          content = content.replace(/\\/g, '\\\\');
+          const status = JSON.parse(content);
+
+          // 스키마 검증 및 누락된 필드 추가
+          const emptyStatus = getEmptyStatus();
+          Object.keys(emptyStatus).forEach(key => {
+            if (status[key] === undefined) {
+              status[key] = emptyStatus[key];
+            }
+          });
+          
+          // 복구된 파일 저장
+          fs.writeFileSync(statusFile, JSON.stringify(status, null, 2));
+          return status;
         }
-      });
-
-      return status;
+        throw parseError;
+      }
     } catch (err) {
       if (i === retries - 1) {
         console.error('⚠️  상태 파일 읽기 실패:', err.message);

package/core/artifacts/architecture-options.md

@@ -1,85 +0,0 @@
-# Architecture Options
-
-> 아키텍처 협상 과정 기록
-> Architect와 사용자 간 논의 내용
-
----
-
-## 0. 문서 메타
-
-| 항목 | 값 |
-|------|-----|
-| 상태 | 협의 중 / 확정 |
-| 최종 수정 | YYYY-MM-DD |
-
----
-
-## 1. 결정 상태
-
-| 항목 | 상태 | 선택 |
-|------|:----:|------|
-| 규모 | ✅ | M (Medium) |
-| 언어 | ✅ | [선택] |
-| 프레임워크 | ⏳ | - |
-| 데이터 저장 | ❌ | - |
-
-상태: ✅ 확정 / ⏳ 협의 중 / ❌ 미정
-
----
-
-## 2. 규모 분석
-
-### 분석 결과
-
-| 항목 | 값 |
-|------|-----|
-| 핵심 기능 수 | N개 |
-| 예상 복잡도 | 낮음 / 중간 / 높음 |
-| 권장 규모 | S / M / L |
-
-### 규모 근거
-
-[규모 판단 근거 설명]
-
----
-
-## 3. 옵션 제안
-
-### [항목명] 옵션
-
-| 옵션 | 장점 | 단점 |
-|------|------|------|
-| A: [선택지] | [장점] | [단점] |
-| B: [선택지] | [장점] | [단점] |
-| C: [선택지] | [장점] | [단점] |
-
-### Architect 권장
-
-옵션 [X] 권장
-
-이유: [권장 이유]
-
----
-
-## 4. 사용자 선택 기록
-
-| 날짜 | 항목 | 선택 | 이유 |
-|------|------|------|------|
-| YYYY-MM-DD | 규모 | M | 기능 수 기준 |
-| YYYY-MM-DD | 언어 | [선택] | [이유] |
-
----
-
-## 5. 미결정 항목
-
-| 항목 | 옵션 | 결정 예정 |
-|------|------|----------|
-| [항목] | A / B / C | [시점] |
-
----
-
-## 6. 확정 시 다음 단계
-
-모든 항목 확정 후:
-1. project.md 생성 (Frozen)
-2. 스프린트 계획 시작

package/core/artifacts/backlog.md

@@ -1,177 +0,0 @@
-# Backlog (Task 목록)
-
-> 모든 Task의 단일 진실 (Single Source of Truth)
-> Planner가 생성, Manager가 상태 관리
-
----
-
-## ✅ Task 완성도 체크리스트
-
-> ⚠️ Task가 READY 상태가 되려면 모든 항목 충족 필요
-
-### 필수 항목 (Required)
-- [ ] Task ID 부여됨 (TASK-NNN)
-- [ ] 출처(기능 ID)가 plan.md에 존재함
-- [ ] 수용 조건 최소 1개 이상
-- [ ] 크기(S/M/L) 결정됨
-- [ ] 우선순위(P0/P1/P2) 결정됨
-
-### 품질 체크 (Quality)
-- [ ] 수용 조건이 테스트 가능함
-- [ ] 의존성이 명시됨 (없으면 "-")
-- [ ] Task 설명이 구체적임 (모호한 표현 없음)
-- [ ] L 크기 Task가 분해 검토됨
-
----
-
-## 0. 문서 메타
-
-| 항목 | 값 |
-|------|-----|
-| 총 Task 수 | N개 |
-| READY | N개 |
-| IN_SPRINT | N개 |
-| DONE | N개 |
-| 최종 갱신 | YYYY-MM-DD |
-
----
-
-## 1. Task 상태 정의
-
-| 상태 | 설명 | 다음 상태 |
-|------|------|----------|
-| BACKLOG | 정의됨, 상세화 필요 | READY |
-| READY | 스프린트 투입 가능 | IN_SPRINT |
-| IN_SPRINT | 현재 스프린트에 포함 | IN_DEV |
-| IN_DEV | 개발 중 | IN_REVIEW |
-| IN_REVIEW | 리뷰 중 | IN_QA, IN_DEV |
-| IN_QA | QA 검증 중 | DONE, IN_DEV |
-| DONE | 완료 | - |
-| BLOCKED | 차단됨 | (해결 후 원래 상태) |
-| DEFERRED | 보류/이월 | BACKLOG |
-
----
-
-## 2. Task 목록
-
-### TASK-001: [Task 이름]
-
-| 항목 | 값 |
-|------|-----|
-| 상태 | BACKLOG |
-| 우선순위 | P0 / P1 / P2 |
-| 크기 | S / M / L |
-| 출처 | F001 (plan.md 기능 ID) |
-| 담당 | - |
-| 의존성 | - |
-
-**수용 조건 (Acceptance Criteria):**
-- [ ] 조건 1
-- [ ] 조건 2
-- [ ] 조건 3
-
----
-
-### TASK-002: [Task 이름]
-
-| 항목 | 값 |
-|------|-----|
-| 상태 | BACKLOG |
-| 우선순위 | P1 |
-| 크기 | M |
-| 출처 | F001 |
-| 담당 | - |
-| 의존성 | TASK-001 |
-
-**수용 조건:**
-- [ ] 조건 1
-- [ ] 조건 2
-
----
-
-### TASK-003: [Task 이름]
-
-| 항목 | 값 |
-|------|-----|
-| 상태 | BACKLOG |
-| 우선순위 | P1 |
-| 크기 | S |
-| 출처 | F002 |
-| 담당 | - |
-| 의존성 | - |
-
-**수용 조건:**
-- [ ] 조건 1
-- [ ] 조건 2
-
----
-
-## 3. 완료된 Task (Archive)
-
-> DONE 상태 Task는 여기로 이동
-
-### ~~TASK-000: [Task 이름]~~ ✅
-
-| 항목 | 값 |
-|------|-----|
-| 상태 | DONE |
-| 완료일 | YYYY-MM-DD |
-| 스프린트 | Sprint 1 |
-
----
-
-## 4. Task 작성 규칙
-
-### 4.1 Task 분해 원칙
-
-- 기능 1개 = Task 1개 이상
-- Task는 독립적으로 완료 가능해야 함
-- 의존성이 있으면 명시
-
-### 4.2 크기 기준
-
-| 크기 | 설명 | 예상 시간 |
-|:----:|------|----------|
-| S | 단순 구현 | 1-2시간 |
-| M | 일반 기능 | 반나절 |
-| L | 복합 기능 | 1일+ |
-
-### 4.3 수용 조건 규칙
-
-- 검증 가능해야 함 (테스트 가능)
-- 구체적이어야 함 (모호함 금지)
-- 완료 기준이 명확해야 함
-
----
-
-## 5. 상태 전환 규칙
-
-### 5.1 전환 권한
-
-| 전환 | 권한 |
-|------|------|
-| BACKLOG → READY | Planner |
-| READY → IN_SPRINT | Manager |
-| IN_SPRINT → IN_DEV | Developer |
-| IN_DEV → IN_REVIEW | Developer |
-| IN_REVIEW → IN_QA | Reviewer (PASS 시) |
-| IN_REVIEW → IN_DEV | Reviewer (REJECT 시) |
-| IN_QA → DONE | Manager (PASS 후 승인) |
-| IN_QA → IN_DEV | QA (FAIL 시) |
-| * → BLOCKED | 누구나 (사유 명시) |
-| * → DEFERRED | Manager |
-
-### 5.2 역전환 규칙
-
-- REJECT/FAIL 시에만 역전환 가능
-- 역전환 시 사유 필수 기록
-
----
-
-## 6. 변경 이력
-
-| 날짜 | Task ID | 변경 내용 | 작성자 |
-|------|---------|----------|--------|
-| YYYY-MM-DD | TASK-001 | 생성 | Planner |
-| YYYY-MM-DD | TASK-001 | BACKLOG → READY | Planner |
-| YYYY-MM-DD | TASK-001 | READY → IN_SPRINT | Manager |

package/core/artifacts/current-sprint.md

@@ -1,125 +0,0 @@
-# Current Sprint
-
-> 현재 진행 중인 스프린트의 작업 범위
-> Manager가 관리
-
----
-
-## 0. 스프린트 메타
-
-| 항목 | 값 |
-|------|-----|
-| 스프린트 | Sprint N |
-| 시작일 | YYYY-MM-DD |
-| 종료 예정 | YYYY-MM-DD |
-| 상태 | 계획 / 진행 / 완료 |
-
----
-
-## 1. 스프린트 목표
-
-> 이번 스프린트에서 달성하고자 하는 것
-
-- [목표 1]
-- [목표 2]
-
----
-
-## 2. 스프린트 Task 목록
-
-| Task | 상태 | 담당 | 우선순위 | 크기 |
-|------|:----:|------|:--------:|:----:|
-| TASK-001 | IN_DEV | Developer | P0 | M |
-| TASK-002 | IN_SPRINT | - | P1 | S |
-| TASK-003 | IN_REVIEW | Developer | P1 | M |
-
-### 상태 요약
-
-| 상태 | 개수 |
-|------|:----:|
-| IN_SPRINT | N |
-| IN_DEV | N |
-| IN_REVIEW | N |
-| IN_QA | N |
-| DONE | N |
-| **총합** | **N** |
-
----
-
-## 3. 역할별 현재 작업
-
-### Developer
-
-| Task | 상태 | 비고 |
-|------|------|------|
-| TASK-001 | IN_DEV | 진행 중 |
-
-### Reviewer
-
-| Task | 상태 | 비고 |
-|------|------|------|
-| TASK-003 | IN_REVIEW | 리뷰 대기 |
-
-### QA
-
-| Task | 상태 | 비고 |
-|------|------|------|
-| - | - | 대기 중 |
-
----
-
-## 4. 차단 사항 (Blockers)
-
-> 현재 진행을 막는 이슈
-
-| Task | 차단 사유 | 담당자 | 상태 |
-|------|----------|--------|------|
-| - | - | - | - |
-
----
-
-## 5. 스프린트 중 변경 사항
-
-> 스프린트 시작 후 발생한 변경
-
-| 날짜 | 변경 내용 | 사유 | 승인 |
-|------|----------|------|------|
-| - | - | - | - |
-
----
-
-## 6. 스프린트 회고 (완료 시)
-
-> 스프린트 종료 후 Manager가 작성
-
-### 완료된 Task
-
-| Task | 설명 |
-|------|------|
-| TASK-XXX | [설명] |
-
-### 미완료 Task
-
-| Task | 사유 | 처리 |
-|------|------|------|
-| TASK-XXX | [사유] | 이월 / 취소 |
-
-### 잘된 점
-
-- [내용]
-
-### 개선할 점
-
-- [내용]
-
-### 다음 스프린트 제안
-
-- [제안]
-
----
-
-## 7. 스프린트 히스토리
-
-| 스프린트 | 기간 | 목표 | 완료 Task | 결과 |
-|----------|------|------|:---------:|:----:|
-| Sprint 1 | MM/DD ~ MM/DD | [목표] | N개 | ✅ / ⚠️ |