@team-semicolon/semo-cli 4.8.0 → 4.10.0

package/dist/commands/audit.d.ts

@@ -23,13 +23,62 @@ export interface BotAuditResult {
     score: number;
     checks: AuditCheck[];
 }
+interface CheckDef {
+    name: string;
+    check: (botDir: string, botId: string) => AuditCheck;
+}
+export interface WorkspaceStandardRow {
+    path_pattern: string;
+    entry_type: string;
+    level: string;
+    severity: string;
+    category: string;
+    bot_scope: string;
+    bot_ids: string[];
+    symlink_target: string | null;
+    content_rules: Record<string, unknown> | null;
+    description: string | null;
+    fix_action: string | null;
+    fix_template: string | null;
+}
+export declare function loadCheckDefs(pool: Pool): Promise<{
+    defs: CheckDef[];
+    rows: WorkspaceStandardRow[];
+}>;
 /** Sync version using fallback CHECK_DEFS (no DB) */
 export declare function auditBot(botDir: string, botId: string): BotAuditResult;
 /** Async version using DB-loaded rules */
 export declare function auditBotFromDb(botDir: string, botId: string, pool: Pool): Promise<BotAuditResult>;
+/** Legacy hardcoded fix — used when DB is unavailable */
 export declare function fixBot(botDir: string, botId: string, checks: AuditCheck[]): number;
+/**
+ * DB `fix_action`/`fix_template` 기반 auto-fix.
+ * 지원 액션: create_file, create_dir, create_symlink, delete (--force 필요)
+ */
+export declare function fixBotFromDb(botDir: string, botId: string, checks: AuditCheck[], dbRules: WorkspaceStandardRow[], options?: {
+    force?: boolean;
+}): {
+    fixed: number;
+    skipped: string[];
+};
+/**
+ * DB의 required 규칙에 대해 파일이 없으면 생성.
+ * content_rules 위반은 보고만 한다.
+ */
+export declare function syncBotFromDb(botDir: string, botId: string, dbRules: WorkspaceStandardRow[]): {
+    created: number;
+    violations: string[];
+};
+export interface SkillAuditCheck extends AuditCheck {
+    skillName?: string;
+}
+/**
+ * 봇의 skills/ 하위 스킬 디렉토리 구조 검증
+ */
+export declare function auditSkillStructure(botDir: string, botId: string): SkillAuditCheck[];
 export declare function auditBotKb(pool: Pool): Promise<AuditCheck[]>;
 export declare function auditBotDb(botId: string, pool: Pool): Promise<AuditCheck[]>;
 export declare function mergeDbChecks(result: BotAuditResult, dbChecks: AuditCheck[]): BotAuditResult;
 export declare function formatAuditSlack(results: BotAuditResult[]): string;
 export declare function storeAuditResults(results: BotAuditResult[], client: PoolClient): Promise<void>;
+export {};

package/dist/commands/audit.js

@@ -46,9 +46,13 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadCheckDefs = loadCheckDefs;
 exports.auditBot = auditBot;
 exports.auditBotFromDb = auditBotFromDb;
 exports.fixBot = fixBot;
+exports.fixBotFromDb = fixBotFromDb;
+exports.syncBotFromDb = syncBotFromDb;
+exports.auditSkillStructure = auditSkillStructure;
 exports.auditBotKb = auditBotKb;
 exports.auditBotDb = auditBotDb;
 exports.mergeDbChecks = mergeDbChecks;
