@jphutchins/code-review 0.1.0-alpha.28 → 0.1.0-alpha.29

package/dist/index.js

@@ -186,6 +186,8 @@ var parseReviewedSha = (body) => {
   const sha = /<!-- reviewed-sha: ([0-9a-fA-F]{40}) -->/.exec(body)?.[1]?.toLowerCase();
   return sha && sha !== ZERO_SHA ? sha : null;
 };
+var REVIEW_COMPLETE_MARKER = "<!-- review-complete -->";
+var parseReviewComplete = (body) => body.includes(REVIEW_COMPLETE_MARKER);
 var parseFindingsMarker = (body) => {
   const match = /<!-- code-review:findings-json;base64 ([A-Za-z0-9+/=]+) -->/.exec(body);
   const b64 = match?.[1];
@@ -240,6 +242,8 @@ var computeSeverityCounts = (findings) => findings.reduce(
 var render = (input) => {
   const eta = new Eta({ autoTrim: false });
   const usageAvailable = input.envelope !== null;
+  const hasUsage = input.envelope !== null && input.envelope.models.length > 0;
+  const incomplete = input.incomplete ?? input.envelope?.incomplete ?? false;
   const costReport = input.envelope ? computeCost(input.envelope.models, input.prices) : null;
   const pricesProvided = input.pricesProvided ?? true;
   const route = input.route ?? input.envelope?.route ?? null;
@@ -249,6 +253,8 @@ var render = (input) => {
     findings: input.findings,
     envelope: input.envelope,
     usageAvailable,
+    hasUsage,
+    incomplete,
     costReport,
     pricesProvided,
     route,
@@ -602,7 +608,12 @@ var ResultEnvelopeCodec = t.intersection([
   t.partial({
     vendor_cost_usd: t.union([t.number, t.null]),
     route: t.string,
-    effort: t.string
+    effort: t.string,
+    // The run produced a notice rather than a completed review (security-gate block, agent kill, no
+    // recoverable findings). An empty `findings` array alone can't say this — a genuine clean review
+    // is also empty — so the render suppresses "clean review" and the sticky precedence guard refuses
+    // to bury a completed review under it. Absent ⇒ a completed review.
+    incomplete: t.boolean
   })
 ]);
 var ModelPricesCodec = t.type({
@@ -959,6 +970,35 @@ var formatMarkdown = (md) => {
 };
 var pad2 = (n) => String(n).padStart(2, "0");
 var formatUtc = (d) => `${String(d.getUTCFullYear())}-${pad2(d.getUTCMonth() + 1)}-${pad2(d.getUTCDate())} ${pad2(d.getUTCHours())}:${pad2(d.getUTCMinutes())} UTC`;
+
+// src/notice.ts
+var isNoticeKind = (s) => s === "security-blocked" || s === "setup-failed" || s === "diff-apply-failed" || s === "no-output";
+var blockquote = (text) => text.replaceAll("\n", "\n> ");
+var noticeSummary = (kind, reasons) => {
+  switch (kind) {
+    case "security-blocked":
+      return reasons !== void 0 && reasons.trim() !== "" ? `### \u{1F6D1} Code review skipped by the security gate
+
+The diff was flagged as unsafe to apply and execute:
+
+> ${blockquote(reasons)}` : "### \u{1F6D1} Code review skipped by the security gate\n\nThe security triage returned an unsafe verdict without a reason. See workflow logs.";
+    case "setup-failed":
+      return "### \u{1F6E0}\uFE0F Review did not run\n\nThe review job failed before the security triage could run (e.g. dependency install or environment setup). See the workflow logs \u2014 this is an infrastructure failure, not a security verdict.";
+    case "diff-apply-failed":
+      return "### \u26A0\uFE0F Could not apply the diff\n\nThe PR diff could not be applied to the checked-out base commit, so the review was skipped rather than run against an unmodified tree. See workflow logs.";
+    case "no-output":
+      return "### \u26A0\uFE0F Review did not complete\n\nThe diff passed triage but the review produced no output. See workflow logs.";
+  }
+};
+var buildNoticeEnvelope = (kind, reasons) => ({
+  schema_version: DEFAULT_SCHEMA_VERSION,
+  findings: noticeFindings(noticeSummary(kind, reasons)),
+  models: [],
+  turns: 0,
+  duration_ms: 0,
+  vendor_cost_usd: null,
+  incomplete: true
+});
 var identity = (decoded) => decoded;
 var findingsTable = [
   {
@@ -1417,6 +1457,15 @@ var post = async (input, ghApi = runGhApi) => {
     DEFAULT_MARKER,
     ghApi
   );
+  const existingComplete = existingSticky !== null && parseReviewComplete(existingSticky.body);
+  const wouldBuryCompleted = (incomplete) => incomplete && existingComplete;
+  const leaveInPlace = () => {
+    process.stderr.write(
+      `Review did not complete and the sticky already reflects a completed review \u2014 leaving it in place
+`
+    );
+    process.exit(0);
+  };
   const prices = JSON.parse(readFileSync(input.pricesPath, "utf-8"));
   const decodedPrices = PriceMapCodec.decode(prices);
   if (decodedPrices._tag === "Left") {
@@ -1428,6 +1477,7 @@ var post = async (input, ghApi = runGhApi) => {
     render({
       findings: noticeFindings(`### \u26A0\uFE0F ${message}`),
       envelope: null,
+      incomplete: true,
       prices: decodedPrices.right,
       pricesProvided: input.pricesProvided,
       template,
@@ -1440,6 +1490,7 @@ var post = async (input, ghApi = runGhApi) => {
     })
   );
   if (isEmptyDiff(diff)) {
+    if (wouldBuryCompleted(true)) leaveInPlace();
     await upsertSticky(
       input.repo,
       prNumber,
@@ -1451,6 +1502,7 @@ var post = async (input, ghApi = runGhApi) => {
   }
   const findingsResult = loadFindings(input.findingsPath);
   if (findingsResult.kind !== "ok") {
+    if (wouldBuryCompleted(true)) leaveInPlace();
     await upsertSticky(
       input.repo,
       prNumber,
@@ -1487,6 +1539,8 @@ var post = async (input, ghApi = runGhApi) => {
     );
     process.exit(0);
   }
+  const thisIncomplete = envelope.incomplete === true;
+  if (wouldBuryCompleted(thisIncomplete)) leaveInPlace();
   const findingsMarker = findingsPointer(findings, input.jsonUrl);
   const {
     comments: rawComments,
@@ -1510,6 +1564,7 @@ var post = async (input, ghApi = runGhApi) => {
   const commonRenderInput = {
     findings,
     envelope,
+    incomplete: thisIncomplete,
     prices: decodedPrices.right,
     pricesProvided: input.pricesProvided,
     template,
@@ -1624,7 +1679,7 @@ var announce = async (input, ghApi = runGhApi) => {
     DEFAULT_MARKER,
     ghApi
   );
-  if (existing !== null && parseReviewedSha(existing.body) === input.headSha.toLowerCase()) {
+  if (existing !== null && parseReviewComplete(existing.body) && parseReviewedSha(existing.body) === input.headSha.toLowerCase()) {
     process.stderr.write(
       `Sticky already reflects a completed review of ${input.headSha} \u2014 leaving it in place
 `
@@ -2365,6 +2420,7 @@ var buildEnvelope = (telemetry, native, agentFilePath, agentFileFallbackPath) =>
         findings: noticeFindings(`### \u26A0\uFE0F Review did not complete
 
 ${outcome.reason}`),
+        incomplete: true,
         ...telemetry
       };
   }
@@ -3125,6 +3181,30 @@ var adaptCmd = defineCommand({
 `);
   }
 });
+var noticeCmd = defineCommand({
+  meta: {
+    name: "notice",
+    description: "Emit an abstract envelope for a run that produced no completed review (security block, setup failure, unapplied diff, or empty run) \u2014 flagged incomplete so the commenter renders it honestly and won't bury a real review"
+  },
+  args: {
+    kind: {
+      type: "positional",
+      description: "One of: security-blocked, setup-failed, diff-apply-failed, no-output",
+      required: true
+    },
+    reasons: {
+      type: "string",
+      description: "security-blocked only: the triage's fail-closed reason string (empty/omitted \u21D2 the no-reason wording)"
+    }
+  },
+  run: ({ args }) => {
+    const kind = isNoticeKind(args.kind) ? args.kind : fail(
+      `Unknown notice kind "${args.kind}" \u2014 expected one of: security-blocked, setup-failed, diff-apply-failed, no-output`
+    );
+    process.stdout.write(`${JSON.stringify(buildNoticeEnvelope(kind, args.reasons), null, 2)}
+`);
+  }
+});
 var isExtractSchemaKind = (s) => s === "findings" || s === "triage";
 var requireExtractSchemaKind = (name) => isExtractSchemaKind(name) ? name : fail(`Unknown kind "${name}" for extract \u2014 expected one of: findings, triage`);
 var failClosedTriage = (outcome) => ({
@@ -3728,6 +3808,7 @@ var main = defineCommand({
     validate: validateCmd,
     "seed-draft": seedDraftCmd,
     adapt: adaptCmd,
+    notice: noticeCmd,
     extract: extractCmd,
     "validate-patches": validatePatchesCmd,
     "print-schema": printSchemaCmd,