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

package/dist/server.mjs

@@ -120,8 +120,8 @@ function registerDataExplorerTools(server2) {
       lines.push("    endpoints:");
       if (result.filter.include && result.filter.include.length > 0) {
         lines.push("      include:");
-        for (const path3 of result.filter.include) {
-          lines.push(`        - ${path3}`);
+        for (const path4 of result.filter.include) {
+          lines.push(`        - ${path4}`);
         }
       }
       if (result.filter.exclude && result.filter.exclude.length > 0) {
@@ -1870,8 +1870,8 @@ function registerOrchestrationTools(server2) {
     {
       buildContext: z9.string().describe("Free-text description of what the user wants to build")
     },
-    async ({ buildContext }) => {
-      const { text, isError } = handleSaveBuildContext({ buildContext });
+    async ({ buildContext: buildContext2 }) => {
+      const { text, isError } = handleSaveBuildContext({ buildContext: buildContext2 });
       return {
         content: [{ type: "text", text }],
         isError
@@ -1999,8 +1999,8 @@ function registerOrchestrationTools(server2) {
 
 // src/tools/pipeline.ts
 import { z as z13 } from "zod";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync4, existsSync as existsSync5, mkdirSync as mkdirSync4, lstatSync as lstatSync5 } from "fs";
-import { join as join4 } from "path";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync4, existsSync as existsSync5, mkdirSync as mkdirSync4, lstatSync as lstatSync6 } from "fs";
+import { join as join5 } from "path";
 import { createHash as createHash3 } from "crypto";
 
 // src/artifact-signing.ts
@@ -2690,6 +2690,223 @@ function registerGetSchemaTool(server2) {
   );
 }
 
+// src/tools/pipeline-graph.ts
+import { readFileSync as readFileSync4, readdirSync as readdirSync2, lstatSync as lstatSync5 } from "fs";
+import { join as join4 } from "path";
+var MANIFEST_NAME_TO_PHASE = {
+  "stackwright-pro-designer-otter": "designer",
+  "stackwright-pro-theme-otter": "theme",
+  "stackwright-pro-scaffold-otter": "scaffold",
+  "stackwright-pro-api-otter": "api",
+  "stackwright-pro-auth-otter": "auth",
+  "stackwright-pro-data-otter": "data",
+  "stackwright-pro-page-otter": "pages",
+  "stackwright-pro-dashboard-otter": "dashboard",
+  "stackwright-pro-form-wizard-otter": "workflow",
+  "stackwright-pro-geo-otter": "geo",
+  "stackwright-pro-polish-otter": "polish",
+  "stackwright-services-otter": "services"
+};
+function manifestNameToPhase(name) {
+  return MANIFEST_NAME_TO_PHASE[name] ?? null;
+}
+var OTTER_SEARCH_PATHS = [
+  "node_modules/@stackwright-pro/otters/src/",
+  // production: installed package
+  "packages/otters/src/",
+  // monorepo: run from repo root
+  "../otters/src/"
+  // monorepo: run from packages/mcp/
+];
+function resolveOtterDirFromCwd() {
+  const cwd = process.cwd();
+  for (const relative of OTTER_SEARCH_PATHS) {
+    const candidate = join4(cwd, relative);
+    try {
+      lstatSync5(candidate);
+      return candidate;
+    } catch {
+    }
+  }
+  throw new Error(
+    `Cannot locate otter directory. Searched: ${OTTER_SEARCH_PATHS.join(", ")} (relative to ${cwd}). Make sure @stackwright-pro/otters is installed.`
+  );
+}
+function loadOtterManifestsFromDir(otterDir) {
+  const entries = readdirSync2(otterDir);
+  const manifests = [];
+  for (const filename of entries) {
+    if (!filename.endsWith("-otter.json")) continue;
+    const filePath = join4(otterDir, filename);
+    if (lstatSync5(filePath).isSymbolicLink()) continue;
+    try {
+      const raw = readFileSync4(filePath, "utf-8");
+      const manifest = JSON.parse(raw);
+      manifests.push(manifest);
+    } catch (err) {
+      const msg = err instanceof Error ? err.message : String(err);
+      throw new Error(`Failed to load otter manifest "${filename}": ${msg}`, { cause: err });
+    }
+  }
+  return manifests;
+}
+function topologicalSort(dependencies) {
+  const phases = Object.keys(dependencies);
+  const inDegree = {};
+  const adjList = {};
+  for (const phase of phases) {
+    inDegree[phase] ??= 0;
+    adjList[phase] ??= [];
+  }
+  for (const phase of phases) {
+    for (const dep of dependencies[phase] ?? []) {
+      inDegree[phase] = (inDegree[phase] ?? 0) + 1;
+      adjList[dep] ??= [];
+      adjList[dep].push(phase);
+    }
+  }
+  const queue = phases.filter((p) => (inDegree[p] ?? 0) === 0);
+  const result = [];
+  while (queue.length > 0) {
+    const node = queue.shift();
+    result.push(node);
+    for (const dependent of adjList[node] ?? []) {
+      inDegree[dependent] -= 1;
+      if (inDegree[dependent] === 0) {
+        queue.push(dependent);
+      }
+    }
+  }
+  if (result.length !== phases.length) {
+    const cycleNodes = phases.filter((p) => (inDegree[p] ?? 0) > 0);
+    throw new Error(
+      `Pipeline dependency cycle detected involving: [${cycleNodes.join(", ")}]. Check otter pipeline declarations for circular dependencies.`
+    );
+  }
+  return result;
+}
+function buildPipelineGraph(manifests) {
+  const sinkProducers = {};
+  const artifactProducers = {};
+  for (const m of manifests) {
+    const phase = manifestNameToPhase(m.name);
+    if (!phase) continue;
+    const out = m.pipeline?.outputs;
+    if (!out) continue;
+    for (const sink of out.sinks ?? []) {
+      if (sinkProducers[sink]) {
+        throw new Error(
+          `Sink "${sink}" is produced by both "${sinkProducers[sink]}" and "${phase}". Each sink must have exactly one producer.`
+        );
+      }
+      sinkProducers[sink] = phase;
+    }
+    if (out.artifact) {
+      if (artifactProducers[out.artifact]) {
+        throw new Error(
+          `Artifact "${out.artifact}" is produced by both "${artifactProducers[out.artifact]}" and "${phase}". Each artifact must have exactly one producer.`
+        );
+      }
+      artifactProducers[out.artifact] = phase;
+    }
+  }
+  const dependencies = {};
+  for (const m of manifests) {
+    const phase = manifestNameToPhase(m.name);
+    if (!phase) continue;
+    const deps = /* @__PURE__ */ new Set();
+    const inp = m.pipeline?.inputs;
+    if (inp) {
+      for (const sink of inp.sinks ?? []) {
+        const producer = sinkProducers[sink];
+        if (!producer) {
+          throw new Error(
+            `Phase "${phase}" declares sink input "${sink}" but no otter produces it. Add an otter with outputs.sinks including "${sink}".`
+          );
+        }
+        if (producer !== phase) deps.add(producer);
+      }
+      for (const artifact of inp.artifacts ?? []) {
+        const producer = artifactProducers[artifact];
+        if (!producer) {
+          throw new Error(
+            `Phase "${phase}" declares artifact input "${artifact}" but no otter produces it. Add an otter with outputs.artifact = "${artifact}".`
+          );
+        }
+        if (producer !== phase) deps.add(producer);
+      }
+    }
+    dependencies[phase] = Array.from(deps);
+  }
+  const order = topologicalSort(dependencies);
+  return { dependencies, order, sinkProducers, artifactProducers };
+}
+var DISTRIBUTED_NAMESPACES = ["@stackwright-pro", "@stackwright"];
+function loadDistributedOtterManifests(cwd) {
+  const results = [];
+  for (const namespace of DISTRIBUTED_NAMESPACES) {
+    const nsDir = join4(cwd, "node_modules", namespace);
+    let pkgDirNames;
+    try {
+      pkgDirNames = readdirSync2(nsDir);
+    } catch {
+      continue;
+    }
+    for (const pkgDirName of pkgDirNames) {
+      const pkgDir = join4(nsDir, pkgDirName);
+      const packageName = `${namespace}/${pkgDirName}`;
+      let otterRelPaths;
+      try {
+        const raw = readFileSync4(join4(pkgDir, "package.json"), "utf-8");
+        const pkgJson = JSON.parse(raw);
+        const declared = pkgJson.stackwright?.otters;
+        if (!Array.isArray(declared) || declared.length === 0) continue;
+        otterRelPaths = declared;
+      } catch {
+        continue;
+      }
+      for (const relPath of otterRelPaths) {
+        const otterFilePath = join4(pkgDir, relPath);
+        try {
+          const raw = readFileSync4(otterFilePath, "utf-8");
+          const manifest = JSON.parse(raw);
+          results.push({ manifest, packageName });
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          console.warn(
+            `[pipeline-graph] Failed to load distributed otter at "${otterFilePath}" from "${packageName}": ${msg}`
+          );
+        }
+      }
+    }
+  }
+  return results;
+}
+function _mergeManifestPools(central, distributed) {
+  const centralNames = new Set(central.map((m) => m.name));
+  const merged = [...central];
+  for (const { manifest, packageName } of distributed) {
+    if (centralNames.has(manifest.name)) {
+      console.warn(
+        `[pipeline-graph] Otter "${manifest.name}" declared by both @stackwright-pro/otters and ${packageName} \u2014 using @stackwright-pro/otters version.`
+      );
+    } else {
+      merged.push(manifest);
+    }
+  }
+  return merged;
+}
+var _cachedGraph = null;
+function loadPipelineGraph() {
+  if (_cachedGraph) return _cachedGraph;
+  const otterDir = resolveOtterDirFromCwd();
+  const central = loadOtterManifestsFromDir(otterDir);
+  const distributed = loadDistributedOtterManifests(process.cwd());
+  const manifests = _mergeManifestPools(central, distributed);
+  _cachedGraph = buildPipelineGraph(manifests);
+  return _cachedGraph;
+}
+
 // src/tools/pipeline.ts
 var PHASE_ORDER = [
   "designer",
@@ -2698,45 +2915,15 @@ var PHASE_ORDER = [
   // generates app/ directory from config
   "api",
   "data",
+  "auth",
+  // moved earlier — only depends on design-language.json (designer)
   "geo",
   "workflow",
   "services",
   "pages",
   "dashboard",
-  "auth",
   "polish"
 ];
-var PHASE_DEPENDENCIES = {
-  designer: [],
-  theme: ["designer"],
-  scaffold: ["designer", "theme"],
-  // needs stackwright.yml + theme-tokens
-  api: [],
-  data: ["api"],
-  geo: ["data"],
-  // workflow: no hard deps — uses service: references with Prism mock fallback
-  // when API artifacts aren't available; roles come from user answers
-  workflow: [],
-  // services: needs API endpoints to know what to wire, and optionally
-  // workflow states as trigger sources. Produces OpenAPI specs consumed
-  // by pages and dashboard for typed data wiring.
-  services: ["api", "workflow"],
-  // pages/dashboard: depend on services for typed endpoint wiring (OpenAPI
-  // specs) and on geo so the specialist prompt includes geo-manifest.json
-  // — page/dashboard otters see which page slugs are already claimed and
-  // won't attempt to overwrite them (swp-73c). 'api' is still transitive
-  // through 'data'; auth removed — page-otter has graceful fallback.
-  pages: ["designer", "theme", "data", "services", "geo", "scaffold"],
-  dashboard: ["designer", "theme", "data", "services", "geo", "scaffold"],
-  // auth is the penultimate phase — runs after all content-producing phases
-  // so it can read pages, dashboard, workflow, and geo artifacts for route
-  // protection and RBAC wiring. Skipped upstream phases still satisfy deps
-  // (the foreman marks them executed=true), so auth always runs.
-  auth: ["pages", "dashboard", "workflow", "geo"],
-  // polish is the terminal phase — runs after auth so the landing page and
-  // nav reflect the final set of protected routes and all generated pages.
-  polish: ["auth"]
-};
 var PHASE_ARTIFACT = {
   designer: "design-language.json",
   theme: "theme-tokens.json",
@@ -2793,7 +2980,7 @@ function createDefaultState() {
   };
 }
 function statePath(cwd) {
-  return join4(cwd, ".stackwright", "pipeline-state.json");
+  return join5(cwd, ".stackwright", "pipeline-state.json");
 }
 function readState(cwd) {
   const p = statePath(cwd);
@@ -2806,7 +2993,7 @@ function readState(cwd) {
 }
 function safeWriteSync(filePath, content) {
   if (existsSync5(filePath)) {
-    const stat = lstatSync5(filePath);
+    const stat = lstatSync6(filePath);
     if (stat.isSymbolicLink()) {
       throw new Error(`Refusing to write to symlink: ${filePath}`);
     }
@@ -2815,15 +3002,15 @@ function safeWriteSync(filePath, content) {
 }
 function safeReadSync(filePath) {
   if (existsSync5(filePath)) {
-    const stat = lstatSync5(filePath);
+    const stat = lstatSync6(filePath);
     if (stat.isSymbolicLink()) {
       throw new Error(`Refusing to read symlink: ${filePath}`);
     }
   }
-  return readFileSync4(filePath, "utf-8");
+  return readFileSync5(filePath, "utf-8");
 }
 function writeState(cwd, state) {
-  const dir = join4(cwd, ".stackwright");
+  const dir = join5(cwd, ".stackwright");
   mkdirSync4(dir, { recursive: true });
   state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   safeWriteSync(statePath(cwd), JSON.stringify(state, null, 2) + "\n");
@@ -2845,7 +3032,7 @@ function handleGetPipelineState(_cwd) {
   const cwd = _cwd ?? process.cwd();
   try {
     const state = readState(cwd);
-    const keyPath = join4(cwd, ".stackwright", "pipeline-keys.json");
+    const keyPath = join5(cwd, ".stackwright", "pipeline-keys.json");
     if (!existsSync5(keyPath)) {
       try {
         const { fingerprint } = initPipelineKeys(cwd);
@@ -2949,7 +3136,7 @@ function handleCheckExecutionReady(_cwd, phase) {
         isError: true
       };
     }
-    const answerFile = join4(cwd, ".stackwright", "answers", `${phase}.json`);
+    const answerFile = join5(cwd, ".stackwright", "answers", `${phase}.json`);
     if (!existsSync5(answerFile)) {
       return {
         text: JSON.stringify({ ready: false, phase, reason: "Answer file not found" }),
@@ -2974,11 +3161,11 @@ function handleCheckExecutionReady(_cwd, phase) {
     }
   }
   try {
-    const answersDir = join4(cwd, ".stackwright", "answers");
+    const answersDir = join5(cwd, ".stackwright", "answers");
     const answeredPhases = [];
     const missingPhases = [];
     for (const phase2 of PHASE_ORDER) {
-      const answerFile = join4(answersDir, `${phase2}.json`);
+      const answerFile = join5(answersDir, `${phase2}.json`);
       if (existsSync5(answerFile)) {
         try {
           const raw = safeReadSync(answerFile);
@@ -3012,6 +3199,7 @@ function handleGetReadyPhases(_cwd) {
   const cwd = _cwd ?? process.cwd();
   try {
     const state = readState(cwd);
+    const graph = loadPipelineGraph();
     const completed = [];
     const ready = [];
     const blocked = [];
@@ -3021,7 +3209,7 @@ function handleGetReadyPhases(_cwd) {
         completed.push(phase);
         continue;
       }
-      const deps = PHASE_DEPENDENCIES[phase];
+      const deps = graph.dependencies[phase] ?? [];
       const unmetDeps = deps.filter((dep) => !state.phases[dep]?.executed);
       if (unmetDeps.length === 0) {
         ready.push(phase);
@@ -3047,7 +3235,7 @@ function handleGetReadyPhases(_cwd) {
 function handleListArtifacts(_cwd) {
   const cwd = _cwd ?? process.cwd();
   try {
-    const artifactsDir = join4(cwd, ".stackwright", "artifacts");
+    const artifactsDir = join5(cwd, ".stackwright", "artifacts");
     let manifest = null;
     try {
       manifest = loadSignatureManifest(cwd);
@@ -3057,7 +3245,7 @@ function handleListArtifacts(_cwd) {
     let completedCount = 0;
     for (const phase of PHASE_ORDER) {
       const expectedFile = PHASE_ARTIFACT[phase];
-      const fullPath = join4(artifactsDir, expectedFile);
+      const fullPath = join5(artifactsDir, expectedFile);
       const exists = existsSync5(fullPath);
       if (exists) completedCount++;
       let signed = false;
@@ -3111,9 +3299,9 @@ function handleWritePhaseQuestions(input) {
       }
     } catch {
     }
-    const questionsDir = join4(cwd, ".stackwright", "questions");
+    const questionsDir = join5(cwd, ".stackwright", "questions");
     mkdirSync4(questionsDir, { recursive: true });
-    const filePath = join4(questionsDir, `${phase}.json`);
+    const filePath = join5(questionsDir, `${phase}.json`);
     const payload = {
       version: "1.0",
       phase,
@@ -3153,13 +3341,13 @@ function handleBuildSpecialistPrompt(input) {
     };
   }
   try {
-    const answersPath = join4(cwd, ".stackwright", "answers", `${phase}.json`);
+    const answersPath = join5(cwd, ".stackwright", "answers", `${phase}.json`);
     let answers = {};
     if (existsSync5(answersPath)) {
       answers = JSON.parse(safeReadSync(answersPath));
     }
     let buildContextText = "";
-    const buildContextPath = join4(cwd, ".stackwright", "build-context.json");
+    const buildContextPath = join5(cwd, ".stackwright", "build-context.json");
     if (existsSync5(buildContextPath)) {
       try {
         const bcRaw = JSON.parse(safeReadSync(buildContextPath));
@@ -3169,12 +3357,13 @@ function handleBuildSpecialistPrompt(input) {
       } catch {
       }
     }
-    const deps = PHASE_DEPENDENCIES[phase];
+    const graph = loadPipelineGraph();
+    const deps = graph.dependencies[phase] ?? [];
     const artifactSections = [];
     const missingDependencies = [];
     for (const dep of deps) {
       const artifactFile = PHASE_ARTIFACT[dep];
-      const artifactPath = join4(cwd, ".stackwright", "artifacts", artifactFile);
+      const artifactPath = join5(cwd, ".stackwright", "artifacts", artifactFile);
       if (existsSync5(artifactPath)) {
         const rawContent = safeReadSync(artifactPath);
         const rawBytes = Buffer.from(rawContent, "utf-8");
@@ -3240,7 +3429,7 @@ ${JSON.stringify(content, null, 2)}`
       parts.push("BUILD_CONTEXT:", buildContextText, "");
     }
     if (phase === "auth") {
-      const initContextPath = join4(cwd, ".stackwright", "init-context.json");
+      const initContextPath = join5(cwd, ".stackwright", "init-context.json");
       if (existsSync5(initContextPath)) {
         try {
           const initContext = JSON.parse(safeReadSync(initContextPath));
@@ -3708,13 +3897,13 @@ function handleValidateArtifact(input) {
     // to a flow or state-machine in this services-config artifact.
     // Skips gracefully when wizard-otter didn't run (Pro-only install) or declared no hooks.
     services: (artifact2) => {
-      const workflowArtifactPath = join4(cwd, ".stackwright", "artifacts", "workflow-config.json");
+      const workflowArtifactPath = join5(cwd, ".stackwright", "artifacts", "workflow-config.json");
       if (!existsSync5(workflowArtifactPath)) {
         return { success: true };
       }
       let workflowArtifact;
       try {
-        workflowArtifact = JSON.parse(readFileSync4(workflowArtifactPath, "utf-8"));
+        workflowArtifact = JSON.parse(readFileSync5(workflowArtifactPath, "utf-8"));
       } catch {
         return { success: true };
       }
@@ -3751,10 +3940,10 @@ function handleValidateArtifact(input) {
     }
   }
   try {
-    const artifactsDir = join4(cwd, ".stackwright", "artifacts");
+    const artifactsDir = join5(cwd, ".stackwright", "artifacts");
     mkdirSync4(artifactsDir, { recursive: true });
     const artifactFile = PHASE_ARTIFACT[phase];
-    const artifactPath = join4(artifactsDir, artifactFile);
+    const artifactPath = join5(artifactsDir, artifactFile);
     const serialized = JSON.stringify(artifact, null, 2) + "\n";
     const artifactBytes = Buffer.from(serialized, "utf-8");
     safeWriteSync(artifactPath, serialized);
@@ -3871,9 +4060,9 @@ function registerPipelineTools(server2) {
             isError: true
           };
         }
-        const questionsDir = join4(process.cwd(), ".stackwright", "questions");
+        const questionsDir = join5(process.cwd(), ".stackwright", "questions");
         mkdirSync4(questionsDir, { recursive: true });
-        const outPath = join4(questionsDir, `${phase}.json`);
+        const outPath = join5(questionsDir, `${phase}.json`);
         writeFileSync4(
           outPath,
           JSON.stringify({ phase, questions, writtenAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)
@@ -3925,8 +4114,8 @@ function registerPipelineTools(server2) {
 
 // src/tools/safe-write.ts
 import { z as z14 } from "zod";
-import { writeFileSync as writeFileSync5, readFileSync as readFileSync5, existsSync as existsSync6, mkdirSync as mkdirSync5, lstatSync as lstatSync6 } from "fs";
-import { normalize, isAbsolute, dirname, join as join5 } from "path";
+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";
 var OTTER_WRITE_ALLOWLISTS = {
   "stackwright-pro-designer-otter": [
     { prefix: ".stackwright/artifacts/", suffix: ".json", description: "Design language artifact" }
@@ -3941,8 +4130,11 @@ var OTTER_WRITE_ALLOWLISTS = {
   ],
   "stackwright-pro-auth-otter": [
     { prefix: ".stackwright/artifacts/", suffix: ".json", description: "Auth config artifact" },
-    { prefix: "config/", suffix: ".yml", description: "Auth YAML config" },
-    { prefix: "config/", suffix: ".yaml", description: "Auth YAML config" },
+    {
+      prefix: "stackwright.auth.",
+      suffix: ".yml",
+      description: "Auth config YAML (stackwright.auth.yml \u2014 compiled to _auth.json)"
+    },
     {
       prefix: ".env",
       suffix: "",
@@ -3961,7 +4153,11 @@ var OTTER_WRITE_ALLOWLISTS = {
   ],
   "stackwright-pro-data-otter": [
     { prefix: ".stackwright/artifacts/", suffix: ".json", description: "Data config artifact" },
-    { prefix: "stackwright.yml", suffix: "", description: "Stackwright config" }
+    {
+      prefix: "stackwright.collections.",
+      suffix: ".yml",
+      description: "Collections config YAML (stackwright.collections.yml \u2014 compiled to _collections.json)"
+    }
   ],
   "stackwright-pro-page-otter": [
     { prefix: "pages/", suffix: "/content.yml", description: "Page content YAML" },
@@ -3987,7 +4183,12 @@ var OTTER_WRITE_ALLOWLISTS = {
     }
   ],
   "stackwright-pro-api-otter": [
-    { prefix: ".stackwright/artifacts/", suffix: ".json", description: "API config artifact" }
+    { prefix: ".stackwright/artifacts/", suffix: ".json", description: "API config artifact" },
+    {
+      prefix: "stackwright.integrations.",
+      suffix: ".yml",
+      description: "Integrations config YAML (stackwright.integrations.yml \u2014 compiled to _integrations.json)"
+    }
   ],
   "stackwright-pro-geo-otter": [
     { prefix: ".stackwright/artifacts/", suffix: ".json", description: "Geo manifest artifact" },
@@ -4066,22 +4267,22 @@ function extractContentTypes(yamlContent) {
   return types.length > 0 ? types : ["unknown"];
 }
 function readPageRegistry(cwd) {
-  const regPath = join5(cwd, PAGE_REGISTRY_FILE);
+  const regPath = join6(cwd, PAGE_REGISTRY_FILE);
   if (!existsSync6(regPath)) return {};
   try {
-    const stat = lstatSync6(regPath);
+    const stat = lstatSync7(regPath);
     if (stat.isSymbolicLink()) return {};
-    return JSON.parse(readFileSync5(regPath, "utf-8"));
+    return JSON.parse(readFileSync6(regPath, "utf-8"));
   } catch {
     return {};
   }
 }
 function writePageRegistry(cwd, registry) {
-  const dir = join5(cwd, ".stackwright");
+  const dir = join6(cwd, ".stackwright");
   mkdirSync5(dir, { recursive: true });
-  const regPath = join5(cwd, PAGE_REGISTRY_FILE);
+  const regPath = join6(cwd, PAGE_REGISTRY_FILE);
   if (existsSync6(regPath)) {
-    const stat = lstatSync6(regPath);
+    const stat = lstatSync7(regPath);
     if (stat.isSymbolicLink()) {
       throw new Error("Refusing to write page registry through symlink");
     }
@@ -4101,8 +4302,8 @@ function checkPageOwnership(cwd, slug, callerOtter) {
   };
 }
 var NEXTJS_BRACKET_SEGMENT_RE = /\[\[\.{3}[a-zA-Z_][a-zA-Z0-9_]*\]\]|\[\.{3}[a-zA-Z_][a-zA-Z0-9_]*\]|\[[a-zA-Z_][a-zA-Z0-9_]*\]/g;
-function stripNextjsBracketSegments(path3) {
-  return path3.replace(NEXTJS_BRACKET_SEGMENT_RE, "");
+function stripNextjsBracketSegments(path4) {
+  return path4.replace(NEXTJS_BRACKET_SEGMENT_RE, "");
 }
 function checkPathAllowed(callerOtter, filePath) {
   const normalized = normalize(filePath);
@@ -4252,10 +4453,10 @@ function handleSafeWrite(input) {
     return { text: JSON.stringify(result), isError: true };
   }
   const normalized = normalize(filePath);
-  const fullPath = join5(cwd, normalized);
+  const fullPath = join6(cwd, normalized);
   if (existsSync6(fullPath)) {
     try {
-      const stat = lstatSync6(fullPath);
+      const stat = lstatSync7(fullPath);
       if (stat.isSymbolicLink()) {
         const result = {
           success: false,
@@ -4358,8 +4559,8 @@ function registerSafeWriteTools(server2) {
 
 // src/tools/auth.ts
 import { z as z15 } from "zod";
-import { readFileSync as readFileSync6, writeFileSync as writeFileSync6, existsSync as existsSync7, mkdirSync as mkdirSync6 } from "fs";
-import { join as join6 } from "path";
+import { readFileSync as readFileSync7, writeFileSync as writeFileSync6, existsSync as existsSync7, mkdirSync as mkdirSync6 } from "fs";
+import { join as join7 } from "path";
 function buildHierarchy(roles) {
   const h = {};
   for (let i = 0; i < roles.length - 1; i++) {
@@ -4373,7 +4574,7 @@ function hierarchyToYaml(hierarchy, indent) {
   return entries.map(([role, subs]) => `${indent}${role}: [${subs.join(", ")}]`).join("\n");
 }
 function rolesToYaml(roles, indent) {
-  return roles.map((r) => `${indent}- ${r}`).join("\n");
+  return roles.map((r) => `${indent}- name: ${r}`).join("\n");
 }
 function normalizeRoutes(routes, defaultRole) {
   return routes.map(
@@ -4386,9 +4587,9 @@ ${indent}  requiredRole: ${r.requiredRole}`).join("\n");
 }
 function detectNextMajorVersion(cwd) {
   try {
-    const pkgPath = join6(cwd, "package.json");
+    const pkgPath = join7(cwd, "package.json");
     if (!existsSync7(pkgPath)) return null;
-    const pkg = JSON.parse(readFileSync6(pkgPath, "utf8"));
+    const pkg = JSON.parse(readFileSync7(pkgPath, "utf8"));
     const nextVersion = pkg.dependencies?.next ?? pkg.devDependencies?.next;
     if (!nextVersion) return null;
     const match = nextVersion.match(/(\d+)/);
@@ -4397,25 +4598,6 @@ function detectNextMajorVersion(cwd) {
     return null;
   }
 }
-function upsertAuthBlock(existing, authYaml) {
-  const lines = existing.split("\n");
-  let authStart = -1;
-  let authEnd = lines.length;
-  for (let i = 0; i < lines.length; i++) {
-    if (/^auth:/.test(lines[i])) {
-      authStart = i;
-    } else if (authStart >= 0 && i > authStart && /^\S/.test(lines[i]) && lines[i].trim() !== "") {
-      authEnd = i;
-      break;
-    }
-  }
-  if (authStart < 0) {
-    return existing.trimEnd() + "\n" + authYaml + "\n";
-  }
-  const before = lines.slice(0, authStart);
-  const after = lines.slice(authEnd);
-  return [...before, ...authYaml.trimEnd().split("\n"), ...after.length ? after : []].join("\n");
-}
 function generateMiddlewareContent(method, params, roles, defaultRole, hierarchy, auditEnabled, auditRetentionDays, protectedRoutes) {
   const rbacBlock = `  rbac: {
     roles: ${JSON.stringify(roles)},
@@ -4615,33 +4797,33 @@ OAUTH2_CLIENT_SECRET=your-client-secret
 `;
 }
 function generateYamlBlock(method, params, roles, defaultRole, hierarchy, auditEnabled, auditRetentionDays, protectedRoutes, useProxy) {
-  const rbacSection = `  rbac:
-    roles:
-${rolesToYaml(roles, "      ")}
-    defaultRole: ${defaultRole}
-    hierarchy:
-${hierarchyToYaml(hierarchy, "      ")}`;
-  const auditSection = `  audit:
-    enabled: ${auditEnabled}
-    retentionDays: ${auditRetentionDays}`;
-  const routeLines = routesToYaml(protectedRoutes, "    ");
-  const providerLine = params.provider ? `  provider: ${params.provider}
+  const rbacSection = `rbac:
+  roles:
+${rolesToYaml(roles, "    ")}
+  defaultRole: ${defaultRole}
+  hierarchy:
+${hierarchyToYaml(hierarchy, "    ")}`;
+  const auditSection = `audit:
+  enabled: ${auditEnabled}
+  retentionDays: ${auditRetentionDays}`;
+  const routeLines = routesToYaml(protectedRoutes, "  ");
+  const providerLine = params.provider ? `provider: ${params.provider}
 ` : "";
   if (method === "cac") {
     const caBundle = params.cacCaBundle ?? "./certs/dod-ca-bundle.pem";
     const edipiLookup = params.cacEdipiLookup ?? "./config/edipi-lookup.json";
     const ocspEndpoint = params.cacOcspEndpoint ?? "https://ocsp.disa.mil";
     const certHeader = params.cacCertHeader ?? "X-SSL-Client-Cert";
-    return `auth:
-  method: cac
-${providerLine}  ${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
-  cac:
-    caBundle: \${CAC_CA_BUNDLE}
-    edipiLookup: ${edipiLookup}
-    ocspEndpoint: \${CAC_OCSP_ENDPOINT}
-    certHeader: ${certHeader}
+    return `# stackwright.auth.yml \u2014 generated by Auth Otter
+method: cac
+${providerLine}${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
+cac:
+  caBundle: \${CAC_CA_BUNDLE}
+  edipiLookup: ${edipiLookup}
+  ocspEndpoint: \${CAC_OCSP_ENDPOINT}
+  certHeader: ${certHeader}
 ${rbacSection}
-  protectedRoutes:
+protectedRoutes:
 ${routeLines}
 ${auditSection}
 `;
@@ -4649,33 +4831,33 @@ ${auditSection}
   if (method === "oidc") {
     const scopes2 = params.oidcScopes ?? "openid profile email";
     const roleClaim = params.oidcRoleClaim ?? "roles";
-    return `auth:
-  method: oidc
-${providerLine}  ${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
-  oidc:
-    discoveryUrl: \${OIDC_DISCOVERY_URL}
-    clientId: \${OIDC_CLIENT_ID}
-    clientSecret: \${OIDC_CLIENT_SECRET}
-    scopes: ${scopes2}
-    roleClaim: ${roleClaim}
+    return `# stackwright.auth.yml \u2014 generated by Auth Otter
+method: oidc
+${providerLine}${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
+oidc:
+  discoveryUrl: \${OIDC_DISCOVERY_URL}
+  clientId: \${OIDC_CLIENT_ID}
+  clientSecret: \${OIDC_CLIENT_SECRET}
+  scopes: ${scopes2}
+  roleClaim: ${roleClaim}
 ${rbacSection}
-  protectedRoutes:
+protectedRoutes:
 ${routeLines}
 ${auditSection}
 `;
   }
   const scopes = params.oauth2Scopes ?? "read write";
-  return `auth:
-  method: oauth2
-${providerLine}  ${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
-  oauth2:
-    authorizationUrl: \${OAUTH2_AUTH_URL}
-    tokenUrl: \${OAUTH2_TOKEN_URL}
-    clientId: \${OAUTH2_CLIENT_ID}
-    clientSecret: \${OAUTH2_CLIENT_SECRET}
-    scopes: ${scopes}
+  return `# stackwright.auth.yml \u2014 generated by Auth Otter
+method: oauth2
+${providerLine}${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
+oauth2:
+  authorizationUrl: \${OAUTH2_AUTH_URL}
+  tokenUrl: \${OAUTH2_TOKEN_URL}
+  clientId: \${OAUTH2_CLIENT_ID}
+  clientSecret: \${OAUTH2_CLIENT_SECRET}
+  scopes: ${scopes}
 ${rbacSection}
-  protectedRoutes:
+protectedRoutes:
 ${routeLines}
 ${auditSection}
 `;
@@ -4861,35 +5043,35 @@ ${configBlock}
 `;
 }
 function generateDevOnlyYamlBlock(method, params, roles, defaultRole, hierarchy, auditEnabled, auditRetentionDays, protectedRoutes, useProxy) {
-  const rbacSection = `  rbac:
-    roles:
-${rolesToYaml(roles, "      ")}
-    defaultRole: ${defaultRole}
-    hierarchy:
-${hierarchyToYaml(hierarchy, "      ")}`;
-  const auditSection = `  audit:
-    enabled: ${auditEnabled}
-    retentionDays: ${auditRetentionDays}`;
-  const routeLines = protectedRoutes.map((r) => `    - pattern: ${r.pattern}
-      requiredRole: ${r.requiredRole}`).join("\n");
-  const providerLine = params.provider ? `  provider: ${params.provider}
+  const rbacSection = `rbac:
+  roles:
+${rolesToYaml(roles, "    ")}
+  defaultRole: ${defaultRole}
+  hierarchy:
+${hierarchyToYaml(hierarchy, "    ")}`;
+  const auditSection = `audit:
+  enabled: ${auditEnabled}
+  retentionDays: ${auditRetentionDays}`;
+  const routeLines = protectedRoutes.map((r) => `  - pattern: ${r.pattern}
+    requiredRole: ${r.requiredRole}`).join("\n");
+  const providerLine = params.provider ? `provider: ${params.provider}
 ` : "";
   if (method === "cac") {
     const caBundle = params.cacCaBundle ?? "./certs/dod-ca-bundle.pem";
     const edipiLookup = params.cacEdipiLookup ?? "./config/edipi-lookup.json";
     const ocspEndpoint = params.cacOcspEndpoint ?? "https://ocsp.disa.mil";
     const certHeader = params.cacCertHeader ?? "X-SSL-Client-Cert";
-    return `auth:
-  method: cac
-  devOnly: true
-${providerLine}  ${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
-  cac:
-    caBundle: ${caBundle}
-    edipiLookup: ${edipiLookup}
-    ocspEndpoint: ${ocspEndpoint}
-    certHeader: ${certHeader}
+    return `# stackwright.auth.yml \u2014 generated by Auth Otter
+method: cac
+devOnly: true
+${providerLine}${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
+cac:
+  caBundle: ${caBundle}
+  edipiLookup: ${edipiLookup}
+  ocspEndpoint: ${ocspEndpoint}
+  certHeader: ${certHeader}
 ${rbacSection}
-  protectedRoutes:
+protectedRoutes:
 ${routeLines}
 ${auditSection}
 `;
@@ -4897,35 +5079,35 @@ ${auditSection}
   if (method === "oidc") {
     const scopes2 = params.oidcScopes ?? "openid profile email";
     const roleClaim = params.oidcRoleClaim ?? "roles";
-    return `auth:
-  method: oidc
-  devOnly: true
-${providerLine}  ${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
-  oidc:
-    discoveryUrl: https://dev-mock-oidc/.well-known/openid-configuration
-    clientId: dev-mock-client
-    clientSecret: dev-mock-secret
-    scopes: ${scopes2}
-    roleClaim: ${roleClaim}
+    return `# stackwright.auth.yml \u2014 generated by Auth Otter
+method: oidc
+devOnly: true
+${providerLine}${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
+oidc:
+  discoveryUrl: https://dev-mock-oidc/.well-known/openid-configuration
+  clientId: dev-mock-client
+  clientSecret: dev-mock-secret
+  scopes: ${scopes2}
+  roleClaim: ${roleClaim}
 ${rbacSection}
-  protectedRoutes:
+protectedRoutes:
 ${routeLines}
 ${auditSection}
 `;
   }
   const scopes = params.oauth2Scopes ?? "read write";
-  return `auth:
-  method: oauth2
-  devOnly: true
-${providerLine}  ${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
-  oauth2:
-    authorizationUrl: https://dev-mock-oauth2/authorize
-    tokenUrl: https://dev-mock-oauth2/token
-    clientId: dev-mock-client
-    clientSecret: dev-mock-secret
-    scopes: ${scopes}
+  return `# stackwright.auth.yml \u2014 generated by Auth Otter
+method: oauth2
+devOnly: true
+${providerLine}${useProxy ? "proxy" : "middleware"}: ./${useProxy ? "proxy" : "middleware"}.ts
+oauth2:
+  authorizationUrl: https://dev-mock-oauth2/authorize
+  tokenUrl: https://dev-mock-oauth2/token
+  clientId: dev-mock-client
+  clientSecret: dev-mock-secret
+  scopes: ${scopes}
 ${rbacSection}
-  protectedRoutes:
+protectedRoutes:
 ${routeLines}
 ${auditSection}
 `;
@@ -5070,7 +5252,7 @@ async function configureAuthHandler(params, cwd) {
       auditRetentionDays,
       normalizedRoutes
     );
-    writeFileSync6(join6(cwd, conventionFile), authFileContent, "utf8");
+    writeFileSync6(join7(cwd, conventionFile), authFileContent, "utf8");
     filesWritten.push(conventionFile);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -5090,9 +5272,9 @@ async function configureAuthHandler(params, cwd) {
   if (!devOnly) {
     try {
       const envBlock = generateEnvBlock(effectiveMethod, params);
-      const envPath = join6(cwd, ".env.example");
+      const envPath = join7(cwd, ".env.example");
       if (existsSync7(envPath)) {
-        const existing = readFileSync6(envPath, "utf8");
+        const existing = readFileSync7(envPath, "utf8");
         writeFileSync6(envPath, existing.trimEnd() + "\n\n" + envBlock, "utf8");
       } else {
         writeFileSync6(envPath, envBlock, "utf8");
@@ -5113,10 +5295,10 @@ async function configureAuthHandler(params, cwd) {
   }
   if (devOnly) {
     try {
-      const mockAuthDir = join6(cwd, "lib");
+      const mockAuthDir = join7(cwd, "lib");
       mkdirSync6(mockAuthDir, { recursive: true });
       const mockAuthContent = generateMockAuthContent(roles, mockUsers);
-      writeFileSync6(join6(mockAuthDir, "mock-auth.ts"), mockAuthContent, "utf8");
+      writeFileSync6(join7(mockAuthDir, "mock-auth.ts"), mockAuthContent, "utf8");
       filesWritten.push("lib/mock-auth.ts");
     } catch (err) {
       const msg = err instanceof Error ? err.message : String(err);
@@ -5134,9 +5316,9 @@ async function configureAuthHandler(params, cwd) {
       };
     }
     try {
-      const pkgPath = join6(cwd, "package.json");
+      const pkgPath = join7(cwd, "package.json");
       if (existsSync7(pkgPath)) {
-        const existingPkg = readFileSync6(pkgPath, "utf8");
+        const existingPkg = readFileSync7(pkgPath, "utf8");
         const updatedPkg = updatePackageJsonScripts(existingPkg, roles, mockUsers);
         writeFileSync6(pkgPath, updatedPkg, "utf8");
         filesWritten.push("package.json");
@@ -5179,21 +5361,18 @@ async function configureAuthHandler(params, cwd) {
       normalizedRoutes,
       useProxy
     );
-    const ymlPath = join6(cwd, "stackwright.yml");
-    if (!existsSync7(ymlPath)) {
-      writeFileSync6(ymlPath, authYaml, "utf8");
-    } else {
-      const existing = readFileSync6(ymlPath, "utf8");
-      writeFileSync6(ymlPath, upsertAuthBlock(existing, authYaml), "utf8");
-    }
-    filesWritten.push("stackwright.yml");
+    writeFileSync6(join7(cwd, "stackwright.auth.yml"), authYaml, "utf8");
+    filesWritten.push("stackwright.auth.yml");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return {
       content: [
         {
           type: "text",
-          text: JSON.stringify({ success: false, error: `Failed writing stackwright.yml: ${msg}` })
+          text: JSON.stringify({
+            success: false,
+            error: `Failed writing stackwright.auth.yml: ${msg}`
+          })
         }
       ],
       isError: true
@@ -5238,7 +5417,7 @@ async function configureAuthHandler(params, cwd) {
 function registerAuthTools(server2) {
   server2.tool(
     "stackwright_pro_configure_auth",
-    "Generate authentication middleware and configuration for a Next.js Stackwright application. Writes `middleware.ts` from a secure template, appends/updates the `auth:` section in `stackwright.yml`, and generates `.env.example` with required environment variables. \u26A0\uFE0F For CAC/PKI: generated `middleware.ts` carries a SECURITY REVIEW REQUIRED comment \u2014 certificate chain validation must be verified by a DoD security officer before production deployment. This is the ONLY approved path to generating `middleware.ts`. Never write TypeScript auth files directly.",
+    "Generate authentication middleware and configuration for a Next.js Stackwright application. Writes `middleware.ts` (or `proxy.ts` for Next.js >=16) from a secure template, writes a standalone `stackwright.auth.yml` sibling file, and generates `.env.example` with required environment variables. \u26A0\uFE0F For CAC/PKI: generated `middleware.ts` carries a SECURITY REVIEW REQUIRED comment \u2014 certificate chain validation must be verified by a DoD security officer before production deployment. This is the ONLY approved path to generating `middleware.ts`. Never write TypeScript auth files directly.",
     {
       method: z15.enum(["cac", "oidc", "oauth2", "none"]),
       provider: z15.enum(["azure-ad", "okta", "ping", "cognito", "custom"]).optional(),
@@ -5289,28 +5468,28 @@ function registerAuthTools(server2) {
 
 // src/integrity.ts
 import { createHash as createHash4, timingSafeEqual as timingSafeEqual2 } from "crypto";
-import { readFileSync as readFileSync7, readdirSync as readdirSync2, lstatSync as lstatSync7 } from "fs";
-import { join as join7, basename } from "path";
+import { readFileSync as readFileSync8, readdirSync as readdirSync3, lstatSync as lstatSync8 } from "fs";
+import { join as join8, basename } from "path";
 var _checksums = /* @__PURE__ */ new Map([
   [
     "stackwright-pro-api-otter.json",
-    "df79f4389a576c2885efa07b04f613c60eb8ebf4a8b1d4c7da5e4bb6ee4248dd"
+    "822b35d7a330ed8ac0b42a63b0f70a41885aa9b5ea23cc5b8b998b549da4c05c"
   ],
   [
     "stackwright-pro-auth-otter.json",
-    "643344b88e42992e0467845fb0184d3932e115b85130fbc6a47a3175759678c8"
+    "d6cd5732667018d99456be77d5955e454da7a0999a0330b5f03a483aa1b9b33f"
   ],
   [
     "stackwright-pro-dashboard-otter.json",
-    "160af221e04200f53709f8c3e249ca6dafb38a325b232fabd478b28f5492ab01"
+    "e3b82555fcffbd77285bd304828814e9f9f7257130797c9de3785de97527668c"
   ],
   [
     "stackwright-pro-data-otter.json",
-    "709c8e49328908549fe87de181a5991e09c918ef24bbfe6948f9888f0c758c25"
+    "bb66eaab31c6872536dca4d3ff145724a46356946dd0665cc4f0346714d3bacb"
   ],
   [
     "stackwright-pro-designer-otter.json",
-    "1364b2c235c07b0b798e9aab90a68604f60019a5508d41ba576977f173e20cd9"
+    "b54121c6a2ab5b1ad68c1262c58b2e04e6315feacd6bb8de8e78eb36f2fa6be6"
   ],
   [
     "stackwright-pro-domain-expert-otter.json",
@@ -5318,35 +5497,35 @@ var _checksums = /* @__PURE__ */ new Map([
   ],
   [
     "stackwright-pro-foreman-otter.json",
-    "438b03d2c35f64536055c68b3a9044fe3b5e4f2889acde4500dd801fad724be1"
+    "abb1cc5e40a8c5ff98057273f43a9e90e2791a15951090cd4d98407c0c3618e3"
   ],
   [
     "stackwright-pro-form-wizard-otter.json",
-    "3dffa3ef2d2ef057578391f784cbea779d768e87d98321894ea5bcd9e3ab7e60"
+    "975ad68e8fb6fe5a10373be278946fa4d9d7ec2238a0b2bd9e4a412e5b1fdd6d"
   ],
   [
     "stackwright-pro-geo-otter.json",
-    "2ec83c26a08c413d9553ff8b8f0f0f643c1a8da043741b356e27106cad78f05f"
+    "ac440da786d8c5ab1feddbf861449c3be3a433a04370578e1b2d35bf6ae7a601"
   ],
   [
     "stackwright-pro-page-otter.json",
-    "0057ea97f7c2e33a8673140f59a0237eb627d82c676af3fae4faa31033598e03"
+    "b70bd6e5d2a40230f7c24ff4a6113585a1614e5b6a215ece2bd47ff053c30f58"
   ],
   [
     "stackwright-pro-polish-otter.json",
-    "bd87327b9a9a62fabaee8837492ce943feae8bfc15e5d43b45ba0e84619daec3"
+    "48ef3cf7f29ac6b5e8ab2004d4d41e2fb899e781689178d3905993241c84095a"
   ],
   [
     "stackwright-pro-scaffold-otter.json",
-    "91de5861f1406043d1d387388302fb1492211b81e2eea9777dec60e48f317f2a"
+    "e8662b63bbc9ce38851d94f9656bbebefdb7843d038862adb9fde2c23f9e77c2"
   ],
   [
     "stackwright-pro-theme-otter.json",
-    "fe10108e3ba67106751ea662f512bb5f4eb58f7abda26880ef4cf6b0f9feb944"
+    "fb62e56642f7f94c50ce173f3e1ce978b3f20ab1567e87403b901d6dd991a7db"
   ],
   [
     "stackwright-services-otter.json",
-    "c013d7fc2475e62d0af54d57bc988182feee7766bac0edf841cbfad5c73e9261"
+    "0a5dac670482871c718099767b30bf23d8ec57e942bd40a00ce295926d82c6bd"
   ]
 ]);
 Object.freeze(_checksums);
@@ -5375,7 +5554,7 @@ function verifyOtterFile(filePath) {
   }
   let stat;
   try {
-    stat = lstatSync7(filePath);
+    stat = lstatSync8(filePath);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return { verified: false, filename, error: `Cannot stat file: ${msg}` };
@@ -5393,7 +5572,7 @@ function verifyOtterFile(filePath) {
   }
   let raw;
   try {
-    raw = readFileSync7(filePath);
+    raw = readFileSync8(filePath);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return { verified: false, filename, error: `Cannot read file: ${msg}` };
@@ -5443,7 +5622,7 @@ function verifyAllOtters(otterDir) {
   const unknown = [];
   let entries;
   try {
-    entries = readdirSync2(otterDir);
+    entries = readdirSync3(otterDir);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return {
@@ -5454,9 +5633,9 @@ function verifyAllOtters(otterDir) {
   }
   const otterFiles = entries.filter((f) => f.endsWith("-otter.json"));
   for (const filename of otterFiles) {
-    const filePath = join7(otterDir, filename);
+    const filePath = join8(otterDir, filename);
     try {
-      if (lstatSync7(filePath).isSymbolicLink()) {
+      if (lstatSync8(filePath).isSymbolicLink()) {
         failed.push({ filename, error: "Skipped: symlink" });
         continue;
       }
@@ -5482,9 +5661,9 @@ var DEFAULT_SEARCH_PATHS = ["node_modules/@stackwright-pro/otters/src/", "packag
 function resolveOtterDir() {
   const cwd = process.cwd();
   for (const relative of DEFAULT_SEARCH_PATHS) {
-    const candidate = join7(cwd, relative);
+    const candidate = join8(cwd, relative);
     try {
-      lstatSync7(candidate);
+      lstatSync8(candidate);
       return candidate;
     } catch {
     }
@@ -5563,13 +5742,13 @@ function registerIntegrityTools(server2) {
 
 // src/tools/domain.ts
 import { z as z16 } from "zod";
-import { readFileSync as readFileSync8, existsSync as existsSync8 } from "fs";
-import { join as join8 } from "path";
+import { readFileSync as readFileSync9, existsSync as existsSync8 } from "fs";
+import { join as join9 } from "path";
 function handleListCollections(input) {
   const cwd = input._cwd ?? process.cwd();
   const sources = [
     {
-      path: join8(cwd, ".stackwright", "artifacts", "data-config.json"),
+      path: join9(cwd, ".stackwright", "artifacts", "data-config.json"),
       source: "data-config.json",
       parse: (raw) => {
         const parsed = JSON.parse(raw);
@@ -5580,15 +5759,15 @@ function handleListCollections(input) {
       }
     },
     {
-      path: join8(cwd, "stackwright.yml"),
+      path: join9(cwd, "stackwright.yml"),
       source: "stackwright.yml",
       parse: extractCollectionsFromYaml
     }
   ];
-  for (const { path: path3, source, parse } of sources) {
-    if (!existsSync8(path3)) continue;
+  for (const { path: path4, source, parse } of sources) {
+    if (!existsSync8(path4)) continue;
     try {
-      const collections = parse(readFileSync8(path3, "utf8"));
+      const collections = parse(readFileSync9(path4, "utf8"));
       return {
         text: JSON.stringify({ collections, source, collectionCount: collections.length }),
         isError: false
@@ -5739,7 +5918,7 @@ function handleValidateWorkflow(input) {
   if (input.workflow && Object.keys(input.workflow).length > 0) {
     raw = input.workflow;
   } else {
-    const artifactPath = join8(cwd, ".stackwright", "artifacts", "workflow-config.json");
+    const artifactPath = join9(cwd, ".stackwright", "artifacts", "workflow-config.json");
     if (!existsSync8(artifactPath)) {
       return fail([
         {
@@ -5749,7 +5928,7 @@ function handleValidateWorkflow(input) {
       ]);
     }
     try {
-      raw = JSON.parse(readFileSync8(artifactPath, "utf8"));
+      raw = JSON.parse(readFileSync9(artifactPath, "utf8"));
     } catch (err) {
       return fail([{ code: "INVALID_JSON", message: `Failed to parse workflow artifact: ${err}` }]);
     }
@@ -5861,12 +6040,12 @@ function handleValidateWorkflow(input) {
   return { text: JSON.stringify({ valid: errors.length === 0, errors, warnings }), isError: false };
 }
 function validateTransitionTargets(step, stepId, stepIds, errors) {
-  const check = (target, path3) => {
+  const check = (target, path4) => {
     if (typeof target === "string" && !stepIds.has(target)) {
       errors.push({
         code: "ORPHANED_TRANSITION",
         message: `Step "${stepId}" transitions to "${target}" which does not exist`,
-        path: path3
+        path: path4
       });
     }
   };
@@ -5905,11 +6084,11 @@ function validateTransitionTargets(step, stepId, stepIds, errors) {
 }
 function collectServiceWarnings(step, stepId, warnings) {
   const isService = (val) => typeof val === "string" && val.startsWith("service:");
-  const warn = (path3) => {
+  const warn = (path4) => {
     warnings.push({
       code: "WARN_SERVICE_REFERENCE",
-      message: `service: reference at "${path3}" requires @stackwright-pro/services. Prism mock fallback will be used until services layer is configured.`,
-      path: path3
+      message: `service: reference at "${path4}" requires @stackwright-pro/services. Prism mock fallback will be used until services layer is configured.`,
+      path: path4
     });
   };
   const onSubmit = step.on_submit;
@@ -6059,15 +6238,15 @@ function registerTypeSchemasTool(server2) {
 // src/tools/scaffold-cleanup.ts
 import {
   existsSync as existsSync9,
-  lstatSync as lstatSync8,
+  lstatSync as lstatSync9,
   unlinkSync as unlinkSync2,
-  readFileSync as readFileSync9,
+  readFileSync as readFileSync10,
   writeFileSync as writeFileSync7,
-  readdirSync as readdirSync3,
+  readdirSync as readdirSync4,
   rmdirSync,
   mkdirSync as mkdirSync7
 } from "fs";
-import { join as join9, dirname as dirname2 } from "path";
+import { join as join10, dirname as dirname2 } from "path";
 var SCAFFOLD_FILES_TO_DELETE = [
   "content/posts/getting-started.yaml",
   "content/posts/hello-world.yaml"
@@ -6092,12 +6271,12 @@ var FALLBACK_COLORS = {
   mutedForeground: "#737373"
 };
 function readThemeColors(cwd) {
-  const tokenPath = join9(cwd, ".stackwright", "artifacts", "theme-tokens.json");
+  const tokenPath = join10(cwd, ".stackwright", "artifacts", "theme-tokens.json");
   if (!existsSync9(tokenPath)) return { ...FALLBACK_COLORS };
-  const stat = lstatSync8(tokenPath);
+  const stat = lstatSync9(tokenPath);
   if (stat.isSymbolicLink()) return { ...FALLBACK_COLORS };
   try {
-    const raw = JSON.parse(readFileSync9(tokenPath, "utf-8"));
+    const raw = JSON.parse(readFileSync10(tokenPath, "utf-8"));
     const css = raw?.cssVariables ?? {};
     const toHsl = (hslValue) => {
       if (!hslValue || typeof hslValue !== "string") return null;
@@ -6158,14 +6337,14 @@ function generateNotFoundPage(colors) {
 }
 function isSafePath(fullPath) {
   if (!existsSync9(fullPath)) return true;
-  const stat = lstatSync8(fullPath);
+  const stat = lstatSync9(fullPath);
   return !stat.isSymbolicLink();
 }
 function isDirEmpty(dirPath) {
   if (!existsSync9(dirPath)) return false;
-  const stat = lstatSync8(dirPath);
+  const stat = lstatSync9(dirPath);
   if (!stat.isDirectory()) return false;
-  return readdirSync3(dirPath).length === 0;
+  return readdirSync4(dirPath).length === 0;
 }
 function handleCleanupScaffold(_cwd) {
   const cwd = _cwd ?? process.cwd();
@@ -6178,7 +6357,7 @@ function handleCleanupScaffold(_cwd) {
     cleanupWarnings: []
   };
   for (const relPath of SCAFFOLD_FILES_TO_DELETE) {
-    const fullPath = join9(cwd, relPath);
+    const fullPath = join10(cwd, relPath);
     if (!existsSync9(fullPath)) {
       result.skipped.push(relPath);
       continue;
@@ -6196,13 +6375,13 @@ function handleCleanupScaffold(_cwd) {
   }
   {
     const relPath = "pages/getting-started/content.yml";
-    const fullPath = join9(cwd, relPath);
+    const fullPath = join10(cwd, relPath);
     if (!existsSync9(fullPath)) {
       result.skipped.push(relPath);
     } else if (!isSafePath(fullPath)) {
       result.errors.push(`Refusing to delete symlink: ${relPath}`);
     } else {
-      const content = readFileSync9(fullPath, "utf-8");
+      const content = readFileSync10(fullPath, "utf-8");
       const isScaffoldDefault = GETTING_STARTED_SCAFFOLD_FINGERPRINTS.some(
         (marker) => content.includes(marker)
       );
@@ -6222,8 +6401,8 @@ function handleCleanupScaffold(_cwd) {
   }
   {
     const relPath = `content/posts/${POSTS_COLLECTION_FILE}`;
-    const fullPath = join9(cwd, relPath);
-    const postsDir = join9(cwd, "content/posts");
+    const fullPath = join10(cwd, relPath);
+    const postsDir = join10(cwd, "content/posts");
     if (!existsSync9(fullPath)) {
       result.skipped.push(relPath);
     } else if (!isSafePath(fullPath)) {
@@ -6231,7 +6410,7 @@ function handleCleanupScaffold(_cwd) {
     } else if (!existsSync9(postsDir)) {
       result.skipped.push(relPath);
     } else {
-      const userPostFiles = readdirSync3(postsDir).filter(
+      const userPostFiles = readdirSync4(postsDir).filter(
         (f) => f !== POSTS_COLLECTION_FILE && POST_FILE_EXTENSIONS.some((ext) => f.endsWith(ext))
       );
       if (userPostFiles.length === 0) {
@@ -6249,7 +6428,7 @@ function handleCleanupScaffold(_cwd) {
     }
   }
   for (const relDir of SCAFFOLD_DIRS_TO_PRUNE) {
-    const fullDir = join9(cwd, relDir);
+    const fullDir = join10(cwd, relDir);
     if (!existsSync9(fullDir)) continue;
     if (!isSafePath(fullDir)) {
       result.errors.push(`Refusing to prune symlink directory: ${relDir}`);
@@ -6265,7 +6444,7 @@ function handleCleanupScaffold(_cwd) {
     }
   }
   {
-    const fullPath = join9(cwd, NOT_FOUND_PATH);
+    const fullPath = join10(cwd, NOT_FOUND_PATH);
     if (!existsSync9(fullPath)) {
       result.skipped.push(NOT_FOUND_PATH);
     } else if (!isSafePath(fullPath)) {
@@ -6543,11 +6722,256 @@ function registerContrastTools(server2) {
   );
 }
 
+// src/tools/compile.ts
+import { z as z19 } from "zod";
+import fs2 from "fs";
+import path3 from "path";
+import { compileCollections } from "@stackwright-pro/pulse/server";
+import { compileAuth } from "@stackwright-pro/auth-nextjs/server";
+import { compileIntegrations } from "@stackwright-pro/openapi/server";
+function buildContext(projectRoot) {
+  return {
+    projectRoot,
+    contentOutDir: path3.join(projectRoot, "public", "stackwright-content"),
+    imagesDir: path3.join(projectRoot, "public", "images"),
+    siteConfig: loadSiteConfig(projectRoot)
+  };
+}
+function loadSiteConfig(projectRoot) {
+  try {
+    const sitePath = path3.join(projectRoot, "public", "stackwright-content", "_site.json");
+    return JSON.parse(fs2.readFileSync(sitePath, "utf8"));
+  } catch {
+    return {};
+  }
+}
+function formatDuration(startMs) {
+  const ms = Date.now() - startMs;
+  return ms < 1e3 ? `${ms}ms` : `${(ms / 1e3).toFixed(2)}s`;
+}
+async function tryOssCompile(fn, ctx, extra) {
+  try {
+    const bsPath = path3.join(ctx.projectRoot, "node_modules", "@stackwright", "build-scripts");
+    if (!fs2.existsSync(bsPath)) {
+      return {
+        ok: false,
+        error: `@stackwright/build-scripts not found at ${bsPath}. Is it installed in your project?`
+      };
+    }
+    const bs = await import(bsPath);
+    if (typeof bs[fn] !== "function") {
+      return { ok: false, error: `${fn} not exported from @stackwright/build-scripts` };
+    }
+    await bs[fn](ctx, ...extra ? [extra] : []);
+    return { ok: true };
+  } catch (err) {
+    return { ok: false, error: err instanceof Error ? err.message : String(err) };
+  }
+}
+function registerCompileTools(server2) {
+  const projectRootArg = z19.string().optional().describe("Absolute path to project root (defaults to cwd)");
+  server2.tool(
+    "stackwright_pro_compile_collections",
+    "Compile stackwright.collections.yml \u2192 public/stackwright-content/_collections.json. Reads and validates the live-collections sidecar config file and emits the JSON sink consumed at runtime by PulseCollectionProvider.",
+    { projectRoot: projectRootArg },
+    async ({ projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      try {
+        await compileCollections(buildContext(root));
+        return {
+          content: [
+            {
+              type: "text",
+              text: ` _collections.json written (${formatDuration(start)})`
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: ` compile_collections failed: ${err instanceof Error ? err.message : String(err)}`
+            }
+          ]
+        };
+      }
+    }
+  );
+  server2.tool(
+    "stackwright_pro_compile_auth",
+    "Compile stackwright.auth.yml \u2192 public/stackwright-content/_auth.json. Reads and validates the auth sidecar config file and emits the JSON sink consumed at app startup to configure auth middleware.",
+    { projectRoot: projectRootArg },
+    async ({ projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      try {
+        await compileAuth(buildContext(root));
+        return {
+          content: [
+            {
+              type: "text",
+              text: ` _auth.json written (${formatDuration(start)})`
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: ` compile_auth failed: ${err instanceof Error ? err.message : String(err)}`
+            }
+          ]
+        };
+      }
+    }
+  );
+  server2.tool(
+    "stackwright_pro_compile_integrations",
+    "Compile stackwright.integrations.yml \u2192 public/stackwright-content/_integrations.json. If no yml file exists, falls back to extracting integration metadata from _site.json (collections data is excluded \u2014 it lives in _collections.json).",
+    { projectRoot: projectRootArg },
+    async ({ projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      try {
+        await compileIntegrations(buildContext(root));
+        return {
+          content: [
+            {
+              type: "text",
+              text: ` _integrations.json written (${formatDuration(start)})`
+            }
+          ]
+        };
+      } catch (err) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: ` compile_integrations failed: ${err instanceof Error ? err.message : String(err)}`
+            }
+          ]
+        };
+      }
+    }
+  );
+  server2.tool(
+    "stackwright_pro_compile_all",
+    "Run all Pro compile sinks (collections + auth + integrations) in sequence. Equivalent to running compile_collections, compile_auth, and compile_integrations individually. Use this for a full Pro prebuild pass.",
+    { projectRoot: projectRootArg },
+    async ({ projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      const ctx = buildContext(root);
+      const results = [];
+      const errors = [];
+      for (const [label, fn] of [
+        ["collections", () => compileCollections(ctx)],
+        ["auth", () => compileAuth(ctx)],
+        ["integrations", () => compileIntegrations(ctx)]
+      ]) {
+        try {
+          await fn();
+          results.push(`   _${label}.json`);
+        } catch (err) {
+          errors.push(`   ${label}: ${err instanceof Error ? err.message : String(err)}`);
+        }
+      }
+      const summary = errors.length > 0 ? ` compile_all finished with errors (${formatDuration(start)}):
+${results.join("\n")}
+Errors:
+${errors.join("\n")}` : ` compile_all complete (${formatDuration(start)}):
+${results.join("\n")}`;
+      return { content: [{ type: "text", text: summary }] };
+    }
+  );
+  server2.tool(
+    "stackwright_pro_compile_theme",
+    "Compile stackwright.yml theme config \u2192 _theme.json. Delegates to compileTheme from @stackwright/build-scripts installed in the project.",
+    { projectRoot: projectRootArg },
+    async ({ projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      const { ok, error } = await tryOssCompile("compileTheme", buildContext(root));
+      return {
+        content: [
+          {
+            type: "text",
+            text: ok ? ` _theme.json written (${formatDuration(start)})` : ` compile_theme failed: ${error}`
+          }
+        ]
+      };
+    }
+  );
+  server2.tool(
+    "stackwright_pro_compile_site",
+    "Compile stackwright.yml \u2192 _site.json. Delegates to compileSite from @stackwright/build-scripts installed in the project.",
+    { projectRoot: projectRootArg },
+    async ({ projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      const { ok, error } = await tryOssCompile("compileSite", buildContext(root));
+      return {
+        content: [
+          {
+            type: "text",
+            text: ok ? ` _site.json written (${formatDuration(start)})` : ` compile_site failed: ${error}`
+          }
+        ]
+      };
+    }
+  );
+  server2.tool(
+    "stackwright_pro_compile_pages",
+    "Compile all pages content.yml files \u2192 page JSON files. Delegates to compilePages from @stackwright/build-scripts installed in the project.",
+    { projectRoot: projectRootArg },
+    async ({ projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      const { ok, error } = await tryOssCompile("compilePages", buildContext(root));
+      return {
+        content: [
+          {
+            type: "text",
+            text: ok ? ` pages compiled (${formatDuration(start)})` : ` compile_pages failed: ${error}`
+          }
+        ]
+      };
+    }
+  );
+  server2.tool(
+    "stackwright_pro_compile_page",
+    "Compile a single page by slug. Delegates to compilePage from @stackwright/build-scripts installed in the project.",
+    {
+      slug: z19.string().describe('Page slug (relative path under pages/, e.g. "dashboard")'),
+      projectRoot: projectRootArg
+    },
+    async ({ slug, projectRoot }) => {
+      const start = Date.now();
+      const root = projectRoot ?? process.cwd();
+      const { ok, error } = await tryOssCompile("compilePage", buildContext(root), { slug });
+      return {
+        content: [
+          {
+            type: "text",
+            text: ok ? ` page "${slug}" compiled (${formatDuration(start)})` : ` compile_page failed: ${error}`
+          }
+        ]
+      };
+    }
+  );
+}
+
 // package.json
 var package_default = {
   dependencies: {
     "@modelcontextprotocol/sdk": "^1.10.0",
+    "@stackwright-pro/auth-nextjs": "workspace:*",
     "@stackwright-pro/cli-data-explorer": "workspace:*",
+    "@stackwright-pro/openapi": "workspace:*",
+    "@stackwright-pro/pulse": "workspace:*",
     "@stackwright-pro/types": "workspace:*",
     "@types/js-yaml": "^4.0.9",
     "js-yaml": "^4.2.0",
@@ -6568,7 +6992,7 @@ var package_default = {
     "test:coverage": "vitest run --coverage"
   },
   name: "@stackwright-pro/mcp",
-  version: "0.2.0-alpha.92",
+  version: "0.2.0-alpha.95",
   description: "MCP tools for Stackwright Pro - Data Explorer, Security, ISR, and Dashboard generation",
   license: "SEE LICENSE IN LICENSE",
   main: "./dist/server.js",
@@ -6626,7 +7050,22 @@ registerValidateYamlFragmentTool(server);
 registerGetSchemaTool(server);
 registerScaffoldCleanupTools(server);
 registerContrastTools(server);
+registerCompileTools(server);
 async function main() {
+  const pipelineGraph = loadPipelineGraph();
+  const phasePosition = new Map(PHASE_ORDER.map((p, i) => [p, i]));
+  for (const [phase, deps] of Object.entries(pipelineGraph.dependencies)) {
+    const phaseIdx = phasePosition.get(phase);
+    if (phaseIdx === void 0) continue;
+    for (const dep of deps) {
+      const depIdx = phasePosition.get(dep);
+      if (depIdx !== void 0 && depIdx >= phaseIdx) {
+        throw new Error(
+          `PHASE_ORDER sanity check failed: "${dep}" (position ${depIdx}) must precede "${phase}" (position ${phaseIdx}) but it doesn't. Update PHASE_ORDER in pipeline.ts to reflect the new dependency structure.`
+        );
+      }
+    }
+  }
   const transport = new StdioServerTransport();
   try {
     const servicesRegisterPkg = "@stackwright-services/mcp/register";