@liangjie559567/ultrapower 5.2.4 → 5.2.6

package/docs/superpowers/specs/AGENTS.md

@@ -1,26 +1,26 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# docs/superpowers/specs/
-
-## Purpose
-Superpowers 规格文档目录。包含 superpowers 功能的技术规格文档，定义接口和行为规范。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `*.md` | 规格文档文件 |
-
-## For AI Agents
-
-### 修改此目录时
-- 参见父级目录了解整体结构
-- 遵循项目编码规范
-
-## Dependencies
-
-### Internal
-- `docs/superpowers/` — 相关模块
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/superpowers/specs/
+
+## Purpose
+Superpowers 规格文档目录。包含 superpowers 功能的技术规格文档，定义接口和行为规范。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `*.md` | 规格文档文件 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见父级目录了解整体结构
+- 遵循项目编码规范
+
+## Dependencies
+
+### Internal
+- `docs/superpowers/` — 相关模块
+
+<!-- MANUAL: -->

package/docs/tasks/ultrapower-standards/AGENTS.md

@@ -1,27 +1,27 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# docs/tasks/ultrapower-standards/
-
-## Purpose
-Ultrapower 标准任务文档目录。包含 ultrapower 标准规范的任务追踪文档和 manifest 清单。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `manifest.md` | 任务 manifest 清单，定义标准规范的实施任务 |
-
-## For AI Agents
-
-### 修改此目录时
-- 参见父级目录了解整体结构
-- 遵循项目编码规范
-
-## Dependencies
-
-### Internal
-- `docs/tasks/` — 相关模块
-- `docs/standards/` — 相关模块
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# docs/tasks/ultrapower-standards/
+
+## Purpose
+Ultrapower 标准任务文档目录。包含 ultrapower 标准规范的任务追踪文档和 manifest 清单。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `manifest.md` | 任务 manifest 清单，定义标准规范的实施任务 |
+
+## For AI Agents
+
+### 修改此目录时
+- 参见父级目录了解整体结构
+- 遵循项目编码规范
+
+## Dependencies
+
+### Internal
+- `docs/tasks/` — 相关模块
+- `docs/standards/` — 相关模块
+
+<!-- MANUAL: -->

package/package.json

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

package/scripts/plugin-setup.mjs

@@ -116,10 +116,31 @@ function copyTemplatesToCache() {
       return;
     }
 
