@team-semicolon/semo-cli 4.13.0 → 4.15.1

package/dist/database.js

@@ -69,11 +69,11 @@ const env_parser_1 = require("./env-parser");
 // 인터랙티브 쉘이 아닌 환경에서 환경변수를 공급한다.
 // 이미 설정된 환경변수는 덮어쓰지 않는다 (env var > file).
 function loadSemoEnv() {
-    const envFile = path.join(os.homedir(), ".claude", "semo", ".env");
+    const envFile = path.join(os.homedir(), '.claude', 'semo', '.env');
     if (!fs.existsSync(envFile))
         return;
     try {
-        const creds = (0, env_parser_1.parseEnvContent)(fs.readFileSync(envFile, "utf8"));
+        const creds = (0, env_parser_1.parseEnvContent)(fs.readFileSync(envFile, 'utf8'));
         for (const [key, val] of Object.entries(creds)) {
             if (!process.env[key])
                 process.env[key] = val;
@@ -91,20 +91,22 @@ function buildDbConfig() {
     if (process.env.DATABASE_URL) {
         return {
             connectionString: process.env.DATABASE_URL,
-            ssl: process.env.DATABASE_URL.includes("sslmode=require") ? { rejectUnauthorized: false } : false,
+            ssl: process.env.DATABASE_URL.includes('sslmode=require')
+                ? { rejectUnauthorized: false }
+                : false,
             connectionTimeoutMillis: 5000,
             idleTimeoutMillis: 30000,
         };
     }
     if (!process.env.SEMO_DB_HOST && !process.env.DATABASE_URL) {
-        throw new Error("DB 연결 정보가 없습니다. DATABASE_URL 또는 SEMO_DB_HOST 환경변수를 설정하세요.");
+        throw new Error('DB 연결 정보가 없습니다. DATABASE_URL 또는 SEMO_DB_HOST 환경변수를 설정하세요.');
     }
     return {
         host: process.env.SEMO_DB_HOST,
-        port: parseInt(process.env.SEMO_DB_PORT || "5432"),
-        user: process.env.SEMO_DB_USER || "app",
+        port: parseInt(process.env.SEMO_DB_PORT || '5432'),
+        user: process.env.SEMO_DB_USER || 'app',
         password: process.env.SEMO_DB_PASSWORD,
-        database: process.env.SEMO_DB_NAME || "appdb",
+        database: process.env.SEMO_DB_NAME || 'appdb',
         ssl: false,
         connectionTimeoutMillis: 5000,
         idleTimeoutMillis: 30000,
@@ -125,7 +127,7 @@ async function checkDbConnection() {
         return dbAvailable;
     try {
         const client = await getPool().connect();
-        await client.query("SELECT 1");
+        await client.query('SELECT 1');
         client.release();
         dbAvailable = true;
     }
@@ -140,17 +142,95 @@ async function checkDbConnection() {
 const FALLBACK_SKILLS = [];
 const FALLBACK_COMMANDS = [];
 const FALLBACK_AGENTS = [
-    { id: "agent-semiclaw", name: "semiclaw", display_name: "SemiClaw 🦀", content: "", package: "openclaw", is_active: true, install_order: 1 },
-    { id: "agent-workclaw", name: "workclaw", display_name: "WorkClaw 🛠️", content: "", package: "openclaw", is_active: true, install_order: 2 },
-    { id: "agent-reviewclaw", name: "reviewclaw", display_name: "ReviewClaw 🔍", content: "", package: "openclaw", is_active: true, install_order: 3 },
-    { id: "agent-planclaw", name: "planclaw", display_name: "PlanClaw 🗓️", content: "", package: "openclaw", is_active: true, install_order: 4 },
-    { id: "agent-designclaw", name: "designclaw", display_name: "DesignClaw 🎨", content: "", package: "openclaw", is_active: true, install_order: 5 },
-    { id: "agent-infraclaw", name: "infraclaw", display_name: "InfraClaw 🏗️", content: "", package: "openclaw", is_active: true, install_order: 6 },
-    { id: "agent-growthclaw", name: "growthclaw", display_name: "GrowthClaw 🌱", content: "", package: "openclaw", is_active: true, install_order: 7 },
+    {
+        id: 'agent-semiclaw',
+        name: 'semiclaw',
+        display_name: 'SemiClaw 🦀',
+        content: '',
+        package: 'openclaw',
+        is_active: true,
+        install_order: 1,
+    },
+    {
+        id: 'agent-workclaw',
+        name: 'workclaw',
+        display_name: 'WorkClaw 🛠️',
+        content: '',
+        package: 'openclaw',
+        is_active: true,
+        install_order: 2,
+    },
+    {
+        id: 'agent-reviewclaw',
+        name: 'reviewclaw',
+        display_name: 'ReviewClaw 🔍',
+        content: '',
+        package: 'openclaw',
+        is_active: true,
+        install_order: 3,
+    },
+    {
+        id: 'agent-planclaw',
+        name: 'planclaw',
+        display_name: 'PlanClaw 🗓️',
+        content: '',
+        package: 'openclaw',
+        is_active: true,
+        install_order: 4,
+    },
+    {
+        id: 'agent-designclaw',
+        name: 'designclaw',
+        display_name: 'DesignClaw 🎨',
+        content: '',
+        package: 'openclaw',
+        is_active: true,
+        install_order: 5,
+    },
+    {
+        id: 'agent-infraclaw',
+        name: 'infraclaw',
+        display_name: 'InfraClaw 🏗️',
+        content: '',
+        package: 'openclaw',
+        is_active: true,
+        install_order: 6,
+    },
+    {
+        id: 'agent-growthclaw',
+        name: 'growthclaw',
+        display_name: 'GrowthClaw 🌱',
+        content: '',
+        package: 'openclaw',
+        is_active: true,
+        install_order: 7,
+    },
 ];
 const FALLBACK_PACKAGES = [
-    { id: "pkg-cli", name: "semo-cli", display_name: "SEMO CLI", description: "CLI 도구 (컨텍스트 동기화, 봇 관리)", layer: "standard", package_type: "standard", version: "4.2.0", is_active: true, is_required: true, install_order: 10 },
-    { id: "pkg-dashboard", name: "semo-dashboard", display_name: "SEMO Dashboard", description: "봇 상태/KB 대시보드", layer: "standard", package_type: "standard", version: "0.1.0", is_active: true, is_required: false, install_order: 30 },
+    {
+        id: 'pkg-cli',
+        name: 'semo-cli',
+        display_name: 'SEMO CLI',
+        description: 'CLI 도구 (컨텍스트 동기화, 봇 관리)',
+        layer: 'standard',
+        package_type: 'standard',
+        version: '4.2.0',
+        is_active: true,
+        is_required: true,
+        install_order: 10,
+    },
+    {
+        id: 'pkg-dashboard',
+        name: 'semo-dashboard',
+        display_name: 'SEMO Dashboard',
+        description: '봇 상태/KB 대시보드',
+        layer: 'standard',
+        package_type: 'standard',
+        version: '0.1.0',
+        is_active: true,
+        is_required: false,
+        install_order: 30,
+    },
 ];
 // ============================================================
 // DB 조회 함수
@@ -162,7 +242,7 @@ const FALLBACK_PACKAGES = [
 async function getActiveSkills() {
     const isConnected = await checkDbConnection();
     if (!isConnected) {
-        console.warn("⚠️ DB 연결 실패, 폴백 스킬 목록 사용");
+        console.warn('⚠️ DB 연결 실패, 폴백 스킬 목록 사용');
         return FALLBACK_SKILLS.filter((s) => s.is_active);
     }
     try {
@@ -173,6 +253,7 @@ async function getActiveSkills() {
                ARRAY(SELECT jsonb_array_elements_text(metadata->'bot_ids')),
                ARRAY[]::text[]
              ) AS bot_ids,
+             metadata->'reference_files' AS reference_files,
              category, package, is_active, is_required, install_order, version
       FROM semo.skill_definitions
       WHERE is_active = true AND office_id IS NULL
@@ -181,7 +262,7 @@ async function getActiveSkills() {
         return result.rows;
     }
     catch (error) {
-        console.warn("⚠️ 스킬 조회 실패, 폴백 데이터 사용:", error);
+        console.warn('⚠️ 스킬 조회 실패, 폴백 데이터 사용:', error);
         return FALLBACK_SKILLS.filter((s) => s.is_active);
     }
 }
@@ -199,7 +280,7 @@ async function getActiveSkillNames() {
 async function getActiveSkillsForBot(botId) {
     const isConnected = await checkDbConnection();
     if (!isConnected) {
-        console.warn("⚠️ DB 연결 실패, 폴백 스킬 목록 사용");
+        console.warn('⚠️ DB 연결 실패, 폴백 스킬 목록 사용');
         return FALLBACK_SKILLS.filter((s) => s.is_active);
     }
     try {
@@ -209,6 +290,7 @@ async function getActiveSkillsForBot(botId) {
                 ARRAY(SELECT jsonb_array_elements_text(sd.metadata->'bot_ids')),
                 ARRAY[]::text[]
               ) AS bot_ids,
+              sd.metadata->'reference_files' AS reference_files,
               sd.category, sd.package, sd.is_active, sd.is_required,
               sd.install_order, sd.version
        FROM semo.skill_definitions sd
@@ -221,7 +303,7 @@ async function getActiveSkillsForBot(botId) {
         return result.rows;
     }
     catch (error) {
-        console.warn("⚠️ 봇 스킬 조회 실패, 폴백 데이터 사용:", error);
+        console.warn('⚠️ 봇 스킬 조회 실패, 폴백 데이터 사용:', error);
         return FALLBACK_SKILLS.filter((s) => s.is_active);
     }
 }
@@ -232,7 +314,7 @@ async function getActiveSkillsForBot(botId) {
 async function getCommands() {
     const isConnected = await checkDbConnection();
     if (!isConnected) {
-        console.warn("⚠️ DB 연결 실패, 폴백 커맨드 목록 사용");
+        console.warn('⚠️ DB 연결 실패, 폴백 커맨드 목록 사용');
         return FALLBACK_COMMANDS.filter((c) => c.is_active);
     }
     try {
@@ -246,7 +328,7 @@ async function getCommands() {
         return result.rows;
     }
     catch (error) {
-        console.warn("⚠️ 커맨드 조회 실패, 폴백 데이터 사용:", error);
+        console.warn('⚠️ 커맨드 조회 실패, 폴백 데이터 사용:', error);
         return FALLBACK_COMMANDS.filter((c) => c.is_active);
     }
 }
@@ -257,7 +339,7 @@ async function getCommands() {
 async function getAgents() {
     const isConnected = await checkDbConnection();
     if (!isConnected) {
-        console.warn("⚠️ DB 연결 실패, 폴백 에이전트 목록 사용");
+        console.warn('⚠️ DB 연결 실패, 폴백 에이전트 목록 사용');
         return FALLBACK_AGENTS.filter((a) => a.is_active);
     }
     try {
@@ -273,7 +355,7 @@ async function getAgents() {
         return result.rows;
     }
     catch (error) {
-        console.warn("⚠️ 에이전트 조회 실패, 폴백 데이터 사용:", error);
+        console.warn('⚠️ 에이전트 조회 실패, 폴백 데이터 사용:', error);
         return FALLBACK_AGENTS.filter((a) => a.is_active);
     }
 }
@@ -283,7 +365,7 @@ async function getAgents() {
 async function getPackages(layer) {
     const isConnected = await checkDbConnection();
     if (!isConnected) {
-        console.warn("⚠️ DB 연결 실패, 폴백 패키지 목록 사용");
+        console.warn('⚠️ DB 연결 실패, 폴백 패키지 목록 사용');
         const fallback = FALLBACK_PACKAGES.filter((p) => p.is_active);
         return layer ? fallback.filter((p) => p.layer === layer) : fallback;
     }
@@ -304,7 +386,7 @@ async function getPackages(layer) {
         return result.rows;
     }
     catch (error) {
-        console.warn("⚠️ 패키지 조회 실패, 폴백 데이터 사용:", error);
+        console.warn('⚠️ 패키지 조회 실패, 폴백 데이터 사용:', error);
         const fallback = FALLBACK_PACKAGES.filter((p) => p.is_active);
         return layer ? fallback.filter((p) => p.layer === layer) : fallback;
     }

package/dist/global-cache.js

@@ -45,7 +45,7 @@ const path = __importStar(require("path"));
 const os = __importStar(require("os"));
 const child_process_1 = require("child_process");
 const database_1 = require("./database");
-const isWindows = process.platform === "win32";
+const isWindows = process.platform === 'win32';
 function removeRecursive(targetPath) {
     if (!fs.existsSync(targetPath))
         return;
@@ -53,10 +53,10 @@ function removeRecursive(targetPath) {
         try {
             const stats = fs.lstatSync(targetPath);
             if (stats.isSymbolicLink()) {
-                (0, child_process_1.execSync)(`cmd /c "rmdir "${targetPath}""`, { stdio: "pipe" });
+                (0, child_process_1.execSync)(`cmd /c "rmdir "${targetPath}""`, { stdio: 'pipe' });
             }
             else {
-                (0, child_process_1.execSync)(`cmd /c "rd /s /q "${targetPath}""`, { stdio: "pipe" });
+                (0, child_process_1.execSync)(`cmd /c "rd /s /q "${targetPath}""`, { stdio: 'pipe' });
             }
         }
         catch {
@@ -64,7 +64,7 @@ function removeRecursive(targetPath) {
         }
     }
     else {
-        (0, child_process_1.execSync)(`rm -rf "${targetPath}"`, { stdio: "pipe" });
+        (0, child_process_1.execSync)(`rm -rf "${targetPath}"`, { stdio: 'pipe' });
     }
 }
 /**
@@ -90,9 +90,7 @@ function injectAgentInfo(content, botIds) {
             const absDescStart = 4 + descIdx;
             const lineEnd = content.indexOf('\n', absDescStart);
             if (lineEnd !== -1) {
-                return (content.slice(0, lineEnd) +
-                    `\n  Agents: ${botIds.join(', ')}` +
-                    content.slice(lineEnd));
+                return (content.slice(0, lineEnd) + `\n  Agents: ${botIds.join(', ')}` + content.slice(lineEnd));
             }
         }
     }
@@ -104,7 +102,7 @@ function injectAgentInfo(content, botIds) {
     return content + agentLine;
 }
 async function syncGlobalCache(claudeDir) {
-    const dir = claudeDir || path.join(os.homedir(), ".claude");
+    const dir = claudeDir || path.join(os.homedir(), '.claude');
     fs.mkdirSync(dir, { recursive: true });
     // 병렬 조회
     const [skills, commands, agents, delegations] = await Promise.all([
@@ -114,7 +112,7 @@ async function syncGlobalCache(claudeDir) {
         (0, database_1.getDelegations)(),
     ]);
     // 1. 스킬 설치 (전체 교체)
-    const skillsDir = path.join(dir, "skills");
+    const skillsDir = path.join(dir, 'skills');
     removeRecursive(skillsDir);
     fs.mkdirSync(skillsDir, { recursive: true });
     let skippedSkills = 0;
@@ -124,13 +122,27 @@ async function syncGlobalCache(claudeDir) {
             skippedSkills++;
             continue;
         }
+        if (!skill.content)
+            continue; // skip skills with null/empty content
         const skillFolder = path.join(skillsDir, skill.name);
         fs.mkdirSync(skillFolder, { recursive: true });
         const finalContent = injectAgentInfo(skill.content, skill.bot_ids);
-        fs.writeFileSync(path.join(skillFolder, "SKILL.md"), finalContent);
+        fs.writeFileSync(path.join(skillFolder, 'SKILL.md'), finalContent);
+        // Write reference files if present
+        if (skill.reference_files &&
+            typeof skill.reference_files === 'object' &&
+            Object.keys(skill.reference_files).length > 0) {
+            const refsDir = path.join(skillFolder, 'references');
+            fs.mkdirSync(refsDir, { recursive: true });
+            for (const [filename, refContent] of Object.entries(skill.reference_files)) {
+                if (typeof refContent === 'string') {
+                    fs.writeFileSync(path.join(refsDir, filename), refContent);
+                }
+            }
+        }
     }
     // 2. 커맨드 설치 (전체 교체)
-    const commandsDir = path.join(dir, "commands");
+    const commandsDir = path.join(dir, 'commands');
     removeRecursive(commandsDir);
     fs.mkdirSync(commandsDir, { recursive: true });
     const commandsByFolder = {};
@@ -149,9 +161,8 @@ async function syncGlobalCache(claudeDir) {
             cmdCount++;
         }
     }
-    // 3. 에이전트 설치 (전체 교체, 대소문자 중복 제거)
-    const agentsDir = path.join(dir, "agents");
-    removeRecursive(agentsDir);
+    // 3. 에이전트 설치 (머지 모드 — 로컬 YAML frontmatter 보존)
+    const agentsDir = path.join(dir, 'agents');
     fs.mkdirSync(agentsDir, { recursive: true });
     const seenAgentNames = new Set();
     const dedupedAgents = [];
@@ -162,30 +173,62 @@ async function syncGlobalCache(claudeDir) {
             dedupedAgents.push(agent);
         }
     }
+    // 기존 로컬 파일의 frontmatter 캐싱 (덮어쓰기 전)
+    const existingFrontmatters = new Map();
+    for (const folder of fs.readdirSync(agentsDir).filter((f) => !f.startsWith('.'))) {
+        const filePath = path.join(agentsDir, folder, `${folder}.md`);
+        if (fs.existsSync(filePath)) {
+            const existing = fs.readFileSync(filePath, 'utf8');
+            const fmMatch = existing.match(/^---\n([\s\S]*?)\n---\n/);
+            if (fmMatch) {
+                existingFrontmatters.set(folder.toLowerCase(), fmMatch[1]);
+            }
+        }
+    }
+    // DB에 없는 에이전트 폴더 정리 (orphan 제거)
+    const dbAgentNames = new Set(dedupedAgents.map((a) => a.name.toLowerCase()));
+    for (const folder of fs.readdirSync(agentsDir).filter((f) => !f.startsWith('.'))) {
+        const folderPath = path.join(agentsDir, folder);
+        if (!dbAgentNames.has(folder.toLowerCase()) && fs.statSync(folderPath).isDirectory()) {
+            removeRecursive(folderPath);
+        }
+    }
     for (const agent of dedupedAgents) {
         const agentFolder = path.join(agentsDir, agent.name);
         fs.mkdirSync(agentFolder, { recursive: true });
-        let content = agent.content;
+        // DB content에서 frontmatter 제거 (body만 추출)
+        let dbBody = agent.content;
+        const dbFmMatch = agent.content.match(/^---\n[\s\S]*?\n---\n([\s\S]*)$/);
+        if (dbFmMatch) {
+            dbBody = dbFmMatch[1].trim();
+        }
         // 위임 매트릭스 주입
         const agentDelegations = delegations.filter((d) => d.from_bot_id === agent.name);
         if (agentDelegations.length > 0) {
             const delegationLines = agentDelegations
-                .map((d) => `- → ${d.to_bot_id}: ${d.domains.join(", ")} (via ${d.method})`)
-                .join("\n");
-            content += `\n\n## 위임 매트릭스\n${delegationLines}\n`;
+                .map((d) => `- → ${d.to_bot_id}: ${d.domains.join(', ')} (via ${d.method})`)
+                .join('\n');
+            dbBody += `\n\n## 위임 매트릭스\n${delegationLines}\n`;
         }
-        // metadata에 model/description이 있으면 YAML frontmatter 주입
-        if (agent.metadata && (agent.metadata.model || agent.metadata.description)) {
-            const hasFrontmatter = content.trimStart().startsWith('---');
-            if (!hasFrontmatter) {
-                const fm = ['---'];
-                if (agent.metadata.description)
-                    fm.push(`description: "${agent.metadata.description}"`);
-                if (agent.metadata.model)
-                    fm.push(`model: "${agent.metadata.model}"`);
-                fm.push('---', '');
-                content = fm.join('\n') + content;
-            }
+        // 로컬 frontmatter 보존 (있으면) → DB body와 합침
+        const localFm = existingFrontmatters.get(agent.name.toLowerCase());
+        let content;
+        if (localFm) {
+            // 로컬 frontmatter 우선 보존 + DB body 업데이트
+            content = `---\n${localFm}\n---\n${dbBody}`;
+        }
+        else if (agent.metadata && (agent.metadata.model || agent.metadata.description)) {
+            // 로컬 frontmatter 없으면 metadata에서 생성
+            const fm = ['---'];
+            if (agent.metadata.description)
+                fm.push(`description: "${agent.metadata.description}"`);
+            if (agent.metadata.model)
+                fm.push(`model: "${agent.metadata.model}"`);
+            fm.push('---', '');
+            content = fm.join('\n') + dbBody;
+        }
+        else {
+            content = dbBody;
         }
         fs.writeFileSync(path.join(agentFolder, `${agent.name}.md`), content);
     }