@devflow-tools/mcp-server 0.17.0 → 0.17.1

package/dist/command-registry.json

@@ -19,10 +19,16 @@
         "WebFetch"
       ],
       "source": "core",
-      "sourceVersion": "0.17.0",
+      "sourceVersion": "0.17.1",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:context/SKILL.md"
+      "skillPath": "skills/devflow:context/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__get_project_context",
+          "mcp__devflow__search_symbol"
+        ]
+      }
     },
     "devflow:graph": {
       "mcpTools": [
@@ -38,10 +44,15 @@
         "Explore"
       ],
       "source": "core",
-      "sourceVersion": "0.17.0",
+      "sourceVersion": "0.17.1",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:graph/SKILL.md"
+      "skillPath": "skills/devflow:graph/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__get_dependency_graph"
+        ]
+      }
     },
     "devflow:knowledge": {
       "mcpTools": [
@@ -52,10 +63,15 @@
         "WebFetch"
       ],
       "source": "core",
-      "sourceVersion": "0.17.0",
+      "sourceVersion": "0.17.1",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:knowledge/SKILL.md"
+      "skillPath": "skills/devflow:knowledge/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__get_knowledge"
+        ]
+      }
     },
     "devflow:memory": {
       "mcpTools": [
@@ -71,10 +87,15 @@
         "Explore"
       ],
       "source": "core",
-      "sourceVersion": "0.17.0",
+      "sourceVersion": "0.17.1",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:memory/SKILL.md"
+      "skillPath": "skills/devflow:memory/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__get_memory"
+        ]
+      }
     },
     "devflow:workflow": {
       "mcpTools": [
@@ -82,10 +103,15 @@
       ],
       "blockedNative": [],
       "source": "core",
-      "sourceVersion": "0.17.0",
+      "sourceVersion": "0.17.1",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:workflow/SKILL.md"
+      "skillPath": "skills/devflow:workflow/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__run_workflow"
+        ]
+      }
     },
     "devflow:animation": {
       "mcpTools": [
@@ -106,7 +132,12 @@
       "sourceVersion": "0.1.0",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:animation/SKILL.md"
+      "skillPath": "skills/devflow:animation/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__animation_suggest"
+        ]
+      }
     },
     "devflow:css": {
       "mcpTools": [
@@ -127,7 +158,12 @@
       "sourceVersion": "0.1.0",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:css/SKILL.md"
+      "skillPath": "skills/devflow:css/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__css_audit_selectors"
+        ]
+      }
     },
     "devflow:docker": {
       "mcpTools": [
@@ -148,7 +184,12 @@
       "sourceVersion": "0.1.0",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:docker/SKILL.md"
+      "skillPath": "skills/devflow:docker/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__docker_dockerize_project"
+        ]
+      }
     },
     "devflow:electron": {
       "mcpTools": [
@@ -172,7 +213,12 @@
       "skillPath": "skills/devflow:electron/SKILL.md",
       "runtimePackages": [
         "electron"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__electron_diagnose_bug"
+        ]
+      }
     },
     "devflow:git": {
       "mcpTools": [
@@ -193,7 +239,12 @@
       "sourceVersion": "0.1.0",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:git/SKILL.md"
+      "skillPath": "skills/devflow:git/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__git_analyze_repo"
+        ]
+      }
     },
     "devflow:graphql": {
       "mcpTools": [
@@ -217,7 +268,12 @@
       "skillPath": "skills/devflow:graphql/SKILL.md",
       "runtimePackages": [
         "graphql"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__graphql_diagnose_bug"
+        ]
+      }
     },
     "devflow:nest": {
       "mcpTools": [
@@ -242,7 +298,13 @@
       "skillPath": "skills/devflow:nest/SKILL.md",
       "runtimePackages": [
         "@nestjs/core"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__nest_diagnose_bug",
+          "mcp__devflow__nest_new_module"
+        ]
+      }
     },
     "devflow:nextjs": {
       "mcpTools": [
@@ -268,7 +330,13 @@
       "runtimePackages": [
         "next",
         "react"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__nextjs_diagnose_bug",
+          "mcp__devflow__nextjs_new_page"
+        ]
+      }
     },
     "devflow:performance": {
       "mcpTools": [
@@ -289,7 +357,12 @@
       "sourceVersion": "0.1.0",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:performance/SKILL.md"
+      "skillPath": "skills/devflow:performance/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__performance_audit_performance"
+        ]
+      }
     },
     "devflow:react": {
       "mcpTools": [
@@ -318,7 +391,16 @@
       "runtimePackages": [
         "react",
         "react-dom"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__react_review_hooks",
+          "mcp__devflow__react_audit_performance",
+          "mcp__devflow__react_refactor_component",
+          "mcp__devflow__react_diagnose_bug",
+          "mcp__devflow__react_new_component"
+        ]
+      }
     },
     "devflow:tailwind": {
       "mcpTools": [
@@ -343,7 +425,13 @@
       "skillPath": "skills/devflow:tailwind/SKILL.md",
       "runtimePackages": [
         "tailwindcss"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__tailwind_new_component",
+          "mcp__devflow__tailwind_optimize_classes"
+        ]
+      }
     },
     "devflow:taro": {
       "mcpTools": [
@@ -367,7 +455,12 @@
       "skillPath": "skills/devflow:taro/SKILL.md",
       "runtimePackages": [
         "@tarojs/taro"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__taro_new_page"
+        ]
+      }
     },
     "devflow:ui-layout": {
       "mcpTools": [
@@ -388,7 +481,12 @@
       "sourceVersion": "0.1.0",
       "requiresContext": true,
       "evidenceMode": "mixed",
-      "skillPath": "skills/devflow:ui-layout/SKILL.md"
+      "skillPath": "skills/devflow:ui-layout/SKILL.md",
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__ui_layout_generate"
+        ]
+      }
     },
     "devflow:vue": {
       "mcpTools": [
@@ -413,7 +511,13 @@
       "skillPath": "skills/devflow:vue/SKILL.md",
       "runtimePackages": [
         "vue"
-      ]
+      ],
+      "hostTools": {
+        "claude-code": [
+          "mcp__devflow__vue_diagnose_bug",
+          "mcp__devflow__vue_debug_reactivity"
+        ]
+      }
     }
   }
 }

