@team-semicolon/semo-cli 4.10.0 → 4.12.0

package/dist/commands/commitments.d.ts

@@ -0,0 +1,8 @@
+/**
+ * semo commitments — 봇 약속 추적 (Durable Task Tracking)
+ *
+ * 봇이 "~하겠습니다" 약속 후 세션 종료되어도 추적 가능하도록
+ * semo.bot_commitments 테이블에 기록하고, 워치독이 overdue/stale 감지.
+ */
+import { Command } from "commander";
+export declare function registerCommitmentsCommands(program: Command): void;

package/dist/commands/commitments.js

@@ -0,0 +1,361 @@
+"use strict";
+/**
+ * semo commitments — 봇 약속 추적 (Durable Task Tracking)
+ *
+ * 봇이 "~하겠습니다" 약속 후 세션 종료되어도 추적 가능하도록
+ * semo.bot_commitments 테이블에 기록하고, 워치독이 overdue/stale 감지.
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommitmentsCommands = registerCommitmentsCommands;
+const chalk_1 = __importDefault(require("chalk"));
+const database_1 = require("../database");
+// ─── ID 생성 ─────────────────────────────────────────────────────────────────
+function generateCommitmentId(botId) {
+    const rand = Math.random().toString(36).slice(2, 6);
+    return `cmt-${botId}-${Date.now()}-${rand}`;
+}
+// ─── deadline 파싱 ───────────────────────────────────────────────────────────
+function parseDeadline(input) {
+    const match = input.match(/^(\d+)(m|h|d)$/);
+    if (match) {
+        const value = parseInt(match[1]);
+        const unit = match[2];
+        const now = new Date();
+        if (unit === "m")
+            now.setMinutes(now.getMinutes() + value);
+        else if (unit === "h")
+            now.setHours(now.getHours() + value);
+        else if (unit === "d")
+            now.setDate(now.getDate() + value);
+        return now.toISOString();
+    }
+    // ISO 문자열이면 그대로
+    return new Date(input).toISOString();
+}
+// ─── Command registration ───────────────────────────────────────────────────
+function registerCommitmentsCommands(program) {
+    const cmd = program
+        .command("commitments")
+        .description("봇 약속 추적 (Durable Commitment Tracking)");
+    // ── semo commitments create ────────────────────────────────────────────────
+    cmd
+        .command("create")
+        .description("새 약속 등록")
+        .requiredOption("--bot-id <id>", "봇 ID")
+        .requiredOption("--title <text>", "약속 제목")
+        .option("--description <text>", "상세 설명")
+        .option("--source-type <type>", "출처 (github-issue|slack|cron|manual)")
+        .option("--source-ref <ref>", "출처 참조 (issue URL, channel:thread)")
+        .option("--deadline <time>", "기한 (15m, 1h, 2d, 또는 ISO 문자열)")
+        .option("--steps <json>", "단계 JSON 배열 (예: \'[{\"label\":\"Step1\",\"done\":false}]\')")
+        .action(async (options) => {
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            console.error(chalk_1.default.red("❌ DB 연결 실패"));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        const id = generateCommitmentId(options.botId);
+        const deadlineAt = options.deadline ? parseDeadline(options.deadline) : null;
+        let steps = [];
+        if (options.steps) {
+            try {
+                steps = JSON.parse(options.steps);
+            }
+            catch {
+                console.error(chalk_1.default.red("❌ --steps JSON 파싱 실패"));
+                await (0, database_1.closeConnection)();
+                process.exit(1);
+            }
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            await pool.query(`INSERT INTO semo.bot_commitments
+             (id, bot_id, status, title, description, source_type, source_ref, deadline_at, steps)
+           VALUES ($1, $2, 'pending', $3, $4, $5, $6, $7, $8)`, [
+                id,
+                options.botId,
+                options.title,
+                options.description ?? null,
+                options.sourceType ?? null,
+                options.sourceRef ?? null,
+                deadlineAt,
+                JSON.stringify(steps),
+            ]);
+            console.log(chalk_1.default.green(`✔ commitment created: ${id}`));
+            console.log(JSON.stringify({ id, bot_id: options.botId, title: options.title, deadline_at: deadlineAt }));
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`❌ create 실패: ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+    // ── semo commitments update ────────────────────────────────────────────────
+    cmd
+        .command("update <id>")
+        .description("진행 보고 (heartbeat, status, step 완료)")
+        .option("--heartbeat", "heartbeat 갱신")
+        .option("--status <status>", "상태 변경 (active|pending)")
+        .option("--step-done <label>", "특정 step을 완료 처리")
+        .action(async (id, options) => {
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            console.error(chalk_1.default.red("❌ DB 연결 실패"));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            if (options.heartbeat) {
+                await pool.query(`UPDATE semo.bot_commitments
+             SET last_heartbeat_at = NOW(),
+                 status = CASE WHEN status = 'pending' THEN 'active' ELSE status END
+             WHERE id = $1`, [id]);
+                console.log(chalk_1.default.green(`✔ heartbeat updated: ${id}`));
+            }
+            if (options.status) {
+                await pool.query(`UPDATE semo.bot_commitments SET status = $1 WHERE id = $2`, [options.status, id]);
+                console.log(chalk_1.default.green(`✔ status → ${options.status}: ${id}`));
+            }
+            if (options.stepDone) {
+                await pool.query(`UPDATE semo.bot_commitments
+             SET steps = (
+               SELECT jsonb_agg(
+                 CASE
+                   WHEN elem->>'label' = $2 THEN jsonb_set(elem, '{done}', 'true')
+                   ELSE elem
+                 END
+               )
+               FROM jsonb_array_elements(steps) AS elem
+             )
+             WHERE id = $1`, [id, options.stepDone]);
+                console.log(chalk_1.default.green(`✔ step done "${options.stepDone}": ${id}`));
+            }
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`❌ update 실패: ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+    // ── semo commitments done ──────────────────────────────────────────────────
+    cmd
+        .command("done <id>")
+        .description("약속 완료 처리")
+        .action(async (id) => {
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            console.error(chalk_1.default.red("❌ DB 연결 실패"));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            const result = await pool.query(`UPDATE semo.bot_commitments SET status = 'done' WHERE id = $1 AND status IN ('pending', 'active') RETURNING id`, [id]);
+            if (result.rowCount === 0) {
+                console.error(chalk_1.default.yellow(`⚠ commitment 없거나 이미 종료됨: ${id}`));
+            }
+            else {
+                console.log(chalk_1.default.green(`✔ commitment done: ${id}`));
+            }
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`❌ done 실패: ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+    // ── semo commitments fail ──────────────────────────────────────────────────
+    cmd
+        .command("fail <id>")
+        .description("약속 실패 처리")
+        .option("--reason <text>", "실패 사유")
+        .action(async (id, options) => {
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            console.error(chalk_1.default.red("❌ DB 연결 실패"));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            const metadataUpdate = options.reason
+                ? `, metadata = metadata || jsonb_build_object('fail_reason', $2::text)`
+                : "";
+            const params = options.reason ? [id, options.reason] : [id];
+            const result = await pool.query(`UPDATE semo.bot_commitments SET status = 'failed'${metadataUpdate} WHERE id = $1 AND status IN ('pending', 'active') RETURNING id`, params);
+            if (result.rowCount === 0) {
+                console.error(chalk_1.default.yellow(`⚠ commitment 없거나 이미 종료됨: ${id}`));
+            }
+            else {
+                console.log(chalk_1.default.green(`✔ commitment failed: ${id}`));
+            }
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`❌ fail 실패: ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+    // ── semo commitments list ──────────────────────────────────────────────────
+    cmd
+        .command("list")
+        .description("약속 목록 조회")
+        .option("--bot-id <id>", "특정 봇만")
+        .option("--status <status>", "상태 필터 (pending|active|done|failed|expired)")
+        .option("--limit <n>", "최대 조회 수", "20")
+        .option("--format <type>", "출력 형식 (table|json)", "table")
+        .action(async (options) => {
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            console.error(chalk_1.default.red("❌ DB 연결 실패"));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            const conditions = [];
+            const params = [];
+            let paramIdx = 1;
+            if (options.botId) {
+                conditions.push(`bot_id = $${paramIdx++}`);
+                params.push(options.botId);
+            }
+            if (options.status) {
+                conditions.push(`status = $${paramIdx++}`);
+                params.push(options.status);
+            }
+            const where = conditions.length > 0 ? `WHERE ${conditions.join(" AND ")}` : "";
+            params.push(parseInt(options.limit));
+            const result = await pool.query(`SELECT id, bot_id, status, title, deadline_at::text, steps,
+                  last_heartbeat_at::text, created_at::text, completed_at::text, metadata
+           FROM semo.bot_commitments
+           ${where}
+           ORDER BY created_at DESC
+           LIMIT $${paramIdx}`, params);
+            if (options.format === "json") {
+                console.log(JSON.stringify(result.rows, null, 2));
+            }
+            else {
+                console.log(chalk_1.default.cyan.bold("\n📋 Commitments\n"));
+                if (result.rows.length === 0) {
+                    console.log(chalk_1.default.yellow("  약속 없음"));
+                }
+                else {
+                    for (const c of result.rows) {
+                        const statusColor = c.status === "done" ? chalk_1.default.green :
+                            c.status === "failed" ? chalk_1.default.red :
+                                c.status === "expired" ? chalk_1.default.gray :
+                                    c.status === "active" ? chalk_1.default.cyan :
+                                        chalk_1.default.yellow;
+                        const deadline = c.deadline_at
+                            ? new Date(c.deadline_at).toLocaleString("ko-KR")
+                            : "-";
+                        const stepsInfo = Array.isArray(c.steps) && c.steps.length > 0
+                            ? ` [${c.steps.filter((s) => s.done).length}/${c.steps.length}]`
+                            : "";
+                        console.log(`  ${statusColor(c.status.padEnd(8))} ` +
+                            chalk_1.default.white(c.title.slice(0, 40).padEnd(42)) +
+                            chalk_1.default.gray(`${c.bot_id.padEnd(14)}`) +
+                            chalk_1.default.gray(`⏰ ${deadline}`) +
+                            chalk_1.default.cyan(stepsInfo));
+                        console.log(chalk_1.default.gray(`           ${c.id}`));
+                    }
+                }
+                console.log();
+            }
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`❌ list 실패: ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+    // ── semo commitments watch ─────────────────────────────────────────────────
+    cmd
+        .command("watch")
+        .description("워치독 — 활성 약속의 health 상태 조회")
+        .option("--format <type>", "출력 형식 (table|json)", "table")
+        .action(async (options) => {
+        const connected = await (0, database_1.isDbConnected)();
+        if (!connected) {
+            console.error(chalk_1.default.red("❌ DB 연결 실패"));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        try {
+            const pool = (0, database_1.getPool)();
+            const result = await pool.query(`SELECT id, bot_id, status, title, deadline_at::text,
+                  health, minutes_since_heartbeat, minutes_overdue,
+                  steps, last_heartbeat_at::text, created_at::text, metadata
+           FROM semo.v_active_commitments
+           ORDER BY
+             CASE health
+               WHEN 'overdue' THEN 0
+               WHEN 'stale' THEN 1
+               ELSE 2
+             END,
+             deadline_at ASC NULLS LAST`);
+            if (options.format === "json") {
+                const summary = {
+                    total: result.rows.length,
+                    overdue: result.rows.filter((r) => r.health === "overdue").length,
+                    stale: result.rows.filter((r) => r.health === "stale").length,
+                    on_track: result.rows.filter((r) => r.health === "on-track").length,
+                    commitments: result.rows,
+                };
+                console.log(JSON.stringify(summary, null, 2));
+            }
+            else {
+                console.log(chalk_1.default.cyan.bold("\n🔍 Commitment Watchdog\n"));
+                if (result.rows.length === 0) {
+                    console.log(chalk_1.default.green("  ✅ 활성 약속 없음 — all clear"));
+                }
+                else {
+                    for (const c of result.rows) {
+                        const healthColor = c.health === "overdue" ? chalk_1.default.red.bold :
+                            c.health === "stale" ? chalk_1.default.yellow :
+                                chalk_1.default.green;
+                        const overdue = c.minutes_overdue != null && c.minutes_overdue > 0
+                            ? ` (${Math.round(c.minutes_overdue)}분 초과)`
+                            : "";
+                        console.log(`  ${healthColor(c.health.padEnd(10))} ` +
+                            chalk_1.default.white(c.title.slice(0, 35).padEnd(37)) +
+                            chalk_1.default.gray(c.bot_id.padEnd(14)) +
+                            chalk_1.default.gray(`hb: ${Math.round(c.minutes_since_heartbeat)}분 전`) +
+                            chalk_1.default.red(overdue));
+                    }
+                    const overdue = result.rows.filter((r) => r.health === "overdue").length;
+                    const stale = result.rows.filter((r) => r.health === "stale").length;
+                    console.log();
+                    if (overdue > 0)
+                        console.log(chalk_1.default.red.bold(`  ⚠ ${overdue}건 overdue`));
+                    if (stale > 0)
+                        console.log(chalk_1.default.yellow(`  ⏳ ${stale}건 stale`));
+                }
+                console.log();
+            }
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`❌ watch 실패: ${err}`));
+            process.exit(1);
+        }
+        finally {
+            await (0, database_1.closeConnection)();
+        }
+    });
+}

package/dist/database.d.ts

@@ -75,6 +75,30 @@ export interface BotProtocol {
     value: Record<string, unknown>;
     description: string | null;
 }
+export interface BotCommitment {
+    id: string;
+    bot_id: string;
+    status: 'pending' | 'active' | 'done' | 'failed' | 'expired';
+    title: string;
+    description: string | null;
+    source_type: string | null;
+    source_ref: string | null;
+    deadline_at: string | null;
+    steps: Array<{
+        label: string;
+        done: boolean;
+    }>;
+    metadata: Record<string, unknown>;
+    last_heartbeat_at: string | null;
+    created_at: string;
+    updated_at: string;
+    completed_at: string | null;
+}
+export interface ActiveCommitmentView extends BotCommitment {
+    health: 'overdue' | 'stale' | 'on-track';
+    minutes_since_heartbeat: number;
+    minutes_overdue: number | null;
+}
 /**
  * 활성 스킬 목록 조회
  * SoT: skill_definitions (prompt as content — CLI 인터페이스 유지)

package/dist/index.js

@@ -65,6 +65,7 @@ const sessions_1 = require("./commands/sessions");
 const db_1 = require("./commands/db");
 const memory_1 = require("./commands/memory");
 const test_1 = require("./commands/test");
+const commitments_1 = require("./commands/commitments");
 const global_cache_1 = require("./global-cache");
 const semo_workspace_1 = require("./semo-workspace");
 const PACKAGE_NAME = "@team-semicolon/semo-cli";
@@ -1733,7 +1734,7 @@ kbCmd
 kbCmd
     .command("ontology")
     .description("온톨로지 조회 — 도메인/타입/스키마/라우팅 테이블")
-    .option("--action <type>", "동작 (list|show|services|types|instances|schema|routing-table|register|create-type|add-key|remove-key)", "list")
+    .option("--action <type>", "동작 (list|show|services|types|instances|schema|routing-table|register|unregister|create-type|add-key|remove-key)", "list")
     .option("--domain <name>", "action=show|register 시 도메인")
     .option("--type <name>", "action=schema|register|add-key|remove-key 시 타입 키")
     .option("--key <name>", "action=add-key|remove-key 시 스키마 키")
@@ -1744,6 +1745,8 @@ kbCmd
     .option("--service <name>", "action=register 시 서비스 그룹")
     .option("--tags <tags>", "action=register 시 태그 (쉼표 구분)")
     .option("--no-init", "action=register 시 필수 KB entry 자동 생성 건너뛰기")
+    .option("--force", "action=unregister 시 잔존 KB 항목도 모두 삭제")
+    .option("--yes", "action=unregister 시 확인 프롬프트 건너뛰기")
     .option("--format <type>", "출력 형식 (json|table)", "table")
     .action(async (options) => {
     try {
@@ -1989,8 +1992,64 @@ kbCmd
                 process.exit(1);
             }
         }
+        else if (action === "unregister") {
+            if (!options.domain) {
+                console.log(chalk_1.default.red("--domain 옵션이 필요합니다."));
+                process.exit(1);
+            }
+            // 도메인 정보 조회
+            const domainInfo = await (0, kb_1.ontoShow)(pool, options.domain);
+            if (!domainInfo) {
+                console.log(chalk_1.default.red(`\n❌ 도메인 '${options.domain}'은(는) 존재하지 않습니다.\n`));
+                process.exit(1);
+            }
+            // KB 엔트리 수 확인
+            const countRes = await pool.query("SELECT COUNT(*)::int AS cnt FROM semo.knowledge_base WHERE domain = $1", [options.domain]);
+            const kbCount = countRes.rows[0].cnt;
+            // 확인 프롬프트
+            if (!options.yes) {
+                const typeStr = domainInfo.entity_type ? ` [${domainInfo.entity_type}]` : "";
+                const svcStr = domainInfo.service && domainInfo.service !== "_global" ? ` (${domainInfo.service})` : "";
+                if (kbCount > 0 && options.force) {
+                    console.log(chalk_1.default.yellow(`\n⚠️  도메인 '${options.domain}'에 KB 항목 ${kbCount}건이 남아있습니다.`));
+                    console.log(chalk_1.default.yellow(`  --force 옵션으로 모두 삭제됩니다.\n`));
+                }
+                else {
+                    console.log(chalk_1.default.cyan(`\n📐 삭제 대상 도메인: ${options.domain}${typeStr}${svcStr}`));
+                    console.log(chalk_1.default.gray(`  KB 항목: ${kbCount}건\n`));
+                }
+                const { createInterface } = await import("readline");
+                const rl = createInterface({ input: process.stdin, output: process.stdout });
+                const answer = await new Promise((resolve) => {
+                    rl.question(chalk_1.default.yellow("  정말 삭제하시겠습니까? (y/N): "), resolve);
+                });
+                rl.close();
+                if (answer.toLowerCase() !== "y") {
+                    console.log(chalk_1.default.gray("  취소됨.\n"));
+                    await (0, database_1.closeConnection)();
+                    return;
+                }
+            }
+            const result = await (0, kb_1.ontoUnregister)(pool, options.domain, !!options.force);
+            if (options.format === "json") {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                if (result.success) {
+                    console.log(chalk_1.default.green(`\n✅ 도메인 '${options.domain}' 삭제 완료`));
+                    if (result.deleted_entries && result.deleted_entries > 0) {
+                        console.log(chalk_1.default.gray(`  KB 항목 ${result.deleted_entries}건 함께 삭제됨`));
+                    }
+                    console.log();
+                }
+                else {
+                    console.log(chalk_1.default.red(`\n❌ 삭제 실패: ${result.error}\n`));
+                    process.exit(1);
+                }
+            }
+        }
         else {
-            console.log(chalk_1.default.red(`알 수 없는 action: '${action}'. 사용 가능: list, show, services, types, instances, schema, routing-table, register, create-type, add-key, remove-key`));
+            console.log(chalk_1.default.red(`알 수 없는 action: '${action}'. 사용 가능: list, show, services, types, instances, schema, routing-table, register, create-type, add-key, remove-key, unregister`));
             process.exit(1);
         }
         await (0, database_1.closeConnection)();
@@ -2218,6 +2277,74 @@ ontoCmd
         process.exit(1);
     }
 });
+ontoCmd
+    .command("unregister <domain>")
+    .description("온톨로지 도메인 삭제 (KB 데이터 포함)")
+    .option("--force", "잔존 KB 항목이 있어도 모두 삭제 후 도메인 제거")
+    .option("--yes", "확인 프롬프트 건너뛰기")
+    .option("--format <type>", "출력 형식 (json|table)", "table")
+    .action(async (domain, options) => {
+    try {
+        const pool = (0, database_1.getPool)();
+        // 도메인 정보 조회
+        const domainInfo = await (0, kb_1.ontoShow)(pool, domain);
+        if (!domainInfo) {
+            console.log(chalk_1.default.red(`\n❌ 도메인 '${domain}'은(는) 존재하지 않습니다.\n`));
+            await (0, database_1.closeConnection)();
+            process.exit(1);
+        }
+        // KB 엔트리 수 확인
+        const countRes = await pool.query("SELECT COUNT(*)::int AS cnt FROM semo.knowledge_base WHERE domain = $1", [domain]);
+        const kbCount = countRes.rows[0].cnt;
+        // 확인 프롬프트
+        if (!options.yes) {
+            const typeStr = domainInfo.entity_type ? ` [${domainInfo.entity_type}]` : "";
+            const svcStr = domainInfo.service && domainInfo.service !== "_global" ? ` (${domainInfo.service})` : "";
+            if (kbCount > 0 && options.force) {
+                console.log(chalk_1.default.yellow(`\n⚠️  도메인 '${domain}'에 KB 항목 ${kbCount}건이 남아있습니다.`));
+                console.log(chalk_1.default.yellow(`  --force 옵션으로 모두 삭제됩니다.\n`));
+            }
+            else {
+                console.log(chalk_1.default.cyan(`\n📐 삭제 대상 도메인: ${domain}${typeStr}${svcStr}`));
+                console.log(chalk_1.default.gray(`  KB 항목: ${kbCount}건\n`));
+            }
+            const { createInterface } = await import("readline");
+            const rl = createInterface({ input: process.stdin, output: process.stdout });
+            const answer = await new Promise((resolve) => {
+                rl.question(chalk_1.default.yellow("  정말 삭제하시겠습니까? (y/N): "), resolve);
+            });
+            rl.close();
+            if (answer.toLowerCase() !== "y") {
+                console.log(chalk_1.default.gray("  취소됨.\n"));
+                await (0, database_1.closeConnection)();
+                return;
+            }
+        }
+        const result = await (0, kb_1.ontoUnregister)(pool, domain, !!options.force);
+        if (options.format === "json") {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            if (result.success) {
+                console.log(chalk_1.default.green(`\n✅ 도메인 '${domain}' 삭제 완료`));
+                if (result.deleted_entries && result.deleted_entries > 0) {
+                    console.log(chalk_1.default.gray(`  KB 항목 ${result.deleted_entries}건 함께 삭제됨`));
+                }
+                console.log();
+            }
+            else {
+                console.log(chalk_1.default.red(`\n❌ 삭제 실패: ${result.error}\n`));
+                process.exit(1);
+            }
+        }
+        await (0, database_1.closeConnection)();
+    }
+    catch (err) {
+        console.error(chalk_1.default.red(`삭제 실패: ${err}`));
+        await (0, database_1.closeConnection)();
+        process.exit(1);
+    }
+});
 // === 신규 v4 커맨드 그룹 등록 ===
 (0, context_1.registerContextCommands)(program);
 (0, bots_1.registerBotsCommands)(program);
@@ -2226,6 +2353,7 @@ ontoCmd
 (0, db_1.registerDbCommands)(program);
 (0, memory_1.registerMemoryCommands)(program);
 (0, test_1.registerTestCommands)(program);
+(0, commitments_1.registerCommitmentsCommands)(program);
 // === semo skills — DB 시딩 ===
 /**
  * SKILL.md frontmatter 파싱 (YAML 파서 없이 regex 기반)

package/dist/kb.d.ts

@@ -232,6 +232,17 @@ export interface OntoRegisterResult {
  * 4. If init_required (default true), create KB entries for required keys in kb_type_schema
  */
 export declare function ontoRegister(pool: Pool, opts: OntoRegisterOptions): Promise<OntoRegisterResult>;
