@liangjie559567/ultrapower 5.2.12 → 5.3.0

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

package/.mcp.json

@@ -2,15 +2,15 @@
   "mcpServers": {
     "t": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/bridge/mcp-server.cjs"]
+      "args": ["./bridge/mcp-server.cjs"]
     },
     "x": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/bridge/codex-server.cjs"]
+      "args": ["./bridge/codex-server.cjs"]
     },
     "g": {
       "command": "node",
-      "args": ["${CLAUDE_PLUGIN_ROOT}/bridge/gemini-server.cjs"]
+      "args": ["./bridge/gemini-server.cjs"]
     }
   }
 }

package/docs/ARCHITECTURE.md

@@ -191,12 +191,19 @@ notepad_write_working("full_context", {
 
 ## Hooks
 
-ultrapower 在 `src/hooks/` 中包含 35 个 hook，用于生命周期事件：
+ultrapower 在 `src/hooks/` 中包含 47 个 hook，用于生命周期事件：
 
 | 事件 | 用途 |
 |-------|---------|
 | `UserPromptSubmit` | 关键词检测、模式激活 |
-| `Stop` | 续行强制、会话结束 |
+| `SubagentStop` | 子 agent 完成时触发 |
+| `PreCompact` | 上下文压缩前触发 |
+| `TeammateIdle` | 团队成员空闲时触发 |
+| `SessionEnd` | 会话结束时触发 |
+| `UserPromptSubmit` | 用户提交提示词前触发 |
+| `PermissionRequest` | 工具权限请求时触发 |
+| `TaskCompleted` | 任务完成时触发 |
+| `ConfigChange` | 配置变更时触发 |
 | `PreToolUse` | 权限验证 |
 | `PostToolUse` | 错误恢复、规则注入 |
 

package/docs/REFERENCE.md

@@ -434,7 +434,7 @@ omc config-stop-callback discord --show
 
 ## Hooks System
 
-ultrapower 包含 35 个生命周期 hooks，用于增强 Claude Code 的行为。
+ultrapower 包含 47 个生命周期 hooks，用于增强 Claude Code 的行为。
 
 ### 执行模式 Hooks
 
@@ -467,6 +467,13 @@ ultrapower 包含 35 个生命周期 hooks，用于增强 Claude Code 的行为
 | `recovery` | 编辑错误、会话和上下文窗口恢复 |
 | `preemptive-compaction` | 监控上下文使用量以防止超限 |
 | `pre-compact` | 压缩前处理 |
+| `subagent-stop` | 子 agent 完成时触发，防止无限循环 |
+| `teammate-idle` | 团队成员空闲时触发，默认允许 |
+| `session-end` | 会话结束时触发，清理临时状态 |
+| `user-prompt-submit` | 用户提交提示词前触发，用于关键词检测 |
+| `permission-request` | 工具权限请求时触发 |
+| `task-completed` | 任务完成时触发 |
+| `config-change` | 配置变更时触发 |
 | `directory-readme-injector` | README 上下文注入 |
 
 ### 质量与验证 Hooks

package/hooks/hooks.json

@@ -59,6 +59,101 @@
           }
         ]
       }
+    ],
+    "SubagentStop": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/subagent-stop.mjs",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "PreCompact": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/pre-compact.mjs",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/teammate-idle.mjs",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "SessionEnd": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/session-end.mjs",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/user-prompt-submit.mjs",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "PermissionRequest": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/permission-request.mjs",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/task-completed.mjs",
+            "async": false
+          }
+        ]
+      }
+    ],
+    "ConfigChange": [
+      {
+        "matcher": "",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "node ${CLAUDE_PLUGIN_ROOT}/templates/hooks/config-change.mjs",
+            "async": false
+          }
+        ]
+      }
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangjie559567/ultrapower",
-  "version": "5.2.12",
+  "version": "5.3.0",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
   "type": "module",
   "main": "dist/index.js",
@@ -58,7 +58,8 @@
     "prepublishOnly": "npm run build && npm run compose-docs",
     "postinstall": "node scripts/plugin-setup.mjs",
     "release:local": "node scripts/release-local.mjs",
-    "release:dry-run": "node scripts/release-local.mjs --dry-run"
+    "release:dry-run": "node scripts/release-local.mjs --dry-run",
+    "bump": "node scripts/bump-version.mjs"
   },
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "^0.1.0",

package/scripts/bump-version.mjs

