gencow 0.1.127 → 0.1.129

package/bin/gencow.mjs

@@ -727,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;
@@ -1166,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);
 
@@ -1562,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);
 
@@ -1708,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...");
@@ -1967,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;
@@ -2020,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)
@@ -3080,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);
@@ -3247,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);
@@ -3859,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);
@@ -3997,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);
 
@@ -4121,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") {

package/core/index.js

@@ -1524,6 +1524,11 @@ function buildRealtimeCtx(options) {
           continue;
         }
         try {
+          if (!options?.buildCtxForRefresh) {
+            console.warn(
+              `[gencow] \u26A0\uFE0F  refresh("${key}"): buildCtxForRefresh not provided. Query handler will receive an empty ctx \u2014 ctx.db will be undefined. This is a framework configuration error. \u{1F4A1} Ensure buildRealtimeCtx() receives a buildCtxForRefresh callback.`
+            );
+          }
           const refreshCtx = options?.buildCtxForRefresh?.() ?? {};
           const result = await queryDef.handler(refreshCtx, {});
           if (options?.httpCallback) {