+export interface OntoUnregisterResult {
+    success: boolean;
+    deleted_entries?: number;
+    error?: string;
+}
+/**
+ * Unregister an ontology domain.
+ * If force=false and KB entries exist, returns error with count.
+ * If force=true, deletes all KB entries in a transaction, then removes the domain.
+ */
+export declare function ontoUnregister(pool: Pool, domain: string, force: boolean): Promise<OntoUnregisterResult>;
 /**
  * Add a key to a type schema
  */

package/dist/kb.js

@@ -62,6 +62,7 @@ exports.ontoRoutingTable = ontoRoutingTable;
 exports.ontoListServices = ontoListServices;
 exports.ontoListInstances = ontoListInstances;
 exports.ontoRegister = ontoRegister;
+exports.ontoUnregister = ontoUnregister;
 exports.ontoAddKey = ontoAddKey;
 exports.ontoCreateType = ontoCreateType;
 exports.ontoRemoveKey = ontoRemoveKey;
@@ -1011,6 +1012,50 @@ async function ontoRegister(pool, opts) {
         client.release();
     }
 }
+/**
+ * Unregister an ontology domain.
+ * If force=false and KB entries exist, returns error with count.
+ * If force=true, deletes all KB entries in a transaction, then removes the domain.
+ */
+async function ontoUnregister(pool, domain, force) {
+    const client = await pool.connect();
+    try {
+        // 1. Check domain exists
+        const domainCheck = await client.query("SELECT domain, entity_type, service FROM semo.ontology WHERE domain = $1", [domain]);
+        if (domainCheck.rows.length === 0) {
+            return { success: false, error: `도메인 '${domain}'은(는) 존재하지 않습니다.` };
+        }
+        // 2. Count KB entries
+        const countResult = await client.query("SELECT COUNT(*)::int AS cnt FROM semo.knowledge_base WHERE domain = $1", [domain]);
+        const entryCount = countResult.rows[0].cnt;
+        // 3. If entries exist and no force → error
+        if (entryCount > 0 && !force) {
+            return {
+                success: false,
+                error: `도메인 '${domain}'에 KB 항목 ${entryCount}건이 남아있습니다. --force 옵션으로 모두 삭제 후 제거할 수 있습니다.`,
+            };
+        }
+        // 4. Transaction: delete KB entries (if any) → delete ontology
+        await client.query("BEGIN");
+        try {
+            let deletedEntries = 0;
+            if (entryCount > 0) {
+                const delResult = await client.query("DELETE FROM semo.knowledge_base WHERE domain = $1", [domain]);
+                deletedEntries = delResult.rowCount ?? 0;
+            }
+            await client.query("DELETE FROM semo.ontology WHERE domain = $1", [domain]);
+            await client.query("COMMIT");
+            return { success: true, deleted_entries: deletedEntries };
+        }
+        catch (err) {
+            await client.query("ROLLBACK");
+            return { success: false, error: String(err) };
+        }
+    }
+    finally {
+        client.release();
+    }
+}
 /**
  * Add a key to a type schema
  */

package/dist/semo-workspace.js

@@ -267,7 +267,7 @@ function generateUserMd() {
     const content = `# User Profile
 
 > 이 파일은 사용자 프로필입니다.
-> \`semo kb get semicolon team/{name}\`으로 KB에서 가져오거나 직접 수정하세요.
+> \`semo kb get {name} contact\`으로 KB에서 가져오거나 직접 수정하세요.
 
 ## 기본 정보
 

package/package.json

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