@team-semicolon/semo-cli 4.0.5 → 4.1.1

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,266 @@
+"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]);
+            }
+            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() {
@@ -772,6 +773,7 @@ program
     .option("--no-gitignore", ".gitignore 수정 생략")
     .option("--migrate", "레거시 환경 강제 마이그레이션")
     .option("--seed-skills", "semo-system/semo-skills/ → semo.skills DB 초기 시딩")
+    .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"));
@@ -822,8 +824,8 @@ program
     }
     // 7. Hooks 설치 (대화 로깅)
     await setupHooks(cwd, false);
-    // 7.5. ~/.semo.env 템플릿 생성 (없는 경우)
-    setupSemoEnvTemplate();
+    // 7.5. ~/.semo.env DB 접속 설정 (자동 감지 → Gist → 프롬프트)
+    await setupSemoEnv(options.credentialsGist);
     // 8. CLAUDE.md 생성
     await setupClaudeMd(cwd, [], options.force);
     // 9. 설치 검증
@@ -849,11 +851,11 @@ program
     console.log(chalk_1.default.gray("    ✓ semo-agents (14개 페르소나 Agent)"));
     console.log(chalk_1.default.gray("    ✓ semo-scripts (자동화 스크립트)"));
     console.log(chalk_1.default.cyan("\n다음 단계:"));
-    console.log(chalk_1.default.gray("  1. ~/.semo.env에 팀 DB 접속 정보 입력 (이미 존재하면 생략)"));
-    console.log(chalk_1.default.gray("     DATABASE_URL='postgres://user:pass@host:5432/appdb'"));
-    console.log(chalk_1.default.gray("  2. Claude Code에서 프로젝트 열기 (SessionStart 훅이 자동 sync)"));
-    console.log(chalk_1.default.gray("  3. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
-    console.log(chalk_1.default.gray("  4. /SEMO:help로 도움말 확인"));
+    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();
+    console.log(chalk_1.default.gray("  DB 접속정보 변경: nano ~/.semo.env"));
     console.log();
 });
 // === Standard 설치 (DB 기반) ===
@@ -1385,30 +1387,93 @@ const BASE_MCP_SERVERS = [
         args: ["-y", "@modelcontextprotocol/server-github"],
     },
 ];
