draftgo-cli 3.0.29 → 3.0.35

package/resources/skill/rules/parallel.md

@@ -1,263 +0,0 @@
----
-name: draftgo-parallel-execution
-description: DraftGo 并行开发协议。仅在当前任务按 dev-workflow 分级后确实需要多任务/多代理协作，且存在无依赖关系的任务组时启用。
-version: 1.0.0
----
-
-# DraftGo 并行开发协议
-
-> 本协议是 dev-workflow.md 的按需扩展，不是额外门禁。小修、轻功能和普通串行标准功能不启用；只有多任务、多资源或多代理协作确有收益，且存在 **2 个及以上无依赖任务** 时才启用。
-
----
-
-## 核心模型
-
-```
-主代理（Orchestrator）
-├── 按 dev-workflow 完成任务分级与必要范围确认
-├── 分析任务依赖图
-├── 分发无依赖任务组给子代理
-├── 收集子代理结果
-├── 统一推送（batch push）
-└── 闭环门
-
-子代理（Worker）
-├── 接收：单个 Task + 上下文包
-├── 执行：读 → 改 → 验（TDR 的 Tiny + Demo）
-├── 产出：修改后的文件 + changelog 条目 + 验证证据
-└── 不推送、不闭环（交回主代理）
-```
-
----
-
-## 依赖分析规则
-
-当 dev-workflow 判定需要 Task、并行或多资源协作时，为相关任务标注 `depends` 字段：
-
-```markdown
-- [ ] T1. 用户列表页增加导出按钮  ⬜
-  - depends: []
-  - resource_lock: pages/admin-users.html
-
-- [ ] T2. 用户详情页增加操作日志  ⬜
-  - depends: []
-  - resource_lock: pages/admin-user-detail.html
-
-- [ ] T3. 导出 API 脚本编写  ⬜
-  - depends: []
-  - resource_lock: custom_scripts/user-export.py
-
-- [ ] T4. 导出按钮对接 API  ⬜
-  - depends: [T1, T3]
-  - resource_lock: pages/admin-users.html
-```
-
-### 依赖判定标准
-
-| 关系 | 判定为依赖 | 判定为独立 |
-|------|-----------|-----------|
-| 同一文件 | T4 改 admin-users.html，T1 也改 → T4 depends T1 | - |
-| 数据依赖 | T4 需要 T3 产出的 API slug → T4 depends T3 | - |
-| 不同文件 | T1 改页面 A，T2 改页面 B | 无依赖，可并行 |
-| 不同类型 | T1 改 page，T3 写 script | 无依赖，可并行 |
-| 导航引用页面 | 导航加链接 → 目标页面必须先存在 | 页面和不相关导航 |
-
-### resource_lock 规则
-
-- 每个任务声明它要修改的文件路径（`resource_lock`）
-- **同一 resource_lock 的任务不可并行**，必须串行或合并
-- 一个任务可以锁多个资源：`resource_lock: [pages/a.html, pages/b.html]`
-
----
-
-## 并行分发协议
-
-### 主代理职责
-
-1. **短计划或 Task 明确后**，按依赖图将任务分为并行批次（waves）：
-   ```
-   Wave 1: [T1, T2, T3]  — 全部 depends: []，可并行
-   Wave 2: [T4]           — depends T1+T3，等 Wave 1 结束
-   ```
-
-2. **为每个子代理打包上下文**（Context Pack）：
-   ```
-   - task_id: T1
-   - task_description: <从 Task 文档摘取该任务的完整定义>
-   - resource_files: <该任务涉及的当前文件内容>
-   - story_context: <story.yaml 的关键约束摘要>
-   - dev_rules: <frontend.md / debugging-syntax.md 的关键禁区摘要>
-   - project_config: <.draftgo/config.json 的 server 地址（不含 token）>
-   ```
-
-3. **分发时的指令模板**：
-   ```
-   你是 DraftGo 子代理，负责执行单个开发任务。
-
-   ## 你的任务
-   {task_description}
-
-   ## 当前文件内容
-   {resource_files}
-
-   ## 强制规则
-   - 只修改 resource_lock 声明的文件，禁止动其他文件
-   - 遵守 DraftGo 前端禁区（见下方摘要）
-   - 修改完成后输出：
-     1. 修改后的完整文件内容
-     2. changelog 条目（格式：- [HH:MM] [操作类型] 描述）
-     3. 验证证据（你做了什么验证、结果如何）
-   - 不要推送、不要更新 Task 文档、不要写 lessons
-
-   ## 禁区摘要
-   {dev_rules_summary}
-   ```
-
-4. **收集结果后**：
-   - 将子代理产出的文件内容写入对应路径
-   - 汇总所有 changelog 条目，按时间排序写入 changelog.md
-   - 批量推送：`draftgo auto-push --batch pages 1,2,3 nav 4`（由 `auto_push` 开关决定是否真正推送）
-   - 统一更新 Task 文档标记
-   - 进入闭环门
-
-### 子代理职责
-
-1. 接收上下文包，理解任务边界
-2. 执行 TDR 循环的 Tiny + Demo：
-   - 读取当前文件
-   - 做最小改动
-   - 在能力范围内验证（语法检查、逻辑自审）
-3. **产出三件套**：修改后文件 + changelog 条目 + 验证报告
-4. **不做**：推送、Task 标记、lessons 记录、闭环声明
-
-### 子代理边界红线
-
-```
-禁止：
-- 修改 resource_lock 之外的任何文件
-- 调用推送 API 或推送脚本
-- 修改 .draftgo/Task/ 文档
-- 安装新依赖或引入新库
-- 修改 .draftgo/config.json
-- 做出超出 task_description 范围的"顺手"改动
-
-允许：
-- 读取其他文件以理解上下文（只读）
-- 在验证阶段用 console.log 调试
-- 发现阻塞时报告给主代理（而非自行绕过）
-```
-
----
-
-## 平台适配
-
-不同 AI 平台实现并行的方式不同，主代理根据当前平台选择策略：
-
-| 平台 | 并行实现方式 | 子代理能力 |
-|------|-------------|-----------|
-| Claude Code | `Agent` tool（subagent） | 完整文件读写 + Bash |
-| Cursor | Background Agent / Composer | 文件读写 |
-| Codex CLI | 多 sandbox 实例 | 完整隔离环境 |
-| Windsurf | Cascade 多步 | 有限并行 |
-| Kiro | Agent tool | 完整文件读写 |
-| 其他 | 退化为串行 | - |
-
-### 退化策略
-
-当平台不支持子代理或任务数 ≤ 2 时，**静默退化为串行执行**，不需要告知用户。并行协议的 Task 依赖标注仍保留（对执行顺序有指导意义）。
-
----
-
-## 批量推送
-
-并行执行完毕后，主代理使用批量推送减少网络开销：
-
-```bash
-draftgo auto-push --batch pages 1,2,3 nav 4 custom_scripts 7
-```
-
-开关为 `true` 时，等价于依次推送 pages 1、2、3 + nav 4 + custom_scripts 7，但一次加载 config、一次建立连接；为 `false` 时仅执行本地检查并返回未推送信息。
-
----
-
-## 错误处理
-
-### 子代理失败
-
-- 子代理报告阻塞 → 主代理判断：能否由自己接手修复？
-  - 能：主代理接手该 Task，其余子代理结果不受影响
-  - 不能：暂停该 Task（⏸），其余继续
-- 子代理产出与禁区冲突 → 主代理拒收，自行修复或重新分发
-
-### Wave 间传递
-
-- Wave 1 中某个 Task 失败 → Wave 2 中依赖该 Task 的任务自动暂停
-- Wave 1 中其他 Task 成功 → Wave 2 中不依赖失败任务的照常执行
-
-### 资源冲突检测
-
-主代理收集子代理结果时，如果发现两个子代理意外修改了同一文件（违规）：
-1. 比对两份输出，取变更不重叠的部分合并
-2. 如果重叠 → 丢弃后执行的那份，由主代理手动合并
-3. 记入 lessons：子代理 resource_lock 定义不够精确
-
----
-
-## Task 文档并行标注格式
-
-启用并行后，Task 文档的任务清单增加 `depends` 和 `resource_lock` 字段，进度总览增加 `wave` 列：
-
-```markdown
-## 任务清单
-
-- [ ] T1. 用户列表页增加导出按钮  ⬜
-  - depends: []
-  - resource_lock: pages/admin-users.html
-  - wave: 1
-
-- [ ] T2. 用户详情页增加操作日志  ⬜
-  - depends: []
-  - resource_lock: pages/admin-user-detail.html
-  - wave: 1
-
-- [ ] T3. 导出 API 脚本编写  ⬜
-  - depends: []
-  - resource_lock: custom_scripts/user-export.py
-  - wave: 1
-
-- [ ] T4. 导出按钮对接 API  ⬜
-  - depends: [T1, T3]
-  - resource_lock: pages/admin-users.html
-  - wave: 2
-
-## 进度总览
-
-| 任务 | Wave | 状态 | 执行方式 | 完成时间 | 证据摘要 |
-|-----|------|------|---------|---------|---------|
-| T1  | 1    | ⬜   | 子代理   |         |         |
-| T2  | 1    | ⬜   | 子代理   |         |         |
-| T3  | 1    | ⬜   | 子代理   |         |         |
-| T4  | 2    | ⬜   | 主代理   |         |         |
-```
-
----
-
-## 启用条件与判断
-
-主代理在完成任务分级和必要范围确认后自动判断：
-
-```
-IF 无依赖任务数 >= 2
-   AND 平台支持子代理
-   AND 任务间无 resource_lock 冲突
-THEN 启用并行分发
-ELSE 串行执行（静默，不告知用户）
-```
-
-不需要用户显式启用。用户也可以明确说"串行做"来关闭并行。
-
----
-
-## 一句话总结
-
-> **主代理管脑子（计划 + 闭环），子代理管手脚（单 Task 执行），resource_lock 防冲突，batch push 收全场。**

