@cogito.ai/cli 0.4.3 → 0.4.5

package/dist/index.js

@@ -868,7 +868,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "@cogito.ai/cli",
-    version: "0.4.3",
+    version: "0.4.5",
     type: "module",
     description: "AgentDock CLI – scaffold projects for humans and AI agents",
     publishConfig: {

package/dist/templates/web-nextjs/apps/docs/.source/browser.ts

@@ -1,22 +1,12 @@
 // @ts-nocheck
-import { browser } from 'fumadocs-mdx/runtime/browser'
-import type * as Config from '../source.config'
+import { browser } from 'fumadocs-mdx/runtime/browser';
+import type * as Config from '../source.config';
 
-const create = browser<
-  typeof Config,
-  import('fumadocs-mdx/runtime/types').InternalTypeConfig & {
-    DocData: {}
+const create = browser<typeof Config, import("fumadocs-mdx/runtime/types").InternalTypeConfig & {
+  DocData: {
   }
->()
+}>();
 const browserCollections = {
-  docs: create.doc('docs', {
-    'index.mdx': () => import('../content/docs/index.mdx?collection=docs'),
-    'changelog/index.mdx': () => import('../content/docs/changelog/index.mdx?collection=docs'),
-    'decisions/turbo-package-manager.mdx': () =>
-      import('../content/docs/decisions/turbo-package-manager.mdx?collection=docs'),
-    'features/auth.mdx': () => import('../content/docs/features/auth.mdx?collection=docs'),
-    'features/hello.mdx': () => import('../content/docs/features/hello.mdx?collection=docs'),
-    'roadmap/index.mdx': () => import('../content/docs/roadmap/index.mdx?collection=docs'),
-  }),
-}
-export default browserCollections
+  docs: create.doc("docs", {"index.mdx": () => import("../content/docs/index.mdx?collection=docs"), "changelog/index.mdx": () => import("../content/docs/changelog/index.mdx?collection=docs"), "decisions/turbo-package-manager.mdx": () => import("../content/docs/decisions/turbo-package-manager.mdx?collection=docs"), "roadmap/index.mdx": () => import("../content/docs/roadmap/index.mdx?collection=docs"), "template/alipay.mdx": () => import("../content/docs/template/alipay.mdx?collection=docs"), "template/deployment.mdx": () => import("../content/docs/template/deployment.mdx?collection=docs"), "template/drizzle.mdx": () => import("../content/docs/template/drizzle.mdx?collection=docs"), "template/getting-started.mdx": () => import("../content/docs/template/getting-started.mdx?collection=docs"), "template/stripe.mdx": () => import("../content/docs/template/stripe.mdx?collection=docs"), "template/supabase.mdx": () => import("../content/docs/template/supabase.mdx?collection=docs"), "template/troubleshooting.mdx": () => import("../content/docs/template/troubleshooting.mdx?collection=docs"), "template/wechat-pay.mdx": () => import("../content/docs/template/wechat-pay.mdx?collection=docs"), "features/auth.mdx": () => import("../content/docs/features/auth.mdx?collection=docs"), "features/hello.mdx": () => import("../content/docs/features/hello.mdx?collection=docs"), }),
+};
+export default browserCollections;

package/dist/templates/web-nextjs/apps/docs/.source/dynamic.ts

@@ -1,14 +1,8 @@
 // @ts-nocheck
-import { dynamic } from 'fumadocs-mdx/runtime/dynamic'
-import * as Config from '../source.config'
+import { dynamic } from 'fumadocs-mdx/runtime/dynamic';
+import * as Config from '../source.config';
 
-const create = await dynamic<
-  typeof Config,
-  import('fumadocs-mdx/runtime/types').InternalTypeConfig & {
-    DocData: {}
+const create = await dynamic<typeof Config, import("fumadocs-mdx/runtime/types").InternalTypeConfig & {
+  DocData: {
   }
->(
-  Config,
-  { configPath: 'source.config.ts', environment: 'next', outDir: '.source' },
-  { doc: { passthroughs: ['extractedReferences'] } },
-)
+}>(Config, {"configPath":"source.config.ts","environment":"next","outDir":".source"}, {"doc":{"passthroughs":["extractedReferences"]}});

package/dist/templates/web-nextjs/apps/docs/.source/server.ts

@@ -1,41 +1,30 @@
 // @ts-nocheck
-import * as __fd_glob_10 from '../content/docs/roadmap/index.mdx?collection=docs'
-import * as __fd_glob_9 from '../content/docs/features/hello.mdx?collection=docs'
-import * as __fd_glob_8 from '../content/docs/features/auth.mdx?collection=docs'
-import * as __fd_glob_7 from '../content/docs/decisions/turbo-package-manager.mdx?collection=docs'
-import * as __fd_glob_6 from '../content/docs/changelog/index.mdx?collection=docs'
-import * as __fd_glob_5 from '../content/docs/index.mdx?collection=docs'
-import { default as __fd_glob_4 } from '../content/docs/roadmap/meta.json?collection=docs'
-import { default as __fd_glob_3 } from '../content/docs/decisions/meta.json?collection=docs'
-import { default as __fd_glob_2 } from '../content/docs/features/meta.json?collection=docs'
-import { default as __fd_glob_1 } from '../content/docs/changelog/meta.json?collection=docs'
-import { default as __fd_glob_0 } from '../content/docs/meta.json?collection=docs'
-import { server } from 'fumadocs-mdx/runtime/server'
-import type * as Config from '../source.config'
+import * as __fd_glob_19 from "../content/docs/features/hello.mdx?collection=docs"
+import * as __fd_glob_18 from "../content/docs/features/auth.mdx?collection=docs"
+import * as __fd_glob_17 from "../content/docs/template/wechat-pay.mdx?collection=docs"
+import * as __fd_glob_16 from "../content/docs/template/troubleshooting.mdx?collection=docs"
+import * as __fd_glob_15 from "../content/docs/template/supabase.mdx?collection=docs"
+import * as __fd_glob_14 from "../content/docs/template/stripe.mdx?collection=docs"
+import * as __fd_glob_13 from "../content/docs/template/getting-started.mdx?collection=docs"
+import * as __fd_glob_12 from "../content/docs/template/drizzle.mdx?collection=docs"
+import * as __fd_glob_11 from "../content/docs/template/deployment.mdx?collection=docs"
+import * as __fd_glob_10 from "../content/docs/template/alipay.mdx?collection=docs"
+import * as __fd_glob_9 from "../content/docs/roadmap/index.mdx?collection=docs"
+import * as __fd_glob_8 from "../content/docs/decisions/turbo-package-manager.mdx?collection=docs"
+import * as __fd_glob_7 from "../content/docs/changelog/index.mdx?collection=docs"
+import * as __fd_glob_6 from "../content/docs/index.mdx?collection=docs"
+import { default as __fd_glob_5 } from "../content/docs/roadmap/meta.json?collection=docs"
+import { default as __fd_glob_4 } from "../content/docs/template/meta.json?collection=docs"
+import { default as __fd_glob_3 } from "../content/docs/changelog/meta.json?collection=docs"
+import { default as __fd_glob_2 } from "../content/docs/features/meta.json?collection=docs"
+import { default as __fd_glob_1 } from "../content/docs/decisions/meta.json?collection=docs"
+import { default as __fd_glob_0 } from "../content/docs/meta.json?collection=docs"
+import { server } from 'fumadocs-mdx/runtime/server';
+import type * as Config from '../source.config';
 
-const create = server<
-  typeof Config,
-  import('fumadocs-mdx/runtime/types').InternalTypeConfig & {
-    DocData: {}
+const create = server<typeof Config, import("fumadocs-mdx/runtime/types").InternalTypeConfig & {
+  DocData: {
   }
->({ doc: { passthroughs: ['extractedReferences'] } })
+}>({"doc":{"passthroughs":["extractedReferences"]}});
 
-export const docs = await create.docs(
-  'docs',
-  'content/docs',
-  {
-    'meta.json': __fd_glob_0,
-    'changelog/meta.json': __fd_glob_1,
-    'features/meta.json': __fd_glob_2,
-    'decisions/meta.json': __fd_glob_3,
-    'roadmap/meta.json': __fd_glob_4,
-  },
-  {
-    'index.mdx': __fd_glob_5,
-    'changelog/index.mdx': __fd_glob_6,
-    'decisions/turbo-package-manager.mdx': __fd_glob_7,
-    'features/auth.mdx': __fd_glob_8,
-    'features/hello.mdx': __fd_glob_9,
-    'roadmap/index.mdx': __fd_glob_10,
-  },
-)
+export const docs = await create.docs("docs", "content/docs", {"meta.json": __fd_glob_0, "decisions/meta.json": __fd_glob_1, "features/meta.json": __fd_glob_2, "changelog/meta.json": __fd_glob_3, "template/meta.json": __fd_glob_4, "roadmap/meta.json": __fd_glob_5, }, {"index.mdx": __fd_glob_6, "changelog/index.mdx": __fd_glob_7, "decisions/turbo-package-manager.mdx": __fd_glob_8, "roadmap/index.mdx": __fd_glob_9, "template/alipay.mdx": __fd_glob_10, "template/deployment.mdx": __fd_glob_11, "template/drizzle.mdx": __fd_glob_12, "template/getting-started.mdx": __fd_glob_13, "template/stripe.mdx": __fd_glob_14, "template/supabase.mdx": __fd_glob_15, "template/troubleshooting.mdx": __fd_glob_16, "template/wechat-pay.mdx": __fd_glob_17, "features/auth.mdx": __fd_glob_18, "features/hello.mdx": __fd_glob_19, });

package/dist/templates/web-nextjs/apps/docs/content/docs/meta.json

@@ -1,4 +1,4 @@
 {
   "title": "Documentation",
-  "pages": ["features", "decisions", "changelog", "roadmap"]
+  "pages": ["template", "features", "decisions", "changelog", "roadmap"]
 }

package/dist/templates/web-nextjs/apps/docs/content/docs/template/alipay.mdx

@@ -0,0 +1,276 @@
+---
+title: 支付：支付宝
+description: 支付宝支付集成指南，包括架构、配置、安全和使用方法。
+---
+
+## 概述
+
+本项目集成了 **支付宝** 支付方式，支持电脑网站支付（PC Web）场景。
+
+## 技术架构
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                        用户浏览器                              │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │   选择商品    │ -> │  创建订单     │ -> │  跳转支付     │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+┌─────────────────────────────────────────────────────────────┐
+│                    Next.js 应用 (Server)                    │
+│  ┌──────────────┐    ┌──────────────┐    ┌──────────────┐  │
+│  │  /api/pay    │    │  签名/验签   │    │  回调处理     │  │
+│  │  /api/notify │    │              │    │              │  │
+│  └──────────────┘    └──────────────┘    └──────────────┘  │
+└─────────────────────────────────────────────────────────────┘
+                             │
+                             ▼
+                    ┌────────────────┐
+                    │   支付宝网关    │
+                    │  (openapi.alipay.com) │
+                    └────────────────┘
+```
+
+## 时序图
+
+```
+用户          前端页面         Next.js API      支付宝网关
+ │               │                  │                 │
+ │  1.选择商品   │                  │                 │
+ │─────────────>│                  │                 │
+ │               │  2.POST /create  │                 │
+ │               │─────────────────>│                 │
+ │               │                  │  3.创建订单      │
+ │               │                  │─────────────────>│
+ │               │                  │  4.返回支付链接   │
+ │               │                  │<─────────────────│
+ │  5.返回支付URL│                  │                 │
+ │<─────────────│                  │                 │
+ │  6.跳转支付宝 │                  │                 │
+ │─────────────────────────────────────────────────>│
+ │  7.完成支付   │                  │                 │
+ │<─────────────────────────────────────────────────│
+ │               │                  │  8.异步通知      │
+ │               │                  │<─────────────────│
+ │               │                  │  9.验签+更新状态 │
+ │               │                  │                 │
+ │  10.跳转成功页│                  │                 │
+ │<─────────────│                  │                 │
+```
+
+## 前置条件
+
+### 支付宝开放平台账号
+
+1. 注册 [支付宝开放平台](https://open.alipay.com/) 账号
+2. 创建应用，获取 **APPID**
+3. 生成并配置 **公钥和私钥**
+
+### 必要配置
+
+| 配置项 | 说明 | 获取位置 |
+|--------|------|----------|
+| `ALIPAY_APP_ID` | 应用 APPID | 支付宝开放平台 → 应用详情 |
+| `ALIPAY_PRIVATE_KEY` | 应用私钥 | 密钥工具生成 |
+| `ALIPAY_PUBLIC_KEY` | 应用公钥 | 密钥工具生成 |
+| `ALIPAY_GATEWAY_URL` | 网关地址 | `https://openapi.alipay.com/gateway.do` |
+
+## 开发环境配置
+
+### 1. 配置环境变量
+
+在 `.env.local` 中添加：
+
+```
+ALIPAY_APP_ID=your-app-id
+ALIPAY_PRIVATE_KEY=-----BEGIN RSA PRIVATE KEY-----\n...\n-----END RSA PRIVATE KEY-----
+ALIPAY_PUBLIC_KEY=-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----
+ALIPAY_GATEWAY_URL=https://openapi.alipay.com/gateway.do
+ALIPAY_NOTIFY_URL=https://your-domain.com/api/payments/alipay/notify
+ALIPAY_RETURN_URL=https://your-domain.com/payment/success
+```
+
+> **注意**: 私钥包含换行符，使用 `\n` 转义。
+
+### 2. 生成密钥对
+
+使用支付宝提供的 [密钥工具](https://opendocs.alipay.com/common/02khje) 生成 RSA2 密钥对：
+
+```bash
+# 工具下载
+https://ides.alipay.com/static/Alipaykeytool.dmg
+
+# 选择 "RSA2" 和 "PKCS1" 格式
+# 保存私钥和公钥
+```
+
+### 3. 配置支付宝公钥
+
+在支付宝开放平台 → 应用详情 → 开发设置 → 接口加签方式 中：
+
+1. 上传你的应用公钥
+2. 获取支付宝公钥（用于回调验签）
+
+## 生产环境配置
+
+### 服务器要求
+
+- 公网可访问的 HTTPS 地址
+- 支持接收 POST 请求的回调接口
+
+### 回调地址配置
+
+在支付宝开放平台 → 应用详情 → 开发设置 中配置：
+
+| 配置项 | 值 |
+|--------|-----|
+| 授权回调地址 | `https://your-domain.com/api/payments/alipay/return` |
+| 异步通知地址 | `https://your-domain.com/api/payments/alipay/notify` |
+
+## API 路由
+
+### 创建支付订单
+
+```http
+POST /api/payments/alipay/create
+Content-Type: application/json
+
+{
+  "orderId": "ORDER_123456",
+  "amount": 99.99,
+  "subject": "商品名称",
+  "body": "商品描述"
+}
+```
+
+**响应:**
+
+```json
+{
+  "success": true,
+  "data": {
+    "paymentUrl": "https://openapi.alipay.com/gateway.do?..."
+  }
+}
+```
+
+### 支付回调通知
+
+```http
+POST /api/payments/alipay/notify
+Content-Type: application/x-www-form-urlencoded
+```
+
+支付宝会发送以下参数：
+
+| 参数 | 说明 |
+|------|------|
+| `out_trade_no` | 商户订单号 |
+| `trade_no` | 支付宝交易号 |
+| `trade_status` | 交易状态（TRADE_SUCCESS 表示成功） |
+| `total_amount` | 订单金额 |
+| `sign` | 签名 |
+
+### 查询订单状态
+
+```http
+GET /api/payments/alipay/query?outTradeNo=ORDER_123456
+```
+
+## 安全注意事项
+
+### 签名验证
+
+**务必验证支付宝回调的签名**，防止伪造通知：
+
+```ts
+import { verifyAlipaySignature } from '@/lib/alipay'
+
+// 回调处理
+export async function POST(request: Request) {
+  const formData = await request.formData()
+  const params = Object.fromEntries(formData)
+  
+  // 1. 验证签名
+  const isValid = verifyAlipaySignature(params)
+  if (!isValid) {
+    return new Response('Invalid signature', { status: 400 })
+  }
+  
+  // 2. 更新订单状态
+  // ...
+}
+```
+
+### 安全最佳实践
+
+| 风险 | 防护措施 |
+|------|----------|
+| 回调伪造 | 严格验证签名 |
+| 金额篡改 | 比对数据库订单金额与回调金额 |
+| 重复通知 | 使用幂等性处理（out_trade_no 去重） |
+| 密钥泄露 | 私钥仅存储在服务器端，绝不暴露到客户端 |
+| 中间人攻击 | 使用 HTTPS 传输 |
+
+### 幂等性处理
+
+```ts
+// 使用数据库唯一约束防止重复处理
+await db.payments.updateOne(
+  { outTradeNo: params.out_trade_no, status: { $ne: 'PAID' } },
+  { $set: { status: 'PAID', tradeNo: params.trade_no } }
+)
+```
+
+## 开发环境调试
+
+### 沙箱环境
+
+支付宝提供沙箱环境用于开发测试：
+
+1. 登录 [支付宝开放平台](https://open.alipay.com/)
+2. 进入 **沙箱** 页面
+3. 获取沙箱 APPID 和密钥
+4. 修改环境变量为沙箱配置：
+
+```
+ALIPAY_GATEWAY_URL=https://openapi.alipaydev.com/gateway.do
+ALIPAY_APP_ID=your-sandbox-app-id
+```
+
+### 调试工具
+
+- [支付宝沙箱环境](https://open.alipay.com/platform/appDaily.htm?tab=account)
+- [在线签名校验工具](https://opendocs.alipay.com/common/02maie)
+
+## 支付宝支付 FAQs
+
+**Q: 支付回调收不到怎么办？**
+
+A: 检查以下几点：
+1. 服务器是否公网可访问
+2. 回调地址是否正确配置在支付宝开放平台
+3. 是否使用 HTTPS（支付宝要求）
+4. 服务器防火墙是否放行
+
+**Q: 签名验证失败？**
+
+A: 常见原因：
+1. 公私钥不匹配
+2. 编码格式错误（应为 UTF-8）
+3. 公钥/私钥格式错误（应为 PKCS1 格式）
+
+**Q: 如何测试支付流程？**
+
+A: 使用支付宝沙箱环境 + 沙箱账号登录 [沙箱版支付宝 APP](https://open.alipay.com/platform/appDaily.htm?tab=tool)。
+
+## 相关资源
+
+- [支付宝开放平台](https://open.alipay.com/)
+- [支付宝电脑网站支付文档](https://opendocs.alipay.com/open/270/105899)
+- [支付宝沙箱环境](https://open.alipay.com/platform/appDaily.htm)
+- [密钥工具下载](https://opendocs.alipay.com/common/02khje)
+- [签名校验工具](https://opendocs.alipay.com/common/02maie)
+- [异步通知说明](https://opendocs.alipay.com/open/270/105902)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/deployment.mdx

@@ -0,0 +1,32 @@
+---
+title: 项目部署
+description: 如何将 web-nextjs 模板项目部署到生产环境。
+---
+
+## 概述
+
+本章将介绍如何将 web-nextjs 模板项目部署到生产环境。
+
+> **占位章节**。后续我们会结合 CLI 部署到我们自己的部署平台 Dokploy。
+
+## 部署选项
+
+### 1. Vercel
+
+Vercel 是 Next.js 的原生部署平台，支持一键部署。
+
+### 2. Dokploy
+
+我们将通过 AgentDock CLI 集成 Dokploy 平台，实现一键部署。
+
+## 环境变量
+
+生产环境需要配置以下环境变量：
+
+- `NEXT_PUBLIC_SUPABASE_URL`
+- `NEXT_PUBLIC_SUPABASE_ANON_KEY`
+- `SUPABASE_SERVICE_ROLE_KEY`
+
+## 即将推出
+
+本章内容正在完善中，敬请期待。

package/dist/templates/web-nextjs/apps/docs/content/docs/template/drizzle.mdx

@@ -0,0 +1,18 @@
+---
+title: 数据层：Drizzle
+description: ORM 和数据库迁移管理。
+---
+
+## 概述
+
+本章将介绍如何使用 Drizzle ORM 管理数据库模式和查询。
+
+> **占位章节**。内容正在完善中。
+
+## 即将推出
+
+本章内容正在编写中，敬请期待。
+
+## 相关资源
+
+- [Drizzle ORM 官方文档](https://orm.drizzle.team/)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/getting-started.mdx

@@ -0,0 +1,98 @@
+---
+title: 开始使用
+description: 如何初始化、开发和部署 web-nextjs 模板项目。
+---
+
+## 环境要求
+
+- **Node.js**: >= 18
+- **pnpm**: >= 9
+- **Git**
+
+## 通过 CLI 初始化项目
+
+使用 AgentDock CLI 创建新项目：
+
+```bash
+npx @cogito.ai/agentdock-cli create my-project
+```
+
+选择 **web-nextjs** 模板，CLI 会自动完成以下操作：
+
+1. 克隆模板代码
+2. 安装依赖 (`pnpm install`)
+3. 复制环境变量配置文件 (`.env.local`)
+
+## 本地开发
+
+### 安装依赖
+
+```bash
+pnpm install
+```
+
+### 启动开发服务器
+
+```bash
+pnpm dev
+```
+
+这会同时启动：
+- **Web 应用**: http://localhost:3000
+- **文档站点**: http://localhost:3001
+
+### 构建生产版本
+
+```bash
+pnpm build
+```
+
+### 运行测试
+
+```bash
+pnpm test          # 运行单元测试
+pnpm check-types   # TypeScript 类型检查
+pnpm lint          # ESLint 代码检查
+```
+
+## 项目结构
+
+```
+my-project/
+├── apps/
+│   ├── web/          # Next.js 主应用
+│   └── docs/         # Fumadocs 文档站点
+├── packages/         # 共享包
+├── supabase/         # 数据库迁移
+└── scripts/          # 自动化脚本
+```
+
+## 关键配置
+
+### 环境变量
+
+复制 `.env.local.example` 到 `.env.local`，并填写以下配置：
+
+| 变量 | 说明 | 获取方式 |
+|------|------|----------|
+| `NEXT_PUBLIC_SUPABASE_URL` | Supabase 项目 URL | Supabase Dashboard → Project Settings → API |
+| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase 匿名密钥 | Supabase Dashboard → Project Settings → API |
+| `SUPABASE_SERVICE_ROLE_KEY` | Supabase 服务角色密钥 | Supabase Dashboard → Project Settings → API |
+
+### pnpm 工作区
+
+项目使用 pnpm workspace 管理 monorepo：
+
+```yaml
+# pnpm-workspace.yaml
+packages:
+  - 'apps/*'
+  - 'packages/*'
+```
+
+## 下一步
+
+- [数据层：Supabase](/docs/template/supabase)
+- [数据层：Drizzle](/docs/template/drizzle)
+- [支付：支付宝](/docs/template/alipay)
+- [支付：微信支付](/docs/template/wechat-pay)

package/dist/templates/web-nextjs/apps/docs/content/docs/template/meta.json

@@ -0,0 +1,13 @@
+{
+  "title": "web-nextjs 模板",
+  "pages": [
+    "getting-started",
+    "deployment",
+    "supabase",
+    "drizzle",
+    "alipay",
+    "wechat-pay",
+    "stripe",
+    "troubleshooting"
+  ]
+}

package/dist/templates/web-nextjs/apps/docs/content/docs/template/stripe.mdx

@@ -0,0 +1,18 @@
+---
+title: 支付：Stripe
+description: Stripe 支付集成指南。
+---
+
+## 概述
+
+本章将介绍如何集成 Stripe 支付。
+
+> **占位章节**。内容正在完善中。
+
+## 即将推出
+
+本章内容正在编写中，敬请期待。
+
+## 相关资源
+
+- [Stripe 官方文档](https://stripe.com/docs)