@liangjie559567/ultrapower 6.0.0 → 7.0.2

package/docs/tasks/v7.0.1/sub_prds/T-001-test-optimization.md

@@ -0,0 +1,66 @@
+# T-001: 测试套件优化
+
+**任务ID**: T-001
+**里程碑**: M1
+**优先级**: P0
+**工期**: 3 天
+**依赖**: None
+
+## 目标
+
+优化测试套件性能，实现快速测试 <5s，完整测试 <15s。
+
+## 验收标准
+
+1. 快速测试（`npm run test:quick`）< 5 秒
+2. 完整测试（`npm test`）< 15 秒
+3. 测试并行化配置完成
+4. 覆盖率保持 >85%
+
+## 实施方案
+
+### 1. 配置测试分层
+
+**vitest.config.ts**:
+```typescript
+export default defineConfig({
+  test: {
+    threads: true,
+    maxThreads: 4,
+    minThreads: 2,
+    isolate: false, // 快速模式禁用隔离
+  }
+});
+```
+
+### 2. 添加快速测试脚本
+
+**package.json**:
+```json
+{
+  "scripts": {
+    "test:quick": "vitest run --reporter=dot --changed",
+    "test": "vitest run"
+  }
+}
+```
+
+### 3. 优化慢速测试
+
+- 使用 `vi.mock()` 替代真实文件系统操作
+- 缓存重复的测试数据
+- 减少不必要的 setup/teardown
+
+## 影响范围
+
+- `vitest.config.ts`
+- `package.json`
+- `tests/**/*.test.ts`（优化慢速测试）
+
+## 验证命令
+
+```bash
+time npm run test:quick  # 应 < 5s
+time npm test            # 应 < 15s
+npm run test:coverage    # 覆盖率 >85%
+```

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@liangjie559567/ultrapower",
-  "version": "6.0.0",
+  "version": "7.0.2",
   "description": "Disciplined multi-agent orchestration: workflow enforcement + parallel execution",
   "type": "module",
   "main": "dist/index.js",
@@ -48,6 +48,7 @@
     "dev": "tsc --watch",
     "start": "node dist/index.js",
     "test": "vitest",
+    "test:quick": "vitest run --config vitest.config.quick.ts --reporter=dot",
     "test:ui": "vitest --ui",
     "test:run": "vitest run",
     "test:coverage": "vitest run --coverage",
@@ -81,6 +82,9 @@
     "@anthropic-ai/claude-agent-sdk": "^0.1.0",
     "@ast-grep/napi": "^0.41.0",
     "@modelcontextprotocol/sdk": "1.27.1",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/sdk-trace-base": "^2.6.0",
+    "@opentelemetry/sdk-trace-node": "^2.6.0",
     "@tokscale/core": "^1.0.25",
     "@types/better-sqlite3": "^7.6.13",
     "ajv": "^8.17.1",

package/scripts/check-version-sync.mjs

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+import { readFileSync } from 'fs';
+import { join } from 'path';
+
+const files = [
+  { path: 'package.json', extract: (c) => JSON.parse(c).version },
+  { path: 'marketplace.json', extract: (c) => JSON.parse(c).version },
+  { path: 'docs/CLAUDE.md', extract: (c) => c.match(/OMC:VERSION:(\S+)/)?.[1] },
+  { path: 'CLAUDE.md', extract: (c) => c.match(/ultrapower v(\S+)/)?.[1] }
+];
+
+const versions = files.map(({ path, extract }) => {
+  try {
+    const content = readFileSync(path, 'utf-8');
+    return { path, version: extract(content) };
+  } catch (e) {
+    return { path, version: null, error: e.message };
+  }
+});
+
+const reference = versions[0].version;
+const mismatches = versions.filter(v => v.version !== reference);
+
+if (mismatches.length > 0) {
+  console.error('❌ Version mismatch detected:');
+  console.error(`   Reference: ${reference} (package.json)`);
+  mismatches.forEach(({ path, version }) => {
+    console.error(`   ${path}: ${version || 'NOT FOUND'}`);
+  });
+  process.exit(1);
+}
+
+console.log(`✅ All versions synchronized: ${reference}`);

