@stackwright-pro/mcp 0.2.0-alpha.21 → 0.2.0-alpha.22

package/dist/server.mjs

@@ -1110,7 +1110,8 @@ function setupPackages(opts) {
 }
 
 // src/tools/questions.ts
-import { readFile } from "fs/promises";
+import { readFile, writeFile } from "fs/promises";
+import { existsSync as existsSync2, lstatSync as lstatSync2, mkdirSync, renameSync } from "fs";
 import { join } from "path";
 import { z as z8 } from "zod";
 
@@ -1383,12 +1384,12 @@ function registerQuestionTools(server2) {
           content: [
             {
               type: "text",
-              text: JSON.stringify({
-                phase,
-                skipped: true,
-                reason: "No questions to present (all filtered by dependsOn conditions)",
-                answers: []
-              })
+              text: `Phase "${phase}" has no questions to present. Do NOT call ask_user_question. Call stackwright_pro_save_phase_answers({ phase: "${phase}", rawAnswers: [] }) directly, then proceed to the execution step for this phase.`
+            },
+            {
+              type: "text",
+              // Empty array — second block always present so the foreman's two-block contract holds
+              text: JSON.stringify([])
             }
           ],
           isError: false
@@ -1409,11 +1410,149 @@ function registerQuestionTools(server2) {
       };
     }
   );
+  server2.tool(
+    "stackwright_pro_get_next_question",
+    "Returns the next unanswered question for a phase as a plain JSON object \u2014 one question at a time. Returns { done: true } when all questions are answered or the phase has no questions. Call this in a loop: present the question in plain chat, get user reply, call record_answer, repeat.",
+    { phase: z8.string().describe('Phase name e.g. "designer", "api", "auth"') },
+    async ({ phase }) => {
+      const SAFE_PHASE = /^[a-z][a-z0-9-]{0,30}$/;
+      if (!SAFE_PHASE.test(phase)) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ error: `Invalid phase name: "${phase.slice(0, 50)}"` })
+            }
+          ],
+          isError: true
+        };
+      }
+      const cwd = process.cwd();
+      const questionsPath = join(cwd, ".stackwright", "questions", `${phase}.json`);
+      let questions = [];
+      try {
+        const raw = await readFile(questionsPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        questions = parsed.questions ?? [];
+      } catch {
+        return { content: [{ type: "text", text: JSON.stringify({ done: true }) }] };
+      }
+      if (questions.length === 0) {
+        return { content: [{ type: "text", text: JSON.stringify({ done: true }) }] };
+      }
+      const answersPath = join(cwd, ".stackwright", "answers", `${phase}.json`);
+      let answeredIds = /* @__PURE__ */ new Set();
+      try {
+        const raw = await readFile(answersPath, "utf-8");
+        const parsed = JSON.parse(raw);
+        answeredIds = new Set(Object.keys(parsed.answers ?? {}));
+      } catch {
+      }
+      const next = questions.find((q) => !answeredIds.has(q.id));
+      if (!next) {
+        return { content: [{ type: "text", text: JSON.stringify({ done: true }) }] };
+      }
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              done: false,
+              questionId: next.id,
+              question: next.question,
+              type: next.type,
+              options: next.options ?? null,
+              help: next.help ?? null,
+              index: questions.indexOf(next) + 1,
+              total: questions.length
+            })
+          }
+        ]
+      };
+    }
+  );
+  server2.tool(
+    "stackwright_pro_record_answer",
+    "Records a single answer to a phase question. Appends to .stackwright/answers/{phase}.json incrementally. Idempotent \u2014 calling twice for the same questionId overwrites. Call after receiving each user reply in the conversational question loop.",
+    {
+      phase: z8.string().describe('Phase name e.g. "designer"'),
+      questionId: z8.string().describe('The question ID from get_next_question, e.g. "designer-1"'),
+      answer: z8.string().describe("The user's free-text answer")
+    },
+    async ({ phase, questionId, answer }) => {
+      const SAFE_PHASE = /^[a-z][a-z0-9-]{0,30}$/;
+      if (!SAFE_PHASE.test(phase)) {
+        return {
+          content: [
+            { type: "text", text: JSON.stringify({ error: "Invalid phase name" }) }
+          ],
+          isError: true
+        };
+      }
+      if (!/^[a-z0-9][a-z0-9-]{0,63}$/i.test(questionId)) {
+        return {
+          content: [
+            { type: "text", text: JSON.stringify({ error: "Invalid questionId" }) }
+          ],
+          isError: true
+        };
+      }
+      const safeAnswer = answer.slice(0, 2e3);
+      const cwd = process.cwd();
+      const answersDir = join(cwd, ".stackwright", "answers");
+      const answersPath = join(answersDir, `${phase}.json`);
+      if (existsSync2(answersDir) && lstatSync2(answersDir).isSymbolicLink()) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({ error: "answers dir is a symlink \u2014 refusing to write" })
+            }
+          ],
+          isError: true
+        };
+      }
+      mkdirSync(answersDir, { recursive: true });
+      let existing = {
+        version: "1.0",
+        phase,
+        answers: {}
+      };
+      try {
+        if (existsSync2(answersPath)) {
+          if (lstatSync2(answersPath).isSymbolicLink()) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: JSON.stringify({ error: "answers file is a symlink \u2014 refusing to write" })
+                }
+              ],
+              isError: true
+            };
+          }
+          const raw = await readFile(answersPath, "utf-8");
+          existing = JSON.parse(raw);
+        }
+      } catch {
+      }
+      existing.answers[questionId] = safeAnswer;
+      existing.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
+      const tmp = `${answersPath}.tmp`;
+      await writeFile(tmp, JSON.stringify(existing, null, 2), "utf-8");
+      renameSync(tmp, answersPath);
+      return {
+        content: [
+          { type: "text", text: JSON.stringify({ recorded: true, phase, questionId }) }
+        ]
+      };
+    }
+  );
 }
 
 // src/tools/orchestration.ts
 import { z as z9 } from "zod";
