@team-semicolon/semo-cli 4.1.1 → 4.1.4

package/dist/commands/bots.js

@@ -50,6 +50,7 @@ const chalk_1 = __importDefault(require("chalk"));
 const ora_1 = __importDefault(require("ora"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
 const database_1 = require("../database");
 function parseIdentityMd(content) {
     const nameMatch = content.match(/\*\*Name:\*\*\s*(.+)/);
@@ -343,11 +344,23 @@ function registerBotsCommands(program) {
         catch (err) {
             await client.query("ROLLBACK");
             spinner.fail(`sync 실패: ${err}`);
-            process.exit(1);
-        }
-        finally {
             client.release();
             await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        client.release();
+        await (0, database_1.closeConnection)();
+        // sessions sync 연동: DB 연결 반납 후 별도 프로세스로 실행
+        console.log(chalk_1.default.gray("  → sessions sync 실행 중..."));
+        try {
+            const semoCmd = process.argv[1];
+            (0, child_process_1.spawnSync)(process.execPath, [semoCmd, "sessions", "sync", "--all"], {
+                stdio: "inherit",
+                timeout: 60000,
+            });
+        }
+        catch {
+            console.log(chalk_1.default.yellow("  ⚠ sessions sync 호출 실패 (무시)"));
         }
     });
     // ── semo bots set-status ─────────────────────────────────────

package/dist/commands/sessions.d.ts

@@ -1,16 +1,29 @@
 /**
  * semo sessions — 세션 추적
  *
- * Claude Code 훅(SessionStart / Stop)에서 stdin으로 전달되는 JSON을 파싱해
- * semo.bot_sessions 테이블에 upsert합니다.
+ * sync: 각 봇의 OpenClaw 게이트웨이(HTTP API) 또는 로컬 sessions.json에서
+ *       세션 데이터를 읽어 semo.bot_sessions에 upsert합니다.
  *
- * Claude Code hook stdin 구조:
- *   SessionStart: { session_id, transcript_path, cwd, hook_event_name }
- *   Stop:         { session_id, transcript_path, hook_event_name }
+ * push: Claude Code 훅(SessionStart / Stop)에서 stdin으로 전달되는 JSON을 파싱해
+ *       semo.bot_sessions 테이블에 upsert합니다. (Claude Code 직접 실행 시에만 유효)
  *
- * 사용법 (settings.json hooks):
- *   SessionStart → semo sessions push --bot-id workclaw --event start
- *   Stop         → semo sessions push --bot-id workclaw --event stop
+ * OpenClaw 봇은 게이트웨이(WS/HTTP 서버)로 운영되어 Claude Code 훅이 트리거되지 않으므로
+ * semo sessions sync --all 로 주기적으로 동기화해야 합니다.
+ *
+ * 게이트웨이 설정 위치: ~/.openclaw-{botId}/openclaw.json
+ *   gateway.port: 포트번호
+ *   gateway.auth.token: Bearer 토큰
+ *
+ * HTTP API: POST http://127.0.0.1:{port}/tools/invoke
+ *   { tool: "sessions_list", action: "json", args: {} }
+ *   응답: { ok: true, result: { content: [{ type: "text", text: "<JSON string>" }] } }
+ *   inner JSON: { count: N, sessions: [{ key, kind, channel, displayName, updatedAt, totalTokens }] }
+ *
+ * Fallback: ~/.openclaw-{botId}/agents/main/sessions/sessions.json
+ *   { "agent:main:slack:channel:xxx": { updatedAt: <unix ms>, ... }, ... }
  */
 import { Command } from "commander";
+export declare function syncBotSessions(botIds: string[], client: any): Promise<{
+    total: number;
+}>;
 export declare function registerSessionsCommands(program: Command): void;

package/dist/commands/sessions.js

@@ -2,16 +2,26 @@
 /**
  * semo sessions — 세션 추적
  *
- * Claude Code 훅(SessionStart / Stop)에서 stdin으로 전달되는 JSON을 파싱해
- * semo.bot_sessions 테이블에 upsert합니다.
+ * sync: 각 봇의 OpenClaw 게이트웨이(HTTP API) 또는 로컬 sessions.json에서
+ *       세션 데이터를 읽어 semo.bot_sessions에 upsert합니다.
  *
- * Claude Code hook stdin 구조:
- *   SessionStart: { session_id, transcript_path, cwd, hook_event_name }
- *   Stop:         { session_id, transcript_path, hook_event_name }
+ * push: Claude Code 훅(SessionStart / Stop)에서 stdin으로 전달되는 JSON을 파싱해
+ *       semo.bot_sessions 테이블에 upsert합니다. (Claude Code 직접 실행 시에만 유효)
  *
- * 사용법 (settings.json hooks):
- *   SessionStart → semo sessions push --bot-id workclaw --event start
- *   Stop         → semo sessions push --bot-id workclaw --event stop
+ * OpenClaw 봇은 게이트웨이(WS/HTTP 서버)로 운영되어 Claude Code 훅이 트리거되지 않으므로
+ * semo sessions sync --all 로 주기적으로 동기화해야 합니다.
+ *
+ * 게이트웨이 설정 위치: ~/.openclaw-{botId}/openclaw.json
+ *   gateway.port: 포트번호
+ *   gateway.auth.token: Bearer 토큰
+ *
+ * HTTP API: POST http://127.0.0.1:{port}/tools/invoke
+ *   { tool: "sessions_list", action: "json", args: {} }
+ *   응답: { ok: true, result: { content: [{ type: "text", text: "<JSON string>" }] } }
+ *   inner JSON: { count: N, sessions: [{ key, kind, channel, displayName, updatedAt, totalTokens }] }
+ *
+ * Fallback: ~/.openclaw-{botId}/agents/main/sessions/sessions.json
+ *   { "agent:main:slack:channel:xxx": { updatedAt: <unix ms>, ... }, ... }
  */
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
@@ -50,13 +60,94 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.syncBotSessions = syncBotSessions;
 exports.registerSessionsCommands = registerSessionsCommands;
 const chalk_1 = __importDefault(require("chalk"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const readline = __importStar(require("readline"));
+const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const database_1 = require("../database");
+function readOpenClawConfig(botId) {
+    const configPath = path.join(os.homedir(), `.openclaw-${botId}`, "openclaw.json");
+    if (!fs.existsSync(configPath))
+        return null;
+    try {
+        return JSON.parse(fs.readFileSync(configPath, "utf-8"));
+    }
+    catch {
+        return null;
+    }
+}
+// HTTP API로 게이트웨이에서 세션 목록 조회
+async function fetchSessionsFromGateway(botId) {
+    const config = readOpenClawConfig(botId);
+    if (!config?.gateway?.port || !config?.gateway?.auth?.token)
+        return null;
+    const { port, auth } = config.gateway;
+    const token = auth.token;
+    const url = `http://127.0.0.1:${port}/tools/invoke`;
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: {
+                "Authorization": `Bearer ${token}`,
+                "Content-Type": "application/json",
+            },
+            body: JSON.stringify({ tool: "sessions_list", action: "json", args: {} }),
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return null;
+        const outer = await res.json();
+        if (!outer.ok)
+            return null;
+        // 이중 JSON 파싱: result.content[0].text가 JSON 문자열
+        const textContent = outer.result?.content?.find(c => c.type === "text")?.text;
+        if (!textContent)
+            return null;
+        const inner = JSON.parse(textContent);
+        return inner.sessions ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+// Fallback: 로컬 sessions.json 파일 파싱
+function readSessionsFromFile(botId) {
+    const sessionsPath = path.join(os.homedir(), `.openclaw-${botId}`, "agents", "main", "sessions", "sessions.json");
+    if (!fs.existsSync(sessionsPath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(sessionsPath, "utf-8"));
+        return Object.entries(raw).map(([key, val]) => ({
+            key,
+            updatedAt: val.updatedAt,
+        }));
+    }
+    catch {
+        return null;
+    }
+}
+// GatewaySession → DB 컬럼 매핑
+function mapSessionToDb(s) {
+    // kind: "group" → isolated, 나머지 → main
+    const kind = s.kind === "group" ? "isolated" : "main";
+    // chat_type: key 패턴으로 파싱 (API의 channel 필드 우선)
+    let chatType = s.channel ?? "direct";
+    if (!s.channel) {
+        if (s.key.includes(":slack:"))
+            chatType = "slack";
+        else if (s.key.includes(":cron:"))
+            chatType = "cron";
+    }
+    // label: displayName 우선, 없으면 key에서 마지막 부분
+    const label = s.displayName ?? s.key.split(":").slice(-2).join(":");
+    // last_activity: unix ms → ISO string
+    const lastActivity = s.updatedAt ? new Date(s.updatedAt).toISOString() : null;
+    return { kind, chatType, label, lastActivity, totalTokens: s.totalTokens ?? null };
+}
 async function readStdin() {
     // stdin이 TTY면 hook에서 호출된 게 아님 → 빈 객체 반환
     if (process.stdin.isTTY)
@@ -120,6 +211,57 @@ async function countMessages(transcriptPath) {
         rl.on("error", () => resolve(0));
     });
 }
+// ─── 외부에서 호출 가능한 sync 헬퍼 ──────────────────────────────────────────
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function syncBotSessions(botIds, client) {
+    let totalUpserted = 0;
+    for (const botId of botIds) {
+        let sessions = await fetchSessionsFromGateway(botId);
+        if (!sessions)
+            sessions = readSessionsFromFile(botId);
+        if (!sessions || sessions.length === 0)
+            continue;
+        let upserted = 0;
+        let latestActivity = null;
+        for (const s of sessions) {
+            try {
+                const { kind, chatType, label, lastActivity, totalTokens } = mapSessionToDb(s);
+                await client.query(`INSERT INTO semo.bot_sessions
+             (bot_id, session_key, label, kind, chat_type, last_activity, message_count, synced_at)
+           VALUES ($1, $2, $3, $4, $5, $6, $7, NOW())
+           ON CONFLICT (bot_id, session_key) DO UPDATE SET
+             label         = EXCLUDED.label,
+             kind          = EXCLUDED.kind,
+             chat_type     = EXCLUDED.chat_type,
+             last_activity = COALESCE(EXCLUDED.last_activity, semo.bot_sessions.last_activity),
+             message_count = COALESCE(EXCLUDED.message_count, semo.bot_sessions.message_count),
+             synced_at     = NOW()`, [botId, s.key, label, kind, chatType, lastActivity, totalTokens]);
+                upserted++;
+                if (lastActivity) {
+                    const d = new Date(lastActivity);
+                    if (!latestActivity || d > latestActivity)
+                        latestActivity = d;
+                }
+            }
+            catch { /* 개별 세션 실패 무시 */ }
+        }
+        try {
+            await client.query(`UPDATE semo.bot_status
+         SET session_count = (SELECT COUNT(*) FROM semo.bot_sessions WHERE bot_id = $1),
+             last_active   = CASE
+               WHEN $2::timestamptz IS NOT NULL
+                 AND (last_active IS NULL OR $2::timestamptz > last_active)
+               THEN $2::timestamptz
+               ELSE last_active
+             END,
+             synced_at = NOW()
+         WHERE bot_id = $1`, [botId, latestActivity?.toISOString() ?? null]);
+        }
+        catch { /* bot_status 없으면 무시 */ }
+        totalUpserted += upserted;
+    }
+    return { total: totalUpserted };
+}
 // ─── Command registration ─────────────────────────────────────────────────────
 function registerSessionsCommands(program) {
     const sessionsCmd = program
@@ -189,6 +331,13 @@ function registerSessionsCommands(program) {
                last_activity = NOW(),
                message_count = COALESCE(EXCLUDED.message_count, semo.bot_sessions.message_count),
                synced_at     = NOW()`, [botId, sessionKey, label, options.kind, messageCount ?? null]);
+                // bot_status.session_count 갱신
+                await client.query(`UPDATE semo.bot_status
+             SET session_count = (
+               SELECT COUNT(*) FROM semo.bot_sessions WHERE bot_id = $1
+             ),
+             synced_at = NOW()
+             WHERE bot_id = $1`, [botId]);
             }
             client.release();
             console.log(chalk_1.default.green(`✔ sessions push [${event}] ${botId}/${sessionKey.slice(0, 8)}`));
@@ -202,6 +351,117 @@ function registerSessionsCommands(program) {
             await (0, database_1.closeConnection)();
         }
     });
+    // ── semo sessions sync ──────────────────────────────────────────────────────
+    sessionsCmd
+        .command("sync")
+        .description("OpenClaw 게이트웨이에서 세션 읽어 DB upsert")
+        .option("--bot-id <id>", "특정 봇만 동기화")
+        .option("--all", "semo.bot_status의 모든 봇 동기화")
+        .action(async (options) => {
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            console.log(chalk_1.default.red("❌ DB 연결 실패"));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        const pool = (0, database_1.getPool)();
+        const client = await pool.connect();
+        // 대상 봇 목록 결정
+        let botIds = [];
+        if (options.botId) {
+            botIds = [options.botId];
+        }
+        else if (options.all) {
+            try {
+                const r = await client.query("SELECT bot_id FROM semo.bot_status ORDER BY bot_id");
+                botIds = r.rows.map((row) => row.bot_id);
+            }
+            catch {
+                // bot_status 없으면 openclaw 디렉토리에서 자동 감지
+                const home = os.homedir();
+                botIds = fs.readdirSync(home)
+                    .filter(d => d.startsWith(".openclaw-"))
+                    .map(d => d.replace(".openclaw-", ""))
+                    .filter(id => id.length > 0);
+            }
+        }
+        else {
+            console.log(chalk_1.default.yellow("  --bot-id <id> 또는 --all 옵션 필요"));
+            client.release();
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        if (botIds.length === 0) {
+            console.log(chalk_1.default.yellow("  동기화할 봇 없음"));
+            client.release();
+            await (0, database_1.closeConnection)();
+            return;
+        }
+        console.log(chalk_1.default.cyan(`\n🔄 sessions sync — ${botIds.length}개 봇\n`));
+        let totalUpserted = 0;
+        for (const botId of botIds) {
+            process.stdout.write(chalk_1.default.gray(`  ${botId.padEnd(14)}`));
+            // 1) HTTP API 시도
+            let sessions = await fetchSessionsFromGateway(botId);
+            let source = "gateway";
+            // 2) Fallback: 로컬 파일
+            if (!sessions) {
+                sessions = readSessionsFromFile(botId);
+                source = "file";
+            }
+            if (!sessions || sessions.length === 0) {
+                console.log(chalk_1.default.yellow("세션 없음 (게이트웨이 오프라인, 파일 없음)"));
+                continue;
+            }
+            // DB upsert
+            let upserted = 0;
+            let latestActivity = null;
+            for (const s of sessions) {
+                try {
+                    const { kind, chatType, label, lastActivity, totalTokens } = mapSessionToDb(s);
+                    await client.query(`INSERT INTO semo.bot_sessions
+                 (bot_id, session_key, label, kind, chat_type, last_activity, message_count, synced_at)
+               VALUES ($1, $2, $3, $4, $5, $6, $7, NOW())
+               ON CONFLICT (bot_id, session_key) DO UPDATE SET
+                 label         = EXCLUDED.label,
+                 kind          = EXCLUDED.kind,
+                 chat_type     = EXCLUDED.chat_type,
+                 last_activity = COALESCE(EXCLUDED.last_activity, semo.bot_sessions.last_activity),
+                 message_count = COALESCE(EXCLUDED.message_count, semo.bot_sessions.message_count),
+                 synced_at     = NOW()`, [botId, s.key, label, kind, chatType, lastActivity, totalTokens]);
+                    upserted++;
+                    if (lastActivity) {
+                        const d = new Date(lastActivity);
+                        if (!latestActivity || d > latestActivity)
+                            latestActivity = d;
+                    }
+                }
+                catch {
+                    // 개별 세션 실패는 무시
+                }
+            }
+            // bot_status session_count + last_active 갱신
+            try {
+                await client.query(`UPDATE semo.bot_status
+             SET session_count = (SELECT COUNT(*) FROM semo.bot_sessions WHERE bot_id = $1),
+                 last_active   = CASE
+                   WHEN $2::timestamptz IS NOT NULL
+                     AND (last_active IS NULL OR $2::timestamptz > last_active)
+                   THEN $2::timestamptz
+                   ELSE last_active
+                 END,
+                 synced_at = NOW()
+             WHERE bot_id = $1`, [botId, latestActivity?.toISOString() ?? null]);
+            }
+            catch { /* bot_status 없으면 무시 */ }
+            totalUpserted += upserted;
+            console.log(chalk_1.default.green(`✔ ${upserted}개`) +
+                chalk_1.default.gray(` (${source}, total ${sessions.length})`));
+        }
+        client.release();
+        console.log(chalk_1.default.green(`\n✅ sessions sync 완료 — 총 ${totalUpserted}건 upsert\n`));
+        await (0, database_1.closeConnection)();
+    });
     // ── semo sessions list ───────────────────────────────────────────────────────
     sessionsCmd
         .command("list")

package/dist/index.js

@@ -676,6 +676,11 @@ async function confirmOverwrite(itemName, itemPath) {
     if (!fs.existsSync(itemPath)) {
         return true;
     }
+    // 비인터랙티브 환경(CI, 파이프) — 덮어쓰지 않고 기존 파일 유지
+    if (!process.stdin.isTTY) {
+        console.log(chalk_1.default.gray(`  → ${itemName} 이미 존재 (비인터랙티브 모드: 건너뜀)`));
+        return false;
+    }
     const { shouldOverwrite } = await inquirer_1.default.prompt([
         {
             type: "confirm",
@@ -776,7 +781,6 @@ program
     .option("--credentials-gist <gistId>", "Private GitHub Gist에서 팀 DB 접속정보 자동 가져오기")
     .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.1. 버전 비교
     await showVersionComparison(cwd);
@@ -810,6 +814,8 @@ program
         fs.mkdirSync(claudeDir, { recursive: true });
         console.log(chalk_1.default.green("\n✓ .claude/ 디렉토리 생성됨"));
     }
+    // 2.5. ~/.semo.env DB 접속 설정 (자동 감지 → Gist → 프롬프트) — DB 연결 전에 먼저
+    await setupSemoEnv(options.credentialsGist);
     // 3. Standard 설치 (semo-core + semo-skills)
     await setupStandard(cwd, options.force);
     // 4. MCP 설정
@@ -822,10 +828,8 @@ program
     if (options.gitignore !== false) {
         updateGitignore(cwd);
     }
-    // 7. Hooks 설치 (대화 로깅)
+    // 7. Hooks 설치
     await setupHooks(cwd, false);
-    // 7.5. ~/.semo.env DB 접속 설정 (자동 감지 → Gist → 프롬프트)
-    await setupSemoEnv(options.credentialsGist);
     // 8. CLAUDE.md 생성
     await setupClaudeMd(cwd, [], options.force);
     // 9. 설치 검증
@@ -845,11 +849,11 @@ program
         console.log(chalk_1.default.yellow.bold("\n⚠️ SEMO 설치 완료 (일부 문제 발견)\n"));
     }
     console.log(chalk_1.default.cyan("설치된 구성:"));
-    console.log(chalk_1.default.gray("  [Standard]"));
-    console.log(chalk_1.default.gray("    ✓ semo-core (원칙, 오케스트레이터)"));
-    console.log(chalk_1.default.gray("    ✓ semo-skills (13개 통합 스킬)"));
-    console.log(chalk_1.default.gray("    ✓ semo-agents (14개 페르소나 Agent)"));
-    console.log(chalk_1.default.gray("    ✓ semo-scripts (자동화 스크립트)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/skills/    (DB 기반 스킬)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/agents/    (DB 기반 에이전트)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/commands/  (슬래시 커맨드)"));
+    console.log(chalk_1.default.gray("  ✓ .claude/memory/    (컨텍스트 동기화)"));
+    console.log(chalk_1.default.gray("  ✓ ~/.claude/settings.local.json  (훅 등록)"));
     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. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
@@ -929,8 +933,6 @@ async function setupStandard(cwd, force) {
         }
         console.log(chalk_1.default.green(`  ✓ agents 설치 완료 (${agents.length}개)`));
         spinner.succeed("Standard 설치 완료 (DB 기반)");
-        // CLAUDE.md 생성
-        await generateClaudeMd(cwd);
     }
     catch (error) {
         spinner.fail("Standard 설치 실패");
@@ -1629,54 +1631,11 @@ semo-system/
 async function setupHooks(cwd, isUpdate = false) {
     const action = isUpdate ? "업데이트" : "설치";
     console.log(chalk_1.default.cyan(`\n🪝 Claude Code Hooks ${action}`));
-    console.log(chalk_1.default.gray("   전체 대화 로깅 시스템\n"));
-    const hooksDir = path.join(cwd, "semo-system", "semo-hooks");
-    // semo-hooks 디렉토리 확인
-    if (!fs.existsSync(hooksDir)) {
-        console.log(chalk_1.default.yellow("  ⚠ semo-hooks 디렉토리 없음 (건너뜀)"));
-        return;
-    }
-    // 1. npm install
-    console.log(chalk_1.default.gray("  → 의존성 설치 중..."));
-    try {
-        (0, child_process_1.execSync)("npm install", {
-            cwd: hooksDir,
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-    }
-    catch {
-        console.log(chalk_1.default.yellow("  ⚠ npm install 실패 (건너뜀)"));
-        return;
-    }
-    // 2. 빌드
-    console.log(chalk_1.default.gray("  → 빌드 중..."));
-    try {
-        (0, child_process_1.execSync)("npm run build", {
-            cwd: hooksDir,
-            stdio: ["pipe", "pipe", "pipe"],
-        });
-    }
-    catch {
-        console.log(chalk_1.default.yellow("  ⚠ 빌드 실패 (건너뜀)"));
-        return;
-    }
-    // 3. settings.local.json 설정
     const homeDir = process.env.HOME || process.env.USERPROFILE || "";
     const settingsPath = path.join(homeDir, ".claude", "settings.local.json");
-    const hooksCmd = `node ${path.join(hooksDir, "dist", "index.js")}`;
-    // hooks 설정 객체
+    // Core 훅: semo context sync/push — semo-hooks 유무와 무관하게 항상 등록
     const hooksConfig = {
         SessionStart: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} session-start`,
-                        timeout: 10,
-                    },
-                ],
-            },
             {
                 matcher: "",
                 hooks: [
@@ -1688,29 +1647,7 @@ async function setupHooks(cwd, isUpdate = false) {
                 ],
             },
         ],
-        UserPromptSubmit: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} user-prompt`,
-                        timeout: 5,
-                    },
-                ],
-            },
-        ],
         Stop: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} stop`,
-                        timeout: 10,
-                    },
-                ],
-            },
             {
                 matcher: "",
                 hooks: [
@@ -1722,19 +1659,37 @@ async function setupHooks(cwd, isUpdate = false) {
                 ],
             },
         ],
