@liangjie559567/ultrapower 7.6.0 → 7.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (72) hide show
  1. package/.claude-plugin/marketplace.json +2 -2
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/README.md +2 -2
  4. package/bridge/mcp-server.cjs +1 -0
  5. package/dist/hooks/bridge-normalize.d.ts.map +1 -1
  6. package/dist/hooks/bridge-normalize.js +47 -25
  7. package/dist/hooks/bridge-normalize.js.map +1 -1
  8. package/dist/lib/atomic-write.d.ts.map +1 -1
  9. package/dist/lib/atomic-write.js +2 -0
  10. package/dist/lib/atomic-write.js.map +1 -1
  11. package/dist/lib/auditLog.d.ts +6 -7
  12. package/dist/lib/auditLog.d.ts.map +1 -1
  13. package/dist/lib/auditLog.js +10 -7
  14. package/dist/lib/auditLog.js.map +1 -1
  15. package/dist/lib/logger.d.ts.map +1 -1
  16. package/dist/lib/logger.js +9 -4
  17. package/dist/lib/logger.js.map +1 -1
  18. package/dist/lib/path-validator.d.ts.map +1 -1
  19. package/dist/lib/path-validator.js +12 -12
  20. package/dist/lib/path-validator.js.map +1 -1
  21. package/dist/security/concurrency-control.d.ts +7 -0
  22. package/dist/security/concurrency-control.d.ts.map +1 -1
  23. package/dist/security/concurrency-control.js +22 -0
  24. package/dist/security/concurrency-control.js.map +1 -1
  25. package/docs/CLAUDE.md +2 -2
  26. package/docs/CODE_BASED_FLOW.md +12 -12
  27. package/docs/COMPATIBILITY.md +1 -1
  28. package/docs/FEATURES.md +16 -16
  29. package/docs/INSTALL.md +4 -4
  30. package/docs/MIGRATION.md +2 -2
  31. package/docs/OMC-CLAUDE.md +1 -1
  32. package/docs/REFERENCE.md +16 -16
  33. package/docs/UPGRADE_VERIFICATION.md +1 -1
  34. package/docs/agent-templates/README.md +2 -2
  35. package/docs/api/media/INSTALL.md +2 -2
  36. package/docs/api/media/MIGRATION.md +2 -2
  37. package/docs/api/media/REFERENCE.md +14 -14
  38. package/docs/api/media/mcp-server-usage.md +4 -4
  39. package/docs/architecture/ultrapower-flow-analysis.md +1 -1
  40. package/docs/getting-started/quickstart.md +1 -1
  41. package/docs/glossary.md +1 -1
  42. package/docs/guides/mcp-server-usage.md +4 -4
  43. package/docs/guides/tool-name-migration.md +12 -12
  44. package/docs/mcp/configuration.md +5 -5
  45. package/docs/mcp/performance.md +5 -5
  46. package/docs/mcp-compatibility-matrix.md +1 -1
  47. package/docs/partials/agent-tiers.md +24 -24
  48. package/docs/partials/features.md +1 -1
  49. package/docs/partials/verification-tiers.md +2 -2
  50. package/docs/plans/2026-02-24-superpowers-ultrapower-integration-design.md +2 -2
  51. package/docs/plans/2026-03-02-docs-comprehensive-update.md +16 -16
  52. package/docs/plans/2026-03-05-mcp-adoption-atomic-tasks.md +9 -9
  53. package/docs/plans/2026-03-16-tech-debt-fixes.md +222 -0
  54. package/docs/prd/bugs-pain-points-audit-dag.md +297 -297
  55. package/docs/prd/bugs-pain-points-audit-draft.md +154 -154
  56. package/docs/prd/bugs-pain-points-audit-manifest.md +650 -650
  57. package/docs/prd/bugs-pain-points-audit-rough.md +654 -654
  58. package/docs/reports/tech-debt-verification-2026-03-16.md +87 -0
  59. package/docs/reviews/bugs-pain-points-audit/review_critic.md +213 -213
  60. package/docs/reviews/bugs-pain-points-audit/review_domain.md +247 -247
  61. package/docs/reviews/bugs-pain-points-audit/review_product.md +189 -189
  62. package/docs/reviews/bugs-pain-points-audit/review_tech.md +382 -382
  63. package/docs/reviews/bugs-pain-points-audit/review_ux.md +161 -161
  64. package/docs/reviews/bugs-pain-points-audit/summary.md +129 -129
  65. package/docs/reviews/bugs-pain-points-audit/tech-debt-v7.6.0-code-review.md +328 -0
  66. package/docs/shared/agent-tiers.md +24 -24
  67. package/docs/shared/features.md +1 -1
  68. package/docs/shared/verification-tiers.md +2 -2
  69. package/docs/standards/README.md +1 -1
  70. package/docs/standards/runtime-protection.md +7 -0
  71. package/docs/troubleshooting.md +1 -1
  72. package/package.json +1 -1
package/docs/FEATURES.md CHANGED
@@ -288,7 +288,7 @@ project_memory_add_directive(directive: string): boolean
288
288
  { "category": "architecture", "content": "...", "timestamp": "2026-03-02" }
289
289
  ],
290
290
  "directives": [
291
- "始终在修改文件前运行 lsp_diagnostics",
291
+ "始终在修改文件前运行 ultrapower:lsp_diagnostics",
292
292
  "禁止直接修改 main 分支"
293
293
  ]
294
294
  }
@@ -313,24 +313,24 @@ ultrapower 通过 Language Server Protocol、AST-grep 和 Python REPL 提供类
313
313
 
314
314
  | 工具 | 描述 |
315
315
  | ------ | ------ |