package/scripts/fix-agent-headers.py

@@ -1,58 +1,58 @@
-#!/usr/bin/env python3
-import os
-import re
-
-os.chdir('agents.codex')
-for f in os.listdir('.'):
-    if not f.endswith('.md') or f in ['AGENTS.md', 'CONVERSION-GUIDE.md']:
-        continue
-
-    with open(f, 'r', encoding='utf-8') as file:
-        lines = file.readlines()
-
-    # Find frontmatter end
-    fm_end = -1
-    in_fm = False
-    for i, line in enumerate(lines):
-        if line.strip() == '---':
-            if not in_fm:
-                in_fm = True
-            else:
-                fm_end = i
-                break
-
-    if fm_end < 0:
-        continue
-
-    # Generate h1 from filename
-    name = f.replace('.md', '').replace('-', ' ').title()
-
-    # Find first ## 角色 or ## Role
-    new_lines = lines[:fm_end+1]
-    new_lines.append('\n')
-    new_lines.append(f'# {name}\n')
-    new_lines.append('\n')
-
-    # Add rest, skipping duplicate h1s and fixing spacing
-    i = fm_end + 1
-    while i < len(lines):
-        line = lines[i]
-        # Skip empty lines right after frontmatter
-        if i <= fm_end + 3 and line.strip() == '':
-            i += 1
-            continue
-        # Skip duplicate h1
-        if line.startswith('# ') and name.lower() in line.lower():
-            i += 1
-            continue
-        # Skip standalone ## 角色 before h1
-        if i < fm_end + 5 and line.strip() in ['## 角色', '## Role']:
-            i += 1
-            continue
-        new_lines.append(line)
-        i += 1
-
-    with open(f, 'w', encoding='utf-8') as file:
-        file.writelines(new_lines)
-
-    print(f'Fixed: {f}')
+#!/usr/bin/env python3
+import os
+import re
+
+os.chdir('agents.codex')
+for f in os.listdir('.'):
+    if not f.endswith('.md') or f in ['AGENTS.md', 'CONVERSION-GUIDE.md']:
+        continue
+
+    with open(f, 'r', encoding='utf-8') as file:
+        lines = file.readlines()
+
+    # Find frontmatter end
+    fm_end = -1
+    in_fm = False
+    for i, line in enumerate(lines):
+        if line.strip() == '---':
+            if not in_fm:
+                in_fm = True
+            else:
+                fm_end = i
+                break
+
+    if fm_end < 0:
+        continue
+
+    # Generate h1 from filename
+    name = f.replace('.md', '').replace('-', ' ').title()
+
+    # Find first ## 角色 or ## Role
+    new_lines = lines[:fm_end+1]
+    new_lines.append('\n')
+    new_lines.append(f'# {name}\n')
+    new_lines.append('\n')
+
+    # Add rest, skipping duplicate h1s and fixing spacing
+    i = fm_end + 1
+    while i < len(lines):
+        line = lines[i]
+        # Skip empty lines right after frontmatter
+        if i <= fm_end + 3 and line.strip() == '':
+            i += 1
+            continue
+        # Skip duplicate h1
+        if line.startswith('# ') and name.lower() in line.lower():
+            i += 1
+            continue
+        # Skip standalone ## 角色 before h1
+        if i < fm_end + 5 and line.strip() in ['## 角色', '## Role']:
+            i += 1
+            continue
+        new_lines.append(line)
+        i += 1
+
+    with open(f, 'w', encoding='utf-8') as file:
+        file.writelines(new_lines)
+
+    print(f'Fixed: {f}')

package/scripts/fix-blank-lines.py

