feat(init): show AI-generated feature blurbs in setup summary (#982)

## Summary

Ends the wizard with a \"Here's what we set up\" two-column table — one
row per enabled feature with a sentence specific to the project that was
just instrumented. The blurbs come from a new server-side agent that
uses the tech-stack description already captured during platform
detection (e.g. \"Next.js 14 with Drizzle ORM and Cloudflare D1\") to
produce context-aware copy rather than generic marketing text.

Depends on getsentry/cli-init-api#156 for the server-side agent.

## Changes

- `WizardSummary` and `WizardOutput` gain an optional `featureBlurbs`
field
- `buildSummary()` populates it from the workflow output and suppresses
the plain \"Features\" row when blurbs are present (the table makes it
redundant)
- Both `ink-report.ts` (post-dispose chalk output) and `logging-ui.ts`
render the blurbs as a proper two-column table via `renderTextTable` —
same renderer used by `sentry issue list` / `sentry project list`, so
wrapping and column fitting are handled automatically
- `SummaryPanel` in `ink-app.tsx` renders the live Ink variant with flex
layout
- Removed \"Nice, setup made it through.\" preamble so the feedback
prompt follows the summary directly

## Test Plan

- Start `bun run dev` in `cli-init-api`, then run
`MASTRA_API_URL=http://localhost:8787 bun run src/bin.ts init` against a
real project
- Confirm the blurbs table appears after the key/value fields and before
changed files
- Run with `--no-tui` and confirm the plain-text table renders the same
content
- If the blurb agent fails, wizard completes normally with no blurbs
shown (try/catch in `open-sentry-ui.ts`)

---------

Co-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>

Author: betegon

src/lib/formatters/plain-detect.ts

@@ -73,17 +73,29 @@ export function isPlainOutput(): boolean {
 }
 
 /**
- * Strip ANSI escape sequences from a string.
+ * Strip ANSI/VT escape sequences from a string.
  *
- * Handles SGR codes (`\x1b[...m`) and OSC 8 terminal hyperlink sequences
- * (`\x1b]8;;url\x07text\x1b]8;;\x07`).
+ * Covers the four escape-sequence families that can reach a terminal:
+ *   - CSI (`\x1b[`): SGR colour codes, cursor movement, screen-clear, etc.
+ *   - OSC (`\x1b]`): window-title changes, hyperlinks, etc.
+ *   - DCS (`\x1bP`): device-control strings.
+ *   - Two-character C1 ESC: single-byte sequences like `\x1bc` (terminal reset).
  */
 export function stripAnsi(text: string): string {
   return (
     text
-      // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape detection requires matching \x1b and \x07
-      .replace(/\x1b\[[0-9;]*m/g, "")
-      // biome-ignore lint/suspicious/noControlCharactersInRegex: OSC 8 hyperlink sequences use \x1b and \x07
-      .replace(/\x1b\]8;;[^\x07]*\x07/g, "")
+      // CSI: \x1b[ + param bytes (0x30-0x3F) + intermediate bytes (0x20-0x2F) + final byte (0x40-0x7E)
+      // biome-ignore lint/suspicious/noControlCharactersInRegex: ANSI escape detection requires matching \x1b
+      .replace(/\x1b\[[\x30-\x3f]*[\x20-\x2f]*[\x40-\x7e]/g, "")
+      // OSC: \x1b] ... terminated by BEL (\x07) or ST (\x1b\)
+      // biome-ignore lint/suspicious/noControlCharactersInRegex: OSC sequences use \x1b and \x07
+      .replace(/\x1b\][^\x07\x1b]*(?:\x07|\x1b\\)/g, "")
+      // DCS: \x1bP ... terminated by ST (\x1b\)
+      // biome-ignore lint/suspicious/noControlCharactersInRegex: DCS sequences use \x1b
+      .replace(/\x1bP[^\x1b]*\x1b\\/g, "")
+      // Two-character ESC sequences (C1: 0x40-0x5F, Fs: 0x60-0x7E), e.g. \x1bc (terminal reset).
+      // Applied last so CSI/OSC/DCS introducers (\x1b[, \x1b], \x1bP) are already stripped.
+      // biome-ignore lint/suspicious/noControlCharactersInRegex: ESC sequence detection requires matching \x1b
+      .replace(/\x1b[@-~]/g, "")
   );
 }

src/lib/init/feedback.ts

@@ -7,10 +7,7 @@ const FEEDBACK_COMMANDS: Record<InitFeedbackOutcome, string> = {
 };
 
 const FEEDBACK_COPY: Record<InitFeedbackOutcome, string[]> = {
-  success: [
-    "Nice, setup made it through.",
-    "Tell us what felt great or rough:",
-  ],
+  success: ["Tell us what felt great or rough:"],
   cancelled: [
     "Sad to see setup stop. Was something going sideways?",
     "Tell us so we can fix it:",

src/lib/init/formatters.ts

@@ -16,7 +16,8 @@
  */
 
 import { terminalLink } from "../formatters/colors.js";
-import { featureLabel } from "./clack-utils.js";
+import { stripAnsi } from "../formatters/plain-detect.js";
+import { featureLabel, sortFeatures } from "./clack-utils.js";
 import {
   EXIT_DEPENDENCY_INSTALL_FAILED,
   EXIT_PLATFORM_NOT_DETECTED,
@@ -33,6 +34,22 @@ import type { WizardSummary, WizardUI } from "./ui/types.js";
  * appear.
  */
 function buildSummary(output: WizardOutput): WizardSummary | null {
+  // Resolve blurbs first so the Features row can check the *resolved* length.
+  // If the agent returns blurbs with wrong IDs they all drop out here, and
+  // the Features row falls back to showing correctly.
+  const blurbMap = new Map(
+    (output.featureBlurbs ?? []).map(({ feature, blurb }) => [
+      feature,
+      stripAnsi(blurb),
+    ])
+  );
+  const featureBlurbs = sortFeatures(output.features ?? [])
+    .map((feature) => {
+      const blurb = blurbMap.get(feature);
+      return blurb ? { label: featureLabel(feature), blurb } : null;
+    })
+    .filter((b): b is { label: string; blurb: string } => b !== null);
+
   const fields: WizardSummary["fields"] = [];
 
   if (output.platform) {
@@ -41,7 +58,7 @@ function buildSummary(output: WizardOutput): WizardSummary | null {
   if (output.projectDir) {
     fields.push({ label: "Directory", value: output.projectDir });
   }
-  if (output.features?.length) {
+  if (output.features?.length && !featureBlurbs.length) {
     fields.push({
       label: "Features",
       value: output.features.map(featureLabel).join(", "),
@@ -62,13 +79,18 @@ function buildSummary(output: WizardOutput): WizardSummary | null {
 
   const changedFiles = output.changedFiles ?? [];
 
-  if (fields.length === 0 && changedFiles.length === 0) {
+  if (
+    fields.length === 0 &&
+    changedFiles.length === 0 &&
+    featureBlurbs.length === 0
+  ) {
     return null;
   }
 
   return {
     fields,
     ...(changedFiles.length > 0 ? { changedFiles } : {}),
+    ...(featureBlurbs.length > 0 ? { featureBlurbs } : {}),
   };
 }
 

src/lib/init/types.ts

@@ -229,6 +229,7 @@ export type WizardOutput = {
   docsUrl?: string;
   sentryProjectUrl?: string;
   message?: string;
+  featureBlurbs?: Array<{ feature: string; blurb: string }>;
 };
 
 // Interactive payloads

src/lib/init/ui/ink-app.tsx

@@ -1173,6 +1173,28 @@ function SummaryPanel({
           ))}
         </Box>
       ) : null}
+      {summary.featureBlurbs !== undefined &&
+      summary.featureBlurbs.length > 0 ? (
+        <Box flexDirection="column" flexShrink={0} marginTop={1}>
+          <Text bold color={MUTED}>
+            Here&apos;s what we set up
+          </Text>
+          {summary.featureBlurbs.map(({ label, blurb }) => (
+            <Box flexDirection="row" flexShrink={0} key={label}>
+              <Box flexShrink={0} width={22}>
+                <Text bold color={PRIMARY}>
+                  {label}
+                </Text>
+              </Box>
+              <Box flexShrink={1}>
+                <Text color={MUTED} wrap="wrap">
+                  {blurb}
+                </Text>
+              </Box>
+            </Box>
+          ))}
+        </Box>
+      ) : null}
       {summary.changedFiles !== undefined && summary.changedFiles.length > 0 ? (
         <ChangedFilesTree files={summary.changedFiles} />
       ) : null}

src/lib/init/ui/ink-report.ts

@@ -1,4 +1,5 @@
 import chalk from "chalk";
+import { renderTextTable } from "../../formatters/text-table.js";
 import { buildFileTree, flattenTree } from "./file-tree.js";
 import type { WizardSummary } from "./types.js";
 
@@ -60,6 +61,20 @@ export function formatSuccessReport(
       lines.push(`   ${label}  ${field.value}`);
     }
   }
+  if (summary?.featureBlurbs && summary.featureBlurbs.length > 0) {
+    lines.push("");
+    lines.push(`   ${chalk.hex(REPORT_MUTED).bold("Here's what we set up")}`);
+    const tableRows = summary.featureBlurbs.map(({ label, blurb }) => [
+      chalk.bold(label),
+      chalk.hex(REPORT_MUTED)(blurb),
+    ]);
+    const table = renderTextTable(["", ""], tableRows, {
+      shrinkable: [false, true],
+    });
+    for (const line of table.trimEnd().split("\n")) {
+      lines.push(`   ${line}`);
+    }
+  }
   if (summary?.changedFiles && summary.changedFiles.length > 0) {
     lines.push("");
     lines.push(`   ${chalk.hex(REPORT_MUTED).bold("Changed files")}`);

src/lib/init/ui/logging-ui.ts

@@ -22,6 +22,7 @@ import {
   renderInlineMarkdown,
   renderMarkdown,
 } from "../../formatters/markdown.js";
+import { renderTextTable } from "../../formatters/text-table.js";
 import { formatFeedbackHint, type InitFeedbackOutcome } from "../feedback.js";
 import { buildFileTree, flattenTree } from "./file-tree.js";
 import type {
@@ -94,7 +95,11 @@ export class LoggingUI implements WizardUI {
   }
 
   summary(summary: WizardSummary): void {
-    if (summary.fields.length === 0 && !summary.changedFiles?.length) {
+    if (
+      summary.fields.length === 0 &&
+      !summary.changedFiles?.length &&
+      !summary.featureBlurbs?.length
+    ) {
       return;
     }
     // Compact two-column key/value listing — one line per field. The
@@ -109,6 +114,20 @@ export class LoggingUI implements WizardUI {
       const padded = field.label.padEnd(labelWidth);
       this.writeLine(this.stdout, `  ${padded}  ${field.value}`);
     }
+    if (summary.featureBlurbs && summary.featureBlurbs.length > 0) {
+      this.writeLine(this.stdout, "");
+      this.writeLine(this.stdout, "  Here's what we set up");
+      const tableRows = summary.featureBlurbs.map(({ label, blurb }) => [
+        label,
+        blurb,
+      ]);
+      const table = renderTextTable(["", ""], tableRows, {
+        shrinkable: [false, true],
+      });
+      for (const line of table.trimEnd().split("\n")) {
+        this.writeLine(this.stdout, `  ${line}`);
+      }
+    }
     if (summary.changedFiles && summary.changedFiles.length > 0) {
       this.writeLine(this.stdout, "");
       this.writeLine(this.stdout, "  Changed files:");

src/lib/init/ui/types.ts

@@ -143,6 +143,8 @@ export type WizardSummary = {
   fields: { label: string; value: string }[];
   /** Optional list of files the wizard added/edited/removed. */
   changedFiles?: { action: string; path: string }[];
+  /** AI-generated per-feature blurbs personalised to the analysed project. */
+  featureBlurbs?: { label: string; blurb: string }[];
 };
 
 /**

test/lib/init/feedback.test.ts

@@ -5,7 +5,6 @@ describe("formatFeedbackHint", () => {
   test("maps init outcomes to copy-paste feedback commands", () => {
     expect(formatFeedbackHint("success")).toBe(
       [
-        "Nice, setup made it through.",
         "Tell us what felt great or rough:",
         '$ sentry cli feedback "sentry init worked well"',
       ].join("\n")