@team-semicolon/semo-cli 4.1.5 → 4.2.0

package/dist/commands/get.js

@@ -2,11 +2,10 @@
 /**
  * semo get <resource> — 세션 중 실시간 DB 쿼리
  *
- * semo get projects  [--active]
+ * semo get projects  [--active] [--format table|json|md]
  * semo get bots      [--status online|offline]
  * semo get kb        [--domain <d>] [--key <k>] [--search <text>]
  * semo get ontology  [--domain <d>]
- * semo get tasks     [--project <p>] [--status <s>]
  * semo get sessions  [--bot <n>]
  */
 var __importDefault = (this && this.__importDefault) || function (mod) {
@@ -52,69 +51,42 @@ function registerGetCommands(program) {
     // ── semo get projects ───────────────────────────────────────
     getCmd
         .command("projects")
-        .description("프로젝트 목록 조회")
-        .option("--active", "활성 프로젝트만")
+        .description("프로젝트 목록 조회 (KB 기반)")
+        .option("--active", "활성 프로젝트만 (metadata.status='active')")
         .option("--format <type>", "출력 형식 (table|json|md)", "table")
         .action(async (options) => {
         const spinner = (0, ora_1.default)("프로젝트 조회 중...").start();
         const connected = await (0, database_1.isDbConnected)();
         if (!connected) {
-            // Fallback: show KB entries with domain=project
-            try {
-                const pool = (0, database_1.getPool)();
-                const { shared } = await (0, kb_1.kbList)(pool, { domain: "project", limit: 100 });
-                spinner.stop();
-                if (options.format === "json") {
-                    console.log(JSON.stringify(shared, null, 2));
-                }
-                else {
-                    printTable(["key", "content"], shared.map(e => [e.key, e.content.substring(0, 80)]), "📁 프로젝트 (KB 기반)");
-                }
-            }
-            catch {
-                spinner.fail("DB 연결 실패");
-            }
+            spinner.fail("DB 연결 실패");
             await (0, database_1.closeConnection)();
-            return;
+            process.exit(1);
         }
         try {
             const pool = (0, database_1.getPool)();
-            const client = await pool.connect();
-            let query = `
-          SELECT id, name, display_name, status, description, updated_at::text
-          FROM semo.projects
-        `;
-            const params = [];
+            let entries = await (0, kb_1.kbList)(pool, { domain: "project", limit: 100 });
             if (options.active) {
-                query += " WHERE status = 'active'";
-            }
-            query += " ORDER BY updated_at DESC";
-            let rows = [];
-            try {
-                const result = await client.query(query, params);
-                rows = result.rows;
-            }
-            catch {
-                // semo.projects table may not exist — fallback to KB
-                client.release();
-                const { shared } = await (0, kb_1.kbList)(pool, { domain: "project", limit: 100 });
-                spinner.stop();
-                if (options.format === "json") {
-                    console.log(JSON.stringify(shared, null, 2));
-                }
-                else {
-                    printTable(["key", "content"], shared.map(e => [e.key, e.content.substring(0, 80)]), "📁 프로젝트 (KB 기반)");
-                }
-                await (0, database_1.closeConnection)();
-                return;
+                entries = entries.filter(e => {
+                    const meta = e.metadata;
+                    return meta?.status === "active";
+                });
             }
-            client.release();
             spinner.stop();
             if (options.format === "json") {
-                console.log(JSON.stringify(rows, null, 2));
+                console.log(JSON.stringify(entries, null, 2));
+            }
+            else if (options.format === "md") {
+                for (const e of entries) {
+                    console.log(`\n## ${e.key}\n`);
+                    console.log(e.content);
+                }
             }
             else {
-                printTable(["ID", "이름", "상태", "설명"], rows.map(r => [r.id, r.display_name || r.name, r.status || "-", (r.description || "").substring(0, 60)]), "📁 프로젝트");
+                printTable(["key", "content", "updated_at"], entries.map(e => [
+                    e.key,
+                    (e.content || "").substring(0, 60),
+                    e.updated_at ? new Date(e.updated_at).toLocaleString("ko-KR") : "-",
+                ]), "📁 프로젝트 (KB)");
             }
         }
         catch (err) {
@@ -217,11 +189,11 @@ function registerGetCommands(program) {
                 entries = result.rows;
             }
             else {
-                const { shared } = await (0, kb_1.kbList)(pool, {
+                const kbEntries = await (0, kb_1.kbList)(pool, {
                     domain: options.domain,
                     limit,
                 });
-                entries = shared;
+                entries = kbEntries;
             }
             spinner.stop();
             if (options.format === "json") {
@@ -301,70 +273,6 @@ function registerGetCommands(program) {
             await (0, database_1.closeConnection)();
         }
     });
-    // ── semo get tasks ──────────────────────────────────────────
-    getCmd
-        .command("tasks")
-        .description("태스크 조회 (semo.tasks)")
-        .option("--project <name>", "프로젝트 필터")
-        .option("--status <s>", "상태 필터 (open|in_progress|done)")
-        .option("--limit <n>", "최대 결과 수", "20")
-        .option("--format <type>", "출력 형식 (table|json)", "table")
-        .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 pool = (0, database_1.getPool)();
-            const client = await pool.connect();
-            let query = "SELECT id, title, status, project_id, assignee_name, updated_at::text FROM semo.tasks";
-            const params = [];
-            const conditions = [];
-            let idx = 1;
-            if (options.project) {
-                conditions.push(`project_id = $${idx++}`);
-                params.push(options.project);
-            }
-            if (options.status) {
-                conditions.push(`status = $${idx++}`);
-                params.push(options.status);
-            }
-            if (conditions.length > 0) {
-                query += " WHERE " + conditions.join(" AND ");
-            }
-            query += ` ORDER BY updated_at DESC LIMIT $${idx++}`;
-            params.push(parseInt(options.limit));
-            let rows = [];
-            try {
-                const result = await client.query(query, params);
-                rows = result.rows;
-            }
-            catch {
-                client.release();
-                spinner.warn("semo.tasks 테이블이 없거나 접근 불가");
-                await (0, database_1.closeConnection)();
-                return;
-            }
-            client.release();
-            spinner.stop();
-            if (options.format === "json") {
-                console.log(JSON.stringify(rows, null, 2));
-            }
-            else {
-                printTable(["id", "title", "status", "assignee"], rows.map(r => [r.id, (r.title || "").substring(0, 50), r.status, r.assignee_name || "-"]), "📋 태스크");
-            }
-        }
-        catch (err) {
-            spinner.fail(`조회 실패: ${err}`);
-            process.exit(1);
-        }
-        finally {
-            await (0, database_1.closeConnection)();
-        }
-    });
     // ── semo get sessions ───────────────────────────────────────
     getCmd
         .command("sessions")

package/dist/commands/sessions.d.ts

@@ -23,7 +23,8 @@
  *   { "agent:main:slack:channel:xxx": { updatedAt: <unix ms>, ... }, ... }
  */
 import { Command } from "commander";
-export declare function syncBotSessions(botIds: string[], client: any): Promise<{
+import { PoolClient } from "pg";
+export declare function syncBotSessions(botIds: string[], client: PoolClient): Promise<{
     total: number;
 }>;
 export declare function registerSessionsCommands(program: Command): void;

package/dist/commands/sessions.js

@@ -69,6 +69,7 @@ const readline = __importStar(require("readline"));
 const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const database_1 = require("../database");
+// ─── OpenClaw config reader ─────────────────────────────────────────────────
 function readOpenClawConfig(botId) {
     const configPath = path.join(os.homedir(), `.openclaw-${botId}`, "openclaw.json");
     if (!fs.existsSync(configPath))
@@ -80,7 +81,7 @@ function readOpenClawConfig(botId) {
         return null;
     }
 }
-// HTTP API로 게이트웨이에서 세션 목록 조회
+// ─── HTTP API로 게이트웨이에서 세션 목록 조회 ───────────────────────────────
 async function fetchSessionsFromGateway(botId) {
     const config = readOpenClawConfig(botId);
     if (!config?.gateway?.port || !config?.gateway?.auth?.token)
@@ -104,7 +105,7 @@ async function fetchSessionsFromGateway(botId) {
         if (!outer.ok)
             return null;
         // 이중 JSON 파싱: result.content[0].text가 JSON 문자열
-        const textContent = outer.result?.content?.find(c => c.type === "text")?.text;
+        const textContent = outer.result?.content?.find((c) => c.type === "text")?.text;
         if (!textContent)
             return null;
         const inner = JSON.parse(textContent);
@@ -114,7 +115,7 @@ async function fetchSessionsFromGateway(botId) {
         return null;
     }
 }
-// Fallback: 로컬 sessions.json 파일 파싱
+// ─── Fallback: 로컬 sessions.json 파일 파싱 ────────────────────────────────
 function readSessionsFromFile(botId) {
     const sessionsPath = path.join(os.homedir(), `.openclaw-${botId}`, "agents", "main", "sessions", "sessions.json");
     if (!fs.existsSync(sessionsPath))
@@ -130,11 +131,9 @@ function readSessionsFromFile(botId) {
         return null;
     }
 }
-// GatewaySession → DB 컬럼 매핑
+// ─── 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:"))
@@ -142,14 +141,12 @@ function mapSessionToDb(s) {
         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 };
 }
+// ─── stdin reader ───────────────────────────────────────────────────────────
 async function readStdin() {
-    // stdin이 TTY면 hook에서 호출된 게 아님 → 빈 객체 반환
     if (process.stdin.isTTY)
         return {};
     return new Promise((resolve) => {
@@ -164,11 +161,10 @@ async function readStdin() {
                 resolve({});
             }
         });
-        // 500ms 타임아웃 — stdin이 오지 않으면 그냥 진행
         setTimeout(() => resolve({}), 500);
     });
 }
-// ─── 현재 git 브랜치 (label용) ───────────────────────────────────────────────
+// ─── 현재 git 브랜치 (label용) ──────────────────────────────────────────────
 function getGitBranch(cwd) {
     try {
         const dir = cwd || process.cwd();
@@ -176,15 +172,13 @@ function getGitBranch(cwd) {
             cwd: dir,
             stdio: ["ignore", "pipe", "ignore"],
             timeout: 2000,
-        })
-            .toString()
-            .trim();
+        }).toString().trim();
     }
     catch {
         return null;
     }
 }
