@silbaram/artifact-driven-agent 0.1.0

package/src/commands/setup.js

@@ -0,0 +1,128 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import {
+  getPackageRoot,
+  getWorkspaceDir,
+  getCurrentTemplateFile,
+  getAvailableTemplates,
+  copyDirMerge
+} from '../utils/files.js';
+
+export async function setup(template) {
+  const templates = getAvailableTemplates();
+  
+  if (templates.length === 0) {
+    console.log(chalk.red('❌ 사용 가능한 템플릿이 없습니다.'));
+    process.exit(1);
+  }
+
+  // 템플릿 선택
+  if (!template) {
+    const answer = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'template',
+        message: '프로젝트 템플릿을 선택하세요:',
+        choices: templates.map(t => ({
+          name: getTemplateDescription(t),
+          value: t
+        }))
+      }
+    ]);
+    template = answer.template;
+  }
+
+  // 별칭 처리
+  const aliases = {
+    'web': 'web-dev',
+    'lib': 'library'
+  };
+  if (aliases[template]) {
+    template = aliases[template];
+  }
+
+  // 템플릿 유효성 검사
+  if (!templates.includes(template)) {
+    console.log(chalk.red(`❌ 알 수 없는 템플릿: ${template}`));
+    console.log(chalk.gray(`사용 가능: ${templates.join(', ')}`));
+    console.log(chalk.gray(`별칭: web → web-dev, lib → library`));
+    process.exit(1);
+  }
+
+  const packageRoot = getPackageRoot();
+  const workspace = getWorkspaceDir();
+  const coreDir = path.join(packageRoot, 'core');
+  const templateDir = path.join(packageRoot, 'templates', template);
+
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log(chalk.cyan.bold(`📦 ${template} 템플릿으로 세팅 중...`));
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log('');
+
+  // ai-dev-team 디렉토리 생성
+  fs.ensureDirSync(path.join(workspace, 'roles'));
+  fs.ensureDirSync(path.join(workspace, 'artifacts'));
+  fs.ensureDirSync(path.join(workspace, 'rules'));
+  fs.ensureDirSync(path.join(workspace, 'artifacts', 'features', '_template'));
+  fs.ensureDirSync(path.join(workspace, 'artifacts', 'rfc'));
+
+  // Core 복사
+  console.log(chalk.gray('📁 Core 파일 복사 중...'));
+  copyDirMerge(path.join(coreDir, 'roles'), path.join(workspace, 'roles'));
+  copyDirMerge(path.join(coreDir, 'artifacts'), path.join(workspace, 'artifacts'));
+  copyDirMerge(path.join(coreDir, 'rules'), path.join(workspace, 'rules'));
+
+  // Template 복사 (머지)
+  console.log(chalk.gray(`📁 ${template} 템플릿 복사 중...`));
+  copyDirMerge(path.join(templateDir, 'roles'), path.join(workspace, 'roles'));
+  copyDirMerge(path.join(templateDir, 'artifacts'), path.join(workspace, 'artifacts'));
+  copyDirMerge(path.join(templateDir, 'rules'), path.join(workspace, 'rules'));
+
+  // Feature 템플릿 복사
+  const featureTemplateDir = path.join(packageRoot, 'ai-dev-team', 'artifacts', 'features', '_template');
+  if (fs.existsSync(featureTemplateDir)) {
+    copyDirMerge(featureTemplateDir, path.join(workspace, 'artifacts', 'features', '_template'));
+  }
+
+  // RFC 템플릿 복사
+  const rfcTemplateFile = path.join(packageRoot, 'ai-dev-team', 'artifacts', 'rfc', 'RFC-0000-template.md');
+  if (fs.existsSync(rfcTemplateFile)) {
+    fs.copyFileSync(rfcTemplateFile, path.join(workspace, 'artifacts', 'rfc', 'RFC-0000-template.md'));
+  }
+
+  // 현재 템플릿 저장
+  fs.writeFileSync(getCurrentTemplateFile(), template);
+
+  // 결과 출력
+  console.log('');
+  console.log(chalk.green('✅ 세팅 완료!'));
+  console.log('');
+  
+  // 세팅된 파일 목록
+  const roles = fs.readdirSync(path.join(workspace, 'roles')).filter(f => f.endsWith('.md'));
+  const artifacts = fs.readdirSync(path.join(workspace, 'artifacts')).filter(f => f.endsWith('.md'));
+  const rules = fs.readdirSync(path.join(workspace, 'rules')).filter(f => f.endsWith('.md'));
+
+  console.log(chalk.white.bold('📂 ai-dev-team/'));
+  console.log(chalk.gray(`   roles/     ${roles.length}개 역할`));
+  console.log(chalk.gray(`   artifacts/ ${artifacts.length}개 산출물`));
+  console.log(chalk.gray(`   rules/     ${rules.length}개 규칙`));
+  console.log('');
+  console.log(chalk.cyan('다음 단계:'));
+  console.log(chalk.gray('  ada status          # 상태 확인'));
+  console.log(chalk.gray('  ada planner claude  # AI 에이전트 실행'));
+  console.log('');
+}
+
+function getTemplateDescription(template) {
+  const descriptions = {
+    'web-dev': 'web-dev    - 웹 서비스 개발 (Backend + Frontend)',
+    'library': 'library    - 라이브러리/SDK 개발',
+    'game': 'game       - 게임 개발',
+    'cli': 'cli        - CLI 도구 개발'
+  };
+  return descriptions[template] || template;
+}

