refactor(project create): migrate human output to markdown rendering system (#341)

Migrate `project create` from ad-hoc `stdout.write()` +
`writeKeyValue()` formatting to the markdown-first rendering pipeline
used by all other detail/view commands.

## Changes

- **New `formatProjectCreated()` in `human.ts`** — Builds CommonMark
using `mdKvTable()`, `escapeMarkdownInline()`, `safeCodeSpan()`, and
`renderMarkdown()`. Notes (slug divergence, auto-created/auto-selected
team) use markdown blockquotes. Tip footer uses italic text.

- **Simplified `create.ts` output path** — Replaced ~30 lines of
multi-write output with a single `formatProjectCreated()` call. JSON
output and error handling unchanged.

- **Removed `writeKeyValue()` from `output.ts`** — Dead code; `project
create` was its only consumer.

- **Updated test assertions** — Slug divergence note now uses backtick
code spans instead of single quotes. All 32 tests pass.

## Output

**TTY** — Unicode box-drawing tables, styled headings, terminal
hyperlinks:
```
Created project 'my-app' in acme-corp

  Note: Using team 'engineering'. See all teams: sentry team list

╭──────────┬──────────────────────────────────────────────╮
│ Project  │ my-app                                       │
│ Slug     │ my-app                                       │
│ Org      │ acme-corp                                    │
│ Team     │ engineering                                  │
│ Platform │ python                                       │
│ DSN      │ https://abc@o123.ingest.us.sentry.io/999     │
│ URL      │ https://sentry.io/settings/acme-corp/…      │
╰──────────┴──────────────────────────────────────────────╯

Tip: Use sentry project view acme-corp/my-app for details
```

**Plain/piped** — Clean CommonMark (same as all other commands).

Author: BYK

src/commands/project/create.ts

@@ -30,11 +30,7 @@ import {
   CliError,
   ContextError,
 } from "../../lib/errors.js";
-import {
-  writeFooter,
-  writeJson,
-  writeKeyValue,
-} from "../../lib/formatters/index.js";
+import { formatProjectCreated, writeJson } from "../../lib/formatters/index.js";
 import { resolveOrg } from "../../lib/resolve-target.js";
 import {
   buildOrgNotFoundError,
@@ -404,44 +400,20 @@ export const createCommand = buildCommand({
 
     // Human-readable output
     const url = buildProjectUrl(orgSlug, project.slug);
-    const fields: [string, string][] = [
-      ["Project", project.name],
-      ["Slug", project.slug],
-      ["Org", orgSlug],
-      ["Team", team.slug],
-      ["Platform", project.platform || platform],
-    ];
-    if (dsn) {
-      fields.push(["DSN", dsn]);
-    }
-    fields.push(["URL", url]);
-
-    stdout.write(`\nCreated project '${project.name}' in ${orgSlug}\n`);
-
-    // Sentry may adjust the slug to avoid collisions (e.g., "my-app" → "my-app-0g")
     const expectedSlug = slugify(name);
-    if (project.slug !== expectedSlug) {
-      stdout.write(
-        `Note: Slug '${project.slug}' was assigned because '${expectedSlug}' is already taken.\n`
-      );
-    }
-
-    // Inform user which team was used when not explicitly specified
-    if (team.source === "auto-created") {
-      stdout.write(`Note: Created team '${team.slug}' (org had no teams).\n`);
-    } else if (team.source === "auto-selected") {
-      stdout.write(
-        `Note: Using team '${team.slug}'. ` +
-          "See all teams: sentry team list\n"
-      );
-    }
-
-    stdout.write("\n");
-    writeKeyValue(stdout, fields);
 
-    writeFooter(
-      stdout,
-      `Tip: Use 'sentry project view ${orgSlug}/${project.slug}' for details`
+    stdout.write(
+      `${formatProjectCreated({
+        project,
+        orgSlug,
+        teamSlug: team.slug,
+        teamSource: team.source,
+        requestedPlatform: platform,
+        dsn,
+        url,
+        slugDiverged: project.slug !== expectedSlug,
+        expectedSlug,
+      })}\n`
     );
   },
 });

src/lib/formatters/human.ts

@@ -1234,6 +1234,89 @@ export function formatProjectDetails(
   return renderMarkdown(lines.join("\n"));
 }
 
+// Project Creation Formatting
+
+/** Input for the project-created success formatter */
+export type ProjectCreatedResult = {
+  /** The created project */
+  project: SentryProject;
+  /** Organization slug the project was created in */
+  orgSlug: string;
+  /** Team slug the project was assigned to */
+  teamSlug: string;
+  /** How the team was resolved */
+  teamSource: "explicit" | "auto-selected" | "auto-created";
+  /** The platform the user requested via CLI argument (used as fallback display) */
+  requestedPlatform: string;
+  /** Primary DSN, if fetched successfully */
+  dsn: string | null;
+  /** Sentry web URL for the project settings page */
+  url: string;
+  /** Whether Sentry assigned a different slug than expected */
+  slugDiverged: boolean;
+  /** The slug the user expected (derived from the project name) */
+  expectedSlug: string;
+};
+
+/**
+ * Format a successful project creation as rendered markdown.
+ *
+ * Includes a heading, contextual notes (slug divergence, team auto-selection),
+ * a key-value detail table, and a tip footer.
+ *
+ * @param result - Project creation context
+ * @returns Rendered terminal string
+ */
+export function formatProjectCreated(result: ProjectCreatedResult): string {
+  const lines: string[] = [];
+
+  lines.push(
+    `## Created project '${escapeMarkdownInline(result.project.name)}' in ${escapeMarkdownInline(result.orgSlug)}`
+  );
+  lines.push("");
+
+  // Slug divergence note
+  if (result.slugDiverged) {
+    lines.push(
+      `> **Note:** Slug \`${result.project.slug}\` was assigned because \`${result.expectedSlug}\` is already taken.`
+    );
+    lines.push("");
+  }
+
+  // Team source notes
+  if (result.teamSource === "auto-created") {
+    lines.push(
+      `> **Note:** Created team '${escapeMarkdownInline(result.teamSlug)}' (org had no teams).`
+    );
+    lines.push("");
+  } else if (result.teamSource === "auto-selected") {
+    lines.push(
+      `> **Note:** Using team '${escapeMarkdownInline(result.teamSlug)}'. See all teams: \`sentry team list\``
+    );
+    lines.push("");
+  }
+
+  const kvRows: [string, string][] = [
+    ["Project", escapeMarkdownInline(result.project.name)],
+    ["Slug", safeCodeSpan(result.project.slug)],
+    ["Org", safeCodeSpan(result.orgSlug)],
+    ["Team", safeCodeSpan(result.teamSlug)],
+    ["Platform", result.project.platform || result.requestedPlatform],
+  ];
+  if (result.dsn) {
+    kvRows.push(["DSN", safeCodeSpan(result.dsn)]);
+  }
+  kvRows.push(["URL", result.url]);
+
+  lines.push(mdKvTable(kvRows));
+  lines.push("");
+  lines.push(
+    `*Tip: Use \`sentry project view ${result.orgSlug}/${result.project.slug}\` for details*`
+  );
+
+  return renderMarkdown(lines.join("\n"));
+}
+
 // User Identity Formatting
 
 /**

src/lib/formatters/output.ts

@@ -55,20 +55,3 @@ export function writeFooter(stdout: Writer, text: string): void {
   stdout.write("\n");
   stdout.write(`${muted(text)}\n`);
 }
-
-/**
- * Write key-value pairs with aligned columns.
- * Used for human-readable output after resource creation.
- */
-export function writeKeyValue(
-  stdout: Writer,
-  pairs: [label: string, value: string][]
-): void {
-  if (pairs.length === 0) {
-    return;
-  }
-  const maxLabel = Math.max(...pairs.map(([l]) => l.length));
-  for (const [label, value] of pairs) {
-    stdout.write(`  ${label.padEnd(maxLabel + 2)}${value}\n`);
-  }
-}

test/commands/project/create.test.ts

@@ -475,8 +475,8 @@ describe("project create", () => {
     await func.call(context, { json: false }, "my-app", "node");
 
     const output = stdoutWrite.mock.calls.map((c) => c[0]).join("");
-    expect(output).toContain("Slug 'my-app-0g' was assigned");
-    expect(output).toContain("'my-app' is already taken");
+    expect(output).toContain("Slug `my-app-0g` was assigned");
+    expect(output).toContain("`my-app` is already taken");
   });
 
   test("does not show slug note when slug matches name", async () => {