-        SessionEnd: [
-            {
-                matcher: "",
-                hooks: [
-                    {
-                        type: "command",
-                        command: `${hooksCmd} session-end`,
-                        timeout: 10,
-                    },
-                ],
-            },
-        ],
     };
+    // semo-hooks 빌드 (선택적 — semo-system 레포에서만 동작)
+    const hooksDir = path.join(cwd, "semo-system", "semo-hooks");
+    if (fs.existsSync(hooksDir)) {
+        let hooksBuilt = false;
+        try {
+            (0, child_process_1.execSync)("npm install", { cwd: hooksDir, stdio: ["pipe", "pipe", "pipe"] });
+            (0, child_process_1.execSync)("npm run build", { cwd: hooksDir, stdio: ["pipe", "pipe", "pipe"] });
+            hooksBuilt = true;
+        }
+        catch {
+            console.log(chalk_1.default.yellow("  ⚠ semo-hooks 빌드 실패 (core 훅만 등록)"));
+        }
+        if (hooksBuilt) {
+            const hooksCmd = `node ${path.join(hooksDir, "dist", "index.js")}`;
+            hooksConfig.SessionStart.unshift({
+                matcher: "",
+                hooks: [{ type: "command", command: `${hooksCmd} session-start`, timeout: 10 }],
+            });
+            hooksConfig.UserPromptSubmit = [
+                { matcher: "", hooks: [{ type: "command", command: `${hooksCmd} user-prompt`, timeout: 5 }] },
+            ];
+            hooksConfig.Stop.unshift({
+                matcher: "",
+                hooks: [{ type: "command", command: `${hooksCmd} stop`, timeout: 10 }],
+            });
+            hooksConfig.SessionEnd = [
+                { matcher: "", hooks: [{ type: "command", command: `${hooksCmd} session-end`, timeout: 10 }] },
+            ];
+        }
+    }
     // 기존 설정 로드 또는 새로 생성
     let existingSettings = {};
     const claudeConfigDir = path.join(homeDir, ".claude");
