@team-semicolon/semo-cli 4.3.0 → 4.4.0

package/dist/kb.js

@@ -54,9 +54,24 @@ exports.ontoShow = ontoShow;
 exports.ontoListTypes = ontoListTypes;
 exports.ontoValidate = ontoValidate;
 exports.kbDigest = kbDigest;
+exports.kbGet = kbGet;
+exports.kbUpsert = kbUpsert;
+exports.ontoListSchema = ontoListSchema;
+exports.ontoRoutingTable = ontoRoutingTable;
+exports.ontoListServices = ontoListServices;
+exports.ontoListInstances = ontoListInstances;
 exports.ontoPullToLocal = ontoPullToLocal;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
+function splitKey(combinedKey) {
+    const idx = combinedKey.indexOf('/');
+    if (idx === -1)
+        return { key: combinedKey, subKey: '' };
+    return { key: combinedKey.substring(0, idx), subKey: combinedKey.substring(idx + 1) };
+}
+function combineKey(key, subKey) {
+    return subKey ? `${key}/${subKey}` : key;
+}
 // ============================================================
 // Embedding
 // ============================================================
@@ -185,7 +200,7 @@ async function kbPull(pool, domain, cwd) {
     const client = await pool.connect();
     try {
         let query = `
-      SELECT domain, key, content, metadata, created_by, version,
+      SELECT domain, key, sub_key, content, metadata, created_by, version,
              created_at::text, updated_at::text
       FROM semo.knowledge_base
     `;
@@ -242,12 +257,13 @@ async function kbPush(pool, entries, createdBy, cwd) {
             try {
                 const embedding = embeddings[i];
                 const embeddingStr = embedding ? `[${embedding.join(",")}]` : null;
-                await client.query(`INSERT INTO semo.knowledge_base (domain, key, content, metadata, created_by, embedding)
-           VALUES ($1, $2, $3, $4, $5, $6::vector)
-           ON CONFLICT (domain, key) DO UPDATE SET
+                const { key: flatKey, subKey } = splitKey(entry.key);
+                await client.query(`INSERT INTO semo.knowledge_base (domain, key, sub_key, content, metadata, created_by, embedding)
+           VALUES ($1, $2, $3, $4, $5, $6, $7::vector)
+           ON CONFLICT (domain, key, sub_key) DO UPDATE SET
              content = EXCLUDED.content,
              metadata = EXCLUDED.metadata,
-             embedding = EXCLUDED.embedding`, [entry.domain, entry.key, entry.content, JSON.stringify(entry.metadata || {}), entry.created_by || createdBy || "unknown", embeddingStr]);
+             embedding = EXCLUDED.embedding`, [entry.domain, flatKey, subKey, entry.content, JSON.stringify(entry.metadata || {}), entry.created_by || createdBy || "unknown", embeddingStr]);
                 upserted++;
             }
             catch (err) {
@@ -307,7 +323,7 @@ async function kbList(pool, options) {
     const limit = options.limit || 50;
     const offset = options.offset || 0;
     try {
-        let query = "SELECT domain, key, content, metadata, created_by, version, updated_at::text FROM semo.knowledge_base";
+        let query = "SELECT domain, key, sub_key, content, metadata, created_by, version, updated_at::text FROM semo.knowledge_base";
         const params = [];
         let paramIdx = 1;
         if (options.domain) {
@@ -322,7 +338,7 @@ async function kbList(pool, options) {
                 params.push(serviceDomains);
             }
         }
-        query += ` ORDER BY domain, key LIMIT $${paramIdx++} OFFSET $${paramIdx++}`;
+        query += ` ORDER BY domain, key, sub_key LIMIT $${paramIdx++} OFFSET $${paramIdx++}`;
         params.push(limit, offset);
         const result = await client.query(query, params);
         return result.rows;
@@ -352,7 +368,7 @@ async function kbSearch(pool, query, options) {
                 const embeddingStr = `[${queryEmbedding.join(",")}]`;
                 // Vector search on shared KB
                 let sql = `
-          SELECT domain, key, content, metadata, created_by, version, updated_at::text,
+          SELECT domain, key, sub_key, content, metadata, created_by, version, updated_at::text,
                  1 - (embedding <=> $1::vector) as score
           FROM semo.knowledge_base
           WHERE embedding IS NOT NULL
@@ -386,7 +402,7 @@ async function kbSearch(pool, query, options) {
             // Build per-token ILIKE conditions + count matching tokens for scoring
             const tokenConditions = tokens.map(token => {
                 textParams.push(`%${token}%`);
-                return `(CASE WHEN content ILIKE $${tIdx} OR key ILIKE $${tIdx++} THEN 1 ELSE 0 END)`;
+                return `(CASE WHEN content ILIKE $${tIdx} OR key ILIKE $${tIdx} OR sub_key ILIKE $${tIdx++} THEN 1 ELSE 0 END)`;
             });
             // Score = 0.7 base + 0.15 * (matched_tokens / total_tokens), capped at 0.95
             const matchCountExpr = tokenConditions.length > 0
@@ -394,12 +410,12 @@ async function kbSearch(pool, query, options) {
                 : "0";
             const scoreExpr = `LEAST(0.95, 0.7 + 0.15 * (${matchCountExpr})::float / ${Math.max(tokens.length, 1)})`;
             // WHERE: any token matches
-            const whereTokens = tokens.map((_, i) => `(content ILIKE $${i + 1} OR key ILIKE $${i + 1})`);
+            const whereTokens = tokens.map((_, i) => `(content ILIKE $${i + 1} OR key ILIKE $${i + 1} OR sub_key ILIKE $${i + 1})`);
             const whereClause = whereTokens.length > 0
                 ? whereTokens.join(" OR ")
                 : "FALSE";
             let textSql = `
-        SELECT domain, key, content, metadata, created_by, version, updated_at::text,
+        SELECT domain, key, sub_key, content, metadata, created_by, version, updated_at::text,
                ${scoreExpr} as score
         FROM semo.knowledge_base
         WHERE ${whereClause}
@@ -419,10 +435,10 @@ async function kbSearch(pool, query, options) {
             // Deduplicate by domain/key; if already in semantic results, boost its score
             const resultMap = new Map();
             for (const r of results) {
-                resultMap.set(`${r.domain}/${r.key}`, r);
+                resultMap.set(`${r.domain}/${r.key}/${r.sub_key}`, r);
             }
             for (const row of textResult.rows) {
-                const k = `${row.domain}/${row.key}`;
+                const k = `${row.domain}/${row.key}/${row.sub_key}`;
                 const existing = resultMap.get(k);
                 if (existing) {
                     // Boost: semantic match + text match = highest relevance
@@ -440,9 +456,9 @@ async function kbSearch(pool, query, options) {
     catch {
         // Ultimate fallback: simple ILIKE
         let sql = `
-      SELECT domain, key, content, metadata, created_by, version, updated_at::text
+      SELECT domain, key, sub_key, content, metadata, created_by, version, updated_at::text
       FROM semo.knowledge_base
-      WHERE content ILIKE $1 OR key ILIKE $1
+      WHERE content ILIKE $1 OR key ILIKE $1 OR sub_key ILIKE $1
     `;
         const params = [`%${query}%`];
         let paramIdx = 2;
@@ -603,7 +619,7 @@ async function kbDigest(pool, since, domain) {
     const generatedAt = new Date().toISOString();
     try {
         let sql = `
-      SELECT domain, key, content, version, updated_at::text,
+      SELECT domain, key, sub_key, content, version, updated_at::text,
              CASE WHEN created_at > $1 THEN 'new' ELSE 'updated' END as change_type
       FROM semo.knowledge_base
       WHERE updated_at > $1 OR created_at > $1
@@ -622,6 +638,239 @@ async function kbDigest(pool, since, domain) {
         client.release();
     }
 }
+// ============================================================
+// KB Get / Upsert (CLI counterparts of MCP kb functions)
+// ============================================================
+/**
+ * Get a single KB entry by domain + key + sub_key
+ */
+async function kbGet(pool, domain, rawKey, rawSubKey) {
+    let key;
+    let subKey;
+    if (rawSubKey !== undefined) {
+        key = rawKey;
+        subKey = rawSubKey;
+    }
+    else {
+        const split = splitKey(rawKey);
+        key = split.key;
+        subKey = split.subKey;
+    }
+    const client = await pool.connect();
+    try {
+        const result = await client.query(`SELECT domain, key, sub_key, content, metadata, created_by, version,
+              created_at::text, updated_at::text
+       FROM semo.knowledge_base
+       WHERE domain = $1 AND key = $2 AND sub_key = $3`, [domain, key, subKey]);
+        return result.rows[0] || null;
+    }
+    finally {
+        client.release();
+    }
+}
+/**
+ * Upsert a single KB entry with domain/key validation and embedding generation
+ */
+async function kbUpsert(pool, entry) {
+    let key;
+    let subKey;
+    if (entry.sub_key !== undefined) {
+        key = entry.key;
+        subKey = entry.sub_key;
+    }
+    else {
+        const split = splitKey(entry.key);
+        key = split.key;
+        subKey = split.subKey;
+    }
+    // Domain validation
+    const client = await pool.connect();
+    try {
+        const ontoCheck = await client.query("SELECT domain FROM semo.ontology WHERE domain = $1", [entry.domain]);
+        if (ontoCheck.rows.length === 0) {
+            const known = await client.query("SELECT domain FROM semo.ontology ORDER BY domain");
+            const knownDomains = known.rows.map((r) => r.domain);
+            return {
+                success: false,
+                error: `도메인 '${entry.domain}'은(는) 온톨로지에 등록되지 않았습니다. 등록된 도메인: [${knownDomains.join(", ")}]`,
+            };
+        }
+    }
+    finally {
+        client.release();
+    }
+    // Key validation against type schema
+    try {
+        const schemaClient = await pool.connect();
+        try {
+            const typeResult = await schemaClient.query("SELECT entity_type FROM semo.ontology WHERE domain = $1 AND entity_type IS NOT NULL", [entry.domain]);
+            if (typeResult.rows.length > 0) {
+                const entityType = typeResult.rows[0].entity_type;
+                const schemaResult = await schemaClient.query("SELECT scheme_key, COALESCE(key_type, 'singleton') as key_type FROM semo.kb_type_schema WHERE type_key = $1", [entityType]);
+                const schemas = schemaResult.rows;
+                if (schemas.length > 0) {
+                    const match = schemas.find(s => s.scheme_key === key);
+                    if (!match) {
+                        const allowedKeys = schemas.map(s => s.key_type === "singleton" ? s.scheme_key : `${s.scheme_key}/{sub_key}`);
+                        return {
+                            success: false,
+                            error: `키 '${key}'은(는) '${entityType}' 타입의 스키마에 허용되지 않습니다. 허용 키: [${allowedKeys.join(", ")}]`,
+                        };
+                    }
+                    if (match.key_type === "singleton" && subKey !== "") {
+                        return { success: false, error: `키 '${key}'은(는) singleton이므로 sub_key가 비어야 합니다.` };
+                    }
+                    if (match.key_type === "collection" && subKey === "") {
+                        return { success: false, error: `키 '${key}'은(는) collection이므로 sub_key가 필요합니다.` };
+                    }
+                }
+            }
+        }
+        finally {
+            schemaClient.release();
+        }
+    }
+    catch {
+        // Validation failure is non-fatal
+    }
+    // Generate embedding (mandatory)
+    const fullKey = combineKey(key, subKey);
+    const text = `${fullKey}: ${entry.content}`;
+    const embedding = await generateEmbedding(text);
+    if (!embedding) {
+        const reason = process.env.OPENAI_API_KEY
+            ? "임베딩 생성 API 호출 실패"
+            : "OPENAI_API_KEY가 설정되지 않음";
+        return {
+            success: false,
+            error: `임베딩 생성 실패 — ${reason}. 임베딩 없이 저장하면 벡터 검색에서 누락되므로 저장이 거부됩니다.`,
+        };
+    }
+    const embeddingStr = `[${embedding.join(",")}]`;
+    const writeClient = await pool.connect();
+    try {
+        await writeClient.query(`INSERT INTO semo.knowledge_base (domain, key, sub_key, content, metadata, created_by, embedding)
+       VALUES ($1, $2, $3, $4, $5, $6, $7::vector)
+       ON CONFLICT (domain, key, sub_key) DO UPDATE SET
+         content = EXCLUDED.content,
+         metadata = EXCLUDED.metadata,
+         embedding = EXCLUDED.embedding`, [
+            entry.domain,
+            key,
+            subKey,
+            entry.content,
+            JSON.stringify(entry.metadata || {}),
+            entry.created_by || "semo-cli",
+            embeddingStr,
+        ]);
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+    finally {
+        writeClient.release();
+    }
+}
+/**
+ * List type schema entries for a given entity type
+ */
+async function ontoListSchema(pool, typeKey) {
+    const client = await pool.connect();
+    try {
+        const result = await client.query(`SELECT type_key, scheme_key, scheme_description, required, value_hint, sort_order,
+              COALESCE(key_type, 'singleton') as key_type
+       FROM semo.kb_type_schema
+       WHERE type_key = $1
+       ORDER BY sort_order, scheme_key`, [typeKey]);
+        return result.rows;
+    }
+    catch {
+        return [];
+    }
+    finally {
+        client.release();
+    }
+}
+/**
+ * Full domain→key routing table for bot auto-classification
+ */
+async function ontoRoutingTable(pool) {
+    const client = await pool.connect();
+    try {
+        const result = await client.query(`
+      SELECT
+        o.domain,
+        o.entity_type,
+        o.service,
+        o.description AS domain_description,
+        s.scheme_key,
+        s.key_type,
+        s.scheme_description,
+        s.value_hint
+      FROM semo.ontology o
+      JOIN semo.kb_type_schema s ON s.type_key = o.entity_type
+      ORDER BY o.domain, s.sort_order
+    `);
+        return result.rows;
+    }
+    finally {
+        client.release();
+    }
+}
+/**
+ * List services grouped with domain counts
+ */
+async function ontoListServices(pool) {
+    const client = await pool.connect();
+    try {
+        const result = await client.query(`
+      SELECT service, COUNT(*)::int as domain_count,
+             ARRAY_AGG(domain ORDER BY domain) as domains
+      FROM semo.ontology
+      WHERE service IS NOT NULL
+      GROUP BY service
+      ORDER BY service
+    `);
+        return result.rows;
+    }
+    catch {
+        return [];
+    }
+    finally {
+        client.release();
+    }
+}
+/**
+ * List service instances (entity_type = 'service')
+ */
+async function ontoListInstances(pool) {
+    const client = await pool.connect();
+    try {
+        const result = await client.query(`
+      SELECT o.domain, o.description, o.service, o.tags,
+             COALESCE(
+               (SELECT ARRAY_AGG(o2.domain ORDER BY o2.domain)
+                FROM semo.ontology o2
+                WHERE o2.service = o.service AND o2.domain != o.domain),
+               '{}'
+             ) as scoped_domains,
+             (SELECT COUNT(*)::int FROM semo.knowledge_base k
+              WHERE k.domain = o.domain
+                 OR k.domain LIKE o.service || '.%') as entry_count
+      FROM semo.ontology o
+      WHERE o.entity_type = 'service'
+      ORDER BY o.domain
+    `);
+        return result.rows;
+    }
+    catch {
+        return [];
+    }
+    finally {
+        client.release();
+    }
+}
 /**
  * Write ontology schemas to local cache
  */

package/dist/slack-notify.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Slack 알림 유틸리티
+ *
+ * SLACK_WEBHOOK 환경변수에서 URL을 읽어 알림 전송.
+ * ~/.semo.env에서 자동 로드됨 (database.ts loadSemoEnv).
+ */
+export declare function sendSlackNotification(message: string, webhookUrl?: string): Promise<boolean>;
+export declare function formatTestFailureMessage(suiteId: string, runId: string, pass: number, fail: number, warn: number, failedLabels: string[]): string;

package/dist/slack-notify.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Slack 알림 유틸리티
+ *
+ * SLACK_WEBHOOK 환경변수에서 URL을 읽어 알림 전송.
+ * ~/.semo.env에서 자동 로드됨 (database.ts loadSemoEnv).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.sendSlackNotification = sendSlackNotification;
+exports.formatTestFailureMessage = formatTestFailureMessage;
+async function sendSlackNotification(message, webhookUrl) {
+    const url = webhookUrl || process.env.SLACK_WEBHOOK;
+    if (!url)
+        return false;
+    try {
+        const res = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ text: message }),
+            signal: AbortSignal.timeout(10000),
+        });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+function formatTestFailureMessage(suiteId, runId, pass, fail, warn, failedLabels) {
+    const timestamp = new Date().toLocaleString("ko-KR", {
+        timeZone: "Asia/Seoul",
+    });
+    const topFailed = failedLabels.slice(0, 10);
+    const more = failedLabels.length > 10 ? `\n  ... +${failedLabels.length - 10}건` : "";
+    return [
+        `🚨 *Test Suite Failed* — ${suiteId}`,
+        `Run: \`${runId.substring(0, 8)}\` | ${timestamp}`,
+        `Pass: ${pass} | Fail: ${fail} | Warn: ${warn}`,
+        ``,
+        `Failed:`,
+        ...topFailed.map((l) => `  • ${l}`),
+        more,
+    ]
+        .filter(Boolean)
+        .join("\n");
+}

package/dist/test-runners/workspace-audit.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Declarative Workspace Audit Runner
+ *
+ * bot_workspace_standard 테이블에서 규칙을 로드하고,
+ * bot_status에서 봇 목록을 가져와 동적으로 TC를 생성·실행.
+ *
+ * 로컬 스크립트 의존성 없음 — DB가 SoT.
+ */
+import { Pool } from "pg";
+export interface TestOutputLine {
+    type: "case" | "summary";
+    id?: string;
+    status?: "pass" | "fail" | "warn" | "skip";
+    label?: string;
+    detail?: string;
+}
+export declare function runDeclarativeWorkspaceAudit(pool: Pool): Promise<TestOutputLine[]>;