@riddledc/riddle-proof 0.8.36 → 0.8.38

package/dist/{chunk-E25K5PDM.js → chunk-U44KBAPH.js}

@@ -1,3 +1,13 @@
+import {
+  createRiddleApiClient,
+  isTerminalRiddleJobStatus,
+  parseRiddleViewport
+} from "./chunk-DI2XNGEZ.js";
+import {
+  RIDDLE_PROOF_PR_COMMENT_MARKER,
+  buildRiddleProofPrCommentMarkdown,
+  summarizeRiddleProofPrComment
+} from "./chunk-6KYXX4OE.js";
 import {
   RIDDLE_PROOF_PROFILE_EVIDENCE_VERSION,
   assessRiddleProofProfileEvidence,
@@ -13,11 +23,6 @@ import {
   resolveRiddleProofProfileTargetUrl,
   resolveRiddleProofProfileTimeoutSec
 } from "./chunk-Z2LCVROU.js";
-import {
-  createRiddleApiClient,
-  isTerminalRiddleJobStatus,
-  parseRiddleViewport
-} from "./chunk-TWTEUS7R.js";
 import {
   createDisabledRiddleProofAgentAdapter,
   readRiddleProofRunStatus,
@@ -56,11 +61,14 @@ var KNOWN_CLI_OPTIONS = /* @__PURE__ */ new Set([
   "codexSandbox",
   "codexTimeoutMs",
   "command",
+  "commentMode",
   "continueWithStage",
   "createdAt",
   "decision",
   "defaultReviewer",
   "defaultShipMode",
+  "bodyFile",
+  "dryRun",
   "exclude",
   "format",
   "framework",
@@ -88,20 +96,25 @@ var KNOWN_CLI_OPTIONS = /* @__PURE__ */ new Set([
   "pack",
   "packFile",
   "profile",
+  "proofDir",
+  "pr",
   "progressEveryMs",
   "quiet",
   "readinessPath",
   "readinessTimeout",
   "reasonsJson",
+  "repo",
   "requestJson",
   "requiredJson",
   "responseJson",
   "resultFormat",
+  "resultJson",
   "resultsDir",
   "riddleEngineModuleUrl",
   "riddleProofDir",
   "route",
   "runDir",
+  "runResponse",
   "runner",
   "scriptFile",
   "sourceKind",
@@ -138,9 +151,10 @@ function usage() {
     "  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 regression-pack run [--pack oc-flow-regression|--pack-file <file>] [--local-core true|false; default true] [--hosted-riddle true|false; default false] [--format json|markdown|compact-json; default json] [--output <dir>|--output-dir <dir>]",
+    "  riddle-proof-loop pr-comment --proof-dir <dir>|--run-response <file> [--result-json <file>] --pr <number|url> [--repo owner/name] [--dry-run] [--body-file <file>] [--comment-mode update|append]",
     "  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]",
+    "  riddle-proof-loop riddle-preview-deploy <build-dir> <label> [--framework spa|static] [--quiet]",
     "  riddle-proof-loop riddle-server-preview <directory> --script-file <file> [--path /route] [--wait-for-selector selector]",
     "  riddle-proof-loop riddle-run-script --url <url> --script-file <file> [--viewport 1280x720] [--strict true|false]",
     "  riddle-proof-loop riddle-poll <job-id> [--wait] [--attempts n] [--quiet]",
@@ -909,6 +923,18 @@ function formatPollDuration(ms) {
   const remainder = seconds % 60;
   return minutes > 0 ? `${minutes}m${String(remainder).padStart(2, "0")}s` : `${seconds}s`;
 }
+function formatByteCount(bytes) {
+  if (typeof bytes !== "number" || !Number.isFinite(bytes)) return "n/a";
+  if (bytes < 1024) return `${bytes}B`;
+  const units = ["KB", "MB", "GB", "TB"];
+  let value = bytes / 1024;
+  let unitIndex = 0;
+  while (value >= 1024 && unitIndex < units.length - 1) {
+    value /= 1024;
+    unitIndex += 1;
+  }
+  return `${value >= 10 ? value.toFixed(0) : value.toFixed(1)}${units[unitIndex]}`;
+}
 function riddlePollProgressLine(snapshot) {
   const submittedAt = snapshot.submitted_at || "not-submitted";
   const queuePart = snapshot.running_without_submission ? ` waiting_for_submit=${formatPollDuration(snapshot.pre_submission_elapsed_ms)}${snapshot.queue_elapsed_ms !== null ? ` queued_for=${formatPollDuration(snapshot.queue_elapsed_ms)}` : ""}` : snapshot.queue_elapsed_ms !== null ? ` queue=${formatPollDuration(snapshot.queue_elapsed_ms)}` : "";
@@ -922,6 +948,93 @@ function riddlePollProgressLine(snapshot) {
     `submitted_at=${submittedAt}${queuePart}${terminalPart}`
   ].join(" ");
 }
+function riddlePreviewProgressLine(snapshot) {
+  const idPart = snapshot.id ? ` id=${snapshot.id}` : "";
+  const statusPart = snapshot.status ? ` status=${snapshot.status}` : "";
+  const attemptPart = snapshot.attempt && snapshot.attempts ? ` attempt=${snapshot.attempt}/${snapshot.attempts}` : "";
+  const previewPart = snapshot.preview_url ? ` url=${snapshot.preview_url}` : "";
+  const filePart = typeof snapshot.file_count === "number" ? ` files=${snapshot.file_count}` : "";
+  const totalPart = typeof snapshot.total_bytes === "number" ? ` bytes=${formatByteCount(snapshot.total_bytes)}` : "";
+  const archivePart = typeof snapshot.tarball_bytes === "number" ? ` archive=${formatByteCount(snapshot.tarball_bytes)}` : "";
+  const recoveryPart = snapshot.publish_error ? ` publish_error=${JSON.stringify(snapshot.publish_error)}` : "";
+  const messagePart = snapshot.message ? ` ${snapshot.message}` : "";
+  return `[riddle-preview] ${snapshot.stage}${idPart}${statusPart}${attemptPart} elapsed=${formatPollDuration(snapshot.elapsed_ms)} label=${snapshot.label} framework=${snapshot.framework}${filePart}${totalPart}${archivePart}${previewPart}${recoveryPart}${messagePart}`;
+}
+function readJsonFileIfExists(filePath) {
+  if (!filePath || !existsSync(filePath)) return void 0;
+  return readJsonValue(filePath, filePath);
+}
+function defaultProofDirJsonPath(proofDir, filename) {
+  return proofDir ? path.join(proofDir, filename) : void 0;
+}
+function prNumberFromValue(value) {
+  const text = value?.trim();
+  if (!text) return "";
+  const match = text.match(/\/pull\/(\d+)(?:\/|$)/) || text.match(/^#?(\d+)$/);
+  return match ? match[1] : text;
+}
+function ghJson(args, input) {
+  const result = spawnSync("gh", args, {
+    input: typeof input === "undefined" ? void 0 : `${JSON.stringify(input)}
+`,
+    encoding: "utf-8",
+    timeout: 9e4
+  });
+  if (result.error) throw result.error;
+  if (result.status !== 0) {
+    const detail = (result.stderr || result.stdout || "").trim();
+    throw new Error(`gh ${args.join(" ")} failed${detail ? `: ${detail}` : ""}`);
+  }
+  const stdout = (result.stdout || "").trim();
+  return stdout ? JSON.parse(stdout) : {};
+}
+function resolveGhRepoName(repoOption) {
+  if (repoOption?.trim()) return repoOption.trim();
+  const result = spawnSync("gh", ["repo", "view", "--json", "nameWithOwner", "--jq", ".nameWithOwner"], {
+    encoding: "utf-8",
+    timeout: 3e4
+  });
+  if (result.error) throw result.error;
+  if (result.status !== 0 || !result.stdout.trim()) {
+    const detail = (result.stderr || result.stdout || "").trim();
+    throw new Error(`Could not resolve GitHub repository. Pass --repo owner/name.${detail ? ` gh said: ${detail}` : ""}`);
+  }
+  return result.stdout.trim();
+}
+function findManagedPrComment(repo, prNumber) {
+  const comments = ghJson(["api", `repos/${repo}/issues/${prNumber}/comments`, "--paginate"]);
+  return comments.find((comment) => typeof comment.body === "string" && comment.body.includes(RIDDLE_PROOF_PR_COMMENT_MARKER));
+}
+function upsertPrComment(input) {
+  const payload = { body: input.body };
+  if (input.mode !== "append") {
+    const existing = findManagedPrComment(input.repo, input.prNumber);
+    if (existing?.id) {
+      return {
+        action: "updated",
+        comment: ghJson([
+          "api",
+          `repos/${input.repo}/issues/comments/${existing.id}`,
+          "-X",
+          "PATCH",
+          "--input",
+          "-"
+        ], payload)
+      };
+    }
+  }
+  return {
+    action: "created",
+    comment: ghJson([
+      "api",
+      `repos/${input.repo}/issues/${input.prNumber}/comments`,
+      "-X",
+      "POST",
+      "--input",
+      "-"
+    ], payload)
+  };
+}
 function readJsonValue(value, label) {
   if (!value) throw new Error(`${label} is required.`);
   const raw = value === "-" ? readStdin() : existsSync(value) ? readFileSync(value, "utf-8") : value;
@@ -4554,6 +4667,47 @@ async function main() {
     process.exitCode = result.ok ? 0 : 1;
     return;
   }
+  if (command === "pr-comment") {
+    const proofDir = optionString(options, "proofDir") || optionString(options, "outputDir") || positional[1];
+    const runResponsePath = optionString(options, "runResponse") || defaultProofDirJsonPath(proofDir, "riddle-run-response.json");
+    const resultJsonPath = optionString(options, "resultJson") || defaultProofDirJsonPath(proofDir, "result.json");
+    const runResponse = readJsonFileIfExists(runResponsePath);
+    const result = readJsonFileIfExists(resultJsonPath);
+    if (!runResponse && !result) {
+      throw new Error("pr-comment requires --proof-dir with riddle-run-response.json/result.json or explicit --run-response/--result-json.");
+    }
+    const body = buildRiddleProofPrCommentMarkdown({
+      title: optionString(options, "title"),
+      goal: optionString(options, "summary"),
+      successCriteria: optionString(options, "successCriteria"),
+      runResponse,
+      result
+    });
+    const bodyFile = optionString(options, "bodyFile");
+    if (bodyFile) writeFileSync(bodyFile, body);
+    if (optionBoolean(options, "dryRun")) {
+      process.stdout.write(body);
+      return;
+    }
+    const prNumber = prNumberFromValue(optionString(options, "pr"));
+    if (!prNumber) throw new Error("pr-comment requires --pr <number|url> unless --dry-run is used.");
+    const commentMode = optionString(options, "commentMode") || "update";
+    if (!["update", "append"].includes(commentMode)) throw new Error("--comment-mode must be update or append.");
+    const repo = resolveGhRepoName(optionString(options, "repo"));
+    const resultPayload = upsertPrComment({ repo, prNumber, body, mode: commentMode });
+    const comment = resultPayload.comment;
+    process.stdout.write(`${JSON.stringify({
+      ok: true,
+      action: resultPayload.action,
+      repo,
+      pr: prNumber,
+      comment_url: cliString(comment.html_url) || null,
+      summary: summarizeRiddleProofPrComment({ runResponse, result }),
+      body_file: bodyFile || null
+    }, null, 2)}
+`);
+    return;
+  }
   if (command === "profile-http-status-preflight") {
     const profile = normalizeProfileForCli(options);
     const result = await preflightRiddleProofProfileHttpStatusChecks(profile);
@@ -4597,7 +4751,14 @@ async function main() {
   if (command === "riddle-preview-deploy") {
     const buildDir = positional[1];
     const label = positional[2];
-    const result = await createRiddleApiClient(riddleClientConfig(options)).deployPreview(buildDir, label, previewFrameworkOption(options));
+    const clientConfig = riddleClientConfig(options);
+    if (options.quiet !== true) {
+      clientConfig.onPreviewProgress = (snapshot) => {
+        process.stderr.write(`${riddlePreviewProgressLine(snapshot)}
+`);
+      };
+    }
+    const result = await createRiddleApiClient(clientConfig).deployPreview(buildDir, label, previewFrameworkOption(options));
     for (const warning of result.warnings ?? []) {
       process.stderr.write(`Warning: ${warning}
 `);

package/dist/cli/index.js

@@ -1,6 +1,7 @@
-import "../chunk-E25K5PDM.js";
+import "../chunk-U44KBAPH.js";
+import "../chunk-DI2XNGEZ.js";
+import "../chunk-6KYXX4OE.js";
 import "../chunk-Z2LCVROU.js";
-import "../chunk-TWTEUS7R.js";
 import "../chunk-ZREWMTFA.js";
 import "../chunk-ZQWVXQKJ.js";
 import "../chunk-RDPG554T.js";