@riddledc/riddle-proof 0.7.217 → 0.7.218

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");
 }
@@ -19979,6 +20030,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,
@@ -3739,6 +3739,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.218",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",