feat(forge): complete Slack bridge — schema previews, thumbnails, draft migration

Move prose draft mappers to workflow-mappers, add schema field previews and
page-1 confirm thumbnails across workflows, metrics routing, template upgrade
on held drafts, and Slack markup stripping in gather paths.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: pugstro

src/slack/confirm/board.ts

@@ -1,6 +1,6 @@
 import type { KnownBlock } from "@slack/web-api";
 import type { BoardQuality } from "../gather/board.js";
-import { formatEnginePreviewLine } from "./engine-summary.js";
+import { formatEnginePreviewLine, formatSchemaFieldPreview } from "./engine-summary.js";
 
 function kpiPreview(metricNames: string[], max = 4): string {
   const lines = metricNames.slice(0, max).map((name) => `• ${name}`);
@@ -17,8 +17,9 @@ export function buildBoardConfirmBlocks(input: {
   filename: string;
 }): KnownBlock[] {
   const rowCount = Math.max(0, input.quality.lineCount - 1);
+  const fields = formatSchemaFieldPreview(input.draftData);
 
-  return [
+  const blocks: KnownBlock[] = [
     {
       type: "section",
       text: {
@@ -32,6 +33,13 @@ export function buildBoardConfirmBlocks(input: {
           })}_`,
       },
     },
+  ];
+
+  if (fields) {
+    blocks.push({ type: "section", text: { type: "mrkdwn", text: fields } });
+  }
+
+  blocks.push(
     {
       type: "section",
       text: { type: "mrkdwn", text: kpiPreview(input.quality.metricNames) },
@@ -54,5 +62,7 @@ export function buildBoardConfirmBlocks(input: {
         },
       ],
     },
-  ];
+  );
+
+  return blocks;
 }

src/slack/confirm/engine-summary.ts

@@ -1,6 +1,77 @@
 import type { ForgeBuildReceipt } from "../../forge/receipt.js";
 import { sourceCoverageScore } from "../../lint/grounding.js";
 
+const NARRATIVE_KEYS = [
+  "summary",
+  "executive_summary",
+  "abstract",
+  "decision",
+  "context",
+  "commentary",
+  "objective",
+  "root_cause",
+  "background",
+] as const;
+
+function truncateField(text: string, max = 120): string {
+  const t = text.replace(/\s+/g, " ").trim();
+  if (t.length <= max) return t;
+  return `${t.slice(0, max - 1)}…`;
+}
+
+function labelForKey(key: string): string {
+  return key.replace(/_/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+}
+
+/** Top schema fields for confirm cards — not a wall, max 3 lines. */
+export function formatSchemaFieldPreview(
+  draftData: Record<string, unknown>,
+  max = 3,
+): string {
+  const lines: string[] = [];
+
+  for (const key of NARRATIVE_KEYS) {
+    if (lines.length >= max) break;
+    const value = draftData[key];
+    if (typeof value !== "string" || value.trim().length < 8) continue;
+    lines.push(`*${labelForKey(key)}:* ${truncateField(value)}`);
+  }
+
+  if (lines.length < max) {
+    const kpis = draftData.kpis as Array<{ name?: string; value?: string }> | undefined;
+    if (kpis?.length) {
+      const kpiLine = kpis
+        .slice(0, 3)
+        .map((k) => `${k.name ?? "KPI"} ${k.value ?? "—"}`)
+        .join(" · ");
+      lines.push(`*KPIs:* ${truncateField(kpiLine, 140)}`);
+    }
+  }
+
+  if (lines.length < max) {
+    const scope = draftData.scope as Array<{ item?: string }> | undefined;
+    if (scope?.length) {
+      lines.push(
+        `*Scope:* ${truncateField(scope.slice(0, 2).map((s) => s.item ?? "").filter(Boolean).join("; "))}`,
+      );
+    }
+  }
+
+  if (lines.length < max) {
+    const ws = draftData.workstreams as Array<{ name?: string; rag?: string }> | undefined;
+    if (ws?.length) {
+      lines.push(
+        `*Workstreams:* ${ws
+          .slice(0, 3)
+          .map((w) => `${w.name ?? "—"} (${w.rag ?? "amber"})`)
+          .join(" · ")}`,
+      );
+    }
+  }
+
+  return lines.slice(0, max).join("\n");
+}
+
 /** One-line engine proof for confirm cards (pre-compile). */
 export function formatEnginePreviewLine(input: {
   templateId: string;

src/slack/confirm/freehand.ts

@@ -1,6 +1,6 @@
 import type { KnownBlock } from "@slack/web-api";
 import type { DraftInference } from "../workflows/draft-inference.js";
-import { formatEnginePreviewLine } from "./engine-summary.js";
+import { formatEnginePreviewLine, formatSchemaFieldPreview } from "./engine-summary.js";
 
 export function buildDraftChoiceBlocks(input: {
   choiceId: string;
@@ -35,8 +35,9 @@ export function buildDraftConfirmBlocks(input: {
 }): KnownBlock[] {
   const { inference } = input;
   const title = typeof inference.draftData.title === "string" ? inference.draftData.title : "Draft";
+  const fields = formatSchemaFieldPreview(inference.draftData);
 
-  return [
+  const blocks: KnownBlock[] = [
     {
       type: "section",
       text: {
@@ -50,23 +51,39 @@ export function buildDraftConfirmBlocks(input: {
           })}_`,
       },
     },
-    {
-      type: "actions",
-      elements: [
-        {
-          type: "button",
-          action_id: "draft_confirm",
-          text: { type: "plain_text", text: "Generate PDF" },
-          style: "primary",
-          value: input.pendingId,
-        },
-        {
-          type: "button",
-          action_id: "draft_cancel",
-          text: { type: "plain_text", text: "Cancel" },
-          value: input.pendingId,
-        },
-      ],
-    },
   ];
+
+  if (fields) {
+    blocks.push({
+      type: "section",
+      text: { type: "mrkdwn", text: fields },
+    });
+  }
+
+  blocks.push({
+    type: "actions",
+    elements: [
+      {
+        type: "button",
+        action_id: "draft_confirm",
+        text: { type: "plain_text", text: "Generate PDF" },
+        style: "primary",
+        value: input.pendingId,
+      },
+      {
+        type: "button",
+        action_id: "draft_retemplate",
+        text: { type: "plain_text", text: "Change template" },
+        value: input.pendingId,
+      },
+      {
+        type: "button",
+        action_id: "draft_cancel",
+        text: { type: "plain_text", text: "Cancel" },
+        value: input.pendingId,
+      },
+    ],
+  });
+
+  return blocks;
 }

src/slack/confirm/incident.ts

@@ -2,6 +2,7 @@ import type { KnownBlock } from "@slack/web-api";
 import type { TranscriptQuality } from "../gather/context.js";
 import type { ResolvedIncidentSource } from "../session.js";
 import { isRootCauseConfirmed } from "../gather/transcript.js";
+import { formatEnginePreviewLine, formatSchemaFieldPreview } from "./engine-summary.js";
 
 type TimelineEntry = { time: string; event: string };
 
@@ -67,19 +68,33 @@ export function buildIncidentConfirmBlocks(input: {
   title: string;
   filename: string;
   draftData: Record<string, unknown>;
+  templateId?: string;
 }): KnownBlock[] {
   const preview = timelinePreview(input.draftData);
+  const fields = formatSchemaFieldPreview(input.draftData);
+  const templateId = input.templateId ?? "incident_report";
 
-  return [
+  const blocks: KnownBlock[] = [
     {
       type: "section",
       text: {
         type: "mrkdwn",
         text:
-          `*Incident report*\n` +
-          `${formatSourceLink(input.source)} · ${severityLabel(input.draftData.severity)} · \`${input.filename}\``,
+          `*${templateId === "postmortem" ? "Postmortem" : "Incident report"}*\n` +
+          `${formatSourceLink(input.source)} · ${severityLabel(input.draftData.severity)} · \`${input.filename}\`\n` +
+          `_${formatEnginePreviewLine({
+            templateId,
+            draftData: input.draftData,
+          })}_`,
       },
     },
+  ];
+
+  if (fields) {
+    blocks.push({ type: "section", text: { type: "mrkdwn", text: fields } });
+  }
+
+  blocks.push(
     {
       type: "section",
       text: {
@@ -112,5 +127,7 @@ export function buildIncidentConfirmBlocks(input: {
         },
       ],
     },
-  ];
+  );
+
+  return blocks;
 }

src/slack/confirm/preview.ts

@@ -0,0 +1,46 @@
+import { producePreview } from "../../forge/pipeline.js";
+import { docforgeDestroyDocument } from "../../service.js";
+import { uploadPreviewToThread } from "../deliver/upload-preview.js";
+import type { ForgeMessageContext } from "../types.js";
+
+/**
+ * Render page-1 PNG and upload to the confirm thread — one thumbnail, not a
+ * telemetry wall. Skipped when FORGE_CONFIRM_PREVIEW=off (tests/CI).
+ */
+export async function postConfirmPreview(
+  ctx: Pick<ForgeMessageContext, "client" | "logger">,
+  input: {
+    templateId: string;
+    draftData: Record<string, unknown>;
+    filename: string;
+    replyChannelId: string;
+    threadTs: string;
+  },
+): Promise<void> {
+  if (process.env.FORGE_CONFIRM_PREVIEW === "off") return;
+
+  let documentId: string | undefined;
+  try {
+    const preview = await producePreview(input.templateId, input.draftData);
+    documentId = preview.documentId;
+    const base = input.filename.replace(/\.pdf$/i, "");
+    await uploadPreviewToThread({
+      client: ctx.client,
+      channelId: input.replyChannelId,
+      threadTs: input.threadTs,
+      previewPath: preview.previewPath,
+      filename: `${base}-preview.png`,
+      initialComment: "Page 1 preview — generate PDF when ready.",
+    });
+  } catch (err) {
+    ctx.logger.debug?.("confirm preview skipped", err);
+  } finally {
+    if (documentId) {
+      try {
+        await docforgeDestroyDocument(documentId);
+      } catch (err) {
+        ctx.logger.debug?.("confirm preview cleanup skipped", err);
+      }
+    }
+  }
+}

src/slack/confirm/proposal.ts

@@ -2,7 +2,7 @@ import type { KnownBlock } from "@slack/web-api";
 import type { TranscriptQuality } from "../gather/context.js";
 import { pricingSubtotal, type PricingRow } from "../gather/pricing.js";
 import type { ProposalEvidenceSnippet, ProposalSource } from "../gather/proposal-context.js";
-import { formatEnginePreviewLine } from "./engine-summary.js";
+import { formatEnginePreviewLine, formatSchemaFieldPreview } from "./engine-summary.js";
 
 function formatMoney(total: number): string {
   return `$${total.toLocaleString("en-US", { maximumFractionDigits: 0 })}`;
@@ -32,8 +32,9 @@ export function buildProposalConfirmBlocks(input: {
   const client = (input.draftData.client as { name?: string })?.name ?? input.source.clientName;
   const subtotal = pricingSubtotal(input.pricingRows);
   const totalLabel = formatMoney(Math.round(subtotal));
+  const fields = formatSchemaFieldPreview(input.draftData);
 
-  return [
+  const blocks: KnownBlock[] = [
     {
       type: "section",
       text: {
@@ -48,6 +49,13 @@ export function buildProposalConfirmBlocks(input: {
           })}_`,
       },
     },
+  ];
+
+  if (fields) {
+    blocks.push({ type: "section", text: { type: "mrkdwn", text: fields } });
+  }
+
+  blocks.push(
     {
       type: "section",
       text: { type: "mrkdwn", text: scopePreview(input.draftData) },
@@ -70,5 +78,7 @@ export function buildProposalConfirmBlocks(input: {
         },
       ],
     },
-  ];
+  );
+
+  return blocks;
 }

src/slack/confirm/status.ts

@@ -1,5 +1,5 @@
 import type { KnownBlock } from "@slack/web-api";
-import { formatEnginePreviewLine } from "./engine-summary.js";
+import { formatEnginePreviewLine, formatSchemaFieldPreview } from "./engine-summary.js";
 
 const RAG_EMOJI: Record<string, string> = { red: "🔴", amber: "🟠", green: "🟢" };
 
@@ -25,6 +25,7 @@ export function buildStatusConfirmBlocks(input: {
   filename: string;
 }): KnownBlock[] {
   const blockers = (input.draftData.blockers as string[] | undefined) ?? [];
+  const fields = formatSchemaFieldPreview(input.draftData);
 
   const blocks: KnownBlock[] = [
     {
@@ -40,12 +41,17 @@ export function buildStatusConfirmBlocks(input: {
           })}_`,
       },
     },
-    {
-      type: "section",
-      text: { type: "mrkdwn", text: workstreamPreview(input.draftData) },
-    },
   ];
 
+  if (fields) {
+    blocks.push({ type: "section", text: { type: "mrkdwn", text: fields } });
+  }
+
+  blocks.push({
+    type: "section",
+    text: { type: "mrkdwn", text: workstreamPreview(input.draftData) },
+  });
+
   if (blockers.length) {
     blocks.push({
       type: "section",