-import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync2, mkdirSync, lstatSync as lstatSync2 } from "fs";
+import { readFileSync as readFileSync2, writeFileSync as writeFileSync2, existsSync as existsSync3, mkdirSync as mkdirSync2, lstatSync as lstatSync3 } from "fs";
 import { join as join2 } from "path";
 var OTTER_NAME_TO_PHASE = [
   ["designer", "designer"],
@@ -1469,9 +1608,9 @@ function handleSaveManifest(input) {
   const dir = join2(cwd, ".stackwright");
   const filePath = join2(dir, "question-manifest.json");
   try {
-    mkdirSync(dir, { recursive: true });
-    if (existsSync2(filePath)) {
-      const stat = lstatSync2(filePath);
+    mkdirSync2(dir, { recursive: true });
+    if (existsSync3(filePath)) {
+      const stat = lstatSync3(filePath);
       if (stat.isSymbolicLink()) {
         const message = `Refusing to write to symlink: ${filePath}`;
         return {
@@ -1503,7 +1642,7 @@ function handleSavePhaseAnswers(input) {
   const dir = join2(cwd, ".stackwright", "answers");
   const filePath = join2(dir, `${input.phase}.json`);
   try {
-    mkdirSync(dir, { recursive: true });
+    mkdirSync2(dir, { recursive: true });
     let answers;
     if (input.questions && input.questions.length > 0) {
       answers = answersToManifestFormat(input.rawAnswers, input.questions);
@@ -1518,8 +1657,8 @@ function handleSavePhaseAnswers(input) {
       completedAt: (/* @__PURE__ */ new Date()).toISOString(),
       answers
     };
-    if (existsSync2(filePath)) {
-      const stat = lstatSync2(filePath);
+    if (existsSync3(filePath)) {
+      const stat = lstatSync3(filePath);
       if (stat.isSymbolicLink()) {
         const message = `Refusing to write to symlink: ${filePath}`;
         return {
@@ -1548,7 +1687,7 @@ function handleSavePhaseAnswers(input) {
 function handleReadPhaseAnswers(input) {
   const cwd = input._cwd ?? process.cwd();
   const filePath = join2(cwd, ".stackwright", "answers", `${input.phase}.json`);
-  if (!existsSync2(filePath)) {
+  if (!existsSync3(filePath)) {
     return {
       text: JSON.stringify({ missing: true, phase: input.phase }),
       isError: false
@@ -1580,7 +1719,57 @@ function handleGetOtterName(input) {
     isError: false
   };
 }
+function handleSaveBuildContext(input) {
+  const cwd = input._cwd ?? process.cwd();
+  const dir = join2(cwd, ".stackwright");
+  const filePath = join2(dir, "build-context.json");
+  try {
+    mkdirSync2(dir, { recursive: true });
+    if (existsSync3(filePath)) {
+      const stat = lstatSync3(filePath);
+      if (stat.isSymbolicLink()) {
+        return {
+          text: JSON.stringify({
+            success: false,
+            error: `Refusing to write to symlink: ${filePath}`
+          }),
+          isError: true
+        };
+      }
+    }
+    const payload = {
+      version: "1.0",
+      savedAt: (/* @__PURE__ */ new Date()).toISOString(),
+      buildContext: input.buildContext
+    };
+    writeFileSync2(filePath, JSON.stringify(payload, null, 2) + "\n");
+    return {
+      text: JSON.stringify({ success: true, path: filePath }),
+      isError: false
+    };
+  } catch (err) {
+    const message = err instanceof Error ? err.message : String(err);
+    return {
+      text: JSON.stringify({ success: false, error: message }),
+      isError: true
+    };
+  }
+}
 function registerOrchestrationTools(server2) {
+  server2.tool(
+    "stackwright_pro_save_build_context",
+    `Save the user's initial build description to .stackwright/build-context.json. Call this once at startup after the user answers the opening "what are you building" question. The saved context is automatically prepended to specialist prompts by stackwright_pro_build_specialist_prompt.`,
+    {
+      buildContext: z9.string().describe("Free-text description of what the user wants to build")
+    },
+    async ({ buildContext }) => {
+      const { text, isError } = handleSaveBuildContext({ buildContext });
+      return {
+        content: [{ type: "text", text }],
+        isError
+      };
+    }
+  );
   server2.tool(
     "stackwright_pro_parse_otter_response",
     "Parse and validate a specialist otter's QUESTION_COLLECTION_MODE JSON response. Handles JSON extraction from LLM responses (strips markdown, fixes single quotes, trailing commas). Detects the phase from the otter name. Use this immediately after invoke_agent() to get a validated manifest phase object.",
@@ -1686,7 +1875,7 @@ function registerOrchestrationTools(server2) {
 
 // src/tools/pipeline.ts
 import { z as z10 } from "zod";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync3, mkdirSync as mkdirSync2, lstatSync as lstatSync3 } from "fs";
+import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync3, lstatSync as lstatSync4 } from "fs";
 import { join as join3 } from "path";
 var PHASE_ORDER = [
   "designer",
@@ -1760,7 +1949,7 @@ function statePath(cwd) {
 }
 function readState(cwd) {
   const p = statePath(cwd);
-  if (!existsSync3(p)) return createDefaultState();
+  if (!existsSync4(p)) return createDefaultState();
   const raw = JSON.parse(safeReadSync(p));
   if (typeof raw !== "object" || raw === null || raw.version !== "1.0") {
     return createDefaultState();
@@ -1768,8 +1957,8 @@ function readState(cwd) {
   return raw;
 }
 function safeWriteSync(filePath, content) {
-  if (existsSync3(filePath)) {
-    const stat = lstatSync3(filePath);
+  if (existsSync4(filePath)) {
+    const stat = lstatSync4(filePath);
     if (stat.isSymbolicLink()) {
       throw new Error(`Refusing to write to symlink: ${filePath}`);
     }
@@ -1777,8 +1966,8 @@ function safeWriteSync(filePath, content) {
   writeFileSync3(filePath, content);
 }
 function safeReadSync(filePath) {
-  if (existsSync3(filePath)) {
-    const stat = lstatSync3(filePath);
+  if (existsSync4(filePath)) {
+    const stat = lstatSync4(filePath);
     if (stat.isSymbolicLink()) {
       throw new Error(`Refusing to read symlink: ${filePath}`);
     }
@@ -1787,7 +1976,7 @@ function safeReadSync(filePath) {
 }
 function writeState(cwd, state) {
   const dir = join3(cwd, ".stackwright");
-  mkdirSync2(dir, { recursive: true });
+  mkdirSync3(dir, { recursive: true });
   state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   safeWriteSync(statePath(cwd), JSON.stringify(state, null, 2) + "\n");
 }
@@ -1859,28 +2048,62 @@ function handleSetPipelineState(input) {
     return { text: JSON.stringify({ error: true, message: String(err) }), isError: true };
   }
 }
-function handleCheckExecutionReady(_cwd) {
+function handleCheckExecutionReady(_cwd, phase) {
   const cwd = _cwd ?? process.cwd();
+  if (phase) {
+    if (!isValidPhase(phase)) {
+      return {
+        text: JSON.stringify({
+          error: true,
+          message: `Invalid phase: ${phase}. Valid phases are: ${PHASE_ORDER.join(", ")}`
+        }),
+        isError: true
+      };
+    }
+    const answerFile = join3(cwd, ".stackwright", "answers", `${phase}.json`);
+    if (!existsSync4(answerFile)) {
+      return {
+        text: JSON.stringify({ ready: false, phase, reason: "Answer file not found" }),
+        isError: false
+      };
+    }
+    try {
+      const raw = safeReadSync(answerFile);
+      const parsed = JSON.parse(raw);
+      if (typeof parsed["version"] !== "string" || typeof parsed["phase"] !== "string" || typeof parsed["answers"] !== "object" || parsed["answers"] === null) {
+        return {
+          text: JSON.stringify({ ready: false, phase, reason: "Answer file is malformed" }),
+          isError: false
+        };
+      }
+      return { text: JSON.stringify({ ready: true, phase }), isError: false };
+    } catch {
+      return {
+        text: JSON.stringify({ ready: false, phase, reason: "Answer file could not be parsed" }),
+        isError: false
+      };
+    }
+  }
   try {
     const answersDir = join3(cwd, ".stackwright", "answers");
     const answeredPhases = [];
     const missingPhases = [];
-    for (const phase of PHASE_ORDER) {
-      const answerFile = join3(answersDir, `${phase}.json`);
-      if (existsSync3(answerFile)) {
+    for (const phase2 of PHASE_ORDER) {
+      const answerFile = join3(answersDir, `${phase2}.json`);
+      if (existsSync4(answerFile)) {
         try {
           const raw = safeReadSync(answerFile);
           const parsed = JSON.parse(raw);
           if (typeof parsed["version"] !== "string" || typeof parsed["phase"] !== "string" || typeof parsed["answers"] !== "object" || parsed["answers"] === null) {
-            missingPhases.push(phase);
+            missingPhases.push(phase2);
             continue;
           }
-          answeredPhases.push(phase);
+          answeredPhases.push(phase2);
         } catch {
-          missingPhases.push(phase);
+          missingPhases.push(phase2);
         }
       } else {
-        missingPhases.push(phase);
+        missingPhases.push(phase2);
       }
     }
     return {
@@ -1905,7 +2128,7 @@ function handleListArtifacts(_cwd) {
     for (const phase of PHASE_ORDER) {
       const expectedFile = PHASE_ARTIFACT[phase];
       const fullPath = join3(artifactsDir, expectedFile);
-      const exists = existsSync3(fullPath);
+      const exists = existsSync4(fullPath);
       if (exists) completedCount++;
       artifacts.push({ phase, expectedFile, exists, path: fullPath });
     }
@@ -1944,7 +2167,7 @@ function handleWritePhaseQuestions(input) {
     } catch {
     }
     const questionsDir = join3(cwd, ".stackwright", "questions");
-    mkdirSync2(questionsDir, { recursive: true });
+    mkdirSync3(questionsDir, { recursive: true });
     const filePath = join3(questionsDir, `${phase}.json`);
     const payload = {
       version: "1.0",
@@ -1987,26 +2210,38 @@ function handleBuildSpecialistPrompt(input) {
   try {
     const answersPath = join3(cwd, ".stackwright", "answers", `${phase}.json`);
     let answers = {};
-    if (existsSync3(answersPath)) {
+    if (existsSync4(answersPath)) {
       answers = JSON.parse(safeReadSync(answersPath));
     }
+    let buildContextText = "";
+    const buildContextPath = join3(cwd, ".stackwright", "build-context.json");
+    if (existsSync4(buildContextPath)) {
+      try {
+        const bcRaw = JSON.parse(safeReadSync(buildContextPath));
+        if (typeof bcRaw.buildContext === "string" && bcRaw.buildContext.trim().length > 0) {
+          buildContextText = bcRaw.buildContext.trim();
+        }
+      } catch {
+      }
+    }
     const deps = PHASE_DEPENDENCIES[phase];
     const artifactSections = [];
     const missingDependencies = [];
     for (const dep of deps) {
       const artifactFile = PHASE_ARTIFACT[dep];
       const artifactPath = join3(cwd, ".stackwright", "artifacts", artifactFile);
-      if (existsSync3(artifactPath)) {
+      if (existsSync4(artifactPath)) {
         const content = JSON.parse(safeReadSync(artifactPath));
         const expectedOtter = PHASE_TO_OTTER2[dep];
         const artifactOtter = content["generatedBy"];
+        const normalizedOtter = artifactOtter?.replace(/-[a-f0-9]{6}$/, "");
         if (!artifactOtter) {
           missingDependencies.push(dep);
           artifactSections.push(
             `[${artifactFile}]:
 (integrity check failed: missing generatedBy field)`
           );
-        } else if (artifactOtter !== expectedOtter) {
+        } else if (normalizedOtter !== expectedOtter) {
           missingDependencies.push(dep);
           artifactSections.push(
             `[${artifactFile}]:
@@ -2022,7 +2257,11 @@ ${JSON.stringify(content, null, 2)}`);
 (not yet available)`);
       }
     }
-    const parts = ["ANSWERS:", JSON.stringify(answers, null, 2)];
+    const parts = [];
+    if (buildContextText) {
+      parts.push("BUILD_CONTEXT:", buildContextText, "");
+    }
+    parts.push("ANSWERS:", JSON.stringify(answers, null, 2));
     if (artifactSections.length > 0) {
       parts.push("", "UPSTREAM ARTIFACTS:", "", ...artifactSections);
     }
@@ -2121,7 +2360,7 @@ function handleValidateArtifact(input) {
   }
   try {
     const artifactsDir = join3(cwd, ".stackwright", "artifacts");
-    mkdirSync2(artifactsDir, { recursive: true });
+    mkdirSync3(artifactsDir, { recursive: true });
     const artifactFile = PHASE_ARTIFACT[phase];
     const artifactPath = join3(artifactsDir, artifactFile);
     safeWriteSync(artifactPath, JSON.stringify(artifact, null, 2) + "\n");
@@ -2181,9 +2420,11 @@ function registerPipelineTools(server2) {
   );
   server2.tool(
     "stackwright_pro_check_execution_ready",
-    `Check all phases have answer files in .stackwright/answers/. ${DESC}`,
-    {},
-    async () => res(handleCheckExecutionReady())
+    `Check all phases have answer files in .stackwright/answers/. If phase is provided, check only that phase. ${DESC}`,
+    {
+      phase: z10.string().optional().describe("If provided, check only this phase's readiness. Omit to check all phases.")
+    },
+    async ({ phase }) => res(handleCheckExecutionReady(void 0, phase))
   );
   server2.tool(
     "stackwright_pro_list_artifacts",
@@ -2193,12 +2434,49 @@ function registerPipelineTools(server2) {
   );
   server2.tool(
     "stackwright_pro_write_phase_questions",
-    `Parse otter question-collection response \u2192 .stackwright/questions/{phase}.json. ${DESC}`,
+    `Parse otter question-collection response \u2192 .stackwright/questions/{phase}.json. Specialists may also call this directly with a parsed questions array. ${DESC}`,
     {
-      phase: z10.string().describe('Phase name, e.g. "designer"'),
-      responseText: z10.string().describe("Raw LLM response from QUESTION_COLLECTION_MODE")
+      phase: z10.string().optional().describe('Phase name, e.g. "designer" (required for direct write)'),
+      responseText: z10.string().optional().describe("Raw LLM response from QUESTION_COLLECTION_MODE"),
+      questions: jsonCoerce(z10.array(z10.any()).optional()).describe(
+        "Questions array for direct specialist write"
+      )
     },
-    async ({ phase, responseText }) => res(handleWritePhaseQuestions({ phase, responseText }))
+    async ({ phase, responseText, questions }) => {
+      if (phase && questions && Array.isArray(questions)) {
+        const SAFE_PHASE = /^[a-z][a-z0-9-]{0,30}$/;
+        if (!SAFE_PHASE.test(phase)) {
+          return {
+            content: [
+              { type: "text", text: JSON.stringify({ error: `Invalid phase name` }) }
+            ],
+            isError: true
+          };
+        }
+        const questionsDir = join3(process.cwd(), ".stackwright", "questions");
+        mkdirSync3(questionsDir, { recursive: true });
+        const outPath = join3(questionsDir, `${phase}.json`);
+        writeFileSync3(
+          outPath,
+          JSON.stringify({ phase, questions, writtenAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)
+        );
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                written: true,
+                phase,
+                count: questions.length
+              })
+            }
+          ]
+        };
+      }
+      return res(
+        handleWritePhaseQuestions({ phase: phase ?? "", responseText: responseText ?? "" })
+      );
+    }
   );
   server2.tool(
     "stackwright_pro_build_specialist_prompt",
@@ -2219,7 +2497,7 @@ function registerPipelineTools(server2) {
 
 // src/tools/safe-write.ts
 import { z as z11 } from "zod";
-import { writeFileSync as writeFileSync4, existsSync as existsSync4, mkdirSync as mkdirSync3, lstatSync as lstatSync4 } from "fs";
+import { writeFileSync as writeFileSync4, existsSync as existsSync5, mkdirSync as mkdirSync4, lstatSync as lstatSync5 } from "fs";
 import { normalize, isAbsolute, dirname, join as join4 } from "path";
 var OTTER_WRITE_ALLOWLISTS = {
   "stackwright-pro-designer-otter": [
@@ -2393,9 +2671,9 @@ function handleSafeWrite(input) {
   }
   const normalized = normalize(filePath);
   const fullPath = join4(cwd, normalized);
-  if (existsSync4(fullPath)) {
+  if (existsSync5(fullPath)) {
     try {
-      const stat = lstatSync4(fullPath);
+      const stat = lstatSync5(fullPath);
       if (stat.isSymbolicLink()) {
         const result = {
           success: false,
@@ -2422,7 +2700,7 @@ function handleSafeWrite(input) {
   }
   try {
     if (createDirectories) {
-      mkdirSync3(dirname(fullPath), { recursive: true });
+      mkdirSync4(dirname(fullPath), { recursive: true });
     }
     writeFileSync4(fullPath, content, { encoding: "utf-8" });
     const result = {
@@ -2453,7 +2731,9 @@ function registerSafeWriteTools(server2) {
       callerOtter: z11.string().describe('The otter agent name requesting the write, e.g. "stackwright-pro-page-otter"'),
       filePath: z11.string().describe('Relative path from project root, e.g. "pages/dashboard/content.yml"'),
       content: z11.string().describe("File content to write"),
-      createDirectories: z11.boolean().optional().describe("Create parent directories if they don't exist. Default: true")
+      createDirectories: boolCoerce(z11.boolean().optional().default(true)).describe(
+        "Create parent directories if they don't exist. Default: true"
+      )
     },
     async ({ callerOtter, filePath, content, createDirectories }) => {
       const result = handleSafeWrite({
@@ -2469,7 +2749,7 @@ function registerSafeWriteTools(server2) {
 
 // src/tools/auth.ts
 import { z as z12 } from "zod";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync5, existsSync as existsSync5 } from "fs";
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync5, existsSync as existsSync6 } from "fs";
 import { join as join5 } from "path";
 function buildHierarchy(roles) {
   const h = {};
@@ -2749,7 +3029,7 @@ async function configureAuthHandler(params, cwd) {
   try {
     const envBlock = generateEnvBlock(method, params);
     const envPath = join5(cwd, ".env.example");
-    if (existsSync5(envPath)) {
+    if (existsSync6(envPath)) {
       const existing = readFileSync4(envPath, "utf8");
       writeFileSync5(envPath, existing.trimEnd() + "\n\n" + envBlock, "utf8");
     } else {
@@ -2780,7 +3060,7 @@ async function configureAuthHandler(params, cwd) {
       protectedRoutes
     );
     const ymlPath = join5(cwd, "stackwright.yml");
-    if (!existsSync5(ymlPath)) {
+    if (!existsSync6(ymlPath)) {
       writeFileSync5(ymlPath, authYaml, "utf8");
     } else {
       const existing = readFileSync4(ymlPath, "utf8");
@@ -2862,44 +3142,44 @@ function registerAuthTools(server2) {
 
 // src/integrity.ts
 import { createHash as createHash2, timingSafeEqual } from "crypto";
-import { readFileSync as readFileSync5, readdirSync, lstatSync as lstatSync5 } from "fs";
+import { readFileSync as readFileSync5, readdirSync, lstatSync as lstatSync6 } from "fs";
 import { join as join6, basename } from "path";
 var _checksums = /* @__PURE__ */ new Map([
   [
     "stackwright-pro-api-otter.json",
-    "f1cc9edf2dd1df3ebcea1d0ab33d17a358faaf8aa97ee232cd7994042f2eac0d"
+    "0ac26d85a5ad35b072a58965e1d5e090dd5c5f16dc14e68c452c3e99fcbb5510"
   ],
   [
     "stackwright-pro-auth-otter.json",
-    "a19e06c503209a8a35fe321d30448623545b36b48c47a6ec064d13406ad1f725"
+    "d789b71f196659d5745ebfca87a7bda60a1bb63cfeccd17b4a273ac1e29bb08d"
   ],
   [
     "stackwright-pro-dashboard-otter.json",
-    "b3cb3d7554f2e9eed3b57d5e0e3bf85d6ba5b4db5d3af5514391cf0575fcc001"
+    "600e8597429c353e5b886f316731be84a86cd8b93617bf046e3cbf390b31a431"
   ],
   [
     "stackwright-pro-data-otter.json",
-    "bfacb87ae82867472a75982215554336a105a658d6cd3dd2c8b819fa1e11d7ac"
+    "b2946e3da3b53282c122d150e6db86b0cb89d2edba2a94a7666b26d27051be96"
   ],
   [
     "stackwright-pro-designer-otter.json",
-    "c58fa7c7ead9e6398074e1c7ce3f31a8ef4eb3679f5fa18cc03cae3a87878c88"
+    "f4dbff5149051c77be1645de5ee12c0bd7d590c687a0b2d86737b915a5a6d5f0"
   ],
   [
     "stackwright-pro-foreman-otter.json",
-    "f52264c1f6297b72f3da6d92d41b6d63356db776242caeab25571e6a8df628e4"
+    "7464523d7288374dc6efa5c213c825ec0616e00cf4f739d8039eb41df812cbc5"
   ],
   [
     "stackwright-pro-page-otter.json",
-    "65bec3a3a0dda6b7591bba2de9399f1e3a4fb99cfe1075342f4f4be98d917b67"
+    "12aca7b666b3c85c1d96c700a2da7f209604cb75d0f064995e052711ddafd657"
   ],
   [
     "stackwright-pro-theme-otter.json",
-    "1f182326f1acd3d4091a38c7012085cbb4945893e95be4ca3de72318ad092767"
+    "a303ec6c045420f2c916583e3f6efcda469e9610fedfc84a508ed8a8a75866bc"
   ],
   [
     "stackwright-pro-workflow-otter.json",
-    "0eec9d6a731678cf547c2a7b0b6fc338ca143c35501365a1e4e5dd2779dd5510"
+    "16da6c109d0b5ee60d0a14e009dbeab02a7bbac3b0947795769da053565b9821"
   ]
 ]);
 Object.freeze(_checksums);
@@ -2928,7 +3208,7 @@ function verifyOtterFile(filePath) {
   }
   let stat;
   try {
-    stat = lstatSync5(filePath);
+    stat = lstatSync6(filePath);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return { verified: false, filename, error: `Cannot stat file: ${msg}` };
@@ -2997,7 +3277,7 @@ function verifyAllOtters(otterDir) {
   for (const filename of otterFiles) {
     const filePath = join6(otterDir, filename);
     try {
-      if (lstatSync5(filePath).isSymbolicLink()) {
+      if (lstatSync6(filePath).isSymbolicLink()) {
         failed.push({ filename, error: "Skipped: symlink" });
         continue;
       }
@@ -3025,7 +3305,7 @@ function resolveOtterDir() {
   for (const relative of DEFAULT_SEARCH_PATHS) {
     const candidate = join6(cwd, relative);
     try {
-      lstatSync5(candidate);
+      lstatSync6(candidate);
       return candidate;
     } catch {
     }
@@ -3080,7 +3360,7 @@ function registerIntegrityTools(server2) {
 
 // src/tools/domain.ts
 import { z as z13 } from "zod";
-import { readFileSync as readFileSync6, existsSync as existsSync6 } from "fs";
+import { readFileSync as readFileSync6, existsSync as existsSync7 } from "fs";
 import { join as join7 } from "path";
 function handleListCollections(input) {
   const cwd = input._cwd ?? process.cwd();
@@ -3103,7 +3383,7 @@ function handleListCollections(input) {
     }
   ];
   for (const { path: path3, source, parse } of sources) {
-    if (!existsSync6(path3)) continue;
+    if (!existsSync7(path3)) continue;
     try {
       const collections = parse(readFileSync6(path3, "utf8"));
       return {
@@ -3257,7 +3537,7 @@ function handleValidateWorkflow(input) {
     raw = input.workflow;
   } else {
     const artifactPath = join7(cwd, ".stackwright", "artifacts", "workflow-config.json");
-    if (!existsSync6(artifactPath)) {
+    if (!existsSync7(artifactPath)) {
       return fail([
         {
           code: "NO_WORKFLOW",
@@ -3505,7 +3785,7 @@ var package_default = {
     "test:coverage": "vitest run --coverage"
   },
   name: "@stackwright-pro/mcp",
-  version: "0.2.0-alpha.13",
+  version: "0.2.0-alpha.22",
   description: "MCP tools for Stackwright Pro - Data Explorer, Security, ISR, and Dashboard generation",
   license: "PROPRIETARY",
   main: "./dist/server.js",