@stackwright-pro/mcp 0.2.0-alpha.95 → 0.2.0-alpha.98

package/dist/server.mjs

@@ -2705,7 +2705,8 @@ var MANIFEST_NAME_TO_PHASE = {
   "stackwright-pro-form-wizard-otter": "workflow",
   "stackwright-pro-geo-otter": "geo",
   "stackwright-pro-polish-otter": "polish",
-  "stackwright-services-otter": "services"
+  "stackwright-services-otter": "services",
+  "stackwright-pro-qa-otter": "qa"
 };
 function manifestNameToPhase(name) {
   return MANIFEST_NAME_TO_PHASE[name] ?? null;
@@ -2908,6 +2909,7 @@ function loadPipelineGraph() {
 }
 
 // src/tools/pipeline.ts
+import { emit } from "@stackwright-pro/telemetry";
 var PHASE_ORDER = [
   "designer",
   "theme",
@@ -2922,7 +2924,8 @@ var PHASE_ORDER = [
   "services",
   "pages",
   "dashboard",
-  "polish"
+  "polish",
+  "qa"
 ];
 var PHASE_ARTIFACT = {
   designer: "design-language.json",
@@ -2936,7 +2939,8 @@ var PHASE_ARTIFACT = {
   workflow: "workflow-config.json",
   services: "services-config.json",
   polish: "polish-manifest.json",
-  geo: "geo-manifest.json"
+  geo: "geo-manifest.json",
+  qa: "qa-findings.json"
 };
 var PHASE_TO_OTTER2 = {
   designer: "stackwright-pro-designer-otter",
@@ -2950,7 +2954,8 @@ var PHASE_TO_OTTER2 = {
   workflow: "stackwright-pro-form-wizard-otter",
   services: "stackwright-services-otter",
   polish: "stackwright-pro-polish-otter",
-  geo: "stackwright-pro-geo-otter"
+  geo: "stackwright-pro-geo-otter",
+  qa: "stackwright-pro-qa-otter"
 };
 function isValidPhase2(phase) {
   return PHASE_ORDER.includes(phase);
@@ -3119,6 +3124,28 @@ function handleSetPipelineState(input) {
       }
     }
     writeState(cwd, state);
+    try {
+      const completedPhases = Object.entries(state.phases).filter(([, ps]) => ps.artifactWritten).map(([p]) => p);
+      emit(
+        {
+          type: "pipeline_state_change",
+          state: state.status,
+          phases: { ready: [], completed: completedPhases, blocked: [] }
+        },
+        { cwd }
+      );
+      if (input.field === "artifactWritten" && input.value === true && input.phase) {
+        emit({ type: "phase_complete", phase: input.phase }, { cwd });
+      }
+      if (input.updates) {
+        for (const update of input.updates) {
+          if (update.field === "artifactWritten" && update.value === true) {
+            emit({ type: "phase_complete", phase: update.phase }, { cwd });
+          }
+        }
+      }
+    } catch {
+    }
     return { text: JSON.stringify(state), isError: false };
   } catch (err) {
     return { text: JSON.stringify({ error: true, message: String(err) }), isError: true };
@@ -3494,7 +3521,10 @@ var PHASE_REQUIRED_KEYS = {
   workflow: ["version", "generatedBy"],
   services: ["version", "generatedBy", "flows"],
   polish: ["version", "generatedBy"],
-  geo: ["version", "generatedBy", "geoCollections"]
+  geo: ["version", "generatedBy", "geoCollections"],
+  // qa: skipped=true path only needs version+generatedBy+skipped;
+  // skipped=false path also needs summary+findings — Zod validator enforces the conditional.
+  qa: ["version", "generatedBy", "skipped"]
 };
 var PHASE_ARTIFACT_SCHEMA = {
   designer: JSON.stringify(
@@ -3784,9 +3814,44 @@ var PHASE_ARTIFACT_SCHEMA = {
     },
     null,
     2
+  ),
+  qa: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-qa-otter",
+      // skipped: true path — when dev server is unreachable at audit time
+      // skipped: false path — full audit completed
+      skipped: false,
+      skipReason: null,
+      wcagLevel: "<AA|AAA>",
+      summary: {
+        routesAudited: 3,
+        serious: 0,
+        moderate: 1,
+        minor: 0
+      },
+      findings: [
+        {
+          id: "qa-001",
+          route: "/dashboard",
+          severity: "<serious|moderate|minor>",
+          category: "<visual|a11y|design-contract|runtime>",
+          finding: "Human-readable description of what was observed",
+          evidence: {
+            screenshot: ".stackwright/qa/screenshots/dashboard-light.png",
+            consoleErrors: [],
+            axeViolations: []
+          },
+          suggested_otters: ["stackwright-pro-theme-otter"],
+          suggested_fix: "Specific, concrete next step the repair otter should take"
+        }
+      ]
+    },
+    null,
+    2
   )
 };
-function handleValidateArtifact(input) {
+function _validateArtifactInner(input) {
   const cwd = input._cwd ?? process.cwd();
   const { phase, responseText, artifact: directArtifact } = input;
   if (!isValidPhase2(phase)) {
@@ -3924,6 +3989,40 @@ function handleValidateArtifact(input) {
         };
       }
       return { success: true };
+    },
+    // qa artifact — permissive validator: requires version + generatedBy + skipped.
+    // When skipped=true: skipReason must be a string.
+    // When skipped=false: findings must be an array and summary must be an object.
+    qa: (artifact2) => {
+      const skipped = artifact2["skipped"];
+      if (typeof skipped !== "boolean") {
+        return {
+          success: false,
+          error: { message: '"skipped" must be a boolean (true or false).' }
+        };
+      }
+      if (skipped === true) {
+        if (typeof artifact2["skipReason"] !== "string") {
+          return {
+            success: false,
+            error: { message: 'When skipped=true, "skipReason" must be a string.' }
+          };
+        }
+        return { success: true };
+      }
+      if (!Array.isArray(artifact2["findings"])) {
+        return {
+          success: false,
+          error: { message: 'When skipped=false, "findings" must be an array.' }
+        };
+      }
+      if (typeof artifact2["summary"] !== "object" || artifact2["summary"] === null) {
+        return {
+          success: false,
+          error: { message: 'When skipped=false, "summary" must be an object.' }
+        };
+      }
+      return { success: true };
     }
   };
   const zodValidator = PHASE_ZOD_VALIDATORS[phase];
@@ -3974,6 +4073,32 @@ function handleValidateArtifact(input) {
     return { text: JSON.stringify({ error: true, phase, message }), isError: true };
   }
 }
+function handleValidateArtifact(input) {
+  const cwd = input._cwd ?? process.cwd();
+  const { phase } = input;
+  emit(
+    { type: "tool_call", toolName: "stackwright_pro_validate_artifact", args: { phase }, phase },
+    { cwd }
+  );
+  const result = _validateArtifactInner(input);
+  try {
+    const parsed = JSON.parse(result.text);
+    if (parsed.valid === true && parsed.artifactPath) {
+      emit({ type: "file_write", path: parsed.artifactPath, phase }, { cwd });
+    }
+    emit(
+      {
+        type: "tool_complete",
+        toolName: "stackwright_pro_validate_artifact",
+        success: parsed.valid === true,
+        phase
+      },
+      { cwd }
+    );
+  } catch {
+  }
+  return result;
+}
 function registerPipelineTools(server2) {
   const DESC = "Writes state to .stackwright/ \u2014 the filesystem is the state machine.";
   const res = (r) => ({
@@ -4110,12 +4235,70 @@ function registerPipelineTools(server2) {
       return res(handleValidateArtifact({ phase, responseText: responseText ?? "" }));
     }
   );
+  server2.tool(
+    "stackwright_pro_emit_event",
+    `Emit a telemetry event to .stackwright/pipeline-events.ndjson. Foreman calls this at phase boundaries and agent-invoke boundaries. Best-effort: failures are silent and never block. ${DESC}`,
+    {
+      type: z13.enum(["phase_start", "phase_complete", "agent_invoke_start", "agent_invoke_complete"]).describe("Event type to emit"),
+      phase: z13.string().optional().describe("Current phase name"),
+      targetOtter: z13.string().optional().describe("For agent_invoke_* events: which otter is being invoked"),
+      success: z13.boolean().optional().describe("For agent_invoke_complete: did the invocation succeed?"),
+      otter: z13.string().optional().describe('Which otter is emitting (defaults to "foreman")'),
+      durationSec: z13.number().optional().describe("Duration in seconds (for *_complete events)")
+    },
+    async ({ type, phase, targetOtter, success, otter, durationSec }) => {
+      let emitted = false;
+      try {
+        if (type === "phase_start") {
+          if (!phase) {
+            return res({
+              text: JSON.stringify({ emitted: false, reason: "phase required for phase_start" }),
+              isError: false
+            });
+          }
+          emitted = emit({ type: "phase_start", phase, otter: otter ?? "foreman" });
+        } else if (type === "phase_complete") {
+          if (!phase) {
+            return res({
+              text: JSON.stringify({ emitted: false, reason: "phase required for phase_complete" }),
+              isError: false
+            });
+          }
+          emitted = emit({
+            type: "phase_complete",
+            phase,
+            otter: otter ?? "foreman",
+            ...durationSec != null ? { durationSec } : {}
+          });
+        } else if (type === "agent_invoke_start") {
+          emitted = emit({
+            type: "agent_invoke_start",
+            targetOtter: targetOtter ?? "",
+            phase,
+            otter: otter ?? "foreman"
+          });
+        } else if (type === "agent_invoke_complete") {
+          emitted = emit({
+            type: "agent_invoke_complete",
+            targetOtter: targetOtter ?? "",
+            success: success ?? true,
+            phase,
+            otter: otter ?? "foreman",
+            ...durationSec != null ? { durationSec } : {}
+          });
+        }
+      } catch {
+      }
+      return res({ text: JSON.stringify({ emitted }), isError: false });
+    }
+  );
 }
 
 // src/tools/safe-write.ts
 import { z as z14 } from "zod";
 import { writeFileSync as writeFileSync5, readFileSync as readFileSync6, existsSync as existsSync6, mkdirSync as mkdirSync5, lstatSync as lstatSync7 } from "fs";
 import { normalize, isAbsolute, dirname, join as join6 } from "path";
+import { emit as emit2 } from "@stackwright-pro/telemetry";
 var OTTER_WRITE_ALLOWLISTS = {
   "stackwright-pro-designer-otter": [
     { prefix: ".stackwright/artifacts/", suffix: ".json", description: "Design language artifact" }
@@ -4211,6 +4394,25 @@ var OTTER_WRITE_ALLOWLISTS = {
     { prefix: ".stackwright/artifacts/", suffix: ".json", description: "Polish artifact" },
     { prefix: "README.md", suffix: "", description: "Project README rewrite" }
   ],
+  // QA otter writes ONLY to the qa/ directory and the qa-findings artifact.
+  // It never writes .tsx, .ts, .yml, or .json outside these paths.
+  "stackwright-pro-qa-otter": [
+    {
+      prefix: ".stackwright/artifacts/qa-findings.json",
+      suffix: "",
+      description: "QA findings artifact"
+    },
+    {
+      prefix: ".stackwright/qa/",
+      suffix: ".md",
+      description: "QA report markdown"
+    },
+    {
+      prefix: ".stackwright/qa/screenshots/",
+      suffix: ".png",
+      description: "Route screenshots for evidence"
+    }
+  ],
   // domain-expert-otter is a reader/answerer only — it writes via stackwright_pro_save_phase_answers,
   // not via safe_write. Entry required here because the MCP tool availability guard boilerplate
   // in its system prompt mentions stackwright_pro_safe_write (triggering the coherence test).
@@ -4424,7 +4626,7 @@ function validateContent(filePath, content) {
   if (filePath === ".env" || filePath.startsWith(".env")) return validateEnvContent(content);
   return null;
 }
-function handleSafeWrite(input) {
+function _safeWriteInner(input) {
   const cwd = input._cwd ?? process.cwd();
   const { callerOtter, filePath, content, createDirectories = true } = input;
   const check = checkPathAllowed(callerOtter, filePath);
@@ -4532,6 +4734,31 @@ function handleSafeWrite(input) {
     return { text: JSON.stringify(result), isError: true };
   }
 }
+function handleSafeWrite(input) {
+  const cwd = input._cwd ?? process.cwd();
+  const { filePath, callerOtter } = input;
+  emit2(
+    { type: "tool_call", toolName: "stackwright_pro_safe_write", args: { callerOtter, filePath } },
+    { cwd }
+  );
+  const result = _safeWriteInner(input);
+  try {
+    const parsed = JSON.parse(result.text);
+    if (parsed.success === true && parsed.path) {
+      emit2({ type: "file_write", path: parsed.path, bytes: parsed.bytesWritten }, { cwd });
+    }
+    emit2(
+      {
+        type: "tool_complete",
+        toolName: "stackwright_pro_safe_write",
+        success: parsed.success === true
+      },
+      { cwd }
+    );
+  } catch {
+  }
+  return result;
+}
 function registerSafeWriteTools(server2) {
   const DESC = "Controlled file-write chokepoint. Every write from specialist otters goes through this tool with per-otter path allowlists. The LLM cannot write to arbitrary filesystem paths.";
   server2.tool(
@@ -5473,59 +5700,63 @@ import { join as join8, basename } from "path";
 var _checksums = /* @__PURE__ */ new Map([
   [
     "stackwright-pro-api-otter.json",
-    "822b35d7a330ed8ac0b42a63b0f70a41885aa9b5ea23cc5b8b998b549da4c05c"
+    "b3ad28c4404af9fb3c2cfce258c707dadd37bc59ac236e1f46d6163cd8d5dc9b"
   ],
   [
     "stackwright-pro-auth-otter.json",
-    "d6cd5732667018d99456be77d5955e454da7a0999a0330b5f03a483aa1b9b33f"
+    "1a21d9f23e250f23291124307e5a2a32af5a716566319a3290372dae3d02e637"
   ],
   [
     "stackwright-pro-dashboard-otter.json",
-    "e3b82555fcffbd77285bd304828814e9f9f7257130797c9de3785de97527668c"
+    "d9277616db5680ce3d598908fa3a1b0d0f626e33948785a4c64703b85e463b31"
   ],
   [
     "stackwright-pro-data-otter.json",
-    "bb66eaab31c6872536dca4d3ff145724a46356946dd0665cc4f0346714d3bacb"
+    "536cba95f32667e81ae4b6335378a095f91095598defff0de00af231ebdbc488"
   ],
   [
     "stackwright-pro-designer-otter.json",
-    "b54121c6a2ab5b1ad68c1262c58b2e04e6315feacd6bb8de8e78eb36f2fa6be6"
+    "69a6c09fbb54f971c48eae7fd52faa63cf79be2923e435aca9ff802e8d541d0f"
   ],
   [
     "stackwright-pro-domain-expert-otter.json",
-    "1f21b8ff3450bdae29a4d31b31462ba22583995a448af3c11ab0a5071f46bd72"
+    "14d77cade020f44d1b5a2b406e2599501f3466ee90ca4248500a441d419bc59c"
   ],
   [
     "stackwright-pro-foreman-otter.json",
-    "abb1cc5e40a8c5ff98057273f43a9e90e2791a15951090cd4d98407c0c3618e3"
+    "4db4639e618cdd008d86c416bbc88bd4b2a7965e4bfcf01ec54b828f04ccb816"
   ],
   [
     "stackwright-pro-form-wizard-otter.json",
-    "975ad68e8fb6fe5a10373be278946fa4d9d7ec2238a0b2bd9e4a412e5b1fdd6d"
+    "7f6f94192f26face57dc8b2e22e0a49d23ceeeb356ca4ebde05492f1b25e3c47"
   ],
   [
     "stackwright-pro-geo-otter.json",
-    "ac440da786d8c5ab1feddbf861449c3be3a433a04370578e1b2d35bf6ae7a601"
+    "15f2327b69f75a9c772c2acad5a5d6d3daefb7b55a079aca3205ecd4f33ae349"
   ],
   [
     "stackwright-pro-page-otter.json",
-    "b70bd6e5d2a40230f7c24ff4a6113585a1614e5b6a215ece2bd47ff053c30f58"
+    "c467c5d03b69d87fb1efa9482674a25e2f63782189db74b65309928d47456176"
   ],
   [
     "stackwright-pro-polish-otter.json",
-    "48ef3cf7f29ac6b5e8ab2004d4d41e2fb899e781689178d3905993241c84095a"
+    "1cfea28e121e30181b0a7c8bda0700ffc892a6f919a0ec64996a4cf3f7735b51"
+  ],
+  [
+    "stackwright-pro-qa-otter.json",
+    "822075893bb4f8496f3dca7b0e68eda460a6fbde87480c13c194582eb7744318"
   ],
   [
     "stackwright-pro-scaffold-otter.json",
-    "e8662b63bbc9ce38851d94f9656bbebefdb7843d038862adb9fde2c23f9e77c2"
+    "341d74ff2be24893ed174e869dc40c090f82e25e11d412d63519944512c37f15"
   ],
   [
     "stackwright-pro-theme-otter.json",
-    "fb62e56642f7f94c50ce173f3e1ce978b3f20ab1567e87403b901d6dd991a7db"
+    "b0eccc1945e30b80a0f9a3209c5428e8e32cd09063bd9b2ef7ecb891343774f2"
   ],
   [
     "stackwright-services-otter.json",
-    "0a5dac670482871c718099767b30bf23d8ec57e942bd40a00ce295926d82c6bd"
+    "8997bdd9a6fd3e6e02563578a1649480bc21acf919534ae41f73e70ade7cf500"
   ]
 ]);
 Object.freeze(_checksums);
@@ -5538,6 +5769,7 @@ for (const [name, digest] of CANONICAL_CHECKSUMS) {
     );
   }
 }
+var CANONICAL_OTTERS = Object.freeze([...CANONICAL_CHECKSUMS.keys()]);
 var MAX_OTTER_BYTES = 1 * 1024 * 1024;
 function computeSha256(data) {
   return createHash4("sha256").update(data).digest("hex");
@@ -6972,7 +7204,9 @@ var package_default = {
     "@stackwright-pro/cli-data-explorer": "workspace:*",
     "@stackwright-pro/openapi": "workspace:*",
     "@stackwright-pro/pulse": "workspace:*",
+    "@stackwright-pro/telemetry": "workspace:*",
     "@stackwright-pro/types": "workspace:*",
+    "@stackwright/mcp": "0.6.0-alpha.1",
     "@types/js-yaml": "^4.0.9",
     "js-yaml": "^4.2.0",
     zod: "^4.4.3"
@@ -6992,7 +7226,7 @@ var package_default = {
     "test:coverage": "vitest run --coverage"
   },
   name: "@stackwright-pro/mcp",
-  version: "0.2.0-alpha.95",
+  version: "0.2.0-alpha.98",
   description: "MCP tools for Stackwright Pro - Data Explorer, Security, ISR, and Dashboard generation",
   license: "SEE LICENSE IN LICENSE",
   main: "./dist/server.js",
@@ -7016,6 +7250,11 @@ var package_default = {
       types: "./dist/tools/type-schemas.d.ts",
       import: "./dist/tools/type-schemas.mjs",
       require: "./dist/tools/type-schemas.js"
+    },
+    "./pipeline-constants": {
+      types: "./dist/pipeline-constants.d.ts",
+      import: "./dist/pipeline-constants.mjs",
+      require: "./dist/pipeline-constants.js"
     }
   },
   files: [
@@ -7027,6 +7266,20 @@ var package_default = {
 };
 
 // src/server.ts
+import {
+  registerContentTypeTools,
+  registerPageTools,
+  registerSiteTools,
+  registerProjectTools,
+  registerGitOpsTools,
+  registerBoardTools,
+  registerCollectionTools,
+  registerIntegrationTools,
+  registerComposeTools,
+  registerRenderTools,
+  registerA11yTools,
+  closeBrowser
+} from "@stackwright/mcp/register";
 var server = new McpServer({
   name: "stackwright-pro",
   version: package_default.version
@@ -7051,6 +7304,29 @@ registerGetSchemaTool(server);
 registerScaffoldCleanupTools(server);
 registerContrastTools(server);
 registerCompileTools(server);
+registerContentTypeTools(server);
+registerPageTools(server);
+registerSiteTools(server);
+registerProjectTools(server);
+registerGitOpsTools(server);
+registerBoardTools(server);
+registerCollectionTools(server);
+registerIntegrationTools(server);
+registerComposeTools(server);
+registerRenderTools(server);
+registerA11yTools(server);
+process.on("SIGINT", async () => {
+  const forceExit = setTimeout(() => process.exit(1), 3e3);
+  forceExit.unref();
+  await closeBrowser();
+  process.exit(0);
+});
+process.on("SIGTERM", async () => {
+  const forceExit = setTimeout(() => process.exit(1), 3e3);
+  forceExit.unref();
+  await closeBrowser();
+  process.exit(0);
+});
 async function main() {
   const pipelineGraph = loadPipelineGraph();
   const phasePosition = new Map(PHASE_ORDER.map((p, i) => [p, i]));