@riddledc/riddle-proof 0.7.217 → 0.7.219

package/dist/{chunk-33XO7WFI.js → chunk-TWTEUS7R.js}

@@ -1,6 +1,6 @@
 // src/riddle-client.ts
 import { execFileSync } from "child_process";
-import { existsSync, mkdtempSync, readFileSync, rmSync } from "fs";
+import { existsSync, mkdtempSync, readdirSync, readFileSync, rmSync, statSync } from "fs";
 import { tmpdir } from "os";
 import path from "path";
 var DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
@@ -74,6 +74,7 @@ function previewDeployResultFromRecord(input) {
     expires_at: expiresAt,
     publish_recovered: publishRecovered || void 0,
     publish_error: publishError,
+    warnings: input.warnings?.length ? input.warnings : void 0,
     raw: record
   };
 }
@@ -91,7 +92,8 @@ async function waitForPublishedPreview(config, input) {
         framework: input.framework,
         expiresAt: input.expiresAt,
         publishRecovered: true,
-        publishError: input.publishError.message
+        publishError: input.publishError.message,
+        warnings: input.warnings
       });
     }
     if (attempt < PREVIEW_PUBLISH_RECOVERY_ATTEMPTS) {
@@ -104,6 +106,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
   if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
+  const warnings = collectRiddlePreviewDeployWarnings(directory, framework);
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
     body: JSON.stringify({ framework, label })
@@ -131,7 +134,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
     const published = await riddleRequestJson(config, `/v1/preview/${id}/publish`, {
       method: "POST"
     });
-    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt });
+    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt, warnings });
   } catch (error) {
     if (!canRecoverPreviewPublish(error)) throw error;
     return waitForPublishedPreview(config, {
@@ -139,10 +142,58 @@ async function deployRiddlePreview(config, directory, label, framework = "static
       label,
       framework,
       expiresAt,
-      publishError: error
+      publishError: error,
+      warnings
     });
   }
 }
+function latestMatchingMtimeMs(directory, predicate) {
+  let latest = 0;
+  const stack = [directory];
+  let visited = 0;
+  while (stack.length) {
+    const current = stack.pop();
+    for (const entry of readdirSync(current, { withFileTypes: true })) {
+      const fullPath = path.join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(fullPath);
+        continue;
+      }
+      if (!entry.isFile() || !predicate(fullPath)) continue;
+      const stat = statSync(fullPath);
+      latest = Math.max(latest, stat.mtimeMs);
+      visited += 1;
+      if (visited >= 1e4) return latest;
+    }
+  }
+  return latest;
+}
+function collectRiddlePreviewDeployWarnings(directory, framework = "static") {
+  try {
+    if (framework !== "static") return [];
+    const resolvedDirectory = path.resolve(directory);
+    if (path.basename(resolvedDirectory) !== "out") return [];
+    const repoRoot = path.dirname(resolvedDirectory);
+    const nextAppDir = path.join(repoRoot, ".next", "server", "app");
+    if (!existsSync(nextAppDir)) return [];
+    const nextRenderedMtimeMs = latestMatchingMtimeMs(nextAppDir, (filePath) => /\.(?:html|rsc)$/i.test(filePath));
+    if (!nextRenderedMtimeMs) return [];
+    const outRenderedMtimeMs = existsSync(resolvedDirectory) ? latestMatchingMtimeMs(resolvedDirectory, (filePath) => /\.(?:html|txt|rsc)$/i.test(filePath)) : 0;
+    if (!outRenderedMtimeMs) {
+      return [
+        "Riddle Preview static deploy target is an out/ directory with newer Next render output in .next/server/app, but no rendered HTML/RSC files were found in out/. Run the project static bundle/export step before deploying."
+      ];
+    }
+    if (nextRenderedMtimeMs > outRenderedMtimeMs + 1e3) {
+      return [
+        "Riddle Preview static deploy target out/ appears older than the Next render output in .next/server/app. Run the project static bundle/export step, such as npm run build:static-deploy or next export, before deploying to avoid a stale Preview."
+      ];
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
 async function deployRiddleStaticPreview(config, directory, label) {
   return deployRiddlePreview(config, directory, label, "static");
 }
@@ -415,6 +466,7 @@ export {
   riddleRequestJson,
   getRiddleBalance,
   deployRiddlePreview,
+  collectRiddlePreviewDeployWarnings,
   deployRiddleStaticPreview,
   parseRiddleViewport,
   runRiddleServerPreview,

package/dist/cli.cjs

@@ -6635,6 +6635,7 @@ function previewDeployResultFromRecord(input) {
     expires_at: expiresAt,
     publish_recovered: publishRecovered || void 0,
     publish_error: publishError,
+    warnings: input.warnings?.length ? input.warnings : void 0,
     raw: record
   };
 }
@@ -6652,7 +6653,8 @@ async function waitForPublishedPreview(config, input) {
         framework: input.framework,
         expiresAt: input.expiresAt,
         publishRecovered: true,
-        publishError: input.publishError.message
+        publishError: input.publishError.message,
+        warnings: input.warnings
       });
     }
     if (attempt < PREVIEW_PUBLISH_RECOVERY_ATTEMPTS) {
@@ -6665,6 +6667,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
   if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
+  const warnings = collectRiddlePreviewDeployWarnings(directory, framework);
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
     body: JSON.stringify({ framework, label })
@@ -6692,7 +6695,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
     const published = await riddleRequestJson(config, `/v1/preview/${id}/publish`, {
       method: "POST"
     });
-    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt });
+    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt, warnings });
   } catch (error) {
     if (!canRecoverPreviewPublish(error)) throw error;
     return waitForPublishedPreview(config, {
@@ -6700,10 +6703,58 @@ async function deployRiddlePreview(config, directory, label, framework = "static
       label,
       framework,
       expiresAt,
-      publishError: error
+      publishError: error,
+      warnings
     });
   }
 }
