@liangjie559567/ultrapower 5.0.4

package/templates/hooks/session-start.mjs

@@ -0,0 +1,380 @@
+#!/usr/bin/env node
+// OMC Session Start Hook (Node.js)
+// Restores persistent mode states when session starts
+// Cross-platform: Windows, macOS, Linux
+
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { homedir } from 'os';
+import { fileURLToPath, pathToFileURL } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+
+// Import timeout-protected stdin reader (prevents hangs on Linux/Windows, see issue #240, #524)
+let readStdin;
+try {
+  const mod = await import(pathToFileURL(join(__dirname, 'lib', 'stdin.mjs')).href);
+  readStdin = mod.readStdin;
+} catch {
+  // Fallback: inline timeout-protected readStdin if lib module is missing
+  readStdin = (timeoutMs = 5000) => new Promise((resolve) => {
+    const chunks = [];
+    let settled = false;
+    const timeout = setTimeout(() => {
+      if (!settled) { settled = true; process.stdin.removeAllListeners(); process.stdin.destroy(); resolve(Buffer.concat(chunks).toString('utf-8')); }
+    }, timeoutMs);
+    process.stdin.on('data', (chunk) => { chunks.push(chunk); });
+    process.stdin.on('end', () => { if (!settled) { settled = true; clearTimeout(timeout); resolve(Buffer.concat(chunks).toString('utf-8')); } });
+    process.stdin.on('error', () => { if (!settled) { settled = true; clearTimeout(timeout); resolve(''); } });
+    if (process.stdin.readableEnded) { if (!settled) { settled = true; clearTimeout(timeout); resolve(Buffer.concat(chunks).toString('utf-8')); } }
+  });
+}
+
+function readJsonFile(path) {
+  try {
+    if (!existsSync(path)) return null;
+    return JSON.parse(readFileSync(path, 'utf-8'));
+  } catch {
+    return null;
+  }
+}
+
+function writeJsonFile(path, data) {
+  try {
+    const dir = join(path, '..');
+    if (!existsSync(dir)) {
+      mkdirSync(dir, { recursive: true });
+    }
+    writeFileSync(path, JSON.stringify(data, null, 2), 'utf-8');
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+async function checkForUpdates(currentVersion) {
+  const cacheFile = join(homedir(), '.omc', 'update-check.json');
+  const now = Date.now();
+  const CACHE_DURATION = 24 * 60 * 60 * 1000; // 24 hours
+
+  // Check cache first
+  const cached = readJsonFile(cacheFile);
+  if (cached && cached.timestamp && (now - cached.timestamp) < CACHE_DURATION) {
+    return cached.updateAvailable ? cached : null;
+  }
+
+  // Fetch latest version from npm
+  try {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 2000);
+
+    const response = await fetch('https://registry.npmjs.org/oh-my-claude-sisyphus/latest', {
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+
+    if (!response.ok) {
+      throw new Error('Network response was not ok');
+    }
+
+    const data = await response.json();
+    const latestVersion = data.version;
+
+    const updateAvailable = compareVersions(latestVersion, currentVersion) > 0;
+
+    const cacheData = {
+      timestamp: now,
+      latestVersion,
+      currentVersion,
+      updateAvailable
+    };
+
+    writeJsonFile(cacheFile, cacheData);
+
+    return updateAvailable ? cacheData : null;
+  } catch (error) {
+    // Silent fail - network unavailable or timeout
+    return null;
+  }
+}
+
+function compareVersions(v1, v2) {
+  const parts1 = v1.replace(/^v/, '').split('.').map(Number);
+  const parts2 = v2.replace(/^v/, '').split('.').map(Number);
+
+  for (let i = 0; i < 3; i++) {
+    const diff = (parts1[i] || 0) - (parts2[i] || 0);
+    if (diff !== 0) return diff;
+  }
+  return 0;
+}
+
+// ============================================================================
+// Notepad Support
+// ============================================================================
+
+const NOTEPAD_FILENAME = 'notepad.md';
+const PRIORITY_HEADER = '## Priority Context';
+const WORKING_MEMORY_HEADER = '## Working Memory';
+
+/**
+ * Get notepad path in .omc directory
+ */
+function getNotepadPath(directory) {
+  return join(directory, '.omc', NOTEPAD_FILENAME);
+}
+
+/**
+ * Read notepad content
+ */
+function readNotepad(directory) {
+  const notepadPath = getNotepadPath(directory);
+  if (!existsSync(notepadPath)) {
+    return null;
+  }
+  try {
+    return readFileSync(notepadPath, 'utf-8');
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Extract a section from notepad content
+ */
+function extractSection(content, header) {
+  // Match from header to next section (## followed by space and non-# char)
+  const regex = new RegExp(`${header}\\n([\\s\\S]*?)(?=\\n## [^#]|$)`);
+  const match = content.match(regex);
+  if (!match) {
+    return null;
+  }
+  // Remove HTML comments and trim
+  let section = match[1];
+  section = section.replace(/<!--[\s\S]*?-->/g, '').trim();
+  return section || null;
+}
+
+/**
+ * Get Priority Context section (for injection)
+ */
+function getPriorityContext(directory) {
+  const content = readNotepad(directory);
+  if (!content) {
+    return null;
+  }
+  return extractSection(content, PRIORITY_HEADER);
+}
+
+/**
+ * Format notepad context for session injection
+ */
+function formatNotepadContext(directory) {
+  const priorityContext = getPriorityContext(directory);
+  if (!priorityContext) {
+    return null;
+  }
+  return `<notepad-priority>
+
+## Priority Context
+
+${priorityContext}
+
+</notepad-priority>`;
+}
+
+async function main() {
+  try {
+    const input = await readStdin();
+    let data = {};
+    try { data = JSON.parse(input); } catch {}
+
+    const directory = data.cwd || data.directory || process.cwd();
+    const sessionId = data.sessionId || data.session_id || data.sessionid || '';
+    const messages = [];
+
+    // Check for updates (non-blocking)
+    // Read version from OMC's own package.json, not the project's (fixes #516)
+    let currentVersion = null;
+    for (let i = 1; i <= 4; i++) {
+      const candidate = join(__dirname, ...Array(i).fill('..'), 'package.json');
+      const pkg = readJsonFile(candidate);
+      if (pkg?.name === 'oh-my-claude-sisyphus' && pkg?.version) {
+        currentVersion = pkg.version;
+        break;
+      }
+    }
+
+    const updateInfo = currentVersion ? await checkForUpdates(currentVersion) : null;
+    if (updateInfo) {
+      // Read config to check autoUpgradePrompt preference
+      const configPath = join(homedir(), '.claude', '.omc-config.json');
+      const omcConfig = readJsonFile(configPath) || {};
+      const autoUpgradePrompt = omcConfig.autoUpgradePrompt !== false; // default: true
+
+      if (autoUpgradePrompt) {
+        messages.push(`<session-restore>
+
+[OMC AUTO-UPGRADE AVAILABLE]
+
+ultrapower v${updateInfo.latestVersion} is available (current: v${updateInfo.currentVersion}).
+
+ACTION: Use AskUserQuestion to ask the user if they want to upgrade now. Offer these options:
+- "Upgrade now" (Recommended): Run \`npm install -g oh-my-claude-sisyphus@latest\` via Bash, then run \`omc install --force --skip-claude-check --refresh-hooks\` to reconcile hooks and CLAUDE.md
+- "Skip this time": Continue the session without upgrading
+- "Don't ask again": Tell the user to set "autoUpgradePrompt": false in ~/.claude/.omc-config.json to disable future prompts
+
+Keep the prompt brief. If the user accepts, execute the upgrade commands and report the result.
+
+</session-restore>
+
+---
+`);
+      } else {
+        messages.push(`<session-restore>
+
+[OMC UPDATE AVAILABLE]
+
+A new version of ultrapower is available: v${updateInfo.latestVersion} (current: ${updateInfo.currentVersion})
+
+To update, run: omc update
+
+</session-restore>
+
+---
+`);
+      }
+    }
+
+    // Check for ultrawork state - only restore if session matches (issue #311)
+    const ultraworkState = readJsonFile(join(directory, '.omc', 'state', 'ultrawork-state.json'))
+      || readJsonFile(join(homedir(), '.omc', 'state', 'ultrawork-state.json'));
+
+    if (ultraworkState?.active && (!ultraworkState.session_id || ultraworkState.session_id === sessionId)) {
+      messages.push(`<session-restore>
+
+[ULTRAWORK MODE RESTORED]
+
+You have an active ultrawork session from ${ultraworkState.started_at}.
+Original task: ${ultraworkState.original_prompt}
+
+Continue working in ultrawork mode until all tasks are complete.
+
+</session-restore>
+
+---
+`);
+    }
+
+    // Check for incomplete todos (project-local only, not global ~/.claude/todos/)
+    // NOTE: We intentionally do NOT scan the global ~/.claude/todos/ directory.
+    // That directory accumulates todo files from ALL past sessions across all
+    // projects, causing phantom task counts in fresh sessions (see issue #354).
+    const localTodoPaths = [
+      join(directory, '.omc', 'todos.json'),
+      join(directory, '.claude', 'todos.json')
+    ];
+    let incompleteCount = 0;
+    for (const todoFile of localTodoPaths) {
+      if (existsSync(todoFile)) {
+        try {
+          const data = readJsonFile(todoFile);
+          const todos = data?.todos || (Array.isArray(data) ? data : []);
+          incompleteCount += todos.filter(t => t.status !== 'completed' && t.status !== 'cancelled').length;
+        } catch {}
+      }
+    }
+
+    if (incompleteCount > 0) {
+      messages.push(`<session-restore>
+
+[PENDING TASKS DETECTED]
+
+You have ${incompleteCount} incomplete tasks from a previous session.
+Please continue working on these tasks.
+
+</session-restore>
+
+---
+`);
+    }
+
+    // Check for notepad Priority Context (ALWAYS loaded on session start)
+    const notepadContext = formatNotepadContext(directory);
+    if (notepadContext) {
+      messages.push(`<session-restore>
+
+[NOTEPAD PRIORITY CONTEXT LOADED]
+
+${notepadContext}
+
+</session-restore>
+
+---
+`);
+    }
+
+    // Load root AGENTS.md if it exists (deepinit output - issue #613)
+    // This ensures AI-readable directory documentation is available from session start
+    const agentsMdPath = join(directory, 'AGENTS.md');
+    if (existsSync(agentsMdPath)) {
+      try {
+        let agentsContent = readFileSync(agentsMdPath, 'utf-8').trim();
+        if (agentsContent) {
+          // Truncate to ~5000 tokens (20000 chars) to avoid context bloat
+          const MAX_AGENTS_CHARS = 20000;
+          let truncationNotice = '';
+          if (agentsContent.length > MAX_AGENTS_CHARS) {
+            agentsContent = agentsContent.slice(0, MAX_AGENTS_CHARS);
+            truncationNotice = `\n\n[Note: Content was truncated. For full context, read: ${agentsMdPath}]`;
+          }
+          messages.push(`<session-restore>
+
+[ROOT AGENTS.md LOADED]
+
+The following project documentation was generated by deepinit to help AI agents understand the codebase:
+
+${agentsContent}${truncationNotice}
+
+</session-restore>
+
+---
+`);
+        }
+      } catch {
+        // Skip if file can't be read
+      }
+    }
+
+    // MCP tool discovery reminder (deferred tools need ToolSearch before use)
+    messages.push(`<session-restore>
+
+[MCP TOOL DISCOVERY REQUIRED]
+
+MCP tools (ask_codex, ask_gemini) are deferred and NOT in your tool list yet.
+Before first use, call ToolSearch("mcp") to discover all available MCP tools.
+If ToolSearch returns no results, MCP servers are not configured -- use Claude agent fallbacks instead.
+
+</session-restore>
+
+---
+`);
+
+    if (messages.length > 0) {
+      console.log(JSON.stringify({
+        continue: true,
+        hookSpecificOutput: {
+          hookEventName: 'SessionStart',
+          additionalContext: messages.join('\n')
+        }
+      }));
+    } else {
+      console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+    }
+  } catch (error) {
+    console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+  }
+}
+
+main();

package/templates/hooks/stop-continuation.mjs

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+// OMC Stop Continuation Hook (Simplified)
+// Always allows stop - soft enforcement via message injection only.
+
+import { readStdin } from './lib/stdin.mjs';
+
+async function main() {
+  // Consume stdin with timeout protection (required for hook protocol)
+  await readStdin();
+  // Always allow stop
+  console.log(JSON.stringify({ continue: true, suppressOutput: true }));
+}
+
+main();

package/templates/rules/README.md

@@ -0,0 +1,40 @@
+# Rules Templates
+
+This directory contains rule templates that you can copy to your project's `.claude/rules/` directory.
+
+## How to Use
+
+1. Create a `.claude/rules/` directory in your project root
+2. Copy the templates you want to use
+3. Customize them for your project
+4. Rules in `.claude/rules/*.md` will be auto-discovered and injected into context
+
+## Available Templates
+
+| Template | Purpose |
+|----------|---------|
+| `coding-style.md` | Code style and formatting guidelines |
+| `testing.md` | Testing requirements and coverage targets |
+| `security.md` | Security checklist and best practices |
+| `performance.md` | Performance guidelines and model selection |
+| `git-workflow.md` | Git commit and PR workflow |
+
+## Auto-Discovery
+
+When you place rules in `.claude/rules/`, they are automatically discovered by ultrapower and injected into the context for all agents working in your project.
+
+## Example
+
+```bash
+# Copy templates to your project
+mkdir -p .claude/rules
+cp templates/rules/security.md .claude/rules/
+cp templates/rules/testing.md .claude/rules/
+
+# Customize for your project
+# Edit .claude/rules/security.md to add project-specific checks
+```
+
+## Customization
+
+Each template has `[CUSTOMIZE]` markers where you should add project-specific guidelines.

package/templates/rules/axiom-gatekeepers.md

@@ -0,0 +1,40 @@
+# Axiom Gatekeepers（门禁规则）
+
+<!-- Source: C:\Users\ljyih\Desktop\Axiom\.agent\rules\gatekeepers.rule -->
+<!-- Migrated: 2026-02-24 -->
+
+强制性检查点，未通过则绝对禁止进入下一环节。
+
+## 1. 专家评审门禁（Expert Gate）
+
+- **触发**: 所有新功能需求 / Phase 1 结束
+- **动作**: 必须经过 `ai-review` 流程（含 Gatekeeper, Parallel Review, Arbitration）
+- **通过条件**: Aggregator 生成 `review_summary.md` 并结论为 "Pass"
+
+## 2. PRD 确认门禁（User Gate）
+
+- **触发**: PRD 终稿生成完成
+- **动作**: 显示 "PRD 已生成，是否确认执行？(Yes/No)"
+- **恢复**: 用户明确确认后才允许进入分解阶段
+
+## 3. 复杂度门禁（Complexity Gate）
+
+- **触发**: 开发前评估工时 > 1 人日
+- **动作**: 必须触发任务拆解（DAG 分解）
+
+## 4. 编译提交门禁（CI Gate）
+
+- **触发**: 代码修改完成
+- **动作**: 必须执行 `tsc --noEmit && npm run build && npm test`
+- **通过条件**: 无错误时自动执行 `git commit`
+
+## 5. 范围门禁（Scope Gate）
+
+- **触发**: 修改文件时
+- **检查**: 是否在任务定义的 Impact Scope 内
+- **动作**: 越界修改触发警告，需用户确认
+
+## ultrapower 适配说明
+
+- CI Gate 命令已从 `flutter analyze` 替换为 `tsc --noEmit && npm run build && npm test`
+- 专家评审门禁对应 ultrapower 的 `code-reviewer` + `security-reviewer` + `quality-reviewer` 并行审查

package/templates/rules/axiom-provider-router.md

@@ -0,0 +1,40 @@
+# Axiom Provider Router（Provider 路由规则）
+
+<!-- Source: C:\Users\ljyih\Desktop\Axiom\.agent\rules\provider_router.rule -->
+<!-- Migrated: 2026-02-24 -->
+
+在所有需要启动 Worker CLI 的流程中，先读取配置的 `ACTIVE_PROVIDER`，再按下表构造命令。
+
+## Provider → Worker 命令模板
+
+| ACTIVE_PROVIDER | Worker CLI | 说明 |
+| :--- | :--- | :--- |
+| `codex` | Codex CLI | 默认首选 |
+| `claude_code` | Claude Code | 按本机安装命令名 |
+| `opencode` | OpenCode CLI | 以当前 CLI 语法为准 |
+| `gemini_cli` | Gemini CLI | 以当前 CLI 语法为准 |
+| `gemini` | Gemini (legacy) | 向后兼容 |
+| `claude` | Claude (legacy) | 向后兼容 |
+
+## 统一占位符
+
+- `WORKER_EXEC`: 当前 Provider 的执行命令模板
+- `WORKER_LABEL`: 当前 Provider 的展示名
+
+## 回退策略
+
+1. 若 `ACTIVE_PROVIDER` 不存在或未命中，回退到 `codex`
+2. 若目标 CLI 未安装，输出缺失提示并给出安装命令
+3. 仅在当前 Provider 无法执行时，回退到 `codex exec`
+
+## 约束
+
+- 不在 workflow 中硬编码具体 CLI 命令
+- workflow 仅引用 `WORKER_EXEC` 占位符
+
+## ultrapower 适配说明
+
+在 ultrapower 中，Provider 路由通过 Task subagent_type 实现：
+- `codex` → `mcp__plugin_ultrapower_x__ask_codex`
+- `gemini` → `mcp__plugin_ultrapower_g__ask_gemini`
+- `claude_code` → `Task(subagent_type="ultrapower:executor")`

package/templates/rules/axiom-router.md

@@ -0,0 +1,54 @@
+# Axiom Router（核心路由规则）
+
+<!-- Source: C:\Users\ljyih\Desktop\Axiom\.agent\rules\router.rule -->
+<!-- Migrated: 2026-02-24 -->
+
+负责将用户意图路由到正确的工作流或技能。
+
+## 0. 记忆优先原则（Memory First）
+
+**强制**: 每个新 Session 必须先读取活跃上下文。
+
+- **触发**: 任何新 Session 的第一条请求，或用户说 "继续"/"开始"
+- **动作**:
+  1. 读取 `.omc/axiom/active_context.md`
+  2. 检查 `task_status` 字段
+  3. 注入 `Current Goal` 和 `Task Queues`
+  4. 基于状态建议下一步
+
+## 1. 核心流水线路由
+
+遵循: Draft → Review → Decompose → Implement
+
+| 用户意图 | 路由目标 | 说明 |
+| :--- | :--- | :--- |
+| 提出新需求 / 做个功能 | `brainstorming` skill | Phase 1: 需求澄清与初稿 |
+| Draft 已生成 / 评审 | `code-reviewer` + `security-reviewer` | Phase 1.5: 专家评审 |
+| PRD 已确认 / 拆解 | `writing-plans` skill | Phase 2: 任务拆解 |
+| Manifest 已确认 / 开发 | `executing-plans` skill | Phase 3: 开发交付 |
+
+## 2. 辅助功能路由
+
+| 用户意图 | 路由目标 |
+| :--- | :--- |
+| 检测到报错 / "修个Bug" | `ultrapower:analyze` |
+| "回滚" / "撤销" | `/ultrapower:ax-rollback` |
+| "状态" / "进度" | `/ultrapower:ax-status` |
+| "反思" / "总结" | `/ultrapower:ax-reflect` |
+| "知识 [query]" | `/ultrapower:ax-knowledge` |
+| "导出系统" | `/ultrapower:ax-export` |
+| "初始化环境" | `/ultrapower:deepinit` |
+
+## 3. 门禁规则
+
+- **Ambiguity Guard**: 需求模糊时强制反问，禁止直接进入实现阶段
+- **Approval Guard**: PRD 必须用户确认才能进入拆解；Manifest 必须用户确认才能进入开发
+- **CI Guard**: 所有代码提交前必须通过 `tsc --noEmit && npm run build && npm test`
+
+## 4. 进化引擎自动触发
+
+| 触发事件 | 自动行为 |
+| :--- | :--- |
+| 功能开发完成（All Done） | 自动触发 `/ultrapower:learner`（知识收割） |
+| Bug 修复成功 | 自动提取 Error Pattern |
+| Session 结束/挂起 | 自动更新 `active_context.md` |

package/templates/rules/axiom-skills.md

@@ -0,0 +1,33 @@
+# Axiom Skills Router（技能路由表）
+
+<!-- Source: C:\Users\ljyih\Desktop\Axiom\.agent\rules\skills.rule -->
+<!-- Migrated: 2026-02-24 -->
+
+根据任务类型调用对应能力。
+
+## 技能路由表
+
+| 任务类型 | ultrapower 对应 skill/agent | 说明 |
+| :--- | :--- | :--- |
+| 需求分析（Gate） | `ultrapower:analyst` | 需求澄清、验收标准 |
+| 产品设计（Draft） | `ultrapower:brainstorming` | 设计对话、方案探索 |
+| 评审仲裁（Review） | `ultrapower:code-reviewer` | 综合审查 |
+| 系统架构（Manifest） | `ultrapower:architect` | 系统设计、边界定义 |
+| 读写记忆 | `notepad_read/write` + `project_memory_*` | OMC 内置工具 |
+| 错误分析 | `ultrapower:debugger` | 根因分析 |
+| UI/UX 设计 | `ultrapower:designer` | UX/UI 架构 |
+| 自进化 | `ultrapower:learner` | 知识提取与进化 |
+| 代码生成 | `ultrapower:executor` | 代码实现 |
+| DAG 分析 | `ultrapower:planner` | 任务排序、依赖分析 |
+| 测试策略 | `ultrapower:test-engineer` | 测试覆盖、TDD |
+| 安全审查 | `ultrapower:security-reviewer` | 漏洞检测 |
+
+## 使用说明
+
+在 ultrapower 中，通过 `Task(subagent_type="ultrapower:[agent]")` 调用对应 agent。
+
+示例：
+```
+Task(subagent_type="ultrapower:analyst", model="opus", prompt="分析需求...")
+Task(subagent_type="ultrapower:executor", model="sonnet", prompt="实现功能...")
+```

package/templates/rules/coding-style.md

@@ -0,0 +1,74 @@
+# 编码风格规则
+
+## 不可变性（关键）
+
+始终创建新对象，绝不修改：
+
+```javascript
+// 错误：修改
+function updateUser(user, name) {
+  user.name = name  // 修改！
+  return user
+}
+
+// 正确：不可变性
+function updateUser(user, name) {
+  return { ...user, name }
+}
+```
+
+## 文件组织
+
+多个小文件 > 少数大文件：
+- 高内聚，低耦合
+- 典型 200-400 行，最多 800 行
+- 从大型组件中提取工具函数
+- 按功能/领域组织，而非按类型
+
+## 错误处理
+
+始终全面处理错误：
+
+```typescript
+try {
+  const result = await riskyOperation()
+  return result
+} catch (error) {
+  console.error('Operation failed:', error)
+  throw new Error('User-friendly error message')
+}
+```
+
+## 输入验证
+
+始终验证用户输入：
+
+```typescript
+import { z } from 'zod'
+
+const schema = z.object({
+  email: z.string().email(),
+  age: z.number().int().min(0).max(150)
+})
+
+const validated = schema.parse(input)
+```
+
+## 代码质量清单
+
+标记工作完成前：
+- [ ] 代码可读且命名良好
+- [ ] 函数小巧（<50 行）
+- [ ] 文件聚焦（<800 行）
+- [ ] 无深层嵌套（>4 层）
+- [ ] 适当的错误处理
+- [ ] 无 console.log 语句
+- [ ] 无硬编码值
+- [ ] 使用不可变模式
+
+## [自定义] 项目特定风格
+
+在此添加项目特定的编码风格规则：
+- 命名约定
+- 文件结构要求
+- 框架特定模式