@liangjie559567/ultrapower 5.0.16 → 5.0.17

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.16",
+  "version": "5.0.17",
   "author": {
     "name": "Jesse Vincent & oh-my-claudecode contributors"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangjie559567/ultrapower",
-  "version": "5.0.16",
+  "version": "5.0.17",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,8 @@
     "sync-metadata:verify": "tsx scripts/sync-metadata.ts --verify",
     "sync-metadata:dry-run": "tsx scripts/sync-metadata.ts --dry-run",
     "prepare": "npm run build",
-    "prepublishOnly": "npm run build && npm run compose-docs"
+    "prepublishOnly": "npm run build && npm run compose-docs",
+    "postinstall": "node scripts/plugin-setup.mjs"
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.0",

package/scripts/plugin-setup.mjs

@@ -54,6 +54,66 @@ function fixNestedCacheDir() {
 
 fixNestedCacheDir();
 
+// Fix: npm install strips hidden directories (starting with '.'), so .claude-plugin/plugin.json
+// is never extracted to the plugin cache. We recreate it directly in the plugin cache.
+// The postinstall script runs from the npm-cache node_modules dir, so we must target the
+// plugin cache path explicitly rather than relying on __dirname.
+function fixMissingPluginJson() {
+  try {
+    const pluginRoot = dirname(__dirname);
+    const pkgPath = join(pluginRoot, 'package.json');
+    if (!existsSync(pkgPath)) return;
+    const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+    const version = pkg.version || '0.0.0';
+
+    const pluginJson = {
+      name: 'ultrapower',
+      description: pkg.description || '',
+      version,
+      author: pkg.author ? { name: typeof pkg.author === 'string' ? pkg.author : pkg.author.name } : undefined,
+      homepage: pkg.homepage || '',
+      repository: pkg.repository?.url || pkg.repository || '',
+      license: pkg.license || 'MIT',
+      keywords: pkg.keywords || [],
+      skills: './skills/',
+      mcpServers: './.mcp.json'
+    };
+    const pluginJsonStr = JSON.stringify(pluginJson, null, 2);
+
+    // 1. Write to current install location (npm-cache node_modules dir)
+    const localPluginJsonDir = join(pluginRoot, '.claude-plugin');
+    const localPluginJsonPath = join(localPluginJsonDir, 'plugin.json');
+    if (!existsSync(localPluginJsonPath)) {
+      mkdirSync(localPluginJsonDir, { recursive: true });
+      writeFileSync(localPluginJsonPath, pluginJsonStr);
+      console.log('[OMC] Created .claude-plugin/plugin.json in install dir');
+    }
+
+    // 2. Write directly to plugin cache (marketplace: ultrapower, plugin: ultrapower)
+    // Claude Code copies from npm-cache but skips hidden dirs, so we patch the cache directly.
+    const pluginCacheBase = join(CLAUDE_DIR, 'plugins/cache/ultrapower/ultrapower');
+    if (existsSync(pluginCacheBase)) {
+      const versions = readdirSync(pluginCacheBase);
+      for (const v of versions) {
+        const cacheVersionDir = join(pluginCacheBase, v);
+        const cachePluginJsonDir = join(cacheVersionDir, '.claude-plugin');
+        const cachePluginJsonPath = join(cachePluginJsonDir, 'plugin.json');
+        if (!existsSync(cachePluginJsonPath)) {
+          mkdirSync(cachePluginJsonDir, { recursive: true });
+          // Use version-specific content for each cached version
+          const versionedPkg = { ...pluginJson, version: v };
+          writeFileSync(cachePluginJsonPath, JSON.stringify(versionedPkg, null, 2));
+          console.log(`[OMC] Created .claude-plugin/plugin.json in plugin cache v${v}`);
+        }
+      }
+    }
+  } catch (e) {
+    console.log('[OMC] Warning: Could not create .claude-plugin/plugin.json:', e.message);
+  }
+}
+
+fixMissingPluginJson();
+
 // 1. Create HUD directory
 if (!existsSync(HUD_DIR)) {
   mkdirSync(HUD_DIR, { recursive: true });

package/skills/release/SKILL.md

@@ -20,13 +20,16 @@ description: ultrapower 的自动化发布工作流
 按顺序执行以下步骤：
 
 ### 1. 版本升级
-在所有位置更新版本：
+在所有位置更新版本（**必须同步，缺一不可**）：
 - `package.json`
 - `src/installer/index.ts`（VERSION 常量）
 - `src/__tests__/installer.test.ts`（预期版本）
 - `.claude-plugin/plugin.json`
+- `.claude-plugin/marketplace.json`（`"version"` 和 `"source.version"` 两处）
 - `README.md`（版本徽章和标题）
 
+> ⚠️ `marketplace.json` 是安装器读取的入口，版本不同步会导致用户始终安装旧版本。
+
 ### 2. 运行测试
 ```bash
 npm run test:run
@@ -46,17 +49,24 @@ git push origin main
 git push origin v<version>
 ```
 
-### 5. 发布到 npm
+### 5. 刷新本地 marketplace 缓存
+```bash
+claude plugin marketplace update ultrapower
+```
+> 推送到 GitHub 后必须执行此步，否则本地安装器仍读取旧版 `marketplace.json`。
+
+### 6. 发布到 npm
 ```bash
 npm publish --access public
 ```
+> ⚠️ npm 不允许覆盖已发布版本，版本号必须先升级再发布。
 
-### 6. 创建 GitHub Release
+### 7. 创建 GitHub Release
 ```bash
 gh release create v<version> --title "v<version> - <title>" --notes "<release notes>"
 ```
 
-### 7. 验证
+### 8. 验证
 - [ ] npm: https://www.npmjs.com/package/@liangjie559567/ultrapower
 - [ ] GitHub: https://github.com/liangjie559567/ultrapower/releases
 
@@ -68,6 +78,7 @@ gh release create v<version> --title "v<version> - <title>" --notes "<release no
 | `src/installer/index.ts` | `export const VERSION = 'X.Y.Z'` |
 | `src/__tests__/installer.test.ts` | `expect(VERSION).toBe('X.Y.Z')` |
 | `.claude-plugin/plugin.json` | `"version": "X.Y.Z"` |
+| `.claude-plugin/marketplace.json` | `"version": "X.Y.Z"` 和 `"source": { "version": "X.Y.Z" }` |
 | `README.md` | 标题 + 版本徽章 |
 
 ## 语义化版本
@@ -80,7 +91,70 @@ gh release create v<version> --title "v<version> - <title>" --notes "<release no
 
 - 发布前始终运行测试
 - 创建总结变更的发布说明
-- 插件市场从 GitHub releases 自动同步
+- 推送到 GitHub 后必须运行 `claude plugin marketplace update ultrapower` 刷新本地缓存
+- npm 不允许覆盖已发布版本，每次发布前必须升级版本号
+- `.npmignore` 必须排除缓存目录（`ultrapower/`、`*.tgz`、`.claude/`），防止安装时产生无限嵌套
+
+## .npmignore 必要内容
+
+发布前确认 `.npmignore` 包含以下排除项：
+
+```
+# 防止缓存目录被打包（会导致安装时无限嵌套）
+ultrapower/
+.claude/
+plugins/cache/
+*.tgz
+*.tar.gz
+node_modules/
+.git/
+dist/
+```
+
+## 故障排查
+
+### 安装后 skill 无法识别
+
+检查插件缓存路径是否正确：
+```bash
+ls ~/.claude/plugins/cache/ultrapower/ultrapower/<version>/skills/
+```
+正确路径应直接包含 `skills/`、`dist/` 等目录。
+
+### 缓存目录无限嵌套
+
+症状：`cache/ultrapower/ultrapower/5.x.x/ultrapower/5.x.x/ultrapower/...`
+
+原因：npm 包中包含了 `ultrapower/` 子目录（通常是缓存目录被打包进去）。
+
+修复步骤：
+```bash
+# 1. 卸载插件
+claude plugin uninstall ultrapower
+
+# 2. 清除缓存
+rm -rf ~/.claude/plugins/cache/ultrapower
+rm -rf ~/.claude/plugins/marketplaces/ultrapower
+
+# 3. 确认 .npmignore 已排除 ultrapower/ 目录
+
+# 4. 重新发布（需升级版本号）
+npm publish --access public
+
+# 5. 重新安装
+claude plugin install ultrapower
+```
+
+### 安装后仍是旧版本
+
+原因：本地 marketplace 缓存未更新，安装器读取的是旧版 `marketplace.json`。
+
+修复：
+```bash
+claude plugin marketplace update ultrapower
+claude plugin uninstall ultrapower
+claude plugin install ultrapower
+```
 
 ## 路由触发