mcp-probe-kit 2.3.0 → 2.5.0

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 (186) hide show
  1. package/README.md +131 -48
  2. package/build/index.js +1 -7
  3. package/build/lib/guidance.d.ts +8 -0
  4. package/build/lib/guidance.js +30 -0
  5. package/build/lib/orchestration-guidance.d.ts +8 -0
  6. package/build/lib/orchestration-guidance.js +16 -0
  7. package/build/lib/template-loader.d.ts +25 -0
  8. package/build/lib/template-loader.js +473 -0
  9. package/build/lib/toolset-manager.d.ts +4 -4
  10. package/build/lib/toolset-manager.js +10 -13
  11. package/build/schemas/code-analysis-tools.d.ts +0 -18
  12. package/build/schemas/code-analysis-tools.js +0 -19
  13. package/build/schemas/doc-util-tools.d.ts +0 -9
  14. package/build/schemas/doc-util-tools.js +0 -10
  15. package/build/schemas/index.d.ts +46 -47
  16. package/build/schemas/orchestration-tools.d.ts +42 -2
  17. package/build/schemas/orchestration-tools.js +42 -2
  18. package/build/schemas/output/core-tools.d.ts +1 -117
  19. package/build/schemas/output/core-tools.js +1 -60
  20. package/build/schemas/output/index.d.ts +5 -4
  21. package/build/schemas/output/index.js +6 -4
  22. package/build/schemas/output/product-design-tools.d.ts +160 -0
  23. package/build/schemas/output/product-design-tools.js +75 -0
  24. package/build/schemas/output/project-tools.d.ts +1 -217
  25. package/build/schemas/output/project-tools.js +1 -103
  26. package/build/schemas/project-tools.d.ts +4 -18
  27. package/build/schemas/project-tools.js +4 -19
  28. package/build/schemas/structured-output.d.ts +309 -99
  29. package/build/schemas/structured-output.js +174 -72
  30. package/build/schemas/ui-ux-schemas.d.ts +26 -0
  31. package/build/schemas/ui-ux-schemas.js +26 -0
  32. package/build/tools/__tests__/add_feature.template.test.d.ts +4 -0
  33. package/build/tools/__tests__/add_feature.template.test.js +47 -0
  34. package/build/tools/__tests__/start_bugfix.unit.test.d.ts +4 -0
  35. package/build/tools/__tests__/start_bugfix.unit.test.js +85 -0
  36. package/build/tools/__tests__/start_feature.unit.test.d.ts +4 -0
  37. package/build/tools/__tests__/start_feature.unit.test.js +83 -0
  38. package/build/tools/__tests__/start_ui.integration.test.js +4 -3
  39. package/build/tools/__tests__/start_ui.loop.test.d.ts +4 -0
  40. package/build/tools/__tests__/start_ui.loop.test.js +24 -0
  41. package/build/tools/__tests__/start_ui.unit.test.js +39 -1
  42. package/build/tools/add_feature.js +184 -406
  43. package/build/tools/ask_user.js +18 -5
  44. package/build/tools/code_review.js +8 -1
  45. package/build/tools/estimate.js +9 -2
  46. package/build/tools/fix_bug.js +9 -2
  47. package/build/tools/gen_mock.js +8 -1
  48. package/build/tools/gen_prd.d.ts +1 -7
  49. package/build/tools/gen_prd.js +41 -27
  50. package/build/tools/gen_prototype.d.ts +1 -7
  51. package/build/tools/gen_prototype.js +47 -27
  52. package/build/tools/genapi.js +8 -1
  53. package/build/tools/genchangelog.js +8 -1
  54. package/build/tools/gencommit.d.ts +1 -1
  55. package/build/tools/gencommit.js +49 -18
  56. package/build/tools/gendoc.js +9 -1
  57. package/build/tools/genpr.js +8 -1
  58. package/build/tools/genreadme.js +8 -1
  59. package/build/tools/gensql.js +8 -1
  60. package/build/tools/gentest.js +8 -1
  61. package/build/tools/index.d.ts +0 -3
  62. package/build/tools/index.js +0 -3
  63. package/build/tools/interview.d.ts +1 -13
  64. package/build/tools/interview.js +96 -31
  65. package/build/tools/perf.js +8 -1
  66. package/build/tools/refactor.js +8 -1
  67. package/build/tools/resolve_conflict.js +8 -1
  68. package/build/tools/security_scan.js +9 -2
  69. package/build/tools/start_api.js +44 -4
  70. package/build/tools/start_bugfix.js +377 -15
  71. package/build/tools/start_doc.js +40 -4
  72. package/build/tools/start_feature.js +287 -92
  73. package/build/tools/start_onboard.js +83 -100
  74. package/build/tools/start_product.d.ts +1 -1
  75. package/build/tools/start_product.js +183 -6
  76. package/build/tools/start_ralph.js +51 -2
  77. package/build/tools/start_refactor.js +39 -4
  78. package/build/tools/start_release.js +33 -4
  79. package/build/tools/start_review.js +39 -4
  80. package/build/tools/start_ui.js +669 -52
  81. package/build/utils/design-reasoning-engine.d.ts +5 -0
  82. package/build/utils/design-reasoning-engine.js +85 -5
  83. package/docs/data/tools.js +308 -478
  84. package/docs/index.html +1 -1
  85. package/docs/pages/all-tools.html +37 -22
  86. package/docs/pages/examples.html +100 -35
  87. package/docs/pages/getting-started.html +43 -3
  88. package/docs/pages/migration.html +14 -8
  89. package/package.json +79 -79
  90. package/build/lib/analysis-tasks.d.ts +0 -35
  91. package/build/lib/analysis-tasks.js +0 -788
  92. package/build/lib/elicitation-helper.d.ts +0 -73
  93. package/build/lib/elicitation-helper.js +0 -130
  94. package/build/lib/task-generator.d.ts +0 -11
  95. package/build/lib/task-generator.js +0 -109
  96. package/build/lib/template-generator.d.ts +0 -14
  97. package/build/lib/template-generator.js +0 -62
  98. package/build/lib/templates/backend-templates.d.ts +0 -8
  99. package/build/lib/templates/backend-templates.js +0 -26
  100. package/build/resources/index.d.ts +0 -4
  101. package/build/resources/index.js +0 -4
  102. package/build/resources/tool-params-guide.d.ts +0 -571
  103. package/build/resources/tool-params-guide.js +0 -488
  104. package/build/tools/analyze_project.d.ts +0 -1
  105. package/build/tools/analyze_project.js +0 -566
  106. package/build/tools/check_deps.d.ts +0 -1
  107. package/build/tools/check_deps.js +0 -213
  108. package/build/tools/convert.d.ts +0 -13
  109. package/build/tools/convert.js +0 -599
  110. package/build/tools/css_order.d.ts +0 -13
  111. package/build/tools/css_order.js +0 -81
  112. package/build/tools/debug.d.ts +0 -1
  113. package/build/tools/debug.js +0 -133
  114. package/build/tools/design2code.d.ts +0 -20
  115. package/build/tools/design2code.js +0 -426
  116. package/build/tools/detect_shell.d.ts +0 -6
  117. package/build/tools/detect_shell.js +0 -151
  118. package/build/tools/explain.d.ts +0 -13
  119. package/build/tools/explain.js +0 -390
  120. package/build/tools/fix.d.ts +0 -13
  121. package/build/tools/fix.js +0 -303
  122. package/build/tools/gen_skill.d.ts +0 -13
  123. package/build/tools/gen_skill.js +0 -560
  124. package/build/tools/genui.d.ts +0 -13
  125. package/build/tools/genui.js +0 -803
  126. package/build/tools/init_setting.d.ts +0 -13
  127. package/build/tools/init_setting.js +0 -47
  128. package/build/tools/split.d.ts +0 -13
  129. package/build/tools/split.js +0 -599
  130. package/build/tools/templates/architecture-template.d.ts +0 -5
  131. package/build/tools/templates/architecture-template.js +0 -42
  132. package/build/tools/templates/coding-standards-template.d.ts +0 -5
  133. package/build/tools/templates/coding-standards-template.js +0 -41
  134. package/build/tools/templates/dependencies-template.d.ts +0 -5
  135. package/build/tools/templates/dependencies-template.js +0 -38
  136. package/build/tools/templates/index-template.d.ts +0 -5
  137. package/build/tools/templates/index-template.js +0 -64
  138. package/build/tools/templates/tech-stack-template.d.ts +0 -5
  139. package/build/tools/templates/tech-stack-template.js +0 -35
  140. package/build/tools/templates/workflows-template.d.ts +0 -5
  141. package/build/tools/templates/workflows-template.js +0 -31
  142. package/docs/specs/algorithm-enhancement/roadmap.md +0 -619
  143. package/docs/specs/project-context-modular/design.md +0 -722
  144. package/docs/specs/project-context-modular/example-output.md +0 -123
  145. package/docs/specs/project-context-modular/implementation-v2.md +0 -275
  146. package/docs/specs/project-context-modular/requirements.md +0 -234
  147. package/docs/specs/project-context-modular/tasks.md +0 -386
  148. package/docs/specs/v2.1-planning.md +0 -335
  149. package/docs/specs/vnext-upgrade/00-OVERVIEW.md +0 -258
  150. package/docs/specs/vnext-upgrade/BETA_RELEASE_GUIDE.md +0 -328
  151. package/docs/specs/vnext-upgrade/GITHUB_DISCUSSION_TEMPLATE.md +0 -236
  152. package/docs/specs/vnext-upgrade/M8.9-PROGRESS-UPDATE.md +0 -248
  153. package/docs/specs/vnext-upgrade/PROGRESS-SUMMARY.md +0 -195
  154. package/docs/specs/vnext-upgrade/QUICK_REFERENCE.md +0 -338
  155. package/docs/specs/vnext-upgrade/README.md +0 -125
  156. package/docs/specs/vnext-upgrade/STATUS-UPDATE-2026-01-26.md +0 -230
  157. package/docs/specs/vnext-upgrade/TOOL_CLEANUP.md +0 -343
  158. package/docs/specs/vnext-upgrade/completed/M1-M2-SUMMARY.md +0 -27
  159. package/docs/specs/vnext-upgrade/completed/M3_COMPLETION_SUMMARY.md +0 -273
  160. package/docs/specs/vnext-upgrade/completed/M4-SUMMARY.md +0 -19
  161. package/docs/specs/vnext-upgrade/completed/M5_COMPLETION_SUMMARY.md +0 -0
  162. package/docs/specs/vnext-upgrade/completed/M8.1-SUMMARY.md +0 -247
  163. package/docs/specs/vnext-upgrade/completed/M8.2-SUMMARY.md +0 -296
  164. package/docs/specs/vnext-upgrade/completed/M8.3-SUMMARY.md +0 -241
  165. package/docs/specs/vnext-upgrade/completed/M8.3-TEST-SUMMARY.md +0 -216
  166. package/docs/specs/vnext-upgrade/completed/M8.4-SUMMARY.md +0 -217
  167. package/docs/specs/vnext-upgrade/completed/M8.4-TEST-SUMMARY.md +0 -198
  168. package/docs/specs/vnext-upgrade/completed/M8.5-SUMMARY.md +0 -202
  169. package/docs/specs/vnext-upgrade/completed/M8.5-TEST-SUMMARY.md +0 -223
  170. package/docs/specs/vnext-upgrade/completed/M8.6-SUMMARY.md +0 -299
  171. package/docs/specs/vnext-upgrade/completed/M8.8-TEST-SUMMARY.md +0 -216
  172. package/docs/specs/vnext-upgrade/completed/TOOL-CLEANUP-SUMMARY.md +0 -210
  173. package/docs/specs/vnext-upgrade/design.md +0 -848
  174. package/docs/specs/vnext-upgrade/requirements.md +0 -221
  175. package/docs/specs/vnext-upgrade/tasks/00-INDEX.md +0 -335
  176. package/docs/specs/vnext-upgrade/tasks/M8.1-SCHEMA-DEFINITION.md +0 -300
  177. package/docs/specs/vnext-upgrade/tasks/M8.2-P1-TOOLS.md +0 -249
  178. package/docs/specs/vnext-upgrade/tasks/M8.3-GENERATION-TOOLS.md +0 -49
  179. package/docs/specs/vnext-upgrade/tasks/M8.4-ORCHESTRATION-TOOLS.md +0 -28
  180. package/docs/specs/vnext-upgrade/tasks/M8.5-PROJECT-TOOLS.md +0 -29
  181. package/docs/specs/vnext-upgrade/tasks/M8.6-UI-TOOLS.md +0 -66
  182. package/docs/specs/vnext-upgrade/tasks/M8.7-HELPER-TOOLS.md +0 -24
  183. package/docs/specs/vnext-upgrade/tasks/M8.8-INTEGRATION-TESTS.md +0 -90
  184. package/docs/specs/vnext-upgrade/tasks/M8.9-DOCUMENTATION.md +0 -103
  185. package/docs/vnext/MCP_2025-11-25_GUIDE.md +0 -276
  186. package/docs/vnext/vNext-PRD.md +0 -488
