@team-semicolon/semo-cli 3.0.3 → 3.0.5

package/dist/index.js

@@ -153,6 +153,50 @@ const LEGACY_MAPPING = {
     design: "biz/design",
     mvp: "biz/poc",
 };
+// 그룹 이름 목록 (biz, eng, ops)
+const PACKAGE_GROUPS = ["biz", "eng", "ops", "meta"];
+// 그룹명 → 해당 그룹의 모든 패키지 반환
+function getPackagesByGroup(group) {
+    return Object.entries(EXTENSION_PACKAGES)
+        .filter(([, pkg]) => pkg.layer === group)
+        .map(([key]) => key);
+}
+// 패키지 입력을 해석 (그룹, 레거시, 쉼표 구분 모두 처리)
+function resolvePackageInput(input) {
+    // 쉼표로 구분된 여러 패키지 처리
+    const parts = input.split(",").map(p => p.trim()).filter(p => p);
+    const resolvedPackages = [];
+    let isGroup = false;
+    let groupName;
+    for (const part of parts) {
+        // 1. 그룹명인지 확인 (biz, eng, ops, meta)
+        if (PACKAGE_GROUPS.includes(part)) {
+            const groupPackages = getPackagesByGroup(part);
+            resolvedPackages.push(...groupPackages);
+            isGroup = true;
+            groupName = part;
+            continue;
+        }
+        // 2. 레거시 매핑 확인
+        if (part in LEGACY_MAPPING) {
+            resolvedPackages.push(LEGACY_MAPPING[part]);
+            continue;
+        }
+        // 3. 직접 패키지명 확인
+        if (part in EXTENSION_PACKAGES) {
+            resolvedPackages.push(part);
+            continue;
+        }
+        // 4. 유효하지 않은 패키지명
+        // (빈 배열 대신 null을 추가하여 나중에 에러 처리)
+    }
+    // 중복 제거
+    return {
+        packages: [...new Set(resolvedPackages)],
+        isGroup,
+        groupName
+    };
+}
 const program = new commander_1.Command();
 program
     .name("semo")
@@ -403,6 +447,148 @@ async function downloadExtensions(cwd, packages, force) {
         console.error(chalk_1.default.red(`   ${error}`));
     }
 }