@@ -0,0 +1,69 @@
+#!/usr/bin/env node
+// scripts/bump-version.mjs
+// 用法: node scripts/bump-version.mjs <new-version>
+// 统一更新 package.json / plugin.json / marketplace.json 并校验一致性
+
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+
+const FILES = {
+  pkg: resolve('package.json'),
+  plugin: resolve('.claude-plugin/plugin.json'),
+  marketplace: resolve('.claude-plugin/marketplace.json'),
+};
+
+export function readVersions() {
+  const pkg = JSON.parse(readFileSync(FILES.pkg, 'utf-8'));
+  const plugin = JSON.parse(readFileSync(FILES.plugin, 'utf-8'));
+  const market = JSON.parse(readFileSync(FILES.marketplace, 'utf-8'));
+  return {
+    pkg: pkg.version,
+    plugin: plugin.version,
+    marketplace: market.plugins?.[0]?.version,
+  };
+}
+
+export function assertVersionsSync() {
+  const v = readVersions();
+  const versions = Object.values(v);
+  if (new Set(versions).size !== 1) {
+    throw new Error(`Version mismatch: ${JSON.stringify(v)}`);
+  }
+  return versions[0];
+}
+
+export function bumpVersion(newVersion) {
+  if (!/^\d+\.\d+\.\d+/.test(newVersion)) {
+    throw new Error(`Invalid version format: ${newVersion}`);
+  }
+  // package.json
+  const pkg = JSON.parse(readFileSync(FILES.pkg, 'utf-8'));
+  pkg.version = newVersion;
+  writeFileSync(FILES.pkg, JSON.stringify(pkg, null, 2) + '\n');
+
+  // plugin.json
+  const plugin = JSON.parse(readFileSync(FILES.plugin, 'utf-8'));
+  plugin.version = newVersion;
+  writeFileSync(FILES.plugin, JSON.stringify(plugin, null, 2) + '\n');
+
+  // marketplace.json
+  const market = JSON.parse(readFileSync(FILES.marketplace, 'utf-8'));
+  for (const p of market.plugins ?? []) {
+    p.version = newVersion;
+    if (p.source) p.source.version = newVersion;
+  }
+  writeFileSync(FILES.marketplace, JSON.stringify(market, null, 2) + '\n');
+
+  console.log(`Bumped all version files to ${newVersion}`);
+}
+
+// CLI
+const newVersion = process.argv[2];
+if (newVersion) {
+  bumpVersion(newVersion);
+} else {
+  const v = readVersions();
+  console.log('Current versions:', v);
+  try { assertVersionsSync(); console.log('✓ All in sync'); }
+  catch (e) { console.error('✗', e.message); process.exit(1); }
+}

package/scripts/plugin-setup.mjs