316
- | `lsp_hover` | 获取光标位置的类型信息和文档注释 |
317
- | `lsp_goto_definition` | 跳转到符号的定义位置 |
318
- | `lsp_find_references` | 查找符号在整个代码库中的所有引用 |
319
- | `lsp_document_symbols` | 获取文件的符号大纲(函数、类、变量) |
320
- | `lsp_workspace_symbols` | 跨工作区搜索符号 |
321
- | `lsp_diagnostics` | 获取单个文件的错误和警告 |
322
- | `lsp_diagnostics_directory` | 项目级类型检查(优先使用 `tsc --noEmit`,回退到 LSP) |
323
- | `lsp_servers` | 列出当前可用的语言服务器 |
324
- | `lsp_prepare_rename` | 检查符号是否可安全重命名 |
325
- | `lsp_rename` | 预览并执行跨文件重命名重构 |
326
- | `lsp_code_actions` | 获取可用的快速修复和重构操作 |
327
- | `lsp_code_action_resolve` | 获取特定代码操作的详细信息 |
316
+ | `ultrapower:lsp_hover` | 获取光标位置的类型信息和文档注释 |
317
+ | `ultrapower:lsp_goto_definition` | 跳转到符号的定义位置 |
318
+ | `ultrapower:lsp_find_references` | 查找符号在整个代码库中的所有引用 |
319
+ | `ultrapower:lsp_document_symbols` | 获取文件的符号大纲(函数、类、变量) |
320
+ | `ultrapower:lsp_workspace_symbols` | 跨工作区搜索符号 |
321
+ | `ultrapower:lsp_diagnostics` | 获取单个文件的错误和警告 |
322
+ | `ultrapower:lsp_diagnostics_directory` | 项目级类型检查(优先使用 `tsc --noEmit`,回退到 LSP) |
323
+ | `ultrapower:lsp_servers` | 列出当前可用的语言服务器 |
324
+ | `ultrapower:lsp_prepare_rename` | 检查符号是否可安全重命名 |
325
+ | `ultrapower:lsp_rename` | 预览并执行跨文件重命名重构 |
326
+ | `ultrapower:lsp_code_actions` | 获取可用的快速修复和重构操作 |
327
+ | `ultrapower:lsp_code_action_resolve` | 获取特定代码操作的详细信息 |
328
328
 
329
329
  **支持语言:** TypeScript、JavaScript、Python、Rust、Go、C/C++、Java、JSON、HTML、CSS、YAML
330
330
 
331
331
  #### 诊断策略
332
332
 
333
- `lsp_diagnostics_directory` 使用双策略方法:
333
+ `ultrapower:lsp_diagnostics_directory` 使用双策略方法:
334
334
 
335
335
  ```typescript
336
336
  type DiagnosticsStrategy = 'tsc' | 'lsp' | 'auto';
@@ -343,14 +343,14 @@ type DiagnosticsStrategy = 'tsc' | 'lsp' | 'auto';
343
343
 
344
344
  ```typescript
345
345
  // 在修改文件后立即验证
346
- const diagnostics = await lsp_diagnostics({ file: 'src/foo.ts' });
346
+ const diagnostics = await ultrapower:lsp_diagnostics({ file: 'src/foo.ts' });
347
347
  if (diagnostics.errorCount > 0) {
348
348
  // 在生产代码中修复,而非测试 hack
349
349
  console.error(diagnostics.messages);
350
350
  }
351
351
 
352
352
  // 项目级检查
353
- const result = await lsp_diagnostics_directory({ directory: process.cwd() });
353
+ const result = await ultrapower:lsp_diagnostics_directory({ directory: process.cwd() });
354
354
  console.log(`${result.errorCount} errors, ${result.warningCount} warnings`);
355
355
  ```
356
356
 
package/docs/INSTALL.md CHANGED
@@ -1,6 +1,6 @@
1
1
  # ultrapower 安装部署详细教程
2
2
 
3
- ultrapower v7.6.0 完整安装指南,覆盖从零开始到完全配置的所有步骤。
3
+ ultrapower v7.7.1 完整安装指南,覆盖从零开始到完全配置的所有步骤。
4
4
 
5
5
  ---
6
6
 
@@ -54,7 +54,7 @@ ultrapower v7.6.0 完整安装指南,覆盖从零开始到完全配置的所
54
54
  | 依赖 | 用途 |
55
55
  | ------ | ------ |
56
56
  | Python 3.8+ | python_repl 工具、nexus 守护进程 |
57
- | TypeScript LSP | lsp_* 代码智能工具 |
57
+ | TypeScript LSP | ultrapower:lsp_* 代码智能工具 |
58
58
  | ast-grep | ast_grep_search/replace 工具 |
59
59
 
60
60
  ### 验证环境
@@ -102,7 +102,7 @@ git --version
102
102
 
103
103
  **预期输出:**
104
104
  ```
105
- ✓ Installing ultrapower v7.6.0...
105
+ ✓ Installing ultrapower v7.7.1...
106
106
  ✓ Hooks registered: 39
107
107
  ✓ Agents loaded: 49
108
108
  ✓ Skills available: 71
@@ -584,7 +584,7 @@ cat ~/.claude/settings.json | grep hooks
584
584
 
585
585
  ### 问题:LSP 工具在 Windows 上失败
586
586
 
587
- **症状**:`lsp_hover`、`lsp_goto_definition` 等工具报错
587
+ **症状**:`ultrapower:lsp_hover`、`ultrapower:lsp_goto_definition` 等工具报错
588
588
 
589
589
  **解决**:确保 Node.js 在 PATH 中,LSP 服务器需要 `.cmd` 扩展名支持(v5.5.33 已修复)。
590
590
 
package/docs/MIGRATION.md CHANGED
@@ -272,7 +272,7 @@ v5.0 集成了 superpowers skill 系统,将 Agent 数量从 28 扩展至 31,
272
272
 
273
273
  **新工具集成:**
274
274
 
275
- * LSP 工具(12 个):`lsp_hover`、`lsp_goto_definition`、`lsp_find_references` 等
275
+ * LSP 工具(12 个):`ultrapower:lsp_hover`、`ultrapower:lsp_goto_definition`、`ultrapower:lsp_find_references` 等
276
276
 
277
277
  * AST 工具:`ast_grep_search`、`ast_grep_replace`
278
278
 
@@ -885,7 +885,7 @@ Version 3.1 是一个小版本,在保持与 v3.0 完全向后兼容的同时
885
885
 
886
886
  #### 3. Directory Diagnostics Tool
887
887
 
888
- 通过 `lsp_diagnostics_directory` 工具进行项目级类型检查。
888
+ 通过 `ultrapower:lsp_diagnostics_directory` 工具进行项目级类型检查。
889
889
 
