@qa-ai-stlc/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,15 @@
+# @qa-ai-stlc/mcp-server
+
+A local stdio MCP server over `@qa-ai-stlc/core`: a tool registry with Zod input/output schemas
+(AGENTS.md 12.3). A `ToolDefinition`'s `handler` returns a value matching its `outputSchema` or
+throws — a `QaError` for an expected failure, anything else for a bug — and `registerTool` turns
+that into a structured `CallToolResult` carrying a stable `code` and, when there is one, a
+`remediation`, never a raw stack trace. The server calls no model itself; it is driven by the
+agent host's own model over the MCP protocol.
+
+`qa-mcp-server` starts the stdio server with the built-in tools (currently `qa.ping`, a health
+check that does not touch `.qa/`). The engine-operation tools (doctor, explore, scope, cases,
+approve, validate, report) are a separate, later task.
+
+Part of [QA-AI-STLC](https://github.com/Klim-101/QA-AI-STLC). See the repository root for
+license, contributing and security information.

package/dist/bin/mcp-server.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/bin/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../../src/bin/mcp-server.ts"],"names":[],"mappings":""}

package/dist/bin/mcp-server.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { readPackageVersion } from '../package-version.js';
+import { createQaMcpServer } from '../server.js';
+import { BUILTIN_TOOLS } from '../tools/index.js';
+const server = createQaMcpServer({ version: readPackageVersion(), tools: BUILTIN_TOOLS });
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=mcp-server.js.map

package/dist/bin/mcp-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.js","sourceRoot":"","sources":["../../src/bin/mcp-server.ts"],"names":[],"mappings":";AACA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAElD,MAAM,MAAM,GAAG,iBAAiB,CAAC,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;AAC1F,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from './tool.js';
+export * from './tool-error.js';
+export * from './registry.js';
+export * from './server.js';
+export * from './package-version.js';
+export * from './tools/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+export * from './tool.js';
+export * from './tool-error.js';
+export * from './registry.js';
+export * from './server.js';
+export * from './package-version.js';
+export * from './tools/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,cAAc,WAAW,CAAC;AAC1B,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,sBAAsB,CAAC;AACrC,cAAc,kBAAkB,CAAC"}

package/dist/package-version.d.ts

@@ -0,0 +1,3 @@
+/** The published version of this server package, read from its own `package.json`. */
+export declare function readPackageVersion(): string;
+//# sourceMappingURL=package-version.d.ts.map

package/dist/package-version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.d.ts","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAKA,sFAAsF;AACtF,wBAAgB,kBAAkB,IAAI,MAAM,CAI3C"}

package/dist/package-version.js

@@ -0,0 +1,10 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { createRequire } from 'node:module';
+/** The published version of this server package, read from its own `package.json`. */
+export function readPackageVersion() {
+    const require = createRequire(import.meta.url);
+    const packageJson = require('../package.json');
+    return packageJson.version;
+}
+//# sourceMappingURL=package-version.js.map

package/dist/package-version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-version.js","sourceRoot":"","sources":["../src/package-version.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,sFAAsF;AACtF,MAAM,UAAU,kBAAkB;IAChC,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAiC,CAAC;IAC/E,OAAO,WAAW,CAAC,OAAO,CAAC;AAC7B,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,11 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { z } from 'zod';
+import type { ToolDefinition } from './tool.js';
+/**
+ * Registers `definition` on `server`, adapting its `z.ZodObject` schemas into the SDK's raw-shape
+ * tool API. A thrown error becomes a structured, coded `CallToolResult` (AGENTS.md 5.4, 12.3)
+ * built here, rather than reaching the SDK's own generic catch, which would collapse it to a bare
+ * message string and drop the `code`/`remediation` an agent needs to act on it.
+ */
+export declare function registerTool<Input extends z.ZodObject, Output extends z.ZodObject>(server: McpServer, definition: ToolDefinition<Input, Output>): void;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGhD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,SAAS,CAAC,CAAC,SAAS,EAAE,MAAM,SAAS,CAAC,CAAC,SAAS,EAChF,MAAM,EAAE,SAAS,EACjB,UAAU,EAAE,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,GACxC,IAAI,CAyBN"}

package/dist/registry.js

@@ -0,0 +1,33 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { toToolErrorPayload } from './tool-error.js';
+/**
+ * Registers `definition` on `server`, adapting its `z.ZodObject` schemas into the SDK's raw-shape
+ * tool API. A thrown error becomes a structured, coded `CallToolResult` (AGENTS.md 5.4, 12.3)
+ * built here, rather than reaching the SDK's own generic catch, which would collapse it to a bare
+ * message string and drop the `code`/`remediation` an agent needs to act on it.
+ */
+export function registerTool(server, definition) {
+    server.registerTool(definition.name, {
+        description: definition.description,
+        inputSchema: definition.inputSchema.shape,
+        outputSchema: definition.outputSchema.shape,
+    }, async (rawInput) => {
+        try {
+            // The SDK already validated `rawInput` against `definition.inputSchema.shape` before
+            // calling this handler, so it is a real `z.infer<Input>` at runtime; TypeScript cannot
+            // prove that through two layers of generic indirection (registerTool's own generics,
+            // then the SDK's), so the cast documents an invariant the SDK enforces, not a bypass.
+            const output = await definition.handler(rawInput);
+            return {
+                content: [{ type: 'text', text: `${definition.name} succeeded.` }],
+                structuredContent: output,
+            };
+        }
+        catch (error) {
+            const payload = toToolErrorPayload(error);
+            return { content: [{ type: 'text', text: JSON.stringify(payload) }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAMtC,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AAErD;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC1B,MAAiB,EACjB,UAAyC;IAEzC,MAAM,CAAC,YAAY,CACjB,UAAU,CAAC,IAAI,EACf;QACE,WAAW,EAAE,UAAU,CAAC,WAAW;QACnC,WAAW,EAAE,UAAU,CAAC,WAAW,CAAC,KAAK;QACzC,YAAY,EAAE,UAAU,CAAC,YAAY,CAAC,KAAK;KAC5C,EACD,KAAK,EAAE,QAAiB,EAA2B,EAAE;QACnD,IAAI,CAAC;YACH,qFAAqF;YACrF,uFAAuF;YACvF,qFAAqF;YACrF,sFAAsF;YACtF,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,OAAO,CAAC,QAA0B,CAAC,CAAC;YACpE,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,UAAU,CAAC,IAAI,aAAa,EAAE,CAAC;gBAClE,iBAAiB,EAAE,MAAM;aAC1B,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC;YAC1C,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QACvF,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,10 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ToolDefinition } from './tool.js';
+export interface CreateQaMcpServerOptions {
+    /** The running server's own version, reported to clients during initialization. */
+    readonly version: string;
+    readonly tools: readonly ToolDefinition[];
+}
+/** Builds the MCP server every tool registers on, not yet attached to a transport. */
+export declare function createQaMcpServer(options: CreateQaMcpServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAIhD,MAAM,WAAW,wBAAwB;IACvC,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,KAAK,EAAE,SAAS,cAAc,EAAE,CAAC;CAC3C;AAED,sFAAsF;AACtF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,wBAAwB,GAAG,SAAS,CAM9E"}

package/dist/server.js

@@ -0,0 +1,14 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { registerTool } from './registry.js';
+const SERVER_NAME = 'qa-ai-stlc';
+/** Builds the MCP server every tool registers on, not yet attached to a transport. */
+export function createQaMcpServer(options) {
+    const server = new McpServer({ name: SERVER_NAME, version: options.version });
+    for (const tool of options.tools) {
+        registerTool(server, tool);
+    }
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAG7C,MAAM,WAAW,GAAG,YAAY,CAAC;AAQjC,sFAAsF;AACtF,MAAM,UAAU,iBAAiB,CAAC,OAAiC;IACjE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC9E,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;QACjC,YAAY,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tool-error.d.ts

@@ -0,0 +1,16 @@
+/**
+ * What a tool call result's error content carries (AGENTS.md 5.4, 12.3): a stable code an agent
+ * can branch on and, when there is one, a remediation it can act on — never a raw stack trace.
+ */
+export interface ToolErrorPayload {
+    readonly code: string;
+    readonly message: string;
+    readonly remediation?: string;
+}
+/**
+ * Converts whatever a tool handler threw into a structured payload: a `QaError`'s own `code` and
+ * `remediation` pass through unchanged; anything else (a real bug, not an expected failure) gets
+ * a generic code and no remediation, since there is nothing actionable to suggest.
+ */
+export declare function toToolErrorPayload(error: unknown): ToolErrorPayload;
+//# sourceMappingURL=tool-error.d.ts.map

package/dist/tool-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.d.ts","sourceRoot":"","sources":["../src/tool-error.ts"],"names":[],"mappings":"AAKA;;;GAGG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAID;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CASnE"}

package/dist/tool-error.js

@@ -0,0 +1,20 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { QaError } from '@qa-ai-stlc/core';
+const INTERNAL_ERROR_CODE = 'MCP_TOOL_INTERNAL_ERROR';
+/**
+ * Converts whatever a tool handler threw into a structured payload: a `QaError`'s own `code` and
+ * `remediation` pass through unchanged; anything else (a real bug, not an expected failure) gets
+ * a generic code and no remediation, since there is nothing actionable to suggest.
+ */
+export function toToolErrorPayload(error) {
+    if (error instanceof QaError) {
+        return {
+            code: error.code,
+            message: error.message,
+            ...(error.remediation !== undefined ? { remediation: error.remediation } : {}),
+        };
+    }
+    return { code: INTERNAL_ERROR_CODE, message: error instanceof Error ? error.message : String(error) };
+}
+//# sourceMappingURL=tool-error.js.map

package/dist/tool-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool-error.js","sourceRoot":"","sources":["../src/tool-error.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAY3C,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAEtD;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,IAAI,KAAK,YAAY,OAAO,EAAE,CAAC;QAC7B,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,OAAO,EAAE,KAAK,CAAC,OAAO;YACtB,GAAG,CAAC,KAAK,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC/E,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;AACxG,CAAC"}

package/dist/tool.d.ts

@@ -0,0 +1,15 @@
+import type { z } from 'zod';
+/**
+ * One MCP tool (AGENTS.md 12.3): a Zod input and output schema, and a handler that either
+ * returns a value matching `outputSchema` or throws (a `QaError` for an expected failure, any
+ * other error for a bug). `registerTool` (registry.ts) is the only place that turns a throw into
+ * a structured, coded MCP result — handlers never format their own error response.
+ */
+export interface ToolDefinition<Input extends z.ZodObject = z.ZodObject, Output extends z.ZodObject = z.ZodObject> {
+    readonly name: string;
+    readonly description: string;
+    readonly inputSchema: Input;
+    readonly outputSchema: Output;
+    handler(input: z.infer<Input>): Promise<z.infer<Output>>;
+}
+//# sourceMappingURL=tool.d.ts.map

package/dist/tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.d.ts","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAE7B;;;;;GAKG;AACH,MAAM,WAAW,cAAc,CAC7B,KAAK,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,EACvC,MAAM,SAAS,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS;IAExC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,KAAK,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC;CAC1D"}

package/dist/tool.js

@@ -0,0 +1,4 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+export {};
+//# sourceMappingURL=tool.js.map

package/dist/tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tool.js","sourceRoot":"","sources":["../src/tool.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC"}

package/dist/tools/index.d.ts

@@ -0,0 +1,4 @@
+import type { ToolDefinition } from '../tool.js';
+/** Every tool the server registers by default. P2-05 adds the real engine-operation tools here. */
+export declare const BUILTIN_TOOLS: readonly ToolDefinition[];
+//# sourceMappingURL=index.d.ts.map

package/dist/tools/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,mGAAmG;AACnG,eAAO,MAAM,aAAa,EAAE,SAAS,cAAc,EAAe,CAAC"}

package/dist/tools/index.js

@@ -0,0 +1,6 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { pingTool } from './ping.js';
+/** Every tool the server registers by default. P2-05 adds the real engine-operation tools here. */
+export const BUILTIN_TOOLS = [pingTool];
+//# sourceMappingURL=index.js.map

package/dist/tools/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAGrC,mGAAmG;AACnG,MAAM,CAAC,MAAM,aAAa,GAA8B,CAAC,QAAQ,CAAC,CAAC"}

package/dist/tools/ping.d.ts

@@ -0,0 +1,15 @@
+import { z } from 'zod';
+import type { ToolDefinition } from '../tool.js';
+declare const InputSchema: z.ZodObject<{}, z.core.$strip>;
+declare const OutputSchema: z.ZodObject<{
+    pong: z.ZodLiteral<true>;
+    version: z.ZodString;
+}, z.core.$strip>;
+/**
+ * A health check owned by the server itself, not an engine operation (those are P2-05's tools):
+ * proves the process is up and the tool-call round trip works, without touching `.qa/` or the
+ * engine at all.
+ */
+export declare const pingTool: ToolDefinition<typeof InputSchema, typeof OutputSchema>;
+export {};
+//# sourceMappingURL=ping.d.ts.map

package/dist/tools/ping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.d.ts","sourceRoot":"","sources":["../../src/tools/ping.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,QAAA,MAAM,WAAW,gCAAe,CAAC;AACjC,QAAA,MAAM,YAAY;;;iBAGhB,CAAC;AAEH;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,cAAc,CAAC,OAAO,WAAW,EAAE,OAAO,YAAY,CAM5E,CAAC"}

package/dist/tools/ping.js

@@ -0,0 +1,22 @@
+// Copyright The QA-AI-STLC Authors
+// SPDX-License-Identifier: Apache-2.0
+import { z } from 'zod';
+import { readPackageVersion } from '../package-version.js';
+const InputSchema = z.object({});
+const OutputSchema = z.object({
+    pong: z.literal(true),
+    version: z.string(),
+});
+/**
+ * A health check owned by the server itself, not an engine operation (those are P2-05's tools):
+ * proves the process is up and the tool-call round trip works, without touching `.qa/` or the
+ * engine at all.
+ */
+export const pingTool = {
+    name: 'qa.ping',
+    description: 'Checks that the QA-AI-STLC MCP server is running and responding to tool calls.',
+    inputSchema: InputSchema,
+    outputSchema: OutputSchema,
+    handler: () => Promise.resolve({ pong: true, version: readPackageVersion() }),
+};
+//# sourceMappingURL=ping.js.map

package/dist/tools/ping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ping.js","sourceRoot":"","sources":["../../src/tools/ping.ts"],"names":[],"mappings":"AAAA,mCAAmC;AACnC,sCAAsC;AAEtC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AACjC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;IACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;CACpB,CAAC,CAAC;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA4D;IAC/E,IAAI,EAAE,SAAS;IACf,WAAW,EAAE,gFAAgF;IAC7F,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,YAAY;IAC1B,OAAO,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,kBAAkB,EAAE,EAAE,CAAC;CAC9E,CAAC"}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@qa-ai-stlc/mcp-server",
+  "version": "0.1.0",
+  "description": "Local stdio MCP server over the core engine API: a tool registry with Zod input/output schemas and coded errors. Calls no model itself.",
+  "type": "module",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/Klim-101/QA-AI-STLC/tree/main/packages/mcp-server#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Klim-101/QA-AI-STLC.git",
+    "directory": "packages/mcp-server"
+  },
+  "bugs": "https://github.com/Klim-101/QA-AI-STLC/issues",
+  "files": [
+    "dist"
+  ],
+  "bin": {
+    "qa-mcp-server": "./dist/bin/mcp-server.js"
+  },
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "scripts": {
+    "pretypecheck": "npm run build --workspace @qa-ai-stlc/schemas --workspace @qa-ai-stlc/core --workspace @qa-ai-stlc/test-utils",
+    "typecheck": "tsc --noEmit -p .",
+    "pretest": "npm run build --workspace @qa-ai-stlc/schemas --workspace @qa-ai-stlc/core --workspace @qa-ai-stlc/test-utils",
+    "test": "vitest run",
+    "pretest:coverage": "npm run build --workspace @qa-ai-stlc/schemas --workspace @qa-ai-stlc/core --workspace @qa-ai-stlc/test-utils",
+    "test:coverage": "vitest run --coverage",
+    "build": "tsc -b tsconfig.build.json",
+    "clean": "node ../../scripts/clean-dir.mjs dist"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "1.30.0",
+    "@qa-ai-stlc/core": "0.6.0",
+    "@qa-ai-stlc/schemas": "0.7.0",
+    "zod": "4.6.5"
+  },
+  "devDependencies": {
+    "@qa-ai-stlc/test-utils": "0.0.0"
+  }
+}