@team-semicolon/semo-cli 3.0.6 → 3.0.9

package/README.md

@@ -1,70 +1,71 @@
 # @team-semicolon/semo-cli
 
-> SEMO CLI - AI Agent Orchestration Framework Installer
+> SEMO CLI v3.0 - AI Agent Orchestration Framework Installer
 
-## 개요
-
-Gemini의 하이브리드 전략에 따라 SEMO를 자동 설치하는 CLI 도구입니다.
+## 설치
 
 ```bash
-npx @team-semicolon/semo-cli init
+npm install -g @team-semicolon/semo-cli
 ```
 
-## 동작 방식
-
-`semo init` 명령어는 다음을 자동으로 수행합니다:
+## 빠른 시작
 
-### 1. White Box 설정 (Git Subtree)
+```bash
+# 프로젝트에 SEMO 설치
+semo init
 
-에이전트가 **읽고 학습**해야 하는 지식 베이스:
+# Extension 패키지 추가
+semo add eng/nextjs
 
+# 버전 확인 및 업데이트 체크
+semo -v
 ```
-semo-system/
-├── semo-core/         # Layer 0: 원칙, 오케스트레이션
-└── semo-skills/       # Layer 1: coder, tester, planner
-```
 
-### 2. Black Box 설정 (MCP Server)
+## 명령어
+
+### `semo init`
 
-토큰이 격리된 **외부 연동 도구**:
+현재 프로젝트에 SEMO를 설치합니다.
 
-```json
-// .claude/settings.json
-{
-  "mcpServers": {
-    "semo-integrations": {
-      "command": "npx",
-      "args": ["-y", "@team-semicolon/semo-mcp"]
-    }
-  }
-}
+```bash
+semo init                    # 기본 설치 (프로젝트 유형 자동 감지)
+semo init --force            # 기존 설정 덮어쓰기
+semo init --skip-mcp         # MCP 설정 생략
+semo init --with next,infra  # 특정 패키지와 함께 설치
 ```
 
-### 3. Context Mesh 초기화
+### `semo add <packages>`
 
-세션 간 **컨텍스트 영속화**:
+Extension 패키지를 추가로 설치합니다.
 
+```bash
+# 개별 패키지 설치
+semo add eng/nextjs
+semo add biz/discovery
+
+# 그룹 일괄 설치
+semo add biz      # Business 전체 (discovery, design, management, poc)
+semo add eng      # Engineering 전체 (nextjs, spring, ms, infra)
+semo add ops      # Operations 전체 (qa, monitor, improve)
+
+# 여러 패키지 동시 설치
+semo add eng/nextjs,eng/infra
+
+# 레거시 별칭 지원
+semo add next     # → eng/nextjs
+semo add backend  # → eng/spring
+semo add mvp      # → biz/poc
 ```
-.claude/memory/
-├── context.md         # 프로젝트 상태
-├── decisions.md       # 아키텍처 결정
-└── rules/             # 프로젝트별 규칙
-```
-
-## 명령어
 
-### init
+### `semo list`
 
-현재 프로젝트에 SEMO를 설치합니다.
+사용 가능한 모든 패키지를 표시합니다.
 
 ```bash
-semo init              # 기본 설치
-semo init --force      # 기존 설정 덮어쓰기
-semo init --skip-mcp   # MCP 설정 생략
-semo init --skip-subtree  # Git Subtree 생략
+semo list
 ```
 
-### status
+### `semo status`
 
 SEMO 설치 상태를 확인합니다.
 
@@ -72,31 +73,117 @@ SEMO 설치 상태를 확인합니다.
 semo status
 ```
 
-### update
+### `semo version` / `semo -v`
+
+버전 정보 및 업데이트 확인을 표시합니다.
+
+```bash
+semo version
+semo -v
+```
+
+출력 예시:
+```
+📦 SEMO CLI 버전 정보
+
+  현재 버전: 3.0.7
+  최신 버전: 3.0.7
+
+  ✓ 최신 버전을 사용 중입니다.
+```
+
+### `semo update`
 
 SEMO를 최신 버전으로 업데이트합니다.
 
 ```bash
-semo update
+semo update              # CLI + semo-system 전체 업데이트
+semo update --self       # CLI만 업데이트
+semo update --system     # semo-system만 업데이트
+semo update --skip-cli   # CLI 업데이트 건너뛰기
 ```
 