890
890
  **策略:**
891
891
 
@@ -235,7 +235,7 @@ Notepad(会话记忆,位于 `{worktree}/.omc/notepad.md`):
235
235
 
236
236
  代码智能:
237
237
 
238
- * LSP:`lsp_hover`、`lsp_goto_definition`、`lsp_find_references`、`lsp_document_symbols`、`lsp_workspace_symbols`、`lsp_diagnostics`、`lsp_diagnostics_directory`、`lsp_prepare_rename`、`lsp_rename`、`lsp_code_actions`、`lsp_code_action_resolve`、`lsp_servers`
238
+ * LSP:`ultrapower:lsp_hover`、`ultrapower:lsp_goto_definition`、`ultrapower:lsp_find_references`、`ultrapower:lsp_document_symbols`、`ultrapower:lsp_workspace_symbols`、`ultrapower:lsp_diagnostics`、`ultrapower:lsp_diagnostics_directory`、`ultrapower:lsp_prepare_rename`、`ultrapower:lsp_rename`、`ultrapower:lsp_code_actions`、`ultrapower:lsp_code_action_resolve`、`ultrapower:lsp_servers`
239
239
 
240
240
  * AST:`ast_grep_search`(结构化代码模式搜索)、`ast_grep_replace`(结构化转换)
241
241
 
package/docs/REFERENCE.md CHANGED
@@ -1,4 +1,4 @@
1
- <!-- ultrapower v7.6.0 | updated: 2026-03-02 -->
1
+ <!-- ultrapower v7.7.1 | updated: 2026-03-02 -->
2
2
 
3
3
  # ultrapower Reference — v5.5.33
4
4
 
@@ -564,7 +564,7 @@ ultrapower exposes **35 custom tools** via the `mcp__plugin_ultrapower_t__` pref
564
564
 
565
565
  | Category | Count | Tool Prefix |
566
566
  | ---------- | ------- | ------------- |
567
- | LSP (Language Server Protocol) | 12 | `lsp_*` |
567
+ | LSP (Language Server Protocol) | 12 | `ultrapower:lsp_*` |
568
568
  | AST (Structured code search) | 2 | `ast_grep_*` |
569
569
  | Python REPL | 1 | `python_repl` |
570
570
  | Notepad (Session memory) | 6 | `notepad_*` |
@@ -599,7 +599,7 @@ mcp__plugin_ultrapower_t__lsp_code_action_resolve -- Get action details
599
599
 
600
600
  Supported languages: TypeScript, Python, Rust, Go, C/C++, Java, JSON, HTML, CSS, YAML.
601
601
 
602
- > **Note**: LSP tools require language server installation (typescript-language-server, pylsp, rust-analyzer, gopls, etc.). Use `lsp_servers` to check installation status.
602
+ > **Note**: LSP tools require language server installation (typescript-language-server, pylsp, rust-analyzer, gopls, etc.). Use `ultrapower:lsp_servers` to check installation status.
603
603
 
604
604
  ---
605
605
 
@@ -820,18 +820,18 @@ ultrapower exposes 32 custom tools through the MCP server using the `mcp__plugin
820
820
 
821
821
  | Tool | MCP Name | Description |
822
822
  | ------ | ---------- | ------------- |
823
- | `lsp_hover` | `mcp__plugin_ultrapower_t__lsp_hover` | Get type information and documentation at cursor position |
824
- | `lsp_goto_definition` | `mcp__plugin_ultrapower_t__lsp_goto_definition` | Find definition location of a symbol |
825
- | `lsp_find_references` | `mcp__plugin_ultrapower_t__lsp_find_references` | Find all references to a symbol across codebase |
826
- | `lsp_document_symbols` | `mcp__plugin_ultrapower_t__lsp_document_symbols` | Get hierarchical outline of symbols in a file |
827
- | `lsp_workspace_symbols` | `mcp__plugin_ultrapower_t__lsp_workspace_symbols` | Search for symbols by name across workspace |
828
- | `lsp_diagnostics` | `mcp__plugin_ultrapower_t__lsp_diagnostics` | Get language server diagnostics for a file |
829
- | `lsp_diagnostics_directory` | `mcp__plugin_ultrapower_t__lsp_diagnostics_directory` | Run project-level diagnostics on a directory |
830
- | `lsp_servers` | `mcp__plugin_ultrapower_t__lsp_servers` | List all known language servers and installation status |
831
- | `lsp_prepare_rename` | `mcp__plugin_ultrapower_t__lsp_prepare_rename` | Check if a symbol can be renamed |
832
- | `lsp_rename` | `mcp__plugin_ultrapower_t__lsp_rename` | Rename a symbol across all files in project |
833
- | `lsp_code_actions` | `mcp__plugin_ultrapower_t__lsp_code_actions` | Get available code actions (refactorings, quick fixes) |
834
- | `lsp_code_action_resolve` | `mcp__plugin_ultrapower_t__lsp_code_action_resolve` | Get full edit details for a specific code action |
823
+ | `ultrapower:lsp_hover` | `mcp__plugin_ultrapower_t__lsp_hover` | Get type information and documentation at cursor position |
824
+ | `ultrapower:lsp_goto_definition` | `mcp__plugin_ultrapower_t__lsp_goto_definition` | Find definition location of a symbol |
825
+ | `ultrapower:lsp_find_references` | `mcp__plugin_ultrapower_t__lsp_find_references` | Find all references to a symbol across codebase |
826
+ | `ultrapower:lsp_document_symbols` | `mcp__plugin_ultrapower_t__lsp_document_symbols` | Get hierarchical outline of symbols in a file |
827
+ | `ultrapower:lsp_workspace_symbols` | `mcp__plugin_ultrapower_t__lsp_workspace_symbols` | Search for symbols by name across workspace |
828
+ | `ultrapower:lsp_diagnostics` | `mcp__plugin_ultrapower_t__lsp_diagnostics` | Get language server diagnostics for a file |
829
+ | `ultrapower:lsp_diagnostics_directory` | `mcp__plugin_ultrapower_t__lsp_diagnostics_directory` | Run project-level diagnostics on a directory |
830
+ | `ultrapower:lsp_servers` | `mcp__plugin_ultrapower_t__lsp_servers` | List all known language servers and installation status |
831
+ | `ultrapower:lsp_prepare_rename` | `mcp__plugin_ultrapower_t__lsp_prepare_rename` | Check if a symbol can be renamed |
832
+ | `ultrapower:lsp_rename` | `mcp__plugin_ultrapower_t__lsp_rename` | Rename a symbol across all files in project |
833
+ | `ultrapower:lsp_code_actions` | `mcp__plugin_ultrapower_t__lsp_code_actions` | Get available code actions (refactorings, quick fixes) |
834
+ | `ultrapower:lsp_code_action_resolve` | `mcp__plugin_ultrapower_t__lsp_code_action_resolve` | Get full edit details for a specific code action |
835
835
 
836
836
  #### AST Tools (2)
837
837
 
@@ -1130,7 +1130,7 @@ Available presets: `minimal`, `focused`, `full`, `dense`, `analytics`, `opencode
1130
1130
 
