@team-semicolon/semo-cli 3.5.0 → 3.7.0

package/dist/index.js

@@ -235,48 +235,9 @@ async function showVersionComparison(cwd) {
                 level: 0,
             });
         }
-        // 그룹 패키지 (eng, biz, ops) 및 하위 Extension - semo-system 내부
-        // 그룹별로 묶어서 계층 구조로 출력
+        // Extension 패키지들 (meta, semo-hooks, semo-remote 등) - semo-system 내부
         if (hasSemoSystem) {
-            for (const group of PACKAGE_GROUPS) {
-                const groupVersionPath = path.join(semoSystemDir, group, "VERSION");
-                const hasGroupVersion = fs.existsSync(groupVersionPath);
-                // 해당 그룹의 하위 패키지 찾기
-                const groupExtensions = Object.keys(EXTENSION_PACKAGES).filter(key => key.startsWith(`${group}/`));
-                const installedGroupExtensions = groupExtensions.filter(key => fs.existsSync(path.join(semoSystemDir, key, "VERSION")));
-                // 그룹 버전이 있거나 하위 패키지가 설치된 경우에만 표시
-                if (hasGroupVersion || installedGroupExtensions.length > 0) {
-                    // 그룹 패키지 버전 추가
-                    if (hasGroupVersion) {
-                        const localGroup = fs.readFileSync(groupVersionPath, "utf-8").trim();
-                        const remoteGroup = await getRemotePackageVersion(group);
-                        versionInfos.push({
-                            name: group,
-                            local: localGroup,
-                            remote: remoteGroup,
-                            needsUpdate: remoteGroup ? isVersionLower(localGroup, remoteGroup) : false,
-                            level: 1,
-                        });
-                    }
-                    // 하위 Extension 패키지들 추가
-                    for (const key of installedGroupExtensions) {
-                        const extVersionPath = path.join(semoSystemDir, key, "VERSION");
-                        const localExt = fs.readFileSync(extVersionPath, "utf-8").trim();
-                        const remoteExt = await getRemotePackageVersion(key);
-                        versionInfos.push({
-                            name: key,
-                            local: localExt,
-                            remote: remoteExt,
-                            needsUpdate: remoteExt ? isVersionLower(localExt, remoteExt) : false,
-                            level: 2,
-                            group: group,
-                        });
-                    }
-                }
-            }
-            // 그룹에 속하지 않는 Extension (meta 등)
-            const nonGroupExtensions = Object.keys(EXTENSION_PACKAGES).filter(key => !PACKAGE_GROUPS.some(g => key.startsWith(`${g}/`)));
-            for (const key of nonGroupExtensions) {
+            for (const key of Object.keys(EXTENSION_PACKAGES)) {
                 const extVersionPath = path.join(semoSystemDir, key, "VERSION");
                 if (fs.existsSync(extVersionPath)) {
                     const localExt = fs.readFileSync(extVersionPath, "utf-8").trim();
@@ -650,92 +611,39 @@ function copyRecursive(src, dest) {
     }
 }
 const SEMO_REPO = "https://github.com/semicolon-devteam/semo.git";
-// 확장 패키지 정의 (v3.0 구조)
+// Extension 패키지 정의 (통합 구조)
 const EXTENSION_PACKAGES = {
-    // Business Layer
-    "biz/discovery": { name: "Discovery", desc: "아이템 발굴, 시장 조사, Epic/Task", layer: "biz", detect: [] },
-    "biz/design": { name: "Design", desc: "컨셉 설계, 목업, UX", layer: "biz", detect: [] },
-    "biz/management": { name: "Management", desc: "일정/인력/스프린트 관리", layer: "biz", detect: [] },
-    "biz/poc": { name: "PoC", desc: "빠른 PoC, 패스트트랙", layer: "biz", detect: [] },
-    // Engineering Layer
-    "eng/nextjs": { name: "Next.js", desc: "Next.js 프론트엔드 개발", layer: "eng", detect: ["next.config.js", "next.config.mjs", "next.config.ts"] },
-    "eng/spring": { name: "Spring", desc: "Spring Boot 백엔드 개발", layer: "eng", detect: ["pom.xml", "build.gradle"] },
-    "eng/ms": { name: "Microservice", desc: "마이크로서비스 아키텍처", layer: "eng", detect: [] },
-    "eng/infra": { name: "Infra", desc: "인프라/배포 관리", layer: "eng", detect: ["docker-compose.yml", "Dockerfile"] },
-    // Operations Layer
-    "ops/qa": { name: "QA", desc: "테스트/품질 관리", layer: "ops", detect: [] },
-    "ops/monitor": { name: "Monitor", desc: "서비스 현황 모니터링", layer: "ops", detect: [] },
-    "ops/improve": { name: "Improve", desc: "개선 제안", layer: "ops", detect: [] },
-    // Meta
-    meta: { name: "Meta", desc: "SEMO 프레임워크 자체 개발/관리", layer: "meta", detect: ["semo-core", "semo-skills"] },
-    // System (semo-system 하위 패키지)
-    "semo-hooks": { name: "Hooks", desc: "Claude Code Hooks 기반 로깅 시스템", layer: "system", detect: [] },
-    "semo-remote": { name: "Remote", desc: "Claude Code 원격 제어 (모바일 PWA)", layer: "system", detect: [] },
+    meta: { name: "Meta", desc: "SEMO 프레임워크 자체 개발/관리" },
+    "semo-hooks": { name: "Hooks", desc: "Claude Code Hooks 기반 로깅 시스템" },
+    "semo-remote": { name: "Remote", desc: "Claude Code 원격 제어 (모바일 PWA)" },
 };
 // 단축명 → 전체 패키지 경로 매핑
 const SHORTNAME_MAPPING = {
-    // 하위 패키지명 단축 (discovery → biz/discovery)
-    discovery: "biz/discovery",
-    design: "biz/design",
-    management: "biz/management",
-    poc: "biz/poc",
-    nextjs: "eng/nextjs",
-    spring: "eng/spring",
-    ms: "eng/ms",
-    infra: "eng/infra",
-    qa: "ops/qa",
-    monitor: "ops/monitor",
-    improve: "ops/improve",
-    // 추가 별칭
-    next: "eng/nextjs",
-    backend: "eng/spring",
-    mvp: "biz/poc",
-    // System 패키지 단축명
     hooks: "semo-hooks",
     remote: "semo-remote",
 };
-// 그룹 이름 목록 (biz, eng, ops, meta, system)
-const PACKAGE_GROUPS = ["biz", "eng", "ops", "meta", "system"];
-// 그룹명 → 해당 그룹의 모든 패키지 반환
-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. 단축명 매핑 확인 (discovery → biz/discovery 등)
+        // 1. 단축명 매핑 확인 (hooks → semo-hooks 등)
         if (part in SHORTNAME_MAPPING) {
             resolvedPackages.push(SHORTNAME_MAPPING[part]);
             continue;
         }
-        // 3. 직접 패키지명 확인
+        // 2. 직접 패키지명 확인
         if (part in EXTENSION_PACKAGES) {
             resolvedPackages.push(part);
             continue;
         }
-        // 4. 유효하지 않은 패키지명
+        // 3. 유효하지 않은 패키지명
         // (빈 배열 대신 null을 추가하여 나중에 에러 처리)
     }
     // 중복 제거
     return {
         packages: [...new Set(resolvedPackages)],
-        isGroup,
-        groupName
     };
 }
 const program = new commander_1.Command();
@@ -796,47 +704,10 @@ async function showVersionInfo() {
             level: 0,
         });
     }
