@dusky-bluehour/agent-service 0.6.3 → 0.6.4

package/README.md

@@ -1,5 +1,9 @@
 # tri-agent-manager
 
+```bash
+pnpm dlx --package=@dusky-bluehour/agent-service tri-agent-manager --interactive
+```
+
 Claude Code, Antigravity, Codex에서 공통으로 사용하실 수 있는 서비스 운영형 스킬/워크플로우 패키지입니다.
 
 ## 목적

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dusky-bluehour/agent-service",
-  "version": "0.6.3",
+  "version": "0.6.4",
   "publishConfig": {
     "access": "public"
   },

package/scripts/init.mjs

@@ -1146,32 +1146,82 @@ function statusLabel(status) {
   }
 }
 
-function printPlan(catalog, selection, mode, targetDir) {
-  console.log('');
-  console.log('실행 계획');
-  console.log(`- 모드: ${mode}`);
-  console.log(`- 프리셋: ${selection.presetId ?? '수동/없음'}`);
-  console.log(`- 대상 경로: ${targetDir}`);
+function statusIcon(status) {
+  switch (status) {
+    case 'copied':
+      return '✅';
+    case 'overwritten':
+      return '♻️';
+    case 'skipped':
+      return '⏭️';
+    case 'would-copy':
+      return '📝';
+    case 'would-overwrite':
+      return '🛠️';
+    default:
+      return '•';
+  }
+}
 
-  for (const toolId of selection.selectedToolIds) {
+function normalizeChoiceInput(value) {
+  return value
+    .trim()
+    .toLowerCase()
+    .replaceAll('１', '1')
+    .replaceAll('２', '2')
+    .replaceAll('３', '3')
+    .replaceAll('４', '4')
+    .replaceAll('５', '5');
+}
+
+function printPlan(catalog, selection, mode, targetDir, dryRun = false) {
+  console.log('');
+  console.log('━━━━━━━━ 실행 계획 ━━━━━━━━');
+  console.log(`모드       : ${mode}`);
+  console.log(`실행 타입  : ${dryRun ? 'dry-run (실제 파일 변경 없음)' : '실행 (파일 변경 반영)'}`);
+  console.log(`프리셋     : ${selection.presetId ?? '수동/없음'}`);
+  console.log(`대상 경로  : ${targetDir}`);
+  console.log(`선택 도구  : ${selection.selectedToolIds.length}개`);
+
+  selection.selectedToolIds.forEach((toolId, index) => {
     const tool = findTool(catalog, toolId);
+    if (!tool) {
+      return;
+    }
     const installRoot = getEffectiveInstallRoot(tool, selection);
     const installReferences = getToolInstallReferences(tool);
     const componentIds = selection.componentSelection[toolId] ?? [];
-    const labels = tool.components
-      .filter((c) => componentIds.includes(c.id))
-      .map((c) => `${c.title}(${c.id} → ${path.join(installRoot, getComponentInstallPath(c))})`)
-      .join(', ');
-    console.log(
-      `- ${tool.title}(${tool.id}) [설치 루트: ${installRoot}]: ${labels || '선택된 항목 없음'}`
-    );
+
+    console.log('');
+    console.log(`${index + 1}. ${tool.title} (${tool.id})`);
+    console.log(`   설치 루트 : ${installRoot}`);
+    console.log('   구성요소  :');
+
+    if (componentIds.length === 0) {
+      console.log('    - 선택된 항목 없음');
+    } else {
+      for (const componentId of componentIds) {
+        const component = tool.components.find((candidate) => candidate.id === componentId);
+        if (!component) continue;
+        console.log(
+          `    - ${component.title} (${component.id}) -> ${path.join(
+            installRoot,
+            getComponentInstallPath(component)
+          )}`
+        );
+      }
+    }
+
     if (tool.install_root_basis) {
-      console.log(`  경로 기준: ${tool.install_root_basis}`);
+      console.log(`   경로 기준 : ${tool.install_root_basis}`);
     }
     if (installReferences.length > 0) {
-      console.log(`  참고 문서: ${installReferences.join(', ')}`);
+      console.log('   참고 문서 :');
+      installReferences.forEach((ref) => {
+        console.log(`    - ${ref}`);
+      });
     }
-  }
+  });
 }
 
 async function confirmProceed(yesFlag) {
@@ -1180,9 +1230,23 @@ async function confirmProceed(yesFlag) {
 
   const rl = createInterface({ input, output });
   try {
-    const answer = await rl.question('계속 진행할까요? (y/N)\n> ');
-    const normalized = answer.trim().toLowerCase();
-    return normalized === 'y' || normalized === 'yes';
+    while (true) {
+      console.log('');
+      console.log('진행 여부를 선택해 주세요.');
+      console.log('1) 진행');
+      console.log('2) 취소 (기본값)');
+      const answer = await rl.question('번호를 입력하세요. [기본: 2]\n> ');
+      const normalized = normalizeChoiceInput(answer);
+
+      if (!normalized || normalized === '2' || normalized === '취소' || normalized === '아니오') {
+        return false;
+      }
+      if (normalized === '1' || normalized === '진행' || normalized === '예') {
+        return true;
+      }
+
+      console.log('잘못된 입력입니다. 1 또는 2를 입력해 주세요.');
+    }
   } finally {
     rl.close();
   }
@@ -1289,12 +1353,40 @@ async function runInstallOrUpdate({ catalog, packageData, mode, selection, force
   }
 
   console.log('');
-  console.log('적용 결과');
+  console.log('━━━━━━━━ 적용 결과 ━━━━━━━━');
+  const summaryCounter = {
+    copied: 0,
+    overwritten: 0,
+    skipped: 0,
+    'would-copy': 0,
+    'would-overwrite': 0
+  };
   for (const item of results) {
-    console.log(
-      `- [${item.toolId}] ${item.source} -> ${item.destination}: ${statusLabel(item.status)}`
-    );
+    if (item.status in summaryCounter) {
+      summaryCounter[item.status] += 1;
+    }
+  }
+
+  const groupedResults = new Map();
+  for (const item of results) {
+    const list = groupedResults.get(item.toolId) ?? [];
+    list.push(item);
+    groupedResults.set(item.toolId, list);
+  }
+  for (const toolId of selection.selectedToolIds) {
+    const items = groupedResults.get(toolId) ?? [];
+    if (items.length === 0) continue;
+    console.log(`[${toolId}]`);
+    for (const item of items) {
+      console.log(
+        `  - ${statusIcon(item.status)} ${statusLabel(item.status)} | ${item.source} -> ${item.destination}`
+      );
+    }
   }
+  console.log('');
+  console.log(
+    `요약: 복사 ${summaryCounter.copied} · 업데이트 ${summaryCounter.overwritten} · 건너뜀 ${summaryCounter.skipped} · 복사예정 ${summaryCounter['would-copy']} · 업데이트예정 ${summaryCounter['would-overwrite']}`
+  );
 
   const usageGuidePath = path.join(targetDir, STATE_DIR_NAME, GUIDE_FILE_NAME);
   if (dryRun) {
@@ -1313,46 +1405,61 @@ async function runInstallOrUpdate({ catalog, packageData, mode, selection, force
 
 function printList(catalog) {
   console.log('');
-  console.log(`${CLI_NAME} 카탈로그 (한글)`);
-  console.log('');
-  for (const tool of catalog.tools) {
+  console.log('━━━━━━━━ 도구 카탈로그 ━━━━━━━━');
+  console.log(`CLI: ${CLI_NAME}`);
+
+  catalog.tools.forEach((tool, toolIndex) => {
     const installRoot = getToolInstallRoot(tool);
     const installReferences = getToolInstallReferences(tool);
-    console.log(`- ${tool.title} (${tool.id})`);
-    console.log(`  설명: ${tool.description}`);
-    console.log(`  설치 루트: ${installRoot}`);
+    console.log('');
+    console.log(`${toolIndex + 1}. ${tool.title} (${tool.id})`);
+    console.log(`   설명      : ${tool.description}`);
+    console.log(`   설치 루트 : ${installRoot}`);
     if (tool.install_root_basis) {
-      console.log(`  경로 기준: ${tool.install_root_basis}`);
+      console.log(`   경로 기준 : ${tool.install_root_basis}`);
     }
     if (installReferences.length > 0) {
-      console.log(`  참고 문서: ${installReferences.join(', ')}`);
+      console.log('   참고 문서 :');
+      installReferences.forEach((ref) => {
+        console.log(`    - ${ref}`);
+      });
     }
-    console.log('  구성요소:');
-    for (const component of tool.components) {
+    console.log('   구성요소  :');
+    tool.components.forEach((component) => {
       console.log(
-        `  - ${component.title} (${component.id}): ${component.description} -> ${path.join(
+        `    - ${component.title} (${component.id}) -> ${path.join(
           installRoot,
           getComponentInstallPath(component)
         )}`
       );
-    }
-    console.log('');
-  }
+      if (component.description) {
+        console.log(`      ${component.description}`);
+      }
+    });
+  });
 
   const presets = Array.isArray(catalog.presets) ? catalog.presets : [];
   if (presets.length > 0) {
-    console.log('프리셋 목록');
-    for (const preset of presets) {
-      console.log(`- ${preset.title} (${preset.id})`);
-      console.log(`  설명: ${preset.description}`);
-    }
+    console.log('');
+    console.log('━━━━━━━━ 프리셋 목록 ━━━━━━━━');
+    presets.forEach((preset, index) => {
+      const toolCount = Array.isArray(preset.tools) ? preset.tools.length : 0;
+      console.log(`${index + 1}. ${preset.title} (${preset.id})`);
+      console.log(`   설명      : ${preset.description}`);
+      console.log(`   포함 도구 : ${toolCount}개 (${(preset.tools ?? []).join(', ')})`);
+    });
+    console.log('');
+    console.log('프리셋 사용 예시:');
+    console.log(
+      `  ${CLI_NAME} install --preset balanced-core --target /path/to/project --yes --non-interactive`
+    );
     console.log('');
   }
 
-  console.log('권장 UX 흐름');
-  console.log('1) pnpm dlx tri-agent-manager --interactive 로 시작합니다.');
-  console.log('2) 설치 후 state.json을 기준으로 update를 수행한다.');
-  console.log('3) update 시 필요한 도구만 부분 갱신한다.');
+  console.log('━━━━━━━━ 권장 흐름 ━━━━━━━━');
+  console.log(`1) pnpm dlx ${CLI_NAME} --interactive`);
+  console.log('2) 설치 후 .tri-agent-manager/state.json 기준으로 update');
+  console.log('3) update 시 필요한 도구만 부분 갱신');
 }
 
 async function main() {
@@ -1427,7 +1534,7 @@ async function main() {
     })
   };
 
-  printPlan(catalog, selection, command, selection.targetDir);
+  printPlan(catalog, selection, command, selection.targetDir, options.dryRun);
 
   const proceed = await confirmProceed(options.yes);
   if (!proceed) {
@@ -1445,7 +1552,12 @@ async function main() {
   });
 
   console.log('');
-  console.log('완료: 선택한 운영팩 반영이 끝났습니다.');
+  if (options.dryRun) {
+    console.log('완료: dry-run 계획 확인이 끝났습니다. 실제 반영하려면 --dry-run 없이 다시 실행해 주세요.');
+  } else {
+    console.log('완료: 선택한 운영팩 반영이 끝났습니다.');
+    console.log(`가이드 확인: ${path.join(selection.targetDir, STATE_DIR_NAME, GUIDE_FILE_NAME)}`);
+  }
 }
 
 main().catch((error) => {