@team-semicolon/semo-cli 4.11.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";
@@ -2352,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/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.11.0",
+  "version": "4.12.0",
   "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
   "main": "dist/index.js",
   "bin": {