package/dist/server.d.ts

@@ -48,6 +48,9 @@ interface RuntimeIdentity {
     executionId: string;
     toolUseId?: string;
     eventId: string;
+    turnId?: string;
+    requestId?: string;
+    intentArtifactHash?: string;
 }
 export declare const KNOWN_PREFIXES: Set<string>;
 export declare function getCommandFromTool(toolName: string): string;

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/server.js

@@ -17,6 +17,7 @@ import { classifyToolSemanticOutcome } from "./tool-contracts.js";
 import { createMcpSessionToolProfile } from "./tool-profile.js";
 import { isProtocolResourceUri } from "./protocol-resource.js";
 import { McpSamplingAdapter } from './sampling-grader.js';
+import { emitSemanticControlLog } from '@devflow-tools/telemetry';
 export class EngineWarmingError extends Error {
     etaSeconds;
     constructor(etaSeconds = 5) {
@@ -145,7 +146,10 @@ export async function startServer(options) {
     });
     for (const diagnostic of loaded.diagnostics) {
         if (diagnostic.status !== "loaded") {
-            console.error(`[devflow-mcp] plugin ${diagnostic.packageName} ${diagnostic.status}: ${diagnostic.reason ?? "unknown reason"}`);
+            emitSemanticControlLog({
+                event: 'hook.runtime.degraded', identity: { projectRoot: boundProjectRoot }, level: 'warn', timestamp: Date.now(),
+                data: { stage: 'plugin_load', packageName: diagnostic.packageName, status: diagnostic.status, reason: diagnostic.reason ?? 'unknown_reason' },
+            });
         }
     }
     const pluginMap = loaded.plugins;
@@ -203,7 +207,10 @@ export async function startServer(options) {
                         retries -= 1;
                         if (retries === 0)
                             throw error;
-                        console.error(`[devflow-mcp] createEngines failed, retrying... (${retries} left):`, error.message);
+                        emitSemanticControlLog({
+                            event: 'mcp.action.degraded', identity: { projectRoot }, level: 'warn', timestamp: Date.now(),
+                            data: { stage: 'engine_init', reason: boundedError(error), retriesRemaining: retries, fallback: 'bounded_retry' },
+                        });
                         await new Promise((resolve) => setTimeout(resolve, 1500));
                     }
                 }