-// ─── transcript.jsonl 메시지 수 카운트 ───────────────────────────────────────
+// ─── transcript.jsonl 메시지 수 카운트 ──────────────────────────────────────
 async function countMessages(transcriptPath) {
     if (!transcriptPath || !fs.existsSync(transcriptPath))
         return 0;
@@ -199,20 +193,16 @@ async function countMessages(transcriptPath) {
                 return;
             try {
                 const obj = JSON.parse(line);
-                // role이 있는 메시지(user/assistant)만 카운트
                 if (obj.role === "user" || obj.role === "assistant")
                     count++;
             }
-            catch {
-                // invalid line skip
-            }
+            catch { /* invalid line skip */ }
         });
         rl.on("close", () => resolve(count));
         rl.on("error", () => resolve(0));
     });
 }
-// ─── 외부에서 호출 가능한 sync 헬퍼 ──────────────────────────────────────────
-// eslint-disable-next-line @typescript-eslint/no-explicit-any
+// ─── 외부에서 호출 가능한 sync 헬퍼 ────────────────────────────────────────
 async function syncBotSessions(botIds, client) {
     let totalUpserted = 0;
     for (const botId of botIds) {
@@ -245,10 +235,11 @@ async function syncBotSessions(botIds, client) {
             }
             catch { /* 개별 세션 실패 무시 */ }
         }
+        // session_count는 trg_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
+         SET last_active = CASE
                WHEN $2::timestamptz IS NOT NULL
                  AND (last_active IS NULL OR $2::timestamptz > last_active)
                THEN $2::timestamptz
@@ -262,12 +253,12 @@ async function syncBotSessions(botIds, client) {
     }
     return { total: totalUpserted };
 }