package/resources/skill/specs/custom-services.md

@@ -1,199 +0,0 @@
----
-read_when: 编写、修改、调试或评审自定义服务时；使用服务 SDK、路由、事件、定时任务或服务依赖时
----
-
-# Go 自定义服务契约
-
-DraftGo 的新自定义服务使用 Go。服务代码是完整的 `package main`，可以使用标准库和 `go.mod` 中声明的第三方库。平台在保存或发布时编译服务、运行 `Register` 并保存触发器清单；执行时在独立子进程中调用选定 handler。
-
-平台 SDK 的固定导入路径是 `draftgo/sdk`。它是 DraftGo 构建器注入的本地 module，不从 GitHub 或其他网络仓库下载，也不要在服务的 `go.mod` 中自行添加或 `replace` 此依赖。
-
-## 最小服务
-
-```go
-package main
-
-import "draftgo/sdk"
-
-func Register(app *sdk.App) {
-	app.Route("GET", "/health", health)
-	app.On("order.paid", afterPaid)
-	app.Schedule("0 9 * * 1-5", weekdayReport)
-}
-
-func health(ctx *sdk.Context) (any, error) {
-	return ctx.Respond(map[string]any{"ok": true}, 200, nil), nil
-}
-
-func afterPaid(ctx *sdk.Context) (any, error) {
-	ctx.Log.Info("order paid event received")
-	return nil, nil
-}
-
-func weekdayReport(ctx *sdk.Context) (any, error) { return nil, nil }
-```
-
-`Register` 必须没有业务副作用。它只注册 handler；网络请求、写数据库、发通知等操作放在 handler 内。
-
-## 本地资源
-
-```text
-.draftgo/custom_scripts/
-├── index.json
-└── script_<id>_<slug>.go
-```
-
-`index.json` 的 Go 服务字段：
-
-```json
-{
-  "name": "order-service",
-  "slug": "order-service",
-	"mode": "mixed",
-  "code_file": ".draftgo/custom_scripts/script_new_order-service.go",
-  "go_mod": "module example.com/order-service\n\ngo 1.26.0\n\nrequire github.com/google/uuid v1.6.0\n",
-  "go_sum": ""
-}
-```
-
-- 新服务使用 `mode=mixed`，允许同一个 `Register` 同时注册 route、event 和 scheduled。旧服务可继续使用单一 `route`、`event` 或 `scheduled` mode。
-- `go_mod` 和可选的 `go_sum` 随服务版本保存并由 `draftgo push custom_scripts` 推送。
-- 新依赖应锁定明确版本。构建错误会在保存/发布时返回，不会替换当前有效清单。
-
-## 触发器
-
-### Route
-
-```go
-func Register(app *sdk.App) {
-	app.Route("POST", "/orders", createOrder)
-}
-
-func createOrder(ctx *sdk.Context) (any, error) {
-	body, _ := ctx.Input["body"].(map[string]any)
-	return ctx.Respond(body, 201, nil), nil
-}
-```
-
-`slug=commerce` 时地址为 `POST /api/x/commerce/orders`。Route 精确匹配，不支持 `/orders/{id}` 模板；ID 使用 query 或 body。
-
-`ctx.Input` 的 Route 字段：`method`、`headers`、`body`、`query_params`、`path_params`。当前身份通过 `ctx.Auth.CurrentUser()` 获取，入站请求头通过 `ctx.Headers.Get("Authorization")` 等读取。
-
-Route 默认以请求调用者身份访问 `draftgo.DB`、`draftgo.Users` 和其他平台能力。服务由管理员创建、拥有 `scripts:*` 管理权限，或在请求中收到 SAT，都不会让普通 SDK 调用自动提升；`draftgo.Auth.RequireAdmin()` 也只检查当前调用者。
-
-可信服务需要管理员权限时，逐次显式使用 `draftgo.Admin.*`。这不是服务配置项，也不需要 `admin_access` 开关：调用 `Admin` 就是管理员调用声明。运行时为**这一次**平台 SDK 调用注入管理员身份，并把服务、版本、真实调用者、操作、资源和结果写进该次执行的审计日志；SAT、数据库连接和管理员凭据不会暴露给服务代码。
-
-```go
-func catalog(draftgo *sdk.Context) (any, error) {
-	// 继承调用者权限
-	owned, err := draftgo.DB.Query("order", sdk.QueryOptions{})
-	if err != nil { return nil, err }
-
-	// 显式管理员权限；仅此调用提升
-	internal, err := draftgo.Admin.DB.Query("internal_catalog", sdk.QueryOptions{})
-	if err != nil { return nil, err }
-
-	return draftgo.Respond(map[string]any{
-		"orders": owned.Items,
-		"catalog": internal.Items, // 生产代码应再按客户端可见字段组装
-	}, 200, nil)
-}
-```
-
-`draftgo.Admin` 提供与普通 SDK 对齐的 `DB`、`Users`、`Auth`、`Notify`、`HTTP`、`Cache`、`Config`、`AIHub` 能力。它等价于管理员在平台拥有的权限，不做资源级白名单；因此只能授予可信服务编辑者，并且 Route 返回值仍必须由代码负责脱敏。
-
-### Event
-
-```go
-app.On("user.registered", welcome)
-
-func welcome(ctx *sdk.Context) (any, error) {
-	payload, _ := ctx.Input["payload"].(map[string]any)
-	ctx.Log.Info("registered user: " + fmt.Sprint(payload["user_id"]))
-	return nil, nil
-}
-```
-
-事件异步且不阻塞原请求。事件输入含 `event`、`timestamp`、`payload`。
-
-事件 `payload` 含 `user_id` 或 `actor_user_id` 且该用户仍存在时，handler 继承该用户身份；无法解析用户时才以系统身份执行。事件服务应把事件数据视为业务输入，而不是把它当成绕过资源权限的通道。
-
-### Scheduled
-
-```go
-app.Schedule("0 2 * * *", cleanup)
-```
-
-cron 使用五字段表达式，也支持 `interval:5m`。定时 handler 的 `ctx.Input` 为空对象。
-
-定时任务没有调用者，会以系统身份执行。因此它只能由可信编辑者维护，写入范围应限制在明确的数据类型，并在 handler 中记录可审计的业务日志。
-
-## 平台 SDK
-
-所有资源访问经受控 RPC 返回 Go 主服务。不要自行读取数据库连接、服务 token 或宿主机环境变量。
-
-```go
-record, err := ctx.DB.Create("order", map[string]any{"title": "DraftGo"})
-records, err := ctx.DB.Query("order", sdk.QueryOptions{
-	Filters: map[string]any{"status": "paid"},
-	Page: 1, PageSize: 20, OrderBy: "id", Order: "desc",
-})
-
-user, err := ctx.Users.Get(12)
-err = ctx.Auth.RequireLogin()
-err = ctx.Notify.Send(12, "完成", "订单已创建", "info")
-
-cached, err := ctx.Cache.Get("daily-report")
-err = ctx.Cache.Set("daily-report", map[string]any{"ok": true}, time.Hour)
-
-value, err := ctx.Config.Get("feature_flag", false)
-response, err := ctx.HTTP.Get(ctx.Context(), "https://api.example.com/health", nil, 10*time.Second)
-
-reply, err := ctx.AIHub.Chat(ctx.Context(), sdk.AIChatRequest{AgentID: 12, Message: "总结订单"})
-ctx.Log.Info("service completed")
-```
-
-`ctx.DB` 支持 `Create`、`CreateMany`、`Get`、`Update`、`UpdateMany`、`Delete`、`Query`。`Query` 返回 `sdk.QueryResult{Items, Total, Page, PageSize}`。
-
-`ctx.Users` 支持 `Get`、`List`、`Update`。`ctx.Auth` 支持 `RequireLogin`、`RequireAdmin`、`RequireRole`、`CurrentUser`。
-
-`ctx.HTTP` 支持 `Get`、`Post`、`Put`、`Patch`、`Delete`；响应为 `sdk.HTTPResponse{StatusCode, Headers, Data}`。服务可使用 `config.http_allowed_hosts` 限制出站目标；HTTP timeout 最终限制为 1-30 秒，响应体最大 5 MB。
-
-`ctx.AIHub.Chat` 与 `ctx.AIHub.GenerateImage` 使用已配置的 Agent。AIHub 权限仍受服务配置与调用身份控制。
-
-日志每次执行最多 500 条、单条最多 4096 字符。不要记录 token、Cookie、密码或完整个人信息。
-
-## 权限与运行限制
-
-- `scripts:read/create/update/delete/execute` 控制可信人员管理服务。
-- Route 调用者仍由服务 `permission` 与 `config.route_security` 控制；管理权限不绕过 Route 调用权限。
-- Route 的普通 SDK 数据访问继承调用者权限；不要把“管理员创建服务”误写成自动提升。只有显式 `draftgo.Admin.*` 调用才以管理员执行并记录审计；定时任务和无可解析用户的事件是系统身份例外。
-- `config.timeout`、`max_concurrency`、`queue_timeout_ms` 适用于服务执行。Route 饱和时返回 HTTP 429。
-- Go 服务以独立进程运行，超时会终止该进程；它不是为不可信多租户代码准备的安全沙箱。只向可信编辑者授予服务编辑权限。
-- 每个保存版本按源码、依赖、SDK 和 Runner 协议生成不可变构建键。代码或依赖变更会生成新构建产物；旧版本可通过现有版本恢复接口重新激活。
-
-## 管理 API
-
-管理 API 使用 `{code, data, message}` 信封并受 `scripts:*` 权限控制：
-
-| 方法 | 路径 |
-|---|---|
-| `POST` / `GET` | `/api/scripts` |
-| `GET` | `/api/scripts/options/roles` |
-| `GET` / `PUT` / `DELETE` | `/api/scripts/{id}` |
-| `GET` | `/api/scripts/{id}/routes` |
-| `POST` | `/api/scripts/{id}/enable`、`/api/scripts/{id}/disable`、`/api/scripts/{id}/execute` |
-| `GET` | `/api/scripts/{id}/versions`、`/api/scripts/{id}/executions` |
-| `POST` | `/api/scripts/{id}/versions/{version_id}/restore` |
-| `GET` | `/api/scripts/{id}/executions/{execution_id}` |
-
-运行时 route 为 `ANY /api/x/{slug}/{path}`，不使用管理 API 信封。
-
-## 验收清单
-
-- [ ] `package main` 且实现 `Register(app *sdk.App)`。
-- [ ] 服务使用 `mode=mixed`，第三方库写入 `go_mod`。
-- [ ] 路由使用 `app.Route`，事件使用 `app.On`，定时任务使用 `app.Schedule`。
-- [ ] handler 返回 `(any, error)`，需要状态码时使用 `ctx.Respond`。
-- [ ] Route 显式设置 `permission` 与 `route_security`。
-- [ ] 推送后请求无副作用 GET Route，必要时运行 `draftgo push custom_scripts --probe-routes`。