+## 패키지 구조
+
+### Standard (필수)
+
+모든 프로젝트에 기본 설치됩니다.
+
+| 패키지 | 설명 |
+|--------|------|
+| `semo-core` | 원칙, 오케스트레이터, 공통 커맨드 |
+| `semo-skills` | 13개 통합 스킬 (coder, tester, planner, deployer 등) |
+
+### Extensions (선택)
+
+프로젝트 유형에 맞게 선택적으로 설치합니다.
+
+#### Business Layer (`biz`)
+
+| 패키지 | 설명 | 설치 |
+|--------|------|------|
+| `biz/discovery` | 아이템 발굴, 시장 조사, Epic/Task | `semo add biz/discovery` |
+| `biz/design` | 컨셉 설계, 목업, UX | `semo add biz/design` |
+| `biz/management` | 일정/인력/스프린트 관리 | `semo add biz/management` |
+| `biz/poc` | 빠른 PoC, 패스트트랙 | `semo add biz/poc` |
+
+#### Engineering Layer (`eng`)
+
+| 패키지 | 설명 | 자동 감지 | 설치 |
+|--------|------|----------|------|
+| `eng/nextjs` | Next.js 프론트엔드 개발 | `next.config.*` | `semo add eng/nextjs` |
+| `eng/spring` | Spring Boot 백엔드 개발 | `pom.xml`, `build.gradle` | `semo add eng/spring` |
+| `eng/ms` | 마이크로서비스 아키텍처 | - | `semo add eng/ms` |
+| `eng/infra` | 인프라/배포 관리 | `Dockerfile`, `docker-compose.yml` | `semo add eng/infra` |
+
+#### Operations Layer (`ops`)
+
+| 패키지 | 설명 | 설치 |
+|--------|------|------|
+| `ops/qa` | 테스트/품질 관리 | `semo add ops/qa` |
+| `ops/monitor` | 서비스 현황 모니터링 | `semo add ops/monitor` |
+| `ops/improve` | 개선 제안 | `semo add ops/improve` |
+
+#### Meta
+
+| 패키지 | 설명 | 설치 |
+|--------|------|------|
+| `meta` | SEMO 프레임워크 자체 개발/관리 | `semo add meta` |
+
 ## 설치 후 구조
 
 ```
 your-project/
 ├── .claude/
-│   ├── CLAUDE.md          # 프로젝트 설정
-│   ├── settings.json      # MCP 서버 설정
-│   ├── memory/            # Context Mesh
-│   ├── agents → semo-system/semo-core/agents
-│   └── skills → semo-system/semo-skills
+│   ├── CLAUDE.md              # 프로젝트 설정 (Extension CLAUDE.md 병합)
+│   ├── settings.json          # MCP 서버 설정
+│   ├── memory/                # Context Mesh (세션 간 컨텍스트)
+│   │   ├── context.md         # 프로젝트 상태
+│   │   ├── decisions.md       # 아키텍처 결정
+│   │   └── rules/             # 프로젝트별 규칙
+│   ├── agents/                # 에이전트 심볼릭 링크
+│   ├── skills/                # 스킬 심볼릭 링크
+│   └── commands/SEMO/         # SEMO 커맨드
 │
-└── semo-system/           # White Box (읽기 전용)
-    ├── semo-core/
-    └── semo-skills/
+└── semo-system/               # White Box (읽기 전용)
+    ├── semo-core/             # Layer 0: 원칙, 오케스트레이션
+    ├── semo-skills/           # Layer 1: 통합 스킬
+    ├── biz/                   # Business Layer (선택)
+    ├── eng/                   # Engineering Layer (선택)
+    └── ops/                   # Operations Layer (선택)
 ```
 
-## 환경변수
+## MCP 서버
+
+SEMO CLI는 다음 MCP 서버를 자동으로 등록합니다:
+
+| 서버 | 설명 |
+|------|------|
+| `semo-integrations` | GitHub, Slack, Supabase 연동 |
+| `context7` | 라이브러리 문서 조회 |
+| `sequential-thinking` | 순차적 사고 지원 |
+
+### 환경변수
 
 MCP 연동을 위해 다음 환경변수를 설정하세요:
 
@@ -107,11 +194,37 @@ MCP 연동을 위해 다음 환경변수를 설정하세요:
 | `SUPABASE_URL` | Supabase 프로젝트 URL |
 | `SUPABASE_KEY` | Supabase 서비스 키 |
 