-// ─── Command registration ─────────────────────────────────────────────────────
+// ─── Command registration ───────────────────────────────────────────────────
 function registerSessionsCommands(program) {
     const sessionsCmd = program
         .command("sessions")
         .description("세션 추적 (Claude Code 훅 연동)");
-    // ── semo sessions push ───────────────────────────────────────────────────────
+    // ── semo sessions push ────────────────────────────────────────────────────
     sessionsCmd
         .command("push")
         .description("현재 세션을 semo.bot_sessions에 기록 (훅에서 호출)")
@@ -278,21 +269,19 @@ function registerSessionsCommands(program) {
         .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 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 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);
         }
@@ -307,13 +296,7 @@ function registerSessionsCommands(program) {
                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]);
+                // session_count는 trg_session_count 트리거가 자동 관리
             }
             else if (event === "stop") {
                 await client.query(`UPDATE semo.bot_sessions
@@ -323,7 +306,7 @@ function registerSessionsCommands(program) {
              WHERE bot_id = $2 AND session_key = $3`, [messageCount ?? null, botId, sessionKey]);
             }
             else {
-                // heartbeat — 마지막 활동 시간 + 메시지 수 갱신
+                // 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())
@@ -331,19 +314,12 @@ 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]);
+                // session_count는 trg_session_count 트리거가 자동 관리
             }
             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);
         }
