mcp-probe-kit 3.2.0 → 3.6.0

package/build/tools/update_memory_asset.d.ts

@@ -0,0 +1,7 @@
+export declare function updateMemoryAsset(args: any): Promise<import("../lib/response.js").ToolResponse | {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+}>;

package/build/tools/update_memory_asset.js

@@ -0,0 +1,98 @@
+import { parseArgs, getString, getNumber } from '../utils/parseArgs.js';
+import { okStructured } from '../lib/response.js';
+import { createMemoryClient } from '../lib/memory-client.js';
+import { handleToolError } from '../utils/error-handler.js';
+import { attachHandles, buildMemoryAssetHandles } from '../lib/handles.js';
+function fieldProvided(args, ...keys) {
+    const record = args?.input && typeof args.input === 'object' && !Array.isArray(args.input)
+        ? { ...args, ...args.input }
+        : args;
+    if (!record || typeof record !== 'object' || Array.isArray(record)) {
+        return false;
+    }
+    return keys.some((key) => key in record && record[key] !== undefined && record[key] !== null);
+}
+export async function updateMemoryAsset(args) {
+    try {
+        const parsed = parseArgs(args, {
+            fieldAliases: {
+                code_snippet: ['code', 'snippet'],
+                file_path: ['path'],
+                source_project: ['project'],
+                source_path: ['source'],
+            },
+        });
+        const assetId = getString(parsed.asset_id);
+        if (!assetId) {
+            throw new Error('缺少必填参数: asset_id');
+        }
+        const patch = {};
+        if (fieldProvided(args, 'name')) {
+            patch.name = getString(parsed.name);
+        }
+        if (fieldProvided(args, 'type')) {
+            patch.type = getString(parsed.type);
+        }
+        if (fieldProvided(args, 'description')) {
+            patch.description = getString(parsed.description);
+        }
+        if (fieldProvided(args, 'summary')) {
+            patch.summary = getString(parsed.summary);
+        }
+        if (fieldProvided(args, 'content', 'code_snippet', 'code', 'snippet')) {
+            patch.content = getString(parsed.content) || getString(parsed.code_snippet);
+        }
+        if (fieldProvided(args, 'tags')) {
+            patch.tags = Array.isArray(parsed.tags)
+                ? parsed.tags.filter((item) => typeof item === 'string')
+                : [];
+        }
+        if (fieldProvided(args, 'confidence')) {
+            patch.confidence = getNumber(parsed.confidence, 0.7);
+        }
+        if (fieldProvided(args, 'usage')) {
+            patch.usage = getString(parsed.usage);
+        }
+        if (fieldProvided(args, 'source_project', 'project')) {
+            patch.sourceProject = getString(parsed.source_project);
+        }
+        if (fieldProvided(args, 'source_path', 'source', 'file_path', 'path')) {
+            patch.sourcePath = getString(parsed.source_path) || getString(parsed.file_path);
+        }
+        if (Object.keys(patch).length === 0) {
+            throw new Error('至少提供一个待更新字段: name, type, description, summary, content, tags, confidence, usage 等');
+        }
+        const client = createMemoryClient();
+        if (!client.isEnabled()) {
+            return okStructured('记忆服务未开启，已跳过更新。', { enabled: false, updated: false, asset: null });
+        }
+        const warnings = [];
+        const nextType = patch.type;
+        const nextContent = patch.content;
+        if (nextType === 'bugfix' && nextContent) {
+            const requiredSections = ['【现象】', '【根因】', '【修复】'];
+            const missing = requiredSections.filter((section) => !nextContent.includes(section));
+            if (missing.length > 0) {
+                warnings.push(`建议 content 包含 ${missing.join('、')}，便于跨仓库检索与复用`);
+            }
+        }
+        if (patch.sourceProject || patch.sourcePath) {
+            warnings.push('跨仓库共享记忆时请勿依赖 source_project/source_path；路径请写入 content 正文（可选）');
+        }
+        const { updated, asset } = await client.updateAsset(assetId, patch);
+        if (!updated || !asset) {
+            return okStructured(`未找到记忆资产: ${assetId}`, { enabled: true, updated: false, asset: null });
+        }
+        return okStructured(`已更新记忆资产: ${asset.name}`, attachHandles({
+            enabled: true,
+            updated: true,
+            asset,
+            warnings: warnings.length > 0 ? warnings : undefined,
+        }, {
+            memory_assets: buildMemoryAssetHandles([{ id: asset.id, name: asset.name, type: asset.type, summary: asset.summary }], 'update_memory_asset'),
+        }));
+    }
+    catch (error) {
+        return handleToolError(error, 'update_memory_asset');
+    }
+}

