@team-semicolon/semo-cli 4.12.0 → 4.15.0

package/dist/commands/skill-sync.test.js

@@ -56,8 +56,8 @@ let tmpDir;
 let passed = 0;
 let failed = 0;
 function setup() {
-    const dir = fs.mkdtempSync(path.join(os.tmpdir(), "skill-sync-test-"));
-    fs.mkdirSync(path.join(dir, "bot-workspaces"), { recursive: true });
+    const dir = fs.mkdtempSync(path.join(os.tmpdir(), 'skill-sync-test-'));
+    fs.mkdirSync(path.join(dir, 'bot-workspaces'), { recursive: true });
     return dir;
 }
 function cleanup(dir) {
@@ -73,114 +73,147 @@ function assert(condition, message) {
         console.log(`  ❌ ${message}`);
     }
 }
-function makeBotSkill(dir, botId, skillName, content) {
-    const skillDir = path.join(dir, "bot-workspaces", botId, "skills", skillName);
+function makeBotSkill(dir, botId, skillName, content, refs) {
+    const skillDir = path.join(dir, 'bot-workspaces', botId, 'skills', skillName);
     fs.mkdirSync(skillDir, { recursive: true });
-    fs.writeFileSync(path.join(skillDir, "SKILL.md"), content);
+    fs.writeFileSync(path.join(skillDir, 'SKILL.md'), content);
+    if (refs) {
+        const refsDir = path.join(skillDir, 'references');
+        fs.mkdirSync(refsDir, { recursive: true });
+        for (const [name, refContent] of Object.entries(refs)) {
+            fs.writeFileSync(path.join(refsDir, name), refContent);
+        }
+    }
 }
 // ─── 테스트 ───────────────────────────────────────────────
-console.log("\n🧪 skill-sync.test.ts\n");
+console.log('\n🧪 skill-sync.test.ts\n');
 // 1. 빈 디렉토리
-console.log("Case 1: 빈 디렉토리");
+console.log('Case 1: 빈 디렉토리');
 tmpDir = setup();
 {
     const skills = (0, skill_sync_1.scanSkills)(tmpDir);
-    assert(skills.length === 0, "skills = 0");
+    assert(skills.length === 0, 'skills = 0');
 }
 cleanup(tmpDir);
 // 2. 봇 전용 스킬 — flat name
-console.log("Case 2: 봇 전용 스킬 flat name");
+console.log('Case 2: 봇 전용 스킬 flat name');
 tmpDir = setup();
 {
-    makeBotSkill(tmpDir, "semiclaw", "github-issue-pipeline", "# GH Pipeline");
+    makeBotSkill(tmpDir, 'semiclaw', 'github-issue-pipeline', '# GH Pipeline');
     const skills = (0, skill_sync_1.scanSkills)(tmpDir);
     assert(skills.length === 1, `skills = 1 (got ${skills.length})`);
-    assert(skills[0].name === "github-issue-pipeline", `name = github-issue-pipeline (got ${skills[0].name})`);
-    assert(skills[0].botId === "semiclaw", "botId = semiclaw");
-    assert(skills[0].package === "openclaw", "package = openclaw");
+    assert(skills[0].name === 'github-issue-pipeline', `name = github-issue-pipeline (got ${skills[0].name})`);
+    assert(skills[0].botId === 'semiclaw', 'botId = semiclaw');
+    assert(skills[0].package === 'openclaw', 'package = openclaw');
 }
 cleanup(tmpDir);
 // 3. 복수 봇의 전용 스킬 — botId 정확성
-console.log("Case 3: 복수 봇 botId 정확성");
+console.log('Case 3: 복수 봇 botId 정확성');
 tmpDir = setup();
 {
-    makeBotSkill(tmpDir, "semiclaw", "skill-a", "# A");
-    makeBotSkill(tmpDir, "semiclaw", "skill-b", "# B");
-    makeBotSkill(tmpDir, "workclaw", "skill-c", "# C");
-    makeBotSkill(tmpDir, "infraclaw", "skill-d", "# D");
+    makeBotSkill(tmpDir, 'semiclaw', 'skill-a', '# A');
+    makeBotSkill(tmpDir, 'semiclaw', 'skill-b', '# B');
+    makeBotSkill(tmpDir, 'workclaw', 'skill-c', '# C');
+    makeBotSkill(tmpDir, 'infraclaw', 'skill-d', '# D');
     const skills = (0, skill_sync_1.scanSkills)(tmpDir);
     assert(skills.length === 4, `총 4개 (got ${skills.length})`);
-    const semiclawSkills = skills.filter((s) => s.botId === "semiclaw");
-    const workclawSkills = skills.filter((s) => s.botId === "workclaw");
-    const infraclawSkills = skills.filter((s) => s.botId === "infraclaw");
+    const semiclawSkills = skills.filter((s) => s.botId === 'semiclaw');
+    const workclawSkills = skills.filter((s) => s.botId === 'workclaw');
+    const infraclawSkills = skills.filter((s) => s.botId === 'infraclaw');
     assert(semiclawSkills.length === 2, `semiclaw: 2개 (got ${semiclawSkills.length})`);
     assert(workclawSkills.length === 1, `workclaw: 1개 (got ${workclawSkills.length})`);
     assert(infraclawSkills.length === 1, `infraclaw: 1개 (got ${infraclawSkills.length})`);
 }
 cleanup(tmpDir);
 // 4. .skill 확장자 디렉토리 → 스킵
-console.log("Case 4: .skill 확장자 디렉토리");
+console.log('Case 4: .skill 확장자 디렉토리');
 tmpDir = setup();
 {
-    const dotSkillDir = path.join(tmpDir, "bot-workspaces", "semiclaw", "skills", "old-format.skill");
+    const dotSkillDir = path.join(tmpDir, 'bot-workspaces', 'semiclaw', 'skills', 'old-format.skill');
     fs.mkdirSync(dotSkillDir, { recursive: true });
-    fs.writeFileSync(path.join(dotSkillDir, "SKILL.md"), "should be skipped");
-    makeBotSkill(tmpDir, "semiclaw", "valid-skill", "# Valid");
+    fs.writeFileSync(path.join(dotSkillDir, 'SKILL.md'), 'should be skipped');
+    makeBotSkill(tmpDir, 'semiclaw', 'valid-skill', '# Valid');
     const skills = (0, skill_sync_1.scanSkills)(tmpDir);
     assert(skills.length === 1, `.skill 디렉토리 스킵, skills = 1 (got ${skills.length})`);
-    assert(skills[0].name === "valid-skill", "올바른 스킬만 반환");
+    assert(skills[0].name === 'valid-skill', '올바른 스킬만 반환');
 }
 cleanup(tmpDir);
 // 5. SKILL.md 없는 디렉토리 → 스킵
-console.log("Case 5: SKILL.md 없는 디렉토리");
+console.log('Case 5: SKILL.md 없는 디렉토리');
 tmpDir = setup();
 {
-    const emptyDir = path.join(tmpDir, "bot-workspaces", "semiclaw", "skills", "no-skill-md");
+    const emptyDir = path.join(tmpDir, 'bot-workspaces', 'semiclaw', 'skills', 'no-skill-md');
     fs.mkdirSync(emptyDir, { recursive: true });
-    makeBotSkill(tmpDir, "semiclaw", "valid-skill", "content");
+    makeBotSkill(tmpDir, 'semiclaw', 'valid-skill', 'content');
     const skills = (0, skill_sync_1.scanSkills)(tmpDir);
     assert(skills.length === 1, `SKILL.md 없는 디렉토리 스킵, skills = 1 (got ${skills.length})`);
 }
 cleanup(tmpDir);
 // 6. 스킬 변경 감지 — 파일 수정 후 재스캔
-console.log("Case 6: 스킬 변경 감지");
+console.log('Case 6: 스킬 변경 감지');
 tmpDir = setup();
 {
-    makeBotSkill(tmpDir, "semiclaw", "review", "# v1 content");
+    makeBotSkill(tmpDir, 'semiclaw', 'review', '# v1 content');
     const scan1 = (0, skill_sync_1.scanSkills)(tmpDir);
-    assert(scan1[0].prompt === "# v1 content", "초기 스캔: v1");
-    fs.writeFileSync(path.join(tmpDir, "bot-workspaces", "semiclaw", "skills", "review", "SKILL.md"), "# v2 updated content");
+    assert(scan1[0].prompt === '# v1 content', '초기 스캔: v1');
+    fs.writeFileSync(path.join(tmpDir, 'bot-workspaces', 'semiclaw', 'skills', 'review', 'SKILL.md'), '# v2 updated content');
     const scan2 = (0, skill_sync_1.scanSkills)(tmpDir);
-    assert(scan2[0].prompt === "# v2 updated content", "재스캔: v2 반영됨");
+    assert(scan2[0].prompt === '# v2 updated content', '재스캔: v2 반영됨');
 }
 cleanup(tmpDir);
 // 7. 스킬 추가 감지 — 새 디렉토리 추가 후 재스캔
-console.log("Case 7: 스킬 추가 감지");
+console.log('Case 7: 스킬 추가 감지');
 tmpDir = setup();
 {
-    makeBotSkill(tmpDir, "semiclaw", "existing", "# Existing");
+    makeBotSkill(tmpDir, 'semiclaw', 'existing', '# Existing');
     const scan1 = (0, skill_sync_1.scanSkills)(tmpDir);
-    assert(scan1.length === 1, "초기: 1개");
-    makeBotSkill(tmpDir, "semiclaw", "new-skill", "# New Skill");
+    assert(scan1.length === 1, '초기: 1개');
+    makeBotSkill(tmpDir, 'semiclaw', 'new-skill', '# New Skill');
     const scan2 = (0, skill_sync_1.scanSkills)(tmpDir);
     assert(scan2.length === 2, `추가 후: 2개 (got ${scan2.length})`);
 }
 cleanup(tmpDir);
 // 8. 스킬 삭제 감지 — SKILL.md 삭제 후 재스캔
-console.log("Case 8: 스킬 삭제 감지");
+console.log('Case 8: 스킬 삭제 감지');
 tmpDir = setup();
 {
-    makeBotSkill(tmpDir, "semiclaw", "to-delete", "# Will be deleted");
-    makeBotSkill(tmpDir, "semiclaw", "keep", "# Keep");
+    makeBotSkill(tmpDir, 'semiclaw', 'to-delete', '# Will be deleted');
+    makeBotSkill(tmpDir, 'semiclaw', 'keep', '# Keep');
     const scan1 = (0, skill_sync_1.scanSkills)(tmpDir);
-    assert(scan1.length === 2, "초기: 2개");
-    fs.unlinkSync(path.join(tmpDir, "bot-workspaces", "semiclaw", "skills", "to-delete", "SKILL.md"));
+    assert(scan1.length === 2, '초기: 2개');
+    fs.unlinkSync(path.join(tmpDir, 'bot-workspaces', 'semiclaw', 'skills', 'to-delete', 'SKILL.md'));
     const scan2 = (0, skill_sync_1.scanSkills)(tmpDir);
     assert(scan2.length === 1, `삭제 후: 1개 (got ${scan2.length})`);
-    assert(scan2[0].name === "keep", "남은 스킬: keep");
+    assert(scan2[0].name === 'keep', '남은 스킬: keep');
+}
+cleanup(tmpDir);
+// 9. references/ 있는 스킬 → referenceFiles 맵 반환
+console.log('Case 9: references/ 있는 스킬');
+tmpDir = setup();
+{
+    makeBotSkill(tmpDir, 'semiclaw', 'adhoc-meeting', '# Adhoc Meeting', {
+        'meeting-template.md': '# Template',
+        'decision-template.md': '# Decision',
+    });
+    const skills = (0, skill_sync_1.scanSkills)(tmpDir);
+    assert(skills.length === 1, 'skills = 1');
+    assert(skills[0].referenceFiles !== undefined, 'referenceFiles 존재');
+    assert(Object.keys(skills[0].referenceFiles).length === 2, 'referenceFiles 2개');
+    assert(skills[0].referenceFiles['meeting-template.md'] === '# Template', 'meeting-template 내용 일치');
+    assert(skills[0].referenceFiles['decision-template.md'] === '# Decision', 'decision-template 내용 일치');
+}
+cleanup(tmpDir);
+// 10. references/ 없는 스킬 → referenceFiles undefined
+console.log('Case 10: references/ 없는 스킬');
+tmpDir = setup();
+{
+    makeBotSkill(tmpDir, 'semiclaw', 'simple-skill', '# Simple');
+    const skills = (0, skill_sync_1.scanSkills)(tmpDir);
+    assert(skills.length === 1, 'skills = 1');
+    assert(skills[0].referenceFiles === undefined, 'referenceFiles undefined');
 }
 cleanup(tmpDir);
 // ─── 결과 ──────────────────────────────────────────────────
-console.log(`\n${"─".repeat(40)}`);
+console.log(`\n${'─'.repeat(40)}`);
 console.log(`총 ${passed + failed}개 테스트: ✅ ${passed} passed, ❌ ${failed} failed\n`);
 process.exit(failed > 0 ? 1 : 0);

package/dist/database.d.ts

@@ -11,7 +11,7 @@
  *   - command_definitions (prompt as content)
  *   - semo.skills / semo.agents / semo.commands 는 하위 호환 뷰
  */
-import { Pool } from "pg";
+import { Pool } from 'pg';
 export declare function getPool(): Pool;
 export interface Skill {
     id: string;
@@ -20,6 +20,7 @@ export interface Skill {
     description: string | null;
     content: string;
     bot_ids: string[];
+    reference_files?: Record<string, string>;
     category: string;
     package: string;
     is_active: boolean;

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 = {};
@@ -150,7 +162,7 @@ async function syncGlobalCache(claudeDir) {
         }
     }
     // 3. 에이전트 설치 (전체 교체, 대소문자 중복 제거)
-    const agentsDir = path.join(dir, "agents");
+    const agentsDir = path.join(dir, 'agents');
     removeRecursive(agentsDir);
     fs.mkdirSync(agentsDir, { recursive: true });
     const seenAgentNames = new Set();
@@ -170,8 +182,8 @@ async function syncGlobalCache(claudeDir) {
         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");
+                .map((d) => `- → ${d.to_bot_id}: ${d.domains.join(', ')} (via ${d.method})`)
+                .join('\n');
             content += `\n\n## 위임 매트릭스\n${delegationLines}\n`;
         }
         // metadata에 model/description이 있으면 YAML frontmatter 주입