1131
1131
  ## Security Features
1132
1132
 
1133
- ultrapower v7.6.0 includes comprehensive security hardening:
1133
+ ultrapower v7.7.1 includes comprehensive security hardening:
1134
1134
 
1135
1135
  ### Audit Logging
1136
1136
 
@@ -227,7 +227,7 @@ analyze this codebase
227
227
 
228
228
  ```
229
229
 
230
- AI 应能调用 `lsp_hover`、`lsp_diagnostics` 等工具。
230
+ AI 应能调用 `ultrapower:lsp_hover`、`ultrapower:lsp_diagnostics` 等工具。
231
231
 
232
232
  ### 检查点 6: 状态文件路径
233
233
 
@@ -82,7 +82,7 @@ You execute simple, well-defined code changes quickly and efficiently. Handle si
82
82
 
83
83
  * Make the requested changes
84
84
 
85
- * Run lsp_diagnostics on changed files
85
+ * Run ultrapower:lsp_diagnostics on changed files
86
86
 
87
87
  * Verify changes compile/pass basic checks
88
88
 
@@ -90,7 +90,7 @@ You execute simple, well-defined code changes quickly and efficiently. Handle si
90
90
 
91
91
  * Modified file(s)
92
92
 
93
- * lsp_diagnostics output showing no new errors
93
+ * ultrapower:lsp_diagnostics output showing no new errors
94
94
 
95
95
  * Brief summary of changes made
96
96
  ```
@@ -45,7 +45,7 @@ ultrapower v5.2.2 完整安装指南,覆盖从零开始到完全配置的所
45
45
  | 依赖 | 用途 |
46
46
  | ------ | ------ |
47
47
  | Python 3.8+ | python_repl 工具、nexus 守护进程 |
48
- | TypeScript LSP | lsp_* 代码智能工具 |
48
+ | TypeScript LSP | ultrapower:lsp_* 代码智能工具 |
49
49
  | ast-grep | ast_grep_search/replace 工具 |
50
50
 
51
51
  ### 验证环境
@@ -565,7 +565,7 @@ cat ~/.claude/settings.json | grep hooks
565
565
 
566
566
  ### 问题:LSP 工具在 Windows 上失败
567
567
 
568
- **症状**:`lsp_hover`、`lsp_goto_definition` 等工具报错
568
+ **症状**:`ultrapower:lsp_hover`、`ultrapower:lsp_goto_definition` 等工具报错
569
569
 
570
570
  **解决**:确保 Node.js 在 PATH 中,LSP 服务器需要 `.cmd` 扩展名支持(v5.2.2 已修复)。
571
571
 
@@ -272,7 +272,7 @@ v5.0 集成了 superpowers skill 系统,将 Agent 数量从 28 扩展至 31,
272
272
 
273
273
  **新工具集成:**
274
274
 
275
- * LSP 工具(12 个):`lsp_hover`、`lsp_goto_definition`、`lsp_find_references` 等
275
+ * LSP 工具(12 个):`ultrapower:lsp_hover`、`ultrapower:lsp_goto_definition`、`ultrapower:lsp_find_references` 等
276
276
 
277
277
  * AST 工具:`ast_grep_search`、`ast_grep_replace`
278
278
 
@@ -885,7 +885,7 @@ Version 3.1 是一个小版本,在保持与 v3.0 完全向后兼容的同时
885
885
 
886
886
  #### 3. Directory Diagnostics Tool
887
887
 
888
- 通过 `lsp_diagnostics_directory` 工具进行项目级类型检查。
888
+ 通过 `ultrapower:lsp_diagnostics_directory` 工具进行项目级类型检查。
889
889
 
890
890
  **策略:**
891
891
 
@@ -564,7 +564,7 @@ ultrapower exposes **35 custom tools** via the `mcp__plugin_ultrapower_t__` pref
564
564
 
565
565
  | Category | Count | Tool Prefix |
566
566
  | ---------- | ------- | ------------- |
567
- | LSP (Language Server Protocol) | 12 | `lsp_*` |
567
+ | LSP (Language Server Protocol) | 12 | `ultrapower:lsp_*` |
568
568
  | AST (Structured code search) | 2 | `ast_grep_*` |
569
569
  | Python REPL | 1 | `python_repl` |
570
570
  | Notepad (Session memory) | 6 | `notepad_*` |
@@ -599,7 +599,7 @@ mcp__plugin_ultrapower_t__lsp_code_action_resolve -- Get action details
599
599
 
600
600
  Supported languages: TypeScript, Python, Rust, Go, C/C++, Java, JSON, HTML, CSS, YAML.
601
601
 
602
- > **Note**: LSP tools require language server installation (typescript-language-server, pylsp, rust-analyzer, gopls, etc.). Use `lsp_servers` to check installation status.
602
+ > **Note**: LSP tools require language server installation (typescript-language-server, pylsp, rust-analyzer, gopls, etc.). Use `ultrapower:lsp_servers` to check installation status.
603
603
 
604
604
  ---
605
605
 
