@design-ai/cli 4.56.0 → 4.57.0

package/cli/lib/skill-proposals-render.mjs

@@ -0,0 +1,532 @@
+// Markdown/report rendering for skill proposal reviews, apply plans, and patches.
+
+import { existsSync, readFileSync } from "node:fs";
+import path from "node:path";
+
+import { PACKAGE_ROOT } from "./paths.mjs";
+
+function listItem(label, value) {
+  return `- ${label}: ${value}`;
+}
+
+function yesNo(value) {
+  return value ? "yes" : "no";
+}
+
+function normalizePatchPath(filePath) {
+  return String(filePath || "").replace(/\\/g, "/");
+}
+
+function readSkillLines(skillPath, sourceRoot) {
+  const absolutePath = path.resolve(sourceRoot, skillPath);
+  if (!existsSync(absolutePath)) {
+    return {
+      exists: false,
+      absolutePath,
+      lines: [],
+    };
+  }
+  const text = readFileSync(absolutePath, "utf8");
+  return {
+    exists: true,
+    absolutePath,
+    lines: text.split(/\r?\n/),
+  };
+}
+
+function patchSectionForProposal(proposal) {
+  const routes = Array.isArray(proposal.routeIds) && proposal.routeIds.length > 0
+    ? proposal.routeIds.join(", ")
+    : "artifact";
+  return [
+    "",
+    `## Local Learning Proposal: ${proposal.id}`,
+    "",
+    "<!-- Generated by design-ai learn --propose-skills --patch. Review manually before applying. -->",
+    "",
+    `- Category: ${proposal.category}`,
+    `- Routes: ${routes}`,
+    `- Risk: ${proposal.riskLevel}`,
+    `- Review status: ${proposal.reviewStatus || "pending"}`,
+    `- Evidence count: ${proposal.sourceIssueCount}`,
+    `- Proposed instruction: ${proposal.proposedInstructionDelta}`,
+    `- Verification: \`${proposal.verificationCommand}\``,
+  ];
+}
+
+function patchForSkillFile(skillPath, proposals, { sourceRoot }) {
+  const normalizedSkillPath = normalizePatchPath(skillPath);
+  const file = readSkillLines(normalizedSkillPath, sourceRoot);
+  const currentLines = file.lines.slice();
+  if (currentLines.length > 0 && currentLines[currentLines.length - 1] === "") {
+    currentLines.pop();
+  }
+  const addedLines = proposals.flatMap(patchSectionForProposal);
+  const fromPath = `a/${normalizedSkillPath}`;
+  const toPath = `b/${normalizedSkillPath}`;
+  const lines = [
+    `diff --git ${fromPath} ${toPath}`,
+    `--- ${file.exists ? fromPath : "/dev/null"}`,
+    `+++ ${toPath}`,
+  ];
+
+  if (currentLines.length === 0) {
+    lines.push(`@@ -0,0 +1,${addedLines.length} @@`);
+    for (const addedLine of addedLines) {
+      lines.push(`+${addedLine}`);
+    }
+    return lines;
+  }
+
+  const contextLine = currentLines[currentLines.length - 1];
+  lines.push(`@@ -${currentLines.length},1 +${currentLines.length},${addedLines.length + 1} @@`);
+  lines.push(` ${contextLine}`);
+  for (const addedLine of addedLines) {
+    lines.push(`+${addedLine}`);
+  }
+  return lines;
+}
+
+export function renderSkillEvolutionProposalPatch(payload, {
+  sourceRoot = PACKAGE_ROOT,
+} = {}) {
+  const proposals = Array.isArray(payload.proposals)
+    ? payload.proposals.filter((proposal) => !proposal.reviewClearsStrict)
+    : [];
+  const lines = [
+    "# design-ai skill proposal patch preview",
+    "# Preview-only output from `design-ai learn --propose-skills --patch`.",
+    "# Review manually before applying. This command does not edit skill files.",
+  ];
+
+  if (proposals.length === 0) {
+    lines.push((payload.proposalCount || 0) > 0
+      ? "# No pending skill proposal deltas remain after review-file decisions."
+      : "# No repeated check-capture groups crossed the proposal threshold.");
+    return `${lines.join("\n")}\n`;
+  }
+
+  const proposalsBySkill = new Map();
+  for (const proposal of proposals) {
+    const skillPath = proposal.candidateSkillPath || "skills/unknown/SKILL.md";
+    if (!proposalsBySkill.has(skillPath)) proposalsBySkill.set(skillPath, []);
+    proposalsBySkill.get(skillPath).push(proposal);
+  }
+
+  for (const [skillPath, skillProposals] of [...proposalsBySkill.entries()].sort((a, b) => a[0].localeCompare(b[0]))) {
+    lines.push("");
+    lines.push(...patchForSkillFile(skillPath, skillProposals, { sourceRoot }));
+  }
+
+  return `${lines.join("\n")}\n`;
+}
+
+export function renderSkillProposalReviewTemplate(payload, {
+  generatedAt = new Date(),
+} = {}) {
+  const generatedAtText = generatedAt instanceof Date ? generatedAt.toISOString() : String(generatedAt || "");
+  const proposals = Array.isArray(payload.proposals)
+    ? payload.proposals.filter((proposal) => !proposal.reviewClearsStrict)
+    : [];
+  const decisions = proposals.map((proposal) => ({
+    proposalId: proposal.id,
+    status: proposal.reviewStatus && proposal.reviewStatus !== "pending" ? proposal.reviewStatus : "deferred",
+    reviewedAt: "",
+    reviewer: "",
+    note: `Review ${proposal.candidateSkillPath}: ${proposal.title}`,
+  }));
+
+  return `${JSON.stringify({
+    version: 1,
+    generatedAt: generatedAtText,
+    source: "design-ai learn --propose-skills --review-template",
+    proposalFile: payload.file || "",
+    usageFile: payload.usageFile || "",
+    signalSource: payload.signalSource || "",
+    reviewFile: payload.reviewFile || "",
+    reviewPolicy: {
+      clearsStrict: ["applied", "rejected"],
+      remainsPending: ["accepted", "deferred"],
+    },
+    summary: {
+      proposalCount: payload.proposalCount || 0,
+      pendingReviewCount: payload.pendingReviewCount ?? proposals.length,
+      reviewedCount: payload.reviewedCount || 0,
+      templateDecisionCount: decisions.length,
+    },
+    decisions,
+  }, null, 2)}\n`;
+}
+
+export function renderSkillEvolutionProposalReport(payload, {
+  generatedAt = new Date(),
+} = {}) {
+  const generatedAtText = generatedAt instanceof Date ? generatedAt.toISOString() : String(generatedAt || "");
+  const lines = [
+    "# Skill Evolution Proposal Report",
+    "",
+    listItem("Generated", generatedAtText),
+    listItem("File", payload.file),
+    listItem("Usage sidecar", payload.usageFile),
+    listItem("Signal source", payload.signalSource),
+    listItem("Status", payload.status),
+    listItem("Signal status", payload.signalStatus),
+    listItem("Minimum evidence", payload.minEvidenceCount),
+    listItem("Check capture entries", payload.checkCaptureCount),
+    listItem("Candidate groups", payload.candidateCount),
+    listItem("Proposal count", payload.proposalCount),
+    listItem("Skipped groups", payload.skippedCount),
+    listItem("Pending review", payload.pendingReviewCount ?? payload.proposalCount ?? 0),
+    listItem("Reviewed", payload.reviewedCount ?? 0),
+    listItem("Dry run", yesNo(Boolean(payload.dryRun))),
+    listItem("Applied", yesNo(Boolean(payload.applied))),
+    "",
+    "## Proposed Skill Deltas",
+    "",
+  ];
+
+  if (!Array.isArray(payload.proposals) || payload.proposals.length === 0) {
+    lines.push("No repeated check-capture groups crossed the proposal threshold.");
+  } else {
+    for (const proposal of payload.proposals) {
+      const routes = Array.isArray(proposal.routeIds) && proposal.routeIds.length > 0
+        ? proposal.routeIds.join(", ")
+        : "artifact";
+      lines.push(`### ${proposal.title}`);
+      lines.push("");
+      lines.push(listItem("Proposal id", proposal.id));
+      lines.push(listItem("Candidate skill", proposal.candidateSkillPath));
+      lines.push(listItem("Category", proposal.category));
+      lines.push(listItem("Routes", routes));
+      lines.push(listItem("Risk", proposal.riskLevel));
+      lines.push(listItem("Review status", proposal.reviewStatus || "pending"));
+      if (proposal.reviewDecision?.reviewedAt) lines.push(listItem("Reviewed at", proposal.reviewDecision.reviewedAt));
+      if (proposal.reviewDecision?.reviewer) lines.push(listItem("Reviewer", proposal.reviewDecision.reviewer));
+      if (proposal.reviewDecision?.note) lines.push(listItem("Review note", proposal.reviewDecision.note));
+      lines.push(listItem("Source issues", proposal.sourceIssueCount));
+      lines.push(listItem("Rationale", proposal.rationale));
+      lines.push("");
+      lines.push("Proposed instruction delta:");
+      lines.push("");
+      lines.push(`> ${proposal.proposedInstructionDelta}`);
+      lines.push("");
+      lines.push("Verification:");
+      lines.push("");
+      lines.push(`\`\`\`bash`);
+      lines.push(proposal.verificationCommand);
+      lines.push(`\`\`\``);
+      lines.push("");
+      lines.push("Evidence:");
+      const evidenceSources = Array.isArray(proposal.evidenceSources) ? proposal.evidenceSources : [];
+      for (const evidence of evidenceSources) {
+        const title = evidence.title ? ` / ${evidence.title}` : "";
+        lines.push(`- \`${evidence.entryId}\` [${evidence.category}] ${evidence.source}${title}`);
+        if (evidence.createdAt) lines.push(`  - Captured: ${evidence.createdAt}`);
+        if (evidence.textPreview) lines.push(`  - Preview: ${evidence.textPreview}`);
+      }
+      lines.push("");
+    }
+  }
+
+  const review = payload.review || {};
+  lines.push("## Review File", "");
+  if (review.file) {
+    lines.push(listItem("File", review.file));
+    lines.push(listItem("Exists", yesNo(Boolean(review.exists))));
+    lines.push(listItem("Status", review.status || "unknown"));
+    lines.push(listItem("Decisions", review.decisionCount || 0));
+    lines.push(listItem("Matched", review.matchedCount || 0));
+    lines.push(listItem("Stale", review.staleCount || 0));
+    lines.push(listItem("Pending", review.pendingCount ?? 0));
+    lines.push(listItem("Applied", review.appliedCount || 0));
+    lines.push(listItem("Rejected", review.rejectedCount || 0));
+    lines.push(listItem("Accepted", review.acceptedCount || 0));
+    lines.push(listItem("Deferred", review.deferredCount || 0));
+    if (Array.isArray(review.warnings) && review.warnings.length > 0) {
+      lines.push("");
+      lines.push("Warnings:");
+      for (const warning of review.warnings) lines.push(`- ${warning}`);
+    }
+  } else {
+    lines.push("No review file was provided.");
+  }
+  lines.push("");
+
+  lines.push("## Skipped Groups", "");
+  if (!Array.isArray(payload.skipped) || payload.skipped.length === 0) {
+    lines.push("No candidate groups were skipped.");
+  } else {
+    for (const item of payload.skipped) {
+      lines.push(`- \`${item.candidateSkillPath}\` [${item.category}]: ${item.reason}`);
+      const evidenceSources = Array.isArray(item.evidenceSources) ? item.evidenceSources : [];
+      for (const evidence of evidenceSources) {
+        lines.push(`  - Evidence: \`${evidence.entryId}\` ${evidence.source}`);
+      }
+    }
+  }
+
+  lines.push("", "## Recommendations", "");
+  if (!Array.isArray(payload.recommendations) || payload.recommendations.length === 0) {
+    lines.push("No recommendations emitted.");
+  } else {
+    for (const recommendation of payload.recommendations) {
+      lines.push(`- ${recommendation.level}: ${recommendation.text}`);
+    }
+  }
+
+  const privacy = payload.privacy || {};
+  lines.push("", "## Privacy And Boundaries", "");
+  lines.push(listItem("Mutates learning profile", yesNo(Boolean(privacy.mutatesProfile))));
+  lines.push(listItem("Mutates skill files", yesNo(Boolean(privacy.mutatesSkillFiles))));
+  lines.push(listItem("Calls external AI APIs", yesNo(Boolean(privacy.callsExternalAiApis))));
+  lines.push(listItem("Stores raw brief text", yesNo(Boolean(privacy.storesRawBriefText))));
+  lines.push(listItem("Includes entry text preview", yesNo(Boolean(privacy.exposesEntryTextPreview))));
+
+  lines.push("", "## Next Steps", "");
+  if ((payload.proposalCount || 0) > 0) {
+    lines.push("- Review each proposed instruction delta manually before editing any skill file.");
+    lines.push("- Mark resolved proposals as `applied` or `rejected` in the review file to clear the strict proposal gate.");
+    lines.push("- Run the proposal verification command after applying an accepted skill edit.");
+    lines.push("- Re-run `design-ai learn --propose-skills --strict --json` to confirm no pending proposal gate remains.");
+  } else {
+    lines.push("- Keep capturing explicit `design-ai check --learn --yes` warning/failure results until repeated evidence exists.");
+    lines.push("- Re-run this report after new check-capture entries are added.");
+  }
+  lines.push("- This report is preview-only evidence; it does not apply changes.");
+
+  return `${lines.join("\n")}\n`;
+}
+
+export function renderSkillProposalApplyPlanReport(payload, {
+  generatedAt = new Date(),
+} = {}) {
+  const generatedAtText = generatedAt instanceof Date ? generatedAt.toISOString() : String(generatedAt || "");
+  const lines = [
+    "# Skill Proposal Apply Plan",
+    "",
+    listItem("Generated", generatedAtText),
+    listItem("Status", payload.status),
+    listItem("Proposal status", payload.proposalStatus),
+    listItem("Signal status", payload.signalStatus),
+    listItem("File", payload.file),
+    listItem("Usage sidecar", payload.usageFile),
+    listItem("Signal source", payload.signalSource),
+    listItem("Review file", payload.reviewFile || "not configured"),
+    listItem("Accepted proposals", payload.acceptedCount || 0),
+    listItem("Pending review", payload.pendingReviewCount || 0),
+    listItem("Reviewed", payload.reviewedCount || 0),
+    "",
+    "## Manual Apply Tasks",
+    "",
+  ];
+
+  if (!Array.isArray(payload.tasks) || payload.tasks.length === 0) {
+    lines.push("No accepted skill proposals are ready for manual apply.");
+  } else {
+    for (const task of payload.tasks) {
+      lines.push(`### ${task.title}`);
+      lines.push("");
+      lines.push(listItem("Proposal id", task.proposalId));
+      lines.push(listItem("Candidate skill", task.candidateSkillPath));
+      lines.push(listItem("Category", task.category));
+      lines.push(listItem("Routes", (task.routeIds || []).join(", ") || "artifact"));
+      lines.push(listItem("Risk", task.riskLevel));
+      lines.push(listItem("Source issues", task.sourceIssueCount));
+      if (task.reviewDecision?.reviewer) lines.push(listItem("Reviewer", task.reviewDecision.reviewer));
+      if (task.reviewDecision?.reviewedAt) lines.push(listItem("Reviewed at", task.reviewDecision.reviewedAt));
+      if (task.reviewDecision?.note) lines.push(listItem("Review note", task.reviewDecision.note));
+      if (task.rationale) lines.push(listItem("Rationale", task.rationale));
+      lines.push("");
+      lines.push("Proposed instruction delta:");
+      lines.push("");
+      lines.push(`> ${task.proposedInstructionDelta}`);
+      lines.push("");
+      lines.push("Manual steps:");
+      for (const step of task.manualSteps || []) lines.push(`- ${step}`);
+      lines.push("");
+      lines.push("Verification:");
+      lines.push("");
+      lines.push("```bash");
+      lines.push(task.verificationCommand);
+      lines.push("```");
+      lines.push("");
+      lines.push("Safety checklist:");
+      for (const item of task.safetyChecklist || []) lines.push(`- ${item}`);
+      lines.push("");
+      lines.push("Evidence:");
+      for (const evidence of task.evidenceSources || []) {
+        const title = evidence.title ? ` / ${evidence.title}` : "";
+        lines.push(`- \`${evidence.entryId}\` [${evidence.category}] ${evidence.source}${title}`);
+        if (evidence.textPreview) lines.push(`  - Preview: ${evidence.textPreview}`);
+      }
+      lines.push("");
+    }
+  }
+
+  lines.push("## Follow-up Commands", "");
+  const commands = payload.commands || {};
+  for (const [label, command] of Object.entries(commands)) {
+    lines.push(listItem(label, `\`${command}\``));
+  }
+
+  const commandContract = payload.commandContract || {};
+  lines.push("", "## Command Contract", "");
+  lines.push(listItem("Valid", yesNo(Boolean(commandContract.valid))));
+  lines.push(listItem("Status", commandContract.status || "unknown"));
+  lines.push(listItem("Command count", commandContract.commandCount || 0));
+  lines.push(listItem("Check count", commandContract.checkCount || 0));
+  lines.push(listItem("Pass count", commandContract.passCount || 0));
+  lines.push(listItem("Warning count", commandContract.warningCount || 0));
+  lines.push(listItem("Required keys", (commandContract.requiredKeys || []).join(", ") || "none"));
+  lines.push(listItem("Review file required", yesNo(Boolean(commandContract.reviewFileRequired))));
+  lines.push(listItem("Forbidden flags", (commandContract.forbiddenFlags || []).join(", ") || "none"));
+  lines.push(listItem("Failure count", commandContract.failureCount || 0));
+  lines.push(listItem("Failed checks", (commandContract.failedCheckIds || []).join(", ") || "none"));
+  lines.push(listItem("Next command key", commandContract.nextCommandKey || "none"));
+  lines.push(listItem("Next command policy", commandContract.nextCommandRunPolicy || "none"));
+  if (commandContract.nextCommandSafety?.level) lines.push(listItem("Next command safety", commandContract.nextCommandSafety.level));
+  if (commandContract.nextCommand) lines.push(listItem("Next command", `\`${commandContract.nextCommand}\``));
+  lines.push(listItem("Command sequence count", commandContract.commandSequenceCount || 0));
+  lines.push(listItem("Command sequence keys", (commandContract.commandSequenceKeys || []).join(", ") || "none"));
+  const sequenceSummary = commandContract.commandSequenceSummary || {};
+  lines.push(listItem("Command sequence policy", sequenceSummary.runPolicy || "none"));
+  lines.push(listItem("Command sequence executable", yesNo(Boolean(sequenceSummary.executable))));
+  lines.push(listItem("Command sequence local outputs", sequenceSummary.localOutputStepCount || 0));
+  lines.push(listItem("Command sequence mutates profile", yesNo(Boolean(sequenceSummary.mutatesProfile))));
+  lines.push(listItem("Command sequence mutates review file", yesNo(Boolean(sequenceSummary.mutatesReviewFile))));
+  lines.push(listItem("Command sequence mutates skill files", yesNo(Boolean(sequenceSummary.mutatesSkillFiles))));
+  lines.push(listItem("Command sequence calls external AI APIs", yesNo(Boolean(sequenceSummary.callsExternalAiApis))));
+  const operatorRunbook = commandContract.operatorRunbook || {};
+  lines.push(listItem("Operator runbook stages", operatorRunbook.stageCount || 0));
+  lines.push(listItem("Operator runbook keys", (operatorRunbook.stageKeys || []).join(", ") || "none"));
+  lines.push(listItem("Operator runbook required stages", operatorRunbook.requiredStageCount || 0));
+  lines.push(listItem("Operator runbook next stage", operatorRunbook.nextStageKey || "none"));
+  lines.push(listItem("Operator runbook next required stage", operatorRunbook.nextRequiredStageKey || "none"));
+  lines.push(listItem("Operator runbook next required command stage", operatorRunbook.nextRequiredCommandStageKey || "none"));
+  if (operatorRunbook.stageSelection?.strategy) {
+    lines.push(listItem("Operator runbook stage selection", operatorRunbook.stageSelection.strategy));
+    if (operatorRunbook.stageSelection.decision?.action) {
+      lines.push(listItem("Operator runbook decision", operatorRunbook.stageSelection.decision.action));
+      if (operatorRunbook.stageSelection.decision.safety?.level) {
+        lines.push(listItem("Operator runbook decision safety", operatorRunbook.stageSelection.decision.safety.level));
+      }
+      if (Array.isArray(operatorRunbook.stageSelection.decision.commands)) {
+        lines.push(listItem("Operator runbook decision commands", operatorRunbook.stageSelection.decision.commands.map((command) => command.key).join(", ") || "none"));
+      }
+      if (operatorRunbook.stageSelection.decision.nextCommandKey) {
+        lines.push(listItem("Operator runbook decision next command", operatorRunbook.stageSelection.decision.nextCommandKey));
+      }
+    }
+    if (operatorRunbook.stageSelection.nextStage?.key) {
+      const nextStageLabel = operatorRunbook.stageSelection.nextStage.required ? "required" : "optional";
+      lines.push(listItem("Operator runbook selected stage", `${operatorRunbook.stageSelection.nextStage.key} (${nextStageLabel}, ${operatorRunbook.stageSelection.nextStage.kind})`));
+    }
+  }
+  const commandSequence = Array.isArray(commandContract.commandSequence) ? commandContract.commandSequence : [];
+  if (commandSequence.length > 0) {
+    lines.push("");
+    lines.push("Command sequence:");
+    for (const item of commandSequence) {
+      const safetyLevel = item.safety?.level || "unknown";
+      lines.push(`- ${item.step}. ${item.key} (${item.runPolicy || "unknown"} / ${safetyLevel}): \`${item.command}\``);
+    }
+  }
+  const runbookStages = Array.isArray(operatorRunbook.stages) ? operatorRunbook.stages : [];
+  if (runbookStages.length > 0) {
+    lines.push("");
+    lines.push("Operator runbook:");
+    for (const stage of runbookStages) {
+      const required = stage.required ? "required" : "optional";
+      const commandKeys = Array.isArray(stage.commandKeys) && stage.commandKeys.length > 0
+        ? stage.commandKeys.join(", ")
+        : "manual";
+      lines.push(`- ${stage.step}. ${stage.key} (${required} / ${stage.kind || "unknown"}): ${commandKeys}`);
+    }
+  }
+  if (commandContract.nextAction) lines.push(listItem("Next action", commandContract.nextAction));
+  const missingCommandKeys = Array.isArray(commandContract.missingCommandKeys) ? commandContract.missingCommandKeys : [];
+  const unexpectedCommandKeys = Array.isArray(commandContract.unexpectedCommandKeys) ? commandContract.unexpectedCommandKeys : [];
+  if (missingCommandKeys.length > 0) lines.push(listItem("Missing command keys", missingCommandKeys.join(", ")));
+  if (unexpectedCommandKeys.length > 0) lines.push(listItem("Unexpected command keys", unexpectedCommandKeys.join(", ")));
+  const failedChecks = Array.isArray(commandContract.failedChecks) ? commandContract.failedChecks : [];
+  if (failedChecks.length > 0) {
+    lines.push("");
+    lines.push("Failed command checks:");
+    for (const check of failedChecks) {
+      lines.push(`- ${check.id}: ${check.message}`);
+    }
+  }
+
+  lines.push("", "## Recommendations", "");
+  for (const recommendation of payload.recommendations || []) {
+    lines.push(`- ${recommendation.level}: ${recommendation.text}`);
+  }
+
+  const privacy = payload.privacy || {};
+  lines.push("", "## Privacy And Boundaries", "");
+  lines.push(listItem("Mutates learning profile", yesNo(Boolean(privacy.mutatesProfile))));
+  lines.push(listItem("Mutates review file", yesNo(Boolean(privacy.mutatesReviewFile))));
+  lines.push(listItem("Mutates skill files", yesNo(Boolean(privacy.mutatesSkillFiles))));
+  lines.push(listItem("Calls external AI APIs", yesNo(Boolean(privacy.callsExternalAiApis))));
+  lines.push(listItem("Stores raw brief text", yesNo(Boolean(privacy.storesRawBriefText))));
+  lines.push(listItem("Includes entry text preview", yesNo(Boolean(privacy.exposesEntryTextPreview))));
+
+  return `${lines.join("\n")}\n`;
+}
+
+export function renderSkillProposalReviewCheckReport(payload, {
+  generatedAt = new Date(),
+} = {}) {
+  const generatedAtText = generatedAt instanceof Date ? generatedAt.toISOString() : String(generatedAt || "");
+  const lines = [
+    "# Skill Proposal Review Check",
+    "",
+    listItem("Generated", generatedAtText),
+    listItem("Status", payload.status),
+    listItem("Proposal status", payload.proposalStatus),
+    listItem("Signal status", payload.signalStatus),
+    listItem("File", payload.file),
+    listItem("Usage sidecar", payload.usageFile),
+    listItem("Signal source", payload.signalSource),
+    listItem("Review file", payload.reviewFile || "not configured"),
+    listItem("Proposals", payload.proposalCount),
+    listItem("Pending review", payload.pendingReviewCount),
+    listItem("Reviewed", payload.reviewedCount),
+    "",
+    "## Checks",
+    "",
+  ];
+
+  for (const check of payload.checks || []) {
+    lines.push(`- ${check.level}: ${check.id} - ${check.message}`);
+  }
+
+  const review = payload.review || {};
+  lines.push("", "## Review Summary", "");
+  lines.push(listItem("Exists", yesNo(Boolean(review.exists))));
+  lines.push(listItem("Status", review.status || "unknown"));
+  lines.push(listItem("Decisions", review.decisionCount || 0));
+  lines.push(listItem("Matched", review.matchedCount || 0));
+  lines.push(listItem("Stale", review.staleCount || 0));
+  lines.push(listItem("Applied", review.appliedCount || 0));
+  lines.push(listItem("Rejected", review.rejectedCount || 0));
+  lines.push(listItem("Accepted", review.acceptedCount || 0));
+  lines.push(listItem("Deferred", review.deferredCount || 0));
+  if (Array.isArray(review.warnings) && review.warnings.length > 0) {
+    lines.push("", "Warnings:");
+    for (const warning of review.warnings) lines.push(`- ${warning}`);
+  }
+
+  lines.push("", "## Recommendations", "");
+  for (const recommendation of payload.recommendations || []) {
+    lines.push(`- ${recommendation.level}: ${recommendation.text}`);
+  }
+
+  lines.push("", "## Privacy And Boundaries", "");
+  lines.push(listItem("Mutates learning profile", yesNo(Boolean(payload.privacy?.mutatesProfile))));
+  lines.push(listItem("Mutates skill files", yesNo(Boolean(payload.privacy?.mutatesSkillFiles))));
+  lines.push(listItem("Calls external AI APIs", yesNo(Boolean(payload.privacy?.callsExternalAiApis))));
+  lines.push(listItem("Stores raw brief text", yesNo(Boolean(payload.privacy?.storesRawBriefText))));
+
+  return `${lines.join("\n")}\n`;
+}