@team-semicolon/semo-cli 3.9.0 → 3.12.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);
@@ -1159,55 +1205,27 @@ program
         spinner.fail("Git 레포지토리가 아닙니다. 'git init'을 먼저 실행하세요.");
         process.exit(1);
     }
-    // 2. 프로젝트 유형 감지
-    const detected = detectProjectType(cwd);
+    // 2. Extension 패키지 처리 (--with 옵션만 지원, 인터랙션 없음)
     let extensionsToInstall = [];
+    const extPkgs = getExtensionPackagesSync();
+    const shortnames = getShortnameMappingSync();
     if (options.with) {
-        extensionsToInstall = options.with.split(",").map((p) => p.trim()).filter((p) => p in EXTENSION_PACKAGES);
+        // --with 옵션으로 명시적 패키지 지정 시에만 Extension 설치
+        extensionsToInstall = options.with.split(",").map((p) => p.trim()).filter((p) => p in extPkgs || p in shortnames);
+        // 별칭 처리
+        extensionsToInstall = extensionsToInstall.map((p) => shortnames[p] || p);
     }
-    else if (detected.length > 0) {
-        console.log(chalk_1.default.cyan("\n📦 감지된 프로젝트 유형:"));
+    // 프로젝트 유형 감지는 정보 제공용으로만 사용 (자동 설치 안 함)
+    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}`));
+            }
         });
-        const { installDetected } = await inquirer_1.default.prompt([
-            {
-                type: "confirm",
-                name: "installDetected",
-                message: "감지된 패키지를 함께 설치할까요?",
-                default: true,
-            },
-        ]);
-        if (installDetected) {
-            extensionsToInstall = detected;
-        }
-    }
-    else {
-        // 프로젝트 유형이 감지되지 않은 경우 패키지 선택 프롬프트
-        console.log(chalk_1.default.cyan("\n📦 추가 패키지 선택"));
-        console.log(chalk_1.default.gray("   기본 설치 (semo-core + semo-skills) 외에 추가할 패키지를 선택하세요.\n"));
-        // 그룹별로 패키지 구성
-        const packageChoices = [
-            new inquirer_1.default.Separator(chalk_1.default.yellow("── Engineering ──")),
-            { name: `eng/nextjs - ${EXTENSION_PACKAGES["eng/nextjs"].desc}`, value: "eng/nextjs" },
-            { name: `eng/spring - ${EXTENSION_PACKAGES["eng/spring"].desc}`, value: "eng/spring" },
-            { name: `eng/infra - ${EXTENSION_PACKAGES["eng/infra"].desc}`, value: "eng/infra" },
-            new inquirer_1.default.Separator(chalk_1.default.yellow("── Business ──")),
-            { name: `biz/discovery - ${EXTENSION_PACKAGES["biz/discovery"].desc}`, value: "biz/discovery" },
-            { name: `biz/management - ${EXTENSION_PACKAGES["biz/management"].desc}`, value: "biz/management" },
-            { name: `biz/design - ${EXTENSION_PACKAGES["biz/design"].desc}`, value: "biz/design" },
-            new inquirer_1.default.Separator(chalk_1.default.yellow("── Operations ──")),
-            { name: `ops/qa - ${EXTENSION_PACKAGES["ops/qa"].desc}`, value: "ops/qa" },
-        ];
-        const { selectedPackages } = await inquirer_1.default.prompt([
-            {
-                type: "checkbox",
-                name: "selectedPackages",
-                message: "설치할 패키지 선택 (Space로 선택, Enter로 완료):",
-                choices: packageChoices,
-            },
-        ]);
-        extensionsToInstall = selectedPackages;
+        console.log(chalk_1.default.gray(`\n   추가 패키지가 필요하면: semo add ${detected[0].split("/")[1] || detected[0]}`));
     }
     // 3. .claude 디렉토리 생성
     const claudeDir = path.join(cwd, ".claude");
@@ -1265,8 +1283,8 @@ program
     console.log(chalk_1.default.gray("  1. Claude Code에서 프로젝트 열기"));
     console.log(chalk_1.default.gray("  2. 자연어로 요청하기 (예: \"댓글 기능 구현해줘\")"));
     console.log(chalk_1.default.gray("  3. /SEMO:help로 도움말 확인"));
-    if (extensionsToInstall.length === 0 && detected.length === 0) {
-        console.log(chalk_1.default.gray("\n💡 추가 패키지: semo add <package> (예: semo add next)"));
+    if (extensionsToInstall.length === 0) {
+        console.log(chalk_1.default.gray("\n💡 추가 패키지가 필요하면: semo add <package> (예: semo add next)"));
     }
     console.log();
 });
@@ -2777,6 +2795,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)) {
@@ -2785,11 +2805,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);
     }
     // 그룹 설치인 경우 안내
@@ -2797,21 +2819,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();
     }
@@ -2850,12 +2875,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();
     }
@@ -2864,10 +2891,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"));
@@ -2884,7 +2914,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}`));
@@ -2981,6 +3011,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");
@@ -3033,7 +3065,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,73 @@
+/**
+ * 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;
+}>>;

package/dist/supabase.js

@@ -0,0 +1,532 @@
+"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;
+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;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@team-semicolon/semo-cli",
-  "version": "3.9.0",
+  "version": "3.12.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",