@thehammer/schema-mcp-server 1.0.10 → 1.0.11

package/dist/api-client.d.ts

@@ -75,4 +75,11 @@ export declare function callQualityGate(category: string, message?: string): Pro
  */
 export declare function completeDispatch(message?: string): Promise<ApiResponse>;
 export declare function postProgress(progressMessage: string, phase?: string): Promise<ApiResponse>;
+/**
+ * Fail-fast termination — agent calls this the moment anything deviates from the
+ * prompt's described behavior (missing tool, unexpected response, sub-agent not found,
+ * API error the prompt doesn't cover, etc.). Never use shell, tinker, or other creative
+ * workarounds — abort and let the operator diagnose.
+ */
+export declare function abortDispatch(reason: string, details?: string, phase?: string): Promise<ApiResponse>;
 export { SCHEMA_ID };

package/dist/api-client.js

@@ -228,4 +228,17 @@ export async function postProgress(progressMessage, phase) {
         phase,
     });
 }
+/**
+ * Fail-fast termination — agent calls this the moment anything deviates from the
+ * prompt's described behavior (missing tool, unexpected response, sub-agent not found,
+ * API error the prompt doesn't cover, etc.). Never use shell, tinker, or other creative
+ * workarounds — abort and let the operator diagnose.
+ */
+export async function abortDispatch(reason, details, phase) {
+    return apiRequest("POST", mcpPath("abort"), {
+        reason,
+        details,
+        phase,
+    });
+}
 export { SCHEMA_ID };

package/dist/index.js

@@ -52,6 +52,10 @@ const COMMON_TOOLS = [
     "template_preview",
     "template_preview_html",
     "quality_gate_list",
+    // Fail-fast termination — always available regardless of role. The agent calls
+    // this the moment anything deviates from the prompt's described behavior instead
+    // of inventing creative workarounds via shell commands or source-code exploration.
+    "abort",
 ];
 const ROLE_TOOLS = {
     orchestrator: new Set([
@@ -226,6 +230,23 @@ if (shouldRegister("post_progress"))
         const result = await api.postProgress(message, phase);
         return jsonResult(result);
     });
+if (shouldRegister("abort"))
+    server.tool("abort", "FAIL-FAST TERMINATION. Call this the moment anything deviates from the prompt's described behavior: a required tool is missing, a tool returns an unexpected error, a sub-agent can't be invoked, an API call fails in a way the prompt doesn't cover, or anything else the prompt says should work is broken. Do NOT try to work around problems with shell commands, source-code exploration, or creative solutions. Abort, explain what failed, and exit immediately. After calling abort, your response ends — no further tool calls.", {
+        reason: z
+            .string()
+            .describe("Short description of what failed (one sentence). Example: 'mcp__schema__template_patch returned tool_not_found' or 'template-builder sub-agent is not available'."),
+        details: z
+            .string()
+            .optional()
+            .describe("Full error details, stack trace, tool response, or context that would help the operator diagnose the failure."),
+        phase: z
+            .string()
+            .optional()
+            .describe("Phase you were in when the failure occurred (e.g., 'planning', 'delegating', 'template_patch')."),
+    }, async ({ reason, details, phase }) => {
+        const result = await api.abortDispatch(reason, details, phase);
+        return jsonResult(result);
+    });
 // ============================================================================
 // Schema Tools
 // ============================================================================

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thehammer/schema-mcp-server",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "MCP server for Schema Builder - translates Claude Code tool calls into Laravel API requests",
   "license": "MIT",
   "repository": {