@@ -323,8 +330,31 @@ export function createCallToolRequestHandler(dependencies) {
         const argObj = (args ?? {});
         const identity = resolveRuntimeIdentity(argObj, boundProjectRoot);
         const handlerArgs = stripRuntimeIdentity(argObj);
+        const semanticIdentity = {
+            projectRoot: identity.projectRoot,
+            sessionId: identity.sessionId,
+            turnId: identity.turnId,
+            requestId: identity.requestId,
+            executionId: identity.executionId,
+            intentArtifactHash: identity.intentArtifactHash,
+        };
+        emitSemanticControlLog({
+            event: 'canonical.tool.resolved', identity: semanticIdentity, level: 'info', timestamp: Date.now(),
+            data: {
+                requestedName: name, canonicalName: name, projectedName: `mcp__devflow__${name}`,
+                status: 'canonical', attempt: 0, capabilityMechanism: 'native', toolUseId: identity.toolUseId,
+            },
+        });
+        emitSemanticControlLog({
+            event: 'mcp.action.started', identity: semanticIdentity, level: 'info', timestamp: Date.now(),
+            data: { tool: name, toolUseId: identity.toolUseId },
+        });
         if (dependencies.acceptedToolNames && !dependencies.acceptedToolNames.has(name)) {
             recordCanonicalActionBoundaryFailure(identity, name, 'unavailable', 'tool_profile_unavailable');
+            emitSemanticControlLog({
+                event: 'mcp.action.failed', identity: semanticIdentity, level: 'warn', timestamp: Date.now(),
+                data: { tool: name, category: 'tool_profile_unavailable', retryable: true },
+            });
             return createErrorResponse(name, {
                 ok: false,
                 status: "unavailable",
@@ -345,7 +375,12 @@ export function createCallToolRequestHandler(dependencies) {
             || name === 'devflow_report_step') {
             handlerArgs._devflow_session_id = identity.sessionId;
             handlerArgs._devflow_execution_id = identity.executionId;
-            handlerArgs._devflow_request_id = identity.eventId;
+            handlerArgs._devflow_request_id = identity.requestId ?? identity.eventId;
+            if (identity.turnId)
+                handlerArgs._devflow_turn_id = identity.turnId;
+            if (identity.intentArtifactHash) {
+                handlerArgs._devflow_intent_artifact_hash = identity.intentArtifactHash;
+            }
             if (identity.toolUseId)
                 handlerArgs._devflow_tool_use_id = identity.toolUseId;
         }
@@ -354,6 +389,10 @@ export function createCallToolRequestHandler(dependencies) {
                 requireProjectRoot(handlerArgs, boundProjectRoot);
             }
             catch (error) {
+                emitSemanticControlLog({
+                    event: 'mcp.action.failed', identity: semanticIdentity, level: 'warn', timestamp: Date.now(),
+                    data: { tool: name, category: 'project_root_invalid', reason: boundedError(error) },
+                });
                 return createErrorResponse(name, { error: error.message });
             }
             argObj.projectRoot = handlerArgs.projectRoot;
@@ -375,6 +414,10 @@ export function createCallToolRequestHandler(dependencies) {
                     blockReason: enforcement.result.rule?.id,
                 });
                 if (enforcement.result.rule?.id === "S001") {
+                    emitSemanticControlLog({
+                        event: 'mcp.action.degraded', identity: semanticIdentity, level: 'warn', timestamp: Date.now(),
+                        data: { tool: name, category: 'context_required', rule: 'S001', retryable: true },
+                    });
                     return createErrorResponse(name, {
                         code: "DEVFLOW_CONTEXT_REQUIRED",
                         error: "Call get_project_context successfully before this domain tool.",
@@ -385,6 +428,10 @@ export function createCallToolRequestHandler(dependencies) {
                         rule: "S001",
                     });
                 }
+                emitSemanticControlLog({
+                    event: 'mcp.action.failed', identity: semanticIdentity, level: 'warn', timestamp: Date.now(),
+                    data: { tool: name, category: 'enforcement_denied', rule: enforcement.result.rule?.id },
+                });
                 return createErrorResponse(name, {
                     error: message,
                     rule: enforcement.result.rule?.id,
@@ -454,6 +501,18 @@ export function createCallToolRequestHandler(dependencies) {
                 finalResult = { ...finalResult, _warning: enforcement.result.warning };
             }
             const preparedResult = prepareResultForClient(boundProjectRoot, name, finalResult);
+            emitSemanticControlLog({
+                event: semanticOutcome.failed
+                    ? 'mcp.action.failed' : semanticOutcome.degraded ? 'mcp.action.degraded' : 'mcp.action.completed',
+                identity: semanticIdentity,
+                level: semanticOutcome.failed ? 'error' : semanticOutcome.degraded ? 'warn' : 'info',
+                timestamp: Date.now(),
+                data: {
+                    tool: name, durationMs, status: semanticOutcome.status,
+                    errorCode: semanticOutcome.errorCode, resultCount: countResults(result),
+                    contextReceipt: enforcement.receipt,
+                },
+            });
             return semanticOutcome.failed
                 ? createErrorResponse(name, asErrorDetails(preparedResult, semanticOutcome))
                 : createSuccessResponse(name, preparedResult, durationMs);
@@ -462,6 +521,10 @@ export function createCallToolRequestHandler(dependencies) {
             durationMs = Date.now() - startTime;
             if (err instanceof EngineWarmingError) {
                 recordCanonicalActionBoundaryFailure(identity, name, 'timeout', 'engine_warming_timeout');
+                emitSemanticControlLog({
+                    event: 'mcp.action.degraded', identity: semanticIdentity, level: 'warn', timestamp: Date.now(),
+                    data: { tool: name, durationMs, category: 'engine_warming_timeout', retryable: true, etaSeconds: err.etaSeconds },
+                });
                 return createSuccessResponse(name, {
                     status: "warming",
                     etaSeconds: err.etaSeconds,
@@ -475,10 +538,17 @@ export function createCallToolRequestHandler(dependencies) {
                 durationMs,
                 error: err.message,
             });
+            emitSemanticControlLog({
+                event: 'mcp.action.failed', identity: semanticIdentity, level: 'error', timestamp: Date.now(),
+                data: { tool: name, durationMs, category: 'handler_error', reason: boundedError(err) },
+            });
             return createErrorResponse(name, { error: err.message });
         }
     };
 }
+function boundedError(error) {
+    return (error instanceof Error ? error.message : String(error)).trim().slice(0, 500) || 'unknown_error';
+}
 function recordCanonicalActionBoundaryFailure(identity, toolName, status, reason) {
     let database;
     try {
@@ -526,17 +596,28 @@ function resolveRuntimeIdentity(args, projectRoot) {
     const toolUseId = typeof args._devflow_tool_use_id === "string" && args._devflow_tool_use_id.trim()
         ? args._devflow_tool_use_id.trim()
         : undefined;
+    const turnId = optionalRuntimeString(args._devflow_turn_id);
+    const requestId = optionalRuntimeString(args._devflow_request_id);
+    const intentArtifactHash = optionalRuntimeString(args._devflow_intent_artifact_hash);
     const eventKey = toolUseId ?? `${Date.now()}:${Math.random()}`;
     const eventId = `evt_tool_${createHash("sha256")
         .update(`${sessionId}\0${eventKey}`)
         .digest("hex")
         .slice(0, 24)}`;
-    return { projectRoot, sessionId, executionId, toolUseId, eventId };
+    return {
+        projectRoot, sessionId, executionId, toolUseId, eventId,
+        ...(turnId ? { turnId } : {}),
+        ...(requestId ? { requestId } : {}),
+        ...(intentArtifactHash ? { intentArtifactHash } : {}),
+    };
 }
 function stripRuntimeIdentity(args) {
-    const { _devflow_session_id: _sessionId, _devflow_execution_id: _executionId, _devflow_tool_use_id: _toolUseId, ...handlerArgs } = args;
+    const { _devflow_session_id: _sessionId, _devflow_execution_id: _executionId, _devflow_tool_use_id: _toolUseId, _devflow_turn_id: _turnId, _devflow_request_id: _requestId, _devflow_intent_artifact_hash: _intentArtifactHash, ...handlerArgs } = args;
     return handlerArgs;
 }
+function optionalRuntimeString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
 function persistContextAccuracySample(identity, input, result) {
     const query = getQueryFromArgs(input);
     if (!query)
@@ -762,7 +843,10 @@ export function syncReceiptToHook(projectRoot, _toolName) {
             unlinkSync(legacyReceipt);
     }
     catch (error) {
-        console.error("[devflow-mcp] Receipt sync failed:", error instanceof Error ? error.message : String(error));
+        emitSemanticControlLog({
+            event: 'mcp.action.degraded', identity: { projectRoot }, level: 'warn', timestamp: Date.now(),
+            data: { tool: 'get_project_context', stage: 'hook_receipt_sync', reason: boundedError(error), fallback: 'database_receipt' },
+        });
     }
     finally {
         try {