@@ -1,19 +1,19 @@
-#!/usr/bin/env python3
-import os
-import re
-
-os.chdir('agents.codex')
-for f in os.listdir('.'):
-    if not f.endswith('.md'):
-        continue
-
-    with open(f, 'r', encoding='utf-8') as file:
-        content = file.read()
-
-    # Replace 3+ newlines with 2 newlines
-    fixed = re.sub(r'\n{3,}', '\n\n', content)
-
-    with open(f, 'w', encoding='utf-8') as file:
-        file.write(fixed)
-
-    print(f'Fixed: {f}')
+#!/usr/bin/env python3
+import os
+import re
+
+os.chdir('agents.codex')
+for f in os.listdir('.'):
+    if not f.endswith('.md'):
+        continue
+
+    with open(f, 'r', encoding='utf-8') as file:
+        content = file.read()
+
+    # Replace 3+ newlines with 2 newlines
+    fixed = re.sub(r'\n{3,}', '\n\n', content)
+
+    with open(f, 'w', encoding='utf-8') as file:
+        file.write(fixed)
+
+    print(f'Fixed: {f}')

package/scripts/fix-long-lines.py

@@ -1,41 +1,41 @@
-#!/usr/bin/env python3
-import os
-import re
-
-os.chdir('agents.codex')
-
-# Files and line numbers to fix
-fixes = {
-    'code-reviewer.md': [44],
-    'build-fixer.md': [74],
-    'axiom-tech-lead.md': [10],
-}
-
-for filename, line_nums in fixes.items():
-    with open(filename, 'r', encoding='utf-8') as f:
-        lines = f.readlines()
-
-    for line_num in line_nums:
-        idx = line_num - 1
-        if idx < len(lines):
-            line = lines[idx].rstrip()
-            if len(line) > 80:
-                # Split at appropriate point
-                if '。' in line:
-                    parts = line.split('。')
-                    if len(parts) > 1:
-                        lines[idx] = parts[0] + '。\n'
-                        lines.insert(idx + 1, '  ' + '。'.join(parts[1:]) + '\n')
-                elif '，' in line and len(line) > 100:
-                    # Find good split point around middle
-                    mid = len(line) // 2
-                    for i in range(mid - 20, mid + 20):
-                        if i < len(line) and line[i] == '，':
-                            lines[idx] = line[:i+1] + '\n'
-                            lines.insert(idx + 1, '  ' + line[i+1:] + '\n')
-                            break
-
-    with open(filename, 'w', encoding='utf-8') as f:
-        f.writelines(lines)
-
-    print(f'Fixed: {filename}')
+#!/usr/bin/env python3
+import os
+import re
+
+os.chdir('agents.codex')
+
+# Files and line numbers to fix
+fixes = {
+    'code-reviewer.md': [44],
+    'build-fixer.md': [74],
+    'axiom-tech-lead.md': [10],
+}
+
+for filename, line_nums in fixes.items():
+    with open(filename, 'r', encoding='utf-8') as f:
+        lines = f.readlines()
+
+    for line_num in line_nums:
+        idx = line_num - 1
+        if idx < len(lines):
+            line = lines[idx].rstrip()
+            if len(line) > 80:
+                # Split at appropriate point
+                if '。' in line:
+                    parts = line.split('。')
+                    if len(parts) > 1:
+                        lines[idx] = parts[0] + '。\n'
+                        lines.insert(idx + 1, '  ' + '。'.join(parts[1:]) + '\n')
+                elif '，' in line and len(line) > 100:
+                    # Find good split point around middle
+                    mid = len(line) // 2
+                    for i in range(mid - 20, mid + 20):
+                        if i < len(line) and line[i] == '，':
+                            lines[idx] = line[:i+1] + '\n'
+                            lines.insert(idx + 1, '  ' + line[i+1:] + '\n')
+                            break
+
+    with open(filename, 'w', encoding='utf-8') as f:
+        f.writelines(lines)
+
+    print(f'Fixed: {filename}')