-// === ~/.semo.env 템플릿 생성 ===
-function setupSemoEnvTemplate() {
+// === ~/.semo.env 설정 (자동 감지 → Gist → 프롬프트) ===
+function writeSemoEnvFile(dbUrl, slackWebhook = "") {
     const envFile = path.join(os.homedir(), ".semo.env");
-    if (fs.existsSync(envFile))
-        return; // 이미 존재하면 건너뜀
-    const template = `# SEMO 환경변수 — 모든 컨텍스트에서 자동 로드됨
+    const content = `# SEMO 환경변수 — 모든 컨텍스트에서 자동 로드됨
 # (Claude Code 앱, OpenClaw LaunchAgent, cron 등 비인터랙티브 환경 포함)
-#
-# 팀 Core DB 접속 정보를 여기에 입력하세요.
-# 설정 후 Claude Code 세션을 재시작하면 자동으로 context sync가 동작합니다.
 
-DATABASE_URL=''
+DATABASE_URL='${dbUrl}'
 
 # Slack 알림 Webhook (선택 — bot-ops 채널 dead-letter 감지용)
-SLACK_WEBHOOK=''
+SLACK_WEBHOOK='${slackWebhook}'
 `;
+    fs.writeFileSync(envFile, content, { mode: 0o600 });
+}
+function readSemoEnvDbUrl() {
+    const envFile = path.join(os.homedir(), ".semo.env");
+    if (!fs.existsSync(envFile))
+        return null;
+    const content = fs.readFileSync(envFile, "utf-8");
+    const match = content.match(/^DATABASE_URL='([^']+)'/m) || content.match(/^DATABASE_URL="([^"]+)"/m);
+    return match ? match[1] : null;
+}
+function fetchDbUrlFromGist(gistId) {
     try {
-        fs.writeFileSync(envFile, template, { mode: 0o600 });
-        console.log(chalk_1.default.cyan("\n📄 ~/.semo.env 템플릿 생성됨"));
-        console.log(chalk_1.default.yellow("  ⚠️  DATABASE_URL을 팀 Core DB 접속 정보로 채워주세요!"));
-        console.log(chalk_1.default.gray(`  파일: ${envFile}`));
+        const raw = (0, child_process_1.execSync)(`gh gist view ${gistId} --raw`, {
+            encoding: "utf-8",
+            stdio: ["pipe", "pipe", "pipe"],
+            timeout: 8000,
+        });
+        // Gist 파일 형식: DATABASE_URL=<url> 또는 단순 URL
+        const match = raw.match(/DATABASE_URL=['"]?([^'"\s]+)['"]?/) || raw.match(/^(postgres(?:ql)?:\/\/[^\s]+)/m);
+        return match ? match[1].trim() : null;
     }
     catch {
-        // silent — 권한 등으로 실패해도 무시
+        return null;
+    }
+}
+async function setupSemoEnv(credentialsGist) {
+    const envFile = path.join(os.homedir(), ".semo.env");
+    console.log(chalk_1.default.cyan("\n🔑 DB 접속 설정"));
+    // 1. 이미 env var로 설정됨
+    if (process.env.DATABASE_URL) {
+        console.log(chalk_1.default.green("  ✅ DATABASE_URL (환경변수)"));
+        if (!readSemoEnvDbUrl()) {
+            writeSemoEnvFile(process.env.DATABASE_URL);
+            console.log(chalk_1.default.gray(`  → ~/.semo.env 에 저장됨 (비인터랙티브 환경용)`));
+        }
+        return;
+    }
+    // 2. ~/.semo.env 에 이미 있음
+    const existing = readSemoEnvDbUrl();
+    if (existing) {
+        console.log(chalk_1.default.green("  ✅ DATABASE_URL (~/.semo.env)"));
+        return;
+    }
+    // 3. Private GitHub Gist 자동 fetch
+    const gistId = credentialsGist || process.env.SEMO_CREDENTIALS_GIST;
+    if (gistId) {
+        console.log(chalk_1.default.gray("  GitHub Gist에서 팀 접속정보 가져오는 중..."));
+        const url = fetchDbUrlFromGist(gistId);
+        if (url) {
+            writeSemoEnvFile(url);
+            console.log(chalk_1.default.green(`  ✅ Gist (${gistId.slice(0, 8)}...)에서 DATABASE_URL 설정됨`));
+            return;
+        }
+        console.log(chalk_1.default.yellow("  ⚠️  Gist fetch 실패 — 수동 입력으로 전환"));
+    }
+    // 4. 인터랙티브 프롬프트
+    console.log(chalk_1.default.gray("  팀 Core DB URL을 붙여넣으세요 (나중에 ~/.semo.env에서 수정 가능)"));
+    const { dbUrl } = await inquirer_1.default.prompt([
+        {
+            type: "password",
+            name: "dbUrl",
+            message: "DATABASE_URL:",
+            mask: "*",
+        },
+    ]);
+    if (dbUrl && dbUrl.trim()) {
+        writeSemoEnvFile(dbUrl.trim());
+        console.log(chalk_1.default.green("  ✅ ~/.semo.env 저장됨 (권한: 600)"));
+        console.log(chalk_1.default.gray(`  파일: ${envFile}`));
+    }
+    else {
+        // 빈 템플릿 생성
+        if (!fs.existsSync(envFile)) {
+            writeSemoEnvFile("");
+        }
+        console.log(chalk_1.default.yellow("  ⚠️  건너뜀 — ~/.semo.env에서 DATABASE_URL을 직접 입력하세요"));
     }
 }
 // === Claude MCP 서버 존재 여부 확인 ===
@@ -2309,6 +2374,59 @@ program
         console.log(chalk_1.default.cyan("\n새 환경 설치를 위해 'semo init'을 실행하세요.\n"));
     }
 });
+// === config 명령어 (설치 후 설정 변경) ===
+const configCmd = program.command("config").description("SEMO 설정 관리");
+configCmd
+    .command("db")
+    .description("팀 Core DB 접속정보 설정 (DATABASE_URL → ~/.semo.env)")
+    .option("--credentials-gist <gistId>", "Private GitHub Gist에서 자동 가져오기")
+    .action(async (options) => {
+    console.log(chalk_1.default.cyan.bold("\n🔑 DB 접속정보 설정\n"));
+    // 기존 값 확인
+    const existing = readSemoEnvDbUrl();
+    if (existing) {
+        const { overwrite } = await inquirer_1.default.prompt([
+            {
+                type: "confirm",
+                name: "overwrite",
+                message: `기존 DATABASE_URL이 있습니다. 덮어쓰시겠습니까?`,
+                default: false,
+            },
+        ]);
+        if (!overwrite) {
+            console.log(chalk_1.default.gray("취소됨"));
+            return;
+        }
+    }
+    // Gist 또는 프롬프트로 가져오기
+    const gistId = options.credentialsGist || process.env.SEMO_CREDENTIALS_GIST;
+    if (gistId) {
+        console.log(chalk_1.default.gray("GitHub Gist에서 접속정보 가져오는 중..."));
+        const url = fetchDbUrlFromGist(gistId);
+        if (url) {
+            writeSemoEnvFile(url);
+            console.log(chalk_1.default.green("✅ ~/.semo.env 업데이트 완료"));
+            return;
+        }
+        console.log(chalk_1.default.yellow("⚠️  Gist fetch 실패 — 수동 입력"));
+    }
+    const { dbUrl } = await inquirer_1.default.prompt([
+        {
+            type: "password",
+            name: "dbUrl",
+            message: "DATABASE_URL:",
+            mask: "*",
+        },
+    ]);
+    if (dbUrl && dbUrl.trim()) {
+        writeSemoEnvFile(dbUrl.trim());
+        console.log(chalk_1.default.green("✅ ~/.semo.env 저장됨 (권한: 600)"));
+        console.log(chalk_1.default.gray("  다음 Claude Code 세션부터 자동으로 적용됩니다."));
+    }
+    else {
+        console.log(chalk_1.default.yellow("취소됨"));
+    }
+});
 // === doctor 명령어 (설치 상태 진단) ===
 program
     .command("doctor")
@@ -2884,6 +3002,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.0.5",
+  "version": "4.1.1",
   "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
   "main": "dist/index.js",
   "bin": {