Fix Claude v0.9 upgrade migration

.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "zero-workflow",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Evidence-first research workflow for Codex and Claude Code: collect mixed sources, cross-check claims, write cited reports, and verify every handoff.",
   "author": {
     "name": "Zero Workflow maintainers",

VERSION

@@ -1 +1 @@
-1.0.0
+1.0.1

docs/codebase-context/.scan-meta.json

@@ -1 +1 @@
-{"lastScanTime":"2026-07-23T10:21:00Z","scanType":"full","projectRoot":"."}
+{"lastScanTime":"2026-07-23T10:34:00Z","scanType":"full","projectRoot":"."}

docs/codebase-context/01-overview.md

@@ -10,8 +10,8 @@ Zero Workflow 是 Codex 原生、Claude Code 兼容的证据优先研究工作
 
 | 层 | 技术 | 版本 |
 | ---- | ---- | ---- |
-| 流程语言 | Markdown Skills + runtime contracts | 仓库 v1.0.0 |
-| 插件 | Codex plugin manifest | v1.0.0 |
+| 流程语言 | Markdown Skills + runtime contracts | 仓库 v1.0.1 |
+| 插件 | Codex plugin manifest | v1.0.1 |
 | 安装器 | Bash、PowerShell | macOS/Linux/Windows |
 | 校验 | Python 3、Bash、Gitleaks | 无项目级包依赖 |
 | 主运行时 | Codex | Skills 原生发现 |

docs/codebase-context/09-changelog.md

@@ -4,3 +4,4 @@
 | ---- | ---- | ---- | ---- |
 | 2026-07-23T10:07Z | full | 首次非 npm 全量扫描；31 文件、约 1,560 行 | 全部 10 份 |
 | 2026-07-23T10:21Z | refactor | 更新为 Codex 原生 v1.0.0 双运行时结构、安装器与 CI | 全部 10 份 |
+| 2026-07-23T10:34Z | patch | v1.0.1 清理 v0.9.x 旧命令入口，避免 Claude 重复发现 | 01、09、installation |

docs/installation.md

@@ -25,6 +25,8 @@ Set `CLAUDE_HOME` to test an isolated destination. Use `--yes` to replace
 conflicting files without prompts. The installer copies Skills, runtime
 contracts, the optional agent, scripts, and templates. It also generates
 `/zw:report` and `/zw:check` aliases from portable wrapper filenames.
+When upgrading from v0.9.x, it removes only the old managed `commands/zw.md`
+and R1–R8 node files; unrelated files in `commands/` are preserved.
 
 ## Claude Code on Windows
 

install.ps1

@@ -28,6 +28,35 @@ function Copy-TreeSafely {
 
 Write-Host "Zero Workflow Claude compatibility install v$Version"
 Write-Host "Target: $Dest"
+
+$legacyCommands = @(
+    "commands\zw.md",
+    "commands\zw-report-nodes\R1-init.md",
+    "commands\zw-report-nodes\R2-collect.md",
+    "commands\zw-report-nodes\R3-read.md",
+    "commands\zw-report-nodes\R4-crosscheck.md",
+    "commands\zw-report-nodes\R5-analyze.md",
+    "commands\zw-report-nodes\R6-write.md",
+    "commands\zw-report-nodes\R7-verify.md",
+    "commands\zw-report-nodes\R8-deliver.md"
+)
+$removedLegacy = 0
+foreach ($relative in $legacyCommands) {
+    $legacyPath = Join-Path $Dest $relative
+    if (Test-Path $legacyPath -PathType Leaf) {
+        Remove-Item $legacyPath -Force
+        $removedLegacy += 1
+    }
+}
+$legacyNodeDirectory = Join-Path $Dest "commands\zw-report-nodes"
+if ((Test-Path $legacyNodeDirectory) -and
+    -not (Get-ChildItem $legacyNodeDirectory -Force | Select-Object -First 1)) {
+    Remove-Item $legacyNodeDirectory -Force
+}
+if ($removedLegacy -gt 0) {
+    Write-Host "Removed $removedLegacy legacy managed command files"
+}
+
 foreach ($part in "skills", "agents", "runtime", "scripts", "compat") {
     Copy-TreeSafely (Join-Path $Src $part) (Join-Path $Dest $part) $part
 }

install.sh

@@ -54,10 +54,33 @@ copy_file() {
   echo "Installed $label"
 }
 
+migrate_legacy_commands() {
+  removed=0
+  for relative in \
+    commands/zw.md \
+    commands/zw-report-nodes/R1-init.md \
+    commands/zw-report-nodes/R2-collect.md \
+    commands/zw-report-nodes/R3-read.md \
+    commands/zw-report-nodes/R4-crosscheck.md \
+    commands/zw-report-nodes/R5-analyze.md \
+    commands/zw-report-nodes/R6-write.md \
+    commands/zw-report-nodes/R7-verify.md \
+    commands/zw-report-nodes/R8-deliver.md; do
+    if [ -f "$DEST/$relative" ]; then
+      rm -f "$DEST/$relative"
+      removed=$((removed + 1))
+    fi
+  done
+  rmdir "$DEST/commands/zw-report-nodes" 2>/dev/null || true
+  [ "$removed" -eq 0 ] || echo "Removed $removed legacy managed command files"
+}
+
 echo "Zero Workflow Claude compatibility install v$VERSION"
 echo "Source: $SRC_DIR"
 echo "Target: $DEST"
 
+migrate_legacy_commands
+
 for part in skills agents runtime scripts compat; do
   copy_tree "$SRC_DIR/$part" "$DEST/$part" "$part"
 done