@team-semicolon/semo-cli 3.10.0 → 3.13.0

package/dist/index.js

@@ -59,6 +59,7 @@ const child_process_1 = require("child_process");
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const os = __importStar(require("os"));
+const supabase_1 = require("./supabase");
 const PACKAGE_NAME = "@team-semicolon/semo-cli";
 // package.json에서 버전 동적 로드
 function getCliVersion() {
@@ -673,8 +674,39 @@ function copyRecursive(src, dest) {
     }
 }
 const SEMO_REPO = "https://github.com/semicolon-devteam/semo.git";
-// 확장 패키지 정의 (v3.0 구조)
-const EXTENSION_PACKAGES = {
+// ============================================================
+// DB 기반 패키지 관리 (v3.10+)
+// ============================================================
+// 캐시된 패키지 데이터 (DB에서 조회 후 캐시)
+let cachedExtensionPackages = null;
+let cachedShortnameMappings = null;
+let cachedPackageDefinitions = null;
+// 패키지 데이터 초기화 (DB에서 조회)
+async function initPackageData() {
+    if (cachedExtensionPackages && cachedShortnameMappings)
+        return;
+    try {
+        cachedExtensionPackages = await (0, supabase_1.buildExtensionPackagesFromDb)();
+        cachedShortnameMappings = await (0, supabase_1.buildShortnameMappingFromDb)();
+        cachedPackageDefinitions = await (0, supabase_1.getExtensionPackages)();
+    }
+    catch {
+        // 폴백: 하드코딩된 데이터 사용
+        cachedExtensionPackages = EXTENSION_PACKAGES_FALLBACK;
+        cachedShortnameMappings = SHORTNAME_MAPPING_FALLBACK;
+        cachedPackageDefinitions = null;
+    }
+}
+// EXTENSION_PACKAGES 동기 접근용 (초기화 후 사용)
+function getExtensionPackagesSync() {
+    return cachedExtensionPackages || EXTENSION_PACKAGES_FALLBACK;
+}
+// SHORTNAME_MAPPING 동기 접근용
+function getShortnameMappingSync() {
+    return cachedShortnameMappings || SHORTNAME_MAPPING_FALLBACK;
+}
+// 폴백용 하드코딩 데이터 (DB 연결 실패 시 사용)
+const EXTENSION_PACKAGES_FALLBACK = {
     // Business Layer
     "biz/discovery": { name: "Discovery", desc: "아이템 발굴, 시장 조사, Epic/Task", layer: "biz", detect: [] },
     "biz/design": { name: "Design", desc: "컨셉 설계, 목업, UX", layer: "biz", detect: [] },
@@ -695,8 +727,8 @@ const EXTENSION_PACKAGES = {
     "semo-hooks": { name: "Hooks", desc: "Claude Code Hooks 기반 로깅 시스템", layer: "system", detect: [] },
     "semo-remote": { name: "Remote", desc: "Claude Code 원격 제어 (모바일 PWA)", layer: "system", detect: [] },
 };
-// 단축명 → 전체 패키지 경로 매핑
-const SHORTNAME_MAPPING = {
+// 단축명 → 전체 패키지 경로 매핑 (폴백)
+const SHORTNAME_MAPPING_FALLBACK = {
     // 하위 패키지명 단축 (discovery → biz/discovery)
     discovery: "biz/discovery",
     design: "biz/design",
@@ -717,11 +749,20 @@ const SHORTNAME_MAPPING = {
     hooks: "semo-hooks",
     remote: "semo-remote",
 };
+// 호환성을 위한 상수 별칭 (기존 코드에서 사용)
+const EXTENSION_PACKAGES = EXTENSION_PACKAGES_FALLBACK;
+const SHORTNAME_MAPPING = SHORTNAME_MAPPING_FALLBACK;
 // 그룹 이름 목록 (biz, eng, ops, meta, system)
 const PACKAGE_GROUPS = ["biz", "eng", "ops", "meta", "system"];
-// 그룹명 → 해당 그룹의 모든 패키지 반환
-function getPackagesByGroup(group) {
-    return Object.entries(EXTENSION_PACKAGES)
+// 그룹명 → 해당 그룹의 모든 패키지 반환 (DB 기반)
+async function getPackagesByGroupAsync(group) {
+    const packages = await (0, supabase_1.getPackagesByGroup)(group);
+    return packages.map(p => p.name);
+}
+// 그룹명 → 해당 그룹의 모든 패키지 반환 (동기, 폴백)
+function getPackagesByGroupSync(group) {
+    const extPkgs = getExtensionPackagesSync();
+    return Object.entries(extPkgs)
         .filter(([, pkg]) => pkg.layer === group)
         .map(([key]) => key);
 }
@@ -732,22 +773,25 @@ function resolvePackageInput(input) {
     const resolvedPackages = [];
     let isGroup = false;
     let groupName;
+    // DB에서 로드된 데이터 또는 폴백 사용
+    const extPkgs = getExtensionPackagesSync();
+    const shortnames = getShortnameMappingSync();
     for (const part of parts) {
         // 1. 그룹명인지 확인 (biz, eng, ops, meta)
         if (PACKAGE_GROUPS.includes(part)) {
-            const groupPackages = getPackagesByGroup(part);
+            const groupPackages = getPackagesByGroupSync(part);
             resolvedPackages.push(...groupPackages);
             isGroup = true;
             groupName = part;
             continue;
         }
         // 2. 단축명 매핑 확인 (discovery → biz/discovery 등)
-        if (part in SHORTNAME_MAPPING) {
-            resolvedPackages.push(SHORTNAME_MAPPING[part]);
+        if (part in shortnames) {
+            resolvedPackages.push(shortnames[part]);
             continue;
         }
         // 3. 직접 패키지명 확인
-        if (part in EXTENSION_PACKAGES) {
+        if (part in extPkgs) {
             resolvedPackages.push(part);
             continue;
         }
@@ -1132,8 +1176,10 @@ program
     .action(async (options) => {
     console.log(chalk_1.default.cyan.bold("\n🚀 SEMO 설치 시작\n"));
     console.log(chalk_1.default.gray("Gemini 하이브리드 전략: White Box + Black Box\n"));
+    // 0. 패키지 데이터 초기화 (DB에서 조회)
+    await initPackageData();
     const cwd = process.cwd();
-    // 0. 버전 비교
+    // 0.1. 버전 비교
     await showVersionComparison(cwd);
     // 0.5. 레거시 환경 감지 및 마이그레이션
     const legacyCheck = detectLegacyEnvironment(cwd);
@@ -1161,18 +1207,23 @@ program
     }
     // 2. Extension 패키지 처리 (--with 옵션만 지원, 인터랙션 없음)
     let extensionsToInstall = [];
+    const extPkgs = getExtensionPackagesSync();
+    const shortnames = getShortnameMappingSync();
     if (options.with) {
         // --with 옵션으로 명시적 패키지 지정 시에만 Extension 설치
-        extensionsToInstall = options.with.split(",").map((p) => p.trim()).filter((p) => p in EXTENSION_PACKAGES || p in SHORTNAME_MAPPING);
+        extensionsToInstall = options.with.split(",").map((p) => p.trim()).filter((p) => p in extPkgs || p in shortnames);
         // 별칭 처리
-        extensionsToInstall = extensionsToInstall.map((p) => SHORTNAME_MAPPING[p] || p);
+        extensionsToInstall = extensionsToInstall.map((p) => shortnames[p] || p);
     }
     // 프로젝트 유형 감지는 정보 제공용으로만 사용 (자동 설치 안 함)
     const detected = detectProjectType(cwd);
     if (detected.length > 0 && !options.with) {
         console.log(chalk_1.default.cyan("\n💡 감지된 프로젝트 유형:"));
         detected.forEach(pkg => {
-            console.log(chalk_1.default.gray(`   - ${EXTENSION_PACKAGES[pkg].name}: ${EXTENSION_PACKAGES[pkg].desc}`));
+            const pkgInfo = extPkgs[pkg];
+            if (pkgInfo) {
+                console.log(chalk_1.default.gray(`   - ${pkgInfo.name}: ${pkgInfo.desc}`));
+            }
         });
         console.log(chalk_1.default.gray(`\n   추가 패키지가 필요하면: semo add ${detected[0].split("/")[1] || detected[0]}`));
     }
@@ -1303,7 +1354,7 @@ async function createStandardSymlinks(cwd) {
         }
         console.log(chalk_1.default.green(`  ✓ .claude/agents/ (${agents.length}개 agent 링크됨)`));
     }
-    // skills 디렉토리 생성 및 개별 링크 (Extension 병합 지원)
+    // skills 디렉토리 생성 및 개별 링크 (DB 기반 - 활성 스킬만)
     const claudeSkillsDir = path.join(claudeDir, "skills");
     const coreSkillsDir = path.join(semoSystemDir, "semo-skills");
     if (fs.existsSync(coreSkillsDir)) {
@@ -1312,15 +1363,19 @@ async function createStandardSymlinks(cwd) {
             removeRecursive(claudeSkillsDir);
         }
         fs.mkdirSync(claudeSkillsDir, { recursive: true });
-        const skills = fs.readdirSync(coreSkillsDir).filter(f => fs.statSync(path.join(coreSkillsDir, f)).isDirectory());
-        for (const skill of skills) {
-            const skillLink = path.join(claudeSkillsDir, skill);
-            const skillTarget = path.join(coreSkillsDir, skill);
-            if (!fs.existsSync(skillLink)) {
+        // DB에서 활성 스킬 목록 조회 (19개 핵심 스킬만)
+        const activeSkillNames = await (0, supabase_1.getActiveSkillNames)();
+        let linkedCount = 0;
+        for (const skillName of activeSkillNames) {
+            const skillLink = path.join(claudeSkillsDir, skillName);
+            const skillTarget = path.join(coreSkillsDir, skillName);
+            // 스킬 폴더가 존재하는 경우에만 링크
+            if (fs.existsSync(skillTarget) && !fs.existsSync(skillLink)) {
                 createSymlinkOrJunction(skillTarget, skillLink);
+                linkedCount++;
             }
         }
-        console.log(chalk_1.default.green(`  ✓ .claude/skills/ (${skills.length}개 skill 링크됨)`));
+        console.log(chalk_1.default.green(`  ✓ .claude/skills/ (${linkedCount}개 skill 링크됨 - DB 기반)`));
     }
     // commands 링크
     const commandsDir = path.join(claudeDir, "commands");
@@ -2744,6 +2799,8 @@ program
     .description("Extension 패키지를 추가로 설치합니다 (그룹: biz, eng, ops, system / 개별: biz/discovery, eng/nextjs, semo-hooks)")
     .option("-f, --force", "기존 설정 덮어쓰기")
     .action(async (packagesInput, options) => {
+    // 패키지 데이터 초기화 (DB에서 조회)
+    await initPackageData();
     const cwd = process.cwd();
     const semoSystemDir = path.join(cwd, "semo-system");
     if (!fs.existsSync(semoSystemDir)) {
@@ -2752,11 +2809,13 @@ program
     }
     // 패키지 입력 해석 (그룹, 레거시, 쉼표 구분 모두 처리)
     const { packages, isGroup, groupName } = resolvePackageInput(packagesInput);
+    const extPkgs = getExtensionPackagesSync();
+    const shortnames = getShortnameMappingSync();
     if (packages.length === 0) {
         console.log(chalk_1.default.red(`\n알 수 없는 패키지: ${packagesInput}`));
         console.log(chalk_1.default.gray(`사용 가능한 그룹: ${PACKAGE_GROUPS.join(", ")}`));
-        console.log(chalk_1.default.gray(`사용 가능한 패키지: ${Object.keys(EXTENSION_PACKAGES).join(", ")}`));
-        console.log(chalk_1.default.gray(`단축명: ${Object.keys(SHORTNAME_MAPPING).join(", ")}\n`));
+        console.log(chalk_1.default.gray(`사용 가능한 패키지: ${Object.keys(extPkgs).join(", ")}`));
+        console.log(chalk_1.default.gray(`단축명: ${Object.keys(shortnames).join(", ")}\n`));
         process.exit(1);
     }
     // 그룹 설치인 경우 안내
@@ -2764,21 +2823,24 @@ program
         console.log(chalk_1.default.cyan.bold(`\n📦 ${groupName?.toUpperCase()} 그룹 패키지 일괄 설치\n`));
         console.log(chalk_1.default.gray("   포함된 패키지:"));
         for (const pkg of packages) {
-            console.log(chalk_1.default.gray(`   - ${pkg} (${EXTENSION_PACKAGES[pkg].name})`));
+            const pkgInfo = extPkgs[pkg];
+            console.log(chalk_1.default.gray(`   - ${pkg} (${pkgInfo?.name || pkg})`));
         }
         console.log();
     }
     else if (packages.length === 1) {
         // 단일 패키지
         const pkg = packages[0];
-        console.log(chalk_1.default.cyan(`\n📦 ${EXTENSION_PACKAGES[pkg].name} 패키지 설치\n`));
-        console.log(chalk_1.default.gray(`   ${EXTENSION_PACKAGES[pkg].desc}\n`));
+        const pkgInfo = extPkgs[pkg];
+        console.log(chalk_1.default.cyan(`\n📦 ${pkgInfo?.name || pkg} 패키지 설치\n`));
+        console.log(chalk_1.default.gray(`   ${pkgInfo?.desc || ""}\n`));
     }
     else {
         // 여러 패키지 (쉼표 구분)
         console.log(chalk_1.default.cyan.bold(`\n📦 ${packages.length}개 패키지 설치\n`));
         for (const pkg of packages) {
-            console.log(chalk_1.default.gray(`   - ${pkg} (${EXTENSION_PACKAGES[pkg].name})`));
+            const pkgInfo = extPkgs[pkg];
+            console.log(chalk_1.default.gray(`   - ${pkg} (${pkgInfo?.name || pkg})`));
         }
         console.log();
     }
@@ -2817,12 +2879,14 @@ program
     // 4. CLAUDE.md 재생성 (모든 설치된 패키지 반영)
     await setupClaudeMd(cwd, allInstalledPackages, options.force);
     if (toInstall.length === 1) {
-        console.log(chalk_1.default.green.bold(`\n✅ ${EXTENSION_PACKAGES[toInstall[0]].name} 패키지 설치 완료!\n`));
+        const pkgInfo = extPkgs[toInstall[0]];
+        console.log(chalk_1.default.green.bold(`\n✅ ${pkgInfo?.name || toInstall[0]} 패키지 설치 완료!\n`));
     }
     else {
         console.log(chalk_1.default.green.bold(`\n✅ ${toInstall.length}개 패키지 설치 완료!`));
         for (const pkg of toInstall) {
-            console.log(chalk_1.default.green(`   ✓ ${EXTENSION_PACKAGES[pkg].name}`));
+            const pkgInfo = extPkgs[pkg];
+            console.log(chalk_1.default.green(`   ✓ ${pkgInfo?.name || pkg}`));
         }
         console.log();
     }
@@ -2831,10 +2895,13 @@ program
 program
     .command("list")
     .description("사용 가능한 모든 패키지를 표시합니다")
-    .action(() => {
+    .action(async () => {
+    // 패키지 데이터 초기화 (DB에서 조회)
+    await initPackageData();
     const cwd = process.cwd();
     const semoSystemDir = path.join(cwd, "semo-system");
-    console.log(chalk_1.default.cyan.bold("\n📦 SEMO 패키지 목록 (v3.0)\n"));
+    const extPkgs = getExtensionPackagesSync();
+    console.log(chalk_1.default.cyan.bold("\n📦 SEMO 패키지 목록 (v3.10 - DB 기반)\n"));
     // Standard
     console.log(chalk_1.default.white.bold("Standard (필수)"));
     const coreInstalled = fs.existsSync(path.join(semoSystemDir, "semo-core"));
@@ -2851,7 +2918,7 @@ program
         system: { title: "System", emoji: "🔩" },
     };
     for (const [layerKey, layerInfo] of Object.entries(layers)) {
-        const layerPackages = Object.entries(EXTENSION_PACKAGES).filter(([, pkg]) => pkg.layer === layerKey);
+        const layerPackages = Object.entries(extPkgs).filter(([, pkg]) => pkg.layer === layerKey);
         if (layerPackages.length === 0)
             continue;
         console.log(chalk_1.default.white.bold(`${layerInfo.emoji} ${layerInfo.title}`));
@@ -2948,6 +3015,8 @@ program
     .option("--migrate", "레거시 환경 강제 마이그레이션")
     .action(async (options) => {
     console.log(chalk_1.default.cyan.bold("\n🔄 SEMO 업데이트\n"));
+    // 패키지 데이터 초기화 (DB에서 조회)
+    await initPackageData();
     const cwd = process.cwd();
     const semoSystemDir = path.join(cwd, "semo-system");
     const claudeDir = path.join(cwd, ".claude");
@@ -3000,7 +3069,8 @@ program
     }
     // 설치된 Extensions 확인
     const installedExtensions = [];
-    for (const key of Object.keys(EXTENSION_PACKAGES)) {
+    const extPkgs = getExtensionPackagesSync();
+    for (const key of Object.keys(extPkgs)) {
         if (fs.existsSync(path.join(semoSystemDir, key))) {
             installedExtensions.push(key);
         }

package/dist/supabase.d.ts

@@ -0,0 +1,97 @@
+/**
+ * SEMO CLI - Supabase 클라이언트
+ *
+ * package_definitions 테이블에서 패키지 정보를 조회합니다.
+ * DB 연결 실패 시 하드코딩된 폴백 데이터를 사용합니다.
+ */
+export interface PackageDefinition {
+    id: string;
+    name: string;
+    display_name: string;
+    description: string | null;
+    layer: "standard" | "biz" | "eng" | "ops" | "system" | "meta";
+    package_type: "standard" | "extension";
+    version: string;
+    repo_url: string;
+    source_path: string;
+    detect_files: string[];
+    depends_on: string[];
+    aliases: string[];
+    is_active: boolean;
+    is_required: boolean;
+    install_order: number;
+}
+/**
+ * 모든 패키지 목록 조회
+ */
+export declare function getPackages(layer?: string): Promise<PackageDefinition[]>;
+/**
+ * Standard 패키지 목록 조회
+ */
+export declare function getStandardPackages(): Promise<PackageDefinition[]>;
+/**
+ * Extension 패키지 목록 조회
+ */
+export declare function getExtensionPackages(layer?: string): Promise<PackageDefinition[]>;
+/**
+ * 패키지명 또는 별칭으로 패키지 찾기
+ */
+export declare function resolvePackageName(input: string): Promise<string | null>;
+/**
+ * 패키지 버전 조회
+ */
+export declare function getPackageVersion(name: string): Promise<string | null>;
+/**
+ * 그룹별 패키지 목록 조회
+ */
+export declare function getPackagesByGroup(group: string): Promise<PackageDefinition[]>;
+/**
+ * 프로젝트 타입 감지용 패키지 조회
+ */
+export declare function getDetectablePackages(): Promise<PackageDefinition[]>;
+/**
+ * 패키지 정보를 CLI 포맷으로 변환
+ */
+export declare function toExtensionPackageFormat(pkg: PackageDefinition): {
+    name: string;
+    desc: string;
+    detect: string[];
+    layer: string;
+};
+/**
+ * 별칭 매핑 객체 생성 (SHORTNAME_MAPPING 대체)
+ */
+export declare function buildShortnameMappingFromDb(): Promise<Record<string, string>>;
+/**
+ * EXTENSION_PACKAGES 형태의 객체 생성 (호환성용)
+ */
+export declare function buildExtensionPackagesFromDb(): Promise<Record<string, {
+    name: string;
+    desc: string;
+    detect: string[];
+    layer: string;
+}>>;
+export interface SkillDefinition {
+    id: string;
+    name: string;
+    display_name: string;
+    description: string | null;
+    category: "workflow" | "discovery" | "planning" | "solutioning" | "implementation" | "supporting";
+    source_path: string;
+    is_active: boolean;
+    is_required: boolean;
+    install_order: number;
+    version: string;
+}
+/**
+ * 활성 스킬 목록 조회 (설치할 스킬)
+ */
+export declare function getActiveSkills(): Promise<SkillDefinition[]>;
+/**
+ * 스킬 이름 목록만 조회
+ */
+export declare function getActiveSkillNames(): Promise<string[]>;
+/**
+ * 카테고리별 스킬 개수 조회
+ */
+export declare function getSkillCountByCategory(): Promise<Record<string, number>>;

package/dist/supabase.js

@@ -0,0 +1,602 @@
+"use strict";
+/**
+ * SEMO CLI - Supabase 클라이언트
+ *
+ * package_definitions 테이블에서 패키지 정보를 조회합니다.
+ * DB 연결 실패 시 하드코딩된 폴백 데이터를 사용합니다.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPackages = getPackages;
+exports.getStandardPackages = getStandardPackages;
+exports.getExtensionPackages = getExtensionPackages;
+exports.resolvePackageName = resolvePackageName;
+exports.getPackageVersion = getPackageVersion;
+exports.getPackagesByGroup = getPackagesByGroup;
+exports.getDetectablePackages = getDetectablePackages;
+exports.toExtensionPackageFormat = toExtensionPackageFormat;
+exports.buildShortnameMappingFromDb = buildShortnameMappingFromDb;
+exports.buildExtensionPackagesFromDb = buildExtensionPackagesFromDb;
+exports.getActiveSkills = getActiveSkills;
+exports.getActiveSkillNames = getActiveSkillNames;
+exports.getSkillCountByCategory = getSkillCountByCategory;
+const supabase_js_1 = require("@supabase/supabase-js");
+// Supabase 연결 정보 (공개 프로젝트용)
+const SUPABASE_URL = process.env.SEMO_SUPABASE_URL || "https://vdrllieckyeumbhyclkc.supabase.co";
+const SUPABASE_ANON_KEY = process.env.SEMO_SUPABASE_ANON_KEY ||
+    "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InZkcmxsaWVja3lldW1iaHljbGtjIiwicm9sZSI6ImFub24iLCJpYXQiOjE3Njc5NzgxMTEsImV4cCI6MjA4MzU1NDExMX0.SrruG4y9geH1bCWE4uLzMHiUA38UcGMQwbAxxaaa718";
+// Supabase 클라이언트 (싱글톤)
+let supabaseClient = null;
+function getSupabaseClient() {
+    if (!supabaseClient) {
+        supabaseClient = (0, supabase_js_1.createClient)(SUPABASE_URL, SUPABASE_ANON_KEY);
+    }
+    return supabaseClient;
+}
+// DB 연결 가능 여부 확인
+let dbAvailable = null;
+async function checkDbConnection() {
+    if (dbAvailable !== null)
+        return dbAvailable;
+    try {
+        const supabase = getSupabaseClient();
+        const { error } = await supabase
+            .from("package_definitions")
+            .select("id")
+            .limit(1);
+        dbAvailable = !error;
+    }
+    catch {
+        dbAvailable = false;
+    }
+    return dbAvailable;
+}
+/**
+ * 모든 패키지 목록 조회
+ */
+async function getPackages(layer) {
+    const isConnected = await checkDbConnection();
+    if (!isConnected) {
+        console.warn("⚠️ DB 연결 실패, 폴백 데이터 사용");
+        return getFallbackPackages(layer);
+    }
+    const supabase = getSupabaseClient();
+    let query = supabase
+        .from("package_definitions")
+        .select("*")
+        .eq("is_active", true);
+    if (layer) {
+        query = query.eq("layer", layer);
+    }
+    const { data, error } = await query.order("install_order");
+    if (error) {
+        console.warn("⚠️ 패키지 조회 실패, 폴백 데이터 사용");
+        return getFallbackPackages(layer);
+    }
+    return data || [];
+}
+/**
+ * Standard 패키지 목록 조회
+ */
+async function getStandardPackages() {
+    const isConnected = await checkDbConnection();
+    if (!isConnected) {
+        return getFallbackPackages().filter((p) => p.package_type === "standard");
+    }
+    const supabase = getSupabaseClient();
+    const { data, error } = await supabase
+        .from("package_definitions")
+        .select("*")
+        .eq("package_type", "standard")
+        .eq("is_active", true)
+        .order("install_order");
+    if (error) {
+        return getFallbackPackages().filter((p) => p.package_type === "standard");
+    }
+    return data || [];
+}
+/**
+ * Extension 패키지 목록 조회
+ */
+async function getExtensionPackages(layer) {
+    const isConnected = await checkDbConnection();
+    if (!isConnected) {
+        const fallback = getFallbackPackages(layer);
+        return fallback.filter((p) => p.package_type === "extension");
+    }
+    const supabase = getSupabaseClient();
+    let query = supabase
+        .from("package_definitions")
+        .select("*")
+        .eq("package_type", "extension")
+        .eq("is_active", true);
+    if (layer) {
+        query = query.eq("layer", layer);
+    }
+    const { data, error } = await query.order("install_order");
+    if (error) {
+        const fallback = getFallbackPackages(layer);
+        return fallback.filter((p) => p.package_type === "extension");
+    }
+    return data || [];
+}
+/**
+ * 패키지명 또는 별칭으로 패키지 찾기
+ */
+async function resolvePackageName(input) {
+    const isConnected = await checkDbConnection();
+    if (!isConnected) {
+        return resolveFallbackPackageName(input);
+    }
+    const supabase = getSupabaseClient();
+    // 1. 정확한 이름 매칭
+    const { data: exactMatch } = await supabase
+        .from("package_definitions")
+        .select("name")
+        .eq("name", input)
+        .eq("is_active", true)
+        .single();
+    if (exactMatch)
+        return exactMatch.name;
+    // 2. 별칭 매칭 (aliases 배열에 포함)
+    const { data: aliasMatch } = await supabase
+        .from("package_definitions")
+        .select("name")
+        .contains("aliases", [input])
+        .eq("is_active", true)
+        .single();
+    if (aliasMatch)
+        return aliasMatch.name;
+    return null;
+}
+/**
+ * 패키지 버전 조회
+ */
+async function getPackageVersion(name) {
+    const isConnected = await checkDbConnection();
+    if (!isConnected) {
+        const pkg = getFallbackPackages().find((p) => p.name === name);
+        return pkg?.version || null;
+    }
+    const supabase = getSupabaseClient();
+    const { data } = await supabase
+        .from("package_definitions")
+        .select("version")
+        .eq("name", name)
+        .single();
+    return data?.version || null;
+}
+/**
+ * 그룹별 패키지 목록 조회
+ */
+async function getPackagesByGroup(group) {
+    return getExtensionPackages(group);
+}
+/**
+ * 프로젝트 타입 감지용 패키지 조회
+ */
+async function getDetectablePackages() {
+    const packages = await getExtensionPackages();
+    return packages.filter((p) => p.detect_files && p.detect_files.length > 0);
+}
+// ============================================================
+// 폴백 데이터 (DB 연결 실패 시 사용)
+// ============================================================
+const FALLBACK_PACKAGES = [
+    // Standard
+    {
+        id: "std-core",
+        name: "semo-core",
+        display_name: "SEMO Core",
+        description: "원칙, 오케스트레이터, 워크플로우 커맨드",
+        layer: "standard",
+        package_type: "standard",
+        version: "3.12.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/semo-core",
+        detect_files: [],
+        depends_on: [],
+        aliases: [],
+        is_active: true,
+        is_required: true,
+        install_order: 10,
+    },
+    {
+        id: "std-skills",
+        name: "semo-skills",
+        display_name: "SEMO Skills",
+        description: "18개 통합 스킬 (워크플로우 포함)",
+        layer: "standard",
+        package_type: "standard",
+        version: "3.12.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/semo-skills",
+        detect_files: [],
+        depends_on: [],
+        aliases: [],
+        is_active: true,
+        is_required: true,
+        install_order: 20,
+    },
+    {
+        id: "std-scripts",
+        name: "semo-scripts",
+        display_name: "SEMO Scripts",
+        description: "자동화 스크립트",
+        layer: "standard",
+        package_type: "standard",
+        version: "3.12.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/semo-scripts",
+        detect_files: [],
+        depends_on: [],
+        aliases: [],
+        is_active: true,
+        is_required: true,
+        install_order: 30,
+    },
+    // Business Layer
+    {
+        id: "biz-discovery",
+        name: "biz/discovery",
+        display_name: "Discovery",
+        description: "아이템 발굴, 시장 조사, Epic/Task",
+        layer: "biz",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/biz/discovery",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["discovery"],
+        is_active: true,
+        is_required: false,
+        install_order: 100,
+    },
+    {
+        id: "biz-design",
+        name: "biz/design",
+        display_name: "Design",
+        description: "컨셉 설계, 목업, UX",
+        layer: "biz",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/biz/design",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["design"],
+        is_active: true,
+        is_required: false,
+        install_order: 101,
+    },
+    {
+        id: "biz-management",
+        name: "biz/management",
+        display_name: "Management",
+        description: "일정/인력/스프린트 관리",
+        layer: "biz",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/biz/management",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["management"],
+        is_active: true,
+        is_required: false,
+        install_order: 102,
+    },
+    {
+        id: "biz-poc",
+        name: "biz/poc",
+        display_name: "PoC",
+        description: "빠른 PoC, 패스트트랙",
+        layer: "biz",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/biz/poc",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["poc", "mvp"],
+        is_active: true,
+        is_required: false,
+        install_order: 103,
+    },
+    // Engineering Layer
+    {
+        id: "eng-nextjs",
+        name: "eng/nextjs",
+        display_name: "Next.js",
+        description: "Next.js 프론트엔드 개발",
+        layer: "eng",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/eng/nextjs",
+        detect_files: ["next.config.js", "next.config.mjs", "next.config.ts"],
+        depends_on: [],
+        aliases: ["nextjs", "next"],
+        is_active: true,
+        is_required: false,
+        install_order: 110,
+    },
+    {
+        id: "eng-spring",
+        name: "eng/spring",
+        display_name: "Spring",
+        description: "Spring Boot 백엔드 개발",
+        layer: "eng",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/eng/spring",
+        detect_files: ["pom.xml", "build.gradle"],
+        depends_on: [],
+        aliases: ["spring", "backend"],
+        is_active: true,
+        is_required: false,
+        install_order: 111,
+    },
+    {
+        id: "eng-ms",
+        name: "eng/ms",
+        display_name: "Microservice",
+        description: "마이크로서비스 아키텍처",
+        layer: "eng",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/eng/ms",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["ms"],
+        is_active: true,
+        is_required: false,
+        install_order: 112,
+    },
+    {
+        id: "eng-infra",
+        name: "eng/infra",
+        display_name: "Infra",
+        description: "인프라/배포 관리",
+        layer: "eng",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/eng/infra",
+        detect_files: ["docker-compose.yml", "Dockerfile"],
+        depends_on: [],
+        aliases: ["infra"],
+        is_active: true,
+        is_required: false,
+        install_order: 113,
+    },
+    // Operations Layer
+    {
+        id: "ops-qa",
+        name: "ops/qa",
+        display_name: "QA",
+        description: "테스트/품질 관리",
+        layer: "ops",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/ops/qa",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["qa"],
+        is_active: true,
+        is_required: false,
+        install_order: 120,
+    },
+    {
+        id: "ops-monitor",
+        name: "ops/monitor",
+        display_name: "Monitor",
+        description: "서비스 현황 모니터링",
+        layer: "ops",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/ops/monitor",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["monitor"],
+        is_active: true,
+        is_required: false,
+        install_order: 121,
+    },
+    {
+        id: "ops-improve",
+        name: "ops/improve",
+        display_name: "Improve",
+        description: "개선 제안",
+        layer: "ops",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/ops/improve",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["improve"],
+        is_active: true,
+        is_required: false,
+        install_order: 122,
+    },
+    // Meta Layer
+    {
+        id: "meta",
+        name: "meta",
+        display_name: "Meta",
+        description: "SEMO 프레임워크 자체 개발/관리",
+        layer: "meta",
+        package_type: "extension",
+        version: "3.12.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/meta",
+        detect_files: ["semo-core", "semo-skills"],
+        depends_on: [],
+        aliases: [],
+        is_active: true,
+        is_required: false,
+        install_order: 200,
+    },
+    // System Layer
+    {
+        id: "sys-hooks",
+        name: "semo-hooks",
+        display_name: "Hooks",
+        description: "Claude Code Hooks 기반 로깅 시스템",
+        layer: "system",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/semo-hooks",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["hooks"],
+        is_active: true,
+        is_required: false,
+        install_order: 210,
+    },
+    {
+        id: "sys-remote",
+        name: "semo-remote",
+        display_name: "Remote",
+        description: "Claude Code 원격 제어 (모바일 PWA)",
+        layer: "system",
+        package_type: "extension",
+        version: "1.0.0",
+        repo_url: "https://github.com/semicolon-devteam/semo.git",
+        source_path: "semo-system/semo-remote",
+        detect_files: [],
+        depends_on: [],
+        aliases: ["remote"],
+        is_active: true,
+        is_required: false,
+        install_order: 211,
+    },
+];
+function getFallbackPackages(layer) {
+    if (layer) {
+        return FALLBACK_PACKAGES.filter((p) => p.layer === layer);
+    }
+    return FALLBACK_PACKAGES;
+}
+function resolveFallbackPackageName(input) {
+    // 1. 정확한 이름 매칭
+    const exactMatch = FALLBACK_PACKAGES.find((p) => p.name === input);
+    if (exactMatch)
+        return exactMatch.name;
+    // 2. 별칭 매칭
+    const aliasMatch = FALLBACK_PACKAGES.find((p) => p.aliases.includes(input));
+    if (aliasMatch)
+        return aliasMatch.name;
+    return null;
+}
+// ============================================================
+// 유틸리티
+// ============================================================
+/**
+ * 패키지 정보를 CLI 포맷으로 변환
+ */
+function toExtensionPackageFormat(pkg) {
+    return {
+        name: pkg.display_name,
+        desc: pkg.description || "",
+        detect: pkg.detect_files,
+        layer: pkg.layer,
+    };
+}
+/**
+ * 별칭 매핑 객체 생성 (SHORTNAME_MAPPING 대체)
+ */
+async function buildShortnameMappingFromDb() {
+    const packages = await getPackages();
+    const mapping = {};
+    for (const pkg of packages) {
+        for (const alias of pkg.aliases) {
+            mapping[alias] = pkg.name;
+        }
+    }
+    return mapping;
+}
+/**
+ * EXTENSION_PACKAGES 형태의 객체 생성 (호환성용)
+ */
+async function buildExtensionPackagesFromDb() {
+    const packages = await getExtensionPackages();
+    const result = {};
+    for (const pkg of packages) {
+        result[pkg.name] = toExtensionPackageFormat(pkg);
+    }
+    return result;
+}
+// 폴백 스킬 목록 (DB 연결 실패 시 사용)
+const FALLBACK_SKILLS = [
+    // Workflow Management (3개)
+    { id: "sk-1", name: "workflow-start", display_name: "워크플로우 시작", description: "워크플로우 인스턴스 생성 및 시작", category: "workflow", source_path: "semo-skills/workflow-start", is_active: true, is_required: true, install_order: 1, version: "1.0.0" },
+    { id: "sk-2", name: "workflow-progress", display_name: "워크플로우 진행", description: "워크플로우 진행 상황 조회", category: "workflow", source_path: "semo-skills/workflow-progress", is_active: true, is_required: true, install_order: 2, version: "1.0.0" },
+    { id: "sk-3", name: "workflow-resume", display_name: "워크플로우 재개", description: "중단된 워크플로우 재개", category: "workflow", source_path: "semo-skills/workflow-resume", is_active: true, is_required: true, install_order: 3, version: "1.0.0" },
+    // Discovery (1개)
+    { id: "sk-10", name: "ideate", display_name: "아이디에이션", description: "아이디어 발굴 및 분석", category: "discovery", source_path: "semo-skills/ideate", is_active: true, is_required: true, install_order: 10, version: "1.0.0" },
+    // Planning (3개)
+    { id: "sk-20", name: "create-epic", display_name: "Epic 생성", description: "Epic 이슈 생성", category: "planning", source_path: "semo-skills/create-epic", is_active: true, is_required: true, install_order: 20, version: "1.0.0" },
+    { id: "sk-21", name: "design-user-flow", display_name: "사용자 흐름 설계", description: "UX 사용자 흐름 다이어그램 설계", category: "planning", source_path: "semo-skills/design-user-flow", is_active: true, is_required: true, install_order: 21, version: "1.0.0" },
+    { id: "sk-22", name: "generate-mockup", display_name: "목업 생성", description: "UI 목업 생성", category: "planning", source_path: "semo-skills/generate-mockup", is_active: true, is_required: true, install_order: 22, version: "1.0.0" },
+    // Solutioning (4개)
+    { id: "sk-30", name: "scaffold-domain", display_name: "도메인 스캐폴딩", description: "DDD 4-layer 도메인 구조 생성", category: "solutioning", source_path: "semo-skills/scaffold-domain", is_active: true, is_required: true, install_order: 30, version: "1.0.0" },
+    { id: "sk-31", name: "validate-architecture", display_name: "아키텍처 검증", description: "DDD 4-layer 아키텍처 준수 검증", category: "solutioning", source_path: "semo-skills/validate-architecture", is_active: true, is_required: true, install_order: 31, version: "1.0.0" },
+    { id: "sk-32", name: "generate-spec", display_name: "명세 생성", description: "Speckit 워크플로우 통합 실행", category: "solutioning", source_path: "semo-skills/generate-spec", is_active: true, is_required: true, install_order: 32, version: "1.0.0" },
+    { id: "sk-33", name: "design-tests", display_name: "테스트 설계", description: "구현 전 테스트 케이스 설계 (TDD)", category: "solutioning", source_path: "semo-skills/design-tests", is_active: true, is_required: true, install_order: 33, version: "1.0.0" },
+    // Implementation (6개)
+    { id: "sk-40", name: "create-sprint", display_name: "스프린트 생성", description: "Sprint 목표 설정 및 시작", category: "implementation", source_path: "semo-skills/create-sprint", is_active: true, is_required: true, install_order: 40, version: "1.0.0" },
+    { id: "sk-41", name: "start-task", display_name: "태스크 시작", description: "작업 시작 (이슈 상태 변경, 브랜치 생성)", category: "implementation", source_path: "semo-skills/start-task", is_active: true, is_required: true, install_order: 41, version: "1.0.0" },
+    { id: "sk-42", name: "review-task", display_name: "태스크 리뷰", description: "태스크 이슈 기반 구현 완료 리뷰", category: "implementation", source_path: "semo-skills/review-task", is_active: true, is_required: true, install_order: 42, version: "1.0.0" },
+    { id: "sk-43", name: "write-code", display_name: "코드 작성", description: "코드 작성, 수정, 구현", category: "implementation", source_path: "semo-skills/write-code", is_active: true, is_required: true, install_order: 43, version: "1.0.0" },
+    { id: "sk-44", name: "run-code-review", display_name: "코드 리뷰", description: "프로젝트 통합 코드 리뷰", category: "implementation", source_path: "semo-skills/run-code-review", is_active: true, is_required: true, install_order: 44, version: "1.0.0" },
+    { id: "sk-45", name: "close-sprint", display_name: "스프린트 종료", description: "Sprint 종료 및 회고 정리", category: "implementation", source_path: "semo-skills/close-sprint", is_active: true, is_required: true, install_order: 45, version: "1.0.0" },
+    // Supporting (2개)
+    { id: "sk-50", name: "git-workflow", display_name: "Git 워크플로우", description: "Git 커밋/푸시/PR 자동화", category: "supporting", source_path: "semo-skills/git-workflow", is_active: true, is_required: true, install_order: 50, version: "1.0.0" },
+    { id: "sk-51", name: "notify-slack", display_name: "Slack 알림", description: "Slack 채널에 메시지 전송", category: "supporting", source_path: "semo-skills/notify-slack", is_active: true, is_required: true, install_order: 51, version: "1.0.0" },
+];
+/**
+ * 활성 스킬 목록 조회 (설치할 스킬)
+ */
+async function getActiveSkills() {
+    const isConnected = await checkDbConnection();
+    if (!isConnected) {
+        console.warn("⚠️ DB 연결 실패, 폴백 스킬 목록 사용 (19개)");
+        return FALLBACK_SKILLS.filter(s => s.is_active);
+    }
+    const supabase = getSupabaseClient();
+    const { data, error } = await supabase
+        .from("skill_definitions")
+        .select("*")
+        .eq("is_active", true)
+        .order("install_order");
+    if (error) {
+        console.warn("⚠️ 스킬 조회 실패, 폴백 데이터 사용");
+        return FALLBACK_SKILLS.filter(s => s.is_active);
+    }
+    return data || FALLBACK_SKILLS.filter(s => s.is_active);
+}
+/**
+ * 스킬 이름 목록만 조회
+ */
+async function getActiveSkillNames() {
+    const skills = await getActiveSkills();
+    return skills.map(s => s.name);
+}
+/**
+ * 카테고리별 스킬 개수 조회
+ */
+async function getSkillCountByCategory() {
+    const skills = await getActiveSkills();
+    const counts = {};
+    for (const skill of skills) {
+        counts[skill.category] = (counts[skill.category] || 0) + 1;
+    }
+    return counts;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@team-semicolon/semo-cli",
-  "version": "3.10.0",
+  "version": "3.13.0",
   "description": "SEMO CLI - AI Agent Orchestration Framework Installer",
   "main": "dist/index.js",
   "bin": {
@@ -27,6 +27,7 @@
     "directory": "packages/cli"
   },
   "dependencies": {
+    "@supabase/supabase-js": "^2.49.1",
     "chalk": "^4.1.2",
     "commander": "^12.0.0",
     "ora": "^5.4.1",