-    const entries = readdirSync(pluginCacheBase, { withFileTypes: true });
-    for (const entry of entries) {
-      if (!entry.isDirectory()) continue;
-      const version = entry.name;
+    // Collect version directories to copy into.
+    // If the cache base exists but is empty (Claude Code hasn't populated it yet),
+    // fall back to the package version so we can pre-populate the correct directory.
+    let versions = readdirSync(pluginCacheBase, { withFileTypes: true })
+      .filter(e => e.isDirectory())
+      .map(e => e.name);
+
+    if (versions.length === 0) {
+      // Cache dir exists but is empty — read version from package.json and create the dir
+      try {
+        const pkgPath = join(pluginRoot, 'package.json');
+        const pkg = JSON.parse(readFileSync(pkgPath, 'utf-8'));
+        const pkgVersion = pkg.version;
+        if (pkgVersion) {
+          const versionDir = join(pluginCacheBase, pkgVersion);
+          mkdirSync(versionDir, { recursive: true });
+          versions = [pkgVersion];
+          console.log(`[OMC] Plugin cache was empty — created version dir for v${pkgVersion}`);
+        }
+      } catch (pkgErr) {
+        console.log('[OMC] Warning: Could not read package.json to determine version:', pkgErr.message);
+      }
+    }
+
+    for (const version of versions) {
       const cacheVersionDir = join(pluginCacheBase, version);
       const destTemplatesHooks = join(cacheVersionDir, 'templates', 'hooks');
       if (!existsSync(destTemplatesHooks)) {

package/scripts/release-local.mjs

@@ -0,0 +1,27 @@
+// scripts/release-local.mjs
+// 用法:
+//   node scripts/release-local.mjs
+//   node scripts/release-local.mjs --dry-run
+//   node scripts/release-local.mjs --start-from=publish
+//   npm run release:local
+//   npm run release:dry-run
+
+import { runReleasePipeline } from './release-steps.mjs';
+
+export function parseArgs(argv) {
+  const dryRun = argv.includes('--dry-run');
+  const startFromArg = argv.find(a => a.startsWith('--start-from='));
+  const startFrom = startFromArg ? startFromArg.split('=')[1] : 'validate';
+  const skipTests = argv.includes('--skip-tests');
+  return { dryRun, startFrom, skipTests };
+}
+
+// 仅在直接执行时运行（非 import）
+if (process.argv[1] && process.argv[1].endsWith('release-local.mjs')) {
+  const args = parseArgs(process.argv.slice(2));
+  console.log(`Running release pipeline (dryRun=${args.dryRun}, startFrom=${args.startFrom})`);
+  runReleasePipeline(args).catch(err => {
+    console.error(err);
+    process.exit(1);
+  });
+}

package/scripts/release-steps.mjs

@@ -0,0 +1,121 @@
+// scripts/release-steps.mjs
+import { execSync } from 'node:child_process';
+import { readFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+function getVersion() {
+  const pkg = JSON.parse(readFileSync(resolve('package.json'), 'utf-8'));
+  return pkg.version;
+}
+
+function run(cmd, dryRun = false) {
+  if (dryRun) {
+    console.log(`[dry-run] ${cmd}`);
+    return '';
+  }
+  return execSync(cmd, { stdio: 'pipe', encoding: 'utf-8' });
+}
+
+export async function validateBuild(opts = {}) {
+  const { skipTests = false, dryRun = false } = opts;
+  try {
+    run('tsc --noEmit', dryRun);
+    run('npm run build', dryRun);
+    if (!skipTests) run('npm run test:run', dryRun);
+    return { success: true, output: 'Build validation passed' };
+  } catch (err) {
+    return { success: false, output: err.message };
+  }
+}
+
+export async function publishNpm(opts = {}) {
+  const { dryRun = false, tag = 'latest' } = opts;
+  const version = getVersion();
+  try {
+    run(`npm publish --access public --tag ${tag}`, dryRun);
+    return { success: true, version };
+  } catch (err) {
+    return { success: false, version, output: err.message };
+  }
+}
+
+export async function createGithubRelease(opts = {}) {
+  const { version, notes = '', dryRun = false } = opts;
+  const v = version || getVersion();
+  try {
+    const notesFlag = notes ? `--notes "${notes}"` : '--generate-notes';
+    run(`gh release create v${v} ${notesFlag}`, dryRun);
+    return { success: true, url: `https://github.com/liangjie559567/ultrapower/releases/tag/v${v}` };
+  } catch (err) {
+    return { success: false, url: '', output: err.message };
+  }
+}
+
+export async function syncMarketplace(opts = {}) {
+  const { version, dryRun = false } = opts;
+  const v = version || getVersion();
+  try {
+    run(`git add .claude-plugin/marketplace.json`, dryRun);
+    run(`git commit -m "chore: sync marketplace version to v${v}" --allow-empty`, dryRun);
+    run(`git push origin HEAD`, dryRun);
+    return { success: true };
+  } catch (err) {
+    return { success: false, output: err.message };
+  }
+}
+
+export async function runReleasePipeline(opts = {}) {
+  const { dryRun = false, skipTests = false, startFrom = 'validate', version } = opts;
+  const steps = ['validate', 'publish', 'release', 'sync'];
+  const startIdx = steps.indexOf(startFrom);
+
+  if (startIdx === -1) {
+    console.error(`Unknown startFrom: ${startFrom}. Valid: ${steps.join(', ')}`);
+    process.exit(1);
+  }
+
+  const v = version || getVersion();
+
+  if (startIdx <= 0) {
+    console.log('Step 1/4: validateBuild...');
+    const r = await validateBuild({ skipTests, dryRun });
+    if (!r.success) { console.error(`validateBuild failed: ${r.output}`); process.exit(1); }
+  }
+
+  if (startIdx <= 1) {
+    console.log('Step 2/4: publishNpm...');
+    const r = await publishNpm({ dryRun });
+    if (!r.success) { console.error(`publishNpm failed: ${r.output}`); process.exit(1); }
+  }
+
+  if (startIdx <= 2) {
+    console.log('Step 3/4: createGithubRelease...');
+    const r = await createGithubRelease({ version: v, dryRun });
+    if (!r.success) { console.error(`createGithubRelease failed: ${r.output}`); process.exit(1); }
+  }
+
+  if (startIdx <= 3) {
+    console.log('Step 4/4: syncMarketplace...');
+    const r = await syncMarketplace({ version: v, dryRun });
+    if (!r.success) { console.error(`syncMarketplace failed: ${r.output}`); process.exit(1); }
+  }
+
+  console.log('Release pipeline completed successfully.');
+  return { success: true };
+}
+
+// CLI entry point (for direct GitHub Actions invocation)
+const cliStep = process.argv[2];
+if (cliStep && ['validate', 'publish', 'release', 'sync'].includes(cliStep)) {
+  const dryRun = process.argv.includes('--dry-run');
+  const version = process.env.GITHUB_REF_NAME?.replace(/^v/, '') || undefined;
+  const stepMap = {
+    validate: validateBuild,
+    publish: publishNpm,
+    release: createGithubRelease,
+    sync: syncMarketplace,
+  };
+  stepMap[cliStep]({ dryRun, version }).then(r => {
+    if (!r.success) { console.error(`Step ${cliStep} failed`); process.exit(1); }
+  });
+}

package/skills/analyze/AGENTS.md

@@ -1,28 +1,28 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# skills/analyze/
-
-## Purpose
-深度分析与调试 skill。触发 debugger agent 进行根因分析、回归隔离和故障诊断。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
-
-## For AI Agents
-
-### 修改此目录时
-- 编辑 `SKILL.md` 修改 skill 行为
-- 触发关键词变更需同步更新 `src/features/magic-keywords/`
-- 参见 `skills/writing-skills/` 了解 skill 编写规范
-
-## Dependencies
-
-### Internal
-- `src/skills/` — Skill TypeScript 运行时注册
-- `src/features/magic-keywords/` — 关键词触发系统
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/analyze/
+
+## Purpose
+深度分析与调试 skill。触发 debugger agent 进行根因分析、回归隔离和故障诊断。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/autopilot/AGENTS.md

@@ -1,28 +1,28 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# skills/autopilot/
-
-## Purpose
-全自主执行 skill。从想法到可运行代码的端到端自主执行，支持转换为 ralph 或 ultraqa 模式。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
-
-## For AI Agents
-
-### 修改此目录时
-- 编辑 `SKILL.md` 修改 skill 行为
-- 触发关键词变更需同步更新 `src/features/magic-keywords/`
-- 参见 `skills/writing-skills/` 了解 skill 编写规范
-
-## Dependencies
-
-### Internal
-- `src/skills/` — Skill TypeScript 运行时注册
-- `src/features/magic-keywords/` — 关键词触发系统
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/autopilot/
+
+## Purpose
+全自主执行 skill。从想法到可运行代码的端到端自主执行，支持转换为 ralph 或 ultraqa 模式。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ax-analyze-error/AGENTS.md

@@ -1,28 +1,28 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# skills/ax-analyze-error/
-
-## Purpose
-Axiom 错误分析工作流 skill。执行根因诊断 → 自动修复 → 知识入队的完整错误处理流程。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
-
-## For AI Agents
-
-### 修改此目录时
-- 编辑 `SKILL.md` 修改 skill 行为
-- 触发关键词变更需同步更新 `src/features/magic-keywords/`
-- 参见 `skills/writing-skills/` 了解 skill 编写规范
-
-## Dependencies
-
-### Internal
-- `src/skills/` — Skill TypeScript 运行时注册
-- `src/features/magic-keywords/` — 关键词触发系统
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-analyze-error/
+
+## Purpose
+Axiom 错误分析工作流 skill。执行根因诊断 → 自动修复 → 知识入队的完整错误处理流程。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ax-context/AGENTS.md

@@ -1,28 +1,28 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# skills/ax-context/
-
-## Purpose
-Axiom 上下文管理器 skill。读取/保存短期记忆、长期记忆和状态机，维护跨会话任务状态。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
-
-## For AI Agents
-
-### 修改此目录时
-- 编辑 `SKILL.md` 修改 skill 行为
-- 触发关键词变更需同步更新 `src/features/magic-keywords/`
-- 参见 `skills/writing-skills/` 了解 skill 编写规范
-
-## Dependencies
-
-### Internal
-- `src/skills/` — Skill TypeScript 运行时注册
-- `src/features/magic-keywords/` — 关键词触发系统
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-context/
+
+## Purpose
+Axiom 上下文管理器 skill。读取/保存短期记忆、长期记忆和状态机，维护跨会话任务状态。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ax-decompose/AGENTS.md

@@ -1,28 +1,28 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# skills/ax-decompose/
-
-## Purpose
-Axiom 任务拆解工作流 skill。将 Rough PRD 转化为系统架构 → 原子任务 DAG → Manifest 清单。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
-
-## For AI Agents
-
-### 修改此目录时
-- 编辑 `SKILL.md` 修改 skill 行为
-- 触发关键词变更需同步更新 `src/features/magic-keywords/`
-- 参见 `skills/writing-skills/` 了解 skill 编写规范
-
-## Dependencies
-
-### Internal
-- `src/skills/` — Skill TypeScript 运行时注册
-- `src/features/magic-keywords/` — 关键词触发系统
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-decompose/
+
+## Purpose
+Axiom 任务拆解工作流 skill。将 Rough PRD 转化为系统架构 → 原子任务 DAG → Manifest 清单。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->

package/skills/ax-draft/AGENTS.md

@@ -1,28 +1,28 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
-
-# skills/ax-draft/
-
-## Purpose
-Axiom 需求起草工作流 skill。执行需求澄清循环 → PRD 初稿生成 → 用户评审门禁流程。
-
-## Key Files
-
-| File | Description |
-|------|-------------|
-| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
-
-## For AI Agents
-
-### 修改此目录时
-- 编辑 `SKILL.md` 修改 skill 行为
-- 触发关键词变更需同步更新 `src/features/magic-keywords/`
-- 参见 `skills/writing-skills/` 了解 skill 编写规范
-
-## Dependencies
-
-### Internal
-- `src/skills/` — Skill TypeScript 运行时注册
-- `src/features/magic-keywords/` — 关键词触发系统
-
-<!-- MANUAL: -->
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-02-27 | Updated: 2026-02-27 -->
+
+# skills/ax-draft/
+
+## Purpose
+Axiom 需求起草工作流 skill。执行需求澄清循环 → PRD 初稿生成 → 用户评审门禁流程。
+
+## Key Files
+
+| File | Description |
+|------|-------------|
+| `SKILL.md` | Skill 定义文件，包含触发条件、执行工作流和使用说明 |
+
+## For AI Agents
+
+### 修改此目录时
+- 编辑 `SKILL.md` 修改 skill 行为
+- 触发关键词变更需同步更新 `src/features/magic-keywords/`
+- 参见 `skills/writing-skills/` 了解 skill 编写规范
+
+## Dependencies
+
+### Internal
+- `src/skills/` — Skill TypeScript 运行时注册
+- `src/features/magic-keywords/` — 关键词触发系统
+
+<!-- MANUAL: -->