gencow 0.1.126 → 0.1.128

package/bin/gencow.mjs

@@ -425,6 +425,40 @@ function spawnInServer(cmd, args, env = process.env) {
     return spawn(cmd, args, { cwd: serverRoot, stdio: "inherit", shell: true, env });
 }
 
+// ─── Core Import Resolution ───────────────────────────────
+
+/**
+ * @gencow/core import 경로 해석 — 3단계 fallback
+ *
+ * 1. CLI 패키지 내 번들된 core (../core/index.js relative to server/)
+ * 2. 사용자 프로젝트 node_modules/@gencow/core/dist/index.js (절대 경로)
+ * 3. bare specifier "@gencow/core" (모노레포 등 이미 resolve 가능한 경우)
+ *
+ * Bun ESM은 NODE_PATH를 무시하므로, bare specifier fallback은
+ * .gencow-extract.ts 파일 위치(CLI server 디렉토리) 기준으로만 해석됨.
+ * 따라서 2단계에서 프로젝트 node_modules의 절대 경로를 명시적으로 시도하여
+ * 글로벌/npx 설치 환경에서도 안정적으로 resolve.
+ *
+ * @param {string} serverRoot - findServerRoot()가 반환한 서버 루트 경로
+ * @returns {string} import 경로 (절대 경로 또는 bare specifier)
+ */
+function resolveCoreImport(serverRoot) {
+    // 1차: CLI 패키지 내 번들된 core
+    const bundledCorePath = resolve(serverRoot, "../core/index.js");
+    if (existsSync(bundledCorePath)) return bundledCorePath.replace(/\\/g, "/");
+
+    // 2차: 사용자 프로젝트 node_modules (절대 경로 — Bun ESM에서 확실히 resolve)
+    const cwdCoreDist = resolve(process.cwd(), "node_modules/@gencow/core/dist/index.js");
+    if (existsSync(cwdCoreDist)) return cwdCoreDist.replace(/\\/g, "/");
+
+    // 2차-b: src/ 직접 참조 (모노레포 workspace 등에서 dist 미빌드 시)
+    const cwdCoreSrc = resolve(process.cwd(), "node_modules/@gencow/core/src/index.ts");
+    if (existsSync(cwdCoreSrc)) return cwdCoreSrc.replace(/\\/g, "/");
+
+    // 3차: bare specifier — 모노레포 또는 이미 resolve 가능한 환경
+    return "@gencow/core";
+}
+
 // ─── API Codegen ──────────────────────────────────────────
 
 function generateApiTs(config) {
@@ -433,11 +467,8 @@ function generateApiTs(config) {
     const apiTsPath = resolve(absoluteFunctions, "api.ts");
     const extractTsPath = resolve(serverRoot, ".gencow-extract.ts");
 
-    // Resolve @gencow/core — bundled core is at ../core/ relative to server/
-    const bundledCorePath = resolve(serverRoot, "../core/index.js");
-    const coreImport = existsSync(bundledCorePath)
-        ? bundledCorePath.replace(/\\/g, "/")  // Windows 호환
-        : "@gencow/core";                       // 모노레포 등 이미 resolve 가능한 경우
+    // Resolve @gencow/core — 3단계 fallback (bundled → CWD node_modules → bare specifier)
+    const coreImport = resolveCoreImport(serverRoot);
 
     const script = `
 import { getRegisteredQueries, getRegisteredMutations } from "${coreImport}";
@@ -696,6 +727,21 @@ const commands = {
 
     // ── init ─────────────────────────────────────────────
     async init(...initArgs) {
+        // --help handler
+        if (initArgs.includes("--help") || initArgs.includes("-h")) {
+            log(`\n${BOLD}${CYAN}gencow init${RESET} — Create a new Gencow project\n`);
+            log(`  ${BOLD}Usage:${RESET}  gencow init [name] [options]\n`);
+            log(`  ${BOLD}Arguments:${RESET}`);
+            log(`    ${CYAN}name${RESET}               Project name (creates directory) or "." for current dir\n`);
+            log(`  ${BOLD}Options:${RESET}`);
+            log(`    ${DIM}--template, -t${RESET}     Select template (default, task-app, fullstack, ai-chat)`);
+            log(`    ${DIM}--force, -f${RESET}        Initialize in non-empty directory\n`);
+            log(`  ${BOLD}Examples:${RESET}`);
+            log(`    gencow init my-app`);
+            log(`    gencow init . --force`);
+            log(`    gencow init my-app --template fullstack\n`);
+            return;
+        }
         // Parse --template / -t flag, --force / -f flag, and project name from args
         let name = null;
         let templateId = null;
@@ -1135,6 +1181,16 @@ ${hasPrompt ? `
     // seed.ts 실행 (TRUNCATE 없이). 서버가 실행 중이어야 함.
     // Cloud-first: 기본=Cloud, --local=로컬
     async "db:seed"(...args) {
+            // --help handler
+            if (args.includes("--help") || args.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow db:seed${RESET} — Run seed.ts on cloud app\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow db:seed [options]\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--prod${RESET}       Seed production app`);
+                log(`    ${DIM}--local${RESET}      Seed local dev server`);
+                log(`    ${DIM}--app, -a${RESET}    Target specific app\n`);
+                return;
+            }
             const config = loadConfig();
             const isLocal = isLocalDbTarget(args);
 
@@ -1531,6 +1587,16 @@ ${hasPrompt ? `
     // ── db:push ──────────────────────────────────────────
     // Cloud-first: 기본=Cloud, --local=로컬
     async "db:push"(...args) {
+            // --help handler
+            if (args.includes("--help") || args.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow db:push${RESET} — Sync schema.ts → database\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow db:push [options]\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--prod${RESET}       Push to production DB (confirmation required)`);
+                log(`    ${DIM}--local${RESET}      Push to local dev DB`);
+                log(`    ${DIM}--app, -a${RESET}    Target specific app\n`);
+                return;
+            }
             const config = loadConfig();
             const isLocal = isLocalDbTarget(args);
 
@@ -1677,7 +1743,14 @@ ${hasPrompt ? `
         },
 
     // ── db:generate ──────────────────────────────────────
-    async "db:generate"() {
+    async "db:generate"(...args) {
+            // --help handler
+            if (args?.includes?.("--help") || args?.includes?.("-h")) {
+                log(`\n${BOLD}${CYAN}gencow db:generate${RESET} — Generate SQL migration files\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow db:generate\n`);
+                log(`  Generates migration files from schema.ts using drizzle-kit.\n`);
+                return;
+            }
             const config = loadConfig();
             log(`\n${BOLD}${CYAN}Gencow DB Generate${RESET}\n`);
             info("Generating migration files from schema.ts...");
@@ -1936,6 +2009,23 @@ ${BOLD}Examples:${RESET}
 
     // ── static — 정적 파일 배포 (dev 기본, --prod 로 프로덕션) ──
     async static(...staticArgs) {
+            // --help handler
+            if (staticArgs.includes("--help") || staticArgs.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow static${RESET} — Deploy static files\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow static [dir] [options]\n`);
+                log(`  ${BOLD}Arguments:${RESET}`);
+                log(`    ${CYAN}dir${RESET}                Static directory (auto-detects dist/, out/, build/)\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--prod${RESET}             Deploy to production app`);
+                log(`    ${DIM}--no-backend${RESET}       Skip backend deployment`);
+                log(`    ${DIM}--force, -f${RESET}        Skip dependency audit`);
+                log(`    ${DIM}--app, -a${RESET}          Target specific app\n`);
+                log(`  ${BOLD}Examples:${RESET}`);
+                log(`    gencow static dist/`);
+                log(`    gencow static --prod dist/`);
+                log(`    gencow static --no-backend dist/\n`);
+                return;
+            }
             const creds = requireCreds();
 
             let staticDir = null;
@@ -1989,6 +2079,21 @@ ${BOLD}Examples:${RESET}
 
     // ── deploy — 클라우드 배포 (dev 기본, --prod로 프로덕션) ──
     async deploy(...deployArgs) {
+            // --help handler
+            if (deployArgs.includes("--help") || deployArgs.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow deploy${RESET} — Deploy backend to cloud\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow deploy [options]\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--prod${RESET}             Deploy to production (Pro+ only)`);
+                log(`    ${DIM}--rollback${RESET}          Rollback to previous deployment`);
+                log(`    ${DIM}--force, -f${RESET}        Skip dependency audit`);
+                log(`    ${DIM}--app, -a${RESET}          Target specific app\n`);
+                log(`  ${BOLD}Examples:${RESET}`);
+                log(`    gencow deploy`);
+                log(`    gencow deploy --prod`);
+                log(`    gencow deploy --rollback\n`);
+                return;
+            }
             const creds = requireCreds();
 
             // gencow.json에서 앱 ID 확인 (자동 생성된 유니크 ID)
@@ -3049,6 +3154,20 @@ ${BOLD}Examples:${RESET}
 
     // ── env ───────────────────────────────────────────────
     async env(...envArgs) {
+            // --help handler
+            if (envArgs.includes("--help") || envArgs.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow env${RESET} — Environment variable management\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow env <command> [options]\n`);
+                log(`  ${BOLD}Commands:${RESET}`);
+                log(`    ${CYAN}list${RESET}             List cloud env vars`);
+                log(`    ${CYAN}set${RESET} KEY=VALUE    Set cloud env var (hot-reload)`);
+                log(`    ${CYAN}unset${RESET} KEY        Remove cloud env var`);
+                log(`    ${CYAN}push${RESET}             Push .env to cloud\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--prod${RESET}           Target production app`);
+                log(`    ${DIM}--app, -a${RESET}        Target specific app\n`);
+                return;
+            }
             const creds = requireCreds();
             const subCmd = envArgs[0] || "list";
             const restArgs = envArgs.slice(1);
@@ -3216,6 +3335,19 @@ ${BOLD}Examples:${RESET}
 
     // ── config ────────────────────────────────────────────
     async config(...configArgs) {
+            // --help handler
+            if (configArgs.includes("--help") || configArgs.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow config${RESET} — App configuration\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow config <command> [options]\n`);
+                log(`  ${BOLD}Commands:${RESET}`);
+                log(`    ${CYAN}set${RESET}   <key> <value>  Set config (e.g. image.maxWidth 1920)`);
+                log(`    ${CYAN}get${RESET}                  Show current config`);
+                log(`    ${CYAN}reset${RESET}                Reset to tier defaults\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--prod${RESET}     Target production app`);
+                log(`    ${DIM}--app, -a${RESET}  Target specific app\n`);
+                return;
+            }
             const creds = requireCreds();
             const subCmd = configArgs[0] || "help";
             const restArgs = configArgs.slice(1);
@@ -3828,6 +3960,18 @@ ${BOLD}Examples:${RESET}
 
     // ── domain ─────────────────────────────────────────────
     async domain(...domainArgs) {
+            // --help handler
+            if (domainArgs.includes("--help") || domainArgs.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow domain${RESET} — Custom domain management\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow domain <command> [options]\n`);
+                log(`  ${BOLD}Commands:${RESET}`);
+                log(`    ${CYAN}set${RESET} <domain>    Connect custom domain (e.g. myapp.com)`);
+                log(`    ${CYAN}status${RESET}           Check domain DNS/TLS status`);
+                log(`    ${CYAN}remove${RESET}           Disconnect custom domain\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--app, -a${RESET}  Target specific app\n`);
+                return;
+            }
             const creds = requireCreds();
             const subCmd = domainArgs[0] || "status";
             const restArgs = domainArgs.slice(1);
@@ -3966,6 +4110,15 @@ ${BOLD}Examples:${RESET}
 
     // ── codegen — 프론트엔드 전용 api.ts 생성 ─────────
     async codegen(...codegenArgs) {
+            // --help handler
+            if (codegenArgs.includes("--help") || codegenArgs.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow codegen${RESET} — Generate frontend api.ts from schema\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow codegen [options]\n`);
+                log(`  ${BOLD}Options:${RESET}`);
+                log(`    ${DIM}--outdir, -o${RESET}  Output directory (default: src/gencow/)\n`);
+                log(`  Generates api.ts from gencow/ folder for frontend use.\n`);
+                return;
+            }
             const config = loadConfig();
             const absoluteFunctions = resolve(process.cwd(), config.functionsDir);
 
@@ -3994,12 +4147,8 @@ ${BOLD}Examples:${RESET}
             try { runtimeRoot = findServerRoot(); } catch { runtimeRoot = process.cwd(); }
             const extractTsPath = resolve(runtimeRoot, ".gencow-extract.ts");
 
-            // @gencow/core — 번들된 core 절대 경로 우선, 없으면 bare specifier
-            // generateApiTs()와 동일 해석 전략: 글로벌 CLI에서도 resolve 보장
-            const bundledCorePath = resolve(runtimeRoot, "../core/index.js");
-            const coreImport = existsSync(bundledCorePath)
-                ? bundledCorePath.replace(/\\/g, "/")
-                : "@gencow/core";
+            // @gencow/core — 3단계 fallback (bundled → CWD node_modules → bare specifier)
+            const coreImport = resolveCoreImport(runtimeRoot);
 
             const script = `
 import { getRegisteredQueries, getRegisteredMutations } from "${coreImport}";
@@ -4094,6 +4243,17 @@ process.exit(0);
 
     // ── app (subcommands: create, list, delete) ────────
     async app(subcmd, ...rest) {
+            // --help handler
+            if (subcmd === "--help" || subcmd === "-h" || rest.includes("--help") || rest.includes("-h")) {
+                log(`\n${BOLD}${CYAN}gencow app${RESET} — App management\n`);
+                log(`  ${BOLD}Usage:${RESET}  gencow app <command>\n`);
+                log(`  ${BOLD}Commands:${RESET}`);
+                log(`    ${CYAN}list${RESET}      List your apps`);
+                log(`    ${CYAN}create${RESET}    Create a new app`);
+                log(`    ${CYAN}delete${RESET}    Delete an app (confirmation required)`);
+                log(`    ${CYAN}status${RESET}    Show app status\n`);
+                return;
+            }
             const creds = requireCreds();
 
             if (!subcmd || subcmd === "list") {