@riddledc/riddle-proof 0.8.63 → 0.8.65

package/dist/profile-suggestions.cjs

@@ -0,0 +1,204 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/profile-suggestions.ts
+var profile_suggestions_exports = {};
+__export(profile_suggestions_exports, {
+  RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION: () => RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION,
+  suggestRiddleProofProfileChecks: () => suggestRiddleProofProfileChecks
+});
+module.exports = __toCommonJS(profile_suggestions_exports);
+
+// src/profile.ts
+var RIDDLE_PROOF_PROFILE_VERSION = "riddle-proof.profile.v1";
+
+// src/profile-suggestions.ts
+var RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION = "riddle-proof.profile-suggestions.v1";
+var UI_FILE_PATTERN = /\.(css|html?|jsx?|tsx?|vue|svelte|mdx)$/i;
+var VISUAL_ASSET_PATTERN = /\.(avif|gif|jpe?g|png|svg|webp)$/i;
+function nonEmptyStrings(values) {
+  return Array.from(new Set(
+    (values || []).filter((value) => typeof value === "string").map((value) => value.trim()).filter(Boolean)
+  ));
+}
+function normalizeRoute(value) {
+  if (!value?.trim()) return void 0;
+  const trimmed = value.trim();
+  if (/^https?:\/\//i.test(trimmed)) return void 0;
+  return trimmed.startsWith("/") ? trimmed : `/${trimmed}`;
+}
+function routeFromUrl(value) {
+  if (!value?.trim()) return void 0;
+  try {
+    const url = new URL(value);
+    return normalizeRoute(`${url.pathname}${url.search || ""}`);
+  } catch {
+    return void 0;
+  }
+}
+function slugify(value) {
+  return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 80) || "suggested-profile";
+}
+function inferRouteFromFile(file) {
+  const normalized = file.replace(/\\/g, "/");
+  const routeMatch = normalized.match(/(?:^|\/)(?:pages|routes|app)\/(.+?)(?:\.[^.\/]+)?$/);
+  if (!routeMatch) return void 0;
+  const route = routeMatch[1].replace(/\/index$/i, "").replace(/\/page$/i, "").replace(/\[[^/\]]+\]/g, ":param");
+  return normalizeRoute(route || "/");
+}
+function inferRouteFromFiles(files) {
+  for (const file of files) {
+    const route = inferRouteFromFile(file);
+    if (route) return route;
+  }
+  return void 0;
+}
+function uniqueChecks(checks) {
+  const seen = /* @__PURE__ */ new Set();
+  return checks.filter((check) => {
+    const key = JSON.stringify(check);
+    if (seen.has(key)) return false;
+    seen.add(key);
+    return true;
+  });
+}
+function changedTextEntryText(entry) {
+  return typeof entry === "string" ? entry.trim() : (entry.expected_text || entry.text || "").trim();
+}
+function changedTextEntrySelector(entry) {
+  return typeof entry === "string" ? void 0 : entry.selector?.trim() || void 0;
+}
+function changedTextEntryLabel(entry) {
+  return typeof entry === "string" ? void 0 : entry.label?.trim() || void 0;
+}
+function suggestionProfileName(input, route, files) {
+  if (input.name?.trim()) return input.name.trim();
+  return `suggested-${slugify(route || files[0] || "profile")}`;
+}
+function defaultViewports(includeMobile) {
+  const viewports = [
+    { name: "desktop", width: 1280, height: 800 }
+  ];
+  if (includeMobile !== false) {
+    viewports.push({ name: "mobile", width: 390, height: 844 });
+  }
+  return viewports;
+}
+function suggestRiddleProofProfileChecks(input) {
+  const changedFiles = nonEmptyStrings(input.changed_files);
+  const selectors = nonEmptyStrings(input.selectors);
+  const changedText = input.changed_text || [];
+  const route = normalizeRoute(input.route) || inferRouteFromFiles(changedFiles) || routeFromUrl(input.url);
+  const uiFiles = changedFiles.filter((file) => UI_FILE_PATTERN.test(file));
+  const visualAssets = changedFiles.filter((file) => VISUAL_ASSET_PATTERN.test(file));
+  const warnings = [];
+  const suggestions = [];
+  const setupActions = [];
+  if (!route && !input.url?.trim()) {
+    warnings.push("No route or URL was supplied; the draft profile defaults to route /.");
+  }
+  if ((uiFiles.length || visualAssets.length) && !changedText.length && !selectors.length) {
+    warnings.push("UI or visual files changed, but no changed text or selectors were supplied; add focused checks before trusting this profile.");
+  }
+  const routeOrDefault = route || "/";
+  const routeChecks = [
+    { type: "route_loaded", expected_path: routeOrDefault }
+  ];
+  suggestions.push({
+    id: "route-loaded",
+    reason: "Every browser proof should first prove that the intended route loaded.",
+    checks: routeChecks
+  });
+  const hygieneChecks = [
+    { type: "no_fatal_console_errors" },
+    { type: "no_mobile_horizontal_overflow" }
+  ];
+  suggestions.push({
+    id: "runtime-hygiene",
+    reason: "UI changes should not introduce fatal console errors or mobile overflow.",
+    checks: hygieneChecks
+  });
+  for (const selector of selectors) {
+    suggestions.push({
+      id: `selector-${slugify(selector)}`,
+      reason: `Changed selector ${selector} should remain visible.`,
+      checks: [{ type: "selector_visible", selector }]
+    });
+  }
+  for (const entry of changedText) {
+    const text = changedTextEntryText(entry);
+    if (!text) continue;
+    const selector = changedTextEntrySelector(entry);
+    const label = changedTextEntryLabel(entry);
+    const check = selector ? { type: "selector_text_visible", selector, text, label } : { type: "text_visible", text, label };
+    suggestions.push({
+      id: `text-${slugify(`${selector || "page"}-${text}`)}`,
+      reason: selector ? `Expected text should be visible inside ${selector}.` : "Expected text should be visible on the route.",
+      checks: [check]
+    });
+  }
+  if (input.include_screenshot !== false && (uiFiles.length || visualAssets.length || selectors.length || changedText.length)) {
+    setupActions.push({ type: "screenshot", label: "suggested-proof-screenshot", full_page: true });
+    suggestions.push({
+      id: "screenshot-artifact",
+      reason: "A screenshot artifact keeps the proof packet inspectable by humans and hosted renderers.",
+      checks: [],
+      setup_actions: setupActions
+    });
+  }
+  const checks = uniqueChecks(suggestions.flatMap((suggestion) => suggestion.checks));
+  const target = {
+    ...input.url?.trim() ? { url: input.url.trim() } : { route: routeOrDefault },
+    viewports: defaultViewports(input.include_mobile),
+    setup_actions: setupActions.length ? setupActions : void 0
+  };
+  const profile = {
+    version: RIDDLE_PROOF_PROFILE_VERSION,
+    name: suggestionProfileName(input, routeOrDefault, changedFiles),
+    target,
+    checks,
+    artifacts: ["screenshot", "console", "proof_json"],
+    baseline_policy: "invariant_only",
+    failure_policy: {
+      product_regression: "fail",
+      proof_insufficient: "review",
+      environment_blocked: "neutral",
+      configuration_error: "fail",
+      needs_human_review: "review"
+    },
+    metadata: {
+      suggestion_input: {
+        changed_files: changedFiles,
+        selectors,
+        changed_text_count: changedText.length
+      }
+    }
+  };
+  return {
+    version: RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION,
+    profile,
+    suggestions,
+    warnings
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION,
+  suggestRiddleProofProfileChecks
+});

