@stackwright-pro/mcp 0.2.0-alpha.102 → 0.2.0-alpha.104

package/dist/server.mjs

@@ -556,7 +556,7 @@ function registerDashboardTools(server2) {
         yamlLines.push(`          header: Status`);
         yamlLines.push(`          type: badge`);
       }
-      const yaml2 = yamlLines.join("\n");
+      const yaml3 = yamlLines.join("\n");
       return {
         content: [
           {
@@ -566,7 +566,7 @@ function registerDashboardTools(server2) {
 Layout: ${layout}
 
 \`\`\`yaml
-${yaml2}
+${yaml3}
 \`\`\`
 
 \u{1F4A1} Add this to pages/dashboard/content.yml and validate with stackwright_validate_pages.`
@@ -647,7 +647,7 @@ ${yaml2}
       yamlLines.push("          action: navigate");
       yamlLines.push(`          href: "/${entity}"`);
       yamlLines.push("          style: secondary");
-      const yaml2 = yamlLines.join("\n");
+      const yaml3 = yamlLines.join("\n");
       return {
         content: [
           {
@@ -655,7 +655,7 @@ ${yaml2}
             text: `\u{1F4C4} Generated Detail Page for: ${entity}
 
 \`\`\`yaml
-${yaml2}
+${yaml3}
 \`\`\`
 
 \u{1F4A1} Add this to pages/${entity}/[${slugField}]/content.yml and validate.`
@@ -2455,7 +2455,7 @@ function enrichErrors(issues, synonyms) {
   });
 }
 function handleValidateYamlFragment(input) {
-  const { schemaName, yaml: yaml2 } = input;
+  const { schemaName, yaml: yaml3 } = input;
   if (!SUPPORTED_SCHEMA_NAMES.includes(schemaName)) {
     return {
       valid: false,
@@ -2465,7 +2465,7 @@ function handleValidateYamlFragment(input) {
   const name = schemaName;
   let parsed;
   try {
-    parsed = yamlLoad(yaml2);
+    parsed = yamlLoad(yaml3);
   } catch (err) {
     return {
       valid: false,
@@ -2491,8 +2491,8 @@ function registerValidateYamlFragmentTool(server2) {
       ),
       yaml: z11.string().describe("YAML string to validate (can also be JSON \u2014 js-yaml parses both)")
     },
-    async ({ schemaName, yaml: yaml2 }) => {
-      const result = handleValidateYamlFragment({ schemaName, yaml: yaml2 });
+    async ({ schemaName, yaml: yaml3 }) => {
+      const result = handleValidateYamlFragment({ schemaName, yaml: yaml3 });
       return {
         content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
       };
@@ -4198,20 +4198,20 @@ function handleEmitEvent(input) {
   }
 }
 function registerPipelineTools(server2) {
-  const DESC2 = "Writes state to .stackwright/ \u2014 the filesystem is the state machine.";
+  const DESC = "Writes state to .stackwright/ \u2014 the filesystem is the state machine.";
   const res = (r) => ({
     content: [{ type: "text", text: r.text }],
     isError: r.isError
   });
   server2.tool(
     "stackwright_pro_get_pipeline_state",
-    `Read pipeline state from .stackwright/pipeline-state.json. ${DESC2}`,
+    `Read pipeline state from .stackwright/pipeline-state.json. ${DESC}`,
     {},
     async () => res(handleGetPipelineState())
   );
   server2.tool(
     "stackwright_pro_set_pipeline_state",
-    `Atomic read\u2192modify\u2192write pipeline state. ${DESC2}`,
+    `Atomic read\u2192modify\u2192write pipeline state. ${DESC}`,
     {
       phase: z13.string().optional().describe('Phase to update, e.g. "designer"'),
       field: z13.enum(["questionsCollected", "answered", "executed", "artifactWritten", "inFlight"]).optional().describe("Boolean field to set"),
@@ -4252,7 +4252,7 @@ function registerPipelineTools(server2) {
   );
   server2.tool(
     "stackwright_pro_check_execution_ready",
-    `Check all phases have answer files in .stackwright/answers/. If phase is provided, check only that phase. ${DESC2}`,
+    `Check all phases have answer files in .stackwright/answers/. If phase is provided, check only that phase. ${DESC}`,
     {
       phase: z13.string().optional().describe("If provided, check only this phase's readiness. Omit to check all phases.")
     },
@@ -4260,19 +4260,19 @@ function registerPipelineTools(server2) {
   );
   server2.tool(
     "stackwright_pro_get_ready_phases",
-    `Return phases whose dependencies are all satisfied (executed=true). Use to determine which phases can run next \u2014 enables wave-based execution. ${DESC2}`,
+    `Return phases whose dependencies are all satisfied (executed=true). Use to determine which phases can run next \u2014 enables wave-based execution. ${DESC}`,
     {},
     async () => res(handleGetReadyPhases())
   );
   server2.tool(
     "stackwright_pro_list_artifacts",
-    `List phase artifacts in .stackwright/artifacts/ with completedCount/totalCount. ${DESC2}`,
+    `List phase artifacts in .stackwright/artifacts/ with completedCount/totalCount. ${DESC}`,
     {},
     async () => res(handleListArtifacts())
   );
   server2.tool(
     "stackwright_pro_write_phase_questions",
-    `Parse otter question-collection response \u2192 .stackwright/questions/{phase}.json. Specialists may also call this directly with a parsed questions array. ${DESC2}`,
+    `Parse otter question-collection response \u2192 .stackwright/questions/{phase}.json. Specialists may also call this directly with a parsed questions array. ${DESC}`,
     {
       phase: z13.string().optional().describe('Phase name, e.g. "designer" (required for direct write)'),
       responseText: z13.string().optional().describe("Raw LLM response from QUESTION_COLLECTION_MODE"),
@@ -4317,13 +4317,13 @@ function registerPipelineTools(server2) {
   );
   server2.tool(
     "stackwright_pro_build_specialist_prompt",
-    `Assemble execution prompt from answers + upstream artifacts. Foreman passes verbatim. ${DESC2}`,
+    `Assemble execution prompt from answers + upstream artifacts. Foreman passes verbatim. ${DESC}`,
     { phase: z13.string().describe('Phase to build prompt for, e.g. "pages"') },
     async ({ phase }) => res(handleBuildSpecialistPrompt({ phase }))
   );
   server2.tool(
     "stackwright_pro_validate_artifact",
-    `Validate and write artifact to .stackwright/artifacts/. Returns retryPrompt on failure. ${DESC2}`,
+    `Validate and write artifact to .stackwright/artifacts/. Returns retryPrompt on failure. ${DESC}`,
     {
       phase: z13.string().describe('Phase that produced this artifact, e.g. "designer"'),
       responseText: z13.string().optional().describe("Raw response text from the specialist otter (Foreman-mediated path, legacy)"),
@@ -4355,7 +4355,7 @@ function registerPipelineTools(server2) {
   );
   server2.tool(
     "stackwright_pro_emit_event",
-    `FOREMAN ONLY \u2014 specialist otters that call this will receive an authorization rejection (no-op, not an error). 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. ${DESC2}`,
+    `FOREMAN ONLY \u2014 specialist otters that call this will receive an authorization rejection (no-op, not an error). 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",
@@ -4854,10 +4854,10 @@ function handleSafeWrite(input) {
   return result;
 }
 function registerSafeWriteTools(server2) {
-  const DESC2 = "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.";
+  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(
     "stackwright_pro_safe_write",
-    DESC2,
+    DESC,
     {
       callerOtter: z14.string().describe('The otter agent name requesting the write, e.g. "stackwright-pro-page-otter"'),
       filePath: z14.string().describe('Relative path from project root, e.g. "pages/dashboard/content.yml"'),
@@ -5801,7 +5801,7 @@ import { join as join8, basename } from "path";
 var _checksums = /* @__PURE__ */ new Map([
   [
     "stackwright-pro-api-otter.json",
-    "175cca39127beea84ed8f1b264b8cd5cf58733db050d32328c039cca0cf0b981"
+    "023352bac8303d86b33559719dc3f8d06d3a5a1458719eb74e1dc76019cf9d2f"
   ],
   [
     "stackwright-pro-auth-otter.json",
@@ -5809,7 +5809,7 @@ var _checksums = /* @__PURE__ */ new Map([
   ],
   [
     "stackwright-pro-dashboard-otter.json",
-    "6918b51d1007c69e635f252b20b82774fa7c942fa1d2399769c14f8d1df4df70"
+    "f8d594b14e05efea30cf253052d7c7df3e8c4174d739be4cd33f9c96cecdc451"
   ],
   [
     "stackwright-pro-data-otter.json",
@@ -5825,7 +5825,7 @@ var _checksums = /* @__PURE__ */ new Map([
   ],
   [
     "stackwright-pro-foreman-otter.json",
-    "c23436769a9db06fa6f9d312b4fdd8b2cef6646461020eeaf227303350073593"
+    "9d68b7b20af7a8a1668e2a693b4a2b05cf37acce1e9f6298a0966c97a3417e9f"
   ],
   [
     "stackwright-pro-form-wizard-otter.json",
@@ -5849,11 +5849,11 @@ var _checksums = /* @__PURE__ */ new Map([
   ],
   [
     "stackwright-pro-scaffold-otter.json",
-    "c2ae10733d8bd66bd965b29a77193b0abf0ea6765cd02886df1413bf598e0588"
+    "92930c732547c90a19e89ee0e25b5f037b7366f770941f0a01e148ff240a1b6d"
   ],
   [
     "stackwright-pro-theme-otter.json",
-    "b0eccc1945e30b80a0f9a3209c5428e8e32cd09063bd9b2ef7ecb891343774f2"
+    "01d16d0597d475db60362e3b8020035e140817d197c36f4307a48b95f4b28b60"
   ],
   [
     "stackwright-services-otter.json",
@@ -6930,10 +6930,10 @@ function handleCleanupScaffold(_cwd) {
   };
 }
 function registerScaffoldCleanupTools(server2) {
-  const DESC2 = "Deterministic scaffold remnant cleanup \u2014 removes stale OSS scaffold files after raft run.";
+  const DESC = "Deterministic scaffold remnant cleanup \u2014 removes stale OSS scaffold files after raft run.";
   server2.tool(
     "stackwright_pro_cleanup_scaffold",
-    `Remove/rewrite stale scaffold files (blog posts, hardcoded not-found page) after the raft pipeline completes. ${DESC2}`,
+    `Remove/rewrite stale scaffold files (blog posts, hardcoded not-found page) after the raft pipeline completes. ${DESC}`,
     {},
     async () => {
       const r = handleCleanupScaffold();
@@ -7506,7 +7506,7 @@ import { z as z22 } from "zod";
 import { readFileSync as readFileSync12, existsSync as existsSync12, readdirSync as readdirSync5 } from "fs";
 import { join as join13 } from "path";
 import yaml from "js-yaml";
-import { emitEnvLocal } from "@stackwright-pro/emitters";
+import { emitEnvLocal, emitProvidersFile, emitMockPorts } from "@stackwright-pro/emitters";
 function readIntegrations(cwd) {
   const filePath = join13(cwd, "stackwright.integrations.yml");
   if (!existsSync12(filePath)) return [];
@@ -7546,7 +7546,9 @@ function readServiceTokenRefs(cwd) {
     return [];
   }
 }
-var DESC = "Returns { envLocal, envLocalExample } as JSON. The otter writes both files via stackwright_pro_safe_write.";
+var ENV_LOCAL_DESC = "Returns { envLocal, envLocalExample } as JSON. The otter writes both files via stackwright_pro_safe_write.";
+var PROVIDERS_DESC = "Returns { providersFile } as JSON. The otter writes the file via stackwright_pro_safe_write.";
+var PORTS_DESC = "Returns { ports } as JSON \u2014 map of integration name \u2192 port number.";
 function registerEmitterTools(server2) {
   server2.tool(
     "stackwright_pro_emit_env_local",
@@ -7557,7 +7559,7 @@ Call this tool, then write both files with stackwright_pro_safe_write:
   2. stackwright_pro_safe_write({ filePath: '.env.local', content: envLocal, ... })
   3. stackwright_pro_safe_write({ filePath: '.env.local.example', content: envLocalExample, ... })
 
-Do NOT compose the contents by hand. This emitter is the source of truth. If an env var is missing, update integrations.yml or the emitter \u2014 not the file. This is the first concrete instance of the swp-zf9y deterministic emitter pattern. ${DESC}`,
+Do NOT compose the contents by hand. This emitter is the source of truth. If an env var is missing, update integrations.yml or the emitter \u2014 not the file. This is the first concrete instance of the swp-zf9y deterministic emitter pattern. ${ENV_LOCAL_DESC}`,
     {
       cwd: z22.string().describe(
         "Absolute path to the project root containing stackwright.integrations.yml and optionally services/*.yml"
@@ -7589,6 +7591,91 @@ Do NOT compose the contents by hand. This emitter is the source of truth. If an
       };
     }
   );
+  server2.tool(
+    "stackwright_pro_emit_providers_file",
+    `Emit app/_components/providers.tsx from stackwright.integrations.yml. Deterministic emitter \u2014 uses LITERAL env access per integration so Next.js can inline NEXT_PUBLIC_* vars at build time. Also registers the map provider (default: Cesium for Pro). 
+
+\u26A0\uFE0F CRITICAL: DO NOT compose providers.tsx by hand. Computed env access (process.env[varName]) returns undefined in browser bundles for NEXT_PUBLIC_* vars \u2014 this silently drops all auth headers and causes 401s on every integration.
+
+Workflow:
+  1. stackwright_pro_emit_providers_file({ cwd, mapProvider: 'cesium' }) \u2192 { providersFile }
+  2. stackwright_pro_safe_write({ filePath: 'app/_components/providers.tsx', content: providersFile, ... })
+
+mapProvider options:
+  - 'cesium' (default for Pro): 3D globe + terrain, @stackwright-pro/cesium + cesium peer dep
+  - 'maplibre': free-tier 2D maps, no API key \u2014 OSS-style 2D dashboards only (opt-out)
+  - 'none': skip map registration (ONLY if no pages use map content_items)
+
+This is the second concrete instance of the swp-zf9y deterministic emitter pattern. Refs: swp-57ku, swp-2m89, swp-zf9y, drawer 957. ${PROVIDERS_DESC}`,
+    {
+      cwd: z22.string().describe("Absolute path to the project root containing stackwright.integrations.yml"),
+      mapProvider: z22.enum(["maplibre", "cesium", "none"]).optional().describe(
+        "Map provider to register (default: cesium for Pro \u2014 3D globe + terrain). Use maplibre for OSS-style 2D dashboards (explicit opt-out). Use none if pages have no map content_items."
+      )
+    },
+    async ({ cwd, mapProvider }) => {
+      const integrations = readIntegrations(cwd);
+      const providersFile = emitProvidersFile({ integrations, mapProvider });
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                providersFile,
+                meta: {
+                  integrationsRead: integrations.length,
+                  integrationsWithAuth: integrations.filter((i) => i.auth?.envVar).length,
+                  mapProvider: mapProvider ?? "cesium"
+                }
+              },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    }
+  );
+  server2.tool(
+    "stackwright_pro_emit_mock_ports",
+    `Emit mock backend port assignments from stackwright.integrations.yml. Deterministic emitter \u2014 assigns consecutive ports starting at 4011 to each integration in declaration order. Skipped integrations (skipMockPort=true) are omitted and do not consume a port number.
+
+\u26A0\uFE0F DO NOT pick mockUrl port numbers yourself. Port collisions occur when different models pick different defaults (Opus always picked 4010 for all integrations in run-4).
+
+Workflow:
+  1. stackwright_pro_emit_mock_ports({ cwd }) \u2192 { ports }
+  2. For each integration, set mockUrl to http://localhost:<ports[name]>
+  3. Write stackwright.integrations.yml via stackwright_pro_safe_write
+
+This is the third concrete instance of the swp-zf9y deterministic emitter pattern. Refs: swp-phkh, swp-zf9y. ${PORTS_DESC}`,
+    {
+      cwd: z22.string().describe("Absolute path to the project root containing stackwright.integrations.yml")
+    },
+    async ({ cwd }) => {
+      const integrations = readIntegrations(cwd);
+      const { ports } = emitMockPorts({ integrations });
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                ports,
+                meta: {
+                  integrationsRead: integrations.length,
+                  portsAssigned: Object.keys(ports).length,
+                  portRange: Object.keys(ports).length > 0 ? `${Math.min(...Object.values(ports))}\u2013${Math.max(...Object.values(ports))}` : "none"
+                }
+              },
+              null,
+              2
+            )
+          }
+        ]
+      };
+    }
+  );
 }
 
 // src/tools/list-specs.ts
@@ -7668,6 +7755,140 @@ function registerListSpecsTool(server2) {
   );
 }
 
+// src/tools/consolidate-integrations.ts
+import { z as z24 } from "zod";
+import { readdirSync as readdirSync7, readFileSync as readFileSync14, writeFileSync as writeFileSync10, existsSync as existsSync14, mkdirSync as mkdirSync9 } from "fs";
+import { lockSync as lockSync2 } from "proper-lockfile";
+import { join as join15, basename as basename3 } from "path";
+import yaml2 from "js-yaml";
+var BASE_MOCK_PORT = 4011;
+var STRIP_SUFFIXES2 = ["-openapi", "-asyncapi", "-api", "-spec"];
+function deriveNameFromFilename(filename) {
+  const base = basename3(filename, ".json").replace(/^api-config-/, "");
+  for (const suffix of STRIP_SUFFIXES2) {
+    if (base.endsWith(suffix)) return base.slice(0, -suffix.length);
+  }
+  return base;
+}
+function handleConsolidateIntegrations(input) {
+  const { projectRoot } = input;
+  const artifactsDir = join15(projectRoot, ".stackwright", "artifacts");
+  if (!existsSync14(artifactsDir)) {
+    return { written: false, integrationCount: 0, reason: "no per-spec artifacts found" };
+  }
+  let entries;
+  try {
+    entries = readdirSync7(artifactsDir).filter(
+      (f) => f.startsWith("api-config-") && f.endsWith(".json") && f !== "api-config.json"
+    );
+  } catch {
+    return { written: false, integrationCount: 0, reason: "could not read artifacts directory" };
+  }
+  if (entries.length === 0) {
+    return { written: false, integrationCount: 0, reason: "no per-spec artifacts found" };
+  }
+  entries.sort();
+  const integrationsByName = /* @__PURE__ */ new Map();
+  entries.forEach((filename, index) => {
+    let artifact = {};
+    try {
+      const raw = readFileSync14(join15(artifactsDir, filename), "utf-8");
+      artifact = JSON.parse(raw);
+    } catch {
+    }
+    const name = artifact.integrationName ?? deriveNameFromFilename(filename);
+    const spec = artifact.integrationSpec ?? artifact.specPath ?? `./specs/${name}.yaml`;
+    const mockUrl = artifact.mockUrl ?? `http://localhost:${BASE_MOCK_PORT + index}`;
+    const baseUrl = artifact.baseUrl ?? "";
+    const auth = artifact.auth ?? { type: "none" };
+    const isAsyncApi = artifact.skipped?.some((s) => s.format === "asyncapi") ?? false;
+    const integrationType = artifact.integrationFormat ?? (isAsyncApi ? "asyncapi" : "openapi");
+    const entry = {
+      type: integrationType,
+      name,
+      spec,
+      mockUrl,
+      baseUrl,
+      auth
+    };
+    if (artifact.integrationEndpoints) {
+      entry.endpoints = artifact.integrationEndpoints;
+    }
+    integrationsByName.set(name, entry);
+  });
+  const integrations = Array.from(integrationsByName.values());
+  const dedupedCount = entries.length - integrations.length;
+  const integrationsYmlPath = join15(projectRoot, "stackwright.integrations.yml");
+  let existing = {};
+  if (existsSync14(integrationsYmlPath)) {
+    try {
+      const raw = readFileSync14(integrationsYmlPath, "utf-8");
+      existing = yaml2.load(raw) ?? {};
+    } catch {
+      existing = {};
+    }
+  }
+  const merged = { ...existing, integrations };
+  mkdirSync9(join15(projectRoot), { recursive: true });
+  if (!existsSync14(integrationsYmlPath)) {
+    writeFileSync10(integrationsYmlPath, "", "utf-8");
+  }
+  const release = lockSync2(integrationsYmlPath, {
+    realpath: false,
+    stale: 1e4
+  });
+  try {
+    const header = `# stackwright.integrations.yml \u2014 Auto-generated by stackwright_pro_consolidate_integrations
+`;
+    const body = yaml2.dump(merged, { lineWidth: 120, noRefs: true });
+    writeFileSync10(integrationsYmlPath, header + body, "utf-8");
+  } finally {
+    release();
+  }
+  return {
+    written: true,
+    integrationCount: integrations.length,
+    path: "stackwright.integrations.yml",
+    ...dedupedCount > 0 ? { dedupedCount } : {}
+  };
+}
+function registerConsolidateIntegrationsTool(server2) {
+  server2.tool(
+    "stackwright_pro_consolidate_integrations",
+    [
+      "Assemble stackwright.integrations.yml from per-spec api-config-*.json artifacts.",
+      "Called by the foreman AFTER all parallel api-otter invocations complete (swp-3l9j).",
+      "Reads .stackwright/artifacts/api-config-{name}.json for each spec, deduplicates by",
+      "integration name (last-write-wins), preserves any non-integrations top-level keys in",
+      "an existing stackwright.integrations.yml, and writes the merged result atomically.",
+      "Returns { written, integrationCount, path } on success or { written: false, reason } if",
+      "no per-spec artifacts are found."
+    ].join(" "),
+    {
+      projectRoot: z24.string().describe("Absolute path to the project root directory")
+    },
+    async ({ projectRoot }) => {
+      try {
+        const result = handleConsolidateIntegrations({ projectRoot });
+        return {
+          content: [{ type: "text", text: JSON.stringify(result, null, 2) }]
+        };
+      } catch (err) {
+        const message = err instanceof Error ? err.message : String(err);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ written: false, error: message })
+            }
+          ],
+          isError: true
+        };
+      }
+    }
+  );
+}
+
 // package.json
 var package_default = {
   dependencies: {
@@ -7680,7 +7901,7 @@ var package_default = {
     "@stackwright-pro/pulse": "workspace:*",
     "@stackwright-pro/telemetry": "workspace:*",
     "@stackwright-pro/types": "workspace:*",
-    "@stackwright/mcp": "0.6.0-alpha.1",
+    "@stackwright/mcp": "0.6.0-alpha.2",
     "@types/js-yaml": "^4.0.9",
     "js-yaml": "^4.2.0",
     "proper-lockfile": "^4.1.2",
@@ -7702,7 +7923,7 @@ var package_default = {
     "test:coverage": "vitest run --coverage"
   },
   name: "@stackwright-pro/mcp",
-  version: "0.2.0-alpha.102",
+  version: "0.2.0-alpha.104",
   description: "MCP tools for Stackwright Pro - Data Explorer, Security, ISR, and Dashboard generation",
   license: "SEE LICENSE IN LICENSE",
   main: "./dist/server.js",
@@ -7784,6 +8005,7 @@ registerCompileTools(server);
 registerStripLegacyIntegrationsTool(server);
 registerEmitterTools(server);
 registerListSpecsTool(server);
+registerConsolidateIntegrationsTool(server);
 registerContentTypeTools(server);
 registerPageTools(server);
 registerSiteTools(server);