package/build/tools/workflow.d.ts

@@ -0,0 +1,13 @@
+/**
+ * workflow — 开发工作流路由（只读指南）
+ *
+ * 根据用户意图生成「何时调哪个 MCP 工具」的分阶段计划，
+ * 用于约束 Agent 先走 start_* / code_insight / check_spec，而不是直接写代码。
+ */
+export declare function workflow(args: unknown): Promise<import("../lib/response.js").ToolResponse | {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError: true;
+}>;

package/build/tools/workflow.js

@@ -0,0 +1,69 @@
+import { parseArgs, getString } from '../utils/parseArgs.js';
+import { okStructured } from '../lib/response.js';
+import { handleToolError } from '../utils/error-handler.js';
+import { buildDevWorkflow, renderWorkflowMarkdown } from '../lib/dev-workflow.js';
+import { ensureMcpProbeKitBootstrap } from '../lib/workflow-skill-installer.js';
+import { resolveWorkspaceRoot } from '../lib/workspace-root.js';
+/**
+ * workflow — 开发工作流路由（只读指南）
+ *
+ * 根据用户意图生成「何时调哪个 MCP 工具」的分阶段计划，
+ * 用于约束 Agent 先走 start_* / code_insight / check_spec，而不是直接写代码。
+ */
+export async function workflow(args) {
+    try {
+        const parsed = parseArgs(args, {
+            defaultValues: {
+                intent: '',
+                input: '',
+                scenario: 'auto',
+                description: '',
+            },
+            primaryField: 'intent',
+            fieldAliases: {
+                intent: ['input', 'description', 'goal', 'task', '需求', '目标', '描述'],
+                scenario: ['mode', 'type', '场景', '类型'],
+            },
+        });
+        const intent = getString(parsed.intent) ||
+            getString(parsed.input) ||
+            getString(parsed.description);
+        const scenario = getString(parsed.scenario) || 'auto';
+        const plan = buildDevWorkflow(intent, { scenario });
+        const text = renderWorkflowMarkdown(plan, intent);
+        const projectRoot = resolveWorkspaceRoot('');
+        const bootstrap = ensureMcpProbeKitBootstrap(projectRoot);
+        return okStructured(text, {
+            scenario: plan.scenario,
+            scenarioLabel: plan.scenarioLabel,
+            confidence: plan.confidence,
+            summary: plan.summary,
+            firstTool: plan.firstTool,
+            firstToolArgsHint: plan.firstToolArgsHint ?? null,
+            phases: plan.phases,
+            avoid: plan.avoid,
+            memoryNotes: plan.memoryNotes,
+            projectSkill: {
+                relPath: bootstrap.skill.skillRelPath,
+                existed: bootstrap.skill.existed,
+                created: bootstrap.skill.created,
+                updated: bootstrap.skill.updated,
+                version: bootstrap.skill.version,
+                previousVersion: bootstrap.skill.previousVersion,
+            },
+            agentsMd: {
+                path: bootstrap.agentsMd.path,
+                existed: bootstrap.agentsMd.existed,
+                created: bootstrap.agentsMd.created,
+                updated: bootstrap.agentsMd.updated,
+            },
+            handles: {
+                next_tool: plan.firstTool,
+                next_args: plan.firstToolArgsHint ?? {},
+            },
+        });
+    }
+    catch (error) {
+        return handleToolError(error, 'workflow');
+    }
+}

package/build/utils/__tests__/vercel-guidelines-sync.unit.test.js