+## 프로젝트 유형 자동 감지
+
+`semo init` 실행 시 프로젝트 파일을 분석하여 적절한 패키지를 추천합니다:
+
+| 감지 파일 | 추천 패키지 |
+|----------|-------------|
+| `next.config.js`, `next.config.mjs`, `next.config.ts` | `eng/nextjs` |
+| `pom.xml`, `build.gradle` | `eng/spring` |
+| `Dockerfile`, `docker-compose.yml` | `eng/infra` |
+| `semo-core`, `semo-skills` | `meta` |
+
+## 레거시 명령어 호환
+
+이전 버전 사용자를 위해 레거시 패키지명도 지원합니다:
+
+| 레거시 | 현재 |
+|--------|------|
+| `semo add next` | `semo add eng/nextjs` |
+| `semo add backend` | `semo add eng/spring` |
+| `semo add ms` | `semo add eng/ms` |
+| `semo add infra` | `semo add eng/infra` |
+| `semo add qa` | `semo add ops/qa` |
+| `semo add po` | `semo add biz/discovery` |
+| `semo add pm` | `semo add biz/management` |
+| `semo add design` | `semo add biz/design` |
+| `semo add mvp` | `semo add biz/poc` |
+
 ## 참조
 
 - [SEMO 레포지토리](https://github.com/semicolon-devteam/semo)
-- [SEMO MCP Server](../mcp-server/README.md)
-- [Gemini 하이브리드 전략](../../docs/SEMO_ARCHITECTURE_REVIEW.md)
+- [SEMO MCP Server](https://www.npmjs.com/package/@team-semicolon/semo-mcp)
 
 ## 라이선스
 

package/dist/index.js

@@ -59,7 +59,7 @@ const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
-const VERSION = "3.0.6";
+const VERSION = "3.0.9";
 const PACKAGE_NAME = "@team-semicolon/semo-cli";
 // === 버전 비교 유틸리티 ===
 /**
@@ -313,17 +313,92 @@ function detectProjectType(cwd) {
     }
     return detected;
 }
+function checkRequiredTools() {
+    const tools = [
+        {
+            name: "GitHub CLI (gh)",
+            installed: false,
+            installCmd: isWindows ? "winget install GitHub.cli" : "brew install gh",
+            description: "GitHub API 연동 (이슈, PR, 배포)",
+        },
+        {
+            name: "Supabase CLI",
+            installed: false,
+            installCmd: isWindows ? "npm install -g supabase" : "brew install supabase/tap/supabase",
+            description: "Supabase 데이터베이스 연동",
+        },
+    ];
+    // GitHub CLI 확인
+    try {
+        const ghVersion = (0, child_process_1.execSync)("gh --version", { stdio: "pipe", encoding: "utf-8" });
+        tools[0].installed = true;
+        tools[0].version = ghVersion.split("\n")[0].replace("gh version ", "").trim();
+    }
+    catch {
+        // gh not installed
+    }
+    // Supabase CLI 확인
+    try {
+        const supabaseVersion = (0, child_process_1.execSync)("supabase --version", { stdio: "pipe", encoding: "utf-8" });
+        tools[1].installed = true;
+        tools[1].version = supabaseVersion.trim();
+    }
+    catch {
+        // supabase not installed
+    }
+    return tools;
+}
+async function showToolsStatus() {
+    console.log(chalk_1.default.cyan("\n🔍 필수 도구 확인"));
+    const tools = checkRequiredTools();
+    const missingTools = tools.filter(t => !t.installed);
+    for (const tool of tools) {
+        if (tool.installed) {
+            console.log(chalk_1.default.green(`  ✓ ${tool.name} ${tool.version ? `(${tool.version})` : ""}`));
+        }
+        else {
+            console.log(chalk_1.default.yellow(`  ✗ ${tool.name} - 미설치`));
+            console.log(chalk_1.default.gray(`      ${tool.description}`));
+        }
+    }
+    if (missingTools.length > 0) {
+        console.log(chalk_1.default.yellow("\n⚠ 일부 도구가 설치되어 있지 않습니다."));
+        console.log(chalk_1.default.gray("  SEMO의 일부 기능이 제한될 수 있습니다.\n"));
+        console.log(chalk_1.default.cyan("📋 설치 명령어:"));
+        for (const tool of missingTools) {
+            console.log(chalk_1.default.white(`   ${tool.installCmd}`));
+        }
+        console.log();
+        const { continueWithout } = await inquirer_1.default.prompt([
+            {
+                type: "confirm",
+                name: "continueWithout",
+                message: "도구 없이 계속 설치를 진행할까요?",
+                default: true,
+            },
+        ]);
+        return continueWithout;
+    }
+    return true;
+}
 // === init 명령어 ===
 program
     .command("init")
     .description("현재 프로젝트에 SEMO를 설치합니다")
     .option("-f, --force", "기존 설정 덮어쓰기")
     .option("--skip-mcp", "MCP 설정 생략")
+    .option("--no-gitignore", ".gitignore 수정 생략")
     .option("--with <packages>", "추가 설치할 패키지 (쉼표 구분: next,backend)")
     .action(async (options) => {
     console.log(chalk_1.default.cyan.bold("\n🚀 SEMO 설치 시작\n"));
     console.log(chalk_1.default.gray("Gemini 하이브리드 전략: White Box + Black Box\n"));
     const cwd = process.cwd();
+    // 0. 필수 도구 확인
+    const shouldContinue = await showToolsStatus();
+    if (!shouldContinue) {
+        console.log(chalk_1.default.yellow("\n설치가 취소되었습니다. 필수 도구 설치 후 다시 시도하세요.\n"));
+        process.exit(0);
+    }
     // 1. Git 레포지토리 확인
     const spinner = (0, ora_1.default)("Git 레포지토리 확인 중...").start();
     try {
@@ -375,9 +450,13 @@ program
     }
     // 7. Context Mesh 초기화
     await setupContextMesh(cwd);
-    // 8. CLAUDE.md 생성
+    // 8. .gitignore 업데이트
+    if (options.gitignore !== false) {
+        updateGitignore(cwd);
+    }
+    // 9. CLAUDE.md 생성
     await setupClaudeMd(cwd, extensionsToInstall, options.force);
-    // 9. Extensions 심볼릭 링크 (agents/skills 병합)
+    // 10. Extensions 심볼릭 링크 (agents/skills 병합)
     if (extensionsToInstall.length > 0) {
         await setupExtensionSymlinks(cwd, extensionsToInstall);
     }
@@ -488,13 +567,20 @@ async function createStandardSymlinks(cwd) {
     const commandsDir = path.join(claudeDir, "commands");
     fs.mkdirSync(commandsDir, { recursive: true });
     const semoCommandsLink = path.join(commandsDir, "SEMO");
-    if (!fs.existsSync(semoCommandsLink)) {
-        const commandsTarget = path.join(semoSystemDir, "semo-core", "commands", "SEMO");
-        if (fs.existsSync(commandsTarget)) {
-            createSymlinkOrJunction(commandsTarget, semoCommandsLink);
-            console.log(chalk_1.default.green("  ✓ .claude/commands/SEMO → semo-system/semo-core/commands/SEMO"));
+    const commandsTarget = path.join(semoSystemDir, "semo-core", "commands", "SEMO");
+    // 기존 링크가 있으면 삭제 후 재생성 (업데이트 시에도 최신 반영)
+    if (fs.existsSync(semoCommandsLink)) {
+        if (fs.lstatSync(semoCommandsLink).isSymbolicLink()) {
+            fs.unlinkSync(semoCommandsLink);
+        }
+        else {
+            removeRecursive(semoCommandsLink);
         }
     }
+    if (fs.existsSync(commandsTarget)) {
+        createSymlinkOrJunction(commandsTarget, semoCommandsLink);
+        console.log(chalk_1.default.green("  ✓ .claude/commands/SEMO → semo-system/semo-core/commands/SEMO"));
+    }
 }
 // === Extensions 다운로드 (심볼릭 링크 제외) ===
 async function downloadExtensions(cwd, packages, force) {
@@ -511,6 +597,27 @@ async function downloadExtensions(cwd, packages, force) {
             (0, child_process_1.execSync)(`git clone --depth 1 ${SEMO_REPO} "${tempDir}"`, { stdio: "pipe" });
         }
         const semoSystemDir = path.join(cwd, "semo-system");
+        // 그룹 추출 (중복 제거) - 그룹 레벨 CLAUDE.md 복사용
+        const groups = [...new Set(packages.map(pkg => pkg.split("/")[0]).filter(g => ["biz", "eng", "ops"].includes(g)))];
+        // 그룹 레벨 파일 복사 (CLAUDE.md, VERSION 등)
+        for (const group of groups) {
+            const groupSrcDir = path.join(tempDir, "packages", group);
+            const groupDestDir = path.join(semoSystemDir, group);
+            // 그룹 디렉토리의 루트 파일만 복사 (CLAUDE.md, VERSION)
+            if (fs.existsSync(groupSrcDir)) {
+                fs.mkdirSync(groupDestDir, { recursive: true });
+                const groupFiles = fs.readdirSync(groupSrcDir);
+                for (const file of groupFiles) {
+                    const srcFile = path.join(groupSrcDir, file);
+                    const destFile = path.join(groupDestDir, file);
+                    if (fs.statSync(srcFile).isFile()) {
+                        fs.copyFileSync(srcFile, destFile);
+                    }
+                }
+                console.log(chalk_1.default.green(`  ✓ ${group}/ 그룹 파일 복사 (CLAUDE.md 등)`));
+            }
+        }
+        // 개별 패키지 복사
         for (const pkg of packages) {
             const srcPath = path.join(tempDir, "packages", pkg);
             const destPath = path.join(semoSystemDir, pkg);
@@ -520,6 +627,8 @@ async function downloadExtensions(cwd, packages, force) {
                     continue;
                 }
                 removeRecursive(destPath);
+                // 상위 디렉토리 생성 (biz/discovery -> biz/ 먼저 생성)
+                fs.mkdirSync(path.dirname(destPath), { recursive: true });
                 copyRecursive(srcPath, destPath);
             }
         }
@@ -1020,6 +1129,33 @@ async function mergeExtensionSettings(cwd, packages) {
         }
     }
 }
+// === .gitignore 업데이트 ===
+function updateGitignore(cwd) {
+    console.log(chalk_1.default.cyan("\n📝 .gitignore 업데이트"));
+    const gitignorePath = path.join(cwd, ".gitignore");
+    const semoIgnoreBlock = `
+# === SEMO ===
+.claude/*
+!.claude/memory/
+!.claude/memory/**
+`;
+    if (fs.existsSync(gitignorePath)) {
+        const content = fs.readFileSync(gitignorePath, "utf-8");
+        // 이미 SEMO 블록이 있으면 스킵
+        if (content.includes("# === SEMO ===")) {
+            console.log(chalk_1.default.gray("  → SEMO 블록 이미 존재 (건너뜀)"));
+            return;
+        }
+        // 기존 파일에 추가
+        fs.appendFileSync(gitignorePath, semoIgnoreBlock);
+        console.log(chalk_1.default.green("✓ .gitignore에 SEMO 규칙 추가됨"));
+    }
+    else {
+        // 새로 생성
+        fs.writeFileSync(gitignorePath, semoIgnoreBlock.trim() + "\n");
+        console.log(chalk_1.default.green("✓ .gitignore 생성됨 (SEMO 규칙 포함)"));
+    }
+}
 // === Context Mesh 초기화 ===
 async function setupContextMesh(cwd) {
     console.log(chalk_1.default.cyan("\n🧠 Context Mesh 초기화"));
@@ -1140,8 +1276,25 @@ 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");
+            // 그룹 CLAUDE.md 헤더 레벨 조정 (# → ##, ## → ###)
+            const adjustedContent = groupContent
+                .replace(/^# /gm, "## ")
+                .replace(/^## /gm, "### ")
+                .replace(/^### /gm, "#### ");
+            packageClaudeMdSections += `\n\n---\n\n${adjustedContent}`;
+            console.log(chalk_1.default.green(`  + ${group}/ 그룹 CLAUDE.md 병합됨`));
+        }
+    }
+    // 3. 개별 패키지 CLAUDE.md 병합
     for (const pkg of extensions) {
         const pkgClaudeMdPath = path.join(semoSystemDir, pkg, "CLAUDE.md");
         if (fs.existsSync(pkgClaudeMdPath)) {
@@ -1592,7 +1745,18 @@ program
             }
         }
     }
-    // Standard 심볼릭 링크 재생성
+    // commands 링크도 정리 (신규 commands 반영 위해)
+    const claudeCommandsDir = path.join(claudeDir, "commands");
+    const semoCommandsLink = path.join(claudeCommandsDir, "SEMO");
+    if (fs.existsSync(semoCommandsLink)) {
+        if (fs.lstatSync(semoCommandsLink).isSymbolicLink()) {
+            fs.unlinkSync(semoCommandsLink);
+        }
+        else {
+            removeRecursive(semoCommandsLink);
+        }
+    }
+    // Standard 심볼릭 링크 재생성 (agents, skills, commands 포함)
     await createStandardSymlinks(cwd);
     // Extensions 심볼릭 링크 재생성
     if (installedExtensions.length > 0) {

package/package.json

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