package/src/commands/status.js

@@ -0,0 +1,76 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import {
+  getWorkspaceDir,
+  getCurrentTemplate,
+  isWorkspaceSetup
+} from '../utils/files.js';
+
+export async function status() {
+  const workspace = getWorkspaceDir();
+  
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log(chalk.cyan.bold('📊 현재 상태'));
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log('');
+
+  if (!isWorkspaceSetup()) {
+    console.log(chalk.yellow('⚠️  세팅되지 않음'));
+    console.log('');
+    console.log(chalk.gray('세팅하려면:'));
+    console.log(chalk.white('  ada setup'));
+    console.log('');
+    return;
+  }
+
+  const template = getCurrentTemplate();
+  const rolesDir = path.join(workspace, 'roles');
+  const artifactsDir = path.join(workspace, 'artifacts');
+  const rulesDir = path.join(workspace, 'rules');
+
+  // 템플릿 정보
+  console.log(chalk.white.bold('템플릿:'), chalk.green(template || '알 수 없음'));
+  console.log('');
+
+  // 역할 목록
+  const roles = fs.readdirSync(rolesDir).filter(f => f.endsWith('.md'));
+  console.log(chalk.white.bold('역할 (Roles):'));
+  roles.forEach(r => {
+    console.log(chalk.gray(`  • ${r.replace('.md', '')}`));
+  });
+  console.log('');
+
+  // 산출물 목록
+  const artifacts = fs.readdirSync(artifactsDir).filter(f => f.endsWith('.md'));
+  console.log(chalk.white.bold('산출물 (Artifacts):'));
+  artifacts.forEach(a => {
+    const filePath = path.join(artifactsDir, a);
+    const content = fs.readFileSync(filePath, 'utf-8');
+    const status = getDocumentStatus(content);
+    console.log(chalk.gray(`  • ${a.replace('.md', '')} ${status}`));
+  });
+  console.log('');
+
+  // 규칙 목록
+  const rules = fs.readdirSync(rulesDir).filter(f => f.endsWith('.md'));
+  console.log(chalk.white.bold('규칙 (Rules):'));
+  rules.forEach(r => {
+    console.log(chalk.gray(`  • ${r.replace('.md', '')}`));
+  });
+  console.log('');
+}
+
+function getDocumentStatus(content) {
+  if (content.includes('Frozen') || content.includes('🔒')) {
+    return chalk.blue('[Frozen]');
+  }
+  if (content.includes('Confirmed') || content.includes('확정')) {
+    return chalk.green('[Confirmed]');
+  }
+  if (content.includes('Draft') || content.includes('초안')) {
+    return chalk.yellow('[Draft]');
+  }
+  return '';
+}

package/src/commands/validate.js

