@team-semicolon/semo-cli 4.9.0 → 4.11.0

package/dist/database.js

@@ -68,11 +68,8 @@ const env_parser_1 = require("./env-parser");
 // ~/.claude/semo/.env 자동 로드 — LaunchAgent / Claude Code 앱 / cron 등
 // 인터랙티브 쉘이 아닌 환경에서 환경변수를 공급한다.
 // 이미 설정된 환경변수는 덮어쓰지 않는다 (env var > file).
-// v4.5.0: ~/.semo.env → ~/.claude/semo/.env 이전. 구 경로 폴백 유지.
 function loadSemoEnv() {
-    const newEnvFile = path.join(os.homedir(), ".claude", "semo", ".env");
-    const legacyEnvFile = path.join(os.homedir(), ".semo.env");
-    const envFile = fs.existsSync(newEnvFile) ? newEnvFile : legacyEnvFile;
+    const envFile = path.join(os.homedir(), ".claude", "semo", ".env");
     if (!fs.existsSync(envFile))
         return;
     try {

package/dist/env-parser.d.ts

@@ -1,5 +1,5 @@
 /**
  * 공용 KEY=VALUE 파서
- * ~/.semo.env 파일과 GitHub Gist 콘텐츠 모두 이 함수로 파싱한다.
+ * ~/.claude/semo/.env 파일과 GitHub Gist 콘텐츠 모두 이 함수로 파싱한다.
  */
 export declare function parseEnvContent(content: string): Record<string, string>;

package/dist/env-parser.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.parseEnvContent = parseEnvContent;
 /**
  * 공용 KEY=VALUE 파서
- * ~/.semo.env 파일과 GitHub Gist 콘텐츠 모두 이 함수로 파싱한다.
+ * ~/.claude/semo/.env 파일과 GitHub Gist 콘텐츠 모두 이 함수로 파싱한다.
  */
 function parseEnvContent(content) {
     const result = {};

package/dist/index.js

@@ -331,8 +331,7 @@ async function showToolsStatus() {
 // === 글로벌 설정 체크 ===
 function isGlobalSetupDone() {
     const home = os.homedir();
-    const hasEnv = fs.existsSync(path.join(home, ".claude", "semo", ".env")) ||
-        fs.existsSync(path.join(home, ".semo.env")); // 하위 호환
+    const hasEnv = fs.existsSync(path.join(home, ".claude", "semo", ".env"));
     const hasSetup = fs.existsSync(path.join(home, ".claude", "semo", "SOUL.md")) ||
         fs.existsSync(path.join(home, ".claude", "skills")); // 하위 호환
     return hasEnv && hasSetup;
@@ -494,9 +493,7 @@ const BASE_MCP_SERVERS = [
     },
 ];
 // === ~/.claude/semo/.env 설정 (자동 감지 → Gist → 프롬프트) ===
-// v4.5.0: ~/.semo.env → ~/.claude/semo/.env 이전
 const SEMO_ENV_PATH = path.join(os.homedir(), ".claude", "semo", ".env");
-const LEGACY_ENV_PATH = path.join(os.homedir(), ".semo.env");
 const SEMO_CREDENTIALS = [
     {
         key: "DATABASE_URL",
@@ -544,27 +541,9 @@ function writeSemoEnvFile(creds) {
     }
     lines.push("");
     fs.writeFileSync(SEMO_ENV_PATH, lines.join("\n"), { mode: 0o600 });
-    // 하위 호환 심링크: ~/.semo.env → ~/.claude/semo/.env
-    try {
-        if (fs.existsSync(LEGACY_ENV_PATH)) {
-            const stat = fs.lstatSync(LEGACY_ENV_PATH);
-            if (!stat.isSymbolicLink()) {
-                // 기존 실파일은 백업 후 심링크로 교체
-                fs.renameSync(LEGACY_ENV_PATH, LEGACY_ENV_PATH + ".bak");
-            }
-            else {
-                fs.unlinkSync(LEGACY_ENV_PATH);
-            }
-        }
-        fs.symlinkSync(SEMO_ENV_PATH, LEGACY_ENV_PATH);
-    }
-    catch {
-        // 심링크 실패 시 무시 — 새 경로가 원본
-    }
 }
 function readSemoEnvCreds() {
-    // 새 경로 우선, 없으면 레거시 폴백
-    const envFile = fs.existsSync(SEMO_ENV_PATH) ? SEMO_ENV_PATH : LEGACY_ENV_PATH;
+    const envFile = SEMO_ENV_PATH;
     if (!fs.existsSync(envFile))
         return {};
     try {
@@ -740,7 +719,7 @@ async function buildKbFirstBlock() {
             const label = s.desc || s.scheme_key;
             domainGuide += `- 서비스 ${label} → \`domain: {서비스명}\`, key: \`${s.scheme_key}\`\n`;
         }
-        domainGuide += `- 서비스 KPI → \`domain: {서비스명}\`, key: \`kpi/current\`\n`;
+        domainGuide += `- 서비스 KPI → \`domain: {서비스명}\`, key: \`kpi/{YYYY-MM-DD}\` (최신: 가장 최근 날짜)\n`;
         domainGuide += `- 서비스 마일스톤 → \`domain: {서비스명}\`, key: \`milestone/{slug}\`\n`;
         domainGuide += `\n**정확한 경로를 모를 때:**\n`;
         domainGuide += `1. \`semo kb search "검색어"\` → 결과의 \`[domain] key/sub_key\` 경로 확인\n`;
@@ -853,7 +832,7 @@ async function setupHooks(isUpdate = false) {
                 hooks: [
                     {
                         type: "command",
-                        command: ". ~/.claude/semo/.env 2>/dev/null || . ~/.semo.env 2>/dev/null; semo context sync 2>/dev/null || true",
+                        command: ". ~/.claude/semo/.env 2>/dev/null; semo context sync 2>/dev/null || true",
                         timeout: 30,
                     },
                 ],
@@ -865,7 +844,7 @@ async function setupHooks(isUpdate = false) {
                 hooks: [
                     {
                         type: "command",
-                        command: ". ~/.claude/semo/.env 2>/dev/null || . ~/.semo.env 2>/dev/null; semo context push 2>/dev/null || true",
+                        command: ". ~/.claude/semo/.env 2>/dev/null; semo context push 2>/dev/null || true",
                         timeout: 30,
                     },
                 ],
@@ -1119,9 +1098,9 @@ npm run build          # 빌드 검증
 
 ---
 
-## 환경변수 (\`~/.semo.env\`)
+## 환경변수 (\`~/.claude/semo/.env\`)
 
-SEMO는 \`~/.semo.env\` 파일에서 팀 공통 환경변수를 로드합니다.
+SEMO는 \`~/.claude/semo/.env\` 파일에서 팀 공통 환경변수를 로드합니다.
 SessionStart 훅과 OpenClaw 게이트웨이 래퍼에서 자동 source됩니다.
 
 | 변수 | 용도 | 필수 |
@@ -1130,7 +1109,7 @@ SessionStart 훅과 OpenClaw 게이트웨이 래퍼에서 자동 source됩니다
 | \`OPENAI_API_KEY\` | KB 임베딩용 (text-embedding-3-small) | 선택 |
 | \`SLACK_WEBHOOK\` | Slack 알림 | 선택 |
 
-키 갱신이 필요하면 \`~/.semo.env\`를 직접 편집하거나 \`semo onboarding -f\`를 실행하세요.
+키 갱신이 필요하면 \`~/.claude/semo/.env\`를 직접 편집하거나 \`semo onboarding -f\`를 실행하세요.
 
 ---
 
@@ -1754,7 +1733,7 @@ kbCmd
 kbCmd
     .command("ontology")
     .description("온톨로지 조회 — 도메인/타입/스키마/라우팅 테이블")
-    .option("--action <type>", "동작 (list|show|services|types|instances|schema|routing-table|register|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 시 스키마 키")
@@ -1765,6 +1744,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 {
@@ -1949,6 +1930,24 @@ kbCmd
                 }
             }
         }
+        else if (action === "create-type") {
+            if (!options.type) {
+                console.log(chalk_1.default.red("--type 옵션이 필요합니다. (예: --type project)"));
+                process.exit(1);
+            }
+            const result = await (0, kb_1.ontoCreateType)(pool, {
+                type_key: options.type,
+                description: options.description,
+            });
+            if (result.success) {
+                console.log(chalk_1.default.green(`\n✅ 온톨로지 타입 '${options.type}' 생성 완료`));
+                console.log(chalk_1.default.gray(`\n  다음 단계: semo kb ontology --action add-key --type ${options.type} --key <key> --key-type singleton|collection\n`));
+            }
+            else {
+                console.log(chalk_1.default.red(`\n❌ 타입 생성 실패: ${result.error}\n`));
+                process.exit(1);
+            }
+        }
         else if (action === "add-key") {
             if (!options.type) {
                 console.log(chalk_1.default.red("--type 옵션이 필요합니다. (예: --type service)"));
@@ -1992,8 +1991,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, 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)();
@@ -2221,6 +2276,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);

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
  */
@@ -246,6 +257,17 @@ export declare function ontoAddKey(pool: Pool, opts: {
     success: boolean;
     error?: string;
 }>;
+/**
+ * Create a new ontology type
+ */
+export declare function ontoCreateType(pool: Pool, opts: {
+    type_key: string;
+    description?: string;
+    schema?: Record<string, unknown>;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
 /**
  * Remove a key from a type schema
  */

package/dist/kb.js

@@ -62,7 +62,9 @@ exports.ontoRoutingTable = ontoRoutingTable;
 exports.ontoListServices = ontoListServices;
 exports.ontoListInstances = ontoListInstances;
 exports.ontoRegister = ontoRegister;
+exports.ontoUnregister = ontoUnregister;
 exports.ontoAddKey = ontoAddKey;
+exports.ontoCreateType = ontoCreateType;
 exports.ontoRemoveKey = ontoRemoveKey;
 exports.ontoPullToLocal = ontoPullToLocal;
 const fs = __importStar(require("fs"));
@@ -1010,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
  */
@@ -1057,6 +1103,36 @@ async function ontoAddKey(pool, opts) {
         client.release();
     }
 }
+/**
+ * Create a new ontology type
+ */
+async function ontoCreateType(pool, opts) {
+    // kebab-case 검증
+    if (!/^[a-z][a-z0-9]*(-[a-z0-9]+)*$/.test(opts.type_key)) {
+        return { success: false, error: `타입 키 '${opts.type_key}'이(가) 유효하지 않습니다. kebab-case 소문자만 사용 가능 (예: my-type)` };
+    }
+    const client = await pool.connect();
+    try {
+        // 중복 확인
+        const dupCheck = await client.query("SELECT type_key FROM semo.ontology_types WHERE type_key = $1", [opts.type_key]);
+        if (dupCheck.rows.length > 0) {
+            return { success: false, error: `타입 '${opts.type_key}'은(는) 이미 존재합니다.` };
+        }
+        await client.query(`INSERT INTO semo.ontology_types (type_key, schema, description)
+       VALUES ($1, $2, $3)`, [
+            opts.type_key,
+            JSON.stringify(opts.schema || {}),
+            opts.description || opts.type_key,
+        ]);
+        return { success: true };
+    }
+    catch (err) {
+        return { success: false, error: String(err) };
+    }
+    finally {
+        client.release();
+    }
+}
 /**
  * Remove a key from a type schema
  */

package/dist/slack-notify.d.ts

@@ -2,7 +2,7 @@
  * Slack 알림 유틸리티
  *
  * SLACK_WEBHOOK 환경변수에서 URL을 읽어 알림 전송.
- * ~/.semo.env에서 자동 로드됨 (database.ts loadSemoEnv).
+ * ~/.claude/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

@@ -3,7 +3,7 @@
  * Slack 알림 유틸리티
  *
  * SLACK_WEBHOOK 환경변수에서 URL을 읽어 알림 전송.
- * ~/.semo.env에서 자동 로드됨 (database.ts loadSemoEnv).
+ * ~/.claude/semo/.env에서 자동 로드됨 (database.ts loadSemoEnv).
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.sendSlackNotification = sendSlackNotification;

package/package.json

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