package/dist/profile-suggestions.d.cts

@@ -0,0 +1,36 @@
+import { RiddleProofProfileCheck, RiddleProofProfileSetupAction, RiddleProofProfile } from './profile.cjs';
+import './types.cjs';
+import './public-state.cjs';
+
+declare const RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION: "riddle-proof.profile-suggestions.v1";
+interface RiddleProofProfileChangedTextInput {
+    text?: string;
+    expected_text?: string;
+    selector?: string;
+    label?: string;
+}
+interface RiddleProofProfileSuggestionInput {
+    name?: string;
+    route?: string;
+    url?: string;
+    changed_files?: string[];
+    selectors?: string[];
+    changed_text?: Array<string | RiddleProofProfileChangedTextInput>;
+    include_mobile?: boolean;
+    include_screenshot?: boolean;
+}
+interface RiddleProofProfileSuggestion {
+    id: string;
+    reason: string;
+    checks: RiddleProofProfileCheck[];
+    setup_actions?: RiddleProofProfileSetupAction[];
+}
+interface RiddleProofProfileSuggestionsResult {
+    version: typeof RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION;
+    profile: RiddleProofProfile;
+    suggestions: RiddleProofProfileSuggestion[];
+    warnings: string[];
+}
+declare function suggestRiddleProofProfileChecks(input: RiddleProofProfileSuggestionInput): RiddleProofProfileSuggestionsResult;
+
+export { RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION, type RiddleProofProfileChangedTextInput, type RiddleProofProfileSuggestion, type RiddleProofProfileSuggestionInput, type RiddleProofProfileSuggestionsResult, suggestRiddleProofProfileChecks };

