@byteqa/mcp 1.0.1

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/index.js

@@ -0,0 +1,150 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { createRequire } from "module";
+import { acknowledgeInputSchema, acknowledgeRun, approveInputSchema, approveRun, auditInputSchema, getStatus, retroInputSchema, runAudit, runRetro, statusInputSchema, validateArtifacts, validateInputSchema } from "@byteqa/core";
+//#region src/index.ts
+const pkg = createRequire(import.meta.url)("../package.json");
+function resolveTargetPath(input) {
+	if (typeof input.targetPath === "string" && input.targetPath.length > 0) return input.targetPath;
+	const envTarget = process.env.BYTEQA_TARGET;
+	if (typeof envTarget === "string" && envTarget.length > 0) return envTarget;
+	return null;
+}
+function missingTargetError() {
+	return {
+		content: [{
+			type: "text",
+			text: "byteqa error: targetPath is required. Provide it as a tool input or set the BYTEQA_TARGET environment variable."
+		}],
+		isError: true
+	};
+}
+function errorResponse(err) {
+	return {
+		content: [{
+			type: "text",
+			text: `byteqa error: ${err instanceof Error ? err.message : String(err)}`
+		}],
+		isError: true
+	};
+}
+const server = new McpServer({
+	name: "byteqa-local",
+	version: pkg.version
+});
+server.tool("byteqa_audit", "Run the full byteQA loop — scan, audit, security, performance, checker review. Writes .qa/ into targetPath. Returns structured result with status, bugs, escalations, writeBoundary, and nextAction.", auditInputSchema.shape, async (input) => {
+	const targetPath = resolveTargetPath(input);
+	if (!targetPath) return missingTargetError();
+	try {
+		const result = await runAudit({
+			targetPath,
+			maxLoops: input.maxLoops
+		});
+		return {
+			content: [{
+				type: "text",
+				text: `byteqa audit complete.\nStatus: ${result.status}\nNext action: ${result.nextAction}\nBugs: critical=${result.bugCount.critical} high=${result.bugCount.high} medium=${result.bugCount.medium} low=${result.bugCount.low}\nEscalated: ${result.escalatedBugIds.join(", ") || "none"}\nPending actions: ${result.pendingHumanActions.join("; ") || "none"}`
+			}],
+			structuredContent: result
+		};
+	} catch (err) {
+		return errorResponse(err);
+	}
+});
+server.tool("byteqa_status", "Read the current status of the latest byteQA run. Read-only — never writes files. Returns STATUS, bug summary, pending human actions, and unacted prompt lessons.", statusInputSchema.shape, async (input) => {
+	const targetPath = resolveTargetPath(input);
+	if (!targetPath) return missingTargetError();
+	try {
+		const result = await getStatus({ targetPath });
+		return {
+			content: [{
+				type: "text",
+				text: `byteqa status.\nRun: ${result.runId}\nStatus: ${result.status}\nPending actions: ${result.pendingHumanActions.join("; ") || "none"}`
+			}],
+			structuredContent: result
+		};
+	} catch (err) {
+		return errorResponse(err);
+	}
+});
+server.tool("byteqa_approve", "Approve bugs for dev handoff. Human-facing operation. Writes approval.md and triggers dev-handoff creation when approvedForDev=true.", approveInputSchema.shape, async (input) => {
+	const targetPath = resolveTargetPath(input);
+	if (!targetPath) return missingTargetError();
+	try {
+		const result = await approveRun({
+			targetPath,
+			bugIds: input.bugIds,
+			approvedForDev: input.approvedForDev,
+			notes: input.notes
+		});
+		return {
+			content: [{
+				type: "text",
+				text: `byteqa approve complete.\nApproved bug IDs: ${result.approvedBugIds.join(", ") || "none"}\nDev handoff created: ${result.devHandoffCreated}\nNext action: ${result.nextAction}`
+			}],
+			structuredContent: result
+		};
+	} catch (err) {
+		return errorResponse(err);
+	}
+});
+server.tool("byteqa_acknowledge", "Acknowledge pending human actions. Clears PENDING_HUMAN_ACTIONS and stamps HUMAN_ACKNOWLEDGED_AT so the morning digest does not replay cleared items.", acknowledgeInputSchema.shape, async (input) => {
+	const targetPath = resolveTargetPath(input);
+	if (!targetPath) return missingTargetError();
+	try {
+		const result = await acknowledgeRun({ targetPath });
+		return {
+			content: [{
+				type: "text",
+				text: `byteqa acknowledge complete.\nCleared actions: ${result.clearedActions}\nAcknowledged at: ${result.acknowledgedAt}`
+			}],
+			structuredContent: result
+		};
+	} catch (err) {
+		return errorResponse(err);
+	}
+});
+server.tool("byteqa_validate", "Validate .qa/ artifacts against byteQA schemas. Read-only. Reports malformed or missing required files. Pass artifact to validate a specific file, omit to validate all.", validateInputSchema.shape, async (input) => {
+	const targetPath = resolveTargetPath(input);
+	if (!targetPath) return missingTargetError();
+	try {
+		const result = await validateArtifacts({
+			targetPath,
+			artifact: input.artifact
+		});
+		return {
+			content: [{
+				type: "text",
+				text: `byteqa validate complete.\nValid: ${result.valid}\nErrors: ${result.errors.length}\nWarnings: ${result.warnings.length}`
+			}],
+			structuredContent: result
+		};
+	} catch (err) {
+		return errorResponse(err);
+	}
+});
+server.tool("byteqa_retro", "Analyse the last N byteQA runs and surface patterns: recurring bug types, gate failure trends, Checker escalation rate, verification pass rate. Read-only.", retroInputSchema.shape, async (input) => {
+	const targetPath = resolveTargetPath(input);
+	if (!targetPath) return missingTargetError();
+	try {
+		const result = await runRetro({
+			targetPath,
+			lastNRuns: input.lastNRuns,
+			restoreSkill: input.restoreSkill
+		});
+		return {
+			content: [{
+				type: "text",
+				text: `byteqa retro complete.\nRuns analysed: ${result.runsAnalyzed}\nVerification pass rate: ${result.verificationPassRate}\nChecker escalation rate: ${result.checkerEscalationRate}`
+			}],
+			structuredContent: result
+		};
+	} catch (err) {
+		return errorResponse(err);
+	}
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);
+//#endregion
+export {};

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@byteqa/mcp",
+  "version": "1.0.1",
+  "description": "byteQA local MCP stdio server — adapter over @byteqa/core. Binary: byteqa-mcp.",
+  "bin": {
+    "byteqa-mcp": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "../../README.md"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "prepublishOnly": "tsdown"
+  },
+  "dependencies": {
+    "@byteqa/core": "1.0.1",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  }
+}