+// === Orchestrator 병합 파일 생성 ===
+function createMergedOrchestrator(claudeAgentsDir, orchestratorSources) {
+    const orchestratorDir = path.join(claudeAgentsDir, "orchestrator");
+    fs.mkdirSync(orchestratorDir, { recursive: true });
+    // _packages 디렉토리 생성 (원본 참조용)
+    const packagesDir = path.join(orchestratorDir, "_packages");
+    fs.mkdirSync(packagesDir, { recursive: true });
+    // 각 패키지의 orchestrator 내용 수집
+    const routingTables = [];
+    const availableAgents = [];
+    const availableSkills = [];
+    const crossPackageRouting = [];
+    for (const source of orchestratorSources) {
+        const orchestratorMdPath = path.join(source.path, "orchestrator.md");
+        if (!fs.existsSync(orchestratorMdPath))
+            continue;
+        const content = fs.readFileSync(orchestratorMdPath, "utf-8");
+        const pkgShortName = source.pkg.replace(/\//g, "-");
+        // 원본 파일 복사 (참조용)
+        fs.writeFileSync(path.join(packagesDir, `${pkgShortName}.md`), content);
+        // Quick Routing Table 추출
+        const routingMatch = content.match(/## 🔴 Quick Routing Table[\s\S]*?\n\n([\s\S]*?)(?=\n## |$)/);
+        if (routingMatch) {
+            routingTables.push(`### ${EXTENSION_PACKAGES[source.pkg]?.name || source.pkg}\n\n${routingMatch[1].trim()}`);
+        }
+        // Available Agents 추출
+        const agentsMatch = content.match(/## Available Agents[\s\S]*?\n\n([\s\S]*?)(?=\n## |$)/);
+        if (agentsMatch) {
+            availableAgents.push(`### ${EXTENSION_PACKAGES[source.pkg]?.name || source.pkg}\n\n${agentsMatch[1].trim()}`);
+        }
+        // Available Skills 추출
+        const skillsMatch = content.match(/## Available Skills[\s\S]*?\n\n([\s\S]*?)(?=\n## |$)/);
+        if (skillsMatch) {
+            availableSkills.push(`### ${EXTENSION_PACKAGES[source.pkg]?.name || source.pkg}\n\n${skillsMatch[1].trim()}`);
+        }
+        // Cross-Package Routing 추출
+        const crossMatch = content.match(/## 🔄 Cross-Package Routing[\s\S]*?\n\n([\s\S]*?)(?=\n## |$)/);
+        if (crossMatch) {
+            crossPackageRouting.push(crossMatch[1].trim());
+        }
+        // references 폴더가 있으면 복사
+        const refsDir = path.join(source.path, "references");
+        if (fs.existsSync(refsDir)) {
+            const mergedRefsDir = path.join(orchestratorDir, "references");
+            fs.mkdirSync(mergedRefsDir, { recursive: true });
+            const refs = fs.readdirSync(refsDir);
+            for (const ref of refs) {
+                const srcRef = path.join(refsDir, ref);
+                const destRef = path.join(mergedRefsDir, `${pkgShortName}-${ref}`);
+                if (fs.statSync(srcRef).isFile()) {
+                    fs.copyFileSync(srcRef, destRef);
+                }
+            }
+        }
+    }
+    // 병합된 orchestrator.md 생성
+    const mergedContent = `---
+name: orchestrator
+description: |
+  SEMO Merged Orchestrator - Routes all user requests to appropriate agents/skills.
+  This orchestrator combines routing tables from ${orchestratorSources.length} packages.
+  PROACTIVELY delegate on ALL requests. Never process directly.
+tools:
+  - read_file
+  - list_dir
+  - run_command
+  - glob
+  - grep
+  - task
+  - skill
+model: inherit
+---
+
+# SEMO Merged Orchestrator
+
+> 이 파일은 **자동 생성**되었습니다. 직접 수정하지 마세요.
+> 원본 파일: \`_packages/\` 디렉토리 참조
+
+모든 사용자 요청을 분석하고 적절한 Agent 또는 Skill로 라우팅하는 **Primary Router**입니다.
+
+## 🔴 설치된 패키지
+
+${orchestratorSources.map(s => `- **${EXTENSION_PACKAGES[s.pkg]?.name || s.pkg}**: \`semo-system/${s.pkg}\``).join("\n")}
+
+## �� Quick Routing Table (Merged)
+
+> 키워드 매칭 시 **첫 번째 매칭된 패키지**로 라우팅됩니다.
+
+${routingTables.join("\n\n---\n\n")}
+
+## SEMO 메시지 포맷
+
+### Agent 위임
+
+\`\`\`markdown
+[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
+
+[SEMO] Agent 위임: {agent_name} (사유: {reason})
+\`\`\`
+
+### Skill 호출
+
+\`\`\`markdown
+[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
+
+[SEMO] Skill 호출: {skill_name}
+\`\`\`
+
+### 라우팅 실패
+
+\`\`\`markdown
+[SEMO] Orchestrator: 라우팅 실패 → 적절한 Agent/Skill 없음
+
+⚠️ 직접 처리 필요
+\`\`\`
+
+## Critical Rules
+
+1. **Routing-Only**: 직접 작업 수행 금지
+2. **SEMO 메시지 필수**: 모든 위임에 SEMO 메시지 포함
+3. **Package Priority**: 라우팅 충돌 시 설치 순서대로 우선순위 적용
+4. **Cross-Package**: 다른 패키지 전문 영역 요청 시 인계 권유
+
+${crossPackageRouting.length > 0 ? `## 🔄 Cross-Package Routing
+
+${crossPackageRouting[0]}` : ""}
+
+${availableAgents.length > 0 ? `## Available Agents (All Packages)
+
+${availableAgents.join("\n\n")}` : ""}
+
+${availableSkills.length > 0 ? `## Available Skills (All Packages)
+
+${availableSkills.join("\n\n")}` : ""}
+
+## References
+
+- 원본 Orchestrator: \`_packages/\` 디렉토리
+- 병합된 References: \`references/\` 디렉토리
+`;
+    fs.writeFileSync(path.join(orchestratorDir, "orchestrator.md"), mergedContent);
+}
 // === Extensions 심볼릭 링크 설정 (agents/skills 병합) ===
 async function setupExtensionSymlinks(cwd, packages) {
     console.log(chalk_1.default.cyan("\n🔗 Extensions 연결"));
@@ -413,12 +599,12 @@ async function setupExtensionSymlinks(cwd, packages) {
     const claudeSkillsDir = path.join(claudeDir, "skills");
     fs.mkdirSync(claudeAgentsDir, { recursive: true });
     fs.mkdirSync(claudeSkillsDir, { recursive: true });
+    // Orchestrator 소스 수집 (병합용)
+    const orchestratorSources = [];
     for (const pkg of packages) {
         const pkgPath = path.join(semoSystemDir, pkg);
         if (!fs.existsSync(pkgPath))
             continue;
-        // Note: .claude/semo-{pkg} 링크는 생성하지 않음 (불필요)
-        // Extension의 agents/skills만 개별 링크하여 병합
         // 1. Extension의 agents를 .claude/agents/에 개별 링크
         const extAgentsDir = path.join(pkgPath, "agents");
         if (fs.existsSync(extAgentsDir)) {
@@ -426,6 +612,11 @@ async function setupExtensionSymlinks(cwd, packages) {
             for (const agent of agents) {
                 const agentLink = path.join(claudeAgentsDir, agent);
                 const agentTarget = path.join(extAgentsDir, agent);
+                // Orchestrator는 특별 처리 (병합 필요)
+                if (agent === "orchestrator") {
+                    orchestratorSources.push({ pkg, path: agentTarget });
+                    continue; // 심볼릭 링크 생성 안 함
+                }
                 if (!fs.existsSync(agentLink)) {
                     createSymlinkOrJunction(agentTarget, agentLink);
                     console.log(chalk_1.default.green(`  ✓ .claude/agents/${agent} → semo-system/${pkg}/agents/${agent}`));
@@ -446,6 +637,27 @@ async function setupExtensionSymlinks(cwd, packages) {
             }
         }
     }
+    // 3. Orchestrator 병합 처리
+    if (orchestratorSources.length > 0) {
+        // 기존 orchestrator 링크/디렉토리 제거
+        const orchestratorPath = path.join(claudeAgentsDir, "orchestrator");
+        if (fs.existsSync(orchestratorPath)) {
+            removeRecursive(orchestratorPath);
+        }
+        if (orchestratorSources.length === 1) {
+            // 단일 패키지: 심볼릭 링크
+            createSymlinkOrJunction(orchestratorSources[0].path, orchestratorPath);
+            console.log(chalk_1.default.green(`  ✓ .claude/agents/orchestrator → semo-system/${orchestratorSources[0].pkg}/agents/orchestrator`));
+        }
+        else {
+            // 다중 패키지: 병합 파일 생성
+            createMergedOrchestrator(claudeAgentsDir, orchestratorSources);
+            console.log(chalk_1.default.green(`  ✓ .claude/agents/orchestrator (${orchestratorSources.length}개 패키지 병합)`));
+            for (const source of orchestratorSources) {
+                console.log(chalk_1.default.gray(`    - semo-system/${source.pkg}/agents/orchestrator`));
+            }
+        }
+    }
 }
 const BASE_MCP_SERVERS = [
     {
@@ -997,44 +1209,90 @@ ${packageClaudeMdSections}
 }
 // === add 명령어 ===
 program
-    .command("add <package>")
-    .description("Extension 패키지를 추가로 설치합니다")
+    .command("add <packages>")
+    .description("Extension 패키지를 추가로 설치합니다 (그룹: biz, eng, ops / 개별: biz/discovery, eng/nextjs)")
     .option("-f, --force", "기존 설정 덮어쓰기")
-    .action(async (packageName, options) => {
+    .action(async (packagesInput, options) => {
     const cwd = process.cwd();
     const semoSystemDir = path.join(cwd, "semo-system");
     if (!fs.existsSync(semoSystemDir)) {
         console.log(chalk_1.default.red("\nSEMO가 설치되어 있지 않습니다. 'semo init'을 먼저 실행하세요.\n"));
         process.exit(1);
     }
-    // 레거시 패키지 이름 → 새 이름 변환
-    let resolvedPackage = packageName;
-    if (packageName in LEGACY_MAPPING) {
-        resolvedPackage = LEGACY_MAPPING[packageName];
-        console.log(chalk_1.default.yellow(`\n💡 '${packageName}' → '${resolvedPackage}' (v3.0 구조)`));
-    }
-    if (!(resolvedPackage in EXTENSION_PACKAGES)) {
-        console.log(chalk_1.default.red(`\n알 수 없는 패키지: ${packageName}`));
+    // 패키지 입력 해석 (그룹, 레거시, 쉼표 구분 모두 처리)
+    const { packages, isGroup, groupName } = resolvePackageInput(packagesInput);
+    if (packages.length === 0) {
+        console.log(chalk_1.default.red(`\n알 수 없는 패키지: ${packagesInput}`));
+        console.log(chalk_1.default.gray(`사용 가능한 그룹: ${PACKAGE_GROUPS.join(", ")}`));
         console.log(chalk_1.default.gray(`사용 가능한 패키지: ${Object.keys(EXTENSION_PACKAGES).join(", ")}`));
         console.log(chalk_1.default.gray(`레거시 별칭: ${Object.keys(LEGACY_MAPPING).join(", ")}\n`));
         process.exit(1);
     }
-    packageName = resolvedPackage;
-    const pkgPath = path.join(semoSystemDir, packageName);
-    if (fs.existsSync(pkgPath) && !options.force) {
-        console.log(chalk_1.default.yellow(`\n${EXTENSION_PACKAGES[packageName].name} 패키지가 이미 설치되어 있습니다.`));
-        console.log(chalk_1.default.gray("강제 재설치: semo add " + packageName + " --force\n"));
+    // 그룹 설치인 경우 안내
+    if (isGroup) {
+        console.log(chalk_1.default.cyan.bold(`\n📦 ${groupName?.toUpperCase()} 그룹 패키지 일괄 설치\n`));
+        console.log(chalk_1.default.gray("   포함된 패키지:"));
+        for (const pkg of packages) {
+            console.log(chalk_1.default.gray(`   - ${pkg} (${EXTENSION_PACKAGES[pkg].name})`));
+        }
+        console.log();
+    }
+    else if (packages.length === 1) {
+        // 단일 패키지
+        const pkg = packages[0];
+        console.log(chalk_1.default.cyan(`\n📦 ${EXTENSION_PACKAGES[pkg].name} 패키지 설치\n`));
+        console.log(chalk_1.default.gray(`   ${EXTENSION_PACKAGES[pkg].desc}\n`));
+    }
+    else {
+        // 여러 패키지 (쉼표 구분)
+        console.log(chalk_1.default.cyan.bold(`\n📦 ${packages.length}개 패키지 설치\n`));
+        for (const pkg of packages) {
+            console.log(chalk_1.default.gray(`   - ${pkg} (${EXTENSION_PACKAGES[pkg].name})`));
+        }
+        console.log();
+    }
+    // 이미 설치된 패키지 확인
+    const alreadyInstalled = [];
+    const toInstall = [];
+    for (const pkg of packages) {
+        const pkgPath = path.join(semoSystemDir, pkg);
+        if (fs.existsSync(pkgPath) && !options.force) {
+            alreadyInstalled.push(pkg);
+        }
+        else {
+            toInstall.push(pkg);
+        }
+    }
+    if (alreadyInstalled.length > 0) {
+        console.log(chalk_1.default.yellow("⚠ 이미 설치된 패키지 (건너뜀):"));
+        for (const pkg of alreadyInstalled) {
+            console.log(chalk_1.default.yellow(`   - ${pkg}`));
+        }
+        console.log(chalk_1.default.gray("   강제 재설치: semo add " + packagesInput + " --force\n"));
+    }
+    if (toInstall.length === 0) {
+        console.log(chalk_1.default.yellow("\n모든 패키지가 이미 설치되어 있습니다.\n"));
         return;
     }
-    console.log(chalk_1.default.cyan(`\n📦 ${EXTENSION_PACKAGES[packageName].name} 패키지 설치\n`));
-    console.log(chalk_1.default.gray(`   ${EXTENSION_PACKAGES[packageName].desc}\n`));
     // 1. 다운로드
-    await downloadExtensions(cwd, [packageName], options.force);
+    await downloadExtensions(cwd, toInstall, options.force);
     // 2. settings.json 병합
-    await mergeExtensionSettings(cwd, [packageName]);
-    // 3. 심볼릭 링크 설정
-    await setupExtensionSymlinks(cwd, [packageName]);
-    console.log(chalk_1.default.green.bold(`\n✅ ${EXTENSION_PACKAGES[packageName].name} 패키지 설치 완료!\n`));
+    await mergeExtensionSettings(cwd, toInstall);
+    // 3. 심볼릭 링크 설정 (모든 설치된 패키지 포함하여 orchestrator 병합)
+    const allInstalledPackages = [...new Set([...alreadyInstalled, ...toInstall])];
+    await setupExtensionSymlinks(cwd, allInstalledPackages);
+    // 4. CLAUDE.md 재생성 (모든 설치된 패키지 반영)
+    await setupClaudeMd(cwd, allInstalledPackages, options.force);
+    if (toInstall.length === 1) {
+        console.log(chalk_1.default.green.bold(`\n✅ ${EXTENSION_PACKAGES[toInstall[0]].name} 패키지 설치 완료!\n`));
+    }
+    else {
+        console.log(chalk_1.default.green.bold(`\n✅ ${toInstall.length}개 패키지 설치 완료!`));
+        for (const pkg of toInstall) {
+            console.log(chalk_1.default.green(`   ✓ ${EXTENSION_PACKAGES[pkg].name}`));
+        }
+        console.log();
+    }
 });
 // === list 명령어 ===
 program
@@ -1072,6 +1330,13 @@ program
         }
         console.log();
     }
+    // 그룹 설치 안내
+    console.log(chalk_1.default.gray("─".repeat(50)));
+    console.log(chalk_1.default.white.bold("📦 그룹 일괄 설치"));
+    console.log(chalk_1.default.gray("  semo add biz      → Business 전체 (discovery, design, management, poc)"));
+    console.log(chalk_1.default.gray("  semo add eng      → Engineering 전체 (nextjs, spring, ms, infra)"));
+    console.log(chalk_1.default.gray("  semo add ops      → Operations 전체 (qa, monitor, improve)"));
+    console.log();
     // 레거시 호환성 안내
     console.log(chalk_1.default.gray("─".repeat(50)));
     console.log(chalk_1.default.gray("레거시 명령어도 지원됩니다:"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@team-semicolon/semo-cli",
-  "version": "3.0.3",
+  "version": "3.0.5",
   "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
   "main": "dist/index.js",
   "bin": {