package/dist/profile-suggestions.d.ts

@@ -0,0 +1,36 @@
+import { RiddleProofProfileCheck, RiddleProofProfileSetupAction, RiddleProofProfile } from './profile.js';
+import './types.js';
+import './public-state.js';
+
+declare const RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION: "riddle-proof.profile-suggestions.v1";
+interface RiddleProofProfileChangedTextInput {
+    text?: string;
+    expected_text?: string;
+    selector?: string;
+    label?: string;
+}
+interface RiddleProofProfileSuggestionInput {
+    name?: string;
+    route?: string;
+    url?: string;
+    changed_files?: string[];
+    selectors?: string[];
+    changed_text?: Array<string | RiddleProofProfileChangedTextInput>;
+    include_mobile?: boolean;
+    include_screenshot?: boolean;
+}
+interface RiddleProofProfileSuggestion {
+    id: string;
+    reason: string;
+    checks: RiddleProofProfileCheck[];
+    setup_actions?: RiddleProofProfileSetupAction[];
+}
+interface RiddleProofProfileSuggestionsResult {
+    version: typeof RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION;
+    profile: RiddleProofProfile;
+    suggestions: RiddleProofProfileSuggestion[];
+    warnings: string[];
+}
+declare function suggestRiddleProofProfileChecks(input: RiddleProofProfileSuggestionInput): RiddleProofProfileSuggestionsResult;
+
+export { RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION, type RiddleProofProfileChangedTextInput, type RiddleProofProfileSuggestion, type RiddleProofProfileSuggestionInput, type RiddleProofProfileSuggestionsResult, suggestRiddleProofProfileChecks };

package/dist/profile-suggestions.js

@@ -0,0 +1,10 @@
+import {
+  RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION,
+  suggestRiddleProofProfileChecks
+} from "./chunk-5Y4V2IXI.js";
+import "./chunk-EX7TO4I5.js";
+import "./chunk-MLKGABMK.js";
+export {
+  RIDDLE_PROOF_PROFILE_SUGGESTIONS_VERSION,
+  suggestRiddleProofProfileChecks
+};

package/dist/riddle-client.cjs

