@liangjie559567/ultrapower 5.5.2 → 5.5.3

package/dist/workers/sqlite-adapter.js

@@ -0,0 +1,262 @@
+/**
+ * SQLite Worker State Adapter
+ */
+import { existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+export class SqliteWorkerAdapter {
+    db = null;
+    cwd;
+    constructor(cwd) {
+        this.cwd = cwd;
+    }
+    async init() {
+        try {
+            const betterSqlite3Module = await import('better-sqlite3');
+            const Database = betterSqlite3Module.default || betterSqlite3Module;
+            const stateDir = join(this.cwd, '.omc', 'state');
+            if (!existsSync(stateDir)) {
+                mkdirSync(stateDir, { recursive: true });
+            }
+            const dbPath = join(stateDir, 'workers.db');
+            this.db = new Database(dbPath);
+            this.db.pragma('journal_mode = WAL');
+            this.db.exec(`
+        CREATE TABLE IF NOT EXISTS workers (
+          worker_id TEXT PRIMARY KEY,
+          worker_type TEXT NOT NULL,
+          name TEXT NOT NULL,
+          status TEXT NOT NULL,
+          pid INTEGER,
+          spawned_at TEXT NOT NULL,
+          last_heartbeat_at TEXT,
+          completed_at TEXT,
+          provider TEXT,
+          model TEXT,
+          agent_role TEXT,
+          prompt_file TEXT,
+          response_file TEXT,
+          team_name TEXT,
+          tmux_session TEXT,
+          current_task_id TEXT,
+          consecutive_errors INTEGER DEFAULT 0,
+          error TEXT,
+          metadata TEXT
+        );
+        CREATE INDEX IF NOT EXISTS idx_worker_type ON workers(worker_type);
+        CREATE INDEX IF NOT EXISTS idx_status ON workers(status);
+        CREATE INDEX IF NOT EXISTS idx_team_name ON workers(team_name);
+      `);
+            return true;
+        }
+        catch (error) {
+            console.error('[SqliteWorkerAdapter] Init failed:', error);
+            return false;
+        }
+    }
+    async upsert(worker) {
+        if (!this.db)
+            return false;
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO workers (
+          worker_id, worker_type, name, status, pid,
+          spawned_at, last_heartbeat_at, completed_at,
+          provider, model, agent_role, prompt_file, response_file,
+          team_name, tmux_session, current_task_id, consecutive_errors,
+          error, metadata
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(worker_id) DO UPDATE SET
+          status = excluded.status,
+          last_heartbeat_at = excluded.last_heartbeat_at,
+          completed_at = excluded.completed_at,
+          current_task_id = excluded.current_task_id,
+          consecutive_errors = excluded.consecutive_errors,
+          error = excluded.error,
+          metadata = excluded.metadata
+      `);
+            stmt.run(worker.workerId, worker.workerType, worker.name, worker.status, worker.pid ?? null, worker.spawnedAt, worker.lastHeartbeatAt ?? null, worker.completedAt ?? null, worker.provider ?? null, worker.model ?? null, worker.agentRole ?? null, worker.promptFile ?? null, worker.responseFile ?? null, worker.teamName ?? null, worker.tmuxSession ?? null, worker.currentTaskId ?? null, worker.consecutiveErrors ?? 0, worker.error ?? null, worker.metadata ? JSON.stringify(worker.metadata) : null);
+            return true;
+        }
+        catch (error) {
+            console.error('[SqliteWorkerAdapter] Upsert failed:', error);
+            return false;
+        }
+    }
+    async get(workerId) {
+        if (!this.db)
+            return null;
+        try {
+            const stmt = this.db.prepare('SELECT * FROM workers WHERE worker_id = ?');
+            const row = stmt.get(workerId);
+            return row ? this.rowToWorkerState(row) : null;
+        }
+        catch (error) {
+            console.error('[SqliteWorkerAdapter] Get failed:', error);
+            return null;
+        }
+    }
+    async list(filter) {
+        if (!this.db)
+            return [];
+        try {
+            let query = 'SELECT * FROM workers WHERE 1=1';
+            const params = [];
+            if (filter?.workerType) {
+                query += ' AND worker_type = ?';
+                params.push(filter.workerType);
+            }
+            if (filter?.status) {
+                const statuses = Array.isArray(filter.status) ? filter.status : [filter.status];
+                query += ` AND status IN (${statuses.map(() => '?').join(',')})`;
+                params.push(...statuses);
+            }
+            if (filter?.teamName) {
+                query += ' AND team_name = ?';
+                params.push(filter.teamName);
+            }
+            if (filter?.provider) {
+                query += ' AND provider = ?';
+                params.push(filter.provider);
+            }
+            if (filter?.spawnedAfter) {
+                query += ' AND spawned_at >= ?';
+                params.push(filter.spawnedAfter.toISOString());
+            }
+            if (filter?.spawnedBefore) {
+                query += ' AND spawned_at <= ?';
+                params.push(filter.spawnedBefore.toISOString());
+            }
+            query += ' ORDER BY spawned_at DESC';
+            const stmt = this.db.prepare(query);
+            const rows = stmt.all(...params);
+            return rows.map(row => this.rowToWorkerState(row));
+        }
+        catch (error) {
+            console.error('[SqliteWorkerAdapter] List failed:', error);
+            return [];
+        }
+    }
+    async delete(workerId) {
+        if (!this.db)
+            return false;
+        try {
+            const stmt = this.db.prepare('DELETE FROM workers WHERE worker_id = ?');
+            const result = stmt.run(workerId);
+            return result.changes > 0;
+        }
+        catch (error) {
+            console.error('[SqliteWorkerAdapter] Delete failed:', error);
+            return false;
+        }
+    }
+    async healthCheck(workerId, maxHeartbeatAge = 30000) {
+        const worker = await this.get(workerId);
+        if (!worker)
+            return { isAlive: false };
+        const now = Date.now();
+        let heartbeatAge;
+        if (worker.lastHeartbeatAt) {
+            heartbeatAge = now - new Date(worker.lastHeartbeatAt).getTime();
+        }
+        const isAlive = worker.status === 'running' || worker.status === 'working'
+            ? (heartbeatAge !== undefined && heartbeatAge < maxHeartbeatAge)
+            : worker.status !== 'dead';
+        const uptimeMs = now - new Date(worker.spawnedAt).getTime();
+        return { isAlive, heartbeatAge, lastError: worker.error, uptimeMs };
+    }
+    async batchUpsert(workers) {
+        if (!this.db)
+            return 0;
+        try {
+            const transaction = this.db.transaction((workers) => {
+                let count = 0;
+                for (const worker of workers) {
+                    if (this.upsertSync(worker))
+                        count++;
+                }
+                return count;
+            });
+            return transaction(workers);
+        }
+        catch (error) {
+            console.error('[SqliteWorkerAdapter] Batch upsert failed:', error);
+            return 0;
+        }
+    }
+    async cleanup(maxAgeMs) {
+        if (!this.db)
+            return 0;
+        try {
+            const cutoff = new Date(Date.now() - maxAgeMs).toISOString();
+            const stmt = this.db.prepare(`
+        DELETE FROM workers
+        WHERE status IN ('completed', 'failed', 'timeout', 'dead')
+        AND (completed_at < ? OR (completed_at IS NULL AND spawned_at < ?))
+      `);
+            const result = stmt.run(cutoff, cutoff);
+            return result.changes;
+        }
+        catch (error) {
+            console.error('[SqliteWorkerAdapter] Cleanup failed:', error);
+            return 0;
+        }
+    }
+    async close() {
+        if (this.db) {
+            this.db.close();
+            this.db = null;
+        }
+    }
+    rowToWorkerState(row) {
+        return {
+            workerId: row.worker_id,
+            workerType: row.worker_type,
+            name: row.name,
+            status: row.status,
+            pid: row.pid,
+            spawnedAt: row.spawned_at,
+            lastHeartbeatAt: row.last_heartbeat_at,
+            completedAt: row.completed_at,
+            provider: row.provider,
+            model: row.model,
+            agentRole: row.agent_role,
+            promptFile: row.prompt_file,
+            responseFile: row.response_file,
+            teamName: row.team_name,
+            tmuxSession: row.tmux_session,
+            currentTaskId: row.current_task_id,
+            consecutiveErrors: row.consecutive_errors,
+            error: row.error,
+            metadata: row.metadata ? JSON.parse(row.metadata) : undefined,
+        };
+    }
+    upsertSync(worker) {
+        if (!this.db)
+            return false;
+        try {
+            const stmt = this.db.prepare(`
+        INSERT INTO workers (
+          worker_id, worker_type, name, status, pid,
+          spawned_at, last_heartbeat_at, completed_at,
+          provider, model, agent_role, prompt_file, response_file,
+          team_name, tmux_session, current_task_id, consecutive_errors,
+          error, metadata
+        ) VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)
+        ON CONFLICT(worker_id) DO UPDATE SET
+          status = excluded.status,
+          last_heartbeat_at = excluded.last_heartbeat_at,
+          completed_at = excluded.completed_at,
+          current_task_id = excluded.current_task_id,
+          consecutive_errors = excluded.consecutive_errors,
+          error = excluded.error,
+          metadata = excluded.metadata
+      `);
+            stmt.run(worker.workerId, worker.workerType, worker.name, worker.status, worker.pid ?? null, worker.spawnedAt, worker.lastHeartbeatAt ?? null, worker.completedAt ?? null, worker.provider ?? null, worker.model ?? null, worker.agentRole ?? null, worker.promptFile ?? null, worker.responseFile ?? null, worker.teamName ?? null, worker.tmuxSession ?? null, worker.currentTaskId ?? null, worker.consecutiveErrors ?? 0, worker.error ?? null, worker.metadata ? JSON.stringify(worker.metadata) : null);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=sqlite-adapter.js.map

package/dist/workers/sqlite-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite-adapter.js","sourceRoot":"","sources":["../../src/workers/sqlite-adapter.ts"],"names":[],"mappings":"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"}

package/dist/workers/types.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Worker State Types - Unified state model for MCP and Team workers
+ */
+export type WorkerStatus = 'spawned' | 'running' | 'idle' | 'working' | 'completed' | 'failed' | 'timeout' | 'dead';
+export interface WorkerState {
+    workerId: string;
+    workerType: 'mcp' | 'team';
+    name: string;
+    status: WorkerStatus;
+    pid?: number;
+    spawnedAt: string;
+    lastHeartbeatAt?: string;
+    completedAt?: string;
+    provider?: 'codex' | 'gemini';
+    model?: string;
+    agentRole?: string;
+    promptFile?: string;
+    responseFile?: string;
+    teamName?: string;
+    tmuxSession?: string;
+    currentTaskId?: string;
+    consecutiveErrors?: number;
+    error?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface HealthStatus {
+    isAlive: boolean;
+    heartbeatAge?: number;
+    tmuxSessionAlive?: boolean;
+    lastError?: string;
+    uptimeMs?: number;
+}
+export interface WorkerFilter {
+    workerType?: 'mcp' | 'team';
+    status?: WorkerStatus | WorkerStatus[];
+    teamName?: string;
+    provider?: 'codex' | 'gemini';
+    spawnedAfter?: Date;
+    spawnedBefore?: Date;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/workers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,SAAS,GACT,MAAM,GACN,SAAS,GACT,WAAW,GACX,QAAQ,GACR,SAAS,GACT,MAAM,CAAC;AAEX,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,KAAK,GAAG,MAAM,CAAC;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,YAAY,GAAG,YAAY,EAAE,CAAC;IACvC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,GAAG,QAAQ,CAAC;IAC9B,YAAY,CAAC,EAAE,IAAI,CAAC;IACpB,aAAa,CAAC,EAAE,IAAI,CAAC;CACtB"}

package/dist/workers/types.js

@@ -0,0 +1,5 @@
+/**
+ * Worker State Types - Unified state model for MCP and Team workers
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/workers/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/workers/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/docs/AGENTS.md

@@ -1,100 +1,92 @@
-<!-- Parent: ../AGENTS.md -->
-<!-- Generated: 2026-01-31 | Updated: 2026-02-24 -->
+<!-- Generated: 2026-01-28 | Updated: 2026-03-05 -->
 
-# docs
+# docs/ - 文档结构
 
-ultrapower 的用户文档和技术指南。
+**用途：** 用户文档、指南、参考资料和架构说明。
 
-## 目的
-
-本目录包含面向终端用户和开发者的文档：
-
-- **终端用户指南**：如何使用 ultrapower 功能
-- **技术参考**：架构、兼容性、迁移
-- **设计文档**：功能设计规范
+**版本：** 5.5.14
 
 ## 关键文件
 
-| 文件 | 说明 |
-|------|-------------|
+| 文件 | 描述 |
+|------|------|
+| `README.md` | 项目主文档 |
+| `REFERENCE.md` | 完整 API 参考（智能体、skills、hooks、工具） |
+| `ARCHITECTURE.md` | 系统架构和设计决策 |
+| `FEATURES.md` | 功能列表和说明 |
 | `CLAUDE.md` | 终端用户编排说明（安装到用户项目） |
-| `FEATURES.md` | 内部功能的开发者 API 参考 |
-| `REFERENCE.md` | API 参考和配置选项 |
-| `ARCHITECTURE.md` | 系统架构概览 |
 | `MIGRATION.md` | 版本迁移指南 |
-| `COMPATIBILITY.md` | 兼容性矩阵和系统要求 |
-| `TIERED_AGENTS_V2.md` | 模型路由和分层 agent 设计 |
-| `DELEGATION-ENFORCER.md` | 委派协议文档 |
-| `SYNC-SYSTEM.md` | 状态同步系统 |
-| `ANALYTICS-SYSTEM.md` | 分析数据收集文档 |
-| `LOCAL_PLUGIN_INSTALL.md` | 插件安装指南 |
-
-## 子目录
-
-| 目录 | 用途 |
-|-----------|---------|
-| `design/` | 功能设计规范 |
-
-## 面向 AI Agents
-
-### 在本目录中工作
-
-1. **终端用户视角**：CLAUDE.md 会安装到用户项目——面向终端用户而非开发者编写
-2. **保持链接可访问**：CLAUDE.md 中的链接使用原始 GitHub URL（agents 无法导航 GitHub UI）
-3. **版本一致性**：发布时更新所有文档中的版本号
-
-### 何时更新各文件
-
-| 触发条件 | 需更新的文件 |
-|---------|---------------|
-| Agent 数量或列表变更 | `REFERENCE.md`（Agents 章节） |
-| Skill 数量或列表变更 | `REFERENCE.md`（Skills 章节） |
-| Hook 数量或列表变更 | `REFERENCE.md`（Hooks System 章节） |
-| Magic keywords 变更 | `REFERENCE.md`（Magic Keywords 章节） |
-| Agent 工具分配变更 | `CLAUDE.md`（Agent Tool Matrix） |
-| Skill 组合或架构变更 | `ARCHITECTURE.md` |
-| 新增内部 API 或功能 | `FEATURES.md` |
-| 破坏性变更或迁移 | `MIGRATION.md` |
-| 分层 agent 设计更新 | `TIERED_AGENTS_V2.md` |
-| 平台或版本支持变更 | `COMPATIBILITY.md` |
-| 终端用户说明变更 | `CLAUDE.md` |
-| 主要面向用户的功能 | `../README.md` |
-
-### 测试要求
-
-- 验证 markdown 渲染正确
-- 检查所有内部链接可解析
-- 验证文档中的代码示例
-
-### 常见模式
-
-#### 链接到原始内容
-
-使用原始 GitHub URL 以确保外部可访问：
-
-[Migration Guide](https://raw.githubusercontent.com/liangjie559567/ultrapower/main/docs/MIGRATION.md)
-
-#### 版本引用
-
-使用一致的版本标题格式，标题后留空行：
-
-```markdown
-## v3.8.17 Changes
-
-- Feature A
-- Feature B
+| `COMPATIBILITY.md` | 兼容性矩阵 |
+| `INSTALL.md` | 安装说明 |
+| `testing.md` | 测试策略和覆盖率 |
+
+## 子目录表
+
+| 目录 | 用途 | 文件数 |
+|------|------|--------|
+| `standards/` | 规范体系（P0/P1 文档） | 10+ |
+| `guides/` | 用户指南和教程 | 8+ |
+| `design/` | 设计文档和决策记录 | 5+ |
+| `prd/` | 产品需求文档 | 10+ |
+| `reviews/` | 审查报告和分析 | 15+ |
+| `tasks/` | 任务规划和分解 | 20+ |
+| `troubleshooting/` | 故障排查指南 | 8+ |
+| `superpowers/` | 超级功能说明 | 5+ |
+| `windows/` | Windows 特定文档 | 3+ |
+| `partials/` | 文档片段（用于组合） | 10+ |
+| `shared/` | 共享文档资源 | 5+ |
+
+## 面向 AI 智能体
+
+### 在此目录中工作
+
+1. **更新参考文档**
+   - 修改 `REFERENCE.md` 时更新智能体/skills/hooks/工具列表
+   - 保持版本号和日期同步
+
+2. **编写用户指南**
+   - 在 `guides/` 中创建新指南
+   - 包含代码示例和验证步骤
+   - 链接到相关参考文档
+
+3. **维护架构文档**
+   - 修改 `ARCHITECTURE.md` 时记录设计决策
+   - 更新系统图表和流程图
+   - 保持与实现代码同步
+
+### 修改检查清单
+
+| 修改位置 | 更新文档 |
+|---------|---------|
+| 智能体数量/列表变化 | `REFERENCE.md` |
+| Skills 数量/列表变化 | `REFERENCE.md` |
+| Hooks 数量/列表变化 | `REFERENCE.md` |
+| 工具数量/列表变化 | `REFERENCE.md` |
+| 架构或设计变化 | `ARCHITECTURE.md` |
+| 新功能 | `FEATURES.md` |
+| 破坏性变化 | `MIGRATION.md` |
+| 兼容性问题 | `COMPATIBILITY.md` |
+
+### 常见任务
+
+```bash
+# 查看参考文档
+cat docs/REFERENCE.md
+
+# 查看架构
+cat docs/ARCHITECTURE.md
+
+# 查看用户指南
+ls -la docs/guides/
+
+# 查看规范
+ls -la docs/standards/
 ```
 
-## 依赖
-
-### 内部依赖
-
-- 引用 `agents/` 中的 agents
-- 引用 `skills/` 中的 skills
-- 引用 `src/tools/` 中的工具
-
-### 外部依赖
-
-无——纯 markdown 文件。
+### 文档更新规则
 
-<!-- MANUAL: -->
+- 保留 "Generated" 日期不变
+- 更新 "Updated" 日期为当前日期
+- 版本号与 package.json 同步
+- 所有代码示例必须经过测试
+- 链接必须指向有效的文件或 URL