gencow 0.1.13 → 0.1.14

package/bin/gencow.mjs

@@ -479,13 +479,71 @@ function generateReadmeMd(config, apiObj) {
     md += `\n`;
     md += `위 API를 기반으로 Next.js + Tailwind CSS UI 컴포넌트를 만들어줘.\n`;
     md += `- TypeScript 타입을 최대한 활용하고, 로딩/에러 상태도 처리해줘.\n`;
+    md += `- ctx.ai.chat()을 사용해서 AI를 호출하고, OpenAI SDK를 직접 설치하지 마.\n`;
+    md += `- 배포는 \`npx gencow deploy\`로 해.\n`;
+    md += `- 환경변수는 \`npx gencow env set KEY=VALUE\`로 관리해.\n`;
+    md += `- .env 파일은 로컬 개발 전용이야. 서버에는 gencow env push로 올려.\n`;
     md += `\`\`\`\n\n`;
 
-    // ── 4. Dev Tips ────────────────────────────────────────
+    // ── 4. AI 사용법 ────────────────────────────────────
+    md += `---\n\n## 🤖 AI 사용법 (ctx.ai)\n\n`;
+    md += `> Gencow는 OpenAI GPT-4o/4o-mini를 내장 지원합니다.\n`;
+    md += `> API 키 관리, 과금, 보안을 플랫폼이 자동 처리합니다.\n\n`;
+    md += `### 백엔드에서 AI 호출\n\n`;
+    md += `\`\`\`typescript\n`;
+    md += `// gencow/ai.ts\n`;
+    md += `import { mutation } from "@gencow/core";\n\n`;
+    md += `export const chat = mutation({\n`;
+    md += `    handler: async (ctx, { message }) => {\n`;
+    md += `        const result = await ctx.ai.chat({\n`;
+    md += `            model: "gpt-4o-mini",  // 또는 "gpt-4o"\n`;
+    md += `            messages: [{ role: "user", content: message }],\n`;
+    md += `        });\n`;
+    md += `        return result.text;\n`;
+    md += `    },\n`;
+    md += `});\n`;
+    md += `\`\`\`\n\n`;
+    md += `### 로컬 개발 설정\n\n`;
+    md += `\`.env\` 파일에 OpenAI 키를 추가하면 로컬에서 바로 테스트 가능:\n\n`;
+    md += `\`\`\`\nOPENAI_API_KEY=sk-...\n\`\`\`\n\n`;
+    md += `> ⚠️ 배포 후에는 플랫폼 키가 자동 사용됩니다. .env의 키는 로컬 전용입니다.\n\n`;
+    md += `### ❌ 하지 마세요\n\n`;
+    md += `\`\`\`typescript\n`;
+    md += `// ❌ OpenAI SDK를 직접 설치하지 마세요\n`;
+    md += `import OpenAI from "openai";\n`;
+    md += `const openai = new OpenAI({ apiKey: process.env.OPENAI_API_KEY });\n\n`;
+    md += `// ✅ ctx.ai.chat()을 사용하세요 — 키 관리 + 과금 자동\n`;
+    md += `const result = await ctx.ai.chat({ model: "gpt-4o-mini", messages: [...] });\n`;
+    md += `\`\`\`\n\n`;
+
+    // ── 5. 배포 가이드 ───────────────────────────────────
+    md += `---\n\n## 🚀 배포\n\n`;
+    md += `### 클라우드 배포 (3단계)\n\n`;
+    md += `\`\`\`bash\n`;
+    md += `# 1. 로그인 (최초 1회)\n`;
+    md += `npx gencow login\n\n`;
+    md += `# 2. 배포\n`;
+    md += `npx gencow deploy\n\n`;
+    md += `# 3. 환경변수 설정 (필요 시)\n`;
+    md += `npx gencow env set DATABASE_URL=postgres://...\n`;
+    md += `npx gencow env list\n`;
+    md += `\`\`\`\n\n`;
+    md += `> 배포 후 앱은 \`https://{앱이름}.gencow.dev\`에서 접근 가능\n\n`;
+    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`;
+
+    // ── 6. Dev Tips ────────────────────────────────────────
     md += `---\n\n## 💡 개발 팁\n\n`;
     md += `- \`gencow/\` 폴더 내 파일을 수정하면 \`api.ts\`와 이 README가 **자동으로 재생성**됩니다.\n`;
     md += `- 스키마 변경 후 \`gencow db:push\`를 실행하면 DB가 즉시 동기화됩니다.\n`;
     md += `- MCP 서버를 사용하면 AI가 이 구조를 자동으로 인식합니다.\n`;
+    md += `- 로컬 개발: \`gencow dev\` → \`http://localhost:5456\`\n`;
+    md += `- .env 파일은 로컬 전용. 서버에는 \`gencow env push\`로 올리세요.\n`;
 
     // ── 5. 기존 컴포넌트 섹션 보존 (gencow add로 추가된 부분) ──
     const COMP_START = "<!-- gencow-components-start -->";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "gencow",
-    "version": "0.1.13",
+    "version": "0.1.14",
     "description": "Gencow — Backend OS for AI Agents",
     "type": "module",
     "bin": {