@team-semicolon/semo-cli 4.7.3 → 4.7.4

package/dist/index.js

@@ -1705,9 +1705,13 @@ kbCmd
 kbCmd
     .command("ontology")
     .description("온톨로지 조회 — 도메인/타입/스키마/라우팅 테이블")
-    .option("--action <type>", "조회 동작 (list|show|services|types|instances|schema|routing-table)", "list")
-    .option("--domain <name>", "action=show 시 도메인")
-    .option("--type <name>", "action=schema 시 타입 키")
+    .option("--action <type>", "동작 (list|show|services|types|instances|schema|routing-table|register)", "list")
+    .option("--domain <name>", "action=show|register 시 도메인")
+    .option("--type <name>", "action=schema|register 시 타입 키")
+    .option("--description <text>", "action=register 시 설명")
+    .option("--service <name>", "action=register 시 서비스 그룹")
+    .option("--tags <tags>", "action=register 시 태그 (쉼표 구분)")
+    .option("--no-init", "action=register 시 필수 KB entry 자동 생성 건너뛰기")
     .option("--format <type>", "출력 형식 (json|table)", "table")
     .action(async (options) => {
     try {
@@ -1852,8 +1856,48 @@ kbCmd
                 console.log();
             }
         }
+        else if (action === "register") {
+            if (!options.domain) {
+                console.log(chalk_1.default.red("--domain 옵션이 필요합니다."));
+                process.exit(1);
+            }
+            if (!options.type) {
+                console.log(chalk_1.default.red("--type 옵션이 필요합니다. (예: --type service, --type team, --type person)"));
+                const types = await (0, kb_1.ontoListTypes)(pool);
+                console.log(chalk_1.default.gray(`사용 가능한 타입: ${types.map(t => t.type_key).join(", ")}`));
+                process.exit(1);
+            }
+            const tags = options.tags ? options.tags.split(",").map((t) => t.trim()) : undefined;
+            const result = await (0, kb_1.ontoRegister)(pool, {
+                domain: options.domain,
+                entity_type: options.type,
+                description: options.description,
+                service: options.service,
+                tags,
+                init_required: options.init !== false,
+            });
+            if (options.format === "json") {
+                console.log(JSON.stringify(result, null, 2));
+            }
+            else {
+                if (result.success) {
+                    console.log(chalk_1.default.green(`\n✅ 도메인 '${options.domain}' 등록 완료 (타입: ${options.type})`));
+                    if (result.created_entries && result.created_entries.length > 0) {
+                        console.log(chalk_1.default.gray(`  초기 KB entry ${result.created_entries.length}건 생성:`));
+                        for (const e of result.created_entries) {
+                            console.log(chalk_1.default.gray(`    - ${e.key}`));
+                        }
+                    }
+                    console.log(chalk_1.default.gray(`\n  다음 단계: semo kb upsert ${options.domain} <key> --content "..." 으로 데이터 입력\n`));
+                }
+                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`));
+            console.log(chalk_1.default.red(`알 수 없는 action: '${action}'. 사용 가능: list, show, services, types, instances, schema, routing-table, register`));
             process.exit(1);
         }
         await (0, database_1.closeConnection)();
@@ -2033,6 +2077,54 @@ ontoCmd
         process.exit(1);
     }
 });
+ontoCmd
+    .command("register <domain>")
+    .description("새 온톨로지 도메인 등록")
+    .requiredOption("--type <type>", "엔티티 타입 (예: service, team, person, bot)")
+    .option("--description <text>", "도메인 설명")
+    .option("--service <name>", "서비스 그룹")
+    .option("--tags <tags>", "태그 (쉼표 구분)")
+    .option("--no-init", "필수 KB entry 자동 생성 건너뛰기")
+    .option("--format <type>", "출력 형식 (json|table)", "table")
+    .action(async (domain, options) => {
+    try {
+        const pool = (0, database_1.getPool)();
+        const tags = options.tags ? options.tags.split(",").map((t) => t.trim()) : undefined;
+        const result = await (0, kb_1.ontoRegister)(pool, {
+            domain,
+            entity_type: options.type,
+            description: options.description,
+            service: options.service,
+            tags,
+            init_required: options.init !== false,
+        });
+        if (options.format === "json") {
+            console.log(JSON.stringify(result, null, 2));
+        }
+        else {
+            if (result.success) {
+                console.log(chalk_1.default.green(`\n✅ 도메인 '${domain}' 등록 완료 (타입: ${options.type})`));
+                if (result.created_entries && result.created_entries.length > 0) {
+                    console.log(chalk_1.default.gray(`  초기 KB entry ${result.created_entries.length}건 생성:`));
+                    for (const e of result.created_entries) {
+                        console.log(chalk_1.default.gray(`    - ${e.key}`));
+                    }
+                }
+                console.log(chalk_1.default.gray(`\n  다음 단계: semo kb upsert ${domain} <key> --content "..." 으로 데이터 입력\n`));
+            }
+            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);

package/dist/kb.d.ts

@@ -198,6 +198,31 @@ export declare function ontoListServices(pool: Pool): Promise<ServiceInfo[]>;
  * List service instances (entity_type = 'service')
  */
 export declare function ontoListInstances(pool: Pool): Promise<ServiceInstance[]>;
+export interface OntoRegisterOptions {
+    domain: string;
+    entity_type: string;
+    description?: string;
+    service?: string;
+    tags?: string[];
+    init_required?: boolean;
+}
+export interface OntoRegisterResult {
+    success: boolean;
+    error?: string;
+    created_entries?: Array<{
+        key: string;
+        sub_key: string;
+    }>;
+}
+/**
+ * Register a new ontology domain with optional initial required KB entries.
+ *
+ * 1. Validate entity_type exists in ontology_types
+ * 2. Check domain doesn't already exist
+ * 3. INSERT into semo.ontology
+ * 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>;
 /**
  * Write ontology schemas to local cache
  */

package/dist/kb.js

@@ -60,6 +60,7 @@ exports.ontoListSchema = ontoListSchema;
 exports.ontoRoutingTable = ontoRoutingTable;
 exports.ontoListServices = ontoListServices;
 exports.ontoListInstances = ontoListInstances;
+exports.ontoRegister = ontoRegister;
 exports.ontoPullToLocal = ontoPullToLocal;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -886,6 +887,79 @@ async function ontoListInstances(pool) {
         client.release();
     }
 }
+/**
+ * Register a new ontology domain with optional initial required KB entries.
+ *
+ * 1. Validate entity_type exists in ontology_types
+ * 2. Check domain doesn't already exist
+ * 3. INSERT into semo.ontology
+ * 4. If init_required (default true), create KB entries for required keys in kb_type_schema
+ */
+async function ontoRegister(pool, opts) {
+    const client = await pool.connect();
+    try {
+        // 1. Validate entity_type
+        const typeCheck = await client.query("SELECT type_key FROM semo.ontology_types WHERE type_key = $1", [opts.entity_type]);
+        if (typeCheck.rows.length === 0) {
+            const known = await client.query("SELECT type_key FROM semo.ontology_types ORDER BY type_key");
+            const knownTypes = known.rows.map((r) => r.type_key);
+            return {
+                success: false,
+                error: `타입 '${opts.entity_type}'은(는) 존재하지 않습니다. 사용 가능한 타입: [${knownTypes.join(", ")}]`,
+            };
+        }
+        // 2. Check domain doesn't already exist
+        const existCheck = await client.query("SELECT domain FROM semo.ontology WHERE domain = $1", [opts.domain]);
+        if (existCheck.rows.length > 0) {
+            return { success: false, error: `도메인 '${opts.domain}'은(는) 이미 등록되어 있습니다.` };
+        }
+        // 3. INSERT into ontology
+        await client.query(`INSERT INTO semo.ontology (domain, entity_type, description, service, tags, schema)
+       VALUES ($1, $2, $3, $4, $5, $6)`, [
+            opts.domain,
+            opts.entity_type,
+            opts.description || null,
+            opts.service || "_global",
+            opts.tags || [opts.entity_type],
+            JSON.stringify({}),
+        ]);
+        // 4. Create required KB entries
+        const createdEntries = [];
+        const initRequired = opts.init_required !== false;
+        if (initRequired) {
+            const schemaResult = await client.query(`SELECT scheme_key, scheme_description, COALESCE(key_type, 'singleton') as key_type, value_hint
+         FROM semo.kb_type_schema
+         WHERE type_key = $1 AND required = true
+         ORDER BY sort_order`, [opts.entity_type]);
+            for (const s of schemaResult.rows) {
+                if (s.key_type === "collection")
+                    continue; // collection은 sub_key가 필요하므로 스킵
+                const placeholder = s.value_hint
+                    ? `(미입력 — hint: ${s.value_hint})`
+                    : `(미입력)`;
+                const text = `${s.scheme_key}: ${placeholder}`;
+                const embedding = await generateEmbedding(text);
+                const embeddingStr = embedding ? `[${embedding.join(",")}]` : null;
+                try {
+                    await client.query(`INSERT INTO semo.knowledge_base (domain, key, sub_key, content, metadata, created_by, embedding)
+             VALUES ($1, $2, '', $3, '{}', 'semo-cli:onto-register', $4::vector)
+             ON CONFLICT (domain, key, sub_key) DO NOTHING`, [opts.domain, s.scheme_key, placeholder, embeddingStr]);
+                    createdEntries.push({ key: s.scheme_key, sub_key: "" });
+                }
+                catch {
+                    // 개별 entry 실패는 무시 — 도메인 등록 자체는 성공
+                }
+            }
+        }
+        return { success: true, created_entries: createdEntries };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+    finally {
+        client.release();
+    }
+}
 /**
  * Write ontology schemas to local cache
  */

package/package.json

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