@@ -820,18 +820,18 @@ ultrapower exposes 32 custom tools through the MCP server using the `mcp__plugin
820
820
 
821
821
  | Tool | MCP Name | Description |
822
822
  | ------ | ---------- | ------------- |
823
- | `lsp_hover` | `mcp__plugin_ultrapower_t__lsp_hover` | Get type information and documentation at cursor position |
824
- | `lsp_goto_definition` | `mcp__plugin_ultrapower_t__lsp_goto_definition` | Find definition location of a symbol |
825
- | `lsp_find_references` | `mcp__plugin_ultrapower_t__lsp_find_references` | Find all references to a symbol across codebase |
826
- | `lsp_document_symbols` | `mcp__plugin_ultrapower_t__lsp_document_symbols` | Get hierarchical outline of symbols in a file |
827
- | `lsp_workspace_symbols` | `mcp__plugin_ultrapower_t__lsp_workspace_symbols` | Search for symbols by name across workspace |
828
- | `lsp_diagnostics` | `mcp__plugin_ultrapower_t__lsp_diagnostics` | Get language server diagnostics for a file |
829
- | `lsp_diagnostics_directory` | `mcp__plugin_ultrapower_t__lsp_diagnostics_directory` | Run project-level diagnostics on a directory |
830
- | `lsp_servers` | `mcp__plugin_ultrapower_t__lsp_servers` | List all known language servers and installation status |
831
- | `lsp_prepare_rename` | `mcp__plugin_ultrapower_t__lsp_prepare_rename` | Check if a symbol can be renamed |
832
- | `lsp_rename` | `mcp__plugin_ultrapower_t__lsp_rename` | Rename a symbol across all files in project |
833
- | `lsp_code_actions` | `mcp__plugin_ultrapower_t__lsp_code_actions` | Get available code actions (refactorings, quick fixes) |
834
- | `lsp_code_action_resolve` | `mcp__plugin_ultrapower_t__lsp_code_action_resolve` | Get full edit details for a specific code action |
823
+ | `ultrapower:lsp_hover` | `mcp__plugin_ultrapower_t__lsp_hover` | Get type information and documentation at cursor position |
824
+ | `ultrapower:lsp_goto_definition` | `mcp__plugin_ultrapower_t__lsp_goto_definition` | Find definition location of a symbol |
825
+ | `ultrapower:lsp_find_references` | `mcp__plugin_ultrapower_t__lsp_find_references` | Find all references to a symbol across codebase |
826
+ | `ultrapower:lsp_document_symbols` | `mcp__plugin_ultrapower_t__lsp_document_symbols` | Get hierarchical outline of symbols in a file |
827
+ | `ultrapower:lsp_workspace_symbols` | `mcp__plugin_ultrapower_t__lsp_workspace_symbols` | Search for symbols by name across workspace |
828
+ | `ultrapower:lsp_diagnostics` | `mcp__plugin_ultrapower_t__lsp_diagnostics` | Get language server diagnostics for a file |
829
+ | `ultrapower:lsp_diagnostics_directory` | `mcp__plugin_ultrapower_t__lsp_diagnostics_directory` | Run project-level diagnostics on a directory |
830
+ | `ultrapower:lsp_servers` | `mcp__plugin_ultrapower_t__lsp_servers` | List all known language servers and installation status |
831
+ | `ultrapower:lsp_prepare_rename` | `mcp__plugin_ultrapower_t__lsp_prepare_rename` | Check if a symbol can be renamed |
832
+ | `ultrapower:lsp_rename` | `mcp__plugin_ultrapower_t__lsp_rename` | Rename a symbol across all files in project |
833
+ | `ultrapower:lsp_code_actions` | `mcp__plugin_ultrapower_t__lsp_code_actions` | Get available code actions (refactorings, quick fixes) |
834
+ | `ultrapower:lsp_code_action_resolve` | `mcp__plugin_ultrapower_t__lsp_code_action_resolve` | Get full edit details for a specific code action |
835
835
 
836
836
  #### AST Tools (2)
837
837
 
@@ -70,8 +70,8 @@ Edit `~/.claude/claude_desktop_config.json`:
70
70
  After configuration, restart Claude Desktop. The MCP server tools should appear in the tool list:
71
71
 
72
72
  ```
73
- mcp__plugin_ultrapower_t__ultrapower:lsp_hover
74
- mcp__plugin_ultrapower_t__ultrapower:lsp_goto_definition
73
+ mcp__plugin_ultrapower_t__lsp_hover
74
+ mcp__plugin_ultrapower_t__lsp_goto_definition
75
75
  mcp__plugin_ultrapower_t__ultrapower:ast_grep_search
76
76
  ... (64 tools total - each tool has both new and legacy names)
77
77
  ```
@@ -121,12 +121,12 @@ Restart Cursor. Check the MCP panel to confirm the server is connected and all 3
121
121
 
122
122
  Get type information at cursor position:
123
123
  ```
124
- Use mcp__plugin_ultrapower_t__ultrapower:lsp_hover with file and position
124
+ Use mcp__plugin_ultrapower_t__lsp_hover with file and position
125
125
  ```
126
126
 
127
127
  Find all references to a symbol:
128
128
  ```
