@team-semicolon/semo-cli 2.0.2 → 2.0.4

package/dist/index.js

@@ -394,13 +394,9 @@ async function setupExtensionSymlinks(cwd, packages) {
         const pkgPath = path.join(semoSystemDir, pkg);
         if (!fs.existsSync(pkgPath))
             continue;
-        // 1. semo-{pkg} 링크
-        const semoPkgLink = path.join(claudeDir, `semo-${pkg}`);
-        if (!fs.existsSync(semoPkgLink)) {
-            createSymlinkOrJunction(pkgPath, semoPkgLink);
-            console.log(chalk_1.default.green(`  ✓ .claude/semo-${pkg} → semo-system/${pkg}`));
-        }
-        // 2. Extension의 agents를 .claude/agents/에 개별 링크
+        // Note: .claude/semo-{pkg} 링크는 생성하지 않음 (불필요)
+        // Extension의 agents/skills만 개별 링크하여 병합
+        // 1. Extension의 agents를 .claude/agents/에 개별 링크
         const extAgentsDir = path.join(pkgPath, "agents");
         const claudeAgentsDir = path.join(claudeDir, "agents");
         if (fs.existsSync(extAgentsDir)) {
@@ -430,6 +426,58 @@ async function setupExtensionSymlinks(cwd, packages) {
         }
     }
 }