@@ -4,18 +4,18 @@ import * as fs from 'fs';
 import * as path from 'path';
 describe('vercel-guidelines-sync', () => {
     it('parses MUST/SHOULD/NEVER rules from markdown', () => {
-        const sample = `# Title
-
-## Interactions
-
-### Keyboard
-
-- MUST: Visible focus rings
-- NEVER: outline: none without replacement
-
-## Animation
-
-- SHOULD: Prefer CSS animations
+        const sample = `# Title
+
+## Interactions
+
+### Keyboard
+
+- MUST: Visible focus rings
+- NEVER: outline: none without replacement
+
+## Animation
+
+- SHOULD: Prefer CSS animations
 `;
         const records = parseVercelGuidelinesMarkdown(sample);
         expect(records).toHaveLength(3);

package/build/utils/design-reasoning-engine.d.ts

@@ -34,6 +34,8 @@ export interface DesignSystemRecommendation {
     typography: TypographyPairing;
     effects: EffectsRecommendation;
     antiPatterns: string[];
+    hardConstraints: string[];
+    bannedList: string[];
     checklist: string[];
     reasoning: string;
 }

package/build/utils/design-reasoning-engine.js

@@ -7,6 +7,7 @@
  * 完全匹配原版 Python 实现：
  * https://github.com/nextlevelbuilder/ui-ux-pro-max-skill
  */
+import { UI_HARD_RULES, UI_BANNED_LIST } from '../lib/quality-constraints.js';
 /**
  * 设计推理引擎（完全匹配 Python 版本）
  */
@@ -98,6 +99,8 @@ export class DesignReasoningEngine {
                 animations: combinedEffects,
             },
             antiPatterns: (reasoning.antiPatterns || '').split('+').map((p) => p.trim()).filter(Boolean),
+            hardConstraints: [...UI_HARD_RULES],
+            bannedList: [...UI_BANNED_LIST],
             checklist: this.generateChecklist(bestStyle, request),
             reasoning: this.generateReasoningText(productRule, bestStyle, bestColor, bestTypography, reasoning),
         };

package/build/utils/themes-sync.js

@@ -66,14 +66,14 @@ function renderGlobalsCss(name, light, dark) {
     const toBlock = (vars) => Object.entries(vars)
         .map(([key, value]) => `    --${key}: ${value};`)
         .join('\n');
-    return `@layer base {
-  /* Theme: ${name} — paste into globals.css */
-  :root {
-${toBlock(light)}
-  }
-  .dark {
-${toBlock(dark)}
-  }
+    return `@layer base {
+  /* Theme: ${name} — paste into globals.css */
+  :root {
+${toBlock(light)}
+  }
+  .dark {
+${toBlock(dark)}
+  }
 }`;
 }
 function buildTheme(input) {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "mcp-probe-kit",
-  "version": "3.2.0",
-  "description": "AI-Powered Development Toolkit - MCP Server with 27 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, UI/UX Pro Max, and Requirements Interview.",
+  "version": "3.6.0",
+  "description": "AI-Powered Development Toolkit - MCP Server with 30 tools covering code quality, development efficiency, project management, and UI/UX design. Features: Structured Output, Workflow Orchestration, MCP Skill auto-sync, UI/UX Pro Max, and Requirements Interview.",
   "mcpName": "io.github.mybolide/mcp-probe-kit",
   "type": "module",
   "main": "build/index.js",
@@ -20,7 +20,10 @@
     "prepare": "npm run build",
     "prepublishOnly": "npm run build",
     "sync-ui-data": "tsx scripts/sync-ui-data.ts",
-    "prebuild": "npm run sync-ui-data",
+    "sync-version": "node scripts/sync-version.mjs",
+    "verify-workflow-skill": "tsx scripts/verify-workflow-skill.ts",
+    "sync-workflow-skill": "tsx scripts/sync-workflow-skill.ts",
+    "prebuild": "npm run sync-version && npm run sync-ui-data && npm run verify-workflow-skill && npm run sync-workflow-skill",
     "docs:serve": "npx http-server docs -p 8080 -o"
   },
   "keywords": [

package/build/resources/index.d.ts

@@ -1,4 +0,0 @@
-/**
- * MCP Resources 统一导出
- */
-export { getToolParamsGuide } from "./tool-params-guide.js";

package/build/resources/index.js

@@ -1,4 +0,0 @@
-/**
- * MCP Resources 统一导出
- */
-export { getToolParamsGuide } from "./tool-params-guide.js";