package/src/commands/doctor.js

@@ -1,54 +0,0 @@
-'use strict';
-
-const log = require('../logger');
-const { all } = require('../installers');
-const { detectTargets } = require('../detect');
-const { findPython } = require('../python');
-const { readInstalledVersion, getPackageVersion } = require('../skill');
-const { fetchLatestVersion, cmpSemver } = require('../updateCheck');
-
-async function doctor(projectDir, flags = {}) {
-  log.title('draftgo doctor');
-
-  log.info(`Node 版本：${process.version}`);
-  log.info(`平台：${process.platform}`);
-  log.info(`CLI 版本：${getPackageVersion()}`);
-  log.info(`项目目录：${projectDir}`);
-
-  console.log('');
-  const py = findPython();
-  if (py) log.ok(`Python：${py.bin} (${py.version})`);
-  else log.err('Python 未检测到（DraftGo init/sync 脚本需要 Python 3.9+）。');
-
-  console.log('');
-  if (!flags['skip-update-check'] && process.env.DRAFTGO_NO_UPDATE_CHECK !== '1') {
-    const current = getPackageVersion();
-    const latest = await fetchLatestVersion();
-    if (!latest) {
-      log.dim('CLI 最新版查询失败（可能离线或 registry 不可达）');
-    } else if (cmpSemver(latest, current) > 0) {
-      log.warn(`CLI 有新版：${current} → ${latest}`);
-      log.dim('  运行 `draftgo upgrade` 可显式升级。');
-    } else {
-      log.ok(`CLI 已是最新：${current}`);
-    }
-  }
-
-  console.log('');
-  log.info('项目中检测到的 AI 工具信号：');
-  const hits = detectTargets(projectDir);
-  if (hits.length === 0) log.dim('  （无）');
-  else hits.forEach((n) => log.dim(`  • ${n}`));
-
-  console.log('');
-  log.info(`已装 skill 版本：${readInstalledVersion(projectDir) || '未安装'}`);
-  log.info('各 AI 工具入口状态：');
-  for (const t of all) {
-    const st = t.status(projectDir);
-    const mark = st.installed ? log.c.green('✓') : log.c.gray('·');
-    console.log(`  ${mark} ${t.name.padEnd(12)} ${t.displayName}`);
-  }
-  return 0;
-}
-
-module.exports = doctor;