+function latestMatchingMtimeMs(directory, predicate) {
+  let latest = 0;
+  const stack = [directory];
+  let visited = 0;
+  while (stack.length) {
+    const current = stack.pop();
+    for (const entry of (0, import_node_fs5.readdirSync)(current, { withFileTypes: true })) {
+      const fullPath = import_node_path5.default.join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(fullPath);
+        continue;
+      }
+      if (!entry.isFile() || !predicate(fullPath)) continue;
+      const stat = (0, import_node_fs5.statSync)(fullPath);
+      latest = Math.max(latest, stat.mtimeMs);
+      visited += 1;
+      if (visited >= 1e4) return latest;
+    }
+  }
+  return latest;
+}
+function collectRiddlePreviewDeployWarnings(directory, framework = "static") {
+  try {
+    if (framework !== "static") return [];
+    const resolvedDirectory = import_node_path5.default.resolve(directory);
+    if (import_node_path5.default.basename(resolvedDirectory) !== "out") return [];
+    const repoRoot = import_node_path5.default.dirname(resolvedDirectory);
+    const nextAppDir = import_node_path5.default.join(repoRoot, ".next", "server", "app");
+    if (!(0, import_node_fs5.existsSync)(nextAppDir)) return [];
+    const nextRenderedMtimeMs = latestMatchingMtimeMs(nextAppDir, (filePath) => /\.(?:html|rsc)$/i.test(filePath));
+    if (!nextRenderedMtimeMs) return [];
+    const outRenderedMtimeMs = (0, import_node_fs5.existsSync)(resolvedDirectory) ? latestMatchingMtimeMs(resolvedDirectory, (filePath) => /\.(?:html|txt|rsc)$/i.test(filePath)) : 0;
+    if (!outRenderedMtimeMs) {
+      return [
+        "Riddle Preview static deploy target is an out/ directory with newer Next render output in .next/server/app, but no rendered HTML/RSC files were found in out/. Run the project static bundle/export step before deploying."
+      ];
+    }
+    if (nextRenderedMtimeMs > outRenderedMtimeMs + 1e3) {
+      return [
+        "Riddle Preview static deploy target out/ appears older than the Next render output in .next/server/app. Run the project static bundle/export step, such as npm run build:static-deploy or next export, before deploying to avoid a stale Preview."
+      ];
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
 async function deployRiddleStaticPreview(config, directory, label) {
   return deployRiddlePreview(config, directory, label, "static");
 }
@@ -16281,6 +16332,92 @@ function extractRiddleProofProfileResult(input) {
 
 // src/cli.ts
 var RIDDLE_PROFILE_BALANCE_PREFLIGHT_MIN_SECONDS_PER_JOB = 30;
+var KNOWN_CLI_OPTIONS = /* @__PURE__ */ new Set([
+  "agent",
+  "apiBaseUrl",
+  "apiKey",
+  "apiKeyFile",
+  "artifact",
+  "attempts",
+  "balancePreflight",
+  "baseUrl",
+  "candidateJson",
+  "candidatesJson",
+  "checkpointMode",
+  "checkpointVisibility",
+  "codexCommand",
+  "codexFullAuto",
+  "codexHome",
+  "codexModel",
+  "codexSandbox",
+  "codexTimeoutMs",
+  "command",
+  "continueWithStage",
+  "createdAt",
+  "decision",
+  "defaultReviewer",
+  "defaultShipMode",
+  "exclude",
+  "format",
+  "framework",
+  "help",
+  "image",
+  "input",
+  "inputDir",
+  "inputFile",
+  "inputFiles",
+  "inputs",
+  "intervalMs",
+  "job",
+  "jobId",
+  "maxIterations",
+  "navigationTimeout",
+  "output",
+  "outputDir",
+  "path",
+  "payloadJson",
+  "pollAttempts",
+  "pollIntervalMs",
+  "port",
+  "profile",
+  "progressEveryMs",
+  "quiet",
+  "readinessPath",
+  "readinessTimeout",
+  "reasonsJson",
+  "requestJson",
+  "requiredJson",
+  "responseJson",
+  "resultFormat",
+  "resultsDir",
+  "riddleEngineModuleUrl",
+  "riddleProofDir",
+  "route",
+  "runDir",
+  "runner",
+  "scriptFile",
+  "sourceKind",
+  "splitViewports",
+  "stateDir",
+  "statePath",
+  "strict",
+  "submitRetries",
+  "submitTimeoutMs",
+  "summary",
+  "sync",
+  "timeout",
+  "url",
+  "unsubmittedJobRetries",
+  "unsubmittedJobTimeoutMs",
+  "unsubmittedRetries",
+  "unsubmittedTimeoutMs",
+  "viewport",
+  "viewportName",
+  "viewportNames",
+  "viewports",
+  "wait",
+  "waitForSelector"
+]);
 function usage() {
   return [
     "Usage:",
@@ -16289,9 +16426,9 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--viewport-name <name[,name...]>] [--strict true|false; default false] [--split-viewports true|false; default false] [--balance-preflight true|false; default true] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json] [--quiet]",
-    "  riddle-proof-loop run-profile aggregate --profile <file|json|-> --url <base-url> --input-dir <dir>|--inputs <path[,path...]> [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
-    "  riddle-proof-loop run-profile recover --profile <file|json|-> --url <base-url> --job <job-id> [--viewport-name <name[,name...]>] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--base-url <base-url>] [--runner riddle] [--viewport-name <name[,name...]>] [--strict true|false; default false] [--split-viewports true|false; default false] [--balance-preflight true|false; default true] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json] [--quiet]",
+    "  riddle-proof-loop run-profile aggregate --profile <file|json|-> --url <base-url> [--base-url <base-url>] --input-dir <dir>|--inputs <path[,path...]> [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
+    "  riddle-proof-loop run-profile recover --profile <file|json|-> --url <base-url> [--base-url <base-url>] --job <job-id> [--viewport-name <name[,name...]>] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
     "  riddle-proof-loop profile-body-assertions --artifact <file|url|-> --candidates-json <file|json|-> [--required-json <file|json|->] [--format json|body-contains]",
     "  riddle-proof-loop profile-http-status-preflight --profile <file|json|-> --url <base-url> [--format json|summary]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
@@ -16331,6 +16468,15 @@ function parseArgs(argv) {
   }
   return { positional, options };
 }
+function optionKeyToFlagName(key) {
+  return key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+function validateCliOptions(options) {
+  const unknown = Object.keys(options).filter((key) => !KNOWN_CLI_OPTIONS.has(key));
+  if (!unknown.length) return;
+  const flags = unknown.map((key) => `--${optionKeyToFlagName(key)}`).join(", ");
+  throw new Error(`Unknown option${unknown.length === 1 ? "" : "s"}: ${flags}. Run riddle-proof-loop help for usage.`);
+}
 function optionString(options, key) {
   const value = options[key];
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
@@ -16652,7 +16798,7 @@ function parseProfileViewports(value) {
 function normalizeProfileForCli(options) {
   const rawProfile = readJsonValue(optionString(options, "profile"), "--profile");
   return normalizeRiddleProofProfile(rawProfile, {
-    url: optionString(options, "url"),
+    url: optionString(options, "url") ?? optionString(options, "baseUrl"),
     route: optionString(options, "route"),
     viewports: parseProfileViewports(optionString(options, "viewports") || optionString(options, "viewport"))
   });
@@ -19904,6 +20050,7 @@ async function main() {
 `);
     return;
   }
+  validateCliOptions(options);
   if (command === "doctor") {
     const subject = positional[1];
     if (!isLocalAgentMode(subject)) throw new Error("Only `doctor local` is supported.");
@@ -19979,6 +20126,10 @@ async function main() {
     const buildDir = positional[1];
     const label = positional[2];
     const result = await createRiddleApiClient(riddleClientConfig(options)).deployPreview(buildDir, label, previewFrameworkOption(options));
+    for (const warning of result.warnings ?? []) {
+      process.stderr.write(`Warning: ${warning}
+`);
+    }
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     return;

package/dist/cli.js

@@ -18,7 +18,7 @@ import {
   createRiddleApiClient,
   isTerminalRiddleJobStatus,
   parseRiddleViewport
-} from "./chunk-33XO7WFI.js";
+} from "./chunk-TWTEUS7R.js";
 import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
@@ -41,6 +41,92 @@ import "./chunk-VY4Y5U57.js";
 import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from "fs";
 import path from "path";
 var RIDDLE_PROFILE_BALANCE_PREFLIGHT_MIN_SECONDS_PER_JOB = 30;
+var KNOWN_CLI_OPTIONS = /* @__PURE__ */ new Set([
+  "agent",
+  "apiBaseUrl",
+  "apiKey",
+  "apiKeyFile",
+  "artifact",
+  "attempts",
+  "balancePreflight",
+  "baseUrl",
+  "candidateJson",
+  "candidatesJson",
+  "checkpointMode",
+  "checkpointVisibility",
+  "codexCommand",
+  "codexFullAuto",
+  "codexHome",
+  "codexModel",
+  "codexSandbox",
+  "codexTimeoutMs",
+  "command",
+  "continueWithStage",
+  "createdAt",
+  "decision",
+  "defaultReviewer",
+  "defaultShipMode",
+  "exclude",
+  "format",
+  "framework",
+  "help",
+  "image",
+  "input",
+  "inputDir",
+  "inputFile",
+  "inputFiles",
+  "inputs",
+  "intervalMs",
+  "job",
+  "jobId",
+  "maxIterations",
+  "navigationTimeout",
+  "output",
+  "outputDir",
+  "path",
+  "payloadJson",
+  "pollAttempts",
+  "pollIntervalMs",
+  "port",
+  "profile",
+  "progressEveryMs",
+  "quiet",
+  "readinessPath",
+  "readinessTimeout",
+  "reasonsJson",
+  "requestJson",
+  "requiredJson",
+  "responseJson",
+  "resultFormat",
+  "resultsDir",
+  "riddleEngineModuleUrl",
+  "riddleProofDir",
+  "route",
+  "runDir",
+  "runner",
+  "scriptFile",
+  "sourceKind",
+  "splitViewports",
+  "stateDir",
+  "statePath",
+  "strict",
+  "submitRetries",
+  "submitTimeoutMs",
+  "summary",
+  "sync",
+  "timeout",
+  "url",
+  "unsubmittedJobRetries",
+  "unsubmittedJobTimeoutMs",
+  "unsubmittedRetries",
+  "unsubmittedTimeoutMs",
+  "viewport",
+  "viewportName",
+  "viewportNames",
+  "viewports",
+  "wait",
+  "waitForSelector"
+]);
 function usage() {
   return [
     "Usage:",
@@ -49,9 +135,9 @@ function usage() {
     "  riddle-proof-loop respond --state-path <path> --response-json <file|json|->",
     "  riddle-proof-loop respond --state-path <path> --decision <decision> --summary <text> [--payload-json <file|json|->]",
     "  riddle-proof-loop status --state-path <path>",
-    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--runner riddle] [--viewport-name <name[,name...]>] [--strict true|false; default false] [--split-viewports true|false; default false] [--balance-preflight true|false; default true] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json] [--quiet]",
-    "  riddle-proof-loop run-profile aggregate --profile <file|json|-> --url <base-url> --input-dir <dir>|--inputs <path[,path...]> [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
-    "  riddle-proof-loop run-profile recover --profile <file|json|-> --url <base-url> --job <job-id> [--viewport-name <name[,name...]>] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
+    "  riddle-proof-loop run-profile --profile <file|json|-> --url <base-url> [--base-url <base-url>] [--runner riddle] [--viewport-name <name[,name...]>] [--strict true|false; default false] [--split-viewports true|false; default false] [--balance-preflight true|false; default true] [--poll-attempts n] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json] [--quiet]",
+    "  riddle-proof-loop run-profile aggregate --profile <file|json|-> --url <base-url> [--base-url <base-url>] --input-dir <dir>|--inputs <path[,path...]> [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
+    "  riddle-proof-loop run-profile recover --profile <file|json|-> --url <base-url> [--base-url <base-url>] --job <job-id> [--viewport-name <name[,name...]>] [--output <dir>|--output-dir <dir>] [--result-format json|compact-json|summary|none; default json]",
     "  riddle-proof-loop profile-body-assertions --artifact <file|url|-> --candidates-json <file|json|-> [--required-json <file|json|->] [--format json|body-contains]",
     "  riddle-proof-loop profile-http-status-preflight --profile <file|json|-> --url <base-url> [--format json|summary]",
     "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static]",
@@ -91,6 +177,15 @@ function parseArgs(argv) {
   }
   return { positional, options };
 }
+function optionKeyToFlagName(key) {
+  return key.replace(/[A-Z]/g, (letter) => `-${letter.toLowerCase()}`);
+}
+function validateCliOptions(options) {
+  const unknown = Object.keys(options).filter((key) => !KNOWN_CLI_OPTIONS.has(key));
+  if (!unknown.length) return;
+  const flags = unknown.map((key) => `--${optionKeyToFlagName(key)}`).join(", ");
+  throw new Error(`Unknown option${unknown.length === 1 ? "" : "s"}: ${flags}. Run riddle-proof-loop help for usage.`);
+}
 function optionString(options, key) {
   const value = options[key];
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
@@ -412,7 +507,7 @@ function parseProfileViewports(value) {
 function normalizeProfileForCli(options) {
   const rawProfile = readJsonValue(optionString(options, "profile"), "--profile");
   return normalizeRiddleProofProfile(rawProfile, {
-    url: optionString(options, "url"),
+    url: optionString(options, "url") ?? optionString(options, "baseUrl"),
     route: optionString(options, "route"),
     viewports: parseProfileViewports(optionString(options, "viewports") || optionString(options, "viewport"))
   });
@@ -3664,6 +3759,7 @@ async function main() {
 `);
     return;
   }
+  validateCliOptions(options);
   if (command === "doctor") {
     const subject = positional[1];
     if (!isLocalAgentMode(subject)) throw new Error("Only `doctor local` is supported.");
@@ -3739,6 +3835,10 @@ async function main() {
     const buildDir = positional[1];
     const label = positional[2];
     const result = await createRiddleApiClient(riddleClientConfig(options)).deployPreview(buildDir, label, previewFrameworkOption(options));
+    for (const warning of result.warnings ?? []) {
+      process.stderr.write(`Warning: ${warning}
+`);
+    }
     process.stdout.write(`${JSON.stringify(result, null, 2)}
 `);
     return;

package/dist/index.cjs

@@ -2948,6 +2948,7 @@ __export(index_exports, {
   buildVisualProofSession: () => buildVisualProofSession,
   checkpointResponseIdentity: () => checkpointResponseIdentity,
   checkpointSummaryFromState: () => checkpointSummaryFromState,
+  collectRiddlePreviewDeployWarnings: () => collectRiddlePreviewDeployWarnings,
   collectRiddleProfileArtifactRefs: () => collectRiddleProfileArtifactRefs,
   collectRiddleProofProfileWarnings: () => collectRiddleProofProfileWarnings,
   compactBasicGameplayText: () => compactBasicGameplayText,
@@ -18137,6 +18138,7 @@ function previewDeployResultFromRecord(input) {
     expires_at: expiresAt,
     publish_recovered: publishRecovered || void 0,
     publish_error: publishError,
+    warnings: input.warnings?.length ? input.warnings : void 0,
     raw: record
   };
 }
@@ -18154,7 +18156,8 @@ async function waitForPublishedPreview(config, input) {
         framework: input.framework,
         expiresAt: input.expiresAt,
         publishRecovered: true,
-        publishError: input.publishError.message
+        publishError: input.publishError.message,
+        warnings: input.warnings
       });
     }
     if (attempt < PREVIEW_PUBLISH_RECOVERY_ATTEMPTS) {
@@ -18167,6 +18170,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
   if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
+  const warnings = collectRiddlePreviewDeployWarnings(directory, framework);
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
     body: JSON.stringify({ framework, label })
@@ -18194,7 +18198,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
     const published = await riddleRequestJson(config, `/v1/preview/${id}/publish`, {
       method: "POST"
     });
-    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt });
+    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt, warnings });
   } catch (error) {
     if (!canRecoverPreviewPublish(error)) throw error;
     return waitForPublishedPreview(config, {
@@ -18202,10 +18206,58 @@ async function deployRiddlePreview(config, directory, label, framework = "static
       label,
       framework,
       expiresAt,
-      publishError: error
+      publishError: error,
+      warnings
     });
   }
 }
+function latestMatchingMtimeMs(directory, predicate) {
+  let latest = 0;
+  const stack = [directory];
+  let visited = 0;
+  while (stack.length) {
+    const current = stack.pop();
+    for (const entry of (0, import_node_fs5.readdirSync)(current, { withFileTypes: true })) {
+      const fullPath = import_node_path5.default.join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(fullPath);
+        continue;
+      }
+      if (!entry.isFile() || !predicate(fullPath)) continue;
+      const stat = (0, import_node_fs5.statSync)(fullPath);
+      latest = Math.max(latest, stat.mtimeMs);
+      visited += 1;
+      if (visited >= 1e4) return latest;
+    }
+  }
+  return latest;
+}
+function collectRiddlePreviewDeployWarnings(directory, framework = "static") {
+  try {
+    if (framework !== "static") return [];
+    const resolvedDirectory = import_node_path5.default.resolve(directory);
+    if (import_node_path5.default.basename(resolvedDirectory) !== "out") return [];
+    const repoRoot = import_node_path5.default.dirname(resolvedDirectory);
+    const nextAppDir = import_node_path5.default.join(repoRoot, ".next", "server", "app");
+    if (!(0, import_node_fs5.existsSync)(nextAppDir)) return [];
+    const nextRenderedMtimeMs = latestMatchingMtimeMs(nextAppDir, (filePath) => /\.(?:html|rsc)$/i.test(filePath));
+    if (!nextRenderedMtimeMs) return [];
+    const outRenderedMtimeMs = (0, import_node_fs5.existsSync)(resolvedDirectory) ? latestMatchingMtimeMs(resolvedDirectory, (filePath) => /\.(?:html|txt|rsc)$/i.test(filePath)) : 0;
+    if (!outRenderedMtimeMs) {
+      return [
+        "Riddle Preview static deploy target is an out/ directory with newer Next render output in .next/server/app, but no rendered HTML/RSC files were found in out/. Run the project static bundle/export step before deploying."
+      ];
+    }
+    if (nextRenderedMtimeMs > outRenderedMtimeMs + 1e3) {
+      return [
+        "Riddle Preview static deploy target out/ appears older than the Next render output in .next/server/app. Run the project static bundle/export step, such as npm run build:static-deploy or next export, before deploying to avoid a stale Preview."
+      ];
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
 async function deployRiddleStaticPreview(config, directory, label) {
   return deployRiddlePreview(config, directory, label, "static");
 }
@@ -18519,6 +18571,7 @@ function createRiddleApiClient(config = {}) {
   buildVisualProofSession,
   checkpointResponseIdentity,
   checkpointSummaryFromState,
+  collectRiddlePreviewDeployWarnings,
   collectRiddleProfileArtifactRefs,
   collectRiddleProofProfileWarnings,
   compactBasicGameplayText,

package/dist/index.d.cts

@@ -11,4 +11,4 @@ export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_V
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.cjs';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.cjs';
 export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofArtifactBodyAssertionInput, RiddleProofArtifactBodyAssertionResult, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileHttpStatusBodyJsonAssertion, RiddleProofProfileHttpStatusBodyJsonAssertionResult, RiddleProofProfileHttpStatusPreflightCheckResult, RiddleProofProfileHttpStatusPreflightFetch, RiddleProofProfileHttpStatusPreflightFetchResponse, RiddleProofProfileHttpStatusPreflightOptions, RiddleProofProfileHttpStatusPreflightResult, RiddleProofProfileJsonValueType, RiddleProofProfileNetworkAbortErrorCode, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileReturnSummaryField, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.cjs';
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.cjs';

package/dist/index.d.ts

@@ -11,4 +11,4 @@ export { BuildVisualProofSessionInput, RIDDLE_PROOF_VISUAL_SESSION_FINGERPRINT_V
 export { AssessPlayabilityOptions, RIDDLE_PROOF_PLAYABILITY_ASSESSMENT_VERSION, RIDDLE_PROOF_PLAYABILITY_VERSION, RiddleProofPlayabilityAssessment, RiddleProofPlayabilityEvidence, assessPlayabilityEvidence, extractPlayabilityEvidence, isRiddleProofPlayabilityMode } from './playability.js';
 export { AssessBasicGameplayOptions, AttachBasicGameplayArtifactOptions, BASIC_GAMEPLAY_ACTION_TYPES, BASIC_GAMEPLAY_PROGRESS_CHECK_TYPES, BasicGameplayActionResult, BasicGameplayActionType, BasicGameplayArtifactResolution, BasicGameplayAssessmentSummary, BasicGameplayBoundsOffender, BasicGameplayCanvasState, BasicGameplayCatchRecord, BasicGameplayChangeSummary, BasicGameplayFailureCode, BasicGameplayFixReference, BasicGameplayMetric, BasicGameplayMobileEvidence, BasicGameplayProgressCheckType, BasicGameplayProgressionCheck, BasicGameplayProofArtifact, BasicGameplayResponsiveViewportEvidence, BasicGameplayRouteReference, BasicGameplaySnapshot, BasicGameplaySuiteFailure, BasicGameplayWarningCode, CreateBasicGameplayCatchSummaryInput, RIDDLE_PROOF_BASIC_GAMEPLAY_ASSESSMENT_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_CATCH_VERSION, RIDDLE_PROOF_BASIC_GAMEPLAY_VERSION, RiddleProofBasicGameplayAssessment, RiddleProofBasicGameplayCatchSummary, RiddleProofBasicGameplayEvidence, RiddleProofBasicGameplayRouteAssessment, RiddleProofBasicGameplayRouteEvidence, assessBasicGameplayEvidence, assessBasicGameplayProgressionCheck, assessBasicGameplayProgressionChecks, assessBasicGameplayRoute, attachBasicGameplayArtifactScreenshotHashes, augmentBasicGameplayAssessmentWithProgressionChecks, compactBasicGameplayText, createBasicGameplayCatchRecords, createBasicGameplayCatchSummary, extractBasicGameplayEvidence, resolveBasicGameplayProgressionCheckWithArtifactScreenshots, sanitizeBasicGameplayJsonString } from './basic-gameplay.js';
 export { NormalizeRiddleProofProfileOptions, RIDDLE_PROOF_PROFILE_CHECK_TYPES, RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION, RIDDLE_PROOF_PROFILE_NETWORK_ABORT_ERROR_CODES, RIDDLE_PROOF_PROFILE_RESULT_VERSION, RIDDLE_PROOF_PROFILE_SETUP_ACTION_TYPES, RIDDLE_PROOF_PROFILE_STATUSES, RIDDLE_PROOF_PROFILE_VERSION, RiddleProofArtifactBodyAssertionInput, RiddleProofArtifactBodyAssertionResult, RiddleProofProfile, RiddleProofProfileArtifactRef, RiddleProofProfileBaselinePolicy, RiddleProofProfileBoundsOffender, RiddleProofProfileCheck, RiddleProofProfileCheckResult, RiddleProofProfileCheckType, RiddleProofProfileEvidence, RiddleProofProfileFailureAction, RiddleProofProfileHttpStatusBodyJsonAssertion, RiddleProofProfileHttpStatusBodyJsonAssertionResult, RiddleProofProfileHttpStatusPreflightCheckResult, RiddleProofProfileHttpStatusPreflightFetch, RiddleProofProfileHttpStatusPreflightFetchResponse, RiddleProofProfileHttpStatusPreflightOptions, RiddleProofProfileHttpStatusPreflightResult, RiddleProofProfileJsonValueType, RiddleProofProfileNetworkAbortErrorCode, RiddleProofProfileNetworkMock, RiddleProofProfileNetworkMockResponse, RiddleProofProfileResult, RiddleProofProfileReturnSummaryField, RiddleProofProfileRouteEvidence, RiddleProofProfileRouteInventoryRoute, RiddleProofProfileRunner, RiddleProofProfileSetupAction, RiddleProofProfileSetupActionType, RiddleProofProfileStatus, RiddleProofProfileTarget, RiddleProofProfileViewport, RiddleProofProfileViewportEvidence, assessRiddleProofProfileEvidence, buildRiddleProofProfileScript, collectRiddleProfileArtifactRefs, collectRiddleProofProfileWarnings, createRiddleProofProfileConfigurationError, createRiddleProofProfileEnvironmentBlockedResult, createRiddleProofProfileInsufficientResult, deriveRiddleProofArtifactBodyAssertions, extractRiddleProofProfileResult, normalizeRiddleProofProfile, preflightRiddleProofProfileHttpStatusChecks, profileStatusExitCode, resolveRiddleProofProfileRouteUrl, resolveRiddleProofProfileTargetUrl, resolveRiddleProofProfileTimeoutSec, slugifyRiddleProofProfileName, summarizeRiddleProofProfileResult } from './profile.js';
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployResult, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from './riddle-client.js';

package/dist/index.js

@@ -67,6 +67,7 @@ import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
+  collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,
   deployRiddlePreview,
   deployRiddleStaticPreview,
@@ -79,7 +80,7 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-33XO7WFI.js";
+} from "./chunk-TWTEUS7R.js";
 import {
   DEFAULT_DIAGNOSTIC_ARRAY_LIMIT,
   DEFAULT_DIAGNOSTIC_HISTORY_LIMIT,
@@ -194,6 +195,7 @@ export {
   buildVisualProofSession,
   checkpointResponseIdentity,
   checkpointSummaryFromState,
+  collectRiddlePreviewDeployWarnings,
   collectRiddleProfileArtifactRefs,
   collectRiddleProofProfileWarnings,
   compactBasicGameplayText,

package/dist/riddle-client.cjs

@@ -33,6 +33,7 @@ __export(riddle_client_exports, {
   DEFAULT_RIDDLE_API_BASE_URL: () => DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE: () => DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError: () => RiddleApiError,
+  collectRiddlePreviewDeployWarnings: () => collectRiddlePreviewDeployWarnings,
   createRiddleApiClient: () => createRiddleApiClient,
   deployRiddlePreview: () => deployRiddlePreview,
   deployRiddleStaticPreview: () => deployRiddleStaticPreview,
@@ -122,6 +123,7 @@ function previewDeployResultFromRecord(input) {
     expires_at: expiresAt,
     publish_recovered: publishRecovered || void 0,
     publish_error: publishError,
+    warnings: input.warnings?.length ? input.warnings : void 0,
     raw: record
   };
 }
@@ -139,7 +141,8 @@ async function waitForPublishedPreview(config, input) {
         framework: input.framework,
         expiresAt: input.expiresAt,
         publishRecovered: true,
-        publishError: input.publishError.message
+        publishError: input.publishError.message,
+        warnings: input.warnings
       });
     }
     if (attempt < PREVIEW_PUBLISH_RECOVERY_ATTEMPTS) {
@@ -152,6 +155,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
   if (!directory?.trim()) throw new Error("directory is required");
   if (!label?.trim()) throw new Error("label is required");
   if (framework !== "spa" && framework !== "static") throw new Error("framework must be spa or static");
+  const warnings = collectRiddlePreviewDeployWarnings(directory, framework);
   const created = await riddleRequestJson(config, "/v1/preview", {
     method: "POST",
     body: JSON.stringify({ framework, label })
@@ -179,7 +183,7 @@ async function deployRiddlePreview(config, directory, label, framework = "static
     const published = await riddleRequestJson(config, `/v1/preview/${id}/publish`, {
       method: "POST"
     });
-    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt });
+    return previewDeployResultFromRecord({ record: published, id, label, framework, expiresAt, warnings });
   } catch (error) {
     if (!canRecoverPreviewPublish(error)) throw error;
     return waitForPublishedPreview(config, {
@@ -187,10 +191,58 @@ async function deployRiddlePreview(config, directory, label, framework = "static
       label,
       framework,
       expiresAt,
-      publishError: error
+      publishError: error,
+      warnings
     });
   }
 }
+function latestMatchingMtimeMs(directory, predicate) {
+  let latest = 0;
+  const stack = [directory];
+  let visited = 0;
+  while (stack.length) {
+    const current = stack.pop();
+    for (const entry of (0, import_node_fs.readdirSync)(current, { withFileTypes: true })) {
+      const fullPath = import_node_path.default.join(current, entry.name);
+      if (entry.isDirectory()) {
+        stack.push(fullPath);
+        continue;
+      }
+      if (!entry.isFile() || !predicate(fullPath)) continue;
+      const stat = (0, import_node_fs.statSync)(fullPath);
+      latest = Math.max(latest, stat.mtimeMs);
+      visited += 1;
+      if (visited >= 1e4) return latest;
+    }
+  }
+  return latest;
+}
+function collectRiddlePreviewDeployWarnings(directory, framework = "static") {
+  try {
+    if (framework !== "static") return [];
+    const resolvedDirectory = import_node_path.default.resolve(directory);
+    if (import_node_path.default.basename(resolvedDirectory) !== "out") return [];
+    const repoRoot = import_node_path.default.dirname(resolvedDirectory);
+    const nextAppDir = import_node_path.default.join(repoRoot, ".next", "server", "app");
+    if (!(0, import_node_fs.existsSync)(nextAppDir)) return [];
+    const nextRenderedMtimeMs = latestMatchingMtimeMs(nextAppDir, (filePath) => /\.(?:html|rsc)$/i.test(filePath));
+    if (!nextRenderedMtimeMs) return [];
+    const outRenderedMtimeMs = (0, import_node_fs.existsSync)(resolvedDirectory) ? latestMatchingMtimeMs(resolvedDirectory, (filePath) => /\.(?:html|txt|rsc)$/i.test(filePath)) : 0;
+    if (!outRenderedMtimeMs) {
+      return [
+        "Riddle Preview static deploy target is an out/ directory with newer Next render output in .next/server/app, but no rendered HTML/RSC files were found in out/. Run the project static bundle/export step before deploying."
+      ];
+    }
+    if (nextRenderedMtimeMs > outRenderedMtimeMs + 1e3) {
+      return [
+        "Riddle Preview static deploy target out/ appears older than the Next render output in .next/server/app. Run the project static bundle/export step, such as npm run build:static-deploy or next export, before deploying to avoid a stale Preview."
+      ];
+    }
+    return [];
+  } catch {
+    return [];
+  }
+}
 async function deployRiddleStaticPreview(config, directory, label) {
   return deployRiddlePreview(config, directory, label, "static");
 }
@@ -458,6 +510,7 @@ function createRiddleApiClient(config = {}) {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
+  collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,
   deployRiddlePreview,
   deployRiddleStaticPreview,

package/dist/riddle-client.d.cts

@@ -65,6 +65,7 @@ interface RiddlePreviewDeployResult {
     expires_at?: string;
     publish_recovered?: boolean;
     publish_error?: string;
+    warnings?: string[];
     raw?: Record<string, unknown>;
 }
 interface RiddleRunScriptInput {
@@ -129,6 +130,7 @@ declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
 declare function getRiddleBalance(config?: RiddleClientConfig): Promise<RiddleBalanceResult>;
 declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
+declare function collectRiddlePreviewDeployWarnings(directory: string, framework?: RiddlePreviewFramework): string[];
 declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
@@ -149,4 +151,4 @@ declare function createRiddleApiClient(config?: RiddleClientConfig): {
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.d.ts

@@ -65,6 +65,7 @@ interface RiddlePreviewDeployResult {
     expires_at?: string;
     publish_recovered?: boolean;
     publish_error?: string;
+    warnings?: string[];
     raw?: Record<string, unknown>;
 }
 interface RiddleRunScriptInput {
@@ -129,6 +130,7 @@ declare function resolveRiddleApiKey(config?: RiddleClientConfig): string;
 declare function riddleRequestJson<T = unknown>(config: RiddleClientConfig, pathname: string, init?: RequestInit): Promise<T>;
 declare function getRiddleBalance(config?: RiddleClientConfig): Promise<RiddleBalanceResult>;
 declare function deployRiddlePreview(config: RiddleClientConfig, directory: string, label: string, framework?: RiddlePreviewFramework): Promise<RiddlePreviewDeployResult>;
+declare function collectRiddlePreviewDeployWarnings(directory: string, framework?: RiddlePreviewFramework): string[];
 declare function deployRiddleStaticPreview(config: RiddleClientConfig, directory: string, label: string): Promise<RiddlePreviewDeployResult>;
 declare function parseRiddleViewport(value?: string): {
     width: number;
@@ -149,4 +151,4 @@ declare function createRiddleApiClient(config?: RiddleClientConfig): {
     pollJob: (jobId: string, options?: RiddlePollJobOptions) => Promise<RiddlePollJobResult>;
 };
 
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployResult, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };

package/dist/riddle-client.js

@@ -2,6 +2,7 @@ import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
+  collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,
   deployRiddlePreview,
   deployRiddleStaticPreview,
@@ -14,11 +15,12 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-33XO7WFI.js";
+} from "./chunk-TWTEUS7R.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
   RiddleApiError,
+  collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,
   deployRiddlePreview,
   deployRiddleStaticPreview,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.7.217",
+  "version": "0.7.219",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",