@andyqiu/codeforge 0.3.10 → 0.3.11

package/install.sh

@@ -553,6 +553,14 @@ else
   ok "项目级安装，跳过用户级 default_agent 配置（要装请加 --global）"
 fi
 
+# 如果是 CodeForge 开发仓库本身，重新生成 dev shim（install 会清掉 .opencode/plugins/）
+# ADR-0055：本仓库内 opencode 加载本项目 dist/ 而非全局 stable，依赖 dev shim 让位
+if [ -f ".codeforge/.dev-marker" ] && [ -f "scripts/dev-sync.mjs" ]; then
+  node scripts/dev-sync.mjs --no-build 2>/dev/null || true
+  echo "  ↳ dev shim regenerated (.opencode/plugins/codeforge-dev.js)"
+fi
+
+
 # 验证清单
 hr
 ok "${C_BOLD}CodeForge v${CF_VERSION} 安装完成${C_RESET}"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andyqiu/codeforge",
-  "version": "0.3.10",
+  "version": "0.3.11",
   "description": "CodeForge — opencode 的零侵入扩展包",
   "type": "module",
   "private": false,

package/schemas/codeforge.schema.json

@@ -1,224 +1,230 @@
-{
-  "$schema": "http://json-schema.org/draft-07/schema#",
-  "$id": "https://codeforge/schemas/codeforge.schema.json",
-  "title": "CodeForge Configuration",
-  "description": "Single source of truth for CodeForge: agent ↔ model mapping + global runtime preferences.",
-  "type": "object",
-  "additionalProperties": true,
-  "properties": {
-    "$schema": { "type": "string" },
-    "_doc": { "type": "string" },
-
-    "models": {
-      "type": "object",
-      "description": "Agent ↔ model bindings + reusable categories + runtime fallback policy. Synced to agents/*.md frontmatter via `npm run sync:models`.",
-      "required": ["agents"],
-      "additionalProperties": true,
-      "properties": {
-        "_doc": { "type": "string" },
-        "default": {
-          "$ref": "#/$defs/ProviderModelId",
-          "description": "Fallback for any agent that omits `model` and is not bound by category."
-        },
-        "agents": {
-          "type": "object",
-          "description": "Per-agent model binding. Key = agent name (matches agents/<name>.md).",
-          "patternProperties": {
-            "^[a-z][a-z0-9-]*$": { "$ref": "#/$defs/AgentBinding" }
-          },
-          "additionalProperties": false,
-          "minProperties": 1
-        },
-        "categories": {
-          "type": "object",
-          "description": "Reusable model presets shared by multiple agents.",
-          "patternProperties": {
-            "^[a-z][a-z0-9-]*$": { "$ref": "#/$defs/CategoryBinding" }
-          },
-          "additionalProperties": false
-        },
-        "runtime_fallback": {
-          "type": "object",
-          "description": "Behavior of plugins/model-fallback.ts when primary model fails.",
-          "additionalProperties": true,
-          "properties": {
-            "enabled": { "type": "boolean", "default": true },
-            "max_fallback_attempts": { "type": "integer", "minimum": 1, "default": 3 },
-            "notify_on_fallback": { "type": "boolean", "default": true },
-            "trigger_events": {
-              "type": "array",
-              "items": { "type": "string" },
-              "default": ["session.error", "model.unavailable", "model.rate_limited"]
-            },
-            "_doc": { "type": "string" }
-          }
-        }
-      }
-    },
-
-    "autonomy": {
-      "type": "object",
-      "description": "三档自主度默认（AGENTS.md C18）。命令行 --mode 优先生效。",
-      "additionalProperties": false,
-      "properties": {
-        "_doc": { "type": "string" },
-        "default_mode": {
-          "type": "string",
-          "enum": ["step", "semi", "full"],
-          "default": "semi",
-          "description": "step=每步确认 / semi=危险工具确认 / full=全自动（强制 worktree）"
-        },
-        "downgrade_on_risky": {
-          "type": "boolean",
-          "default": true,
-          "description": "检测到破坏性命令是否自动降级到 semi（不可关）"
-        }
-      }
-    },
-
-    "runtime": {
-      "type": "object",
-      "description": "全局运行时安全开关（v1 占位；写入但 plugin 默认仍为 hardcoded 安全值，下个版本接入）",
-      "additionalProperties": false,
-      "properties": {
-        "_doc": { "type": "string" },
-        "worktree_isolation": {
-          "type": "boolean",
-          "default": true,
-          "description": "subtasks 在独立 worktree 跑（C22）。v1：subtasks plugin 已默认开，此字段暂未读取。"
-        },
-        "workspace_snapshot": {
-          "type": "boolean",
-          "default": true,
-          "description": "每步前对工作区做 shadow git 快照。v1：plugin 已默认开，此字段暂未读取。"
-        },
-        "auto_commit": {
-          "type": "boolean",
-          "default": false,
-          "description": "step 完成后自动 commit（C23）。v1：plugin 已默认开，此字段暂未读取。"
-        }
-      }
-    },
-
-    "tools": {
-      "type": "object",
-      "description": "工具开关（已接 plugins/codeforge-tools.ts）",
-      "additionalProperties": false,
-      "properties": {
-        "_doc": { "type": "string" },
-        "browser": {
-          "type": "object",
-          "additionalProperties": false,
-          "properties": {
-            "enabled": {
-              "type": "boolean",
-              "default": false,
-              "description": "Browser Control 工具开关（AGENTS.md C20 默认禁用）。开启会注册 6 个 browser_* 工具。"
-            }
-          }
-        }
-      }
-    },
-
-    "context": {
-      "type": "object",
-      "description": "Implicit Reasoning + Condenser（已接 plugins/token-manager.ts）",
-      "additionalProperties": false,
-      "properties": {
-        "_doc": { "type": "string" },
-        "condenser_threshold_ratio": {
-          "type": "number",
-          "minimum": 0.1,
-          "maximum": 0.95,
-          "default": 0.7,
-          "description": "Token 使用率超过此比例自动压缩上下文。"
-        }
-      }
-    },
-
-    "update": {
-      "type": "object",
-      "description": "自动更新检查（已接 plugins/update-checker.ts）。仿 oh-my-opencode：opencode 启动时后台拉 GitHub Releases，发现新版只通知不自动重装。",
-      "additionalProperties": false,
-      "properties": {
-        "_doc": { "type": "string" },
-        "auto_check_enabled": {
-          "type": "boolean",
-          "default": true,
-          "description": "是否启用启动时自动检查"
-        },
-        "interval_hours": {
-          "type": "integer",
-          "minimum": 1,
-          "maximum": 720,
-          "default": 24,
-          "description": "两次检查之间的最短间隔（小时）。命中缓存就不打 GitHub API。"
-        },
-        "repo": {
-          "type": "string",
-          "pattern": "^[a-zA-Z0-9._-]+/[a-zA-Z0-9._-]+$",
-          "default": "andy-personal/code-forge",
-          "description": "GitHub 仓库 <owner>/<repo>，私仓需要 GITHUB_TOKEN 环境变量"
-        },
-        "channel": {
-          "type": "string",
-          "enum": ["stable", "prerelease"],
-          "default": "stable",
-          "description": "stable=只看 latest release；prerelease=允许 pre-release（v1 仅声明，未实现）"
-        }
-      }
-    },
-
-  },
-
-  "$defs": {
-    "ProviderModelId": {
-      "type": "string",
-      "pattern": "^[a-z0-9-]+/[a-zA-Z0-9._-]+$",
-      "description": "Format: <provider>/<model-id>, e.g. anthropic/claude-opus-4-7"
-    },
-    "Thinking": {
-      "type": "object",
-      "additionalProperties": true,
-      "properties": {
-        "type": { "type": "string", "enum": ["enabled", "disabled"] },
-        "budget_tokens": { "type": "integer", "minimum": 0 }
-      }
-    },
-    "AgentBinding": {
-      "type": "object",
-      "required": ["model"],
-      "additionalProperties": false,
-      "properties": {
-        "model": { "$ref": "#/$defs/ProviderModelId" },
-        "variant": { "type": "string" },
-        "category": { "type": "string" },
-        "thinking": { "$ref": "#/$defs/Thinking" },
-        "fallback_models": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/ProviderModelId" },
-          "uniqueItems": true,
-          "default": []
-        },
-        "_doc": { "type": "string" }
-      }
-    },
-    "CategoryBinding": {
-      "type": "object",
-      "required": ["model"],
-      "additionalProperties": false,
-      "properties": {
-        "model": { "$ref": "#/$defs/ProviderModelId" },
-        "variant": { "type": "string" },
-        "thinking": { "$ref": "#/$defs/Thinking" },
-        "fallback_models": {
-          "type": "array",
-          "items": { "$ref": "#/$defs/ProviderModelId" },
-          "uniqueItems": true,
-          "default": []
-        },
-        "_doc": { "type": "string" }
-      }
-    }
-  }
-}
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://codeforge/schemas/codeforge.schema.json",
+  "title": "CodeForge Configuration",
+  "description": "Single source of truth for CodeForge: agent ↔ model mapping + global runtime preferences.",
+  "type": "object",
+  "additionalProperties": true,
+  "properties": {
+    "$schema": { "type": "string" },
+    "_doc": { "type": "string" },
+
+    "models": {
+      "type": "object",
+      "description": "Agent ↔ model bindings + reusable categories + runtime fallback policy. Synced to agents/*.md frontmatter via `npm run sync:models`.",
+      "required": ["agents"],
+      "additionalProperties": true,
+      "properties": {
+        "_doc": { "type": "string" },
+        "default": {
+          "$ref": "#/$defs/ProviderModelId",
+          "description": "Fallback for any agent that omits `model` and is not bound by category."
+        },
+        "agents": {
+          "type": "object",
+          "description": "Per-agent model binding. Key = agent name (matches agents/<name>.md).",
+          "patternProperties": {
+            "^[a-z][a-z0-9-]*$": { "$ref": "#/$defs/AgentBinding" }
+          },
+          "additionalProperties": false,
+          "minProperties": 1
+        },
+        "categories": {
+          "type": "object",
+          "description": "Reusable model presets shared by multiple agents.",
+          "patternProperties": {
+            "^[a-z][a-z0-9-]*$": { "$ref": "#/$defs/CategoryBinding" }
+          },
+          "additionalProperties": false
+        },
+        "runtime_fallback": {
+          "type": "object",
+          "description": "Behavior of plugins/model-fallback.ts when primary model fails.",
+          "additionalProperties": true,
+          "properties": {
+            "enabled": { "type": "boolean", "default": true },
+            "max_fallback_attempts": { "type": "integer", "minimum": 1, "default": 3 },
+            "notify_on_fallback": { "type": "boolean", "default": true },
+            "trigger_events": {
+              "type": "array",
+              "items": { "type": "string" },
+              "default": ["session.error", "model.unavailable", "model.rate_limited"]
+            },
+            "_doc": { "type": "string" }
+          }
+        }
+      }
+    },
+
+    "autonomy": {
+      "type": "object",
+      "description": "三档自主度默认（AGENTS.md C18）。命令行 --mode 优先生效。",
+      "additionalProperties": false,
+      "properties": {
+        "_doc": { "type": "string" },
+        "default_mode": {
+          "type": "string",
+          "enum": ["step", "semi", "full"],
+          "default": "semi",
+          "description": "step=每步确认 / semi=危险工具确认 / full=全自动（强制 worktree）"
+        },
+        "downgrade_on_risky": {
+          "type": "boolean",
+          "default": true,
+          "description": "检测到破坏性命令是否自动降级到 semi（不可关）"
+        }
+      }
+    },
+
+    "runtime": {
+      "type": "object",
+      "description": "全局运行时安全开关（v1 占位；写入但 plugin 默认仍为 hardcoded 安全值，下个版本接入）",
+      "additionalProperties": false,
+      "properties": {
+        "_doc": { "type": "string" },
+        "worktree_isolation": {
+          "type": "boolean",
+          "default": true,
+          "description": "subtasks 在独立 worktree 跑（C22）。v1：subtasks plugin 已默认开，此字段暂未读取。"
+        },
+        "workspace_snapshot": {
+          "type": "boolean",
+          "default": true,
+          "description": "每步前对工作区做 shadow git 快照。v1：plugin 已默认开，此字段暂未读取。"
+        },
+        "auto_commit": {
+          "type": "boolean",
+          "default": false,
+          "description": "step 完成后自动 commit（C23）。v1：plugin 已默认开，此字段暂未读取。"
+        }
+      }
+    },
+
+    "tools": {
+      "type": "object",
+      "description": "工具开关（已接 plugins/codeforge-tools.ts）",
+      "additionalProperties": false,
+      "properties": {
+        "_doc": { "type": "string" },
+        "browser": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "enabled": {
+              "type": "boolean",
+              "default": false,
+              "description": "Browser Control 工具开关（AGENTS.md C20 默认禁用）。开启会注册 6 个 browser_* 工具。"
+            }
+          }
+        }
+      }
+    },
+
+    "context": {
+      "type": "object",
+      "description": "Implicit Reasoning + Condenser（已接 plugins/token-manager.ts）",
+      "additionalProperties": false,
+      "properties": {
+        "_doc": { "type": "string" },
+        "condenser_threshold_ratio": {
+          "type": "number",
+          "minimum": 0.1,
+          "maximum": 0.95,
+          "default": 0.7,
+          "description": "Token 使用率超过此比例自动压缩上下文。"
+        }
+      }
+    },
+
+    "update": {
+      "type": "object",
+      "description": "自动更新检查（已接 plugins/update-checker.ts）。仿 oh-my-opencode：opencode 启动时后台拉 GitHub Releases，发现新版只通知不自动重装。",
+      "additionalProperties": false,
+      "properties": {
+        "_doc": { "type": "string" },
+        "auto_check_enabled": {
+          "type": "boolean",
+          "default": true,
+          "description": "是否启用启动时自动检查"
+        },
+        "interval_hours": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 720,
+          "default": 24,
+          "description": "两次检查之间的最短间隔（小时）。命中缓存就不打 GitHub API。"
+        },
+        "repo": {
+          "type": "string",
+          "pattern": "^[a-zA-Z0-9._-]+/[a-zA-Z0-9._-]+$",
+          "default": "andy-personal/code-forge",
+          "description": "GitHub 仓库 <owner>/<repo>，私仓需要 GITHUB_TOKEN 环境变量"
+        },
+        "channel": {
+          "type": "string",
+          "enum": ["stable", "prerelease"],
+          "default": "stable",
+          "description": "stable=只看 latest release；prerelease=允许 pre-release（v1 仅声明，未实现）"
+        }
+      }
+    },
+
+  },
+
+  "$defs": {
+    "ProviderModelId": {
+      "type": "string",
+      "pattern": "^[a-z0-9-]+/[a-zA-Z0-9._-]+$",
+      "description": "Format: <provider>/<model-id>, e.g. anthropic/claude-opus-4-7"
+    },
+    "Thinking": {
+      "type": "object",
+      "additionalProperties": true,
+      "properties": {
+        "type": { "type": "string", "enum": ["enabled", "disabled"] },
+        "budget_tokens": { "type": "integer", "minimum": 0 }
+      }
+    },
+    "AgentBinding": {
+      "type": "object",
+      "required": ["model"],
+      "additionalProperties": false,
+      "properties": {
+        "model": { "$ref": "#/$defs/ProviderModelId" },
+        "variant": { "type": "string" },
+        "category": { "type": "string" },
+        "tier": {
+          "type": "string",
+          "enum": ["quick", "balanced", "deep", "ultra"],
+          "description": "任务难度档位，与 lib/model-tier.ts 的 TierLevel 对应"
+        },
+
+        "thinking": { "$ref": "#/$defs/Thinking" },
+        "fallback_models": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ProviderModelId" },
+          "uniqueItems": true,
+          "default": []
+        },
+        "_doc": { "type": "string" }
+      }
+    },
+    "CategoryBinding": {
+      "type": "object",
+      "required": ["model"],
+      "additionalProperties": false,
+      "properties": {
+        "model": { "$ref": "#/$defs/ProviderModelId" },
+        "variant": { "type": "string" },
+        "thinking": { "$ref": "#/$defs/Thinking" },
+        "fallback_models": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/ProviderModelId" },
+          "uniqueItems": true,
+          "default": []
+        },
+        "_doc": { "type": "string" }
+      }
+    }
+  }
+}