@@ -1,303 +0,0 @@
1
- import { parseArgs, getString } from "../utils/parseArgs.js";
2
- // fix 工具实现
3
- export async function fix(args) {
4
- try {
5
- // 智能参数解析,支持自然语言输入
6
- const parsedArgs = parseArgs(args, {
7
- defaultValues: {
8
- code: "",
9
- type: "all",
10
- },
11
- primaryField: "code", // 纯文本输入默认映射到 code 字段
12
- fieldAliases: {
13
- code: ["source", "src", "代码", "content"],
14
- type: ["fix_type", "category", "类型", "修复类型"],
15
- },
16
- });
17
- const code = getString(parsedArgs.code);
18
- const type = getString(parsedArgs.type) || "all"; // lint, type, format, import, unused
19
- const message = `请自动修复以下代码问题:
20
-
21
- 📝 **代码内容**:
22
- ${code || "请提供需要修复的代码"}
23
-
24
- 🎯 **修复类型**:${type}
25
-
26
- ---
27
-
28
- ## 自动修复步骤
29
-
30
- ### 第一步:识别问题
31
-
32
- 执行以下检查:
33
- \`\`\`bash
34
- # Lint 检查
35
- npm run lint
36
-
37
- # TypeScript 类型检查
38
- tsc --noEmit
39
-
40
- # 格式化检查
41
- npm run format:check
42
- \`\`\`
43
-
44
- ### 第二步:问题分类
45
-
46
- **1️⃣ Lint 错误**
47
- - ESLint 规则违反
48
- - 代码质量问题
49
- - 潜在 Bug
50
-
51
- **2️⃣ TypeScript 类型错误**
52
- - 类型不匹配
53
- - 缺少类型定义
54
- - 隐式 any
55
-
56
- **3️⃣ 格式化问题**
57
- - 缩进不一致
58
- - 引号风格
59
- - 分号使用
60
- - 换行规则
61
-
62
- **4️⃣ Import 问题**
63
- - 未使用的 import
64
- - 重复 import
65
- - Import 顺序混乱
66
- - 相对路径 vs 绝对路径
67
-
68
- **5️⃣ 未使用代码**
69
- - 未使用的变量
70
- - 未使用的函数
71
- - 死代码(Dead Code)
72
-
73
- ---
74
-
75
- ## 修复策略
76
-
77
- ### 🔧 Lint 错误修复
78
-
79
- **常见问题和修复:**
80
-
81
- 1. **no-unused-vars**
82
- \`\`\`typescript
83
- // ❌ Before
84
- const unusedVar = 123;
85
- function test() {
86
- const result = compute();
87
- return 42;
88
- }
89
-
90
- // ✅ After
91
- function test() {
92
- return 42;
93
- }
94
- \`\`\`
95
-
96
- 2. **no-console**
97
- \`\`\`typescript
98
- // ❌ Before
99
- console.log('debug info');
100
-
101
- // ✅ After (开发环境)
102
- if (process.env.NODE_ENV === 'development') {
103
- console.log('debug info');
104
- }
105
-
106
- // ✅ After (使用 logger)
107
- logger.debug('debug info');
108
- \`\`\`
109
-
110
- 3. **prefer-const**
111
- \`\`\`typescript
112
- // ❌ Before
113
- let value = 10;
114
- const result = value * 2;
115
-
116
- // ✅ After
117
- const value = 10;
118
- const result = value * 2;
119
- \`\`\`
120
-
121
- ### 🔧 TypeScript 类型错误修复
122
-
123
- **常见问题和修复:**
124
-
125
- 1. **隐式 any**
126
- \`\`\`typescript
127
- // ❌ Before
128
- function process(data) {
129
- return data.value;
130
- }
131
-
132
- // ✅ After
133
- function process(data: { value: string }): string {
134
- return data.value;
135
- }
136
- \`\`\`
137
-
138
- 2. **类型不匹配**
139
- \`\`\`typescript
140
- // ❌ Before
141
- const num: number = "123";
142
-
143
- // ✅ After
144
- const num: number = 123;
145
- // 或
146
- const num: number = parseInt("123");
147
- \`\`\`
148
-
149
- 3. **可能为 null/undefined**
150
- \`\`\`typescript
151
- // ❌ Before
152
- function getName(user) {
153
- return user.name.toUpperCase();
154
- }
155
-
156
- // ✅ After
157
- function getName(user: User | null): string {
158
- return user?.name?.toUpperCase() ?? 'Unknown';
159
- }
160
- \`\`\`
161
-
162
- ### 🔧 Import 优化
163
-
164
- **修复策略:**
165
-
166
- \`\`\`typescript
167
- // ❌ Before
168
- import { useState, useEffect, useMemo } from 'react';
169
- import { Button } from './components/Button';
170
- import React from 'react';
171
- import { formatDate } from '../utils/date';
172
- import { api } from '../../services/api';
173
-
174
- // ✅ After
175
- // 外部依赖
176
- import React, { useEffect, useMemo, useState } from 'react';
177
-
178
- // 内部模块(按层级从远到近)
179
- import { api } from '../../services/api';
180
- import { formatDate } from '../utils/date';
181
- import { Button } from './components/Button';
182
- \`\`\`
183
-
184
- ### 🔧 格式化修复
185
-
186
- **自动格式化:**
187
- \`\`\`bash
188
- # Prettier
189
- npm run format
190
-
191
- # ESLint 自动修复
192
- npm run lint:fix
193
- \`\`\`
194
-
195
- ---
196
-
197
- ## 批量修复命令
198
-
199
- **一键修复所有可自动修复的问题:**
200
- \`\`\`bash
201
- # 1. 格式化代码
202
- npm run format
203
-
204
- # 2. ESLint 自动修复
205
- npm run lint:fix
206
-
207
- # 3. 整理 import
208
- npx organize-imports-cli 'src/**/*.ts'
209
-
210
- # 4. 移除未使用的 import
211
- npx ts-unused-exports tsconfig.json --deleteUnusedFile
212
-
213
- # 5. TypeScript 类型检查
214
- tsc --noEmit
215
- \`\`\`
216
-
217
- ---
218
-
219
- ## 修复报告
220
-
221
- ### 📊 问题统计
222
- - Lint 错误: X 个
223
- - 类型错误: Y 个
224
- - 格式问题: Z 个
225
- - Import 问题: W 个
226
-
227
- ### ✅ 已自动修复
228
- 1. [文件:行号] 问题描述 → 已修复
229
- 2. [文件:行号] 问题描述 → 已修复
230
-
231
- ### ⚠️ 需要手动处理
232
- 1. [文件:行号] 问题描述 → 修复建议
233
- 2. [文件:行号] 问题描述 → 修复建议
234
-
235
- ### 📝 修复后的代码
236
- \`\`\`typescript
237
- // 完整的修复后代码
238
- \`\`\`
239
-
240
- ---
241
-
242
- ## 预防措施
243
-
244
- **配置自动修复:**
245
-
246
- \`\`\`.vscode/settings.json
247
- {
248
- "editor.formatOnSave": true,
249
- "editor.codeActionsOnSave": {
250
- "source.fixAll.eslint": true,
251
- "source.organizeImports": true
252
- },
253
- "eslint.validate": [
254
- "javascript",
255
- "typescript",
256
- "javascriptreact",
257
- "typescriptreact"
258
- ]
259
- }
260
- \`\`\`
261
-
262
- **Git Hooks(Husky):**
263
- \`\`\`json
264
- {
265
- "husky": {
266
- "hooks": {
267
- "pre-commit": "lint-staged"
268
- }
269
- },
270
- "lint-staged": {
271
- "*.{js,ts,tsx}": [
272
- "eslint --fix",
273
- "prettier --write"
274
- ]
275
- }
276
- }
277
- \`\`\`
278
-
279
- ---
280
-
281
- 现在请开始分析代码问题并自动修复。`;
282
- return {
283
- content: [
284
- {
285
- type: "text",
286
- text: message,
287
- },
288
- ],
289
- };
290
- }
291
- catch (error) {
292
- const errorMessage = error instanceof Error ? error.message : String(error);
293
- return {
294
- content: [
295
- {
296
- type: "text",
297
- text: `❌ 自动修复失败: ${errorMessage}`,
298
- },
299
- ],
300
- isError: true,
301
- };
302
- }
303
- }
@@ -1,13 +0,0 @@
1
- export declare function genSkill(args: any): Promise<{
2
- content: {
3
- type: string;
4
- text: string;
5
- }[];
6
- isError?: undefined;
7
- } | {
8
- content: {
9
- type: string;
10
- text: string;
11
- }[];
12
- isError: boolean;
13
- }>;