@@ -102,6 +102,7 @@ function fixNestedCacheDir() {
     // Pattern B: cache/omc/ultrapower/VERSION/ (versioned nesting)
     const pluginCacheBase = join(CLAUDE_DIR, 'plugins/cache/omc/ultrapower');
     if (!existsSync(pluginCacheBase)) return;
+    const versions = readdirSync(pluginCacheBase);
     for (const version of versions) {
       const versionDir = join(pluginCacheBase, version);
       const nestedDir = join(versionDir, 'ultrapower');

package/scripts/release-steps.mjs

@@ -2,6 +2,7 @@
 import { execSync } from 'node:child_process';
 import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
+import { assertVersionsSync } from './bump-version.mjs';
 
 function getVersion() {
   const pkg = JSON.parse(readFileSync(resolve('package.json'), 'utf-8'));
@@ -16,6 +17,15 @@ function run(cmd, dryRun = false) {
   return execSync(cmd, { stdio: 'pipe', encoding: 'utf-8' });
 }
 
+export async function preflight(opts = {}) {
+  try {
+    assertVersionsSync();
+    return { success: true };
+  } catch (err) {
+    return { success: false, output: err.message };
+  }
+}
+
 export async function validateBuild(opts = {}) {
   const { skipTests = false, dryRun = false } = opts;
   try {
@@ -52,34 +62,15 @@ export async function createGithubRelease(opts = {}) {
 }
 
 export async function syncMarketplace(opts = {}) {
-  const { version, dryRun = false } = opts;
-  const v = version || getVersion();
-  try {
-    // Update marketplace.json version fields
-    const marketplacePath = resolve('.claude-plugin/marketplace.json');
-    const marketplace = JSON.parse(readFileSync(marketplacePath, 'utf-8'));
-    for (const plugin of marketplace.plugins ?? []) {
-      plugin.version = v;
-      if (plugin.source) plugin.source.version = v;
-    }
-    if (!dryRun) {
-      const { writeFileSync } = await import('node:fs');
-      writeFileSync(marketplacePath, JSON.stringify(marketplace, null, 2) + '\n');
-    } else {
-      console.log(`[dry-run] Would write marketplace.json version -> ${v}`);
-    }
-    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 };
-  }
+  const { dryRun = false } = opts;
+  // Version already in sync (bumped before tagging); no-op in CI (tag push is sufficient)
+  if (dryRun) { console.log('[dry-run] syncMarketplace: no-op'); }
+  return { success: true };
 }
 
 export async function runReleasePipeline(opts = {}) {
-  const { dryRun = false, skipTests = false, startFrom = 'validate', version } = opts;
-  const steps = ['validate', 'publish', 'release', 'sync'];
+  const { dryRun = false, skipTests = false, startFrom = 'preflight', version } = opts;
+  const steps = ['preflight', 'validate', 'publish', 'release', 'sync'];
   const startIdx = steps.indexOf(startFrom);
 
   if (startIdx === -1) {
@@ -88,30 +79,17 @@ export async function runReleasePipeline(opts = {}) {
   }
 
   const v = version || getVersion();
+  const run5 = async (label, fn, fnOpts) => {
+    console.log(label);
+    const r = await fn(fnOpts);
+    if (!r.success) { console.error(`${label} failed: ${r.output}`); process.exit(1); }
+  };
 
-  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); }
-  }
+  if (startIdx <= 0) await run5('Step 1/5: preflight...', preflight, { dryRun });
+  if (startIdx <= 1) await run5('Step 2/5: validateBuild...', validateBuild, { skipTests, dryRun });
+  if (startIdx <= 2) await run5('Step 3/5: publishNpm...', publishNpm, { dryRun });
+  if (startIdx <= 3) await run5('Step 4/5: createGithubRelease...', createGithubRelease, { version: v, dryRun });
+  if (startIdx <= 4) await run5('Step 5/5: syncMarketplace...', syncMarketplace, { dryRun });
 
   console.log('Release pipeline completed successfully.');
   return { success: true };
@@ -119,15 +97,10 @@ export async function runReleasePipeline(opts = {}) {
 
 // CLI entry point (for direct GitHub Actions invocation)
 const cliStep = process.argv[2];
-if (cliStep && ['validate', 'publish', 'release', 'sync'].includes(cliStep)) {
+if (cliStep && ['preflight', '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,
-  };
+  const stepMap = { preflight, 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/templates/hooks/config-change.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// OMC ConfigChange Hook
+// Fires when Claude Code configuration changes.
+
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  const raw = await readStdin();
+  let data = {};
+  try { data = JSON.parse(raw); } catch {}
+
+  // key and value available in data
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();

package/templates/hooks/permission-request.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// OMC PermissionRequest Hook
+// Fires when Claude requests permission to use a tool.
+
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  const raw = await readStdin();
+  let data = {};
+  try { data = JSON.parse(raw); } catch {}
+
+  // tool_name and tool_input available in data
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();

package/templates/hooks/pre-compact.mjs

@@ -0,0 +1,34 @@
+#!/usr/bin/env node
+// OMC PreCompact Hook
+// Fires before context compaction. Saves Axiom state to prevent context loss.
+
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  const raw = await readStdin();
+  let data = {};
+  try { data = JSON.parse(raw); } catch {}
+
+  const cwd = data.cwd || process.cwd();
+  const VALID_TRIGGERS = new Set(['auto', 'manual']);
+  const trigger = VALID_TRIGGERS.has(data.trigger) ? data.trigger : 'auto';
+  const axiomDir = join(cwd, '.omc', 'axiom');
+
+  // If Axiom is active, append a compact notice to active_context.md
+  const activeContextPath = join(axiomDir, 'active_context.md');
+  if (existsSync(activeContextPath)) {
+    try {
+      const content = readFileSync(activeContextPath, 'utf-8');
+      const notice = `\n\n<!-- PreCompact: context compacted (${trigger}) at ${new Date().toISOString()} -->`;
+      if (!content.includes('<!-- PreCompact:')) {
+        writeFileSync(activeContextPath, content + notice, 'utf-8');
+      }
+    } catch {}
+  }
+
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();

package/templates/hooks/session-end.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// OMC SessionEnd Hook
+// Fires when a session ends. Cleans up transient state.
+
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  const raw = await readStdin();
+  let data = {};
+  try { data = JSON.parse(raw); } catch {}
+
+  // session_id and directory available in data
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();

package/templates/hooks/subagent-stop.mjs

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// OMC SubagentStop Hook
+// Fires when a subagent finishes. Logs agent completion for trace/metrics.
+
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  const raw = await readStdin();
+  let data = {};
+  try { data = JSON.parse(raw); } catch {}
+
+  const { agent_type, agent_id, last_assistant_message, stop_hook_active } = data;
+
+  // Prevent infinite loop: if hook is already active, exit silently
+  if (stop_hook_active) process.exit(0);
+
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();

package/templates/hooks/task-completed.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// OMC TaskCompleted Hook
+// Fires when a task is marked complete.
+
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  const raw = await readStdin();
+  let data = {};
+  try { data = JSON.parse(raw); } catch {}
+
+  // task_id and result available in data
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();

package/templates/hooks/teammate-idle.mjs

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+// OMC TeammateIdle Hook
+// Fires when a team teammate is about to go idle.
+// Exit code 2 + stderr message forces teammate to continue working.
+
+// Allow idle by default - enforcement is opt-in via user config
+async function main() {
+  process.exit(0);
+}
+
+main();

package/templates/hooks/user-prompt-submit.mjs

@@ -0,0 +1,16 @@
+#!/usr/bin/env node
+// OMC UserPromptSubmit Hook
+// Fires before user prompt is submitted. Used for keyword detection.
+
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  const raw = await readStdin();
+  let data = {};
+  try { data = JSON.parse(raw); } catch {}
+
+  // prompt available in data.prompt
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();