129
- Use mcp__plugin_ultrapower_t__ultrapower:lsp_find_references to locate usage
129
+ Use mcp__plugin_ultrapower_t__lsp_find_references to locate usage
130
130
  ```
131
131
 
132
132
  ### AST Tools
@@ -574,7 +574,7 @@ ultrapower 提供内置 MCP 服务器,暴露以下工具类别:
574
574
  - **状态管理**: `state_read`, `state_write`, `state_clear`, `state_list_active`, `state_get_status`
575
575
  - **Notepad**: `notepad_read`, `notepad_priority`, `notepad_working`, `notepad_manual`, `notepad_prune`
576
576
  - **项目记忆**: `mem_read`, `mem_write`, `mem_add_note`, `mem_add_directive`
577
- - **LSP 工具**: `lsp_hover`, `lsp_goto_definition`, `lsp_diagnostics`, `lsp_diagnostics_directory`
577
+ - **LSP 工具**: `ultrapower:lsp_hover`, `ultrapower:lsp_goto_definition`, `ultrapower:lsp_diagnostics`, `ultrapower:lsp_diagnostics_directory`
578
578
  - **AST 工具**: `ast_grep_search`, `ast_grep_replace`
579
579
  - **Python REPL**: `python_repl`
580
580
  - **追踪**: `trace_timeline`, `trace_summary`
@@ -1,4 +1,4 @@
1
- # 🚀 15 分钟快速上手指南
1
+ # 🚀 15 分钟快速上手指南 - v7.6.0
2
2
 
3
3
  完整的 ultrapower 入门教程,从安装到第一个自主执行任务。
4
4
 
package/docs/glossary.md CHANGED
@@ -96,7 +96,7 @@
96
96
 
97
97
  **Tool** - 可调用的功能单元。35 个自定义工具:LSP x12、AST x2、REPL x1、Notepad x6、State x5、Memory x4、Trace x2、Skills x3。
98
98
 
99
- **LSP Tool** - 语言服务器协议工具。lsp_hover、lsp_goto_definition、lsp_find_references、lsp_diagnostics 等。
99
+ **LSP Tool** - 语言服务器协议工具。ultrapower:lsp_hover、ultrapower:lsp_goto_definition、ultrapower:lsp_find_references、ultrapower:lsp_diagnostics 等。
100
100
 
101
101
  **AST Tool** - 抽象语法树工具。ast_grep_search(结构化代码搜索)、ast_grep_replace(结构化转换)。
102
102
 
@@ -70,8 +70,8 @@ Edit `~/.claude/claude_desktop_config.json`:
70
70
  After configuration, restart Claude Desktop. The MCP server tools should appear in the tool list:
71
71
 
72
72
  ```
73
- mcp__plugin_ultrapower_t__ultrapower:lsp_hover
74
- mcp__plugin_ultrapower_t__ultrapower:lsp_goto_definition
73
+ mcp__plugin_ultrapower_t__lsp_hover
74
+ mcp__plugin_ultrapower_t__lsp_goto_definition
75
75
  mcp__plugin_ultrapower_t__ultrapower:ast_grep_search
76
76
  ... (64 tools total - each tool has both new and legacy names)
77
77
  ```
@@ -121,12 +121,12 @@ Restart Cursor. Check the MCP panel to confirm the server is connected and all 3
121
121
 
122
122
  Get type information at cursor position:
123
123
  ```
124
- Use mcp__plugin_ultrapower_t__ultrapower:lsp_hover with file and position
124
+ Use mcp__plugin_ultrapower_t__lsp_hover with file and position
125
125
  ```
126
126
 
127
127
  Find all references to a symbol:
128
128
  ```
129
- Use mcp__plugin_ultrapower_t__ultrapower:lsp_find_references to locate usage
129
+ Use mcp__plugin_ultrapower_t__lsp_find_references to locate usage
130
130
  ```
131
131
 
132
132
  ### AST Tools
@@ -17,29 +17,29 @@ Starting from v5.6.0, all ultrapower tools use the `ultrapower:` prefix instead
17
17
 
18
18
  ### LSP Tools
19
19
 
20
- * `lsp_hover` → `ultrapower:lsp_hover`
20
+ * `ultrapower:lsp_hover` → `ultrapower:lsp_hover`
21
21
 
22
- * `lsp_goto_definition` → `ultrapower:lsp_goto_definition`
22
+ * `ultrapower:lsp_goto_definition` → `ultrapower:lsp_goto_definition`
23
23
 
24
- * `lsp_find_references` → `ultrapower:lsp_find_references`
24
+ * `ultrapower:lsp_find_references` → `ultrapower:lsp_find_references`
25
25
 
26
- * `lsp_document_symbols` → `ultrapower:lsp_document_symbols`
26
+ * `ultrapower:lsp_document_symbols` → `ultrapower:lsp_document_symbols`
27
27
 
28
- * `lsp_workspace_symbols` → `ultrapower:lsp_workspace_symbols`
28
+ * `ultrapower:lsp_workspace_symbols` → `ultrapower:lsp_workspace_symbols`
29
29
 
30
- * `lsp_diagnostics` → `ultrapower:lsp_diagnostics`
30
+ * `ultrapower:lsp_diagnostics` → `ultrapower:lsp_diagnostics`
31
31
 
32
- * `lsp_diagnostics_directory` → `ultrapower:lsp_diagnostics_directory`
32
+ * `ultrapower:lsp_diagnostics_directory` → `ultrapower:lsp_diagnostics_directory`
33
33
 
34
- * `lsp_servers` → `ultrapower:lsp_servers`
34
+ * `ultrapower:lsp_servers` → `ultrapower:lsp_servers`
35
35
 
36
- * `lsp_prepare_rename` → `ultrapower:lsp_prepare_rename`
36
+ * `ultrapower:lsp_prepare_rename` → `ultrapower:lsp_prepare_rename`
37
37
 
38
- * `lsp_rename` → `ultrapower:lsp_rename`
38
+ * `ultrapower:lsp_rename` → `ultrapower:lsp_rename`
39
39
 
40
- * `lsp_code_actions` → `ultrapower:lsp_code_actions`
40
+ * `ultrapower:lsp_code_actions` → `ultrapower:lsp_code_actions`
41
41
 
42
- * `lsp_code_action_resolve` → `ultrapower:lsp_code_action_resolve`
42
+ * `ultrapower:lsp_code_action_resolve` → `ultrapower:lsp_code_action_resolve`
43
43
 
44
44
  ### State Tools
45
45
 
@@ -91,7 +91,7 @@ Location: `.claude/mcp.json` (workspace)
91
91
  "args": ["bridge/mcp-server.cjs"],
92
92
  "disabled": false,
93
93
  "autoApprove": [
94
- "lsp_hover",
94
+ "ultrapower:lsp_hover",
95
95
  "state_read",
96
96
  "notepad_read"
97
97
  ]
@@ -137,8 +137,8 @@ Edit `src/mcp/timeout.ts`:
137
137
 
138
138
  ```typescript