package/scripts/sync-agent-models.mjs

@@ -7,12 +7,19 @@
  * 行为：
  *   - 对每个 agent：
  *       * 找不到 agents/<name>.md → 报警告（不创建）
- *       * 找到 → 在 frontmatter 中写入/更新：model / fallback_models / category / thinking
+ *       * 找到 → 在 frontmatter 中写入/更新：model / fallback_models / category / thinking / tier
  *       * 删除老字段 preferred_model（统一改名为 model，对齐 opencode 标准）
  *   - --check 模式：只校验，不写盘；任何漂移则 exit(1)
  *   - --dry  模式：打印会改什么，不写盘
  *
- * 设计原则：保留 frontmatter 中其他字段不动，仅替换四个目标 key。
+ * 设计原则：保留 frontmatter 中其他字段不动，仅替换目标 key。
+ *
+ * 关于 tier：
+ *   - tier 是 ADR-0060 模型难度分级字段（quick / balanced / deep / ultra）
+ *   - 变体 agent（名字含 -quick / -deep / -ultra 后缀）不在 codeforge.json 的 agents 里，
+ *     本脚本只同步 base agent；变体由人工维护或后续 sync 脚本扩展生成。
+ *   - 当 codeforge.json 未声明 tier 时，保留 .md 中现有 tier 值（不删），
+ *     避免变体 agent 的 tier 在 sync 时被静默清除。
  */
 
 import { promises as fs } from "node:fs"