@@ -324,6 +328,7 @@ const FIXABLE_DIRS = {
 const FILE_TEMPLATES = {
     "SOUL.md": (botId) => `# ${botId} — SOUL\n\n## Identity\n\n> TODO\n\n## R&R\n\n> TODO\n\n## KB Lookup Protocol\n\n> semo kb get/search로 팀 정보 조회\n\n## Operating Procedures\n\n> TODO\n\n## NON-NEGOTIABLE\n\n1. TODO\n`,
 };
+/** Legacy hardcoded fix — used when DB is unavailable */
 function fixBot(botDir, botId, checks) {
     let fixed = 0;
     for (const check of checks) {
@@ -384,6 +389,295 @@ function fixBot(botDir, botId, checks) {
     return fixed;
 }
 // ============================================================
+// DB-based auto-fix — fix_action/fix_template 활용
+// ============================================================
+/**
+ * DB `fix_action`/`fix_template` 기반 auto-fix.
+ * 지원 액션: create_file, create_dir, create_symlink, delete (--force 필요)
+ */
+function fixBotFromDb(botDir, botId, checks, dbRules, options = {}) {
+    let fixed = 0;
+    const skipped = [];
+    const home = process.env.HOME || "/Users/reus";
+    // Build a map of check name → row for quick lookup
+    const failedCheckNames = new Set(checks.filter((c) => !c.passed).map((c) => c.name));
+    for (const row of dbRules) {
+        if (!row.fix_action || !row.fix_template)
+            continue;
+        const checkName = `${row.category}/${row.path_pattern}`;
+        // Check if any of the failed checks relate to this row
+        const isRelevant = failedCheckNames.has(checkName) ||
+            failedCheckNames.has(`${checkName}-symlink`);
+        if (!isRelevant)
+            continue;
+        // Variable substitution in fix_template
+        const resolvedTemplate = row.fix_template
+            .replace(/\$BOT_ID/g, botId)
+            .replace(/\$HOME/g, home);
+        const targetPath = path.join(botDir, row.path_pattern);
+        switch (row.fix_action) {
+            case "create_file": {
+                if (fs.existsSync(targetPath))
+                    break;
+                const dir = path.dirname(targetPath);
+                if (!fs.existsSync(dir)) {
+                    fs.mkdirSync(dir, { recursive: true });
+                }
+                fs.writeFileSync(targetPath, resolvedTemplate, "utf-8");
+                fixed++;
+                break;
+            }
+            case "create_dir": {
+                const dirPath = row.path_pattern.endsWith("/")
+                    ? path.join(botDir, row.path_pattern.slice(0, -1))
+                    : targetPath;
+                if (!fs.existsSync(dirPath)) {
+                    fs.mkdirSync(dirPath, { recursive: true });
+                    fixed++;
+                }
+                break;
+            }
+            case "create_symlink": {
+                const symlinkTarget = resolvedTemplate;
+                if (!fs.existsSync(symlinkTarget))
+                    break;
+                if (fs.existsSync(targetPath)) {
+                    const stats = fs.lstatSync(targetPath);
+                    if (stats.isSymbolicLink()) {
+                        const existing = fs.readlinkSync(targetPath);
+                        if (existing === symlinkTarget)
+                            break; // already correct
+                        fs.unlinkSync(targetPath);
+                    }
+                    else {
+                        fs.unlinkSync(targetPath);
+                    }
+                }
+                fs.symlinkSync(symlinkTarget, targetPath);
+                fixed++;
+                break;
+            }
+            case "delete": {
+                if (!fs.existsSync(targetPath))
+                    break;
+                if (!options.force) {
+                    skipped.push(`${row.path_pattern} (delete requires --force)`);
+                    break;
+                }
+                const stats = fs.lstatSync(targetPath);
+                if (stats.isDirectory()) {
+                    fs.rmSync(targetPath, { recursive: true, force: true });
+                }
+                else {
+                    fs.unlinkSync(targetPath);
+                }
+                fixed++;
+                break;
+            }
+        }
+    }
+    return { fixed, skipped };
+}
+// ============================================================
+// --sync: DB required 항목 proactive 보장
+// ============================================================
+/**
+ * DB의 required 규칙에 대해 파일이 없으면 생성.
+ * content_rules 위반은 보고만 한다.
+ */
+function syncBotFromDb(botDir, botId, dbRules) {
+    let created = 0;
+    const violations = [];
+    const home = process.env.HOME || "/Users/reus";
+    for (const row of dbRules) {
+        if (row.level !== "required")
+            continue;
+        if (row.path_pattern.includes("*"))
+            continue; // glob patterns handled separately
+        const targetPath = path.join(botDir, row.path_pattern);
+        if (row.entry_type === "dir") {
+            const dirPath = row.path_pattern.endsWith("/")
+                ? path.join(botDir, row.path_pattern.slice(0, -1))
+                : targetPath;
+            if (!fs.existsSync(dirPath)) {
+                if (row.fix_action === "create_dir") {
+                    fs.mkdirSync(dirPath, { recursive: true });
+                    created++;
+                }
+            }
+        }
+        else if (row.entry_type === "symlink") {
+            if (!fs.existsSync(targetPath) && row.fix_action === "create_symlink" && row.fix_template) {
+                const symlinkTarget = row.fix_template
+                    .replace(/\$BOT_ID/g, botId)
+                    .replace(/\$HOME/g, home);
+                if (fs.existsSync(symlinkTarget)) {
+                    const dir = path.dirname(targetPath);
+                    if (!fs.existsSync(dir))
+                        fs.mkdirSync(dir, { recursive: true });
+                    fs.symlinkSync(symlinkTarget, targetPath);
+                    created++;
+                }
+            }
+        }
+        else {
+            // file
+            if (!fs.existsSync(targetPath)) {
+                if (row.fix_action === "create_file" && row.fix_template) {
+                    const content = row.fix_template
+                        .replace(/\$BOT_ID/g, botId)
+                        .replace(/\$HOME/g, home);
+                    const dir = path.dirname(targetPath);
+                    if (!fs.existsSync(dir))
+                        fs.mkdirSync(dir, { recursive: true });
+                    fs.writeFileSync(targetPath, content, "utf-8");
+                    created++;
+                }
+            }
+            else if (row.content_rules) {
+                // File exists — check content_rules violations (report only)
+                const rules = row.content_rules;
+                const maxLines = rules.max_lines;
+                if (maxLines) {
+                    try {
+                        const lines = fs.readFileSync(targetPath, "utf-8").split("\n").length;
+                        if (lines > maxLines) {
+                            violations.push(`${row.path_pattern}: ${lines} lines (max ${maxLines})`);
+                        }
+                    }
+                    catch { /* skip unreadable */ }
+                }
+            }
+        }
+    }
+    return { created, violations };
+}
+/**
+ * 봇의 skills/ 하위 스킬 디렉토리 구조 검증
+ */
+function auditSkillStructure(botDir, botId) {
+    const checks = [];
+    const skillsDir = path.join(botDir, "skills");
+    if (!fs.existsSync(skillsDir) || !fs.statSync(skillsDir).isDirectory()) {
+        return checks;
+    }
+    let entries;
+    try {
+        entries = fs.readdirSync(skillsDir, { withFileTypes: true });
+    }
+    catch {
+        return checks;
+    }
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        if (entry.name.startsWith("_") || entry.name.startsWith("."))
+            continue;
+        if (entry.name.endsWith(".skill"))
+            continue;
+        const skillName = entry.name;
+        const skillDir = path.join(skillsDir, skillName);
+        const skillMdPath = path.join(skillDir, "SKILL.md");
+        // SKILL.md 존재 여부
+        if (!fs.existsSync(skillMdPath)) {
+            checks.push({
+                name: `skill/${skillName}/SKILL.md`,
+                passed: false,
+                detail: `skills/${skillName}/SKILL.md missing`,
+                skillName,
+            });
+            continue;
+        }
+        // SKILL.md 내용 검증
+        let content;
+        try {
+            content = fs.readFileSync(skillMdPath, "utf-8");
+        }
+        catch {
+            checks.push({
+                name: `skill/${skillName}/SKILL.md`,
+                passed: false,
+                detail: `skills/${skillName}/SKILL.md unreadable`,
+                skillName,
+            });
+            continue;
+        }
+        // SKILL.md exists
+        checks.push({
+            name: `skill/${skillName}/SKILL.md`,
+            passed: true,
+            detail: `skills/${skillName}/SKILL.md exists`,
+            skillName,
+        });
+        // Line count check (max 500)
+        const lines = content.split("\n").length;
+        checks.push({
+            name: `skill/${skillName}/lines`,
+            passed: lines <= 500,
+            detail: lines <= 500
+                ? `skills/${skillName}/SKILL.md: ${lines} lines (≤ 500)`
+                : `skills/${skillName}/SKILL.md: ${lines} lines (> 500, too long)`,
+            skillName,
+        });
+        // Frontmatter check (---\nname: ...\ndescription: ...\n---)
+        const fmMatch = content.match(/^---\n([\s\S]*?)\n---/);
+        if (fmMatch) {
+            const fm = fmMatch[1];
+            const nameMatch = fm.match(/^name:\s*(.+)$/m);
+            const descMatch = fm.match(/^description:/m);
+            if (nameMatch) {
+                const fmName = nameMatch[1].trim();
+                const isKebab = /^[a-z0-9]+(-[a-z0-9]+)*$/.test(fmName);
+                checks.push({
+                    name: `skill/${skillName}/name-kebab`,
+                    passed: isKebab,
+                    detail: isKebab
+                        ? `skills/${skillName} name "${fmName}" is kebab-case`
+                        : `skills/${skillName} name "${fmName}" is not kebab-case`,
+                    skillName,
+                });
+            }
+            else {
+                checks.push({
+                    name: `skill/${skillName}/name-kebab`,
+                    passed: false,
+                    detail: `skills/${skillName}/SKILL.md frontmatter missing 'name'`,
+                    skillName,
+                });
+            }
+            checks.push({
+                name: `skill/${skillName}/description`,
+                passed: !!descMatch,
+                detail: descMatch
+                    ? `skills/${skillName}/SKILL.md has description`
+                    : `skills/${skillName}/SKILL.md frontmatter missing 'description'`,
+                skillName,
+            });
+        }
+        else {
+            checks.push({
+                name: `skill/${skillName}/frontmatter`,
+                passed: false,
+                detail: `skills/${skillName}/SKILL.md missing frontmatter (--- block)`,
+                skillName,
+            });
+        }
+        // Forbidden files check
+        const forbiddenFiles = ["README.md", "CHANGELOG.md", "INSTALL.md", "LICENSE", "LICENSE.md"];
+        for (const forbidden of forbiddenFiles) {
+            if (fs.existsSync(path.join(skillDir, forbidden))) {
+                checks.push({
+                    name: `skill/${skillName}/forbidden-${forbidden}`,
+                    passed: false,
+                    detail: `skills/${skillName}/${forbidden} exists (forbidden)`,
+                    skillName,
+                });
+            }
+        }
+    }
+    return checks;
+}
+// ============================================================
 // KB domain checks (async, requires pool)
 // ============================================================
 const KB_REQUIRED_DOMAINS = ["semicolon"];

package/dist/commands/bots.js

@@ -561,7 +561,9 @@ function registerBotsCommands(program) {
         .command("audit")
         .description("봇 워크스페이스 표준 구조 audit")
         .option("--format <type>", "출력 형식 (table|json|slack)", "table")
-        .option("--fix", "누락 파일/디렉토리 자동 생성")
+        .option("--fix", "누락 파일/디렉토리 자동 생성 (DB fix_action 활용)")
+        .option("--sync", "DB required 항목 proactive 보장 (누락 파일 생성)")
+        .option("--force", "delete fix_action 실행 허용 (--fix와 함께 사용)")
         .option("--no-db", "DB 저장 건너뛰기")
         .option("--local", "~/.claude/semo/bots/ 로컬 미러 audit")
         .action(async (options) => {
@@ -596,14 +598,74 @@ function registerBotsCommands(program) {
         // Run audit — try DB-based rules first, fallback to hardcoded
         let results;
         const dbConnected = await (0, database_1.isDbConnected)();
+        let dbRules = [];
         if (dbConnected) {
             const pool = (0, database_1.getPool)();
+            try {
+                const { rows } = await (0, audit_1.loadCheckDefs)(pool);
+                dbRules = rows;
+            }
+            catch { /* DB rules load failed, will use fallback */ }
             results = await Promise.all(botEntries.map(({ botId, botDir }) => (0, audit_1.auditBotFromDb)(botDir, botId, pool)));
         }
         else {
             results = botEntries.map(({ botId, botDir }) => (0, audit_1.auditBot)(botDir, botId));
         }
+        // Merge skill structure checks into results
+        for (let i = 0; i < results.length; i++) {
+            const skillChecks = (0, audit_1.auditSkillStructure)(botEntries[i].botDir, botEntries[i].botId);
+            if (skillChecks.length > 0) {
+                results[i] = (0, audit_1.mergeDbChecks)(results[i], skillChecks);
+            }
+        }
         spinner.stop();
+        // --sync: DB required 항목 proactive 보장
+        if (options.sync && dbRules.length > 0) {
+            let totalCreated = 0;
+            const allViolations = [];
+            for (const { botId, botDir } of botEntries) {
+                const botSpecificRules = dbRules.filter((row) => {
+                    if (row.bot_scope === "all")
+                        return true;
+                    if (row.bot_scope === "include")
+                        return row.bot_ids.includes(botId);
+                    if (row.bot_scope === "exclude")
+                        return !row.bot_ids.includes(botId);
+                    return true;
+                });
+                const { created, violations } = (0, audit_1.syncBotFromDb)(botDir, botId, botSpecificRules);
+                if (created > 0) {
+                    console.log(chalk_1.default.green(`  ✔ ${botId}: ${created}개 항목 동기화 생성`));
+                    totalCreated += created;
+                }
+                allViolations.push(...violations.map((v) => `${botId}: ${v}`));
+            }
+            if (totalCreated > 0) {
+                console.log(chalk_1.default.green(`\n총 ${totalCreated}개 동기화`));
+            }
+            if (allViolations.length > 0) {
+                console.log(chalk_1.default.yellow(`\n⚠ content_rules 위반 (보고만):`));
+                for (const v of allViolations) {
+                    console.log(chalk_1.default.yellow(`  - ${v}`));
+                }
+            }
+            // Re-audit after sync
+            if (totalCreated > 0) {
+                if (dbConnected) {
+                    const pool = (0, database_1.getPool)();
+                    results = await Promise.all(botEntries.map(({ botId, botDir }) => (0, audit_1.auditBotFromDb)(botDir, botId, pool)));
+                }
+                else {
+                    results = botEntries.map(({ botId, botDir }) => (0, audit_1.auditBot)(botDir, botId));
+                }
+                for (let i = 0; i < results.length; i++) {
+                    const skillChecks = (0, audit_1.auditSkillStructure)(botEntries[i].botDir, botEntries[i].botId);
+                    if (skillChecks.length > 0) {
+                        results[i] = (0, audit_1.mergeDbChecks)(results[i], skillChecks);
+                    }
+                }
+            }
+        }
         // --fix
         if (options.fix) {
             let totalFixed = 0;
@@ -611,20 +673,50 @@ function registerBotsCommands(program) {
                 const botDir = isLocal
                     ? path.join(home, ".claude", "semo", "bots", r.botId)
                     : path.join(home, `.openclaw-${r.botId}`, "workspace");
-                const fixed = (0, audit_1.fixBot)(botDir, r.botId, r.checks);
+                let fixed;
+                if (dbRules.length > 0) {
+                    // DB-based fix
+                    const botSpecificRules = dbRules.filter((row) => {
+                        if (row.bot_scope === "all")
+                            return true;
+                        if (row.bot_scope === "include")
+                            return row.bot_ids.includes(r.botId);
+                        if (row.bot_scope === "exclude")
+                            return !row.bot_ids.includes(r.botId);
+                        return true;
+                    });
+                    const result = (0, audit_1.fixBotFromDb)(botDir, r.botId, r.checks, botSpecificRules, { force: options.force });
+                    fixed = result.fixed;
+                    if (result.skipped.length > 0) {
+                        for (const s of result.skipped) {
+                            console.log(chalk_1.default.yellow(`  ⚠ ${r.botId}: ${s}`));
+                        }
+                    }
+                }
+                else {
+                    // Fallback to hardcoded fix
+                    fixed = (0, audit_1.fixBot)(botDir, r.botId, r.checks);
+                }
                 if (fixed > 0) {
-                    console.log(chalk_1.default.green(`  ✔ ${r.botId}: ${fixed}개 파일/디렉토리 생성`));
+                    console.log(chalk_1.default.green(`  ✔ ${r.botId}: ${fixed}개 파일/디렉토리 수정`));
                     totalFixed += fixed;
                 }
             }
             if (totalFixed > 0) {
                 console.log(chalk_1.default.green(`\n총 ${totalFixed}개 수정`));
                 // Re-audit after fix
+                if (dbConnected) {
+                    const pool = (0, database_1.getPool)();
+                    results = await Promise.all(botEntries.map(({ botId, botDir }) => (0, audit_1.auditBotFromDb)(botDir, botId, pool)));
+                }
+                else {
+                    results = botEntries.map(({ botId, botDir }) => (0, audit_1.auditBot)(botDir, botId));
+                }
                 for (let i = 0; i < results.length; i++) {
-                    const botDir = isLocal
-                        ? path.join(home, ".claude", "semo", "bots", results[i].botId)
-                        : path.join(home, `.openclaw-${results[i].botId}`, "workspace");
-                    results[i] = (0, audit_1.auditBot)(botDir, results[i].botId);
+                    const skillChecks = (0, audit_1.auditSkillStructure)(botEntries[i].botDir, botEntries[i].botId);
+                    if (skillChecks.length > 0) {
+                        results[i] = (0, audit_1.mergeDbChecks)(results[i], skillChecks);
+                    }
                 }
             }
         }

package/dist/commands/skill-sync.d.ts

@@ -1,12 +1,15 @@
 /**
- * skill-sync — 봇 전용 스킬 파일 스캔 + DB 동기화
+ * skill-sync — 봇 워크스페이스 스킬 스캔 + DB 동기화
+ *
+ * v2.0: ~/.openclaw-{bot}/workspace/skills/ 경로 스캔 (semo-system/ 폐기)
+ * 봇 목록은 bot_status DB에서 동적 로드, fallback으로 로컬 디렉토리 스캔.
  *
  * semo bots sync (piggyback) 및 semo context sync (세션 훅) 양쪽에서 호출.
  * 스킬 이름은 flat (예: 'kb-manager'), metadata.bot_ids 배열로 봇 매핑.
  * 동일 스킬명이 여러 봇에 존재하면 bot_ids를 머지.
  */
-import { PoolClient } from "pg";
-interface ScannedSkill {
+import { Pool, PoolClient } from "pg";
+export interface ScannedSkill {
     name: string;
     prompt: string;
     package: string;
@@ -17,12 +20,21 @@ export interface SkillSyncResult {
     total: number;
 }
 /**
- * semo-system/bot-workspaces 에서 봇 전용 스킬 파일 스캔
+ * ~/.openclaw-{bot}/workspace/skills/ 에서 봇 전용 스킬 파일 스캔
+ *
+ * @param botIds - 스캔 대상 봇 ID 목록
+ */
+export declare function scanSkills(botIds: string[]): ScannedSkill[];
+/**
+ * @deprecated semo-system/ 기반 스캔 (하위호환 유지)
  */
 export declare function scanSkills(semoSystemDir: string): ScannedSkill[];
+/**
+ * DB에서 봇 목록을 로드, fallback으로 로컬 디렉토리 스캔
+ */
+export declare function getBotIds(pool: Pool): Promise<string[]>;
 /**
  * 스캔된 스킬을 skill_definitions에 upsert
  * flat name + metadata.bot_ids 배열 사용, 동일 스킬명은 bot_ids 머지
  */
-export declare function syncSkillsToDB(client: PoolClient, semoSystemDir: string): Promise<SkillSyncResult>;
-export {};
+export declare function syncSkillsToDB(client: PoolClient, pool: Pool): Promise<SkillSyncResult>;

package/dist/commands/skill-sync.js

@@ -1,6 +1,9 @@
 "use strict";
 /**
- * skill-sync — 봇 전용 스킬 파일 스캔 + DB 동기화
+ * skill-sync — 봇 워크스페이스 스킬 스캔 + DB 동기화
+ *
+ * v2.0: ~/.openclaw-{bot}/workspace/skills/ 경로 스캔 (semo-system/ 폐기)
+ * 봇 목록은 bot_status DB에서 동적 로드, fallback으로 로컬 디렉토리 스캔.
  *
  * semo bots sync (piggyback) 및 semo context sync (세션 훅) 양쪽에서 호출.
  * 스킬 이름은 flat (예: 'kb-manager'), metadata.bot_ids 배열로 봇 매핑.
@@ -41,13 +44,55 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.scanSkills = scanSkills;
+exports.getBotIds = getBotIds;
 exports.syncSkillsToDB = syncSkillsToDB;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
-/**
- * semo-system/bot-workspaces 에서 봇 전용 스킬 파일 스캔
- */
-function scanSkills(semoSystemDir) {
+function scanSkills(arg) {
+    if (typeof arg === "string") {
+        return scanSkillsLegacy(arg);
+    }
+    return scanSkillsV2(arg);
+}
+function scanSkillsV2(botIds) {
+    const skills = [];
+    const home = process.env.HOME || "/Users/reus";
+    for (const botId of botIds) {
+        const skillsDir = path.join(home, `.openclaw-${botId}`, "workspace", "skills");
+        if (!fs.existsSync(skillsDir))
+            continue;
+        let skillEntries;
+        try {
+            skillEntries = fs.readdirSync(skillsDir, { withFileTypes: true });
+        }
+        catch {
+            continue;
+        }
+        for (const skillEntry of skillEntries) {
+            if (!skillEntry.isDirectory())
+                continue;
+            if (skillEntry.name.endsWith(".skill"))
+                continue;
+            if (skillEntry.name.startsWith("_") || skillEntry.name.startsWith("."))
+                continue;
+            const skillMdPath = path.join(skillsDir, skillEntry.name, "SKILL.md");
+            if (!fs.existsSync(skillMdPath))
+                continue;
+            try {
+                skills.push({
+                    name: skillEntry.name,
+                    prompt: fs.readFileSync(skillMdPath, "utf-8"),
+                    package: "openclaw",
+                    botId,
+                });
+            }
+            catch { /* skip unreadable */ }
+        }
+    }
+    return skills;
+}
+/** Legacy: semo-system/bot-workspaces 에서 스캔 (하위호환) */
+function scanSkillsLegacy(semoSystemDir) {
     const skills = [];
     const workspacesDir = path.join(semoSystemDir, "bot-workspaces");
     if (!fs.existsSync(workspacesDir))
@@ -81,12 +126,42 @@ function scanSkills(semoSystemDir) {
     }
     return skills;
 }
+/**
+ * DB에서 봇 목록을 로드, fallback으로 로컬 디렉토리 스캔
+ */
+async function getBotIds(pool) {
+    try {
+        const result = await pool.query("SELECT bot_id FROM semo.bot_status ORDER BY bot_id");
+        if (result.rows.length > 0) {
+            return result.rows.map((r) => r.bot_id);
+        }
+    }
+    catch { /* fallback to local scan */ }
+    // Fallback: scan ~/.openclaw-*/workspace/ directories
+    const home = process.env.HOME || "/Users/reus";
+    const botIds = [];
+    try {
+        const entries = fs.readdirSync(home);
+        for (const entry of entries) {
+            const match = entry.match(/^\.openclaw-(.+)$/);
+            if (match) {
+                const wsDir = path.join(home, entry, "workspace");
+                if (fs.existsSync(wsDir)) {
+                    botIds.push(match[1]);
+                }
+            }
+        }
+    }
+    catch { /* skip */ }
+    return botIds.sort();
+}
 /**
  * 스캔된 스킬을 skill_definitions에 upsert
  * flat name + metadata.bot_ids 배열 사용, 동일 스킬명은 bot_ids 머지
  */
-async function syncSkillsToDB(client, semoSystemDir) {
-    const skills = scanSkills(semoSystemDir);
+async function syncSkillsToDB(client, pool) {
+    const botIds = await getBotIds(pool);
+    const skills = scanSkills(botIds);
     for (const skill of skills) {
         await client.query(`INSERT INTO semo.skill_definitions (name, prompt, package, metadata, is_active, office_id)
        VALUES ($1, $2, $3, $4, true, NULL)

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|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 시 스키마 키")
@@ -1949,6 +1928,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)"));
@@ -1993,7 +1990,7 @@ kbCmd
             }
         }
         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`));
             process.exit(1);
         }
         await (0, database_1.closeConnection)();

package/dist/kb.d.ts

@@ -246,6 +246,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

@@ -63,6 +63,7 @@ exports.ontoListServices = ontoListServices;
 exports.ontoListInstances = ontoListInstances;
 exports.ontoRegister = ontoRegister;
 exports.ontoAddKey = ontoAddKey;
+exports.ontoCreateType = ontoCreateType;
 exports.ontoRemoveKey = ontoRemoveKey;
 exports.ontoPullToLocal = ontoPullToLocal;
 const fs = __importStar(require("fs"));
@@ -1057,6 +1058,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.8.0",
+  "version": "4.10.0",
   "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
   "main": "dist/index.js",
   "bin": {