@andyqiu/codeforge 0.3.7 → 0.3.9

package/install.sh

@@ -155,6 +155,96 @@ opencode_cfg_path() {
   echo "$TARGET_ROOT/opencode.json"
 }
 
+# 配置默认 agent → codeforge（ADR-0056 D5 / D2 实施细节）
+#
+# 在 ~/.config/opencode/opencode.json 顶层幂等合并 "default_agent": "codeforge"。
+# 行为规则：
+#   - 字段不存在 → 写入 codeforge
+#   - 字段已是 codeforge → unchanged
+#   - 字段为其他值（用户自配） → 跳过不动 + 打 warn（绝不覆盖用户配置）
+# 仅在 MODE=user/global 调用（项目级配置由用户自己管，不动）。
+# 失败不阻塞 install 主流程（warn + return 0）。
+# 用 node 处理 JSON（避免 sed/awk 处理 JSON 转义边界）。
+configure_default_agent() {
+  local opencode_json="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/opencode.json"
+  local target_agent="codeforge"
+
+  if [[ ! -f "$opencode_json" ]]; then
+    warn "opencode.json 不存在，跳过 default_agent 配置（首次安装 opencode 后请手动重跑 codeforge install）"
+    return 0
+  fi
+
+  if ! command -v node >/dev/null 2>&1; then
+    warn "未找到 node，跳过 default_agent 配置（请安装 Node.js >= 20 后重跑 install）"
+    return 0
+  fi
+
+  if [[ $DRY_RUN -eq 1 ]]; then
+    printf "  ${C_BLUE}[dry-run]${C_RESET} configure default_agent=%s in %s\n" "$target_agent" "$opencode_json"
+    return 0
+  fi
+
+  local result
+  result=$(CFG="$opencode_json" TARGET="$target_agent" node -e '
+    const fs = require("node:fs");
+    const path = process.env.CFG;
+    const target = process.env.TARGET;
+    let cfg;
+    try { cfg = JSON.parse(fs.readFileSync(path, "utf8")); }
+    catch (e) { console.log("ERROR: " + e.message); process.exit(0); }
+    const current = cfg.default_agent;
+    if (current === undefined) {
+      cfg.default_agent = target;
+      fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+      console.log("SET default_agent=" + target);
+    } else if (current === target) {
+      console.log("UNCHANGED (already " + target + ")");
+    } else {
+      console.log("SKIPPED: user has default_agent=\"" + current + "\", not touching");
+    }
+  ' 2>&1) || {
+    warn "default_agent 配置失败（不阻塞 install 主流程）"
+    return 0
+  }
+  ok "default_agent: $result"
+}
+
+# 卸载时还原 default_agent（仅当当前值是 codeforge 时移除字段）。
+# 用户改成其他值的不动。
+restore_default_agent() {
+  local opencode_json="${XDG_CONFIG_HOME:-$HOME/.config}/opencode/opencode.json"
+  if [[ ! -f "$opencode_json" ]]; then
+    return 0
+  fi
+  if ! command -v node >/dev/null 2>&1; then
+    warn "未找到 node，跳过 default_agent 卸载还原"
+    return 0
+  fi
+  if [[ $DRY_RUN -eq 1 ]]; then
+    printf "  ${C_BLUE}[dry-run]${C_RESET} restore default_agent in %s (remove if codeforge)\n" "$opencode_json"
+    return 0
+  fi
+
+  local result
+  result=$(CFG="$opencode_json" node -e '
+    const fs = require("node:fs");
+    const path = process.env.CFG;
+    let cfg;
+    try { cfg = JSON.parse(fs.readFileSync(path, "utf8")); }
+    catch { process.exit(0); }
+    if (cfg.default_agent === "codeforge") {
+      delete cfg.default_agent;
+      fs.writeFileSync(path, JSON.stringify(cfg, null, 2) + "\n", "utf8");
+      console.log("REMOVED default_agent (was codeforge)");
+    } else if (cfg.default_agent !== undefined) {
+      console.log("SKIPPED: default_agent=\"" + cfg.default_agent + "\" not set by codeforge");
+    } else {
+      console.log("NOOP (no default_agent)");
+    }
+  ' 2>&1) || return 0
+  ok "default_agent: $result"
+}
+
 # 写 ~/.config/codeforge/kh.json 模板（仅 --global 调用）
 #
 # 硬约束 #2：API key 绝不能落盘，模板里**不写** token / apiKey 字段。
@@ -293,6 +383,10 @@ remove_plugin_entry() {
 uninstall() {
   log "卸载 CodeForge from: $TARGET_ROOT"
   remove_plugin_entry
+  # 还原 default_agent（仅 user/global mode；project mode 不动用户级配置）
+  if [[ "$MODE" != "project" ]]; then
+    restore_default_agent
+  fi
   for name in "${LEGACY_DIRS[@]}" "${MANAGED_DIRS[@]}"; do
     local p="$TARGET_ROOT/$name"
     if [[ -e "$p" || -L "$p" ]]; then
@@ -338,13 +432,13 @@ if [[ "$ACTION" == "uninstall" ]]; then
   exit 0
 fi
 
-# Step 1/7: 环境检测
-log "Step 1/7: 环境检测"
+# Step 1/8: 环境检测
+log "Step 1/8: 环境检测"
 detect_opencode
 detect_kh_mcp
 
-# Step 2/7: build dist bundle
-log "Step 2/7: 构建 dist/index.js 单 bundle"
+# Step 2/8: build dist bundle
+log "Step 2/8: 构建 dist/index.js 单 bundle"
 BUNDLE_SRC="$SOURCE_ROOT/$BUNDLE_SRC_REL"
 if [[ $SKIP_BUILD -eq 1 ]]; then
   warn "已跳过 build（--skip-build），使用现有 dist/index.js"
@@ -369,8 +463,8 @@ if [[ -f "$BUNDLE_SRC" ]]; then
   ok "bundle 已就绪: $BUNDLE_SRC (${size} bytes)"
 fi
 
-# Step 3/7: 准备目录 + 清理 legacy
-log "Step 3/7: 准备目标目录 + 清理 legacy 注入物"
+# Step 3/8: 准备目录 + 清理 legacy
+log "Step 3/8: 准备目标目录 + 清理 legacy 注入物"
 ensure_dir "$TARGET_ROOT"
 for legacy in "${LEGACY_DIRS[@]}"; do
   p="$TARGET_ROOT/$legacy"
@@ -380,8 +474,8 @@ for legacy in "${LEGACY_DIRS[@]}"; do
   fi
 done
 
-# Step 4/7: 装 bundle
-log "Step 4/7: 装入 dist/index.js bundle"
+# Step 4/8: 装 bundle
+log "Step 4/8: 装入 dist/index.js bundle"
 BUNDLE_DST="$TARGET_ROOT/$BUNDLE_DST_REL"
 ensure_dir "$(dirname "$BUNDLE_DST")"
 run "cp -f '$BUNDLE_SRC' '$BUNDLE_DST'"
@@ -396,8 +490,8 @@ if [[ $DRY_RUN -eq 0 ]]; then
 fi
 ok "VERSION → ${VERSION_FILE} (${CF_VERSION})"
 
-# Step 5/7: 装 agents / commands / workflows / context-templates
-log "Step 5/7: 装 agents / commands / workflows / context-templates"
+# Step 5/8: 装 agents / commands / workflows / context-templates
+log "Step 5/8: 装 agents / commands / workflows / context-templates"
 for entry in "${MD_COPY_DIRS[@]}"; do
   src_name="${entry%%:*}"; dst_name="${entry##*:}"
   src_path="$SOURCE_ROOT/$src_name"
@@ -430,8 +524,8 @@ for entry in "${COPY_DIRS[@]}"; do
   ok "$src_name/ → $dst_path (整目录拷贝)"
 done
 
-# Step 6/7: AGENTS.md 智能合并（仅项目模式）
-log "Step 6/7: AGENTS.md 智能合并"
+# Step 6/8: AGENTS.md 智能合并（仅项目模式）
+log "Step 6/8: AGENTS.md 智能合并"
 if [[ "$MODE" == "project" ]]; then
   agents_target="$(pwd)/AGENTS.md"
   template_path="$SOURCE_ROOT/$KH_TEMPLATE_REL"
@@ -440,14 +534,25 @@ else
   ok "全局模式：跳过项目 AGENTS.md 合并（context-templates 已装到 $TARGET_ROOT/context-templates）"
 fi
 
-# Step 7/7: KH 全局配置模板（仅 --global）
-log "Step 7/7: KH 全局配置模板"
+# Step 7/8: KH 全局配置模板（仅 --global）
+log "Step 7/8: KH 全局配置模板"
 if [[ "$MODE" == "global" ]]; then
   write_kh_template
 else
   ok "项目级安装，跳过 KH 全局模板（要装请加 --global）"
 fi
 
+# Step 8/8: 配置默认 agent → codeforge（ADR-0056 D5）
+# 仅 user/global mode 配置用户级 ~/.config/opencode/opencode.json
+# project mode 不动用户级配置（项目应由用户自决是否覆盖）
+# Windows 用户暂需手动配置（install.ps1 尚未实现该步骤，留待 ADR-0059）
+log "Step 8/8: 配置默认 agent → codeforge"
+if [[ "$MODE" == "global" ]]; then
+  configure_default_agent
+else
+  ok "项目级安装，跳过用户级 default_agent 配置（要装请加 --global）"
+fi
+
 # 验证清单
 hr
 ok "${C_BOLD}CodeForge v${CF_VERSION} 安装完成${C_RESET}"

package/package.json

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

package/workflows/parallel-explore.yaml

@@ -1,64 +1,29 @@
-# ──────────────────────────────────────────────────────────────
-# parallel-explore.yaml — N 路并行探索工作流（Phase 4 Task NN）
+# DEPRECATED (ADR-0054 hotfix 2)
 #
-# 触发：用户输入 /parallel
-# 流程：
-#   1. planner 根据用户原始需求 + KH 历史，拆出 N 个独立子任务
-#   2. subtasks plugin 并发执行（每条子任务可分配独立 worktree）
-#   3. reviewer 看冲突报告 + 各子任务摘要，给最终建议
+# /parallel 命令已由 plugins/subtasks.ts 直接拦截处理（command.execute.before hook），
+# 提供 4 类文字反馈（派出/启动/完成/总结）+ /parallel-status 查询。
 #
-# 关键：第二步用 `tool: subtasks-dispatch` 间接触发 plugins/subtasks，
-# 它内部调 lib/parallel.schedule 真正并发跑。
-# ──────────────────────────────────────────────────────────────
+# 本 workflow 之前作为 fallback 路径存在，dry_run 模式会吐大段 plan JSON 污染父 session；
+# 真跑模式又会和 plugin 路径冲突。当前实现下整个 workflow 已无用。
+#
+# 双保险禁用：
+#   1. trigger 错位为 /parallel-DISABLED-DO-NOT-MATCH — 永远 match 不上 /parallel
+#   2. 唯一 step 是 no-op smart_search，即使误触发也仅查询 KH，不会破坏任何东西
+#
+# schema 要求 steps ≥ 1 + 不识别 disabled 字段，所以无法用纯禁用语法；改用 trigger 错位兜底。
+#
+# 如未来 plugin 链路出问题，可恢复此文件（改回 trigger /parallel + 写真正 steps）。
 
 name: parallel-explore
-version: 1.0.0
-description: |
-  把一个含糊需求扔给 planner 拆成 N 路独立子任务，subtasks plugin 并发跑（每路独立
-  worktree），reviewer 看冲突 + digest 给最终建议。灵感来自 Cursor Composer 的多路探索。
-
-trigger: /parallel
+description: (已弃用 - 见 plugins/subtasks.ts)
+trigger: /parallel-DISABLED-DO-NOT-MATCH
 
 steps:
-  - name: 拆分
+  - name: no-op (workflow 已弃用)
     agent: planner
-    description: 把 ${user_request} 拆成 2~4 个独立可并发的子任务
-    inject_context:
-      role_hint: |
-        请输出 2~4 条独立子任务（每条独立可跑，互相不冲突）。
-        每条用「-」开头，单行描述。
     actions:
       - tool: smart_search
         args:
-          query: "${user_request}"
-          limit: 3
-        on_error: skip
-    on_error: abort
-
-  - name: 并发
-    agent: coder
-    description: 用 subtasks plugin 并发跑全部子任务
-    requires_human_approval: false
-    actions:
-      - tool: subtasks-dispatch
-        args:
-          parentId: "${session_id}"
-          # description 由 plugin 从上一步 planner 输出里抽（按行拆）
-          description: "${planner_output}"
-          maxConcurrency: 4
-        on_error: abort
-    on_error: abort
-
-  - name: 汇总
-    agent: reviewer
-    description: 看冲突 + digest，给最终建议（合并 / 选其一 / 补救）
-    actions:
-      - tool: save_chat_insight
-        args:
-          insight: "${session_summary}"
-          category: workflow
-          tags:
-            - "trigger:/parallel"
-            - "workflow:parallel-explore"
+          query: "deprecated parallel-explore workflow no-op"
+          limit: 1
         on_error: skip
-    on_error: skip