@@ -28,7 +35,7 @@ const CONFIG_FILE = "codeforge.json"
 const CONFIG_PATH = path.join(ROOT, CONFIG_FILE)
 const AGENTS_DIR = path.join(ROOT, "agents")
 
-const TARGET_KEYS = ["model", "fallback_models", "model_category", "model_thinking"]
+const TARGET_KEYS = ["model", "fallback_models", "model_category", "model_thinking", "tier"]
 const REMOVE_KEYS = ["preferred_model"]
 
 async function main() {
@@ -108,6 +115,13 @@ function applyToMarkdown(text, agentCfg) {
 
   const lines = fmRaw.split(/\r?\n/)
 
+  // 在删除前先解析现有 frontmatter 里的 tier 值（顶层 key，单行）。
+  // 用途：当 codeforge.json 未声明 tier 时（如变体 agent），保留 .md 中已有 tier，
+  // 避免被本次 sync 静默清除。
+  const existingTier = lines
+    .map((line) => line.match(/^tier\s*:\s*(.+?)\s*$/)?.[1]?.trim())
+    .find(Boolean)
+
   // 删除目标 + REMOVE_KEYS。
   // 关键：YAML 子结构（list/object）以「行首空白」为续行标志；
   //       一旦遇到下一个顶层 key（行首非空白且不是注释/空行）就结束 skipping。
@@ -134,9 +148,14 @@ function applyToMarkdown(text, agentCfg) {
   // 末尾保证空行清洁
   while (stripped.length > 0 && stripped[stripped.length - 1].trim() === "") stripped.pop()
 
+  // tier 写入策略：优先用 agentCfg.tier（codeforge.json 声明），
+  // 否则 fallback 到 .md 中现有 tier；都没有就不写（保持空）。
+  const tier = typeof agentCfg.tier === "string" ? agentCfg.tier : existingTier
+
   const newLines = []
   newLines.push(`model: ${agentCfg.model}`)
   if (agentCfg.category) newLines.push(`model_category: ${agentCfg.category}`)
+  if (tier) newLines.push(`tier: ${tier}`)
   if (agentCfg.thinking) {
     newLines.push(`model_thinking:`)
     newLines.push(`  type: ${agentCfg.thinking.type}`)