@@ -1935,133 +1890,132 @@ async function setupClaudeMd(cwd, _extensions, force) {
             return;
         }
     }
-    const orchestratorRefSection = `**반드시 읽어야 할 파일**: \`semo-system/semo-core/agents/orchestrator/orchestrator.md\`
-
-이 파일에서 라우팅 테이블, 의도 분류, 메시지 포맷을 확인하세요.`;
-    const claudeMdContent = `# SEMO Project Configuration
+    const projectName = path.basename(cwd);
+    const installDate = new Date().toISOString().split("T")[0];
+    const claudeMdContent = `# ${projectName} — Claude Configuration
 
-> SEMO (Semicolon Orchestrate) - AI Agent Orchestration Framework v${VERSION}
+> SEMO v${VERSION} 설치됨 (${installDate})
 
 ---
 
-## 🔴 MANDATORY: Memory Context (항시 참조)
-
-> **⚠️ 세션 시작 시 반드시 \`.claude/memory/\` 폴더의 파일들을 먼저 읽으세요. 예외 없음.**
+## SEMO란?
 
-### 필수 참조 파일
+**SEMO (Semicolon Orchestrate)** 는 OpenClaw 봇팀과 로컬 Claude Code 세션이
+**팀 Core DB를 단일 진실 공급원(Single Source of Truth)으로 공유**하는 컨텍스트 동기화 시스템이다.
 
 \`\`\`
-.claude/memory/
-├── context.md     # 프로젝트 상태, 기술 스택, 진행 중 작업
-├── decisions.md   # 아키텍처 결정 기록 (ADR)
-├── projects.md    # GitHub Projects 설정
-└── rules/         # 프로젝트별 커스텀 규칙
+로컬 Claude Code 세션
+    ↕ semo context sync / push
+팀 Core DB (PostgreSQL, semo 스키마)
+    ↕ 봇 세션 시작/종료 훅
+OpenClaw 봇팀 (7개 봇)
+  workclaw · reviewclaw · planclaw · designclaw
+  infraclaw · growthclaw · semiclaw
 \`\`\`
 
-**이 파일들은 세션의 컨텍스트를 유지하는 장기 기억입니다. 매 세션마다 반드시 읽고 시작하세요.**
+**이 CLAUDE.md가 설치된 프로젝트는 OpenClaw 봇팀의 컨텍스트를 실시간으로 공유받는다.**
 
 ---
 
-## 🔴 MANDATORY: Orchestrator-First Execution
+## 자동 동기화
 
-> **⚠️ 이 규칙은 모든 사용자 요청에 적용됩니다. 예외 없음.**
+세션 시작/종료 시 팀 Core DB와 자동 동기화됩니다.
 
-### 실행 흐름 (필수)
+| 시점 | 동작 |
+|------|------|
+| 세션 시작 | \`semo context sync\` → \`.claude/memory/\` 최신화 |
+| 세션 종료 | \`semo context push\` → \`decisions.md\` 변경분 DB 저장 |
+
+---
+
+## Memory Context
+
+\`.claude/memory/\` 파일들은 **팀 Core DB (\`semo\` 스키마)에서 자동으로 채워집니다**.
+직접 편집하지 마세요 — 세션 시작 시 덮어씌워집니다.
+
+| 파일 | DB 소스 | 방향 |
+|------|---------|------|
+| \`team.md\` | \`kb WHERE domain='team'\` | DB → 로컬 (읽기 전용) |
+| \`projects.md\` | \`kb WHERE domain='project'\` | DB → 로컬 (읽기 전용) |
+| \`decisions.md\` | \`kb WHERE domain='decision'\` | **양방향** (편집 가능, Stop 시 DB 저장) |
+| \`infra.md\` | \`kb WHERE domain='infra'\` | DB → 로컬 (읽기 전용) |
+| \`process.md\` | \`kb WHERE domain='process'\` | DB → 로컬 (읽기 전용) |
+| \`bots.md\` | \`semo.bot_status\` | DB → 로컬 (봇 상태) |
+| \`ontology.md\` | \`semo.ontology\` | DB → 로컬 (읽기 전용) |
+
+**decisions.md 만 편집 가능합니다.** 아키텍처 결정(ADR)을 여기에 기록하세요.
+
+---
+
+## 설치된 구성
 
 \`\`\`
-1. 사용자 요청 수신
-2. Orchestrator가 의도 분석 후 적절한 Agent/Skill 라우팅
-3. Agent/Skill이 작업 수행
-4. 실행 결과 반환
+.claude/
+├── CLAUDE.md       # 이 파일
+├── settings.json   # MCP 서버 설정 + SessionStart/Stop 훅
+├── memory/         # Core DB → 로컬 자동 동기화 컨텍스트
+├── skills/         # SEMO 스킬 (semo-system/semo-skills/ 링크)
+├── agents/         # SEMO 에이전트 (semo-system/meta/agents/ 링크)
+└── commands/SEMO   # 슬래시 커맨드 (semo-system/semo-core/commands/)
 \`\`\`
 
-### Orchestrator 참조
+---
 
-${orchestratorRefSection}
+## 프로젝트 규칙 (팀이 채워야 함)
 
----
+> 아래 섹션은 이 프로젝트 고유의 규칙을 기록하세요.
+> 팀 공통 규칙은 \`memory/process.md\`에 있습니다.
 
-## 🔴 NON-NEGOTIABLE RULES
+### 기술 스택
 
-### 1. Orchestrator-First Policy
+<!-- 예: Next.js 14, PostgreSQL, TypeScript strict mode -->
 
-> **모든 요청은 반드시 Orchestrator를 통해 라우팅됩니다. 직접 처리 금지.**
+### 브랜치 전략
 
-**직접 처리 금지 항목**:
-- 코드 작성/수정 → \`implementation-master\` 또는 \`coder\` 스킬
-- Git 커밋/푸시 → \`git-workflow\` 스킬
-- 품질 검증 → \`quality-master\` 또는 \`verify\` 스킬
-- 명세 작성 → \`spec-master\`
-- 일반 작업 → Orchestrator 분석 후 라우팅
+<!-- 예: main(prod) / dev(staging) / feat/* -->
 
-### 2. Pre-Commit Quality Gate
+### 코딩 컨벤션
 
-> **코드 변경이 포함된 커밋 전 반드시 Quality Gate를 통과해야 합니다.**
+<!-- 예: ESLint airbnb, 함수형 컴포넌트 필수, any 금지 -->
 
-\`\`\`bash
-# 필수 검증 순서
-npm run lint           # 1. ESLint 검사
-npx tsc --noEmit       # 2. TypeScript 타입 체크
-npm run build          # 3. 빌드 검증 (Next.js/TypeScript 프로젝트)
-\`\`\`
+### 아키텍처 특이사항
 
-**차단 항목**:
-- \`--no-verify\` 플래그 사용 금지
-- Quality Gate 우회 시도 거부
-- "그냥 커밋해줘", "빌드 생략해줘" 등 거부
+<!-- 예: DB 직접 접근 금지 — 반드시 API route 통해야 함 -->
 
 ---
 
-## 설치된 구성
-
-### Standard (필수)
-- **semo-core**: 원칙, 오케스트레이터, 공통 커맨드
-- **semo-skills**: 13개 통합 스킬
-  - 행동: coder, tester, planner, deployer, writer
-  - 운영: memory, notify-slack, feedback, version-updater, semo-help, semo-architecture-checker, circuit-breaker, list-bugs
+## Quality Gate
 
-## 구조
+코드 변경 커밋 전 필수:
 
-\`\`\`
-.claude/
-├── settings.json      # MCP 서버 설정 (Black Box)
-├── memory/            # Context Mesh (장기 기억)
-│   ├── context.md     # 프로젝트 상태
-│   ├── decisions.md   # 아키텍처 결정
-│   └── rules/         # 프로젝트별 규칙
-├── agents → semo-system/semo-core/agents
-├── skills → semo-system/semo-skills
-└── commands/SEMO → semo-system/semo-core/commands/SEMO
-
-semo-system/           # White Box (읽기 전용)
-├── semo-core/         # Layer 0: 원칙, 오케스트레이션
-└── semo-skills/       # Layer 1: 통합 스킬
+\`\`\`bash
+npm run lint       # ESLint
+npx tsc --noEmit   # TypeScript
+npm run build      # 빌드 검증
 \`\`\`
 
-## 사용 가능한 커맨드
+\`--no-verify\` 사용 금지.
+
+---
+
+## 슬래시 커맨드
 
 | 커맨드 | 설명 |
 |--------|------|
 | \`/SEMO:help\` | 도움말 |
 | \`/SEMO:feedback\` | 피드백 제출 |
-| \`/SEMO:update\` | SEMO 업데이트 |
-| \`/SEMO:onboarding\` | 온보딩 가이드 |
-| \`/SEMO:dry-run {프롬프트}\` | 명령 검증 (라우팅 시뮬레이션) |
-
-## Context Mesh 사용
-
-SEMO는 \`.claude/memory/\`를 통해 세션 간 컨텍스트를 유지합니다:
+| \`/SEMO:health\` | 환경 헬스체크 |
 
-- **context.md**: 프로젝트 상태, 진행 중인 작업
-- **decisions.md**: 아키텍처 결정 기록 (ADR)
-- **rules/**: 프로젝트별 커스텀 규칙
-
-memory 스킬이 자동으로 이 파일들을 관리합니다.
+---
 
-## References
+## 복구 명령어
 
-- [SEMO Principles](semo-system/semo-core/principles/PRINCIPLES.md)
-- [SEMO Skills](semo-system/semo-skills/)
+\`\`\`bash
+semo doctor              # 환경 진단 (DB 연결, 설치 상태)
+semo config db           # DB URL 재설정
+semo context sync        # memory/ 수동 최신화
+semo bots status         # 봇 상태 조회
+\`\`\`
 `;
     fs.writeFileSync(claudeMdPath, claudeMdContent);
     console.log(chalk_1.default.green("✓ .claude/CLAUDE.md 생성됨"));

package/package.json

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