@liangjie559567/ultrapower 7.6.0 → 7.7.1

package/docs/plans/2026-03-02-docs-comprehensive-update.md

@@ -311,18 +311,18 @@ Total: **35 tools** exposed via `mcp__plugin_ultrapower_t__` prefix.
 ### LSP Tools (12)
 
 ```
-lsp_hover                  — Type info and docs at position
-lsp_goto_definition        — Jump to definition
-lsp_find_references        — Find all usages
-lsp_document_symbols       — File outline
-lsp_workspace_symbols      — Cross-workspace symbol search
-lsp_diagnostics            — Per-file errors/warnings
-lsp_diagnostics_directory  — Project-level type check
-lsp_servers                — List available language servers
-lsp_prepare_rename         — Check if rename is valid
-lsp_rename                 — Preview multi-file rename
-lsp_code_actions           — Available refactors/fixes
-lsp_code_action_resolve    — Get action details
+ultrapower:lsp_hover                  — Type info and docs at position
+ultrapower:lsp_goto_definition        — Jump to definition
+ultrapower:lsp_find_references        — Find all usages
+ultrapower:lsp_document_symbols       — File outline
+ultrapower:lsp_workspace_symbols      — Cross-workspace symbol search
+ultrapower:lsp_diagnostics            — Per-file errors/warnings
+ultrapower:lsp_diagnostics_directory  — Project-level type check
+ultrapower:lsp_servers                — List available language servers
+ultrapower:lsp_prepare_rename         — Check if rename is valid
+ultrapower:lsp_rename                 — Preview multi-file rename
+ultrapower:lsp_code_actions           — Available refactors/fixes
+ultrapower:lsp_code_action_resolve    — Get action details
 ```
 
 Supported languages: TypeScript, Python, Rust, Go, C/C++, Java, JSON, HTML, CSS, YAML
@@ -860,17 +860,17 @@ Directives are the highest-priority memory: they survive context compression and
 
 ### LSP Tools (12)
 
-Require a running language server. Use `lsp_servers()` to check availability.
+Require a running language server. Use `ultrapower:lsp_servers()` to check availability.
 
 ```typescript
 // Type info at cursor position
-lsp_hover({ file: "src/hooks/bridge.ts", line: 42, character: 15 })
+ultrapower:lsp_hover({ file: "src/hooks/bridge.ts", line: 42, character: 15 })
 
 // Find all usages
-lsp_find_references({ file: "src/lib/validateMode.ts", symbol: "assertValidMode" })
+ultrapower:lsp_find_references({ file: "src/lib/validateMode.ts", symbol: "assertValidMode" })
 
 // Project-wide diagnostics
-lsp_diagnostics_directory({ directory: "src/", includeWarnings: false })
+ultrapower:lsp_diagnostics_directory({ directory: "src/", includeWarnings: false })
 ```
 
 ### AST Tools (2)

package/docs/plans/2026-03-05-mcp-adoption-atomic-tasks.md

@@ -162,11 +162,11 @@ npm install --save-dev @types/node
 
 **步骤：**
 1. 创建 `src/mcp/adapters/lsp-adapter.ts`
-2. 转换 lsp_hover, lsp_goto_definition, lsp_find_references
-3. 转换 lsp_document_symbols, lsp_workspace_symbols
-4. 转换 lsp_diagnostics, lsp_diagnostics_directory
-5. 转换 lsp_servers, lsp_prepare_rename, lsp_rename
-6. 转换 lsp_code_actions, lsp_code_action_resolve
+2. 转换 ultrapower:lsp_hover, ultrapower:lsp_goto_definition, ultrapower:lsp_find_references
+3. 转换 ultrapower:lsp_document_symbols, ultrapower:lsp_workspace_symbols
+4. 转换 ultrapower:lsp_diagnostics, ultrapower:lsp_diagnostics_directory
+5. 转换 ultrapower:lsp_servers, ultrapower:lsp_prepare_rename, ultrapower:lsp_rename
+6. 转换 ultrapower:lsp_code_actions, ultrapower:lsp_code_action_resolve
 
 **验收：**
 
@@ -380,7 +380,7 @@ npm install --save-dev @types/node
 1. 创建 `src/mcp/tool-resolver.ts`
 2. 实现 `resolveTool(name: string)` 函数
 3. 支持带前缀：`mcp__plugin_ultrapower_t__lsp_hover`