-    // 4. 그룹 패키지 (eng, biz, ops) 및 하위 Extension - semo-system 내부
+    // 4. Extension 패키지들 (meta, semo-hooks, semo-remote 등) - semo-system 내부
     const semoSystemDir = path.join(cwd, "semo-system");
     if (fs.existsSync(semoSystemDir)) {
-        for (const group of PACKAGE_GROUPS) {
-            const groupVersionPath = path.join(semoSystemDir, group, "VERSION");
-            const hasGroupVersion = fs.existsSync(groupVersionPath);
-            // 해당 그룹의 하위 패키지 찾기
-            const groupExtensions = Object.keys(EXTENSION_PACKAGES).filter(key => key.startsWith(`${group}/`));
-            const installedGroupExtensions = groupExtensions.filter(key => fs.existsSync(path.join(semoSystemDir, key, "VERSION")));
-            if (hasGroupVersion || installedGroupExtensions.length > 0) {
-                // 그룹 패키지 버전 추가
-                if (hasGroupVersion) {
-                    const localGroup = fs.readFileSync(groupVersionPath, "utf-8").trim();
-                    const remoteGroup = await getRemotePackageVersion(group);
-                    versionInfos.push({
-                        name: group,
-                        local: localGroup,
-                        remote: remoteGroup,
-                        needsUpdate: remoteGroup ? isVersionLower(localGroup, remoteGroup) : false,
-                        level: 1,
-                    });
-                }
-                // 하위 Extension 패키지들 추가
-                for (const key of installedGroupExtensions) {
-                    const extVersionPath = path.join(semoSystemDir, key, "VERSION");
-                    const localExt = fs.readFileSync(extVersionPath, "utf-8").trim();
-                    const remoteExt = await getRemotePackageVersion(key);
-                    versionInfos.push({
-                        name: key,
-                        local: localExt,
-                        remote: remoteExt,
-                        needsUpdate: remoteExt ? isVersionLower(localExt, remoteExt) : false,
-                        level: 2,
-                        group: group,
-                    });
-                }
-            }
-        }
-        // 그룹에 속하지 않는 Extension (meta 등)
-        const nonGroupExtensions = Object.keys(EXTENSION_PACKAGES).filter(key => !PACKAGE_GROUPS.some(g => key.startsWith(`${g}/`)));
-        for (const key of nonGroupExtensions) {
+        for (const key of Object.keys(EXTENSION_PACKAGES)) {
             const extVersionPath = path.join(semoSystemDir, key, "VERSION");
             if (fs.existsSync(extVersionPath)) {
                 const localExt = fs.readFileSync(extVersionPath, "utf-8").trim();
@@ -995,18 +866,6 @@ async function confirmOverwrite(itemName, itemPath) {
     ]);
     return shouldOverwrite;
 }
-function detectProjectType(cwd) {
-    const detected = [];
-    for (const [key, pkg] of Object.entries(EXTENSION_PACKAGES)) {
-        for (const file of pkg.detect) {
-            if (fs.existsSync(path.join(cwd, file))) {
-                detected.push(key);
-                break;
-            }
-        }
-    }
-    return detected;
-}
 // === 설치된 Extension 패키지 스캔 ===
 function getInstalledExtensions(cwd) {
     const semoSystemDir = path.join(cwd, "semo-system");
@@ -1136,56 +995,17 @@ program
         spinner.fail("Git 레포지토리가 아닙니다. 'git init'을 먼저 실행하세요.");
         process.exit(1);
     }
-    // 2. 프로젝트 유형 감지
-    const detected = detectProjectType(cwd);
+    // 2. Extension 패키지 처리 (--with 옵션으로만 지정 가능)
     let extensionsToInstall = [];
     if (options.with) {
         extensionsToInstall = options.with.split(",").map((p) => p.trim()).filter((p) => p in EXTENSION_PACKAGES);
-    }
-    else if (detected.length > 0) {
-        console.log(chalk_1.default.cyan("\n📦 감지된 프로젝트 유형:"));
-        detected.forEach(pkg => {
-            console.log(chalk_1.default.gray(`   - ${EXTENSION_PACKAGES[pkg].name}: ${EXTENSION_PACKAGES[pkg].desc}`));
-        });
-        const { installDetected } = await inquirer_1.default.prompt([
-            {
-                type: "confirm",
-                name: "installDetected",
-                message: "감지된 패키지를 함께 설치할까요?",
-                default: true,
-            },
-        ]);
-        if (installDetected) {
-            extensionsToInstall = detected;
+        if (extensionsToInstall.length > 0) {
+            console.log(chalk_1.default.cyan("\n📦 추가 Extension 설치:"));
+            extensionsToInstall.forEach(pkg => {
+                console.log(chalk_1.default.gray(`   - ${EXTENSION_PACKAGES[pkg].name}: ${EXTENSION_PACKAGES[pkg].desc}`));
+            });
         }
     }
-    else {
-        // 프로젝트 유형이 감지되지 않은 경우 패키지 선택 프롬프트
-        console.log(chalk_1.default.cyan("\n📦 추가 패키지 선택"));
-        console.log(chalk_1.default.gray("   기본 설치 (semo-core + semo-skills) 외에 추가할 패키지를 선택하세요.\n"));
-        // 그룹별로 패키지 구성
-        const packageChoices = [
-            new inquirer_1.default.Separator(chalk_1.default.yellow("── Engineering ──")),
-            { name: `eng/nextjs - ${EXTENSION_PACKAGES["eng/nextjs"].desc}`, value: "eng/nextjs" },
-            { name: `eng/spring - ${EXTENSION_PACKAGES["eng/spring"].desc}`, value: "eng/spring" },
-            { name: `eng/infra - ${EXTENSION_PACKAGES["eng/infra"].desc}`, value: "eng/infra" },
-            new inquirer_1.default.Separator(chalk_1.default.yellow("── Business ──")),
-            { name: `biz/discovery - ${EXTENSION_PACKAGES["biz/discovery"].desc}`, value: "biz/discovery" },
-            { name: `biz/management - ${EXTENSION_PACKAGES["biz/management"].desc}`, value: "biz/management" },
-            { name: `biz/design - ${EXTENSION_PACKAGES["biz/design"].desc}`, value: "biz/design" },
-            new inquirer_1.default.Separator(chalk_1.default.yellow("── Operations ──")),
-            { name: `ops/qa - ${EXTENSION_PACKAGES["ops/qa"].desc}`, value: "ops/qa" },
-        ];
-        const { selectedPackages } = await inquirer_1.default.prompt([
-            {
-                type: "checkbox",
-                name: "selectedPackages",
-                message: "설치할 패키지 선택 (Space로 선택, Enter로 완료):",
-                choices: packageChoices,
-            },
-        ]);
-        extensionsToInstall = selectedPackages;
-    }
     // 3. .claude 디렉토리 생성
     const claudeDir = path.join(cwd, ".claude");
     if (!fs.existsSync(claudeDir)) {
@@ -1238,12 +1058,22 @@ program
             console.log(chalk_1.default.gray(`    ✓ ${EXTENSION_PACKAGES[pkg].name}`));
         });
     }
+    // GitHub MCP 토큰 설정 안내
+    if (!isGitHubTokenConfigured()) {
+        console.log(chalk_1.default.yellow("\n⚠️  GitHub MCP 설정 필요"));
+        console.log(chalk_1.default.gray("   GitHub 이슈/PR 생성 기능을 사용하려면 토큰을 설정하세요:"));
+        console.log(chalk_1.default.white("\n   export GITHUB_PERSONAL_ACCESS_TOKEN=\"$(gh auth token)\""));
+        console.log(chalk_1.default.gray("\n   영구 설정: ~/.zshrc 또는 ~/.bashrc에 위 명령어 추가"));
+    }
+    else {
+        console.log(chalk_1.default.green("\n✓ GitHub 토큰 감지됨 (MCP 사용 가능)"));
+    }
     console.log(chalk_1.default.cyan("\n다음 단계:"));
     console.log(chalk_1.default.gray("  1. Claude Code에서 프로젝트 열기"));
     console.log(chalk_1.default.gray("  2. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
     console.log(chalk_1.default.gray("  3. /SEMO:help로 도움말 확인"));
-    if (extensionsToInstall.length === 0 && detected.length === 0) {
-        console.log(chalk_1.default.gray("\n💡 추가 패키지: semo add <package> (예: semo add next)"));
+    if (extensionsToInstall.length === 0) {
+        console.log(chalk_1.default.gray("\n💡 추가 패키지: semo add <package> (예: semo add meta)"));
     }
     console.log();
 });
@@ -1854,8 +1684,29 @@ const BASE_MCP_SERVERS = [
         name: "github",
         command: "npx",
         args: ["-y", "@modelcontextprotocol/server-github"],
+        env: {
+            GITHUB_PERSONAL_ACCESS_TOKEN: "${GITHUB_PERSONAL_ACCESS_TOKEN}",
+        },
     },
 ];
+// === GitHub 토큰 자동 감지 ===
+function getGitHubTokenFromCLI() {
+    try {
+        const token = (0, child_process_1.execSync)("gh auth token", { stdio: "pipe", encoding: "utf-8" }).trim();
+        return token || null;
+    }
+    catch {
+        return null;
+    }
+}
+function isGitHubTokenConfigured() {
+    // 환경변수 확인
+    if (process.env.GITHUB_PERSONAL_ACCESS_TOKEN) {
+        return true;
+    }
+    // gh CLI 토큰 확인
+    return getGitHubTokenFromCLI() !== null;
+}
 // === Claude MCP 서버 존재 여부 확인 ===
 function isMCPServerRegistered(serverName) {
     try {
@@ -2493,27 +2344,9 @@ async function setupClaudeMd(cwd, extensions, force) {
     const extensionsList = extensions.length > 0
         ? extensions.map(pkg => `├── ${pkg}/              # ${EXTENSION_PACKAGES[pkg].name}`).join("\n")
         : "";
-    // 그룹 및 패키지별 CLAUDE.md 병합 섹션 생성
+    // 패키지별 CLAUDE.md 병합 섹션 생성
     let packageClaudeMdSections = "";
-    // 1. 설치된 패키지에서 그룹 추출 (중복 제거)
-    const installedGroups = [...new Set(extensions.map(pkg => pkg.split("/")[0]).filter(g => PACKAGE_GROUPS.includes(g)))];
-    // 2. 그룹 레벨 CLAUDE.md 먼저 병합 (biz, eng, ops) - 중복 제거 적용
-    for (const group of installedGroups) {
-        const groupClaudeMdPath = path.join(semoSystemDir, group, "CLAUDE.md");
-        if (fs.existsSync(groupClaudeMdPath)) {
-            const groupContent = fs.readFileSync(groupClaudeMdPath, "utf-8");
-            // 중복 제거 후 고유 콘텐츠만 추출
-            const uniqueContent = extractUniqueContent(groupContent, group);
-            // 헤더 레벨 조정 (# → ##, ## → ###)
-            const adjustedContent = uniqueContent
-                .replace(/^# /gm, "## ")
-                .replace(/^## /gm, "### ")
-                .replace(/^### /gm, "#### ");
-            packageClaudeMdSections += `\n\n---\n\n${adjustedContent}`;
-            console.log(chalk_1.default.green(`  + ${group}/ 그룹 CLAUDE.md 병합됨 (고유 섹션만)`));
-        }
-    }
-    // 3. 개별 패키지 CLAUDE.md 병합 - 중복 제거 적용
+    // 개별 패키지 CLAUDE.md 병합 - 중복 제거 적용
     for (const pkg of extensions) {
         const pkgClaudeMdPath = path.join(semoSystemDir, pkg, "CLAUDE.md");
         if (fs.existsSync(pkgClaudeMdPath)) {
@@ -2680,7 +2513,7 @@ ${packageClaudeMdSections}
 // === add 명령어 ===
 program
     .command("add <packages>")
-    .description("Extension 패키지를 추가로 설치합니다 (그룹: biz, eng, ops, system / 개별: biz/discovery, eng/nextjs, semo-hooks)")
+    .description("Extension 패키지를 추가로 설치합니다 (meta, semo-hooks, semo-remote)")
     .option("-f, --force", "기존 설정 덮어쓰기")
     .action(async (packagesInput, options) => {
     const cwd = process.cwd();
@@ -2689,25 +2522,16 @@ program
         console.log(chalk_1.default.red("\nSEMO가 설치되어 있지 않습니다. 'semo init'을 먼저 실행하세요.\n"));
         process.exit(1);
     }
-    // 패키지 입력 해석 (그룹, 레거시, 쉼표 구분 모두 처리)
-    const { packages, isGroup, groupName } = resolvePackageInput(packagesInput);
+    // 패키지 입력 해석
+    const { packages } = 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(SHORTNAME_MAPPING).join(", ")}\n`));
         process.exit(1);
     }
-    // 그룹 설치인 경우 안내
-    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) {
+    // 패키지 설치 안내
+    if (packages.length === 1) {
         // 단일 패키지
         const pkg = packages[0];
         console.log(chalk_1.default.cyan(`\n📦 ${EXTENSION_PACKAGES[pkg].name} 패키지 설치\n`));
@@ -2773,50 +2597,28 @@ program
     .action(() => {
     const cwd = process.cwd();
     const semoSystemDir = path.join(cwd, "semo-system");
-    console.log(chalk_1.default.cyan.bold("\n📦 SEMO 패키지 목록 (v3.0)\n"));
-    // Standard
+    console.log(chalk_1.default.cyan.bold("\n📦 SEMO 패키지 목록\n"));
+    // Standard (필수)
     console.log(chalk_1.default.white.bold("Standard (필수)"));
     const coreInstalled = fs.existsSync(path.join(semoSystemDir, "semo-core"));
     const skillsInstalled = fs.existsSync(path.join(semoSystemDir, "semo-skills"));
     console.log(`  ${coreInstalled ? chalk_1.default.green("✓") : chalk_1.default.gray("○")} semo-core - 원칙, 오케스트레이터`);
     console.log(`  ${skillsInstalled ? chalk_1.default.green("✓") : chalk_1.default.gray("○")} semo-skills - 통합 스킬`);
     console.log();
-    // Extensions - 레이어별 그룹화
-    const layers = {
-        biz: { title: "Business Layer", emoji: "💼" },
-        eng: { title: "Engineering Layer", emoji: "⚙️" },
-        ops: { title: "Operations Layer", emoji: "📊" },
-        meta: { title: "Meta", emoji: "🔧" },
-        system: { title: "System", emoji: "🔩" },
-    };
-    for (const [layerKey, layerInfo] of Object.entries(layers)) {
-        const layerPackages = Object.entries(EXTENSION_PACKAGES).filter(([, pkg]) => pkg.layer === layerKey);
-        if (layerPackages.length === 0)
-            continue;
-        console.log(chalk_1.default.white.bold(`${layerInfo.emoji} ${layerInfo.title}`));
-        for (const [key, pkg] of layerPackages) {
-            const isInstalled = fs.existsSync(path.join(semoSystemDir, key));
-            const status = isInstalled ? chalk_1.default.green("✓") : chalk_1.default.gray("○");
-            const displayKey = key.includes("/") ? key.split("/")[1] : key;
-            console.log(`  ${status} ${chalk_1.default.cyan(displayKey)} - ${pkg.desc}`);
-            console.log(chalk_1.default.gray(`      semo add ${key}`));
-        }
-        console.log();
+    // Extensions
+    console.log(chalk_1.default.white.bold("Extensions (선택)"));
+    const extensionList = [
+        { key: "meta", name: "Meta", desc: "SEMO 프레임워크 자체 개발/관리" },
+        { key: "semo-hooks", name: "Hooks", desc: "Claude Code Hooks 기반 로깅 시스템" },
+        { key: "semo-remote", name: "Remote", desc: "Claude Code 원격 제어 (모바일 PWA)" },
+    ];
+    for (const ext of extensionList) {
+        const isInstalled = fs.existsSync(path.join(semoSystemDir, ext.key));
+        const status = isInstalled ? chalk_1.default.green("✓") : chalk_1.default.gray("○");
+        console.log(`  ${status} ${chalk_1.default.cyan(ext.key)} - ${ext.desc}`);
+        console.log(chalk_1.default.gray(`      semo add ${ext.key}`));
     }
-    // 그룹 설치 안내
-    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(chalk_1.default.gray("  semo add system   → System 전체 (hooks, remote)"));
     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 discovery  → biz/discovery"));
-    console.log(chalk_1.default.gray("  semo add qa         → ops/qa"));
-    console.log(chalk_1.default.gray("  semo add nextjs     → eng/nextjs\n"));
 });
 // === status 명령어 ===
 program
@@ -2876,6 +2678,102 @@ program
     }
     console.log();
 });
+// === doctor 명령어 ===
+program
+    .command("doctor")
+    .description("SEMO 및 MCP 설정 문제를 진단합니다")
+    .action(() => {
+    console.log(chalk_1.default.cyan.bold("\n🩺 SEMO 진단\n"));
+    const cwd = process.cwd();
+    let hasIssues = false;
+    // 1. gh CLI 확인
+    console.log(chalk_1.default.white.bold("GitHub CLI:"));
+    try {
+        const ghVersion = (0, child_process_1.execSync)("gh --version", { stdio: "pipe", encoding: "utf-8" }).split("\n")[0];
+        console.log(chalk_1.default.green(`  ✓ 설치됨 (${ghVersion.replace("gh version ", "")})`));
+        // gh 인증 상태
+        try {
+            (0, child_process_1.execSync)("gh auth status", { stdio: "pipe" });
+            console.log(chalk_1.default.green("  ✓ 인증됨"));
+        }
+        catch {
+            console.log(chalk_1.default.red("  ✗ 인증 필요: gh auth login"));
+            hasIssues = true;
+        }
+    }
+    catch {
+        console.log(chalk_1.default.red("  ✗ 미설치: brew install gh"));
+        hasIssues = true;
+    }
+    // 2. GitHub 토큰 확인
+    console.log(chalk_1.default.white.bold("\nGitHub MCP 토큰:"));
+    const ghToken = getGitHubTokenFromCLI();
+    const envToken = process.env.GITHUB_PERSONAL_ACCESS_TOKEN;
+    if (envToken) {
+        console.log(chalk_1.default.green("  ✓ 환경변수 설정됨 (GITHUB_PERSONAL_ACCESS_TOKEN)"));
+    }
+    else if (ghToken) {
+        console.log(chalk_1.default.yellow("  ⚠ gh CLI 토큰 있음 (환경변수 미설정)"));
+        console.log(chalk_1.default.gray("    GitHub MCP 사용하려면:"));
+        console.log(chalk_1.default.white('    export GITHUB_PERSONAL_ACCESS_TOKEN="$(gh auth token)"'));
+        hasIssues = true;
+    }
+    else {
+        console.log(chalk_1.default.red("  ✗ 토큰 없음"));
+        console.log(chalk_1.default.gray("    1. gh auth login 실행"));
+        console.log(chalk_1.default.white('    2. export GITHUB_PERSONAL_ACCESS_TOKEN="$(gh auth token)"'));
+        hasIssues = true;
+    }
+    // 3. MCP 서버 등록 상태
+    console.log(chalk_1.default.white.bold("\nMCP 서버:"));
+    const requiredServers = ["semo-integrations", "github", "context7"];
+    for (const server of requiredServers) {
+        if (isMCPServerRegistered(server)) {
+            console.log(chalk_1.default.green(`  ✓ ${server}`));
+        }
+        else {
+            console.log(chalk_1.default.yellow(`  ⚠ ${server} 미등록`));
+            hasIssues = true;
+        }
+    }
+    // 4. settings.json 확인
+    console.log(chalk_1.default.white.bold("\n설정 파일:"));
+    const settingsPath = path.join(cwd, ".claude", "settings.json");
+    if (fs.existsSync(settingsPath)) {
+        console.log(chalk_1.default.green("  ✓ .claude/settings.json"));
+        try {
+            const settings = JSON.parse(fs.readFileSync(settingsPath, "utf-8"));
+            if (settings.mcpServers?.github?.env?.GITHUB_PERSONAL_ACCESS_TOKEN) {
+                console.log(chalk_1.default.green("  ✓ GitHub MCP 환경변수 설정됨"));
+            }
+            else {
+                console.log(chalk_1.default.yellow("  ⚠ GitHub MCP 환경변수 누락"));
+                hasIssues = true;
+            }
+        }
+        catch {
+            console.log(chalk_1.default.yellow("  ⚠ settings.json 파싱 실패"));
+            hasIssues = true;
+        }
+    }
+    else {
+        console.log(chalk_1.default.red("  ✗ .claude/settings.json 없음"));
+        hasIssues = true;
+    }
+    // 결과
+    console.log();
+    if (hasIssues) {
+        console.log(chalk_1.default.yellow.bold("⚠️  일부 문제가 발견되었습니다."));
+        console.log(chalk_1.default.gray("\nGitHub MCP 빠른 설정:"));
+        console.log(chalk_1.default.white('  export GITHUB_PERSONAL_ACCESS_TOKEN="$(gh auth token)"'));
+        console.log(chalk_1.default.gray("\n영구 설정 (셸 재시작 후 적용):"));
+        console.log(chalk_1.default.white('  echo \'export GITHUB_PERSONAL_ACCESS_TOKEN="$(gh auth token)"\' >> ~/.zshrc'));
+    }
+    else {
+        console.log(chalk_1.default.green.bold("✅ 모든 설정이 정상입니다."));
+    }
+    console.log();
+});
 // === update 명령어 ===
 program
     .command("update")

package/package.json

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