package/scripts/migrate-console-to-logger.ts

@@ -0,0 +1,91 @@
+import { readFileSync, writeFileSync, readdirSync, statSync } from 'fs';
+import { join } from 'path';
+
+const KEEP_CONSOLE = [
+  'stats.ts', 'cost.ts', 'sessions.ts', 'teleport.ts', 'wait.ts', 'backfill.ts',
+  'dashboard.ts', 'example.ts', 'test-categories.ts', 'tutorial',
+];
+
+function walkDir(dir: string, files: string[] = []): string[] {
+  const entries = readdirSync(dir);
+  for (const entry of entries) {
+    const path = join(dir, entry);
+    if (statSync(path).isDirectory()) {
+      if (!entry.includes('__tests__') && !entry.includes('node_modules')) {
+        walkDir(path, files);
+      }
+    } else if (entry.endsWith('.ts') && !entry.endsWith('.test.ts')) {
+      files.push(path);
+    }
+  }
+  return files;
+}
+
+function shouldMigrate(filePath: string): boolean {
+  const name = filePath.split('\\').pop() || '';
+  const dir = filePath.split('\\').slice(-2, -1)[0] || '';
+  return !KEEP_CONSOLE.some(keep => name === keep || dir === keep || filePath.includes(keep));
+}
+
+function getContextName(filePath: string): string {
+  const parts = filePath.replace(/\\/g, '/').split('/');
+  const fileName = parts[parts.length - 1].replace('.ts', '');
+  const dirName = parts[parts.length - 2];
+  return `${dirName}:${fileName}`;
+}
+
+function migrateFile(filePath: string): { changed: boolean; before: number; after: number } {
+  let content = readFileSync(filePath, 'utf-8');
+  const beforeCount = (content.match(/console\.(log|error|warn|info)/g) || []).length;
+
+  if (beforeCount === 0) return { changed: false, before: 0, after: 0 };
+
+  const hasLogger = content.includes('createLogger') || content.includes('from \'../lib/unified-logger');
+
+  if (!hasLogger) {
+    const importMatch = content.match(/^(import .+;\n)+/m);
+    const contextName = getContextName(filePath);
+    const depth = filePath.split('\\').length - 2;
+    const prefix = '../'.repeat(depth);
+    const loggerImport = `import { createLogger } from '${prefix}lib/unified-logger.js';\nconst logger = createLogger('${contextName}');\n\n`;
+
+    if (importMatch) {
+      content = content.replace(importMatch[0], importMatch[0] + loggerImport);
+    } else {
+      content = loggerImport + content;
+    }
+  }
+
+  content = content.replace(/console\.log\(/g, 'logger.info(');
+  content = content.replace(/console\.error\(/g, 'logger.error(');
+  content = content.replace(/console\.warn\(/g, 'logger.warn(');
+  content = content.replace(/console\.info\(/g, 'logger.info(');
+
+  const afterCount = (content.match(/console\.(log|error|warn|info)/g) || []).length;
+
+  if (beforeCount !== afterCount) {
+    writeFileSync(filePath, content, 'utf-8');
+    return { changed: true, before: beforeCount, after: afterCount };
+  }
+
+  return { changed: false, before: beforeCount, after: afterCount };
+}
+
+const files = walkDir('src');
+let totalBefore = 0;
+let totalAfter = 0;
+let filesChanged = 0;
+
+for (const file of files) {
+  if (shouldMigrate(file)) {
+    const result = migrateFile(file);
+    if (result.changed) {
+      filesChanged++;
+      console.log(`✓ ${file}: ${result.before} → ${result.after}`);
+    }
+    totalBefore += result.before;
+    totalAfter += result.after;
+  }
+}
+
+console.log(`\n迁移完成: ${filesChanged} 个文件, ${totalBefore} → ${totalAfter} console 调用`);