@@ -0,0 +1,219 @@
+import fs from 'fs-extra';
+import path from 'path';
+import chalk from 'chalk';
+import { getWorkspaceDir, isWorkspaceSetup } from '../utils/files.js';
+
+export async function validate(doc) {
+  if (!isWorkspaceSetup()) {
+    console.log(chalk.red('❌ 먼저 setup을 실행하세요.'));
+    process.exit(1);
+  }
+
+  const workspace = getWorkspaceDir();
+  const artifactsDir = path.join(workspace, 'artifacts');
+
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log(chalk.cyan.bold('📋 문서 검증'));
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log('');
+
+  let totalPass = 0;
+  let totalFail = 0;
+  let totalWarn = 0;
+
+  const validators = {
+    plan: validatePlan,
+    project: validateProject,
+    backlog: validateBacklog,
+    sprint: validateSprint
+  };
+
+  if (doc && validators[doc]) {
+    // 특정 문서만 검증
+    const result = validators[doc](artifactsDir);
+    totalPass += result.pass;
+    totalFail += result.fail;
+    totalWarn += result.warn;
+  } else {
+    // 전체 검증
+    for (const [name, validator] of Object.entries(validators)) {
+      const result = validator(artifactsDir);
+      totalPass += result.pass;
+      totalFail += result.fail;
+      totalWarn += result.warn;
+    }
+  }
+
+  // 결과 요약
+  console.log('');
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log(chalk.white.bold('📊 검증 결과'));
+  console.log(chalk.cyan('━'.repeat(50)));
+  console.log('');
+  console.log(chalk.green(`  ✓ PASS: ${totalPass}`));
+  console.log(chalk.red(`  ✗ FAIL: ${totalFail}`));
+  console.log(chalk.yellow(`  ⚠ WARN: ${totalWarn}`));
+  console.log('');
+
+  if (totalFail > 0) {
+    process.exit(1);
+  }
+}
+
+function validatePlan(artifactsDir) {
+  const filePath = path.join(artifactsDir, 'plan.md');
+  let pass = 0, fail = 0, warn = 0;
+
+  console.log(chalk.white.bold('📄 plan.md'));
+
+  if (!fs.existsSync(filePath)) {
+    console.log(chalk.red('  ✗ 파일 없음'));
+    return { pass: 0, fail: 1, warn: 0 };
+  }
+
+  const content = fs.readFileSync(filePath, 'utf-8');
+
+  // 필수 섹션 검사
+  const requiredSections = ['서비스 개요', '기능 목록', '비기능 요구사항'];
+  for (const section of requiredSections) {
+    if (content.includes(section)) {
+      console.log(chalk.green(`  ✓ 섹션 존재: ${section}`));
+      pass++;
+    } else {
+      console.log(chalk.red(`  ✗ 섹션 누락: ${section}`));
+      fail++;
+    }
+  }
+
+  // TBD 개수 검사
+  const tbdMatches = content.match(/TBD/gi) || [];
+  if (tbdMatches.length > 3) {
+    console.log(chalk.yellow(`  ⚠ TBD 항목: ${tbdMatches.length}개 (3개 초과)`));
+    warn++;
+  } else {
+    console.log(chalk.green(`  ✓ TBD 항목: ${tbdMatches.length}개`));
+    pass++;
+  }
+
+  console.log('');
+  return { pass, fail, warn };
+}
+
+function validateProject(artifactsDir) {
+  const filePath = path.join(artifactsDir, 'project.md');
+  let pass = 0, fail = 0, warn = 0;
+
+  console.log(chalk.white.bold('📄 project.md'));
+
+  if (!fs.existsSync(filePath)) {
+    console.log(chalk.red('  ✗ 파일 없음'));
+    return { pass: 0, fail: 1, warn: 0 };
+  }
+
+  const content = fs.readFileSync(filePath, 'utf-8');
+
+  // 필수 섹션 검사
+  const requiredSections = ['프로젝트 규모', '기술 스택'];
+  for (const section of requiredSections) {
+    if (content.includes(section)) {
+      console.log(chalk.green(`  ✓ 섹션 존재: ${section}`));
+      pass++;
+    } else {
+      console.log(chalk.red(`  ✗ 섹션 누락: ${section}`));
+      fail++;
+    }
+  }
+
+  // Frozen 상태 검사
+  if (content.includes('Frozen') || content.includes('🔒')) {
+    console.log(chalk.green('  ✓ Frozen 상태 표시됨'));
+    pass++;
+  } else {
+    console.log(chalk.yellow('  ⚠ Frozen 상태 미표시'));
+    warn++;
+  }
+
+  // 모호한 버전 검사 (예: 1.x, 2.x)
+  if (/\d+\.x/i.test(content)) {
+    console.log(chalk.yellow('  ⚠ 모호한 버전 형식 (예: 1.x)'));
+    warn++;
+  } else {
+    console.log(chalk.green('  ✓ 버전 형식 양호'));
+    pass++;
+  }
+
+  console.log('');
+  return { pass, fail, warn };
+}
+
+function validateBacklog(artifactsDir) {
+  const filePath = path.join(artifactsDir, 'backlog.md');
+  let pass = 0, fail = 0, warn = 0;
+
+  console.log(chalk.white.bold('📄 backlog.md'));
+
+  if (!fs.existsSync(filePath)) {
+    console.log(chalk.red('  ✗ 파일 없음'));
+    return { pass: 0, fail: 1, warn: 0 };
+  }
+
+  const content = fs.readFileSync(filePath, 'utf-8');
+
+  // Task 개수 검사
+  const taskMatches = content.match(/TASK-\d+/gi) || [];
+  if (taskMatches.length > 0) {
+    console.log(chalk.green(`  ✓ Task 개수: ${taskMatches.length}개`));
+    pass++;
+  } else {
+    console.log(chalk.red('  ✗ Task 없음'));
+    fail++;
+  }
+
+  // 수용 조건 존재 검사
+  if (content.includes('수용 조건') || content.includes('AC-') || content.includes('Acceptance')) {
+    console.log(chalk.green('  ✓ 수용 조건 존재'));
+    pass++;
+  } else {
+    console.log(chalk.yellow('  ⚠ 수용 조건 미확인'));
+    warn++;
+  }
+
+  console.log('');
+  return { pass, fail, warn };
+}
+
+function validateSprint(artifactsDir) {
+  const filePath = path.join(artifactsDir, 'current-sprint.md');
+  let pass = 0, fail = 0, warn = 0;
+
+  console.log(chalk.white.bold('📄 current-sprint.md'));
+
+  if (!fs.existsSync(filePath)) {
+    console.log(chalk.gray('  - 파일 없음 (스프린트 시작 전)'));
+    return { pass: 0, fail: 0, warn: 0 };
+  }
+
+  const content = fs.readFileSync(filePath, 'utf-8');
+
+  // 스프린트 번호 검사
+  if (/Sprint\s*#?\d+/i.test(content) || /스프린트\s*#?\d+/.test(content)) {
+    console.log(chalk.green('  ✓ 스프린트 번호 존재'));
+    pass++;
+  } else {
+    console.log(chalk.yellow('  ⚠ 스프린트 번호 미확인'));
+    warn++;
+  }
+
+  // 목표 섹션 검사
+  if (content.includes('목표') || content.includes('Goal')) {
+    console.log(chalk.green('  ✓ 목표 섹션 존재'));
+    pass++;
+  } else {
+    console.log(chalk.yellow('  ⚠ 목표 섹션 미확인'));
+    warn++;
+  }
+
+  console.log('');
+  return { pass, fail, warn };
+}

package/src/index.js

@@ -0,0 +1,12 @@
+// Commands
+export { setup } from './commands/setup.js';
+export { status } from './commands/status.js';
+export { reset } from './commands/reset.js';
+export { validate } from './commands/validate.js';
+export { sessions } from './commands/sessions.js';
+export { logs } from './commands/logs.js';
+export { run } from './commands/run.js';
+export { interactive } from './commands/interactive.js';
+
+// Utils
+export * from './utils/files.js';

package/src/utils/files.js

@@ -0,0 +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(process.cwd(), '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);
+    }
+  }
+}