@@ -351,7 +327,7 @@ function registerSessionsCommands(program) {
             await (0, database_1.closeConnection)();
         }
     });
-    // ── semo sessions sync ──────────────────────────────────────────────────────
+    // ── semo sessions sync ────────────────────────────────────────────────────
     sessionsCmd
         .command("sync")
         .description("OpenClaw 게이트웨이에서 세션 읽어 DB upsert")
@@ -366,7 +342,6 @@ function registerSessionsCommands(program) {
         }
         const pool = (0, database_1.getPool)();
         const client = await pool.connect();
-        // 대상 봇 목록 결정
         let botIds = [];
         if (options.botId) {
             botIds = [options.botId];
@@ -377,7 +352,6 @@ function registerSessionsCommands(program) {
                 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-"))
@@ -401,10 +375,8 @@ function registerSessionsCommands(program) {
         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";
@@ -413,7 +385,6 @@ function registerSessionsCommands(program) {
                 console.log(chalk_1.default.yellow("세션 없음 (게이트웨이 오프라인, 파일 없음)"));
                 continue;
             }
-            // DB upsert
             let upserted = 0;
             let latestActivity = null;
             for (const s of sessions) {
@@ -436,15 +407,13 @@ function registerSessionsCommands(program) {
                             latestActivity = d;
                     }
                 }
-                catch {
-                    // 개별 세션 실패는 무시
-                }
+                catch { /* 개별 세션 실패 무시 */ }
             }
-            // bot_status session_count + last_active 갱신
+            // session_count는 trg_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
+             SET last_active = CASE
                    WHEN $2::timestamptz IS NOT NULL
                      AND (last_active IS NULL OR $2::timestamptz > last_active)
                    THEN $2::timestamptz
@@ -462,7 +431,7 @@ function registerSessionsCommands(program) {
         console.log(chalk_1.default.green(`\n✅ sessions sync 완료 — 총 ${totalUpserted}건 upsert\n`));
         await (0, database_1.closeConnection)();
     });
-    // ── semo sessions list ───────────────────────────────────────────────────────
+    // ── semo sessions list ────────────────────────────────────────────────────
     sessionsCmd
         .command("list")
         .description("bot_sessions 테이블 조회")

package/dist/commands/skill-sync.d.ts

@@ -0,0 +1,28 @@
+/**
+ * skill-sync — 봇 전용 스킬 파일 스캔 + DB 동기화
+ *
+ * semo bots sync (piggyback) 및 semo context sync (세션 훅) 양쪽에서 호출.
+ * 스킬 이름은 flat (예: 'kb-manager'), metadata.bot_ids 배열로 봇 매핑.
+ * 동일 스킬명이 여러 봇에 존재하면 bot_ids를 머지.
+ */
+import { PoolClient } from "pg";
+interface ScannedSkill {
+    name: string;
+    prompt: string;
+    package: string;
+    botId: string;
+}
+export interface SkillSyncResult {
+    botSpecific: number;
+    total: number;
+}
+/**
+ * semo-system/bot-workspaces 에서 봇 전용 스킬 파일 스캔
+ */
+export declare function scanSkills(semoSystemDir: string): ScannedSkill[];
+/**
+ * 스캔된 스킬을 skill_definitions에 upsert
+ * flat name + metadata.bot_ids 배열 사용, 동일 스킬명은 bot_ids 머지
+ */
+export declare function syncSkillsToDB(client: PoolClient, semoSystemDir: string): Promise<SkillSyncResult>;
+export {};

package/dist/commands/skill-sync.js

@@ -0,0 +1,111 @@
+"use strict";
+/**
+ * skill-sync — 봇 전용 스킬 파일 스캔 + DB 동기화
+ *
+ * semo bots sync (piggyback) 및 semo context sync (세션 훅) 양쪽에서 호출.
+ * 스킬 이름은 flat (예: 'kb-manager'), metadata.bot_ids 배열로 봇 매핑.
+ * 동일 스킬명이 여러 봇에 존재하면 bot_ids를 머지.
+ */
+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;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.scanSkills = scanSkills;
+exports.syncSkillsToDB = syncSkillsToDB;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * semo-system/bot-workspaces 에서 봇 전용 스킬 파일 스캔
+ */
+function scanSkills(semoSystemDir) {
+    const skills = [];
+    const workspacesDir = path.join(semoSystemDir, "bot-workspaces");
+    if (!fs.existsSync(workspacesDir))
+        return skills;
+    const botEntries = fs.readdirSync(workspacesDir, { withFileTypes: true });
+    for (const botEntry of botEntries) {
+        if (!botEntry.isDirectory())
+            continue;
+        const skillsDir = path.join(workspacesDir, botEntry.name, "skills");
+        if (!fs.existsSync(skillsDir))
+            continue;
+        const skillEntries = fs.readdirSync(skillsDir, { withFileTypes: true });
+        for (const skillEntry of skillEntries) {
+            if (!skillEntry.isDirectory())
+                continue;
+            if (skillEntry.name.endsWith(".skill"))
+                continue;
+            const skillMdPath = path.join(skillsDir, skillEntry.name, "SKILL.md");
+            if (!fs.existsSync(skillMdPath))
+                continue;
+            try {
+                skills.push({
+                    name: skillEntry.name,
+                    prompt: fs.readFileSync(skillMdPath, "utf-8"),
+                    package: "openclaw",
+                    botId: botEntry.name,
+                });
+            }
+            catch { /* skip unreadable */ }
+        }
+    }
+    return skills;
+}
+/**
+ * 스캔된 스킬을 skill_definitions에 upsert
+ * flat name + metadata.bot_ids 배열 사용, 동일 스킬명은 bot_ids 머지
+ */
+async function syncSkillsToDB(client, semoSystemDir) {
+    const skills = scanSkills(semoSystemDir);
+    for (const skill of skills) {
+        await client.query(`INSERT INTO skill_definitions (name, prompt, package, metadata, is_active, office_id)
+       VALUES ($1, $2, $3, $4, true, NULL)
+       ON CONFLICT (name, office_id) DO UPDATE SET
+         prompt = EXCLUDED.prompt,
+         package = EXCLUDED.package,
+         metadata = jsonb_set(
+           skill_definitions.metadata,
+           '{bot_ids}',
+           (SELECT jsonb_agg(DISTINCT v)
+            FROM jsonb_array_elements(
+              COALESCE(skill_definitions.metadata->'bot_ids', '[]'::jsonb) ||
+              COALESCE(EXCLUDED.metadata->'bot_ids', '[]'::jsonb)
+            ) AS v)
+         ),
+         updated_at = NOW()`, [skill.name, skill.prompt, skill.package, JSON.stringify({ bot_ids: [skill.botId] })]);
+    }
+    return {
+        botSpecific: skills.length,
+        total: skills.length,
+    };
+}

package/dist/commands/skill-sync.test.d.ts

@@ -0,0 +1,16 @@
+/**
+ * skill-sync 테스트 — scanSkills 함수의 파일 스캔 로직 검증
+ *
+ * 실행: npx ts-node packages/cli/src/commands/skill-sync.test.ts
+ *
+ * 테스트 케이스:
+ *   1. 빈 디렉토리 → 0개
+ *   2. 봇 전용 스킬 → flat name으로 반환
+ *   3. 복수 봇의 전용 스킬 — botId 정확성
+ *   4. .skill 확장자 디렉토리 → 스킵
+ *   5. SKILL.md 없는 디렉토리 → 스킵
+ *   6. 스킬 변경 감지 — 파일 수정 후 재스캔
+ *   7. 스킬 추가 감지 — 새 디렉토리 추가 후 재스캔
+ *   8. 스킬 삭제 감지 — SKILL.md 삭제 후 재스캔
+ */
+export {};