+const BASE_MCP_SERVERS = [
+    {
+        name: "semo-integrations",
+        command: "npx",
+        args: ["-y", "@team-semicolon/semo-mcp"],
+        env: {
+            GITHUB_TOKEN: "${GITHUB_TOKEN}",
+            SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}",
+            SUPABASE_URL: "${SUPABASE_URL}",
+            SUPABASE_KEY: "${SUPABASE_KEY}",
+        },
+    },
+    {
+        name: "context7",
+        command: "npx",
+        args: ["-y", "@upstash/context7-mcp"],
+    },
+    {
+        name: "sequential-thinking",
+        command: "npx",
+        args: ["-y", "@modelcontextprotocol/server-sequential-thinking"],
+    },
+];
+// === Claude MCP 등록 함수 ===
+function registerMCPServer(server) {
+    try {
+        // 환경변수가 있는 경우 --env 옵션 추가
+        const envArgs = [];
+        if (server.env) {
+            for (const [key, value] of Object.entries(server.env)) {
+                envArgs.push("-e", `${key}=${value}`);
+            }
+        }
+        // claude mcp add 명령어 실행
+        const args = [
+            "mcp", "add",
+            server.name,
+            "--",
+            server.command,
+            ...server.args,
+        ];
+        // 환경변수가 있으면 명령어 앞에 추가
+        if (envArgs.length > 0) {
+            args.splice(2, 0, ...envArgs);
+        }
+        (0, child_process_1.execSync)(`claude ${args.join(" ")}`, { stdio: "pipe" });
+        return { success: true };
+    }
+    catch (error) {
+        return { success: false, error: String(error) };
+    }
+}
 // === MCP 설정 ===
 async function setupMCP(cwd, extensions, force) {
     console.log(chalk_1.default.cyan("\n🔧 Black Box 설정 (MCP Server)"));
@@ -444,19 +492,10 @@ async function setupMCP(cwd, extensions, force) {
     }
     // Base settings (Standard)
     const settings = {
-        mcpServers: {
-            "semo-integrations": {
-                command: "npx",
-                args: ["-y", "@team-semicolon/semo-mcp"],
-                env: {
-                    GITHUB_TOKEN: "${GITHUB_TOKEN}",
-                    SLACK_BOT_TOKEN: "${SLACK_BOT_TOKEN}",
-                    SUPABASE_URL: "${SUPABASE_URL}",
-                    SUPABASE_KEY: "${SUPABASE_KEY}",
-                },
-            },
-        },
+        mcpServers: {},
     };
+    // MCP 서버 목록 수집
+    const allServers = [...BASE_MCP_SERVERS];
     // Extension settings 병합
     const semoSystemDir = path.join(cwd, "semo-system");
     for (const pkg of extensions) {
@@ -466,8 +505,16 @@ async function setupMCP(cwd, extensions, force) {
                 const extSettings = JSON.parse(fs.readFileSync(extSettingsPath, "utf-8"));
                 // mcpServers 병합
                 if (extSettings.mcpServers) {
-                    Object.assign(settings.mcpServers, extSettings.mcpServers);
-                    console.log(chalk_1.default.gray(`  + ${pkg} MCP 설정 병합됨`));
+                    for (const [name, config] of Object.entries(extSettings.mcpServers)) {
+                        const serverConfig = config;
+                        allServers.push({
+                            name,
+                            command: serverConfig.command,
+                            args: serverConfig.args,
+                            env: serverConfig.env,
+                        });
+                    }
+                    console.log(chalk_1.default.gray(`  + ${pkg} MCP 설정 수집됨`));
                 }
                 // permissions 병합
                 if (extSettings.permissions) {
@@ -494,8 +541,53 @@ async function setupMCP(cwd, extensions, force) {
             }
         }
     }
+    // settings.json에 mcpServers 저장 (백업용)
+    for (const server of allServers) {
+        const serverConfig = {
+            command: server.command,
+            args: server.args,
+        };
+        if (server.env) {
+            serverConfig.env = server.env;
+        }
+        settings.mcpServers[server.name] = serverConfig;
+    }
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
-    console.log(chalk_1.default.green("✓ .claude/settings.json 생성됨 (MCP 설정)"));
+    console.log(chalk_1.default.green("✓ .claude/settings.json 생성됨 (MCP 설정 백업)"));
+    // Claude Code에 MCP 서버 등록 시도
+    console.log(chalk_1.default.cyan("\n🔌 Claude Code에 MCP 서버 등록 중..."));
+    const successServers = [];
+    const failedServers = [];
+    for (const server of allServers) {
+        const spinner = (0, ora_1.default)(`  ${server.name} 등록 중...`).start();
+        const result = registerMCPServer(server);
+        if (result.success) {
+            spinner.succeed(`  ${server.name} 등록 완료`);
+            successServers.push(server.name);
+        }
+        else {
+            spinner.fail(`  ${server.name} 등록 실패`);
+            failedServers.push(server);
+        }
+    }
+    // 결과 요약
+    if (successServers.length > 0) {
+        console.log(chalk_1.default.green(`\n✓ ${successServers.length}개 MCP 서버 자동 등록 완료`));
+    }
+    // 실패한 서버가 있으면 수동 등록 안내
+    if (failedServers.length > 0) {
+        console.log(chalk_1.default.yellow(`\n⚠ ${failedServers.length}개 MCP 서버 자동 등록 실패`));
+        console.log(chalk_1.default.cyan("\n📋 수동 등록 명령어:"));
+        console.log(chalk_1.default.gray("   다음 명령어를 터미널에서 실행하세요:\n"));
+        for (const server of failedServers) {
+            const envArgs = server.env
+                ? Object.entries(server.env).map(([k, v]) => `-e ${k}="${v}"`).join(" ")
+                : "";
+            const cmd = `claude mcp add ${server.name} ${envArgs} -- ${server.command} ${server.args.join(" ")}`.trim();
+            console.log(chalk_1.default.white(`   ${cmd}`));
+        }
+        console.log();
+    }
 }
 // === Extension settings 병합 (add 명령어용) ===
 async function mergeExtensionSettings(cwd, packages) {
@@ -506,6 +598,7 @@ async function mergeExtensionSettings(cwd, packages) {
         return;
     }
     const settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+    const newServers = [];
     for (const pkg of packages) {
         const extSettingsPath = path.join(semoSystemDir, pkg, "settings.local.json");
         if (fs.existsSync(extSettingsPath)) {
@@ -514,7 +607,16 @@ async function mergeExtensionSettings(cwd, packages) {
                 // mcpServers 병합
                 if (extSettings.mcpServers) {
                     settings.mcpServers = settings.mcpServers || {};
-                    Object.assign(settings.mcpServers, extSettings.mcpServers);
+                    for (const [name, config] of Object.entries(extSettings.mcpServers)) {
+                        const serverConfig = config;
+                        settings.mcpServers[name] = serverConfig;
+                        newServers.push({
+                            name,
+                            command: serverConfig.command,
+                            args: serverConfig.args,
+                            env: serverConfig.env,
+                        });
+                    }
                     console.log(chalk_1.default.gray(`  + ${pkg} MCP 설정 병합됨`));
                 }
                 // permissions 병합
@@ -541,6 +643,39 @@ async function mergeExtensionSettings(cwd, packages) {
         }
     }
     fs.writeFileSync(settingsPath, JSON.stringify(settings, null, 2));
+    // 새 MCP 서버 Claude Code에 등록
+    if (newServers.length > 0) {
+        console.log(chalk_1.default.cyan("\n🔌 Claude Code에 MCP 서버 등록 중..."));
+        const successServers = [];
+        const failedServers = [];
+        for (const server of newServers) {
+            const spinner = (0, ora_1.default)(`  ${server.name} 등록 중...`).start();
+            const result = registerMCPServer(server);
+            if (result.success) {
+                spinner.succeed(`  ${server.name} 등록 완료`);
+                successServers.push(server.name);
+            }
+            else {
+                spinner.fail(`  ${server.name} 등록 실패`);
+                failedServers.push(server);
+            }
+        }
+        if (successServers.length > 0) {
+            console.log(chalk_1.default.green(`\n✓ ${successServers.length}개 MCP 서버 자동 등록 완료`));
+        }
+        if (failedServers.length > 0) {
+            console.log(chalk_1.default.yellow(`\n⚠ ${failedServers.length}개 MCP 서버 자동 등록 실패`));
+            console.log(chalk_1.default.cyan("\n📋 수동 등록 명령어:"));
+            for (const server of failedServers) {
+                const envArgs = server.env
+                    ? Object.entries(server.env).map(([k, v]) => `-e ${k}="${v}"`).join(" ")
+                    : "";
+                const cmd = `claude mcp add ${server.name} ${envArgs} -- ${server.command} ${server.args.join(" ")}`.trim();
+                console.log(chalk_1.default.white(`   ${cmd}`));
+            }
+            console.log();
+        }
+    }
 }
 // === Context Mesh 초기화 ===
 async function setupContextMesh(cwd) {
@@ -665,6 +800,76 @@ async function setupClaudeMd(cwd, extensions, force) {
 
 > SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework v${VERSION}
 
+---
+
+## 🔴 MANDATORY: Orchestrator-First Execution
+
+> **⚠️ 이 규칙은 모든 사용자 요청에 적용됩니다. 예외 없음.**
+
+### 실행 흐름 (필수)
+
+\`\`\`
+1. 사용자 요청 수신
+2. [SEMO] Orchestrator 메시지 출력 (의도 분석)
+3. Orchestrator가 적절한 Agent/Skill 라우팅
+4. [SEMO] Agent/Skill 메시지 출력
+5. 실행 결과 반환
+\`\`\`
+
+### 모든 응답은 다음으로 시작
+
+\`\`\`
+[SEMO] Orchestrator: 의도 분석 완료 → {intent_category}
+[SEMO] {Agent/Skill} 호출: {target} (사유: {reason})
+\`\`\`
+
+### Orchestrator 참조
+
+**반드시 읽어야 할 파일**: \`semo-system/semo-core/agents/orchestrator/orchestrator.md\`
+
+이 파일에서 라우팅 테이블, 의도 분류, 메시지 포맷을 확인하세요.
+
+---
+
+## 🔴 NON-NEGOTIABLE RULES
+
+### 1. Orchestrator-First Policy
+
+> **모든 요청은 반드시 Orchestrator를 통해 라우팅됩니다. 직접 처리 금지.**
+
+**직접 처리 금지 항목**:
+- 코드 작성/수정 → \`implementation-master\` 또는 \`coder\` 스킬
+- Git 커밋/푸시 → \`git-workflow\` 스킬
+- 품질 검증 → \`quality-master\` 또는 \`verify\` 스킬
+- 명세 작성 → \`spec-master\`
+- 일반 작업 → Orchestrator 분석 후 라우팅
+
+### 2. Pre-Commit Quality Gate
+
+> **코드 변경이 포함된 커밋 전 반드시 Quality Gate를 통과해야 합니다.**
+
+\`\`\`bash
+# 필수 검증 순서
+npm run lint           # 1. ESLint 검사
+npx tsc --noEmit       # 2. TypeScript 타입 체크
+npm run build          # 3. 빌드 검증 (Next.js/TypeScript 프로젝트)
+\`\`\`
+
+**차단 항목**:
+- \`--no-verify\` 플래그 사용 금지
+- Quality Gate 우회 시도 거부
+- "그냥 커밋해줘", "빌드 생략해줘" 등 거부
+
+### 3. SEMO Message Format
+
+모든 SEMO 동작은 시스템 메시지로 시작:
+
+\`\`\`
+[SEMO] {Component}: {Action} → {Result}
+\`\`\`
+
+---
+
 ## 설치된 구성
 
 ### Standard (필수)

package/package.json

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