-4. 支持不带前缀：`lsp_hover`
+4. 支持不带前缀：`ultrapower:lsp_hover`
 5. 支持命名空间：`ultrapower:lsp_hover`
 
 **验收：**
@@ -530,8 +530,8 @@ npm install --save-dev @types/node
 **依赖：** 1.4.1
 
 **步骤：**
-1. 测试 `lsp_hover` 调用
-2. 测试 `lsp_diagnostics` 调用
+1. 测试 `ultrapower:lsp_hover` 调用
+2. 测试 `ultrapower:lsp_diagnostics` 调用
 3. 验证参数传递正确
 4. 验证返回结果格式
 
@@ -581,7 +581,7 @@ npm install --save-dev @types/node
 **步骤：**
 1. 使用旧前缀调用工具：`mcp__plugin_ultrapower_t__lsp_hover`
 2. 使用新前缀调用工具：`ultrapower:lsp_hover`
-3. 使用无前缀调用工具：`lsp_hover`
+3. 使用无前缀调用工具：`ultrapower:lsp_hover`
 4. 验证三种方式都能成功
 
 **验收：**

package/docs/plans/2026-03-16-tech-debt-fixes.md

@@ -0,0 +1,222 @@
+# Technical Debt Fixes Implementation Plan
+
+> **For Claude:** REQUIRED SUB-SKILL: Use ultrapower:executing-plans to implement this plan task-by-task.
+
+**Goal:** Fix 4 identified technical debt items from architecture assessment (TD-1 to TD-4)
+
+**Architecture:** Prioritize P0 test stability, then address P1 deprecation warnings and platform compatibility, finally unify atomic write protection
+
+**Tech Stack:** TypeScript, Vitest, Node.js fs module, cross-platform file operations
+
+---
+
+## Task 1: Fix P0 Test Timeout Issues (TD-1)
+
+**Priority:** P0 - Blocking CI pipeline
+
+**Files:**
+- Modify: `src/features/__tests__/mcp-integration.test.ts:9`
+- Modify: `src/features/mcp-autodiscovery/__tests__/performance.test.ts:7`
+
+**Step 1: Increase timeout for MCP integration tests**
+
+```typescript
+// src/features/__tests__/mcp-integration.test.ts
+beforeAll(async () => {
+  contextManager = new UnifiedContextManager();
+  await contextManager.initialize();
+}, 30000); // Increase from 10000 to 30000ms
+```
+
+**Step 2: Increase timeout for performance tests**
+
+```typescript
+// src/features/mcp-autodiscovery/__tests__/performance.test.ts
+beforeAll(async () => {
+  // Setup code
+}, 30000); // Increase from 10000 to 30000ms
+```
+
+**Step 3: Run tests to verify fixes**
+
+Run: `npm test -- mcp-integration.test.ts performance.test.ts`
+Expected: All tests pass without timeout
+
+**Step 4: Commit**
+
+```bash
+git add src/features/__tests__/mcp-integration.test.ts src/features/mcp-autodiscovery/__tests__/performance.test.ts
+git commit -m "fix(test): increase timeout for MCP integration tests to 30s
+
+Resolves TD-1: Test timeout issues blocking CI pipeline"
+```
+
+---
+
+## Task 2: Remove LSP Tool Deprecation Warnings (TD-2)
+
+**Priority:** P1 - User experience and maintenance
+
+**Files:**
+- Modify: `src/tools/lsp-tools.ts`
+- Modify: `docs/REFERENCE.md`
+- Modify: `README.md`
+
+**Step 1: Update all documentation to use new naming**
+
+Search and replace in documentation:
+- `ultrapower:lsp_diagnostics` → `ultrapower:lsp_diagnostics`
+- `ultrapower:lsp_hover` → `ultrapower:lsp_hover`
+- (repeat for all 12 LSP tools)
+
+**Step 2: Add deprecation timeline to CHANGELOG**
+
+```markdown
+## [Unreleased]
+
+### Deprecated
+- Old LSP tool naming (without `ultrapower:` prefix) will be removed in v8.0.0
+- Users should migrate to new naming: `ultrapower:lsp_*`
+```
+
+**Step 3: Verify no old naming in docs**
+
+Run: `grep -r "ultrapower:lsp_diagnostics" docs/ README.md`
+Expected: No matches (all should use `ultrapower:lsp_diagnostics`)
+
+**Step 4: Commit**
+
+```bash
+git add docs/ README.md CHANGELOG.md
+git commit -m "docs: migrate LSP tool naming to ultrapower: prefix
+
+Resolves TD-2: Prepare for v8.0.0 deprecation removal"
+```
+
+---
+
+## Task 3: Add Windows Platform Compatibility Tests (TD-3)
+
+**Priority:** P1 - Platform compatibility
+
+**Files:**
+- Create: `tests/platform/windows-atomic-write.test.ts`
+- Modify: `src/lib/atomic-write.ts`
+
+**Step 1: Create Windows-specific test file**
+
+```typescript
+// tests/platform/windows-atomic-write.test.ts
+import { describe, it, expect } from 'vitest';
+import { atomicWriteJsonSyncWithRetry } from '../../src/lib/atomic-write';
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+
+describe.skipIf(process.platform !== 'win32')('Windows atomic write', () => {
+  it('should handle locked files gracefully', async () => {
+    const testPath = join(process.cwd(), '.test-windows-lock.json');
+    const data = { test: 'value' };
+
+    // Write should succeed even if file is temporarily locked
+    atomicWriteJsonSyncWithRetry(testPath, data);
+
+    expect(existsSync(testPath)).toBe(true);
+    const content = JSON.parse(readFileSync(testPath, 'utf-8'));
+    expect(content).toEqual(data);
+  });
+});
+```
+
+**Step 2: Run Windows tests**
+
+Run: `npm test -- windows-atomic-write.test.ts`
+Expected: Tests pass on Windows, skipped on other platforms
+
+**Step 3: Document platform differences**
+
+Add to `docs/standards/runtime-protection.md`:
+
+```markdown
+### Windows Platform Notes
+
+- `renameSync` is not atomic when target file is locked
+- Directory-level `fsync` silently fails
+- Use `maxRetries` parameter in `atomicWriteJsonSyncWithRetry` for robustness
+```
+
+**Step 4: Commit**
+
+```bash
+git add tests/platform/windows-atomic-write.test.ts docs/standards/runtime-protection.md
+git commit -m "test(platform): add Windows atomic write compatibility tests
+
+Resolves TD-3: Windows platform compatibility validation"
+```
+
+---
+
+## Task 4: Unify Atomic Write Protection (TD-4)
+
+**Priority:** P2 - Consistency and safety
+
+**Files:**
+- Modify: `src/hooks/subagent-tracker/index.ts`
+
+**Step 1: Replace immediate write with atomic write**
+
+```typescript
+// src/hooks/subagent-tracker/index.ts
+import { atomicWriteJsonSyncWithRetry } from '../../lib/atomic-write';
+
+// Replace this:
+// writeFileSync(statePath, JSON.stringify(state, null, 2), "utf-8");
+
+// With this:
+atomicWriteJsonSyncWithRetry(statePath, state);
+```
+
+**Step 2: Remove writeTrackingStateImmediate function**
+
+Remove the `writeTrackingStateImmediate()` function entirely, replace all calls with `atomicWriteJsonSyncWithRetry`.
+
+**Step 3: Run tests to verify no regressions**
+
+Run: `npm test -- subagent-tracker`
+Expected: All tests pass
+
+**Step 4: Update difference documentation**
+
+Remove D-07 from `docs/standards/runtime-protection.md` (no longer a difference).
+
+**Step 5: Commit**
+
+```bash
+git add src/hooks/subagent-tracker/index.ts docs/standards/runtime-protection.md
+git commit -m "refactor(hooks): unify atomic write protection in subagent-tracker
+
+Resolves TD-4: Remove immediate write bypass, use atomic write consistently"
+```
+
+---
+
+## Verification Checklist
+
+After completing all tasks:
+
+- [ ] All tests pass: `npm test`
+- [ ] No TypeScript errors: `npm run build`
+- [ ] No lint errors: `npm run lint`
+- [ ] CI pipeline passes on GitHub Actions
+- [ ] Documentation updated for all changes
+- [ ] CHANGELOG.md includes all fixes
+
+---
+
+## Estimated Timeline
+
+- Task 1 (P0): 30 minutes
+- Task 2 (P1): 1 hour
+- Task 3 (P1): 2 hours
+- Task 4 (P2): 1 hour
+
+**Total:** ~4.5 hours