@liangjie559567/ultrapower 5.0.19 → 5.0.21

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "ultrapower",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution. Combines superpowers' TDD/debugging discipline with OMC's multi-agent execution capabilities.",
-  "version": "5.0.19",
+  "version": "5.0.21",
   "author": {
     "name": "Jesse Vincent & oh-my-claudecode contributors"
   },

package/docs/CLAUDE.md

@@ -1,5 +1,5 @@
 <!-- OMC:START -->
-<!-- OMC:VERSION:5.0.19 -->
+<!-- OMC:VERSION:5.0.21 -->
 # ultrapower - Multi-Agent Orchestration 智能多 Agent 编排
 
 你正在使用 ultrapower（OMC），这是 Claude Code 的多 agent 编排层。

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangjie559567/ultrapower",
-  "version": "5.0.19",
+  "version": "5.0.21",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
   "type": "module",
   "main": "dist/index.js",

package/scripts/plugin-setup.mjs

@@ -19,9 +19,12 @@ const SETTINGS_FILE = join(CLAUDE_DIR, 'settings.json');
 
 console.log('[OMC] Running post-install setup...');
 
-// Fix: flatten nested cache directories caused by installer wrapping content in plugin-name subdir.
-// The installer places npm package contents under cache/.../VERSION/ultrapower/ instead of cache/.../VERSION/
-// This function detects and fixes that by moving contents up one level.
+// Fix: flatten nested cache directories caused by Claude Code installer bug.
+// Root cause: xF6(src, dest) copies src contents to dest, but dest is a subdirectory of src.
+// After mkdir -p dest, readdir(src) includes the newly created dest subdir, causing recursive copy.
+// Result: cache/.../VERSION/ultrapower/VERSION/ultrapower/VERSION/... infinite nesting.
+// This function detects and fixes arbitrary-depth nesting by finding the real plugin content
+// and moving it up to the version directory, then removing all nested dirs.
 function fixNestedCacheDir() {
   try {
     const pluginCacheBase = join(CLAUDE_DIR, 'plugins/cache/ultrapower/ultrapower');
@@ -31,25 +34,51 @@ function fixNestedCacheDir() {
       const versionDir = join(pluginCacheBase, version);
       const nestedDir = join(versionDir, 'ultrapower');
       if (!existsSync(nestedDir)) continue;
-      // Check if the nested dir itself has the actual plugin content (skills/, dist/, etc.)
-      const nestedContents = readdirSync(nestedDir);
-      // If nested dir is empty (leftover from previous fix), just remove it
-      if (nestedContents.length === 0) {
-        rmSync(nestedDir, { recursive: true, force: true });
-        console.log(`[OMC] Removed empty nested dir for version ${version}`);
-        continue;
+
+      // Walk down the nesting to find the real plugin content (arbitrary depth)
+      // Real content has skills/, dist/, agents/, or hooks/ directly inside
+      const PLUGIN_MARKERS = ['skills', 'dist', 'agents', 'hooks'];
+      let realContentDir = null;
+      let searchDir = nestedDir;
+      let depth = 0;
+      while (depth < 20) {
+        const contents = readdirSync(searchDir);
+        if (contents.length === 0) {
+          // Empty dir - just remove it
+          rmSync(nestedDir, { recursive: true, force: true });
+          console.log(`[OMC] Removed empty nested dir for version ${version}`);
+          break;
+        }
+        if (contents.some(f => PLUGIN_MARKERS.includes(f))) {
+          realContentDir = searchDir;
+          break;
+        }
+        // Go deeper: look for ultrapower/ or version/ subdir
+        const nextDir = join(searchDir, 'ultrapower');
+        const nextVerDir = join(searchDir, version);
+        if (existsSync(nextDir)) {
+          searchDir = nextDir;
+        } else if (existsSync(nextVerDir)) {
+          searchDir = nextVerDir;
+        } else {
+          break;
+        }
+        depth++;
       }
-      const hasPluginContent = nestedContents.some(f => ['skills', 'dist', 'agents', 'hooks'].includes(f));
-      if (!hasPluginContent) continue;
-      console.log(`[OMC] Fixing nested cache dir for version ${version}...`);
-      // Move contents of nestedDir up to versionDir, then remove nestedDir
-      for (const item of nestedContents) {
-        const src = join(nestedDir, item);
+
+      if (!realContentDir) continue;
+
+      console.log(`[OMC] Fixing nested cache dir for version ${version} (depth ${depth})...`);
+      // Move contents of realContentDir up to versionDir
+      const realContents = readdirSync(realContentDir);
+      for (const item of realContents) {
+        const src = join(realContentDir, item);
         const dest = join(versionDir, item);
         if (!existsSync(dest)) {
           renameSync(src, dest);
         }
       }
+      // Remove the entire nested ultrapower/ subtree
       rmSync(nestedDir, { recursive: true, force: true });
       console.log(`[OMC] Fixed nested cache dir for version ${version}`);
     }

package/skills/omc-doctor/SKILL.md

@@ -71,6 +71,36 @@ if(f.existsSync(npmCachePkg)){
 - `MISMATCH: dir=X pkg.version=Y`：严重错误——npm-cache 复用导致旧内容被安装到新版本目录
 - npm-cache range 显示旧版本范围（如 `^5.0.11`）：警告——下次安装仍会复用旧缓存
 
+### 第一步 ter：检查无限嵌套缓存目录
+
+检查插件缓存目录是否存在无限嵌套（Claude Code 安装器 `xF6` bug 导致）：
+
+```bash
+node -e "
+const p=require('path'),f=require('fs'),h=require('os').homedir();
+const d=process.env.CLAUDE_CONFIG_DIR||p.join(h,'.claude');
+const b=p.join(d,'plugins','cache','ultrapower','ultrapower');
+try {
+  const vs=f.readdirSync(b).filter(x=>/^\d/.test(x));
+  let found=false;
+  for(const v of vs){
+    const nested=p.join(b,v,'ultrapower');
+    if(f.existsSync(nested)){
+      console.log('CRITICAL: nested dir found: '+nested);
+      found=true;
+    }
+  }
+  if(!found) console.log('OK: no nested ultrapower/ dirs found');
+} catch(e){console.log('Cache not found (normal if not installed)');}
+"
+```
+
+**诊断**：
+- `CRITICAL: nested dir found`：严重错误——安装器 `xF6` bug 导致无限嵌套，插件内容可能损坏
+  - 根本原因：`xF6(src, dest)` 先 `mkdir -p dest`，再 `readdir(src)`；因 `dest` 是 `src` 子目录，readdir 包含刚创建的子目录，递归复制时把自身复制进去
+  - 加剧因素：`PM1()` 检测目标非空则跳过复制，嵌套一旦产生安装器永远不会自动修复
+  - 自动修复：5.0.20+ 的 `postinstall` 脚本会自动检测并修复任意深度嵌套
+
 ### 第二步：检查 settings.json 中的旧版 hook
 
 读取 `~/.claude/settings.json`（用户级）和 `./.claude/settings.json`（项目级），检查是否存在包含以下条目的 `"hooks"` 键：
@@ -157,6 +187,7 @@ ls -la ~/.claude/skills/ 2>/dev/null
 |-------|--------|---------|
 | 插件版本 | OK/WARN/CRITICAL | ... |
 | npm-cache 复用 | OK/WARN/CRITICAL | ... |
+| 无限嵌套缓存 | OK/CRITICAL | ... |
 | 旧版 Hook (settings.json) | OK/CRITICAL | ... |
 | 旧版脚本 (~/.claude/hooks/) | OK/WARN | ... |
 | CLAUDE.md | OK/WARN/CRITICAL | ... |
@@ -198,6 +229,21 @@ rm -f ~/.claude/hooks/stop-continuation.sh
 node -e "const p=require('path'),f=require('fs'),d=process.env.CLAUDE_CONFIG_DIR||p.join(require('os').homedir(),'.claude'),b=p.join(d,'plugins','cache','omc','ultrapower');try{f.rmSync(b,{recursive:true,force:true});console.log('Plugin cache cleared. Restart Claude Code to fetch latest version.')}catch{console.log('No plugin cache found')}"
 ```
 
+### 修复：无限嵌套缓存目录
+
+症状：`versionDir/ultrapower/` 子目录存在，插件内容可能损坏。
+
+```bash
+# 完整清洁重装（5.0.20+ postinstall 会自动修复残留嵌套）
+claude plugin uninstall ultrapower
+rm -rf ~/.claude/plugins/npm-cache
+rm -rf ~/.claude/plugins/cache/ultrapower
+claude plugin marketplace update ultrapower
+claude plugin install ultrapower
+```
+
+> ✅ 安装 5.0.20+ 后，`postinstall` 脚本会自动检测并修复任意深度嵌套，无需手动干预。
+
 ### 修复：npm-cache 复用（插件内容是旧版本）
 
 症状：插件缓存目录版本号与 `package.json` 内 `version` 字段不一致。

package/skills/release/SKILL.md

@@ -128,26 +128,33 @@ ls ~/.claude/plugins/cache/ultrapower/ultrapower/<version>/skills/
 
 症状：`cache/ultrapower/ultrapower/5.x.x/ultrapower/5.x.x/ultrapower/...`
 
-原因：npm 包中包含了 `ultrapower/` 子目录（通常是缓存目录被打包进去）。
+**根本原因（已确认）**：Claude Code 安装器的 `xF6(src, dest)` 函数存在 bug：
+1. 先执行 `mkdir -p dest`（`dest = cache/ultrapower/ultrapower/5.x.x`）
+2. 再执行 `readdir(src)`（`src = cache/ultrapower`）
+3. 由于 `dest` 是 `src` 的子目录，`readdir` 结果包含刚创建的 `ultrapower/` 子目录
+4. 递归复制时把自身也复制进去，产生无限嵌套
 
-修复步骤：
-```bash
-# 1. 卸载插件
-claude plugin uninstall ultrapower
+**加剧因素**：`PM1()` 检查目标目录是否非空，非空则跳过复制（认为已缓存）。一旦嵌套产生，安装器永远不会自动修复。
 
-# 2. 清除缓存
+**自动修复**：5.0.20+ 的 `postinstall` 脚本（`fixNestedCacheDir()`）会自动检测并修复任意深度嵌套。
+
+手动修复步骤：
+```bash
+# 1. 清除嵌套的缓存目录
 rm -rf ~/.claude/plugins/cache/ultrapower
-rm -rf ~/.claude/plugins/marketplaces/ultrapower
 
-# 3. 确认 .npmignore 已排除 ultrapower/ 目录
+# 2. 清除 npm-cache（防止复用旧内容）
+rm -rf ~/.claude/plugins/npm-cache
 
-# 4. 重新发布（需升级版本号）
-npm publish --access public
+# 3. 刷新 marketplace 缓存
+claude plugin marketplace update ultrapower
 
-# 5. 重新安装
+# 4. 重新安装（postinstall 会自动修复任何残留嵌套）
 claude plugin install ultrapower
 ```
 
+> ⚠️ `.npmignore` 中的 `ultrapower/` 排除项仍然必要，防止开发目录被打包进 npm 包。
+
 ### 安装后仍是旧版本
 
 原因：本地 marketplace 缓存未更新，安装器读取的是旧版 `marketplace.json`。