@andyqiu/codeforge 0.3.4 → 0.3.5

package/README.md

@@ -25,6 +25,22 @@ npx @andyqiu/codeforge install
 - pending-changes / ast-edit 等代码改动工具
 - Knowledge Hub 集成（需配置 MCP）
 
+## 查当前版本
+
+```bash
+# macOS / Linux
+cat ~/.config/opencode/codeforge/VERSION
+
+# Windows PowerShell
+Get-Content "$env:USERPROFILE\.config\opencode\codeforge\VERSION"
+```
+
+输出形如 `0.3.5`。如需立即升级：
+
+```bash
+npx @andyqiu/codeforge install --global
+```
+
 ## Knowledge Hub 配置（团队成员必读）
 
 首次安装会在 `~/.config/codeforge/kh.json` 生成模板配置。需要在环境变量中提供 API key：

package/dist/index.js

@@ -16600,7 +16600,7 @@ import * as zlib from "node:zlib";
 // lib/version-injected.ts
 function getInjectedVersion() {
   try {
-    const v = "0.3.4";
+    const v = "0.3.5";
     if (typeof v === "string" && /^\d+\.\d+\.\d+/.test(v)) {
       return v;
     }

package/install.ps1

@@ -403,6 +403,21 @@ Invoke-Step "copy $BundleSrcRel -> $BundleDstRel" {
 Write-Ok "bundle -> $bundleDst"
 Add-PluginEntry
 
+# 写 VERSION marker 文件（用户 cat 一行查版本，不依赖 grep bundle）
+$cfVersion = "unknown"
+try {
+  $pkgPath = Join-Path $SourceRoot "package.json"
+  if (Test-Path -LiteralPath $pkgPath) {
+    $pkg = Get-Content -LiteralPath $pkgPath -Raw | ConvertFrom-Json
+    if ($pkg.version) { $cfVersion = $pkg.version }
+  }
+} catch { $cfVersion = "unknown" }
+$versionFile = Join-Path $TargetRoot "codeforge/VERSION"
+if (-not $DryRun) {
+  Set-Content -LiteralPath $versionFile -Value $cfVersion -NoNewline:$false -Encoding utf8
+}
+Write-Ok "VERSION -> $versionFile ($cfVersion)"
+
 # Step 5/7: 装 agents / commands / workflows / context-templates
 Write-Section 'Step 5/7: 装 agents / commands / workflows / context-templates'
 foreach ($entry in $MdCopyMap) {
@@ -474,7 +489,7 @@ if ($Global) {
 
 # 验证清单
 Write-Host '────────────────────────────────────────────────' -ForegroundColor DarkGray
-Write-Ok "CodeForge 安装完成（v0.1+ 单 bundle 架构）"
+Write-Ok "CodeForge v$cfVersion 安装完成"
 Write-Host '────────────────────────────────────────────────' -ForegroundColor DarkGray
 Write-Host @"
 验证清单：

package/install.sh

@@ -45,6 +45,40 @@ warn()   { printf '%b\n' "${C_YELLOW}⚠${C_RESET}  $*"; }
 err()    { printf '%b\n' "${C_RED}✗${C_RESET} $*" >&2; }
 hr()     { printf '%b\n' "${C_BOLD}────────────────────────────────────────────────${C_RESET}"; }
 
+# ────────────── ADR-0050: WSL 路径错位拒绝（先于参数解析，用原始 $* 检测 --uninstall） ──────────────
+# 防止在 WSL 中 $HOME 落在 /mnt/c|d|e/Users/ 导致 codeforge 配置写到
+# Windows 文件系统（NTFS 性能差、权限模型不同、git/symlink 行为异常）。
+#
+# 触发条件：
+#   - 系统真存在 wslpath 命令（WSL 环境标志），或
+#   - 测试旁路 CODEFORGE_FORCE_WSL_CHECK=1（CI/单测中强制走分支）
+#
+# 用户逃生口：
+#   - CODEFORGE_ALLOW_WSL_WINDOWS_HOME=1 → 强制继续（不推荐）
+#   - --uninstall 参数 → guard 整段跳过（用户可能就是要从错位位置清理掉，
+#     ADR-0050 / reviewer Phase 3 #3：卸载场景必须能跑通）
+#
+# 这里用 `$*` 原始参数串做模式匹配，**不依赖**下方 while 循环解析出的 ACTION
+# 变量，因为本段必须在参数解析之前执行（错位路径下连参数解析的 set -u 都可能
+# 因为环境异常而炸，guard 必须最早跑）。
+if [[ " $* " != *" --uninstall "* ]]; then
+  if command -v wslpath >/dev/null 2>&1 || [[ "${CODEFORGE_FORCE_WSL_CHECK:-}" == "1" ]]; then
+    case "$HOME" in
+      /mnt/c/*|/mnt/d/*|/mnt/e/*)
+        err "在 WSL 中检测到 \$HOME=$HOME 落在 Windows 挂载路径下"
+        err "这会导致 codeforge 配置写到 Windows 文件系统，引发权限 / 性能 / 路径转换问题"
+        err "请改用 WSL 原生 home（通常是 /home/<user>/），或在 /etc/wsl.conf 中显式设置 default=<linux-user>"
+        err "如确实需要继续，设置环境变量 CODEFORGE_ALLOW_WSL_WINDOWS_HOME=1 跳过检查（不推荐）"
+        err "如果你是想卸载之前装错位置的 codeforge，加 --uninstall 参数会跳过本检查"
+        if [[ "${CODEFORGE_ALLOW_WSL_WINDOWS_HOME:-}" != "1" ]]; then
+          exit 1
+        fi
+        warn "已通过 CODEFORGE_ALLOW_WSL_WINDOWS_HOME=1 跳过 WSL 路径检查（请确保你清楚后果）"
+        ;;
+    esac
+  fi
+fi
+
 # ────────────── 参数 ──────────────
 MODE="project"
 ACTION="install"
@@ -67,6 +101,7 @@ while [[ $# -gt 0 ]]; do
   shift
 done
 
+
 # ────────────── 路径解析 ──────────────
 SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
 SOURCE_ROOT="$SCRIPT_DIR"
@@ -353,6 +388,14 @@ run "cp -f '$BUNDLE_SRC' '$BUNDLE_DST'"
 ok "bundle → $BUNDLE_DST"
 write_plugin_entry
 
+# 写 VERSION marker 文件（用户 cat 一行查版本，不依赖 grep bundle）
+CF_VERSION="$(node -e "console.log(require('$SOURCE_ROOT/package.json').version)" 2>/dev/null || echo "unknown")"
+VERSION_FILE="$TARGET_ROOT/codeforge/VERSION"
+if [[ $DRY_RUN -eq 0 ]]; then
+  printf "%s\n" "$CF_VERSION" > "$VERSION_FILE"
+fi
+ok "VERSION → ${VERSION_FILE} (${CF_VERSION})"
+
 # Step 5/7: 装 agents / commands / workflows / context-templates
 log "Step 5/7: 装 agents / commands / workflows / context-templates"
 for entry in "${MD_COPY_DIRS[@]}"; do
@@ -407,7 +450,7 @@ fi
 
 # 验证清单
 hr
-ok "${C_BOLD}CodeForge 安装完成（v0.1+ 单 bundle 架构）${C_RESET}"
+ok "${C_BOLD}CodeForge v${CF_VERSION} 安装完成${C_RESET}"
 hr
 cat <<EOF
 ${C_BOLD}验证清单：${C_RESET}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andyqiu/codeforge",
-  "version": "0.3.4",
+  "version": "0.3.5",
   "description": "CodeForge — opencode 的零侵入扩展包",
   "type": "module",
   "private": false,
@@ -14,7 +14,8 @@
     "codeforge"
   ],
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.0.0",
+    "git": ">=2.28.0"
   },
   "main": "./dist/index.js",
   "exports": {
@@ -59,6 +60,10 @@
     "replay": "node ./scripts/codeforge-replay.mjs",
     "release": "node ./scripts/release.mjs",
     "release:dry": "node ./scripts/release.mjs --dry-run",
+    "publish:patch": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/publish.ps1",
+    "publish:minor": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/publish.ps1 -Minor",
+    "publish:major": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/publish.ps1 -Major",
+    "publish:dry": "powershell -NoProfile -ExecutionPolicy Bypass -File ./scripts/publish.ps1 -DryRun",
     "prepublishOnly": "npm run build && npm run typecheck && npm test",
     "prepare": "husky"
   },