@stackwright-pro/mcp 0.2.0-alpha.40 → 0.2.0-alpha.49

package/dist/server.mjs

@@ -1378,6 +1378,25 @@ function registerQuestionTools(server2) {
         }
       }
       const adapted = adaptQuestions(resolvedQuestions, answers ?? {});
+      const labelSchema = z8.string().max(50, "Value should have at most 50 characters");
+      for (const q of adapted) {
+        for (const opt of q.options) {
+          const check = labelSchema.safeParse(opt.label);
+          if (!check.success) {
+            return {
+              content: [
+                {
+                  type: "text",
+                  text: JSON.stringify({
+                    error: `Option label for phase "${phase}" exceeds 50 characters: ${check.error.issues[0]?.message ?? "label too long"}. Truncate option labels to \u226450 characters before calling this tool.`
+                  })
+                }
+              ],
+              isError: true
+            };
+          }
+        }
+      }
       if (adapted.length === 0) {
         return {
           content: [
@@ -1873,9 +1892,350 @@ function registerOrchestrationTools(server2) {
 }
 
 // src/tools/pipeline.ts
-import { z as z10 } from "zod";
-import { readFileSync as readFileSync3, writeFileSync as writeFileSync3, existsSync as existsSync4, mkdirSync as mkdirSync3, lstatSync as lstatSync4 } from "fs";
+import { z as z11 } 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 { createHash as createHash3 } from "crypto";
+
+// src/artifact-signing.ts
+import {
+  createHash as createHash2,
+  generateKeyPairSync,
+  createPublicKey,
+  createPrivateKey,
+  sign,
+  verify,
+  timingSafeEqual
+} from "crypto";
+import {
+  readFileSync as readFileSync3,
+  writeFileSync as writeFileSync3,
+  existsSync as existsSync4,
+  mkdirSync as mkdirSync3,
+  lstatSync as lstatSync4,
+  unlinkSync,
+  readdirSync
+} from "fs";
 import { join as join3 } from "path";
+import { z as z10 } from "zod";
+var ALGORITHM = "ECDSA-P384-SHA384";
+var KEY_FILE = "pipeline-keys.json";
+var KEY_DIR = ".stackwright";
+var SIGNATURE_MANIFEST = "signatures.json";
+var ARTIFACTS_DIR = ".stackwright/artifacts";
+function rejectSymlink(filePath, context) {
+  if (!existsSync4(filePath)) return;
+  const stat = lstatSync4(filePath);
+  if (stat.isSymbolicLink()) {
+    throw new Error(`Security: refusing to follow symlink at ${context}: ${filePath}`);
+  }
+}
+function computeSha384(data) {
+  return createHash2("sha384").update(data).digest("hex");
+}
+function safeDigestEqual(a, b) {
+  if (a.length !== b.length) return false;
+  return timingSafeEqual(Buffer.from(a, "utf8"), Buffer.from(b, "utf8"));
+}
+function emptyManifest() {
+  return {
+    version: "1.0",
+    algorithm: ALGORITHM,
+    signatures: {}
+  };
+}
+function initPipelineKeys(cwd) {
+  const keyDir = join3(cwd, KEY_DIR);
+  const keyPath = join3(keyDir, KEY_FILE);
+  rejectSymlink(keyPath, "pipeline-keys.json");
+  mkdirSync3(keyDir, { recursive: true });
+  const { publicKey, privateKey } = generateKeyPairSync("ec", {
+    namedCurve: "P-384"
+  });
+  const publicKeyPem = publicKey.export({ type: "spki", format: "pem" });
+  const privateKeyPem = privateKey.export({ type: "pkcs8", format: "pem" });
+  const fingerprint = createHash2("sha256").update(publicKeyPem).digest("hex");
+  const keyFile = {
+    version: "1.0",
+    algorithm: ALGORITHM,
+    createdAt: (/* @__PURE__ */ new Date()).toISOString(),
+    publicKeyPem,
+    privateKeyPem
+  };
+  writeFileSync3(keyPath, JSON.stringify(keyFile, null, 2), { encoding: "utf-8" });
+  return { publicKeyPem, fingerprint };
+}
+function loadPipelineKeys(cwd) {
+  const keyPath = join3(cwd, KEY_DIR, KEY_FILE);
+  rejectSymlink(keyPath, "pipeline-keys.json");
+  if (!existsSync4(keyPath)) {
+    throw new Error("Pipeline keys not found \u2014 call initPipelineKeys() first");
+  }
+  let raw;
+  try {
+    raw = readFileSync3(keyPath, "utf-8");
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new Error(`Cannot read pipeline keys: ${msg}`, { cause: err });
+  }
+  let parsed;
+  try {
+    parsed = JSON.parse(raw);
+  } catch {
+    throw new Error("Pipeline keys file is not valid JSON");
+  }
+  if (typeof parsed.publicKeyPem !== "string" || !parsed.publicKeyPem.includes("-----BEGIN PUBLIC KEY-----")) {
+    throw new Error("Invalid public key PEM in pipeline keys file");
+  }
+  if (typeof parsed.privateKeyPem !== "string" || !parsed.privateKeyPem.includes("-----BEGIN")) {
+    throw new Error("Invalid private key PEM in pipeline keys file");
+  }
+  const publicKey = createPublicKey(parsed.publicKeyPem);
+  const privateKey = createPrivateKey(parsed.privateKeyPem);
+  return { privateKey, publicKey };
+}
+function signArtifact(artifactBytes, privateKey) {
+  const digest = computeSha384(artifactBytes);
+  const sig = sign("SHA384", artifactBytes, privateKey);
+  return {
+    digest,
+    signature: sig.toString("base64"),
+    algorithm: ALGORITHM,
+    signedAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+}
+function verifyArtifact(artifactBytes, signature, publicKey) {
+  const sigValid = verify(
+    "SHA384",
+    artifactBytes,
+    publicKey,
+    Buffer.from(signature.signature, "base64")
+  );
+  if (!sigValid) return false;
+  const actualDigest = computeSha384(artifactBytes);
+  return safeDigestEqual(actualDigest, signature.digest);
+}
+function loadSignatureManifest(cwd) {
+  const manifestPath = join3(cwd, ARTIFACTS_DIR, SIGNATURE_MANIFEST);
+  rejectSymlink(manifestPath, "signatures.json");
+  if (!existsSync4(manifestPath)) return emptyManifest();
+  let raw;
+  try {
+    raw = readFileSync3(manifestPath, "utf-8");
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    throw new Error(`Cannot read signature manifest: ${msg}`, { cause: err });
+  }
+  try {
+    const parsed = JSON.parse(raw);
+    if (parsed.version !== "1.0" || typeof parsed.signatures !== "object") {
+      throw new Error("Malformed signature manifest: invalid version or missing signatures object");
+    }
+    return parsed;
+  } catch (err) {
+    if (err instanceof Error && err.message.startsWith("Malformed")) throw err;
+    throw new Error("Signature manifest is not valid JSON", { cause: err });
+  }
+}
+function saveArtifactSignature(cwd, artifactFilename, sig, signerOtter) {
+  const artifactsDir = join3(cwd, ARTIFACTS_DIR);
+  const manifestPath = join3(artifactsDir, SIGNATURE_MANIFEST);
+  rejectSymlink(manifestPath, "signatures.json (save)");
+  mkdirSync3(artifactsDir, { recursive: true });
+  const manifest = loadSignatureManifest(cwd);
+  manifest.signatures[artifactFilename] = {
+    ...sig,
+    signedBy: signerOtter
+  };
+  writeFileSync3(manifestPath, JSON.stringify(manifest, null, 2), { encoding: "utf-8" });
+}
+function getArtifactSignature(cwd, artifactFilename) {
+  const manifest = loadSignatureManifest(cwd);
+  const entry = manifest.signatures[artifactFilename];
+  if (!entry) return null;
+  return {
+    digest: entry.digest,
+    signature: entry.signature,
+    algorithm: entry.algorithm,
+    signedAt: entry.signedAt
+  };
+}
+function emitSignatureAuditEvent(params) {
+  const record = JSON.stringify({
+    level: "AUDIT",
+    event: "ARTIFACT_SIGNATURE_FAIL",
+    timestamp: params.timestamp,
+    source: params.source,
+    artifactFilename: params.artifactFilename,
+    expectedDigest: params.expectedDigest,
+    actualDigest: params.actualDigest,
+    phase: params.phase
+  });
+  process.stderr.write(`ARTIFACT_SIGNATURE_FAIL ${record}
+`);
+}
+function registerArtifactSigningTools(server2) {
+  server2.tool(
+    "stackwright_pro_verify_artifact_signatures",
+    "Verify ECDSA P-384 signatures for all pipeline artifacts in .stackwright/artifacts/. Auto-discovers keys from .stackwright/pipeline-keys.json. Returns per-artifact verification status.",
+    {
+      cwd: z10.string().optional().describe("Project root directory. Defaults to process.cwd().")
+    },
+    async ({ cwd: cwdParam }) => {
+      const cwd = cwdParam ?? process.cwd();
+      let publicKey;
+      try {
+        const keys = loadPipelineKeys(cwd);
+        publicKey = keys.publicKey;
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                error: true,
+                message: `Cannot load pipeline keys: ${msg}`
+              })
+            }
+          ],
+          isError: true
+        };
+      }
+      let manifest;
+      try {
+        manifest = loadSignatureManifest(cwd);
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                error: true,
+                message: `Cannot load signature manifest: ${msg}`
+              })
+            }
+          ],
+          isError: true
+        };
+      }
+      const artifactsPath = join3(cwd, ARTIFACTS_DIR);
+      let artifactFiles = [];
+      try {
+        if (existsSync4(artifactsPath)) {
+          artifactFiles = readdirSync(artifactsPath).filter(
+            (f) => f.endsWith(".json") && f !== SIGNATURE_MANIFEST
+          );
+        }
+      } catch {
+      }
+      const results = [];
+      let hasFailure = false;
+      for (const filename of artifactFiles) {
+        const filePath = join3(artifactsPath, filename);
+        try {
+          rejectSymlink(filePath, `artifact ${filename}`);
+        } catch {
+          results.push({
+            filename,
+            verified: false,
+            error: "Refusing to verify symlink"
+          });
+          hasFailure = true;
+          continue;
+        }
+        let artifactBytes;
+        try {
+          artifactBytes = readFileSync3(filePath);
+        } catch (err) {
+          const msg = err instanceof Error ? err.message : String(err);
+          results.push({
+            filename,
+            verified: false,
+            error: `Cannot read artifact: ${msg}`
+          });
+          hasFailure = true;
+          continue;
+        }
+        const entry = manifest.signatures[filename];
+        if (!entry) {
+          results.push({
+            filename,
+            verified: false,
+            error: "No signature found in manifest"
+          });
+          hasFailure = true;
+          continue;
+        }
+        const sig = {
+          digest: entry.digest,
+          signature: entry.signature,
+          algorithm: entry.algorithm,
+          signedAt: entry.signedAt
+        };
+        const verified = verifyArtifact(artifactBytes, sig, publicKey);
+        if (!verified) {
+          const actualDigest = computeSha384(artifactBytes);
+          emitSignatureAuditEvent({
+            artifactFilename: filename,
+            expectedDigest: sig.digest,
+            actualDigest,
+            phase: entry.signedBy ?? "unknown",
+            timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+            source: "stackwright_pro_verify_artifact_signatures"
+          });
+          results.push({
+            filename,
+            verified: false,
+            error: `Signature verification failed \u2014 artifact may have been tampered with`,
+            signedBy: entry.signedBy,
+            signedAt: entry.signedAt
+          });
+          hasFailure = true;
+        } else {
+          results.push({
+            filename,
+            verified: true,
+            signedBy: entry.signedBy,
+            signedAt: entry.signedAt
+          });
+        }
+      }
+      for (const manifestFilename of Object.keys(manifest.signatures)) {
+        if (!artifactFiles.includes(manifestFilename)) {
+          results.push({
+            filename: manifestFilename,
+            verified: false,
+            error: "Artifact referenced in manifest but missing from disk"
+          });
+          hasFailure = true;
+        }
+      }
+      const verifiedCount = results.filter((r) => r.verified).length;
+      const failedCount = results.filter((r) => !r.verified).length;
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              totalArtifacts: artifactFiles.length,
+              verifiedCount,
+              failedCount,
+              results,
+              ...hasFailure ? {
+                error: "SIGNATURE VERIFICATION FAILED: One or more artifact signatures are invalid. Do not proceed \u2014 artifacts may have been tampered with."
+              } : {}
+            })
+          }
+        ],
+        isError: hasFailure
+      };
+    }
+  );
+}
+
+// src/tools/pipeline.ts
 import { WorkflowFileSchema, authConfigSchema } from "@stackwright-pro/types";
 var PHASE_ORDER = [
   "designer",
@@ -1951,11 +2311,11 @@ function createDefaultState() {
   };
 }
 function statePath(cwd) {
-  return join3(cwd, ".stackwright", "pipeline-state.json");
+  return join4(cwd, ".stackwright", "pipeline-state.json");
 }
 function readState(cwd) {
   const p = statePath(cwd);
-  if (!existsSync4(p)) return createDefaultState();
+  if (!existsSync5(p)) return createDefaultState();
   const raw = JSON.parse(safeReadSync(p));
   if (typeof raw !== "object" || raw === null || raw.version !== "1.0") {
     return createDefaultState();
@@ -1963,26 +2323,26 @@ function readState(cwd) {
   return raw;
 }
 function safeWriteSync(filePath, content) {
-  if (existsSync4(filePath)) {
-    const stat = lstatSync4(filePath);
+  if (existsSync5(filePath)) {
+    const stat = lstatSync5(filePath);
     if (stat.isSymbolicLink()) {
       throw new Error(`Refusing to write to symlink: ${filePath}`);
     }
   }
-  writeFileSync3(filePath, content);
+  writeFileSync4(filePath, content);
 }
 function safeReadSync(filePath) {
-  if (existsSync4(filePath)) {
-    const stat = lstatSync4(filePath);
+  if (existsSync5(filePath)) {
+    const stat = lstatSync5(filePath);
     if (stat.isSymbolicLink()) {
       throw new Error(`Refusing to read symlink: ${filePath}`);
     }
   }
-  return readFileSync3(filePath, "utf-8");
+  return readFileSync4(filePath, "utf-8");
 }
 function writeState(cwd, state) {
-  const dir = join3(cwd, ".stackwright");
-  mkdirSync3(dir, { recursive: true });
+  const dir = join4(cwd, ".stackwright");
+  mkdirSync4(dir, { recursive: true });
   state.updatedAt = (/* @__PURE__ */ new Date()).toISOString();
   safeWriteSync(statePath(cwd), JSON.stringify(state, null, 2) + "\n");
 }
@@ -2003,6 +2363,15 @@ function handleGetPipelineState(_cwd) {
   const cwd = _cwd ?? process.cwd();
   try {
     const state = readState(cwd);
+    const keyPath = join4(cwd, ".stackwright", "pipeline-keys.json");
+    if (!existsSync5(keyPath)) {
+      try {
+        const { fingerprint } = initPipelineKeys(cwd);
+        state["signingKeyFingerprint"] = fingerprint;
+        writeState(cwd, state);
+      } catch {
+      }
+    }
     return { text: JSON.stringify(state), isError: false };
   } catch (err) {
     return { text: JSON.stringify({ error: true, message: String(err) }), isError: true };
@@ -2066,8 +2435,8 @@ function handleCheckExecutionReady(_cwd, phase) {
         isError: true
       };
     }
-    const answerFile = join3(cwd, ".stackwright", "answers", `${phase}.json`);
-    if (!existsSync4(answerFile)) {
+    const answerFile = join4(cwd, ".stackwright", "answers", `${phase}.json`);
+    if (!existsSync5(answerFile)) {
       return {
         text: JSON.stringify({ ready: false, phase, reason: "Answer file not found" }),
         isError: false
@@ -2091,12 +2460,12 @@ function handleCheckExecutionReady(_cwd, phase) {
     }
   }
   try {
-    const answersDir = join3(cwd, ".stackwright", "answers");
+    const answersDir = join4(cwd, ".stackwright", "answers");
     const answeredPhases = [];
     const missingPhases = [];
     for (const phase2 of PHASE_ORDER) {
-      const answerFile = join3(answersDir, `${phase2}.json`);
-      if (existsSync4(answerFile)) {
+      const answerFile = join4(answersDir, `${phase2}.json`);
+      if (existsSync5(answerFile)) {
         try {
           const raw = safeReadSync(answerFile);
           const parsed = JSON.parse(raw);
@@ -2128,15 +2497,35 @@ function handleCheckExecutionReady(_cwd, phase) {
 function handleListArtifacts(_cwd) {
   const cwd = _cwd ?? process.cwd();
   try {
-    const artifactsDir = join3(cwd, ".stackwright", "artifacts");
+    const artifactsDir = join4(cwd, ".stackwright", "artifacts");
+    let manifest = null;
+    try {
+      manifest = loadSignatureManifest(cwd);
+    } catch {
+    }
     const artifacts = [];
     let completedCount = 0;
     for (const phase of PHASE_ORDER) {
       const expectedFile = PHASE_ARTIFACT[phase];
-      const fullPath = join3(artifactsDir, expectedFile);
-      const exists = existsSync4(fullPath);
+      const fullPath = join4(artifactsDir, expectedFile);
+      const exists = existsSync5(fullPath);
       if (exists) completedCount++;
-      artifacts.push({ phase, expectedFile, exists, path: fullPath });
+      let signed = false;
+      let signatureValid = null;
+      if (exists && manifest) {
+        const entry = manifest.signatures[expectedFile];
+        if (entry) {
+          signed = true;
+          try {
+            const rawBytes = Buffer.from(safeReadSync(fullPath), "utf-8");
+            const { publicKey } = loadPipelineKeys(cwd);
+            signatureValid = verifyArtifact(rawBytes, entry, publicKey);
+          } catch {
+            signatureValid = null;
+          }
+        }
+      }
+      artifacts.push({ phase, expectedFile, exists, path: fullPath, signed, signatureValid });
     }
     return {
       text: JSON.stringify({ artifacts, completedCount, totalCount: PHASE_ORDER.length }),
@@ -2172,9 +2561,9 @@ function handleWritePhaseQuestions(input) {
       }
     } catch {
     }
-    const questionsDir = join3(cwd, ".stackwright", "questions");
-    mkdirSync3(questionsDir, { recursive: true });
-    const filePath = join3(questionsDir, `${phase}.json`);
+    const questionsDir = join4(cwd, ".stackwright", "questions");
+    mkdirSync4(questionsDir, { recursive: true });
+    const filePath = join4(questionsDir, `${phase}.json`);
     const payload = {
       version: "1.0",
       phase,
@@ -2214,14 +2603,14 @@ function handleBuildSpecialistPrompt(input) {
     };
   }
   try {
-    const answersPath = join3(cwd, ".stackwright", "answers", `${phase}.json`);
+    const answersPath = join4(cwd, ".stackwright", "answers", `${phase}.json`);
     let answers = {};
-    if (existsSync4(answersPath)) {
+    if (existsSync5(answersPath)) {
       answers = JSON.parse(safeReadSync(answersPath));
     }
     let buildContextText = "";
-    const buildContextPath = join3(cwd, ".stackwright", "build-context.json");
-    if (existsSync4(buildContextPath)) {
+    const buildContextPath = join4(cwd, ".stackwright", "build-context.json");
+    if (existsSync5(buildContextPath)) {
       try {
         const bcRaw = JSON.parse(safeReadSync(buildContextPath));
         if (typeof bcRaw.buildContext === "string" && bcRaw.buildContext.trim().length > 0) {
@@ -2235,9 +2624,39 @@ function handleBuildSpecialistPrompt(input) {
     const missingDependencies = [];
     for (const dep of deps) {
       const artifactFile = PHASE_ARTIFACT[dep];
-      const artifactPath = join3(cwd, ".stackwright", "artifacts", artifactFile);
-      if (existsSync4(artifactPath)) {
-        const content = JSON.parse(safeReadSync(artifactPath));
+      const artifactPath = join4(cwd, ".stackwright", "artifacts", artifactFile);
+      if (existsSync5(artifactPath)) {
+        const rawContent = safeReadSync(artifactPath);
+        const rawBytes = Buffer.from(rawContent, "utf-8");
+        const content = JSON.parse(rawContent);
+        let signatureVerified = false;
+        let signatureAvailable = false;
+        try {
+          const sig = getArtifactSignature(cwd, artifactFile);
+          if (sig) {
+            signatureAvailable = true;
+            const { publicKey } = loadPipelineKeys(cwd);
+            signatureVerified = verifyArtifact(rawBytes, sig, publicKey);
+            if (!signatureVerified) {
+              const actualDigest = createHash3("sha384").update(rawBytes).digest("hex");
+              emitSignatureAuditEvent({
+                artifactFilename: artifactFile,
+                expectedDigest: sig.digest,
+                actualDigest,
+                phase: dep,
+                timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+                source: "stackwright_pro_build_specialist_prompt"
+              });
+              missingDependencies.push(dep);
+              artifactSections.push(
+                `[${artifactFile}]:
+(integrity check failed: ECDSA-P384 signature verification failed \u2014 artifact may have been tampered with)`
+              );
+              continue;
+            }
+          }
+        } catch {
+        }
         const expectedOtter = PHASE_TO_OTTER2[dep];
         const artifactOtter = content["generatedBy"];
         const normalizedOtter = artifactOtter?.replace(/-[a-f0-9]{6}$/, "");
@@ -2254,8 +2673,11 @@ function handleBuildSpecialistPrompt(input) {
 (integrity check failed: artifact claims generatedBy="${artifactOtter}" but expected="${expectedOtter}")`
           );
         } else {
-          artifactSections.push(`[${artifactFile}]:
-${JSON.stringify(content, null, 2)}`);
+          const sigStatus = signatureAvailable ? signatureVerified ? " [signature verified]" : " [signature check skipped]" : " [unsigned]";
+          artifactSections.push(
+            `[${artifactFile}]${sigStatus}:
+${JSON.stringify(content, null, 2)}`
+          );
         }
       } else {
         missingDependencies.push(dep);
@@ -2271,6 +2693,9 @@ ${JSON.stringify(content, null, 2)}`);
     if (artifactSections.length > 0) {
       parts.push("", "UPSTREAM ARTIFACTS:", "", ...artifactSections);
     }
+    const artifactSchema = PHASE_ARTIFACT_SCHEMA[phase];
+    parts.push("", "REQUIRED_ARTIFACT_SCHEMA:");
+    parts.push(artifactSchema);
     parts.push("", "Execute using these answers and the upstream artifacts provided.");
     const prompt = parts.join("\n");
     const dependenciesSatisfied = missingDependencies.length === 0;
@@ -2312,6 +2737,187 @@ var PHASE_REQUIRED_KEYS = {
   dashboard: ["version", "generatedBy"],
   workflow: ["version", "generatedBy"]
 };
+var PHASE_ARTIFACT_SCHEMA = {
+  designer: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-designer-otter",
+      application: {
+        type: "<operational|data-explorer|admin|logistics|general>",
+        environment: "<workstation|field|control-room|mixed>",
+        density: "<compact|balanced|spacious>",
+        accessibility: "<wcag-aa|section-508|none>",
+        colorScheme: "<light|dark|both>"
+      },
+      designLanguage: {
+        rationale: "<design rationale>",
+        spacingScale: { base: 8, scale: [0, 4, 8, 16, 24, 32, 48, 64] },
+        colorSemantics: { primary: "#1a365d", accent: "#e53e3e" },
+        typography: {
+          dataFont: "Inter",
+          headingFont: "Inter",
+          monoFont: "monospace",
+          dataSizePx: 12,
+          bodySizePx: 14
+        },
+        contrastRatio: "4.5",
+        borderRadius: "4",
+        shadowElevation: "standard"
+      },
+      themeTokenSeeds: {
+        light: {
+          background: "#ffffff",
+          foreground: "#1a1a1a",
+          primary: "#1a365d",
+          surface: "#f7f7f7",
+          border: "#e2e8f0"
+        },
+        dark: {
+          background: "#1a1a1a",
+          foreground: "#ffffff",
+          primary: "#90cdf4",
+          surface: "#2d2d2d",
+          border: "#4a5568"
+        }
+      },
+      conformsTo: null,
+      operationalNotes: []
+    },
+    null,
+    2
+  ),
+  theme: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-theme-otter",
+      componentLibrary: "shadcn",
+      colorScheme: "<light|dark|both>",
+      tokens: {
+        colors: { "primary-500": "#1a365d", background: "#ffffff" },
+        spacing: { "spacing-1": "8px", "spacing-2": "16px" },
+        typography: { "font-data": "Inter", "text-sm": "12px" },
+        shape: { "radius-sm": "4px", "radius-md": "8px" },
+        shadows: { "shadow-sm": "0 1px 2px rgba(0,0,0,0.08)" }
+      },
+      cssVariables: {
+        "--background": "0 0% 100%",
+        "--foreground": "222.2 84% 4.9%",
+        "--primary": "222.2 47.4% 11.2%",
+        "--primary-foreground": "210 40% 98%",
+        "--surface": "210 40% 98%",
+        "--border": "214.3 31.8% 91.4%"
+      },
+      dark: { "--background": "222.2 84% 4.9%", "--foreground": "210 40% 98%" }
+    },
+    null,
+    2
+  ),
+  api: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-api-otter",
+      entities: [
+        {
+          name: "Shipment",
+          endpoint: "/shipments",
+          method: "GET",
+          revalidate: 60,
+          mutationType: null
+        }
+      ],
+      auth: { type: "bearer", header: "Authorization", envVar: "API_TOKEN" },
+      baseUrl: "https://api.example.mil/v2",
+      specPath: "./specs/api.yaml"
+    },
+    null,
+    2
+  ),
+  data: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-data-otter",
+      strategy: "<pulse-fast|isr-fast|isr-standard|isr-slow>",
+      pulseMode: false,
+      collections: [{ name: "equipment", revalidate: 60, pulse: false }],
+      endpoints: { included: ["/equipment/**"], excluded: ["/admin/**"] },
+      requiredPackages: { dependencies: {}, devPackages: {} }
+    },
+    null,
+    2
+  ),
+  workflow: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-workflow-otter",
+      workflowConfig: {
+        id: "procurement-approval",
+        route: "/procurement",
+        files: ["workflows/procurement-approval.yml"],
+        serviceDependencies: ["service:workflow-state"],
+        warnings: []
+      }
+    },
+    null,
+    2
+  ),
+  pages: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-page-otter",
+      pages: [
+        {
+          slug: "catalog",
+          type: "collection_listing",
+          collection: "products",
+          themeApplied: true,
+          authRequired: false
+        },
+        {
+          slug: "admin",
+          type: "protected",
+          collection: null,
+          themeApplied: true,
+          authRequired: true
+        }
+      ]
+    },
+    null,
+    2
+  ),
+  dashboard: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-dashboard-otter",
+      pages: [
+        {
+          slug: "dashboard",
+          layout: "<grid|table|mixed>",
+          collections: ["equipment", "supplies"],
+          mode: "<ISR|Pulse>"
+        }
+      ]
+    },
+    null,
+    2
+  ),
+  auth: JSON.stringify(
+    {
+      version: "1.0",
+      generatedBy: "stackwright-pro-auth-otter",
+      authConfig: {
+        method: "<cac|oidc|oauth2|none>",
+        provider: "<azure-ad|okta|ping|cognito \u2014 if OIDC, else null>",
+        rbacRoles: ["ADMIN", "ANALYST"],
+        rbacDefaultRole: "ANALYST",
+        protectedRoutes: ["/dashboard/:path*", "/procurement/:path*"],
+        auditEnabled: true,
+        auditRetentionDays: 90
+      }
+    },
+    null,
+    2
+  )
+};
 function handleValidateArtifact(input) {
   const cwd = input._cwd ?? process.cwd();
   const { phase, responseText, artifact: directArtifact } = input;
@@ -2405,11 +3011,22 @@ function handleValidateArtifact(input) {
     }
   }
   try {
-    const artifactsDir = join3(cwd, ".stackwright", "artifacts");
-    mkdirSync3(artifactsDir, { recursive: true });
+    const artifactsDir = join4(cwd, ".stackwright", "artifacts");
+    mkdirSync4(artifactsDir, { recursive: true });
     const artifactFile = PHASE_ARTIFACT[phase];
-    const artifactPath = join3(artifactsDir, artifactFile);
-    safeWriteSync(artifactPath, JSON.stringify(artifact, null, 2) + "\n");
+    const artifactPath = join4(artifactsDir, artifactFile);
+    const serialized = JSON.stringify(artifact, null, 2) + "\n";
+    const artifactBytes = Buffer.from(serialized, "utf-8");
+    safeWriteSync(artifactPath, serialized);
+    let signed = false;
+    try {
+      const { privateKey } = loadPipelineKeys(cwd);
+      const sig = signArtifact(artifactBytes, privateKey);
+      const signerOtter = PHASE_TO_OTTER2[phase];
+      saveArtifactSignature(cwd, artifactFile, sig, signerOtter);
+      signed = true;
+    } catch {
+    }
     const state = readState(cwd);
     if (!state.phases[phase]) state.phases[phase] = defaultPhaseStatus();
     const ps = state.phases[phase];
@@ -2420,7 +3037,7 @@ function handleValidateArtifact(input) {
       valid: true,
       phase,
       artifactPath,
-      summary: `Wrote ${artifactFile} (keys: ${topKeys}${Object.keys(artifact).length > 5 ? ", ..." : ""})`
+      summary: `Wrote ${artifactFile} (keys: ${topKeys}${Object.keys(artifact).length > 5 ? ", ..." : ""})${signed ? " [signed]" : ""}`
     };
     return { text: JSON.stringify(result), isError: false };
   } catch (err) {
@@ -2444,13 +3061,13 @@ function registerPipelineTools(server2) {
     "stackwright_pro_set_pipeline_state",
     `Atomic read\u2192modify\u2192write pipeline state. ${DESC}`,
     {
-      phase: z10.string().optional().describe('Phase to update, e.g. "designer"'),
-      field: z10.enum(["questionsCollected", "answered", "executed", "artifactWritten"]).optional().describe("Boolean field to set"),
-      value: boolCoerce(z10.boolean().optional()).describe(
+      phase: z11.string().optional().describe('Phase to update, e.g. "designer"'),
+      field: z11.enum(["questionsCollected", "answered", "executed", "artifactWritten"]).optional().describe("Boolean field to set"),
+      value: boolCoerce(z11.boolean().optional()).describe(
         'Value for the field \u2014 must be a JSON boolean (true/false), NOT the string "true"/"false"'
       ),
-      status: z10.enum(["setup", "questions", "execution", "done"]).optional().describe("Top-level status override"),
-      incrementRetry: boolCoerce(z10.boolean().optional()).describe(
+      status: z11.enum(["setup", "questions", "execution", "done"]).optional().describe("Top-level status override"),
+      incrementRetry: boolCoerce(z11.boolean().optional()).describe(
         "Bump retryCount by 1 \u2014 must be a JSON boolean"
       )
     },
@@ -2468,7 +3085,7 @@ function registerPipelineTools(server2) {
     "stackwright_pro_check_execution_ready",
     `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.")
+      phase: z11.string().optional().describe("If provided, check only this phase's readiness. Omit to check all phases.")
     },
     async ({ phase }) => res(handleCheckExecutionReady(void 0, phase))
   );
@@ -2482,9 +3099,9 @@ function registerPipelineTools(server2) {
     "stackwright_pro_write_phase_questions",
     `Parse otter question-collection response \u2192 .stackwright/questions/{phase}.json. Specialists may also call this directly with a parsed questions array. ${DESC}`,
     {
-      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(
+      phase: z11.string().optional().describe('Phase name, e.g. "designer" (required for direct write)'),
+      responseText: z11.string().optional().describe("Raw LLM response from QUESTION_COLLECTION_MODE"),
+      questions: jsonCoerce(z11.array(z11.any()).optional()).describe(
         "Questions array for direct specialist write"
       )
     },
@@ -2499,10 +3116,10 @@ function registerPipelineTools(server2) {
             isError: true
           };
         }
-        const questionsDir = join3(process.cwd(), ".stackwright", "questions");
-        mkdirSync3(questionsDir, { recursive: true });
-        const outPath = join3(questionsDir, `${phase}.json`);
-        writeFileSync3(
+        const questionsDir = join4(process.cwd(), ".stackwright", "questions");
+        mkdirSync4(questionsDir, { recursive: true });
+        const outPath = join4(questionsDir, `${phase}.json`);
+        writeFileSync4(
           outPath,
           JSON.stringify({ phase, questions, writtenAt: (/* @__PURE__ */ new Date()).toISOString() }, null, 2)
         );
@@ -2527,16 +3144,16 @@ function registerPipelineTools(server2) {
   server2.tool(
     "stackwright_pro_build_specialist_prompt",
     `Assemble execution prompt from answers + upstream artifacts. Foreman passes verbatim. ${DESC}`,
-    { phase: z10.string().describe('Phase to build prompt for, e.g. "pages"') },
+    { phase: z11.string().describe('Phase to build prompt for, e.g. "pages"') },
     async ({ phase }) => res(handleBuildSpecialistPrompt({ phase }))
   );
   server2.tool(
     "stackwright_pro_validate_artifact",
     `Validate and write artifact to .stackwright/artifacts/. Returns retryPrompt on failure. ${DESC}`,
     {
-      phase: z10.string().describe('Phase that produced this artifact, e.g. "designer"'),
-      responseText: z10.string().optional().describe("Raw response text from the specialist otter (Foreman-mediated path, legacy)"),
-      artifact: z10.record(z10.unknown()).optional().describe(
+      phase: z11.string().describe('Phase that produced this artifact, e.g. "designer"'),
+      responseText: z11.string().optional().describe("Raw response text from the specialist otter (Foreman-mediated path, legacy)"),
+      artifact: jsonCoerce(z11.record(z11.string(), z11.unknown()).optional()).describe(
         "Artifact object to validate and write directly (specialist direct path \u2014 skips off-script detection and JSON parsing)"
       )
     },
@@ -2552,9 +3169,9 @@ function registerPipelineTools(server2) {
 }
 
 // src/tools/safe-write.ts
-import { z as z11 } from "zod";
-import { writeFileSync as writeFileSync4, existsSync as existsSync5, mkdirSync as mkdirSync4, lstatSync as lstatSync5 } from "fs";
-import { normalize, isAbsolute, dirname, join as join4 } from "path";
+import { z as z12 } from "zod";
+import { writeFileSync as writeFileSync5, existsSync as existsSync6, mkdirSync as mkdirSync5, lstatSync as lstatSync6 } from "fs";
+import { normalize, isAbsolute, dirname, join as join5 } from "path";
 var OTTER_WRITE_ALLOWLISTS = {
   "stackwright-pro-designer-otter": [
     { prefix: ".stackwright/artifacts/", suffix: ".json", description: "Design language artifact" }
@@ -2597,9 +3214,25 @@ var OTTER_WRITE_ALLOWLISTS = {
 };
 var PROTECTED_PATH_PREFIXES = [
   ".stackwright/pipeline-state.json",
+  ".stackwright/pipeline-keys.json",
+  // ephemeral signing keys
+  ".stackwright/artifacts/signatures.json",
+  // artifact signature manifest
   ".stackwright/questions/",
   ".stackwright/answers/"
 ];
+var MAX_SAFE_WRITE_BYTES_JSON = 512 * 1024;
+var MAX_SAFE_WRITE_BYTES_YAML = 256 * 1024;
+var MAX_SAFE_WRITE_BYTES_ENV = 4 * 1024;
+var MAX_SAFE_WRITE_BYTES_DEFAULT = 256 * 1024;
+function getMaxBytesForPath(filePath) {
+  if (filePath.endsWith(".json")) return { limit: MAX_SAFE_WRITE_BYTES_JSON, label: "JSON" };
+  if (filePath.endsWith(".yml") || filePath.endsWith(".yaml"))
+    return { limit: MAX_SAFE_WRITE_BYTES_YAML, label: "YAML" };
+  if (filePath === ".env" || /^\.env\.[a-zA-Z0-9]+/.test(filePath))
+    return { limit: MAX_SAFE_WRITE_BYTES_ENV, label: "env" };
+  return { limit: MAX_SAFE_WRITE_BYTES_DEFAULT, label: "default" };
+}
 function checkPathAllowed(callerOtter, filePath) {
   const normalized = normalize(filePath);
   if (normalized.includes("..")) {
@@ -2725,11 +3358,23 @@ function handleSafeWrite(input) {
     };
     return { text: JSON.stringify(result), isError: true };
   }
+  const contentBytes = Buffer.byteLength(content, "utf-8");
+  const { limit: maxBytes, label: fileTypeLabel } = getMaxBytesForPath(filePath);
+  if (contentBytes > maxBytes) {
+    const result = {
+      success: false,
+      error: `Content size ${contentBytes} bytes exceeds ${fileTypeLabel} limit of ${maxBytes} bytes (${maxBytes / 1024} KB)`,
+      callerOtter,
+      attemptedPath: filePath,
+      allowedPaths: []
+    };
+    return { text: JSON.stringify(result), isError: true };
+  }
   const normalized = normalize(filePath);
-  const fullPath = join4(cwd, normalized);
-  if (existsSync5(fullPath)) {
+  const fullPath = join5(cwd, normalized);
+  if (existsSync6(fullPath)) {
     try {
-      const stat = lstatSync5(fullPath);
+      const stat = lstatSync6(fullPath);
       if (stat.isSymbolicLink()) {
         const result = {
           success: false,
@@ -2756,9 +3401,9 @@ function handleSafeWrite(input) {
   }
   try {
     if (createDirectories) {
-      mkdirSync4(dirname(fullPath), { recursive: true });
+      mkdirSync5(dirname(fullPath), { recursive: true });
     }
-    writeFileSync4(fullPath, content, { encoding: "utf-8" });
+    writeFileSync5(fullPath, content, { encoding: "utf-8" });
     const result = {
       success: true,
       path: normalized,
@@ -2784,10 +3429,10 @@ function registerSafeWriteTools(server2) {
     "stackwright_pro_safe_write",
     DESC,
     {
-      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: boolCoerce(z11.boolean().optional().default(true)).describe(
+      callerOtter: z12.string().describe('The otter agent name requesting the write, e.g. "stackwright-pro-page-otter"'),
+      filePath: z12.string().describe('Relative path from project root, e.g. "pages/dashboard/content.yml"'),
+      content: z12.string().describe("File content to write"),
+      createDirectories: boolCoerce(z12.boolean().optional().default(true)).describe(
         "Create parent directories if they don't exist. Default: true"
       )
     },
@@ -2804,9 +3449,9 @@ function registerSafeWriteTools(server2) {
 }
 
 // src/tools/auth.ts
-import { z as z12 } from "zod";
-import { readFileSync as readFileSync4, writeFileSync as writeFileSync5, existsSync as existsSync6 } from "fs";
-import { join as join5 } from "path";
+import { z as z13 } from "zod";
+import { readFileSync as readFileSync5, writeFileSync as writeFileSync6, existsSync as existsSync7 } from "fs";
+import { join as join6 } from "path";
 function buildHierarchy(roles) {
   const h = {};
   for (let i = 0; i < roles.length - 1; i++) {
@@ -3068,7 +3713,7 @@ async function configureAuthHandler(params, cwd) {
       auditRetentionDays,
       protectedRoutes
     );
-    writeFileSync5(join5(cwd, "middleware.ts"), middlewareContent, "utf8");
+    writeFileSync6(join6(cwd, "middleware.ts"), middlewareContent, "utf8");
     filesWritten.push("middleware.ts");
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
@@ -3084,12 +3729,12 @@ async function configureAuthHandler(params, cwd) {
   }
   try {
     const envBlock = generateEnvBlock(method, params);
-    const envPath = join5(cwd, ".env.example");
-    if (existsSync6(envPath)) {
-      const existing = readFileSync4(envPath, "utf8");
-      writeFileSync5(envPath, existing.trimEnd() + "\n\n" + envBlock, "utf8");
+    const envPath = join6(cwd, ".env.example");
+    if (existsSync7(envPath)) {
+      const existing = readFileSync5(envPath, "utf8");
+      writeFileSync6(envPath, existing.trimEnd() + "\n\n" + envBlock, "utf8");
     } else {
-      writeFileSync5(envPath, envBlock, "utf8");
+      writeFileSync6(envPath, envBlock, "utf8");
     }
     filesWritten.push(".env.example");
   } catch (err) {
@@ -3115,12 +3760,12 @@ async function configureAuthHandler(params, cwd) {
       auditRetentionDays,
       protectedRoutes
     );
-    const ymlPath = join5(cwd, "stackwright.yml");
-    if (!existsSync6(ymlPath)) {
-      writeFileSync5(ymlPath, authYaml, "utf8");
+    const ymlPath = join6(cwd, "stackwright.yml");
+    if (!existsSync7(ymlPath)) {
+      writeFileSync6(ymlPath, authYaml, "utf8");
     } else {
-      const existing = readFileSync4(ymlPath, "utf8");
-      writeFileSync5(ymlPath, upsertAuthBlock(existing, authYaml), "utf8");
+      const existing = readFileSync5(ymlPath, "utf8");
+      writeFileSync6(ymlPath, upsertAuthBlock(existing, authYaml), "utf8");
     }
     filesWritten.push("stackwright.yml");
   } catch (err) {
@@ -3159,35 +3804,35 @@ function registerAuthTools(server2) {
     "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.",
     {
-      method: z12.enum(["cac", "oidc", "oauth2", "none"]),
-      provider: z12.enum(["azure-ad", "okta", "ping", "cognito", "custom"]).optional(),
+      method: z13.enum(["cac", "oidc", "oauth2", "none"]),
+      provider: z13.enum(["azure-ad", "okta", "ping", "cognito", "custom"]).optional(),
       // CAC
-      cacCaBundle: z12.string().optional(),
-      cacEdipiLookup: z12.string().optional(),
-      cacOcspEndpoint: z12.string().optional(),
-      cacCertHeader: z12.string().optional(),
+      cacCaBundle: z13.string().optional(),
+      cacEdipiLookup: z13.string().optional(),
+      cacOcspEndpoint: z13.string().optional(),
+      cacCertHeader: z13.string().optional(),
       // OIDC
-      oidcDiscoveryUrl: z12.string().optional(),
-      oidcClientId: z12.string().optional(),
-      oidcClientSecret: z12.string().optional(),
-      oidcScopes: z12.string().optional(),
-      oidcRoleClaim: z12.string().optional(),
+      oidcDiscoveryUrl: z13.string().optional(),
+      oidcClientId: z13.string().optional(),
+      oidcClientSecret: z13.string().optional(),
+      oidcScopes: z13.string().optional(),
+      oidcRoleClaim: z13.string().optional(),
       // OAuth2
-      oauth2AuthUrl: z12.string().optional(),
-      oauth2TokenUrl: z12.string().optional(),
-      oauth2ClientId: z12.string().optional(),
-      oauth2ClientSecret: z12.string().optional(),
-      oauth2Scopes: z12.string().optional(),
+      oauth2AuthUrl: z13.string().optional(),
+      oauth2TokenUrl: z13.string().optional(),
+      oauth2ClientId: z13.string().optional(),
+      oauth2ClientSecret: z13.string().optional(),
+      oauth2Scopes: z13.string().optional(),
       // RBAC
-      rbacRoles: jsonCoerce(z12.array(z12.string()).optional()),
-      rbacDefaultRole: z12.string().optional(),
+      rbacRoles: jsonCoerce(z13.array(z13.string()).optional()),
+      rbacDefaultRole: z13.string().optional(),
       // Audit
-      auditEnabled: boolCoerce(z12.boolean().optional()),
-      auditRetentionDays: numCoerce(z12.number().int().positive().optional()),
+      auditEnabled: boolCoerce(z13.boolean().optional()),
+      auditRetentionDays: numCoerce(z13.number().int().positive().optional()),
       // Routes
-      protectedRoutes: jsonCoerce(z12.array(z12.string()).optional()),
+      protectedRoutes: jsonCoerce(z13.array(z13.string()).optional()),
       // Injection for tests
-      _cwd: z12.string().optional()
+      _cwd: z13.string().optional()
     },
     async (params) => {
       const cwd = params._cwd ?? process.cwd();
@@ -3197,13 +3842,13 @@ function registerAuthTools(server2) {
 }
 
 // src/integrity.ts
-import { createHash as createHash2, timingSafeEqual } from "crypto";
-import { readFileSync as readFileSync5, readdirSync, lstatSync as lstatSync6 } from "fs";
-import { join as join6, basename } from "path";
+import { createHash as createHash4, timingSafeEqual as timingSafeEqual2 } from "crypto";
+import { readFileSync as readFileSync6, readdirSync as readdirSync2, lstatSync as lstatSync7 } from "fs";
+import { join as join7, basename } from "path";
 var _checksums = /* @__PURE__ */ new Map([
   [
     "stackwright-pro-api-otter.json",
-    "1fd28747ff43121533d40d6446f2d2670d6247afb04e3025cbbcb9ace0e7d1e2"
+    "ed667124af3f025e090c0e65d0a86f0ef08fea06c0029b8fd0edf6df33df9f9c"
   ],
   [
     "stackwright-pro-auth-otter.json",
@@ -3211,7 +3856,7 @@ var _checksums = /* @__PURE__ */ new Map([
   ],
   [
     "stackwright-pro-dashboard-otter.json",
-    "a9e50f26e8b2b687910685f15104b4e76a74ad2e1e5a6021237e1eeb1cbde2ae"
+    "5e930b4092b9002e3c1a413b36418e49c865199af12a546890ccf7f9e56a5593"
   ],
   [
     "stackwright-pro-data-otter.json",
@@ -3219,11 +3864,11 @@ var _checksums = /* @__PURE__ */ new Map([
   ],
   [
     "stackwright-pro-designer-otter.json",
-    "41c5b6b9f1f0f6eb0851e473f9d7d6ebd6a7e00dafd5cdeb8a8b12b0b756e245"
+    "e80d4e7bab87d8647debadb238a58aac498ec5074ff25b21abd3b13ff778bf71"
   ],
   [
     "stackwright-pro-foreman-otter.json",
-    "7c8af9ce5b157ad3030f0255218a6ea923df18a36fe44db9bd5f04897434fc05"
+    "02dd2485562361f2f3cfd998981349020d7599dcd2d969bb022f9f6d537f3517"
   ],
   [
     "stackwright-pro-page-otter.json",
@@ -3231,11 +3876,11 @@ var _checksums = /* @__PURE__ */ new Map([
   ],
   [
     "stackwright-pro-theme-otter.json",
-    "3a37d4bd696f142c4a4278ef653984fca4b776caa610182c2cb82f6732ef9b62"
+    "d3a15871b71a466c12c4711fe37cbb018c768cb99eff15c40dbbc7061d4e966b"
   ],
   [
     "stackwright-pro-workflow-otter.json",
-    "fa2bae06e0f9e6b844008adc933d24b6a210708c0812ce068fc43733ee98b98e"
+    "2ce1bcbb5c45dbb214499ea08c7175f8b743b51b8cb2ad539faf7df11edcf88a"
   ]
 ]);
 Object.freeze(_checksums);
@@ -3250,11 +3895,11 @@ for (const [name, digest] of CANONICAL_CHECKSUMS) {
 }
 var MAX_OTTER_BYTES = 1 * 1024 * 1024;
 function computeSha256(data) {
-  return createHash2("sha256").update(data).digest("hex");
+  return createHash4("sha256").update(data).digest("hex");
 }
 function safeEqual(a, b) {
   if (a.length !== b.length) return false;
-  return timingSafeEqual(Buffer.from(a, "utf8"), Buffer.from(b, "utf8"));
+  return timingSafeEqual2(Buffer.from(a, "utf8"), Buffer.from(b, "utf8"));
 }
 function verifyOtterFile(filePath) {
   const filename = basename(filePath);
@@ -3264,7 +3909,7 @@ function verifyOtterFile(filePath) {
   }
   let stat;
   try {
-    stat = lstatSync6(filePath);
+    stat = lstatSync7(filePath);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return { verified: false, filename, error: `Cannot stat file: ${msg}` };
@@ -3282,7 +3927,7 @@ function verifyOtterFile(filePath) {
   }
   let raw;
   try {
-    raw = readFileSync5(filePath);
+    raw = readFileSync6(filePath);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return { verified: false, filename, error: `Cannot read file: ${msg}` };
@@ -3315,12 +3960,24 @@ function verifyOtterFile(filePath) {
   return { verified: true, filename };
 }
 function verifyAllOtters(otterDir) {
+  if (/(?:^|[/\\])\.\.(?:[/\\]|$)/.test(otterDir) || otterDir.includes("..")) {
+    return {
+      verified: [],
+      failed: [
+        {
+          filename: "<directory>",
+          error: `Security: path traversal sequence detected in otter directory parameter`
+        }
+      ],
+      unknown: []
+    };
+  }
   const verified = [];
   const failed = [];
   const unknown = [];
   let entries;
   try {
-    entries = readdirSync(otterDir);
+    entries = readdirSync2(otterDir);
   } catch (err) {
     const msg = err instanceof Error ? err.message : String(err);
     return {
@@ -3331,9 +3988,9 @@ function verifyAllOtters(otterDir) {
   }
   const otterFiles = entries.filter((f) => f.endsWith("-otter.json"));
   for (const filename of otterFiles) {
-    const filePath = join6(otterDir, filename);
+    const filePath = join7(otterDir, filename);
     try {
-      if (lstatSync6(filePath).isSymbolicLink()) {
+      if (lstatSync7(filePath).isSymbolicLink()) {
         failed.push({ filename, error: "Skipped: symlink" });
         continue;
       }
@@ -3359,15 +4016,30 @@ 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 = join6(cwd, relative);
+    const candidate = join7(cwd, relative);
     try {
-      lstatSync6(candidate);
+      lstatSync7(candidate);
       return candidate;
     } catch {
     }
   }
   return null;
 }
+function emitIntegrityAuditEvent(params) {
+  const record = JSON.stringify({
+    level: "AUDIT",
+    event: "INTEGRITY_FAIL",
+    timestamp: (/* @__PURE__ */ new Date()).toISOString(),
+    source: "stackwright_pro_verify_otter_integrity",
+    otterDir: params.otterDir,
+    failedCount: params.failed.length,
+    unknownCount: params.unknown.length,
+    failures: params.failed,
+    unknown: params.unknown
+  });
+  process.stderr.write(`INTEGRITY_FAIL ${record}
+`);
+}
 function registerIntegrityTools(server2) {
   server2.tool(
     "stackwright_pro_verify_otter_integrity",
@@ -3391,6 +4063,13 @@ function registerIntegrityTools(server2) {
       }
       const result = verifyAllOtters(resolved);
       const allGood = result.failed.length === 0 && result.unknown.length === 0;
+      if (!allGood) {
+        emitIntegrityAuditEvent({
+          otterDir: resolved,
+          failed: result.failed,
+          unknown: result.unknown
+        });
+      }
       return {
         content: [
           {
@@ -3404,25 +4083,27 @@ function registerIntegrityTools(server2) {
               verified: result.verified,
               failed: result.failed,
               unknown: result.unknown,
-              warning: result.failed.length > 0 ? "SHA-256 mismatches detected (non-blocking). PKI-signed manifest support coming soon." : void 0
+              ...allGood ? {} : {
+                error: "INTEGRITY CHECK FAILED: SHA-256 mismatch detected in otter agent definitions. Do not proceed \u2014 otter files may have been tampered with."
+              }
             })
           }
         ],
-        isError: false
+        isError: !allGood
       };
     }
   );
 }
 
 // src/tools/domain.ts
-import { z as z13 } from "zod";
-import { readFileSync as readFileSync6, existsSync as existsSync7 } from "fs";
-import { join as join7 } from "path";
+import { z as z14 } from "zod";
+import { readFileSync as readFileSync7, existsSync as existsSync8 } from "fs";
+import { join as join8 } from "path";
 function handleListCollections(input) {
   const cwd = input._cwd ?? process.cwd();
   const sources = [
     {
-      path: join7(cwd, ".stackwright", "artifacts", "data-config.json"),
+      path: join8(cwd, ".stackwright", "artifacts", "data-config.json"),
       source: "data-config.json",
       parse: (raw) => {
         const parsed = JSON.parse(raw);
@@ -3433,15 +4114,15 @@ function handleListCollections(input) {
       }
     },
     {
-      path: join7(cwd, "stackwright.yml"),
+      path: join8(cwd, "stackwright.yml"),
       source: "stackwright.yml",
       parse: extractCollectionsFromYaml
     }
   ];
   for (const { path: path3, source, parse } of sources) {
-    if (!existsSync7(path3)) continue;
+    if (!existsSync8(path3)) continue;
     try {
-      const collections = parse(readFileSync6(path3, "utf8"));
+      const collections = parse(readFileSync7(path3, "utf8"));
       return {
         text: JSON.stringify({ collections, source, collectionCount: collections.length }),
         isError: false
@@ -3592,8 +4273,8 @@ function handleValidateWorkflow(input) {
   if (input.workflow && Object.keys(input.workflow).length > 0) {
     raw = input.workflow;
   } else {
-    const artifactPath = join7(cwd, ".stackwright", "artifacts", "workflow-config.json");
-    if (!existsSync7(artifactPath)) {
+    const artifactPath = join8(cwd, ".stackwright", "artifacts", "workflow-config.json");
+    if (!existsSync8(artifactPath)) {
       return fail([
         {
           code: "NO_WORKFLOW",
@@ -3602,7 +4283,7 @@ function handleValidateWorkflow(input) {
       ]);
     }
     try {
-      raw = JSON.parse(readFileSync6(artifactPath, "utf8"));
+      raw = JSON.parse(readFileSync7(artifactPath, "utf8"));
     } catch (err) {
       return fail([{ code: "INVALID_JSON", message: `Failed to parse workflow artifact: ${err}` }]);
     }
@@ -3801,7 +4482,7 @@ function registerDomainTools(server2) {
     "stackwright_pro_resolve_data_strategy",
     "Look up the data freshness strategy configuration from the user's answer. Returns mechanism, revalidation seconds, required packages, and the exact MCP tool call to make. Replaces the strategy table in the data-otter prompt.",
     {
-      strategy: z13.string().describe(
+      strategy: z14.string().describe(
         'The data-1 answer value: "pulse-fast", "isr-fast", "isr-standard", or "isr-slow"'
       )
     },
@@ -3811,7 +4492,7 @@ function registerDomainTools(server2) {
     "stackwright_pro_validate_workflow",
     "Validate a workflow definition against the Stackwright workflow schema. Checks step ID uniqueness, transition targets, terminal state existence, and service references. Call this after the workflow otter produces output.",
     {
-      workflow: jsonCoerce(z13.record(z13.string(), z13.unknown()).optional()).describe(
+      workflow: jsonCoerce(z14.record(z14.string(), z14.unknown()).optional()).describe(
         "Parsed workflow object. If omitted, reads from .stackwright/artifacts/workflow-config.json"
       )
     },
@@ -3820,7 +4501,7 @@ function registerDomainTools(server2) {
 }
 
 // src/tools/type-schemas.ts
-import { z as z14 } from "zod";
+import { z as z15 } from "zod";
 function buildTypeSchemaSummary() {
   return {
     version: "1.0",
@@ -3897,7 +4578,7 @@ function registerTypeSchemasTool(server2) {
     "stackwright_pro_get_type_schemas",
     "Returns a structured summary of all canonical @stackwright-pro/types schemas, organized by domain. Use this to determine which otter owns a given schema and what artifact key to expect.",
     {
-      format: z14.enum(["full", "domains-only"]).optional().default("full").describe("full = complete summary with all fields; domains-only = just domain names")
+      format: z15.enum(["full", "domains-only"]).optional().default("full").describe("full = complete summary with all fields; domains-only = just domain names")
     },
     async ({ format }) => {
       const summary = buildTypeSchemaSummary();
@@ -3915,13 +4596,13 @@ var package_default = {
     "@stackwright-pro/types": "workspace:*",
     "@modelcontextprotocol/sdk": "^1.10.0",
     "@stackwright-pro/cli-data-explorer": "workspace:*",
-    zod: "^4.3.6"
+    zod: "^4.4.3"
   },
   devDependencies: {
-    "@types/node": "^24.1.0",
-    tsup: "^8.5.0",
-    typescript: "^5.8.3",
-    vitest: "^4.0.18"
+    "@types/node": "catalog:",
+    tsup: "catalog:",
+    typescript: "catalog:",
+    vitest: "catalog:"
   },
   scripts: {
     prepublishOnly: "node scripts/verify-integrity-sync.js",
@@ -3932,9 +4613,9 @@ var package_default = {
     "test:coverage": "vitest run --coverage"
   },
   name: "@stackwright-pro/mcp",
-  version: "0.2.0-alpha.32",
+  version: "0.2.0-alpha.48",
   description: "MCP tools for Stackwright Pro - Data Explorer, Security, ISR, and Dashboard generation",
-  license: "PROPRIETARY",
+  license: "SEE LICENSE IN LICENSE",
   main: "./dist/server.js",
   bin: {
     "stackwright-pro-mcp": "./dist/server.js"
@@ -3983,6 +4664,7 @@ registerPipelineTools(server);
 registerSafeWriteTools(server);
 registerAuthTools(server);
 registerIntegrityTools(server);
+registerArtifactSigningTools(server);
 registerDomainTools(server);
 registerTypeSchemasTool(server);
 async function main() {