@team-semicolon/semo-cli 4.1.0 → 4.1.3

package/dist/commands/bots.js

@@ -330,6 +330,11 @@ function registerBotsCommands(program) {
                 }
             }
             await client.query("COMMIT");
+            // session_count를 bot_sessions 실제 집계로 갱신
+            await client.query(`UPDATE semo.bot_status bs
+           SET session_count = (
+             SELECT COUNT(*) FROM semo.bot_sessions WHERE bot_id = bs.bot_id
+           )`);
             spinner.succeed(`bots sync 완료: ${upserted}개 봇 업서트`);
             if (errors.length > 0) {
                 errors.forEach(e => console.log(chalk_1.default.red(`  ❌ ${e}`)));

package/dist/commands/sessions.d.ts

@@ -0,0 +1,16 @@
+/**
+ * semo sessions — 세션 추적
+ *
+ * Claude Code 훅(SessionStart / Stop)에서 stdin으로 전달되는 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 }
+ *
+ * 사용법 (settings.json hooks):
+ *   SessionStart → semo sessions push --bot-id workclaw --event start
+ *   Stop         → semo sessions push --bot-id workclaw --event stop
+ */
+import { Command } from "commander";
+export declare function registerSessionsCommands(program: Command): void;

package/dist/commands/sessions.js

@@ -0,0 +1,273 @@
+"use strict";
+/**
+ * semo sessions — 세션 추적
+ *
+ * Claude Code 훅(SessionStart / Stop)에서 stdin으로 전달되는 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 }
+ *
+ * 사용법 (settings.json hooks):
+ *   SessionStart → semo sessions push --bot-id workclaw --event start
+ *   Stop         → semo sessions push --bot-id workclaw --event stop
+ */
+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.registerSessionsCommands = registerSessionsCommands;
+const chalk_1 = __importDefault(require("chalk"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const child_process_1 = require("child_process");
+const database_1 = require("../database");
+async function readStdin() {
+    // stdin이 TTY면 hook에서 호출된 게 아님 → 빈 객체 반환
+    if (process.stdin.isTTY)
+        return {};
+    return new Promise((resolve) => {
+        let raw = "";
+        process.stdin.setEncoding("utf-8");
+        process.stdin.on("data", (chunk) => (raw += chunk));
+        process.stdin.on("end", () => {
+            try {
+                resolve(JSON.parse(raw));
+            }
+            catch {
+                resolve({});
+            }
+        });
+        // 500ms 타임아웃 — stdin이 오지 않으면 그냥 진행
+        setTimeout(() => resolve({}), 500);
+    });
+}
+// ─── 현재 git 브랜치 (label용) ───────────────────────────────────────────────
+function getGitBranch(cwd) {
+    try {
+        const dir = cwd || process.cwd();
+        return (0, child_process_1.execSync)("git rev-parse --abbrev-ref HEAD", {
+            cwd: dir,
+            stdio: ["ignore", "pipe", "ignore"],
+            timeout: 2000,
+        })
+            .toString()
+            .trim();
+    }
+    catch {
+        return null;
+    }
+}
+// ─── transcript.jsonl 메시지 수 카운트 ───────────────────────────────────────
+async function countMessages(transcriptPath) {
+    if (!transcriptPath || !fs.existsSync(transcriptPath))
+        return 0;
+    return new Promise((resolve) => {
+        let count = 0;
+        const rl = readline.createInterface({
+            input: fs.createReadStream(transcriptPath),
+            crlfDelay: Infinity,
+        });
+        rl.on("line", (line) => {
+            if (!line.trim())
+                return;
+            try {
+                const obj = JSON.parse(line);
+                // role이 있는 메시지(user/assistant)만 카운트
+                if (obj.role === "user" || obj.role === "assistant")
+                    count++;
+            }
+            catch {
+                // invalid line skip
+            }
+        });
+        rl.on("close", () => resolve(count));
+        rl.on("error", () => resolve(0));
+    });
+}
+// ─── Command registration ─────────────────────────────────────────────────────
+function registerSessionsCommands(program) {
+    const sessionsCmd = program
+        .command("sessions")
+        .description("세션 추적 (Claude Code 훅 연동)");
+    // ── semo sessions push ───────────────────────────────────────────────────────
+    sessionsCmd
+        .command("push")
+        .description("현재 세션을 semo.bot_sessions에 기록 (훅에서 호출)")
+        .requiredOption("--bot-id <id>", "봇 ID (e.g. workclaw)")
+        .option("--event <type>", "이벤트 종류 (start|stop|heartbeat)", "heartbeat")
+        .option("--label <text>", "세션 라벨 (미지정 시 git 브랜치 자동 감지)")
+        .option("--kind <kind>", "세션 종류 (main|isolated)", "main")
+        .action(async (options) => {
+        const botId = options.botId;
+        const event = options.event;
+        // stdin에서 Claude Code hook JSON 읽기
+        const hook = await readStdin();
+        const sessionKey = hook.session_id ||
+            process.env.CLAUDE_SESSION_ID ||
+            `${botId}-${Date.now()}`;
+        const branch = getGitBranch(hook.cwd);
+        const label = options.label ||
+            branch ||
+            path.basename(hook.cwd || process.cwd());
+        const messageCount = event === "stop" && hook.transcript_path
+            ? await countMessages(hook.transcript_path)
+            : undefined;
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            // 훅에서 호출 시 조용히 실패 (봇 세션에 영향 주지 않도록)
+            await (0, database_1.closeConnection)();
+            process.exit(0);
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            const client = await pool.connect();
+            if (event === "start") {
+                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, 'claude-code', NOW(), 0, NOW())
+             ON CONFLICT (bot_id, session_key) DO UPDATE SET
+               label         = EXCLUDED.label,
+               last_activity = NOW(),
+               synced_at     = NOW()`, [botId, sessionKey, label, options.kind]);
+                // 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]);
+            }
+            else if (event === "stop") {
+                await client.query(`UPDATE semo.bot_sessions
+             SET last_activity = NOW(),
+                 message_count = COALESCE($1, message_count),
+                 synced_at     = NOW()
+             WHERE bot_id = $2 AND session_key = $3`, [messageCount ?? null, botId, sessionKey]);
+            }
+            else {
+                // heartbeat — 마지막 활동 시간 + 메시지 수 갱신
+                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, 'claude-code', NOW(), COALESCE($5, 0), NOW())
+             ON CONFLICT (bot_id, session_key) DO UPDATE SET
+               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)}`));
+        }
+        catch (err) {
+            // 훅에서 호출 시 조용히 실패
+            console.error(chalk_1.default.red(`sessions push 실패: ${err}`));
+            process.exit(0);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+    // ── semo sessions list ───────────────────────────────────────────────────────
+    sessionsCmd
+        .command("list")
+        .description("bot_sessions 테이블 조회")
+        .option("--bot-id <id>", "특정 봇만")
+        .option("--limit <n>", "최대 조회 수", "20")
+        .option("--format <type>", "출력 형식 (table|json)", "table")
+        .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);
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            const client = await pool.connect();
+            const params = [];
+            let where = "";
+            if (options.botId) {
+                where = "WHERE bot_id = $1";
+                params.push(options.botId);
+            }
+            params.push(parseInt(options.limit));
+            const limitIdx = params.length;
+            const result = await client.query(`SELECT bot_id, session_key, label, kind, chat_type,
+                  last_activity::text, message_count
+           FROM semo.bot_sessions
+           ${where}
+           ORDER BY last_activity DESC NULLS LAST
+           LIMIT $${limitIdx}`, params);
+            client.release();
+            if (options.format === "json") {
+                console.log(JSON.stringify(result.rows, null, 2));
+            }
+            else {
+                console.log(chalk_1.default.cyan.bold("\n📋 세션 목록\n"));
+                if (result.rows.length === 0) {
+                    console.log(chalk_1.default.yellow("  세션 없음"));
+                }
+                else {
+                    for (const s of result.rows) {
+                        const ts = s.last_activity
+                            ? new Date(s.last_activity).toLocaleString("ko-KR")
+                            : "-";
+                        console.log(chalk_1.default.cyan(`  ${s.bot_id.padEnd(14)}`) +
+                            chalk_1.default.white(`${(s.label || s.session_key).padEnd(30)}`) +
+                            chalk_1.default.gray(`${ts}  ${s.message_count}msg`));
+                    }
+                }
+                console.log();
+            }
+        }
+        catch (err) {
+            console.log(chalk_1.default.red(`❌ 조회 실패: ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+}

package/dist/index.js

@@ -60,6 +60,7 @@ const database_1 = require("./database");
 const context_1 = require("./commands/context");
 const bots_1 = require("./commands/bots");
 const get_1 = require("./commands/get");
+const sessions_1 = require("./commands/sessions");
 const PACKAGE_NAME = "@team-semicolon/semo-cli";
 // package.json에서 버전 동적 로드
 function getCliVersion() {
@@ -675,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",
@@ -775,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);
@@ -809,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 설정
@@ -821,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. 설치 검증
@@ -844,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. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
@@ -928,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 설치 실패");
@@ -1628,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: [
@@ -1687,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: [
@@ -1721,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");
@@ -1934,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 생성됨"));
@@ -3001,6 +2956,7 @@ ontoCmd
 (0, context_1.registerContextCommands)(program);
 (0, bots_1.registerBotsCommands)(program);
 (0, get_1.registerGetCommands)(program);
+(0, sessions_1.registerSessionsCommands)(program);
 // === semo skills — DB 시딩 ===
 /**
  * SKILL.md frontmatter 파싱 (YAML 파서 없이 regex 기반)

package/package.json

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