@@ -32,6 +32,7 @@ var riddle_client_exports = {};
 __export(riddle_client_exports, {
   DEFAULT_RIDDLE_API_BASE_URL: () => DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE: () => DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT: () => RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError: () => RiddleApiError,
   collectRiddlePreviewDeployWarnings: () => collectRiddlePreviewDeployWarnings,
   createRiddleApiClient: () => createRiddleApiClient,
@@ -54,6 +55,7 @@ var import_node_os = require("os");
 var import_node_path = __toESM(require("path"), 1);
 var DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 var DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+var RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
 var RiddleApiError = class extends Error {
   constructor(pathname, status, body) {
     super(`Riddle API ${pathname} failed HTTP ${status}: ${body}`);
@@ -521,9 +523,10 @@ function buildPollSnapshot(jobId, job, input) {
 function pollMessage(snapshot, timedOut) {
   if (!timedOut) return void 0;
   const submitted = snapshot.submitted_at || "not submitted";
+  const wakeHint = snapshot.running_without_submission && !snapshot.created_at && !snapshot.submitted_at ? ` ${RIDDLE_UNSUBMITTED_WAKE_HINT}.` : "";
   const queue = snapshot.queue_elapsed_ms !== null ? ` queue_elapsed_ms=${snapshot.queue_elapsed_ms}` : "";
   const preSubmit = snapshot.pre_submission_elapsed_ms > 0 ? ` pre_submission_elapsed_ms=${snapshot.pre_submission_elapsed_ms}` : "";
-  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${queue}${preSubmit}`;
+  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${wakeHint}${queue}${preSubmit}`;
 }
 async function pollRiddleJob(config, jobId, options = {}) {
   if (!jobId?.trim()) throw new Error("jobId is required");
@@ -634,6 +637,7 @@ function createRiddleApiClient(config = {}) {
 0 && (module.exports = {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,

package/dist/riddle-client.d.cts

@@ -1,5 +1,6 @@
 declare const DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 declare const DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+declare const RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
 type RiddleFetch = typeof fetch;
 interface RiddleClientConfig {
     apiKey?: string;
@@ -171,4 +172,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 RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, 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

@@ -1,5 +1,6 @@
 declare const DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 declare const DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+declare const RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
 type RiddleFetch = typeof fetch;
 interface RiddleClientConfig {
     apiKey?: string;
@@ -171,4 +172,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 RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, type RiddlePreviewFramework, type RiddleRunScriptInput, type RiddleServerPreviewInput, type RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview };
+export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, type RiddleApiKeySource, type RiddleBalanceResult, type RiddleClientConfig, type RiddleFetch, type RiddlePollJobOptions, type RiddlePollJobResult, type RiddlePollProgressSnapshot, type RiddlePollSummary, type RiddlePreviewDeployProgressSnapshot, type RiddlePreviewDeployResult, type RiddlePreviewDeployStage, 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

@@ -1,6 +1,7 @@
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,
@@ -15,11 +16,12 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "./chunk-DI2XNGEZ.js";
+} from "./chunk-B2DP2LET.js";
 import "./chunk-MLKGABMK.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,

package/dist/runtime/index.cjs

@@ -32,6 +32,7 @@ var runtime_exports = {};
 __export(runtime_exports, {
   DEFAULT_RIDDLE_API_BASE_URL: () => DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE: () => DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT: () => RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError: () => RiddleApiError,
   collectRiddlePreviewDeployWarnings: () => collectRiddlePreviewDeployWarnings,
   createRiddleApiClient: () => createRiddleApiClient,
@@ -56,6 +57,7 @@ var import_node_os = require("os");
 var import_node_path = __toESM(require("path"), 1);
 var DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 var DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+var RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
 var RiddleApiError = class extends Error {
   constructor(pathname, status, body) {
     super(`Riddle API ${pathname} failed HTTP ${status}: ${body}`);
@@ -523,9 +525,10 @@ function buildPollSnapshot(jobId, job, input) {
 function pollMessage(snapshot, timedOut) {
   if (!timedOut) return void 0;
   const submitted = snapshot.submitted_at || "not submitted";
+  const wakeHint = snapshot.running_without_submission && !snapshot.created_at && !snapshot.submitted_at ? ` ${RIDDLE_UNSUBMITTED_WAKE_HINT}.` : "";
   const queue = snapshot.queue_elapsed_ms !== null ? ` queue_elapsed_ms=${snapshot.queue_elapsed_ms}` : "";
   const preSubmit = snapshot.pre_submission_elapsed_ms > 0 ? ` pre_submission_elapsed_ms=${snapshot.pre_submission_elapsed_ms}` : "";
-  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${queue}${preSubmit}`;
+  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${wakeHint}${queue}${preSubmit}`;
 }
 async function pollRiddleJob(config, jobId, options = {}) {
   if (!jobId?.trim()) throw new Error("jobId is required");
@@ -636,6 +639,7 @@ function createRiddleApiClient(config = {}) {
 0 && (module.exports = {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,

package/dist/runtime/index.d.cts

@@ -1 +1 @@
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, 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, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from '../riddle-client.cjs';

package/dist/runtime/index.d.ts

@@ -1 +1 @@
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, 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, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from '../riddle-client.js';

package/dist/runtime/index.js

@@ -1,6 +1,7 @@
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,
@@ -15,11 +16,12 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "../chunk-DI2XNGEZ.js";
+} from "../chunk-B2DP2LET.js";
 import "../chunk-MLKGABMK.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,

package/dist/runtime/riddle-client.cjs

@@ -32,6 +32,7 @@ var riddle_client_exports = {};
 __export(riddle_client_exports, {
   DEFAULT_RIDDLE_API_BASE_URL: () => DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE: () => DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT: () => RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError: () => RiddleApiError,
   collectRiddlePreviewDeployWarnings: () => collectRiddlePreviewDeployWarnings,
   createRiddleApiClient: () => createRiddleApiClient,
@@ -56,6 +57,7 @@ var import_node_os = require("os");
 var import_node_path = __toESM(require("path"), 1);
 var DEFAULT_RIDDLE_API_BASE_URL = "https://api.riddledc.com";
 var DEFAULT_RIDDLE_API_KEY_FILE = "/tmp/riddle-api-key";
+var RIDDLE_UNSUBMITTED_WAKE_HINT = "hosted worker may still be waking or waiting for a lease";
 var RiddleApiError = class extends Error {
   constructor(pathname, status, body) {
     super(`Riddle API ${pathname} failed HTTP ${status}: ${body}`);
@@ -523,9 +525,10 @@ function buildPollSnapshot(jobId, job, input) {
 function pollMessage(snapshot, timedOut) {
   if (!timedOut) return void 0;
   const submitted = snapshot.submitted_at || "not submitted";
+  const wakeHint = snapshot.running_without_submission && !snapshot.created_at && !snapshot.submitted_at ? ` ${RIDDLE_UNSUBMITTED_WAKE_HINT}.` : "";
   const queue = snapshot.queue_elapsed_ms !== null ? ` queue_elapsed_ms=${snapshot.queue_elapsed_ms}` : "";
   const preSubmit = snapshot.pre_submission_elapsed_ms > 0 ? ` pre_submission_elapsed_ms=${snapshot.pre_submission_elapsed_ms}` : "";
-  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${queue}${preSubmit}`;
+  return `Riddle job ${snapshot.job_id} did not reach a terminal status after ${snapshot.attempt} poll attempts; status=${snapshot.status || "unknown"} submitted_at=${submitted}.${wakeHint}${queue}${preSubmit}`;
 }
 async function pollRiddleJob(config, jobId, options = {}) {
   if (!jobId?.trim()) throw new Error("jobId is required");
@@ -636,6 +639,7 @@ function createRiddleApiClient(config = {}) {
 0 && (module.exports = {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,

package/dist/runtime/riddle-client.d.cts

@@ -1 +1 @@
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, 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, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from '../riddle-client.cjs';

package/dist/runtime/riddle-client.d.ts

@@ -1 +1 @@
-export { DEFAULT_RIDDLE_API_BASE_URL, DEFAULT_RIDDLE_API_KEY_FILE, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, 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, RIDDLE_UNSUBMITTED_WAKE_HINT, RiddleApiError, RiddleApiKeySource, RiddleBalanceResult, RiddleClientConfig, RiddleFetch, RiddlePollJobOptions, RiddlePollJobResult, RiddlePollProgressSnapshot, RiddlePollSummary, RiddlePreviewDeployProgressSnapshot, RiddlePreviewDeployResult, RiddlePreviewDeployStage, RiddlePreviewFramework, RiddleRunScriptInput, RiddleServerPreviewInput, RiddleServerPreviewResult, collectRiddlePreviewDeployWarnings, createRiddleApiClient, deployRiddlePreview, deployRiddleStaticPreview, getRiddleBalance, isTerminalRiddleJobStatus, parseRiddleViewport, pollRiddleJob, resolveRiddleApiKey, resolveRiddleApiKeySource, riddleRequestJson, runRiddleScript, runRiddleServerPreview } from '../riddle-client.js';

package/dist/runtime/riddle-client.js

@@ -1,6 +1,7 @@
 import {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,
@@ -15,11 +16,12 @@ import {
   riddleRequestJson,
   runRiddleScript,
   runRiddleServerPreview
-} from "../chunk-DI2XNGEZ.js";
+} from "../chunk-B2DP2LET.js";
 import "../chunk-MLKGABMK.js";
 export {
   DEFAULT_RIDDLE_API_BASE_URL,
   DEFAULT_RIDDLE_API_KEY_FILE,
+  RIDDLE_UNSUBMITTED_WAKE_HINT,
   RiddleApiError,
   collectRiddlePreviewDeployWarnings,
   createRiddleApiClient,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@riddledc/riddle-proof",
-  "version": "0.8.63",
+  "version": "0.8.65",
   "description": "Reusable Riddle Proof contracts and helpers for evidence-backed agent changes.",
   "license": "MIT",
   "author": "RiddleDC",
@@ -129,6 +129,11 @@
       "import": "./dist/profile.js",
       "require": "./dist/profile.cjs"
     },
+    "./profile-suggestions": {
+      "types": "./dist/profile-suggestions.d.ts",
+      "import": "./dist/profile-suggestions.js",
+      "require": "./dist/profile-suggestions.cjs"
+    },
     "./pr-comment": {
       "types": "./dist/pr-comment.d.ts",
       "import": "./dist/pr-comment.js",
@@ -239,7 +244,7 @@
     "typescript": "^5.4.5"
   },
   "scripts": {
-    "build": "npm --workspace @riddledc/riddle-proof-app-contract run build --if-present && tsup src/index.ts src/types.ts src/result.ts src/state.ts src/checkpoint.ts src/run-card.ts src/public-state.ts src/runner.ts src/engine-harness.ts src/codex-exec-agent.ts src/local-agent.ts src/cli.ts src/cli/index.ts src/diagnostics.ts src/proof-session.ts src/playability.ts src/basic-gameplay.ts src/profile.ts src/profile/index.ts src/pr-comment.ts src/openclaw.ts src/proof-run-core.ts src/proof-run-engine.ts src/riddle-client.ts src/runtime/riddle-client.ts src/spec/index.ts src/spec/types.ts src/spec/result.ts src/spec/state.ts src/spec/checkpoint.ts src/spec/run-card.ts src/spec/public-state.ts src/runtime/index.ts src/app-contract/index.ts src/advanced/index.ts src/advanced/runner.ts src/advanced/engine-harness.ts src/advanced/proof-run-core.ts src/advanced/proof-run-engine.ts src/adapters/openclaw.ts src/adapters/local-agent.ts src/adapters/codex-exec-agent.ts src/adapters/codex.ts --format cjs,esm --dts --out-dir dist --clean",
+    "build": "npm --workspace @riddledc/riddle-proof-app-contract run build --if-present && tsup src/index.ts src/types.ts src/result.ts src/state.ts src/checkpoint.ts src/run-card.ts src/public-state.ts src/runner.ts src/engine-harness.ts src/codex-exec-agent.ts src/local-agent.ts src/cli.ts src/cli/index.ts src/diagnostics.ts src/proof-session.ts src/playability.ts src/basic-gameplay.ts src/profile.ts src/profile/index.ts src/profile-suggestions.ts src/pr-comment.ts src/openclaw.ts src/proof-run-core.ts src/proof-run-engine.ts src/riddle-client.ts src/runtime/riddle-client.ts src/spec/index.ts src/spec/types.ts src/spec/result.ts src/spec/state.ts src/spec/checkpoint.ts src/spec/run-card.ts src/spec/public-state.ts src/runtime/index.ts src/app-contract/index.ts src/advanced/index.ts src/advanced/runner.ts src/advanced/engine-harness.ts src/advanced/proof-run-core.ts src/advanced/proof-run-engine.ts src/adapters/openclaw.ts src/adapters/local-agent.ts src/adapters/codex-exec-agent.ts src/adapters/codex.ts --format cjs,esm --dts --out-dir dist --clean",
     "clean": "rm -rf dist",
     "lint": "echo 'lint: (not configured)'",
     "test": "npm run build && node test.js && node proof-run.test.js && node formal-conformance.test.js && node trust-boundary.test.js && node regression-packs.test.js && python3 runtime/tests/trust_boundary_regression.py && python3 runtime/tests/ship_artifact_publication.py && (python3 runtime/tests/recon_verify_smoke.py >/tmp/riddle-proof-recon-verify-smoke.json || (tail -120 /tmp/riddle-proof-recon-verify-smoke.json; exit 1))"

package/runtime/lib/ship.py

@@ -676,6 +676,64 @@ def first_url_from_command_output(*parts):
     return ''
 
 
+def dict_value(value):
+    return value if isinstance(value, dict) else {}
+
+
+def proof_provenance_facts(state):
+    assessment = dict_value(state.get('proof_assessment'))
+    bundle = dict_value(state.get('evidence_bundle'))
+    bundle_session = dict_value(bundle.get('proof_session'))
+    proof_session = dict_value(state.get('proof_session')) or bundle_session
+    publication = dict_value(state.get('proof_artifact_publication'))
+    checkpoint_packet = dict_value(state.get('checkpoint_packet'))
+    checkpoint_summary = dict_value(state.get('checkpoint_summary'))
+    return {
+        'version': 'riddle-proof.provenance.v1',
+        'run_id': str(state.get('run_id') or ''),
+        'checkpoint_packet_id': str(
+            checkpoint_packet.get('packet_id')
+            or checkpoint_summary.get('latest_packet_id')
+            or ''
+        ),
+        'checkpoint_response_packet_id': str(
+            checkpoint_summary.get('latest_response_packet_id')
+            or ''
+        ),
+        'evidence_bundle_id': str(
+            bundle.get('evidence_bundle_id')
+            or bundle.get('bundle_id')
+            or bundle.get('id')
+            or ''
+        ),
+        'proof_session_id': str(
+            proof_session.get('session_id')
+            or bundle_session.get('session_id')
+            or ''
+        ),
+        'proof_session_fingerprint': str(
+            state.get('proof_session_fingerprint')
+            or proof_session.get('fingerprint')
+            or bundle_session.get('fingerprint')
+            or ''
+        ),
+        'proof_assessment_id': str(
+            assessment.get('assessment_id')
+            or assessment.get('id')
+            or ''
+        ),
+        'proof_assessment_source': str(
+            assessment.get('source')
+            or state.get('proof_assessment_source')
+            or ''
+        ),
+        'proof_assessment_decision': str(assessment.get('decision') or ''),
+        'artifact_publication_commit': str(publication.get('commit') or ''),
+        'artifact_manifest_url': str(publication.get('manifest_url') or ''),
+        'artifact_source_fingerprint': str(publication.get('source_fingerprint') or ''),
+    }
+
+
 def build_ship_report(state, marked_ready=None):
     branch = state.get('target_branch') or state.get('branch') or ''
     if marked_ready is None:
@@ -685,6 +743,7 @@ def build_ship_report(state, marked_ready=None):
     after_artifact_url = first_public_artifact_url(state, 'after', 'image') or state.get('after_cdn', '')
     artifact_publication = state.get('proof_artifact_publication') or {}
     ship_gate = ship_gate_report_facts(state)
+    proof_provenance = proof_provenance_facts(state)
     return {
         'pr_url': state.get('pr_url', ''),
         'pr_branch': branch,
@@ -703,6 +762,7 @@ def build_ship_report(state, marked_ready=None):
         'proof_artifacts_manifest_url': artifact_publication.get('manifest_url', '') if isinstance(artifact_publication, dict) else '',
         'proof_artifact_publication': artifact_publication if isinstance(artifact_publication, dict) else {},
         'ship_gate': ship_gate,
+        'proof_provenance': proof_provenance,
     }