@team-semicolon/semo-cli 4.6.0 → 4.7.0

package/dist/commands/bots.js

@@ -590,15 +590,30 @@ function registerBotsCommands(program) {
         .option("--format <type>", "출력 형식 (table|json|slack)", "table")
         .option("--fix", "누락 파일/디렉토리 자동 생성")
         .option("--no-db", "DB 저장 건너뛰기")
+        .option("--local", "~/.claude/semo/bots/ 로컬 미러 audit")
         .action(async (options) => {
         const home = process.env.HOME || "/Users/reus";
-        const spinner = (0, ora_1.default)("bot-workspaces audit 중... (v2.0 SoT: ~/.openclaw-*/workspace/)").start();
-        // v2.0: SoT는 ~/.openclaw-{bot}/workspace/
+        const isLocal = options.local === true;
+        const sourceLabel = isLocal ? "~/.claude/semo/bots/" : "~/.openclaw-*/workspace/";
+        const spinner = (0, ora_1.default)(`bot-workspaces audit 중... (${sourceLabel})`).start();
         const botEntries = [];
-        for (const botId of KNOWN_BOTS) {
-            const botDir = path.join(home, `.openclaw-${botId}`, "workspace");
-            if (fs.existsSync(botDir)) {
-                botEntries.push({ botId, botDir });
+        if (isLocal) {
+            // 로컬 미러: ~/.claude/semo/bots/{botId}/
+            const semoBotsDir = path.join(home, ".claude", "semo", "bots");
+            if (fs.existsSync(semoBotsDir)) {
+                const dirs = fs.readdirSync(semoBotsDir).filter(f => fs.statSync(path.join(semoBotsDir, f)).isDirectory());
+                for (const botId of dirs) {
+                    botEntries.push({ botId, botDir: path.join(semoBotsDir, botId) });
+                }
+            }
+        }
+        else {
+            // v2.0: SoT는 ~/.openclaw-{bot}/workspace/
+            for (const botId of KNOWN_BOTS) {
+                const botDir = path.join(home, `.openclaw-${botId}`, "workspace");
+                if (fs.existsSync(botDir)) {
+                    botEntries.push({ botId, botDir });
+                }
             }
         }
         if (botEntries.length === 0) {
@@ -620,7 +635,9 @@ function registerBotsCommands(program) {
         if (options.fix) {
             let totalFixed = 0;
             for (const r of results) {
-                const botDir = path.join(home, `.openclaw-${r.botId}`, "workspace");
+                const botDir = isLocal
+                    ? path.join(home, ".claude", "semo", "bots", r.botId)
+                    : path.join(home, `.openclaw-${r.botId}`, "workspace");
                 const fixed = (0, audit_1.fixBot)(botDir, r.botId, r.checks);
                 if (fixed > 0) {
                     console.log(chalk_1.default.green(`  ✔ ${r.botId}: ${fixed}개 파일/디렉토리 생성`));
@@ -631,7 +648,9 @@ function registerBotsCommands(program) {
                 console.log(chalk_1.default.green(`\n총 ${totalFixed}개 수정`));
                 // Re-audit after fix
                 for (let i = 0; i < results.length; i++) {
-                    const botDir = path.join(home, `.openclaw-${results[i].botId}`, "workspace");
+                    const botDir = isLocal
+                        ? path.join(home, ".claude", "semo", "bots", results[i].botId)
+                        : path.join(home, `.openclaw-${results[i].botId}`, "workspace");
                     results[i] = (0, audit_1.auditBot)(botDir, results[i].botId);
                 }
             }
@@ -1039,6 +1058,122 @@ function registerBotsCommands(program) {
             await (0, database_1.closeConnection)();
         }
     });
+    // ── semo bots skill-deploy ──────────────────────────────────
+    botsCmd
+        .command("skill-deploy")
+        .description("DB skill_definitions → 봇 워크스페이스 SKILL.md 역배포")
+        .option("--bot <botId>", "특정 봇에만 배포")
+        .option("--dry-run", "파일 쓰기 없이 계획만 출력")
+        .option("--force", "기존 SKILL.md와 내용이 달라도 덮어쓰기")
+        .action(async (options) => {
+        const spinner = (0, ora_1.default)("스킬 배포 준비 중...").start();
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            spinner.fail("DB 연결 실패");
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        try {
+            const skills = await (0, database_1.getActiveSkills)();
+            spinner.succeed(`활성 스킬 ${skills.length}개 조회 완료`);
+            // Filter skills that have bot_ids assigned and content
+            const deployable = skills.filter((s) => s.bot_ids && s.bot_ids.length > 0 && s.content && s.content.trim());
+            if (deployable.length === 0) {
+                console.log(chalk_1.default.yellow("배포 가능한 스킬이 없습니다."));
+                return;
+            }
+            const entries = [];
+            for (const skill of deployable) {
+                const targetBots = options.bot
+                    ? skill.bot_ids.filter((b) => b === options.bot)
+                    : skill.bot_ids;
+                for (const botId of targetBots) {
+                    const wsDir = path.join(os.homedir(), `.openclaw-${botId}`, "workspace");
+                    const skillDir = path.join(wsDir, "skills", skill.name);
+                    const filePath = path.join(skillDir, "SKILL.md");
+                    let action;
+                    if (!fs.existsSync(filePath)) {
+                        action = "CREATE";
+                    }
+                    else {
+                        const existing = fs.readFileSync(filePath, "utf-8");
+                        if (existing === skill.content) {
+                            action = "SKIP_SAME";
+                        }
+                        else if (options.force) {
+                            action = "OVERWRITE";
+                        }
+                        else {
+                            action = "SKIP_EXISTS";
+                        }
+                    }
+                    entries.push({ skillName: skill.name, botId, action, filePath, content: skill.content });
+                }
+            }
+            // Summary table
+            const actionColor = {
+                CREATE: chalk_1.default.green,
+                OVERWRITE: chalk_1.default.yellow,
+                SKIP_SAME: chalk_1.default.gray,
+                SKIP_EXISTS: chalk_1.default.cyan,
+            };
+            console.log("\n" + chalk_1.default.bold("배포 계획:"));
+            console.log("─".repeat(70));
+            for (const e of entries) {
+                const tag = actionColor[e.action](e.action.padEnd(12));
+                console.log(`  ${tag} ${e.botId}/${e.skillName}`);
+            }
+            console.log("─".repeat(70));
+            const creates = entries.filter((e) => e.action === "CREATE").length;
+            const overwrites = entries.filter((e) => e.action === "OVERWRITE").length;
+            const skipSame = entries.filter((e) => e.action === "SKIP_SAME").length;
+            const skipExists = entries.filter((e) => e.action === "SKIP_EXISTS").length;
+            console.log(`  CREATE: ${creates}  OVERWRITE: ${overwrites}  동일: ${skipSame}  스킵(--force 필요): ${skipExists}`);
+            if (options.dryRun) {
+                console.log(chalk_1.default.yellow("\n--dry-run: 파일 쓰기를 건너뜁니다."));
+                return;
+            }
+            const toWrite = entries.filter((e) => e.action === "CREATE" || e.action === "OVERWRITE");
+            if (toWrite.length === 0) {
+                console.log(chalk_1.default.green("\n변경할 파일이 없습니다."));
+                return;
+            }
+            // Write files
+            const writeSpinner = (0, ora_1.default)(`SKILL.md ${toWrite.length}개 배포 중...`).start();
+            for (const e of toWrite) {
+                const dir = path.dirname(e.filePath);
+                fs.mkdirSync(dir, { recursive: true });
+                fs.writeFileSync(e.filePath, e.content, "utf-8");
+            }
+            writeSpinner.succeed(`SKILL.md ${toWrite.length}개 배포 완료`);
+            // Sync workspace files for affected bots
+            const affectedBots = [...new Set(toWrite.map((e) => e.botId))];
+            const pool = (0, database_1.getPool)();
+            const client = await pool.connect();
+            try {
+                for (const botId of affectedBots) {
+                    const wsDir = path.join(os.homedir(), `.openclaw-${botId}`, "workspace");
+                    if (fs.existsSync(wsDir)) {
+                        const syncSpinner = (0, ora_1.default)(`${botId} 워크스페이스 DB 싱크 중...`).start();
+                        const count = await syncWorkspaceFiles(client, botId, wsDir);
+                        syncSpinner.succeed(`${botId} 워크스페이스 싱크 완료 (${count}개 파일 갱신)`);
+                    }
+                }
+            }
+            finally {
+                client.release();
+            }
+            console.log(chalk_1.default.green(`\n✔ 스킬 역배포 완료`));
+        }
+        catch (err) {
+            spinner.isSpinning && spinner.fail("스킬 배포 실패");
+            console.error(chalk_1.default.red(`❌ ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
     // ── semo bots set-status ─────────────────────────────────────
     botsCmd
         .command("set-status <bot_id> <status>")

package/dist/commands/context.js

@@ -55,6 +55,7 @@ const database_1 = require("../database");
 const kb_1 = require("../kb");
 // [v4.4.0] syncSkillsToDB 제거 — semo-system/ 폐기됨, 스킬 SoT는 DB 직접 관리
 const global_cache_1 = require("../global-cache");
+const semo_workspace_1 = require("../semo-workspace");
 // ============================================================
 // Memory file mapping
 // ============================================================
@@ -224,7 +225,21 @@ function registerContextCommands(program) {
                     console.log(chalk_1.default.yellow(`  ⚠ 글로벌 캐시 동기화 실패 (기존 파일 유지): ${cacheErr}`));
                 }
             }
-            // 3. 크론잡 동기화 (local → DB)
+            // 3. 봇 미러 리프레시 (DB → ~/.claude/semo/bots/)
+            const semoDir = path.join(os.homedir(), ".claude", "semo");
+            if (fs.existsSync(semoDir)) {
+                try {
+                    spinner.text = "봇 미러 동기화 (~/.claude/semo/bots/)...";
+                    const mirrorResult = await (0, semo_workspace_1.populateBotMirrors)();
+                    if (mirrorResult.files > 0) {
+                        console.log(chalk_1.default.green(`  ✓ 봇 미러: ${mirrorResult.bots}개 봇, ${mirrorResult.files}개 파일`));
+                    }
+                }
+                catch {
+                    // 봇 미러 동기화 실패는 비치명적
+                }
+            }
+            // 4. 크론잡 동기화 (local → DB)
             try {
                 spinner.text = "크론잡 동기화...";
                 const cronResult = await syncCronJobs(pool);
@@ -235,7 +250,7 @@ function registerContextCommands(program) {
             catch {
                 // 크론잡 동기화 실패는 비치명적
             }
-            spinner.succeed("context sync 완료 — 스킬/캐시/크론잡 동기화");
+            spinner.succeed("context sync 완료 — 스킬/캐시/봇미러/크론잡 동기화");
             console.log(chalk_1.default.gray(`  저장 위치: ${memDir}`));
         }
         catch (err) {

package/dist/commands/memory.js

@@ -211,6 +211,9 @@ function registerMemoryCommands(program) {
         .option("--dry-run", "프리뷰만 (실제 동기화 안 함)")
         .option("--force", "워터마크 무시, 전체 재동기화")
         .action(async (options) => {
+        console.log(chalk_1.default.yellow.bold("\n⚠️  [DEPRECATED] semo memory sync는 semiclaw memory-escalation 크론잡으로 대체되었습니다."));
+        console.log(chalk_1.default.yellow("   매일 06:00 자동 실행되며, LLM 기반 분류로 적절한 KB 도메인/키에 에스컬레이션합니다."));
+        console.log(chalk_1.default.yellow("   수동 실행이 필요하면 semiclaw에게 'memory-escalation 스킬 실행' 을 지시하세요.\n"));
         const dryRun = !!options.dryRun;
         const force = !!options.force;
         const minAgeDays = parseInt(options.days) || 2;

package/dist/database.d.ts

@@ -123,3 +123,15 @@ export declare function closeConnection(): Promise<void>;
  * DB 연결 상태 확인
  */
 export declare function isDbConnected(): Promise<boolean>;
+export interface BotWorkspaceFile {
+    file_path: string;
+    content: string;
+}
+/**
+ * 활성 봇 ID 목록 조회 (retired 제외)
+ */
+export declare function getActiveBotIds(): Promise<string[]>;
+/**
+ * 특정 봇의 워크스페이스 파일 목록 조회 (DB 미러)
+ */
+export declare function getBotWorkspaceFiles(botId: string): Promise<BotWorkspaceFile[]>;

package/dist/database.js

@@ -58,16 +58,21 @@ exports.getDelegations = getDelegations;
 exports.getProtocol = getProtocol;
 exports.closeConnection = closeConnection;
 exports.isDbConnected = isDbConnected;
+exports.getActiveBotIds = getActiveBotIds;
+exports.getBotWorkspaceFiles = getBotWorkspaceFiles;
 const pg_1 = require("pg");
 const fs = __importStar(require("fs"));
 const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const env_parser_1 = require("./env-parser");
-// ~/.semo.env 자동 로드 — LaunchAgent / Claude Code 앱 / cron 등
+// ~/.claude/semo/.env 자동 로드 — LaunchAgent / Claude Code 앱 / cron 등
 // 인터랙티브 쉘이 아닌 환경에서 환경변수를 공급한다.
 // 이미 설정된 환경변수는 덮어쓰지 않는다 (env var > file).
+// v4.5.0: ~/.semo.env → ~/.claude/semo/.env 이전. 구 경로 폴백 유지.
 function loadSemoEnv() {
-    const envFile = path.join(os.homedir(), ".semo.env");
+    const newEnvFile = path.join(os.homedir(), ".claude", "semo", ".env");
+    const legacyEnvFile = path.join(os.homedir(), ".semo.env");
+    const envFile = fs.existsSync(newEnvFile) ? newEnvFile : legacyEnvFile;
     if (!fs.existsSync(envFile))
         return;
     try {
@@ -382,3 +387,33 @@ async function closeConnection() {
 async function isDbConnected() {
     return checkDbConnection();
 }
+/**
+ * 활성 봇 ID 목록 조회 (retired 제외)
+ */
+async function getActiveBotIds() {
+    const isConnected = await checkDbConnection();
+    if (!isConnected)
+        return [];
+    try {
+        const result = await getPool().query(`SELECT bot_id FROM semo.bot_status WHERE status != 'retired' ORDER BY bot_id`);
+        return result.rows.map((r) => r.bot_id);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * 특정 봇의 워크스페이스 파일 목록 조회 (DB 미러)
+ */
+async function getBotWorkspaceFiles(botId) {
+    const isConnected = await checkDbConnection();
+    if (!isConnected)
+        return [];
+    try {
+        const result = await getPool().query(`SELECT file_path, content FROM semo.bot_workspace_files WHERE bot_id = $1 ORDER BY file_path`, [botId]);
+        return result.rows;
+    }
+    catch {
+        return [];
+    }
+}

package/dist/index.js

@@ -66,6 +66,7 @@ const db_1 = require("./commands/db");
 const memory_1 = require("./commands/memory");
 const test_1 = require("./commands/test");
 const global_cache_1 = require("./global-cache");
+const semo_workspace_1 = require("./semo-workspace");
 const PACKAGE_NAME = "@team-semicolon/semo-cli";
 // package.json에서 버전 동적 로드
 function getCliVersion() {
@@ -744,20 +745,24 @@ async function showToolsStatus() {
 // === 글로벌 설정 체크 ===
 function isGlobalSetupDone() {
     const home = os.homedir();
-    return (fs.existsSync(path.join(home, ".semo.env")) &&
-        fs.existsSync(path.join(home, ".claude", "skills")));
+    const hasEnv = fs.existsSync(path.join(home, ".claude", "semo", ".env")) ||
+        fs.existsSync(path.join(home, ".semo.env")); // 하위 호환
+    const hasSetup = fs.existsSync(path.join(home, ".claude", "semo", "SOUL.md")) ||
+        fs.existsSync(path.join(home, ".claude", "skills")); // 하위 호환
+    return hasEnv && hasSetup;
 }
-// === onboarding 명령어 (글로벌 1회 설정) ===
+// === onboarding 명령어 (글로벌 설정 — init 통합) ===
 program
     .command("onboarding")
-    .description("글로벌 SEMO 설정 (머신당 1회) — ~/.claude/, ~/.semo.env")
+    .description("글로벌 SEMO 설정 — ~/.claude/semo/, skills/agents/commands")
     .option("--credentials-gist <gistId>", "Private GitHub Gist에서 DB 접속정보 가져오기")
     .option("-f, --force", "기존 설정 덮어쓰기")
     .option("--skip-mcp", "MCP 설정 생략")
+    .option("--skip-bots", "봇 워크스페이스 미러 건너뛰기")
     .action(async (options) => {
-    console.log(chalk_1.default.cyan.bold("\n🏠 SEMO 글로벌 온보딩\n"));
-    console.log(chalk_1.default.gray("  대상: ~/.claude/, ~/.semo.env (머신당 1회)\n"));
-    // 1. ~/.semo.env DB 접속 설정
+    console.log(chalk_1.default.cyan.bold("\n🏠 SEMO 온보딩\n"));
+    console.log(chalk_1.default.gray("  대상: ~/.claude/semo/ (머신당 1회)\n"));
+    // 1. ~/.claude/semo/.env DB 접속 설정
     await setupSemoEnv(options.credentialsGist, options.force);
     // 2. DB health check
     const spinner = (0, ora_1.default)("DB 연결 확인 중...").start();
@@ -766,103 +771,82 @@ program
         spinner.succeed("DB 연결 확인됨");
     }
     else {
-        spinner.warn("DB 연결 실패 — 스킬/커맨드/에이전트 설치를 건너뜁니다");
-        console.log(chalk_1.default.gray("  ~/.semo.env를 확인하고 다시 시도하세요: semo onboarding\n"));
+        spinner.warn("DB 연결 실패 — 스킬/봇 미러 설치를 건너뜁니다");
+        console.log(chalk_1.default.gray("  ~/.claude/semo/.env를 확인하고 다시 시도하세요: semo onboarding\n"));
         await (0, database_1.closeConnection)();
         return;
     }
-    // 3. Standard 설치 (DB → ~/.claude/skills, commands, agents)
+    // 3. ~/.claude/semo/ 디렉토리 구조 생성
+    console.log(chalk_1.default.cyan("\n📂 SEMO 워크스페이스 구성 (~/.claude/semo/)"));
+    (0, semo_workspace_1.ensureSemoDir)();
+    console.log(chalk_1.default.green("  ✓ ~/.claude/semo/ 디렉토리 생성됨"));
+    // 4. 봇 워크스페이스 미러 (DB → semo/bots/)
+    if (!options.skipBots) {
+        const mirrorSpinner = (0, ora_1.default)("봇 워크스페이스 미러링 (DB → semo/bots/)...").start();
+        try {
+            const result = await (0, semo_workspace_1.populateBotMirrors)();
+            mirrorSpinner.succeed(`봇 미러 완료: ${result.bots}개 봇, ${result.files}개 파일`);
+        }
+        catch (err) {
+            mirrorSpinner.warn(`봇 미러 실패 (계속 진행): ${err}`);
+        }
+    }
+    else {
+        console.log(chalk_1.default.gray("  → 봇 미러 건너뜀 (--skip-bots)"));
+    }
+    // 5. SOUL.md / MEMORY.md / USER.md 생성
+    try {
+        await (0, semo_workspace_1.generateSoulMd)();
+        console.log(chalk_1.default.green("  ✓ semo/SOUL.md 생성됨 (오케스트레이터 페르소나)"));
+    }
+    catch (err) {
+        console.log(chalk_1.default.yellow(`  ⚠ SOUL.md 생성 실패: ${err}`));
+    }
+    (0, semo_workspace_1.generateMemoryMd)();
+    console.log(chalk_1.default.green("  ✓ semo/MEMORY.md 생성됨 (KB 인덱스)"));
+    (0, semo_workspace_1.generateUserMd)();
+    console.log(chalk_1.default.green("  ✓ semo/USER.md 확인됨 (사용자 프로필)"));
+    // 6. Standard 설치 (DB → ~/.claude/skills, commands, agents)
     await setupStandardGlobal();
-    // 4. Hooks 설치 (프로젝트 무관)
+    // 7. Hooks 설치
     await setupHooks(false);
-    // 5. MCP 설정 (글로벌 공통 서버)
+    // 8. MCP 설정
     if (!options.skipMcp) {
         await setupMCP(os.homedir(), [], options.force || false);
     }
-    // 6. 글로벌 CLAUDE.md에 KB-First 규칙 주입
-    await injectKbFirstToGlobalClaudeMd();
+    // 9. Thin Router CLAUDE.md 생성
+    console.log(chalk_1.default.cyan("\n📄 CLAUDE.md 라우터 생성"));
+    const kbFirstBlock = await buildKbFirstBlock();
+    (0, semo_workspace_1.generateThinRouter)(kbFirstBlock);
+    console.log(chalk_1.default.green("  ✓ ~/.claude/CLAUDE.md (thin router) 생성됨"));
     await (0, database_1.closeConnection)();
     // 결과 요약
-    console.log(chalk_1.default.green.bold("\n✅ SEMO 글로벌 온보딩 완료!\n"));
+    console.log(chalk_1.default.green.bold("\n✅ SEMO 온보딩 완료!\n"));
     console.log(chalk_1.default.cyan("설치된 구성:"));
-    console.log(chalk_1.default.gray("  ~/.semo.env              DB 접속정보 (권한 600)"));
-    console.log(chalk_1.default.gray("  ~/.claude/skills/        팀 스킬 (DB 기반)"));
-    console.log(chalk_1.default.gray("  ~/.claude/commands/      팀 커맨드 (DB 기반)"));
-    console.log(chalk_1.default.gray("  ~/.claude/agents/        팀 에이전트 (DB 기반, dedup)"));
+    console.log(chalk_1.default.gray("  ~/.claude/semo/.env            DB 접속정보 (권한 600)"));
+    console.log(chalk_1.default.gray("  ~/.claude/semo/SOUL.md         오케스트레이터 페르소나"));
+    console.log(chalk_1.default.gray("  ~/.claude/semo/MEMORY.md       KB 접근 가이드"));
+    console.log(chalk_1.default.gray("  ~/.claude/semo/USER.md         사용자 프로필"));
+    console.log(chalk_1.default.gray("  ~/.claude/semo/bots/           봇 워크스페이스 미러"));
+    console.log(chalk_1.default.gray("  ~/.claude/skills/              팀 스킬 (DB 기반)"));
+    console.log(chalk_1.default.gray("  ~/.claude/commands/            팀 커맨드 (DB 기반)"));
+    console.log(chalk_1.default.gray("  ~/.claude/agents/              팀 에이전트 (DB 기반)"));
+    console.log(chalk_1.default.gray("  ~/.claude/CLAUDE.md            Thin router + KB-First"));
     console.log(chalk_1.default.gray("  ~/.claude/settings.local.json  SessionStart/Stop 훅"));
-    console.log(chalk_1.default.gray("  ~/.claude/settings.json  Claude Code 설정 (유저레벨)"));
     console.log(chalk_1.default.cyan("\n다음 단계:"));
-    console.log(chalk_1.default.gray("  프로젝트 디렉토리에서 'semo init'을 실행하세요."));
+    console.log(chalk_1.default.gray("  Claude Code에서 프로젝트를 열면 SessionStart 훅이 자동으로 sync합니다."));
     console.log();
 });
-// === init 명령어 (프로젝트별 설정) ===
+// === init 명령어 (deprecated — onboarding으로 통합됨) ===
 program
     .command("init")
-    .description("현재 프로젝트에 SEMO 프로젝트 설정을 합니다 (글로벌: semo onboarding)")
-    .option("-f, --force", "기존 설정 덮어쓰기")
-    .option("--no-gitignore", ".gitignore 수정 생략")
-    .action(async (options) => {
-    console.log(chalk_1.default.cyan.bold("\n📁 SEMO 프로젝트 설정\n"));
-    const cwd = process.cwd();
-    // 0. 글로벌 설정 확인
-    if (!isGlobalSetupDone()) {
-        console.log(chalk_1.default.yellow("⚠ 글로벌 설정이 완료되지 않았습니다."));
-        console.log(chalk_1.default.gray("  먼저 'semo onboarding'을 실행하세요.\n"));
-        console.log(chalk_1.default.gray("  이 머신에서 처음 SEMO를 사용하시나요?"));
-        console.log(chalk_1.default.cyan("  → semo onboarding --credentials-gist <GIST_ID>\n"));
-        process.exit(1);
-    }
-    // 1. Git 레포지토리 확인
-    const spinner = (0, ora_1.default)("Git 레포지토리 확인 중...").start();
-    try {
-        (0, child_process_1.execSync)("git rev-parse --git-dir", { cwd, stdio: "pipe" });
-        spinner.succeed("Git 레포지토리 확인됨");
-    }
-    catch {
-        spinner.fail("Git 레포지토리가 아닙니다. 'git init'을 먼저 실행하세요.");
-        process.exit(1);
-    }
-    // 2. .claude 디렉토리 생성
-    const claudeDir = path.join(cwd, ".claude");
-    if (!fs.existsSync(claudeDir)) {
-        fs.mkdirSync(claudeDir, { recursive: true });
-        console.log(chalk_1.default.green("\n✓ .claude/ 디렉토리 생성됨"));
-    }
-    // 3. 로컬 스킬 경고 (기존 프로젝트 호환)
-    const localSkillsDir = path.join(claudeDir, "skills");
-    if (fs.existsSync(localSkillsDir)) {
-        try {
-            const localSkills = fs.readdirSync(localSkillsDir).filter(f => fs.statSync(path.join(localSkillsDir, f)).isDirectory());
-            if (localSkills.length > 0) {
-                console.log(chalk_1.default.yellow(`\nℹ 프로젝트 로컬 스킬이 감지되었습니다 (${localSkills.length}개).`));
-                console.log(chalk_1.default.gray("  글로벌 스킬(~/.claude/skills/)이 우선 적용됩니다."));
-                console.log(chalk_1.default.gray("  로컬 스킬을 제거하려면: rm -rf .claude/skills/ .claude/commands/ .claude/agents/\n"));
-            }
-        }
-        catch {
-            // ignore
-        }
-    }
-    // 4. Context Mesh 초기화
-    await setupContextMesh(cwd);
-    // 5. CLAUDE.md 생성 (프로젝트 규칙만, 스킬 목록 없음)
-    await setupClaudeMd(cwd, [], options.force || false);
-    // 6. .gitignore 업데이트
-    if (options.gitignore !== false) {
-        updateGitignore(cwd);
-    }
-    // 완료 메시지
-    console.log(chalk_1.default.green.bold("\n✅ SEMO 프로젝트 설정 완료!\n"));
-    console.log(chalk_1.default.cyan("생성된 파일:"));
-    console.log(chalk_1.default.gray("  {cwd}/.claude/CLAUDE.md          프로젝트 규칙"));
-    console.log(chalk_1.default.gray("  {cwd}/.claude/memory/context.md   프로젝트 상태"));
-    console.log(chalk_1.default.gray("  {cwd}/.claude/memory/decisions.md ADR"));
-    console.log(chalk_1.default.gray("  {cwd}/.claude/memory/projects.md  프로젝트 맵"));
-    console.log(chalk_1.default.cyan("\n다음 단계:"));
-    console.log(chalk_1.default.gray("  1. Claude Code에서 프로젝트 열기 (SessionStart 훅이 자동 sync)"));
-    console.log(chalk_1.default.gray("  2. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
-    console.log(chalk_1.default.gray("  3. /SEMO:help로 도움말 확인"));
-    console.log();
+    .description("[deprecated] semo onboarding으로 통합되었습니다")
+    .action(async () => {
+    console.log(chalk_1.default.yellow("\n⚠ 'semo init'은 'semo onboarding'으로 통합되었습니다.\n"));
+    console.log(chalk_1.default.cyan("  글로벌 설정이 필요하면:"));
+    console.log(chalk_1.default.gray("    semo onboarding\n"));
+    console.log(chalk_1.default.cyan("  이미 온보딩을 완료했다면:"));
+    console.log(chalk_1.default.gray("    Claude Code에서 프로젝트를 열면 SessionStart 훅이 자동으로 sync합니다.\n"));
 });
 // === Standard 설치 (DB 기반, 글로벌 ~/.claude/) ===
 async function setupStandardGlobal() {
@@ -1186,6 +1170,10 @@ const BASE_MCP_SERVERS = [
         scope: "user",
     },
 ];
+// === ~/.claude/semo/.env 설정 (자동 감지 → Gist → 프롬프트) ===
+// v4.5.0: ~/.semo.env → ~/.claude/semo/.env 이전
+const SEMO_ENV_PATH = path.join(os.homedir(), ".claude", "semo", ".env");
+const LEGACY_ENV_PATH = path.join(os.homedir(), ".semo.env");
 const SEMO_CREDENTIALS = [
     {
         key: "DATABASE_URL",
@@ -1210,10 +1198,12 @@ const SEMO_CREDENTIALS = [
     },
 ];
 function writeSemoEnvFile(creds) {
-    const envFile = path.join(os.homedir(), ".semo.env");
+    // 디렉토리 보장
+    fs.mkdirSync(path.dirname(SEMO_ENV_PATH), { recursive: true });
     const lines = [
         "# SEMO 환경변수 — 모든 컨텍스트에서 자동 로드됨",
         "# (Claude Code 앱, OpenClaw LaunchAgent, cron 등)",
+        "# 경로: ~/.claude/semo/.env (v4.5.0+)",
         "",
     ];
     // 레지스트리 키 먼저 (순서 보장)
@@ -1230,10 +1220,28 @@ function writeSemoEnvFile(creds) {
         }
     }
     lines.push("");
-    fs.writeFileSync(envFile, lines.join("\n"), { mode: 0o600 });
+    fs.writeFileSync(SEMO_ENV_PATH, lines.join("\n"), { mode: 0o600 });
+    // 하위 호환 심링크: ~/.semo.env → ~/.claude/semo/.env
+    try {
+        if (fs.existsSync(LEGACY_ENV_PATH)) {
+            const stat = fs.lstatSync(LEGACY_ENV_PATH);
+            if (!stat.isSymbolicLink()) {
+                // 기존 실파일은 백업 후 심링크로 교체
+                fs.renameSync(LEGACY_ENV_PATH, LEGACY_ENV_PATH + ".bak");
+            }
+            else {
+                fs.unlinkSync(LEGACY_ENV_PATH);
+            }
+        }
+        fs.symlinkSync(SEMO_ENV_PATH, LEGACY_ENV_PATH);
+    }
+    catch {
+        // 심링크 실패 시 무시 — 새 경로가 원본
+    }
 }
 function readSemoEnvCreds() {
-    const envFile = path.join(os.homedir(), ".semo.env");
+    // 새 경로 우선, 없으면 레거시 폴백
+    const envFile = fs.existsSync(SEMO_ENV_PATH) ? SEMO_ENV_PATH : LEGACY_ENV_PATH;
     if (!fs.existsSync(envFile))
         return {};
     try {
@@ -1304,17 +1312,16 @@ async function setupSemoEnv(credentialsGist, force) {
         }
     }
     // 5. 변경사항이 있거나 파일이 없으면 쓰기
-    const envFile = path.join(os.homedir(), ".semo.env");
     const needsWrite = force ||
         hasNewKeys ||
-        !fs.existsSync(envFile) ||
+        !fs.existsSync(SEMO_ENV_PATH) ||
         Object.keys(gistCreds).some((k) => !existing[k]);
     if (needsWrite) {
         writeSemoEnvFile(merged);
-        console.log(chalk_1.default.green("  ✅ ~/.semo.env 저장됨 (권한: 600)"));
+        console.log(chalk_1.default.green("  ✅ ~/.claude/semo/.env 저장됨 (권한: 600)"));
     }
     else {
-        console.log(chalk_1.default.gray("  ~/.semo.env 변경 없음"));
+        console.log(chalk_1.default.gray("  ~/.claude/semo/.env 변경 없음"));
     }
 }
 // === Claude MCP 서버 존재 여부 확인 ===
@@ -1441,30 +1448,7 @@ KB에 없으면: "KB에 해당 정보가 없습니다. 알려주시면 등록하
 **금지:** "알겠습니다/기억하겠습니다"만 하고 KB에 쓰지 않는 것.
 `;
 }
-async function injectKbFirstToGlobalClaudeMd() {
-    const globalClaudeMd = path.join(os.homedir(), ".claude", "CLAUDE.md");
-    const kbFirstBlock = await buildKbFirstBlock();
-    if (fs.existsSync(globalClaudeMd)) {
-        const content = fs.readFileSync(globalClaudeMd, "utf-8");
-        if (content.includes(KB_FIRST_SECTION_MARKER)) {
-            // 기존 섹션 교체
-            const regex = new RegExp(`\\n${KB_FIRST_SECTION_MARKER.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")}[\\s\\S]*?(?=\\n## |$)`, "m");
-            const updated = content.replace(regex, kbFirstBlock);
-            fs.writeFileSync(globalClaudeMd, updated);
-            console.log(chalk_1.default.gray("  ~/.claude/CLAUDE.md KB-First 규칙 업데이트됨"));
-        }
-        else {
-            // 끝에 추가
-            fs.writeFileSync(globalClaudeMd, content.trimEnd() + "\n" + kbFirstBlock);
-            console.log(chalk_1.default.green("  ✓ ~/.claude/CLAUDE.md에 KB-First 규칙 추가됨"));
-        }
-    }
-    else {
-        // 파일 없으면 생성
-        fs.writeFileSync(globalClaudeMd, kbFirstBlock.trim() + "\n");
-        console.log(chalk_1.default.green("  ✓ ~/.claude/CLAUDE.md 생성됨 (KB-First 규칙)"));
-    }
-}
+// injectKbFirstToGlobalClaudeMd 제거 — generateThinRouter()로 대체 (semo-workspace.ts)
 // === MCP 설정 ===
 async function setupMCP(cwd, _extensions, force) {
     console.log(chalk_1.default.cyan("\n🔧 Black Box 설정 (MCP Server)"));
@@ -1530,44 +1514,7 @@ async function setupMCP(cwd, _extensions, force) {
         console.log();
     }
 }
-// === .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/**
-semo-system/
-`;
-    if (fs.existsSync(gitignorePath)) {
-        let content = fs.readFileSync(gitignorePath, "utf-8");
-        // 이미 SEMO 블록이 있으면 스킵
-        if (content.includes("# === SEMO ===")) {
-            console.log(chalk_1.default.gray("  → SEMO 블록 이미 존재 (건너뜀)"));
-            return;
-        }
-        // 기존에 .claude/ 또는 .claude 전체 무시 항목 제거 (memory/ 접근을 위해)
-        const lines = content.split("\n");
-        const filtered = lines.filter(line => {
-            const trimmed = line.trim();
-            return trimmed !== ".claude" && trimmed !== ".claude/" && trimmed !== ".claude/**";
-        });
-        if (filtered.length !== lines.length) {
-            content = filtered.join("\n");
-            console.log(chalk_1.default.gray("  → 기존 .claude 무시 항목 제거됨 (memory/ 접근 허용)"));
-        }
-        // 기존 파일에 추가
-        fs.writeFileSync(gitignorePath, content + semoIgnoreBlock);
-        console.log(chalk_1.default.green("✓ .gitignore에 SEMO 규칙 추가됨"));
-    }
-    else {
-        // 새로 생성
-        fs.writeFileSync(gitignorePath, semoIgnoreBlock.trim() + "\n");
-        console.log(chalk_1.default.green("✓ .gitignore 생성됨 (SEMO 규칙 포함)"));
-    }
-}
+// updateGitignore 제거 — init 통합으로 프로젝트별 .gitignore 수정 불필요
 // === Hooks 설치/업데이트 ===
 async function setupHooks(isUpdate = false) {
     const action = isUpdate ? "업데이트" : "설치";
@@ -1583,7 +1530,7 @@ async function setupHooks(isUpdate = false) {
                 hooks: [
                     {
                         type: "command",
-                        command: ". ~/.semo.env 2>/dev/null; semo context sync 2>/dev/null || true",
+                        command: ". ~/.claude/semo/.env 2>/dev/null || . ~/.semo.env 2>/dev/null; semo context sync 2>/dev/null || true",
                         timeout: 30,
                     },
                 ],
@@ -1595,7 +1542,7 @@ async function setupHooks(isUpdate = false) {
                 hooks: [
                     {
                         type: "command",
-                        command: ". ~/.semo.env 2>/dev/null; semo context push 2>/dev/null || true",
+                        command: ". ~/.claude/semo/.env 2>/dev/null || . ~/.semo.env 2>/dev/null; semo context push 2>/dev/null || true",
                         timeout: 30,
                     },
                 ],
@@ -1961,7 +1908,7 @@ program
         console.log(chalk_1.default.gray("  대상: ~/.claude/skills, commands, agents (DB 최신)\n"));
         const connected = await (0, database_1.isDbConnected)();
         if (!connected) {
-            console.log(chalk_1.default.red("  DB 연결 실패 — ~/.semo.env를 확인하세요."));
+            console.log(chalk_1.default.red("  DB 연결 실패 — ~/.claude/semo/.env를 확인하세요."));
             await (0, database_1.closeConnection)();
             process.exit(1);
         }

package/dist/semo-workspace.d.ts

@@ -0,0 +1,42 @@
+/**
+ * semo-workspace — ~/.claude/semo/ 디렉토리 관리
+ *
+ * OpenClaw 봇 워크스페이스 스키마를 로컬에 미러링하여
+ * 로컬 Claude Code 세션이 봇 환경과 동형(isomorphic) 구조로 동작하게 한다.
+ *
+ * v4.5.0: onboarding/init 통합 — 글로벌 단일 설정
+ */
+/**
+ * ~/.claude/semo/ 디렉토리 트리 생성
+ */
+export declare function ensureSemoDir(): void;
+/**
+ * DB bot_workspace_files → ~/.claude/semo/bots/{botId}/ 미러링
+ *
+ * 1. getActiveBotIds() → 봇 목록
+ * 2. 봇별 getBotWorkspaceFiles() → 파일 쓰기
+ * 3. DB에 없는 orphan 파일 정리
+ */
+export declare function populateBotMirrors(): Promise<{
+    bots: number;
+    files: number;
+}>;
+/**
+ * 로컬 오케스트레이터 SOUL.md 생성
+ * (봇 SOUL.md와 동일 포맷 — bot_workspace_standard 준수)
+ */
+export declare function generateSoulMd(): Promise<void>;
+/**
+ * KB 접근 가이드 인덱스
+ */
+export declare function generateMemoryMd(): void;
+/**
+ * 사용자 프로필 플레이스홀더
+ */
+export declare function generateUserMd(): void;
+/**
+ * ~/.claude/CLAUDE.md를 얇은 라우터로 생성/교체
+ *
+ * @param kbFirstBlock - buildKbFirstBlock()의 결과 (index.ts에서 전달)
+ */
+export declare function generateThinRouter(kbFirstBlock: string): void;

package/dist/semo-workspace.js

@@ -0,0 +1,339 @@
+"use strict";
+/**
+ * semo-workspace — ~/.claude/semo/ 디렉토리 관리
+ *
+ * OpenClaw 봇 워크스페이스 스키마를 로컬에 미러링하여
+ * 로컬 Claude Code 세션이 봇 환경과 동형(isomorphic) 구조로 동작하게 한다.
+ *
+ * v4.5.0: onboarding/init 통합 — 글로벌 단일 설정
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ensureSemoDir = ensureSemoDir;
+exports.populateBotMirrors = populateBotMirrors;
+exports.generateSoulMd = generateSoulMd;
+exports.generateMemoryMd = generateMemoryMd;
+exports.generateUserMd = generateUserMd;
+exports.generateThinRouter = generateThinRouter;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+const database_1 = require("./database");
+// ============================================================
+// Constants
+// ============================================================
+const SEMO_DIR = path.join(os.homedir(), ".claude", "semo");
+const BOTS_DIR = path.join(SEMO_DIR, "bots");
+function getCliVersion() {
+    try {
+        const pkgPath = path.join(__dirname, "..", "package.json");
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, "utf-8"));
+        return pkg.version || "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+// ============================================================
+// Directory Setup
+// ============================================================
+/**
+ * ~/.claude/semo/ 디렉토리 트리 생성
+ */
+function ensureSemoDir() {
+    const dirs = [SEMO_DIR, BOTS_DIR];
+    for (const dir of dirs) {
+        fs.mkdirSync(dir, { recursive: true });
+    }
+}
+// ============================================================
+// Bot Mirrors
+// ============================================================
+/**
+ * DB bot_workspace_files → ~/.claude/semo/bots/{botId}/ 미러링
+ *
+ * 1. getActiveBotIds() → 봇 목록
+ * 2. 봇별 getBotWorkspaceFiles() → 파일 쓰기
+ * 3. DB에 없는 orphan 파일 정리
+ */
+async function populateBotMirrors() {
+    const botIds = await (0, database_1.getActiveBotIds)();
+    if (botIds.length === 0)
+        return { bots: 0, files: 0 };
+    let totalFiles = 0;
+    for (const botId of botIds) {
+        const botDir = path.join(BOTS_DIR, botId);
+        const files = await (0, database_1.getBotWorkspaceFiles)(botId);
+        if (files.length === 0)
+            continue;
+        // 쓰기
+        const writtenPaths = new Set();
+        for (const file of files) {
+            const filePath = path.join(botDir, file.file_path);
+            fs.mkdirSync(path.dirname(filePath), { recursive: true });
+            fs.writeFileSync(filePath, file.content);
+            writtenPaths.add(file.file_path);
+            totalFiles++;
+        }
+        // Orphan 정리: DB에 없는 로컬 파일 삭제
+        if (fs.existsSync(botDir)) {
+            cleanOrphans(botDir, botDir, writtenPaths);
+        }
+    }
+    // 봇 디렉토리 중 DB에 없는 것 정리
+    if (fs.existsSync(BOTS_DIR)) {
+        const localBotDirs = fs.readdirSync(BOTS_DIR).filter(f => fs.statSync(path.join(BOTS_DIR, f)).isDirectory());
+        for (const dir of localBotDirs) {
+            if (!botIds.includes(dir)) {
+                fs.rmSync(path.join(BOTS_DIR, dir), { recursive: true, force: true });
+            }
+        }
+    }
+    return { bots: botIds.length, files: totalFiles };
+}
+function cleanOrphans(baseDir, currentDir, validPaths) {
+    if (!fs.existsSync(currentDir))
+        return;
+    const entries = fs.readdirSync(currentDir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(currentDir, entry.name);
+        const relativePath = path.relative(baseDir, fullPath);
+        if (entry.isDirectory()) {
+            cleanOrphans(baseDir, fullPath, validPaths);
+            // 빈 디렉토리 정리
+            try {
+                const remaining = fs.readdirSync(fullPath);
+                if (remaining.length === 0)
+                    fs.rmdirSync(fullPath);
+            }
+            catch { /* ignore */ }
+        }
+        else if (!validPaths.has(relativePath)) {
+            fs.unlinkSync(fullPath);
+        }
+    }
+}
+// ============================================================
+// SOUL.md / MEMORY.md / USER.md Generation
+// ============================================================
+/**
+ * 로컬 오케스트레이터 SOUL.md 생성
+ * (봇 SOUL.md와 동일 포맷 — bot_workspace_standard 준수)
+ */
+async function generateSoulMd() {
+    const version = getCliVersion();
+    // 봇 로스터 생성
+    let botRoster = "";
+    try {
+        const pool = (0, database_1.getPool)();
+        const result = await pool.query(`SELECT bot_id, name, emoji, role, status
+       FROM semo.bot_status
+       WHERE status != 'retired'
+       ORDER BY bot_id`);
+        if (result.rows.length > 0) {
+            botRoster = "| Bot | Name | Role | Status |\n|-----|------|------|--------|\n";
+            for (const row of result.rows) {
+                botRoster += `| ${row.emoji || ""} ${row.bot_id} | ${row.name || row.bot_id} | ${row.role || "-"} | ${row.status || "-"} |\n`;
+            }
+        }
+    }
+    catch {
+        botRoster = "_DB 연결 실패 — 봇 정보를 가져올 수 없습니다._\n";
+    }
+    // 위임 매트릭스
+    let delegationMatrix = "";
+    try {
+        const delegations = await (0, database_1.getDelegations)();
+        if (delegations.length > 0) {
+            delegationMatrix = "\n## Delegation Matrix\n\n";
+            delegationMatrix += "| From | To | Type | Domains |\n|------|-----|------|--------|\n";
+            for (const d of delegations) {
+                delegationMatrix += `| ${d.from_bot_id} | ${d.to_bot_id} | ${d.delegation_type} | ${d.domains.join(", ")} |\n`;
+            }
+        }
+    }
+    catch { /* ignore */ }
+    const content = `# SEMO Local Orchestrator — SOUL
+
+> v${version} | Generated by \`semo onboarding\`
+
+## Identity
+
+- **Name**: SEMO Local Session
+- **Role**: Human-AI orchestration interface for Semicolon team
+- **Type**: Local Claude Code session (not an OpenClaw bot)
+
+## Mission
+
+사용자의 작업 요청을 적절한 봇 에이전트에 위임하거나 직접 처리한다.
+로컬 세션, KB, 봇 팀 간 컨텍스트 동기화를 유지한다.
+
+## Bot Roster
+
+${botRoster}
+${delegationMatrix}
+## Operating Procedures
+
+1. **KB-First**: 도메인 질문은 항상 \`semo kb search/get\`으로 KB 조회 후 답변
+2. **SoT Discipline**: 봇 목록/도메인 구조/워크스페이스 규칙을 하드코딩하지 않음
+3. **3-Party Sync**: 모든 변경은 DB ↔ KB ↔ 로컬 파일 영향을 고려
+
+## Constraints
+
+- \`~/.claude/semo/bots/\` 내부 파일은 DB 미러이므로 직접 수정 금지 (sync 시 덮어씀)
+- 봇 에이전트 호출 시 \`~/.claude/agents/\`의 정의를 사용
+- 스킬 실행 시 \`~/.claude/skills/\`의 정의를 사용
+
+---
+
+*Last updated: ${new Date().toISOString().split("T")[0]}*
+`;
+    fs.writeFileSync(path.join(SEMO_DIR, "SOUL.md"), content);
+}
+/**
+ * KB 접근 가이드 인덱스
+ */
+function generateMemoryMd() {
+    const content = `# SEMO Memory Index
+
+> KB(Knowledge Base)는 Single Source of Truth입니다.
+> 이 파일은 KB 접근 가이드이며, 실제 데이터는 DB에 있습니다.
+
+## KB 조회 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| \`semo kb search "쿼리"\` | 벡터+텍스트 하이브리드 검색 |
+| \`semo kb get <domain> <key> [sub_key]\` | domain+key 정확 조회 |
+| \`semo kb list --domain <domain>\` | 도메인별 엔트리 목록 |
+| \`semo kb upsert <domain> <key> [sub_key] --content "내용"\` | KB 항목 쓰기 |
+| \`semo kb ontology --action <action>\` | 온톨로지 조회 |
+
+## 봇 워크스페이스 미러
+
+\`~/.claude/semo/bots/\` 디렉토리에 각 봇의 워크스페이스 파일이 미러링됩니다.
+이 파일들은 \`semo context sync\` 시 DB에서 자동 갱신됩니다.
+
+---
+
+*Auto-generated by semo onboarding*
+`;
+    fs.writeFileSync(path.join(SEMO_DIR, "MEMORY.md"), content);
+}
+/**
+ * 사용자 프로필 플레이스홀더
+ */
+function generateUserMd() {
+    const userMdPath = path.join(SEMO_DIR, "USER.md");
+    // 이미 존재하면 덮어쓰지 않음 (사용자가 커스텀할 수 있음)
+    if (fs.existsSync(userMdPath))
+        return;
+    const content = `# User Profile
+
+> 이 파일은 사용자 프로필입니다.
+> \`semo kb get semicolon team/{name}\`으로 KB에서 가져오거나 직접 수정하세요.
+
+## 기본 정보
+
+| 항목 | 값 |
+|------|-----|
+| **이름** | _설정 필요_ |
+| **역할** | _설정 필요_ |
+
+---
+
+*수동 편집 가능 — semo onboarding이 덮어쓰지 않습니다*
+`;
+    fs.writeFileSync(userMdPath, content);
+}
+// ============================================================
+// Thin Router (CLAUDE.md)
+// ============================================================
+/**
+ * ~/.claude/CLAUDE.md를 얇은 라우터로 생성/교체
+ *
+ * @param kbFirstBlock - buildKbFirstBlock()의 결과 (index.ts에서 전달)
+ */
+function generateThinRouter(kbFirstBlock) {
+    const version = getCliVersion();
+    const globalClaudeMd = path.join(os.homedir(), ".claude", "CLAUDE.md");
+    const content = `# Global Claude Code Configuration
+
+> SEMO (Semicolon Orchestrate) v${version} installed.
+> Orchestrator profile: \`~/.claude/semo/SOUL.md\`
+> Bot roster & workspaces: \`~/.claude/semo/bots/\`
+
+## cmux Environment
+
+이 터미널은 **cmux** (Ghostty 기반 macOS 네이티브 터미널 멀티플렉서)에서 실행 중이다.
+사용자는 여러 프로젝트를 동시에 멀티태스킹하며, 각 워크스페이스가 별도 프로젝트에 대응한다.
+
+### cmux CLI 명령어
+
+| 명령어 | 설명 |
+|--------|------|
+| \`cmux identify\` | 현재 워크스페이스/서피스/패인 식별 |
+| \`cmux list-workspaces\` | 열린 워크스페이스 목록 |
+| \`cmux tree [--workspace <ref>]\` | 워크스페이스 내 패인/서피스/탭 구조 |
+| \`cmux read-screen --workspace <ref> [--surface <ref>] [--lines N]\` | 다른 탭/패인 화면 읽기 |
+| \`cmux send --workspace <ref> <text>\` | 다른 탭에 텍스트 전송 |
+
+### 활용 가이드라인
+
+- 다른 워크스페이스에서 실행 중인 빌드/테스트 상태를 \`cmux read-screen\`으로 확인 가능
+- 에러 로그나 서버 출력을 다른 패인에서 읽을 수 있음
+- \`cmux tree\`로 현재 열려 있는 전체 작업 환경을 파악할 수 있음
+- 사용자가 "다른 탭에서 뭐 돌아가고 있어?" 같은 질문을 하면 cmux 명령어로 확인
+
+${kbFirstBlock}
+`;
+    // 기존 파일 백업 (마이그레이션)
+    if (fs.existsSync(globalClaudeMd)) {
+        const existing = fs.readFileSync(globalClaudeMd, "utf-8");
+        // 이미 thin router인지 확인
+        if (!existing.includes("Orchestrator profile:")) {
+            const backupPath = globalClaudeMd + ".bak";
+            fs.writeFileSync(backupPath, existing);
+            console.log(chalk_1.default.gray(`  기존 CLAUDE.md 백업: ${backupPath}`));
+        }
+    }
+    fs.writeFileSync(globalClaudeMd, content);
+}
+// .env는 이제 ~/.claude/semo/.env에 직접 저장됨 (index.ts writeSemoEnvFile)
+// setupConfigEnvLink 제거 — v4.5.0

package/package.json

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