139
139
  export const TOOL_TIMEOUTS: Record<string, number> = {
140
- lsp_hover: 30000,
141
- lsp_diagnostics: 60000,
140
+ ultrapower:lsp_hover: 30000,
141
+ ultrapower:lsp_diagnostics: 60000,
142
142
  ast_grep_search: 60000,
143
143
  ask_codex: 300000,
144
144
  ask_gemini: 300000
@@ -160,8 +160,8 @@ Skip permission prompts for trusted tools:
160
160
  "mcpServers": {
161
161
  "ultrapower": {
162
162
  "autoApprove": [
163
- "lsp_hover",
164
- "lsp_goto_definition",
163
+ "ultrapower:lsp_hover",
164
+ "ultrapower:lsp_goto_definition",
165
165
  "state_read",
166
166
  "notepad_read",
167
167
  "project_memory_read"
@@ -6,9 +6,9 @@
6
6
 
7
7
  | Tool | Cold Start | Warm | Notes |
8
8
  | ------ | ----------- | ------ | ------- |
9
- | `lsp_hover` | 150ms | 20ms | LSP server cached |
10
- | `lsp_diagnostics` | 300ms | 50ms | File-level |
11
- | `lsp_diagnostics_directory` | 2s | 500ms | Directory scan |
9
+ | `ultrapower:lsp_hover` | 150ms | 20ms | LSP server cached |
10
+ | `ultrapower:lsp_diagnostics` | 300ms | 50ms | File-level |
11
+ | `ultrapower:lsp_diagnostics_directory` | 2s | 500ms | Directory scan |
12
12
  | `ast_grep_search` | 100ms | 30ms | Pattern complexity varies |
13
13
  | `state_read` | 10ms | 5ms | JSON parse |
14
14
  | `notepad_read` | 15ms | 8ms | Markdown parse |
@@ -137,8 +137,8 @@ await mcp__plugin_ultrapower_t__lsp_diagnostics_directory({
137
137
 
138
138
  Output includes timing:
139
139
  ```
140
- [debug] lsp_hover started
141
- [debug] lsp_hover completed in 23ms
140
+ [debug] ultrapower:lsp_hover started
141
+ [debug] ultrapower:lsp_hover completed in 23ms
142
142
  ```
143
143
 
144
144
  ### Measure Tool Calls
@@ -47,7 +47,7 @@ All community MCP server tools use the format: `mcp__servername__toolname`
47
47
 
48
48
  Internal OMC tools do not use namespace prefixes:
49
49
 
50
- * `lsp_*` - Language Server Protocol tools
50
+ * `ultrapower:lsp_*` - Language Server Protocol tools
51
51
 
52
52
  * `ast_grep_*` - AST manipulation tools
53
53
 
@@ -116,18 +116,18 @@ Task(subagent_type="ultrapower:explore",
116
116
 
117
117
  | 工具 | 类别 | 用途 | 是否分配给 Agent? |
118
118
  | ------ | ---------- | --------- | --------------------- |
119
- | `lsp_hover` | LSP | 获取代码位置的类型信息和文档 | 否(orchestrator 直接使用) |
120
- | `lsp_goto_definition` | LSP | 跳转到符号定义处 | 否(orchestrator 直接使用) |
121
- | `lsp_find_references` | LSP | 查找符号在代码库中的所有用法 | 是(仅 `explore`) |
122
- | `lsp_document_symbols` | LSP | 获取文件中所有符号的概览 | 是 |
123
- | `lsp_workspace_symbols` | LSP | 按名称在工作区中搜索符号 | 是 |
124
- | `lsp_diagnostics` | LSP | 获取文件的错误、警告和提示 | 是 |
125
- | `lsp_diagnostics_directory` | LSP | 项目级类型检查(tsc --noEmit 或 LSP) | 是 |
126
- | `lsp_prepare_rename` | LSP | 检查符号是否可以重命名 | 否(orchestrator 直接使用) |
127
- | `lsp_rename` | LSP | 在整个项目中重命名符号 | 否(orchestrator 直接使用) |
128
- | `lsp_code_actions` | LSP | 获取可用的重构和快速修复 | 否(orchestrator 直接使用) |
129
- | `lsp_code_action_resolve` | LSP | 获取代码操作的完整编辑详情 | 否(orchestrator 直接使用) |
130
- | `lsp_servers` | LSP | 列出可用的语言服务器及安装状态 | 否(orchestrator 直接使用) |
119
+ | `ultrapower:lsp_hover` | LSP | 获取代码位置的类型信息和文档 | 否(orchestrator 直接使用) |
120
+ | `ultrapower:lsp_goto_definition` | LSP | 跳转到符号定义处 | 否(orchestrator 直接使用) |
121
+ | `ultrapower:lsp_find_references` | LSP | 查找符号在代码库中的所有用法 | 是(仅 `explore`) |
122
+ | `ultrapower:lsp_document_symbols` | LSP | 获取文件中所有符号的概览 | 是 |
123
+ | `ultrapower:lsp_workspace_symbols` | LSP | 按名称在工作区中搜索符号 | 是 |
124
+ | `ultrapower:lsp_diagnostics` | LSP | 获取文件的错误、警告和提示 | 是 |
125
+ | `ultrapower:lsp_diagnostics_directory` | LSP | 项目级类型检查(tsc --noEmit 或 LSP) | 是 |
126
+ | `ultrapower:lsp_prepare_rename` | LSP | 检查符号是否可以重命名 | 否(orchestrator 直接使用) |
127
+ | `ultrapower:lsp_rename` | LSP | 在整个项目中重命名符号 | 否(orchestrator 直接使用) |
128
+ | `ultrapower:lsp_code_actions` | LSP | 获取可用的重构和快速修复 | 否(orchestrator 直接使用) |
129
+ | `ultrapower:lsp_code_action_resolve` | LSP | 获取代码操作的完整编辑详情 | 否(orchestrator 直接使用) |
130
+ | `ultrapower:lsp_servers` | LSP | 列出可用的语言服务器及安装状态 | 否(orchestrator 直接使用) |
131
131
  | `ast_grep_search` | AST | 基于 AST 的模式化结构代码搜索 | 是 |
132
132
  | `ast_grep_replace` | AST | 基于模式的结构化代码转换 | 是 |
133
133
  | `python_repl` | Data | 用于数据分析和计算的持久化 Python REPL | 是 |
@@ -154,30 +154,30 @@ Task(subagent_type="ultrapower:explore",
154
154
 
155
155
  | 工具 | 直接使用时机 |
156
156
  | ------ | --------------------- |
157
- | `lsp_hover` | 对话中快速查询类型 |
158
- | `lsp_goto_definition` | 分析过程中导航到符号定义 |
159
- | `lsp_prepare_rename` | 在决定方案前检查重命名可行性 |
160
- | `lsp_rename` | 安全重命名操作(返回编辑预览,不自动应用) |
161
- | `lsp_code_actions` | 发现可用的重构操作 |
162
- | `lsp_code_action_resolve` | 获取特定代码操作的详情 |
163
- | `lsp_servers` | 检查语言服务器可用性 |
157
+ | `ultrapower:lsp_hover` | 对话中快速查询类型 |
158
+ | `ultrapower:lsp_goto_definition` | 分析过程中导航到符号定义 |
159
+ | `ultrapower:lsp_prepare_rename` | 在决定方案前检查重命名可行性 |
160
+ | `ultrapower:lsp_rename` | 安全重命名操作(返回编辑预览,不自动应用) |
161
+ | `ultrapower:lsp_code_actions` | 发现可用的重构操作 |
162
+ | `ultrapower:lsp_code_action_resolve` | 获取特定代码操作的详情 |
163
+ | `ultrapower:lsp_servers` | 检查语言服务器可用性 |
164
164
 
165
165
  对于需要实现的复杂重命名或重构任务,委派给 `executor`(使用 `model="opus"`),它可以使用 `ast_grep_replace` 进行结构化转换。
166
166
 
167
167
  ### 工具选择指南
168
168
 
169
- * **需要文件符号概览或工作区搜索?** 通过 `explore` 使用 `lsp_document_symbols`/`lsp_workspace_symbols`
169
+ * **需要文件符号概览或工作区搜索?** 通过 `explore` 使用 `ultrapower:lsp_document_symbols`/`ultrapower:lsp_workspace_symbols`
170
170
 
171
- * **需要查找符号的所有用法?** 通过 `explore` 使用 `lsp_find_references`
171
+ * **需要查找符号的所有用法?** 通过 `explore` 使用 `ultrapower:lsp_find_references`
172
172
 
173
173
  * **需要结构化代码模式?**(如"查找所有匹配 X 形状的函数")通过 `explore`、`architect` 或 `code-reviewer` 使用 `ast_grep_search`
174
174
 
175
175
  * **需要结构化代码转换?** 通过 `executor`(使用 `model="opus"`)使用 `ast_grep_replace`
176
176
 
177
- * **需要全项目类型检查?** 通过 `architect`、`executor` 或 `build-fixer` 使用 `lsp_diagnostics_directory`
177
+ * **需要全项目类型检查?** 通过 `architect`、`executor` 或 `build-fixer` 使用 `ultrapower:lsp_diagnostics_directory`
178
178
 
179
- * **需要单文件错误检查?** 通过多个 agent 使用 `lsp_diagnostics`(参见矩阵)
179
+ * **需要单文件错误检查?** 通过多个 agent 使用 `ultrapower:lsp_diagnostics`(参见矩阵)
180
180
 
181
181
  * **需要数据分析/计算?** 通过 `scientist` 使用 `python_repl`
182
182
 
183
- * **需要快速类型信息或定义查询?** 直接使用 `lsp_hover`/`lsp_goto_definition`(orchestrator 直接工具)
183
+ * **需要快速类型信息或定义查询?** 直接使用 `ultrapower:lsp_hover`/`ultrapower:lsp_goto_definition`(orchestrator 直接工具)
@@ -59,7 +59,7 @@
59
59
 
60
60
  ## 目录诊断工具
61
61
 
62
- 通过 `lsp_diagnostics_directory` 工具进行项目级类型检查。
62
+ 通过 `ultrapower:lsp_diagnostics_directory` 工具进行项目级类型检查。
63
63
 
64
64
  **策略:**
65
65
 
@@ -6,7 +6,7 @@
6
6
 
7
7
  | 层级 | 标准 | Agent | 模型 | 所需证据 |
8
8
  | ------ | ---------- | ------- | ------- | ------------------- |
9
- | **LIGHT** | <5 个文件,<100 行,完整测试覆盖 | architect-low | haiku | lsp_diagnostics 无错误 |
9
+ | **LIGHT** | <5 个文件,<100 行,完整测试覆盖 | architect-low | haiku | ultrapower:lsp_diagnostics 无错误 |
10
10
  | **STANDARD** | 默认(非 LIGHT 或 THOROUGH) | architect-medium | sonnet | diagnostics + 构建通过 |
11
11
  | **THOROUGH** | >20 个文件,或架构/安全变更 | architect | opus | 完整审查 + 所有测试 |
12
12
 
@@ -94,7 +94,7 @@ ELSE:
94
94
  | 声明 | 所需证据 |
95
95
  | ------- | ------------------- |
96
96
  | "已修复" | 显示现在通过的测试 |
97
- | "已实现" | lsp_diagnostics 无错误 + 构建通过 |
97
+ | "已实现" | ultrapower:lsp_diagnostics 无错误 + 构建通过 |
98
98
  | "已重构" | 所有测试仍然通过 |
99
99
  | "已调试" | 定位到 file:line 的根本原因 |
100
100
 
@@ -113,7 +113,7 @@ brainstorming 触发时的强制流程:
113
113
  verification-before-completion → [验证通过]
114
114
 
115
115
  阶段5b: 构建验证(新增)
116
- build-fixer → lsp_diagnostics_directory → [零错误]
116
+ build-fixer → ultrapower:lsp_diagnostics_directory → [零错误]
117
117
 
118
118
  阶段6: 部署测试
119
119
  qa-tester → ultraqa循环 → [全部通过]
@@ -282,7 +282,7 @@ brainstorming 触发时的强制流程:
282
282
 
283
283
  | Agent | 关键节点 | 主推 | 备选 | 推荐理由 |
284
284
  | --- | --- | --- | --- | --- |
285
- | `build-fixer` agent | lsp_diagnostics 零错误后 | `qa-tester` agent | `requesting-code-review` | 构建通过进入部署测试 |
285
+ | `build-fixer` agent | ultrapower:lsp_diagnostics 零错误后 | `qa-tester` agent | `requesting-code-review` | 构建通过进入部署测试 |
286
286
 
287
287
  ### 阶段6:部署测试
288
288