gencow 0.1.73 → 0.1.75

package/bin/gencow.mjs

@@ -426,7 +426,8 @@ function generateReadmeMd(config, apiObj) {
 
     let md = `# Gencow API Guide\n`;
     md += `> ⚡ Auto-generated by Gencow CLI — do not edit manually.\n`;
-    md += `> Last updated: ${now}\n\n`;
+    md += `> Last updated: ${now}\n`;
+    md += `> 📚 Gencow 공식 문서 (전체 참조): https://docs.gencow.com/llms-full.txt\n\n`;
     md += `---\n\n`;
 
     // ── 1. API Reference Table ─────────────────────────────
@@ -594,8 +595,9 @@ function generateReadmeMd(config, apiObj) {
     md += `- 백엔드: \`npx gencow deploy\` (gencow/ 폴더만 배포됨. 프론트엔드는 포함 안 됨)\n`;
     md += `- 프론트엔드: VITE_API_URL=https://{앱ID}.gencow.app npm run build 후 \`npx gencow deploy --static dist/\`\n`;
     md += `- gencow deploy는 프론트엔드를 포함하지 않아. 반드시 별도로 --static 배포해.\n`;
-    md += `- 환경변수는 \`npx gencow env set KEY=VALUE\`로 관리해.\n`;
-    md += `- .env 파일은 로컬 개발 전용이야. 서버에는 gencow env push로 올려.\n`;
+    md += `- 환경변수는 \`npx gencow env set KEY=VALUE\`로 클라우드에 설정해.\n`;
+    md += `- .env 파일은 로컬 개발 전용이야. 클라우드에는 gencow env push로 올려.\n`;
+    md += `- 로컬 dev 서버에 설정하려면 \`gencow env set --local KEY=VALUE\`를 써.\n`;
     md += `\`\`\`\n\n`;
 
     // ── 4. AI 사용법 ────────────────────────────────────
@@ -646,10 +648,11 @@ function generateReadmeMd(config, apiObj) {
     md += `### 환경변수 관리\n\n`;
     md += `| 명령어 | 설명 |\n`;
     md += `| :--- | :--- |\n`;
-    md += `| \`gencow env list\` | 현재 환경변수 목록 |\n`;
-    md += `| \`gencow env set KEY=VALUE\` | 환경변수 추가/수정 |\n`;
-    md += `| \`gencow env unset KEY\` | 환경변수 삭제 |\n`;
-    md += `| \`gencow env push\` | 로컬 .env를 서버에 일괄 업로드 |\n\n`;
+    md += `| \`gencow env list\` | 클라우드 환경변수 목록 |\n`;
+    md += `| \`gencow env set KEY=VALUE\` | 클라우드 환경변수 추가/수정 |\n`;
+    md += `| \`gencow env unset KEY\` | 클라우드 환경변수 삭제 |\n`;
+    md += `| \`gencow env push\` | .env를 클라우드에 일괄 업로드 |\n`;
+    md += `| \`--local\` 옵션 | 로컬 dev 서버 대상 (예: \`env set --local K=V\`) |\n\n`;
 
     // ── 6. Cron Jobs ──────────────────────────────────────
     md += `---\n\n## ⏰ Cron Jobs (예약 작업)\n\n`;
@@ -708,7 +711,7 @@ function generateReadmeMd(config, apiObj) {
     md += `- MCP 서버를 사용하면 AI가 이 구조를 자동으로 인식합니다.\n`;
     md += `- 로컬 개발: \`gencow dev\` → \`http://localhost:5456\`\n`;
     md += `- Self-fetch: \`process.env.GENCOW_INTERNAL_URL\` — cron/mutation에서 다른 함수 호출 시 사용\n`;
-    md += `- .env 파일은 로컬 전용. 서버에는 \`gencow env push\`로 올리세요.\n`;
+    md += `- .env 파일은 로컬 전용. 클라우드에는 \`gencow env push\`로 올리세요. (로컬 서버는 \`--local\`)\n`;
 
     // ── 5. 기존 컴포넌트 섹션 보존 (gencow add로 추가된 부분) ──
     const COMP_START = "<!-- gencow-components-start -->";
@@ -1769,10 +1772,10 @@ ${BOLD}BaaS commands (login required):${RESET}
                      ${DIM}--prod    Deploy to production (confirmation required)${RESET}
                      ${DIM}--name, -n  Specify app name${RESET}
                      ${DIM}--static [dir]  Deploy static files (dist/, out/, build/)${RESET}
-  ${GREEN}env list${RESET}         List remote env vars ${DIM}(--prod for production)${RESET}
-  ${GREEN}env set K=V${RESET}      Set remote env var
-  ${GREEN}env unset KEY${RESET}    Remove remote env var
-  ${GREEN}env push${RESET}         Push local .env to remote
+  ${GREEN}env list${RESET}         List cloud env vars ${DIM}(--local for local dev server)${RESET}
+  ${GREEN}env set K=V${RESET}      Set cloud env var ${DIM}(--local for local)${RESET}
+  ${GREEN}env unset KEY${RESET}    Remove cloud env var ${DIM}(--local for local)${RESET}
+  ${GREEN}env push${RESET}         Push .env to cloud ${DIM}(--local for local)${RESET}
   ${GREEN}domain set${RESET}       Connect custom domain ${DIM}(myapp.com)${RESET}
   ${GREEN}domain status${RESET}    Check domain DNS/TLS status
   ${GREEN}domain remove${RESET}    Disconnect custom domain
@@ -1946,10 +1949,12 @@ ${BOLD}Examples:${RESET}
             let envTarget = "dev";
             let staticDir = null; // --static 옵션
             let isStatic = false;
+            let forceDeploy = false; // --force: skip dependency audit
 
             for (let i = 0; i < deployArgs.length; i++) {
                 const a = deployArgs[i];
                 if (a === "--prod") envTarget = "prod";
+                else if (a === "--force" || a === "-f") forceDeploy = true;
                 else if (a === "--app" || a === "-a") appId = deployArgs[++i];
                 else if (a === "--static") {
                     isStatic = true;
@@ -2025,6 +2030,23 @@ ${BOLD}Examples:${RESET}
                 process.exit(1);
             }
 
+            // 1-0. Pre-deploy dependency audit
+            if (!forceDeploy) {
+                try {
+                    const { auditDeployDependencies, formatAuditError } = await import("../lib/deploy-auditor.mjs");
+                    const entryPoint = resolve(process.cwd(), "gencow", "index.ts");
+                    if (existsSync(entryPoint)) {
+                        const auditResult = await auditDeployDependencies(entryPoint);
+                        if (!auditResult.passed) {
+                            log(formatAuditError(auditResult));
+                            process.exit(1);
+                        }
+                    }
+                } catch (auditErr) {
+                    warn(`의존성 검사 스킵: ${auditErr.message}`);
+                }
+            }
+
             try {
                 exec(`tar -czf "${tmpBundle}" ${filesToPack.join(" ")}`, { cwd: process.cwd() });
             } catch (e) {
@@ -2127,6 +2149,11 @@ ${BOLD}Examples:${RESET}
                     if (!retryRes.ok) {
                         const retryErr = await retryRes.json().catch(() => ({}));
                         error(`배포 실패: ${retryErr.error || retryRes.statusText}`);
+                        if (retryErr.crashLogs?.length) {
+                            log("");
+                            warn("서버 시작 실패 원인:");
+                            for (const line of retryErr.crashLogs) log(`  ${DIM}${line}${RESET}`);
+                        }
                         process.exit(1);
                     }
 
@@ -2142,6 +2169,11 @@ ${BOLD}Examples:${RESET}
                 }
 
                 error(`배포 실패: ${errData.error || deployRes.statusText}`);
+                if (errData.crashLogs?.length) {
+                    log("");
+                    warn("서버 시작 실패 원인:");
+                    for (const line of errData.crashLogs) log(`  ${DIM}${line}${RESET}`);
+                }
                 process.exit(1);
             }
 
@@ -3235,108 +3267,268 @@ process.exit(0);
             });
         },
 
-    // ── env — 환경변수 관리 ────────────────────────────────
+    // ── env — 환경변수 관리 (Cloud-First + --local) ─────────
     async env(...envArgs) {
-            const subcmd = envArgs[0] || "list";
-            const config = loadConfig();
-            const port = process.env.PORT || config.port || 5456;
-            const base = `http://localhost:${port}/_admin/settings/env-vars`;
+            // ── --local 플래그 파싱 ──
+            const isLocal = envArgs.includes("--local");
+            const filteredArgs = envArgs.filter(a => a !== "--local");
+            const subcmd = filteredArgs[0] || "list";
+
+            // ── 로컬 모드: 기존 localhost 로직 ──
+            if (isLocal) {
+                const config = loadConfig();
+                const port = process.env.PORT || config.port || 5456;
+                const base = `http://localhost:${port}/_admin/settings/env-vars`;
+
+                // ── local env list ──
+                if (subcmd === "list") {
+                    try {
+                        const res = await fetch(base);
+                        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+                        const vars = await res.json();
+
+                        log(`\n${BOLD}Environment Variables${RESET}  ${DIM}(local, ${vars.length} total)${RESET}\n`);
+
+                        if (vars.length === 0) {
+                            info("No environment variables configured.");
+                            info(`Use ${GREEN}gencow env set --local KEY=VALUE${RESET} to add one.`);
+                        } else {
+                            const maxLen = Math.max(...vars.map(v => v.name.length), 4);
+                            log(`  ${DIM}${"NAME".padEnd(maxLen)}  VALUE${RESET}`);
+                            log(`  ${DIM}${"─".repeat(maxLen)}  ${"─".repeat(20)}${RESET}`);
+                            for (const v of vars) {
+                                log(`  ${BOLD}${v.name.padEnd(maxLen)}${RESET}  ${DIM}${v.maskedValue}${RESET}`);
+                            }
+                        }
+                        log("");
+                    } catch (e) {
+                        error(`Failed to fetch env vars: ${e.message}`);
+                        info(`Make sure the local dev server is running (gencow dev --local)`);
+                    }
+                    return;
+                }
+
+                // ── local env set KEY=VALUE ──
+                if (subcmd === "set") {
+                    const pairs = filteredArgs.slice(1);
+                    if (pairs.length === 0) {
+                        error("Usage: gencow env set --local KEY=VALUE [KEY2=VALUE2 ...]");
+                        return;
+                    }
+                    for (const pair of pairs) {
+                        const eqIdx = pair.indexOf("=");
+                        if (eqIdx < 1) { error(`Invalid format: ${pair}. Use KEY=VALUE`); continue; }
+                        const name = pair.slice(0, eqIdx).trim();
+                        const value = pair.slice(eqIdx + 1).trim();
+                        if (!name) { error("Key name cannot be empty"); continue; }
+                        if (!value) { error(`Value for ${name} cannot be empty`); continue; }
+
+                        try {
+                            const res = await fetch(base, {
+                                method: "POST",
+                                headers: { "Content-Type": "application/json" },
+                                body: JSON.stringify({ name, value }),
+                            });
+                            if (!res.ok) {
+                                const body = await res.json().catch(() => ({}));
+                                throw new Error(body.error || `HTTP ${res.status}`);
+                            }
+                            success(`Set ${BOLD}${name}${RESET} ${DIM}(local)${RESET}`);
+                        } catch (e) {
+                            error(`Failed to set ${name}: ${e.message}`);
+                        }
+                    }
+                    log(`\n  ${DIM}⚠ Restart local server to apply changes${RESET}\n`);
+                    return;
+                }
+
+                // ── local env unset KEY ──
+                if (subcmd === "unset" || subcmd === "remove" || subcmd === "delete") {
+                    const keys = filteredArgs.slice(1);
+                    if (keys.length === 0) { error("Usage: gencow env unset --local KEY [KEY2 ...]"); return; }
+                    for (const key of keys) {
+                        try {
+                            const res = await fetch(`${base}/${encodeURIComponent(key)}`, { method: "DELETE" });
+                            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+                            success(`Removed ${BOLD}${key}${RESET} ${DIM}(local)${RESET}`);
+                        } catch (e) {
+                            error(`Failed to remove ${key}: ${e.message}`);
+                        }
+                    }
+                    log(`\n  ${DIM}⚠ Restart local server to apply changes${RESET}\n`);
+                    return;
+                }
+
+                // ── local env push ──
+                if (subcmd === "push") {
+                    const envPath = resolve(process.cwd(), ".env");
+                    if (!existsSync(envPath)) { error("No .env file found in current directory"); return; }
+
+                    const content = readFileSync(envPath, "utf-8");
+                    const pairs = [];
+                    for (const line of content.split("\n")) {
+                        const trimmed = line.trim();
+                        if (!trimmed || trimmed.startsWith("#")) continue;
+                        const eqIdx = trimmed.indexOf("=");
+                        if (eqIdx < 1) continue;
+                        const key = trimmed.slice(0, eqIdx).trim();
+                        let val = trimmed.slice(eqIdx + 1).trim();
+                        if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
+                            val = val.slice(1, -1);
+                        }
+                        if (key && val) pairs.push({ key, val });
+                    }
+
+                    if (pairs.length === 0) { warn("No valid KEY=VALUE pairs found in .env"); return; }
+
+                    log(`\n${BOLD}Pushing .env${RESET}  ${DIM}(local, ${pairs.length} variables)${RESET}\n`);
+
+                    let ok = 0, fail = 0;
+                    for (const { key, val } of pairs) {
+                        try {
+                            const res = await fetch(base, {
+                                method: "POST",
+                                headers: { "Content-Type": "application/json" },
+                                body: JSON.stringify({ name: key, value: val }),
+                            });
+                            if (!res.ok) throw new Error(`HTTP ${res.status}`);
+                            success(`${key}`);
+                            ok++;
+                        } catch {
+                            error(`${key}`);
+                            fail++;
+                        }
+                    }
+
+                    log(`\n  ${GREEN}${ok} set${RESET}${fail > 0 ? `, ${RED}${fail} failed${RESET}` : ""}`);
+                    log(`  ${DIM}⚠ Restart local server to apply changes${RESET}\n`);
+                    return;
+                }
+
+                error(`Unknown env subcommand: ${subcmd}`);
+                log(`\n  ${BOLD}Usage (local):${RESET}`);
+                log(`    gencow env list --local       List local env vars`);
+                log(`    gencow env set --local K=V    Set local variable(s)`);
+                log(`    gencow env unset --local KEY  Remove local variable(s)`);
+                log(`    gencow env push --local       Push .env to local server\n`);
+                return;
+            }
 
-            // ── env list ──
+            // ── 클라우드 모드 (기본) ──
+            // gencow.json에서 appId 읽기
+            const gencowJsonPath = resolve(process.cwd(), "gencow.json");
+            let appId = null;
+            if (existsSync(gencowJsonPath)) {
+                try {
+                    const gencowJson = JSON.parse(readFileSync(gencowJsonPath, "utf8"));
+                    appId = gencowJson.appId || gencowJson.appName;
+                } catch { /* ignore parse error */ }
+            }
+
+            if (!appId) {
+                error("No gencow.json found. Cannot determine cloud app.");
+                info(`Run ${GREEN}gencow deploy${RESET} first to create a cloud app.`);
+                info(`Or use ${GREEN}gencow env set --local KEY=VALUE${RESET} for local dev server.`);
+                return;
+            }
+
+            const creds = requireCreds();
+
+            // ── cloud env list ──
             if (subcmd === "list") {
                 try {
-                    const res = await fetch(base);
-                    if (!res.ok) throw new Error(`HTTP ${res.status}`);
+                    const res = await platformFetch(creds, `/platform/apps/${appId}/env`, {
+                        method: "GET",
+                    });
+                    if (!res.ok) {
+                        const body = await res.json().catch(() => ({}));
+                        throw new Error(body.error || `HTTP ${res.status}`);
+                    }
                     const vars = await res.json();
 
-                    log(`\n${BOLD}Environment Variables${RESET}  ${DIM}(${vars.length} total)${RESET}\n`);
+                    log(`\n${BOLD}Environment Variables${RESET}  ${DIM}(cloud: ${appId}, ${vars.length} total)${RESET}\n`);
 
                     if (vars.length === 0) {
                         info("No environment variables configured.");
                         info(`Use ${GREEN}gencow env set KEY=VALUE${RESET} to add one.`);
                     } else {
-                        const maxLen = Math.max(...vars.map(v => v.name.length), 4);
-                        log(`  ${DIM}${"NAME".padEnd(maxLen)}  VALUE${RESET}`);
-                        log(`  ${DIM}${"─".repeat(maxLen)}  ${"─".repeat(20)}${RESET}`);
+                        const maxLen = Math.max(...vars.map(v => v.key.length), 4);
+                        log(`  ${DIM}${"NAME".padEnd(maxLen)}  ENV${RESET}`);
+                        log(`  ${DIM}${"─".repeat(maxLen)}  ${"─".repeat(6)}${RESET}`);
                         for (const v of vars) {
-                            log(`  ${BOLD}${v.name.padEnd(maxLen)}${RESET}  ${DIM}${v.maskedValue}${RESET}`);
+                            log(`  ${BOLD}${v.key.padEnd(maxLen)}${RESET}  ${DIM}${v.env}${RESET}`);
                         }
                     }
                     log("");
                 } catch (e) {
                     error(`Failed to fetch env vars: ${e.message}`);
-                    info(`Make sure the server is running (gencow dev)`);
                 }
                 return;
             }
 
-            // ── env set KEY=VALUE ──
+            // ── cloud env set KEY=VALUE ──
             if (subcmd === "set") {
-                const pairs = envArgs.slice(1);
+                const pairs = filteredArgs.slice(1);
                 if (pairs.length === 0) {
                     error("Usage: gencow env set KEY=VALUE [KEY2=VALUE2 ...]");
                     return;
                 }
                 for (const pair of pairs) {
                     const eqIdx = pair.indexOf("=");
-                    if (eqIdx < 1) {
-                        error(`Invalid format: ${pair}. Use KEY=VALUE`);
-                        continue;
-                    }
+                    if (eqIdx < 1) { error(`Invalid format: ${pair}. Use KEY=VALUE`); continue; }
                     const name = pair.slice(0, eqIdx).trim();
                     const value = pair.slice(eqIdx + 1).trim();
                     if (!name) { error("Key name cannot be empty"); continue; }
                     if (!value) { error(`Value for ${name} cannot be empty`); continue; }
 
                     try {
-                        const res = await fetch(base, {
+                        const res = await platformFetch(creds, `/platform/apps/${appId}/env`, {
                             method: "POST",
                             headers: { "Content-Type": "application/json" },
-                            body: JSON.stringify({ name, value }),
+                            body: JSON.stringify({ key: name, value }),
                         });
                         if (!res.ok) {
                             const body = await res.json().catch(() => ({}));
                             throw new Error(body.error || `HTTP ${res.status}`);
                         }
-                        success(`Set ${BOLD}${name}${RESET}`);
+                        success(`Set ${BOLD}${name}${RESET} ${DIM}(cloud: ${appId})${RESET}`);
                     } catch (e) {
                         error(`Failed to set ${name}: ${e.message}`);
                     }
                 }
-                log(`\n  ${DIM}⚠ Restart server to apply changes${RESET}\n`);
+                log(`\n  ${DIM}⚠ Restart app to apply changes${RESET}\n`);
                 return;
             }
 
-            // ── env unset KEY ──
+            // ── cloud env unset KEY ──
             if (subcmd === "unset" || subcmd === "remove" || subcmd === "delete") {
-                const keys = envArgs.slice(1);
-                if (keys.length === 0) {
-                    error("Usage: gencow env unset KEY [KEY2 ...]");
-                    return;
-                }
+                const keys = filteredArgs.slice(1);
+                if (keys.length === 0) { error("Usage: gencow env unset KEY [KEY2 ...]"); return; }
                 for (const key of keys) {
                     try {
-                        const res = await fetch(`${base}/${encodeURIComponent(key)}`, { method: "DELETE" });
-                        if (!res.ok) throw new Error(`HTTP ${res.status}`);
-                        success(`Removed ${BOLD}${key}${RESET}`);
+                        const res = await platformFetch(creds, `/platform/apps/${appId}/env/${encodeURIComponent(key)}`, {
+                            method: "DELETE",
+                        });
+                        if (!res.ok) {
+                            const body = await res.json().catch(() => ({}));
+                            throw new Error(body.error || `HTTP ${res.status}`);
+                        }
+                        success(`Removed ${BOLD}${key}${RESET} ${DIM}(cloud: ${appId})${RESET}`);
                     } catch (e) {
                         error(`Failed to remove ${key}: ${e.message}`);
                     }
                 }
-                log(`\n  ${DIM}⚠ Restart server to apply changes${RESET}\n`);
+                log(`\n  ${DIM}⚠ Restart app to apply changes${RESET}\n`);
                 return;
             }
 
-            // ── env push — .env to server ──
+            // ── cloud env push — .env to cloud ──
             if (subcmd === "push") {
                 const envPath = resolve(process.cwd(), ".env");
-                if (!existsSync(envPath)) {
-                    error("No .env file found in current directory");
-                    return;
-                }
+                if (!existsSync(envPath)) { error("No .env file found in current directory"); return; }
 
                 const content = readFileSync(envPath, "utf-8");
-                const pairs = [];
+                const vars = {};
                 for (const line of content.split("\n")) {
                     const trimmed = line.trim();
                     if (!trimmed || trimmed.startsWith("#")) continue;
@@ -3344,50 +3536,48 @@ process.exit(0);
                     if (eqIdx < 1) continue;
                     const key = trimmed.slice(0, eqIdx).trim();
                     let val = trimmed.slice(eqIdx + 1).trim();
-                    // Remove surrounding quotes
                     if ((val.startsWith('"') && val.endsWith('"')) || (val.startsWith("'") && val.endsWith("'"))) {
                         val = val.slice(1, -1);
                     }
-                    if (key && val) pairs.push({ key, val });
+                    if (key && val) vars[key] = val;
                 }
 
-                if (pairs.length === 0) {
-                    warn("No valid KEY=VALUE pairs found in .env");
-                    return;
-                }
+                const count = Object.keys(vars).length;
+                if (count === 0) { warn("No valid KEY=VALUE pairs found in .env"); return; }
 
-                log(`\n${BOLD}Pushing .env${RESET}  ${DIM}(${pairs.length} variables)${RESET}\n`);
+                log(`\n${BOLD}Pushing .env${RESET}  ${DIM}(cloud: ${appId}, ${count} variables)${RESET}\n`);
 
-                let ok = 0;
-                let fail = 0;
-                for (const { key, val } of pairs) {
-                    try {
-                        const res = await fetch(base, {
-                            method: "POST",
-                            headers: { "Content-Type": "application/json" },
-                            body: JSON.stringify({ name: key, value: val }),
-                        });
-                        if (!res.ok) throw new Error(`HTTP ${res.status}`);
+                try {
+                    const res = await platformFetch(creds, `/platform/apps/${appId}/env/bulk`, {
+                        method: "PUT",
+                        headers: { "Content-Type": "application/json" },
+                        body: JSON.stringify({ vars }),
+                    });
+                    if (!res.ok) {
+                        const body = await res.json().catch(() => ({}));
+                        throw new Error(body.error || `HTTP ${res.status}`);
+                    }
+                    const data = await res.json();
+                    for (const key of Object.keys(vars)) {
                         success(`${key}`);
-                        ok++;
-                    } catch {
-                        error(`${key}`);
-                        fail++;
                     }
+                    log(`\n  ${GREEN}${data.count || count} set${RESET} ${DIM}(cloud: ${appId})${RESET}`);
+                } catch (e) {
+                    error(`Failed to push env vars: ${e.message}`);
                 }
 
-                log(`\n  ${GREEN}${ok} set${RESET}${fail > 0 ? `, ${RED}${fail} failed${RESET}` : ""}`);
-                log(`  ${DIM}⚠ Restart server to apply changes${RESET}\n`);
+                log(`  ${DIM}⚠ Restart app to apply changes${RESET}\n`);
                 return;
             }
 
             // Unknown subcmd
             error(`Unknown env subcommand: ${subcmd}`);
             log(`\n  ${BOLD}Usage:${RESET}`);
-            log(`    gencow env list        List environment variables`);
-            log(`    gencow env set K=V     Set variable(s)`);
-            log(`    gencow env unset KEY   Remove variable(s)`);
-            log(`    gencow env push        Push local .env to server\n`);
+            log(`    gencow env list              List cloud env vars`);
+            log(`    gencow env set K=V           Set cloud variable(s)`);
+            log(`    gencow env unset KEY         Remove cloud variable(s)`);
+            log(`    gencow env push              Push .env to cloud`);
+            log(`    ${DIM}Add --local for local dev server${RESET}\n`);
         },
 
     async platform() {