rivet-design 0.9.5 → 0.9.6

package/dist/mcp/agent-variants/WorktreeOrchestrator.js

@@ -22,6 +22,8 @@ const previewQa_1 = require("./previewQa");
 const VariantHistoryService_1 = require("../../services/VariantHistoryService");
 const log = (0, logger_1.createLogger)('AgentVariantsOrchestrator');
 const FRESH_DEV_SERVER_HOST = '127.0.0.1';
+const DESIGN_CONTEXT_ROUTE_SEGMENT = 'design-md';
+const DESIGN_CONTEXT_VIEW_SEGMENT = 'view';
 /**
  * Allowlist of asset file extensions an agent-planned source may have.
  * `assetPlan` is sized for large local *assets* (3D models, images,
@@ -39,15 +41,36 @@ const FRESH_DEV_SERVER_HOST = '127.0.0.1';
  */
 const ALLOWED_ASSET_EXTENSIONS = new Set([
     // 3D / models
-    '.glb', '.gltf', '.obj', '.fbx', '.usdz',
+    '.glb',
+    '.gltf',
+    '.obj',
+    '.fbx',
+    '.usdz',
     // images
-    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.svg', '.avif', '.bmp', '.ico',
+    '.png',
+    '.jpg',
+    '.jpeg',
+    '.gif',
+    '.webp',
+    '.svg',
+    '.avif',
+    '.bmp',
+    '.ico',
     // video
-    '.mp4', '.webm', '.mov',
+    '.mp4',
+    '.webm',
+    '.mov',
     // audio
-    '.mp3', '.wav', '.ogg', '.m4a',
+    '.mp3',
+    '.wav',
+    '.ogg',
+    '.m4a',
     // fonts
-    '.woff', '.woff2', '.ttf', '.otf', '.eot',
+    '.woff',
+    '.woff2',
+    '.ttf',
+    '.otf',
+    '.eot',
     // PDFs
     '.pdf',
 ]);
@@ -180,8 +203,7 @@ function copyAssetIntoWorktree(worktreePath, entry, assetSourceRoot) {
         throw new errors_1.AgentVariantsError('RUNTIME_VALIDATION_FAILED', `assetPlan.source resolved extension '${resolvedExt || '(none)'}' is not on the allowlist (resolved from '${entry.source}').`);
     }
     const normalizedDest = path_1.default.normalize(entry.destination);
-    if (normalizedDest.startsWith('..') ||
-        path_1.default.isAbsolute(normalizedDest)) {
+    if (normalizedDest.startsWith('..') || path_1.default.isAbsolute(normalizedDest)) {
         throw new errors_1.AgentVariantsError('RUNTIME_VALIDATION_FAILED', `assetPlan.destination must stay inside the worktree, got '${entry.destination}'`);
     }
     const absDest = path_1.default.join(worktreePath, normalizedDest);
@@ -306,8 +328,10 @@ class AgentVariantsOrchestrator {
         const variants = this.getVariants(sessionId);
         const sessionProjectContext = this.store.getProjectContext(sessionId);
         const projectContext = toActiveProjectContext(sessionProjectContext);
-        const destinationPath = projectContext.kind === 'fresh' ? projectContext.workspacePath : undefined;
-        const artifacts = buildSessionArtifacts(sessionProjectContext);
+        const destinationPath = projectContext.kind === 'fresh'
+            ? projectContext.workspacePath
+            : undefined;
+        const artifacts = buildSessionArtifacts(sessionId, sessionProjectContext);
         return {
             active: true,
             sessionId,
@@ -429,7 +453,9 @@ class AgentVariantsOrchestrator {
                         };
                     }
                 }
-                catch { /* work item may not exist in edge cases */ }
+                catch {
+                    /* work item may not exist in edge cases */
+                }
             }
             if (!preview && port) {
                 preview = { kind: 'dev_server', port };
@@ -440,7 +466,7 @@ class AgentVariantsOrchestrator {
             const canView = Boolean(preview) || (isSucceeded && Boolean(port));
             const canCommit = isSucceeded && !qaFailed;
             const commitDisabledReason = qaFailed
-                ? qa?.summary ?? 'Variant failed QA'
+                ? (qa?.summary ?? 'Variant failed QA')
                 : 'Wait for a successful variant';
             return {
                 ...variant,
@@ -486,7 +512,9 @@ class AgentVariantsOrchestrator {
     }
     getStaticPreviewHtml(sessionId, workItemId) {
         // Primary: from the staticPreviews Map populated by handleSucceededReport.
-        const fromMap = this.resources.get(sessionId)?.staticPreviews.get(workItemId)?.html;
+        const fromMap = this.resources
+            .get(sessionId)
+            ?.staticPreviews.get(workItemId)?.html;
         if (fromMap)
             return fromMap;
         // Fallback: read directly from the work item's stored output — available
@@ -501,6 +529,16 @@ class AgentVariantsOrchestrator {
             return undefined;
         }
     }
+    /** Resolve the DESIGN.md markdown behind an artifact link. */
+    getDesignContextMarkdown(sessionId, artifactId) {
+        const artifact = findDesignContextArtifact(this.store.getProjectContext(sessionId), artifactId);
+        return artifact?.content;
+    }
+    /** Build the raw-plus-rendered DesignMD document for an artifact link. */
+    getDesignContextViewerHtml(sessionId, artifactId) {
+        const artifact = findDesignContextArtifact(this.store.getProjectContext(sessionId), artifactId);
+        return artifact ? buildDesignContextViewerDocument(artifact) : undefined;
+    }
     getStaticPreviewByBriefId(sessionId, briefId) {
         const resources = this.resources.get(sessionId);
         if (!resources)
@@ -559,8 +597,12 @@ class AgentVariantsOrchestrator {
      */
     async startUnified(args) {
         const count = args.briefs?.length ?? args.count ?? 4;
-        const projectContext = args.projectContext ?? { kind: 'existing' };
-        const sourceContext = projectContext.kind === 'fresh' ? projectContext.sourceContext : undefined;
+        const projectContext = args.projectContext ?? {
+            kind: 'existing',
+        };
+        const sourceContext = projectContext.kind === 'fresh'
+            ? projectContext.sourceContext
+            : undefined;
         const isSourceGrounded = Boolean(sourceContext?.sourceUrls?.length) ||
             Boolean(sourceContext?.sourceArtifacts?.length) ||
             Boolean(sourceContext?.sourceIntent) ||
@@ -835,8 +877,8 @@ class AgentVariantsOrchestrator {
             }
             else {
                 try {
-                    historyProjectPath =
-                        (await this.resolveEnv(args.sessionId))?.projectPath;
+                    historyProjectPath = (await this.resolveEnv(args.sessionId))
+                        ?.projectPath;
                 }
                 catch {
                     historyProjectPath = undefined;
@@ -869,13 +911,15 @@ class AgentVariantsOrchestrator {
         }
         const variantSnapshot = this.getVariants(args.sessionId).find((variant) => variant.workItemId === args.variantId);
         if (!variantSnapshot || variantSnapshot.actions?.commit?.enabled !== true) {
-            throw new errors_1.AgentVariantsError('INVALID_STAGE_ACTION', variantSnapshot?.actions?.commit?.reason ?? 'Variant is not committable');
+            throw new errors_1.AgentVariantsError('INVALID_STAGE_ACTION', variantSnapshot?.actions?.commit?.reason ??
+                'Variant is not committable');
         }
         const input = this.store.getWorkItemInput(args.sessionId, args.variantId);
         const projectContext = this.store.getProjectContext(args.sessionId);
         let payload;
         let envelopeDestination;
         let changedFilesCount;
+        let runnablePaths;
         if (projectContext.kind === 'fresh') {
             const destinationPath = projectContext.workspacePath;
             this.assertDestinationAvailable(destinationPath);
@@ -956,7 +1000,7 @@ class AgentVariantsOrchestrator {
                     // chosen project. Best-effort: failures here log and continue so
                     // a partial history never blocks the commit handoff.
                     try {
-                        this.preserveUnchosenVariants({
+                        runnablePaths = this.preserveUnchosenVariants({
                             sessionId: args.sessionId,
                             chosenVariantId: args.variantId,
                             destinationPath,
@@ -1052,7 +1096,7 @@ class AgentVariantsOrchestrator {
                 diff: record.diff,
                 target: input.target,
                 changedFilesCount,
-                note: 'Variant diff applied to the user\'s working tree (uncommitted).',
+                note: "Variant diff applied to the user's working tree (uncommitted).",
             };
             envelopeDestination = env.projectPath;
         }
@@ -1087,12 +1131,21 @@ class AgentVariantsOrchestrator {
             projectPath: historyProjectPath,
             projectKind: projectContext.kind,
             destinationPath: envelopeDestination,
+            runnablePaths,
         }).catch((err) => {
             log.warn(`persistVariantHistoryAtCommit failed for session ${args.sessionId}`, err);
         });
         const enqueueResult = this.adapter.enqueue(envelope);
         resources.committedVariantIds.add(args.variantId);
-        if (this.activeSessionId === args.sessionId) {
+        // For fresh `new-project` commits the committed variant IS the user's
+        // final result — there's no dev server to fall back to. Keep the session
+        // active so SSE keeps pushing snapshots with the chosen variant; the UI's
+        // iframe stays on it instead of unmounting to about:blank (which would
+        // surface a misleading "Preview isn't connected" overlay). For diff /
+        // diff-applied commits the user moves on to their own dev server, so
+        // clearing is correct — that's the original behavior preserved below.
+        if (this.activeSessionId === args.sessionId &&
+            payload.kind !== 'project-created') {
             this.activeSessionId = null;
         }
         const dwellMsFromTerminal = resources.terminalAt
@@ -1558,19 +1611,28 @@ class AgentVariantsOrchestrator {
         const projectContext = this.store.getProjectContext(args.sessionId);
         if (projectContext.kind !== 'existing')
             return;
-        let projectPath;
+        let env;
         try {
-            const env = await this.resolveEnv(args.sessionId);
-            projectPath = env.projectPath;
+            env = await this.resolveEnv(args.sessionId);
         }
         catch (err) {
             log.warn(`persistCompletedExistingVariant: resolveEnv failed for ${args.sessionId}`, err);
             return;
         }
+        const record = this.resources.get(args.sessionId)?.worktrees.get(args.workItemId);
+        let sourceDir;
+        if (env.framework === 'static' && record) {
+            try {
+                sourceDir = await this.worktrees.getProjectCwdInWorktree(record.worktreePath);
+            }
+            catch (err) {
+                log.warn(`persistCompletedExistingVariant: static snapshot path failed for ${args.sessionId}/${args.workItemId}`, err);
+            }
+        }
         const input = this.store.getWorkItemInput(args.sessionId, args.workItemId);
         const sessionPrompt = this.store.getPrompt(args.sessionId);
         await this.variantHistory.persistVariant({
-            projectPath,
+            projectPath: env.projectPath,
             sessionId: args.sessionId,
             variantId: args.workItemId,
             label: input.briefLabel,
@@ -1578,6 +1640,10 @@ class AgentVariantsOrchestrator {
             sessionPrompt,
             kind: 'diff',
             diff: args.diff,
+            sourceDir,
+            preview: sourceDir
+                ? { kind: 'static', entryPath: 'index.html' }
+                : { kind: 'none', reason: 'diff_only' },
             changedFilesCount: countDiffFiles(args.diff),
             projectKind: 'existing',
         });
@@ -1634,9 +1700,17 @@ class AgentVariantsOrchestrator {
         // is implementation-detail staging that we copy alongside it. Hardcode
         // the count so the history row matches what `commit_variant` reports
         // (always 1) instead of double-counting the brief.
-        const changedFilesCount = staticPreview
-            ? 1
-            : countWorktreeFiles(sourceDir);
+        const changedFilesCount = staticPreview ? 1 : countWorktreeFiles(sourceDir);
+        const preview = staticPreview
+            ? { kind: 'static', entryPath: 'index.html' }
+            : {
+                kind: 'dev-server',
+                command: {
+                    cwd: '.',
+                    packageManager: 'npm',
+                    script: 'dev',
+                },
+            };
         try {
             await this.variantHistory.persistVariant({
                 projectPath: historyProjectPath,
@@ -1647,6 +1721,7 @@ class AgentVariantsOrchestrator {
                 sessionPrompt,
                 kind: 'project-created',
                 sourceDir,
+                preview,
                 changedFilesCount,
                 projectKind: 'fresh',
                 designMarkdown: designArtifact?.markdown,
@@ -1688,6 +1763,7 @@ class AgentVariantsOrchestrator {
                 variantId: workItemId,
                 status,
                 destinationPath: isChosen ? args.destinationPath : undefined,
+                runnablePath: args.runnablePaths?.get(workItemId),
             });
         }
     }
@@ -1807,8 +1883,9 @@ class AgentVariantsOrchestrator {
      */
     preserveUnchosenVariants(args) {
         const resources = this.resources.get(args.sessionId);
+        const runnablePaths = new Map();
         if (!resources)
-            return;
+            return runnablePaths;
         const destinationParent = path_1.default.dirname(args.destinationPath);
         const projectSlug = path_1.default.basename(args.destinationPath);
         const historyDir = (0, createProjectArtifacts_1.createVariantsHistoryPath)(destinationParent, projectSlug);
@@ -1827,6 +1904,7 @@ class AgentVariantsOrchestrator {
             const folderName = `${numericPrefix}-${slug}`;
             if (variant.workItemId === args.chosenVariantId) {
                 chosenSlug = slug;
+                runnablePaths.set(variant.workItemId, projectSlug);
                 manifestEntries.push({
                     variantId: variant.workItemId,
                     label,
@@ -1892,6 +1970,7 @@ class AgentVariantsOrchestrator {
                 // Update the in-memory record so teardown doesn't try to operate on
                 // the stale path.
                 record.worktreePath = newPath;
+                runnablePaths.set(variant.workItemId, `${path_1.default.basename(historyDir)}/${folderName}`);
                 manifestEntries.push({
                     variantId: variant.workItemId,
                     label,
@@ -1926,6 +2005,7 @@ class AgentVariantsOrchestrator {
             log.warn(`Writing variants history manifest failed for ${historyDir}`, err);
         }
         resources.vitePreservedSiblings = true;
+        return runnablePaths;
     }
     /**
      * Rename `sourceWorktreePath` into `destinationPath`, then replace the
@@ -2323,15 +2403,26 @@ const toActiveProjectContext = (projectContext) => {
  * Resolve the user-facing supporting artifacts for a session.
  *
  * For 0→1 (`fresh`) sessions with a populated `designContext`, each slot is
- * turned into a `design_context` artifact carrying the full DESIGN.md
- * markdown:
+ * turned into a `design_context` artifact that links to Rivet-hosted
+ * DESIGN.md views:
  *   - `slug` entries resolve bundled catalog markdown via the design catalog.
  *   - `markdown` entries (Agent Browser / inspiration extractor output) carry
- *     their stored markdown verbatim.
+ *     their stored markdown when the linked route is requested.
  * Slots whose markdown can't be resolved are skipped so the UI never renders
  * a metadata-only DESIGN.md row.
  */
-const buildSessionArtifacts = (projectContext) => {
+const buildSessionArtifacts = (sessionId, projectContext) => {
+    const artifacts = buildResolvedDesignContextArtifacts(projectContext);
+    return artifacts.map(({ content: _content, ...artifact }) => ({
+        ...artifact,
+        rawUrl: buildDesignContextRawUrl(sessionId, artifact.id),
+        viewUrl: buildDesignContextViewUrl(sessionId, artifact.id),
+    }));
+};
+const findDesignContextArtifact = (projectContext, artifactId) => {
+    return buildResolvedDesignContextArtifacts(projectContext).find((artifact) => artifact.id === artifactId);
+};
+const buildResolvedDesignContextArtifacts = (projectContext) => {
     if (projectContext.kind !== 'fresh')
         return [];
     const designContext = projectContext.designContext;
@@ -2350,7 +2441,9 @@ const buildSessionArtifacts = (projectContext) => {
                 id: `design_context:${slot}:${entry.slug}`,
                 kind: 'design_context',
                 label: catalogEntry?.name ?? entry.slug,
-                ...(catalogEntry?.description ? { summary: catalogEntry.description } : {}),
+                ...(catalogEntry?.description
+                    ? { summary: catalogEntry.description }
+                    : {}),
                 status: 'ready',
                 source: 'static',
                 contentType: 'text/markdown',
@@ -2382,8 +2475,6 @@ const buildSessionArtifacts = (projectContext) => {
     });
 };
 const addDesignContextArtifact = (artifactsByContent, artifact) => {
-    if (!artifact.content)
-        return;
     const existing = artifactsByContent.get(artifact.content);
     if (existing) {
         existing.usedByVariantCount += 1;
@@ -2394,6 +2485,310 @@ const addDesignContextArtifact = (artifactsByContent, artifact) => {
         usedByVariantCount: 1,
     });
 };
+const buildDesignContextRawUrl = (sessionId, artifactId) => {
+    return `/api/variants/${encodeURIComponent(sessionId)}/${DESIGN_CONTEXT_ROUTE_SEGMENT}/${encodeURIComponent(artifactId)}`;
+};
+const buildDesignContextViewUrl = (sessionId, artifactId) => {
+    return `${buildDesignContextRawUrl(sessionId, artifactId)}/${DESIGN_CONTEXT_VIEW_SEGMENT}`;
+};
+const buildDesignContextViewerDocument = (artifact) => {
+    const title = `${artifact.label} DESIGN.md`;
+    const visualHtml = renderDesignMarkdown(artifact.content);
+    const rawMarkdown = escapeHtml(artifact.content);
+    return `<!doctype html>
+<html lang="en">
+<head>
+  <meta charset="utf-8" />
+  <meta name="viewport" content="width=device-width, initial-scale=1" />
+  <title>${escapeHtml(title)}</title>
+  <style>
+    :root {
+      color-scheme: light;
+      --ink: #201b16;
+      --muted: #75695e;
+      --paper: #fbf7ef;
+      --panel: #fffdf8;
+      --rule: #eadfcf;
+      --accent: #e45d2f;
+      --accent-soft: #ffe0d3;
+      --code: #2a2521;
+    }
+    * { box-sizing: border-box; }
+    body {
+      margin: 0;
+      min-height: 100vh;
+      background:
+        radial-gradient(circle at top left, rgba(228, 93, 47, 0.18), transparent 36rem),
+        linear-gradient(135deg, #fbf7ef 0%, #f2eadc 100%);
+      color: var(--ink);
+      font-family: ui-serif, Georgia, Cambria, "Times New Roman", serif;
+    }
+    main {
+      width: min(1440px, calc(100vw - 40px));
+      margin: 0 auto;
+      padding: 40px 0;
+    }
+    header {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      gap: 24px;
+      margin-bottom: 24px;
+      border-bottom: 1px solid var(--rule);
+      padding-bottom: 18px;
+    }
+    h1 {
+      margin: 0;
+      max-width: 780px;
+      font-size: clamp(2rem, 5vw, 4.5rem);
+      letter-spacing: -0.06em;
+      line-height: 0.92;
+    }
+    .mode-input {
+      position: absolute;
+      opacity: 0;
+      pointer-events: none;
+    }
+    .mode-toggle {
+      display: inline-flex;
+      flex-shrink: 0;
+      gap: 4px;
+      border: 1px solid var(--rule);
+      border-radius: 999px;
+      background: rgba(255, 253, 248, 0.72);
+      padding: 4px;
+      box-shadow: 0 12px 30px rgba(61, 44, 26, 0.08);
+    }
+    .mode-toggle label {
+      position: relative;
+      cursor: pointer;
+      border-radius: 999px;
+      padding: 8px 14px;
+      color: var(--muted);
+      font: 600 0.74rem/1.2 ui-sans-serif, system-ui, sans-serif;
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+      transition:
+        background 160ms ease,
+        color 160ms ease;
+    }
+    .mode-toggle label:has(input:checked) {
+      background: var(--ink);
+      color: var(--paper);
+    }
+    .viewer {
+      display: block;
+    }
+    .viewer-panel {
+      display: none;
+    }
+    main:has(#designmd-visual-mode:checked) .visual-panel,
+    main:has(#designmd-raw-mode:checked) .raw-panel {
+      display: block;
+    }
+    .panel {
+      overflow: hidden;
+      border: 1px solid var(--rule);
+      border-radius: 18px;
+      background: color-mix(in srgb, var(--panel) 92%, white);
+      box-shadow: 0 20px 60px rgba(61, 44, 26, 0.12);
+    }
+    .panel-title {
+      display: flex;
+      align-items: center;
+      justify-content: space-between;
+      border-bottom: 1px solid var(--rule);
+      padding: 12px 16px;
+      color: var(--muted);
+      font: 700 0.72rem/1 ui-sans-serif, system-ui, sans-serif;
+      letter-spacing: 0.12em;
+      text-transform: uppercase;
+    }
+    .visual {
+      padding: 24px;
+    }
+    .visual h1,
+    .visual h2,
+    .visual h3 {
+      margin: 1.3em 0 0.45em;
+      letter-spacing: -0.04em;
+      line-height: 1;
+    }
+    .visual h1:first-child,
+    .visual h2:first-child,
+    .visual h3:first-child {
+      margin-top: 0;
+    }
+    .visual h1 { font-size: 2.25rem; }
+    .visual h2 { font-size: 1.6rem; }
+    .visual h3 { font-size: 1.18rem; }
+    .visual p,
+    .visual li,
+    .visual blockquote {
+      color: #3d342c;
+      font-size: 1rem;
+      line-height: 1.62;
+    }
+    .visual ul {
+      display: grid;
+      gap: 8px;
+      padding-left: 1.1rem;
+    }
+    .visual blockquote {
+      margin: 18px 0;
+      border-left: 4px solid var(--accent);
+      padding-left: 14px;
+      color: var(--muted);
+    }
+    .visual code {
+      border-radius: 6px;
+      background: var(--accent-soft);
+      padding: 0.12rem 0.34rem;
+      font-family: ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
+      font-size: 0.92em;
+    }
+    pre {
+      margin: 0;
+      max-height: calc(100vh - 190px);
+      overflow: auto;
+      background: #181512;
+      color: #f9ead7;
+      padding: 20px;
+      font: 0.78rem/1.55 ui-monospace, "SFMono-Regular", Menlo, Consolas, monospace;
+      white-space: pre-wrap;
+      word-break: break-word;
+    }
+    @media (max-width: 900px) {
+      main { width: min(100vw - 24px, 760px); padding: 24px 0; }
+      header { align-items: start; flex-direction: column; }
+      pre { max-height: 520px; }
+    }
+  </style>
+</head>
+<body>
+  <main>
+    <header>
+      <h1>${escapeHtml(title)}</h1>
+      <div class="mode-toggle" aria-label="DesignMD view mode">
+        <label>
+          <input class="mode-input" type="radio" name="designmd-view-mode" id="designmd-visual-mode" checked />
+          <span>Visual</span>
+        </label>
+        <label>
+          <input class="mode-input" type="radio" name="designmd-view-mode" id="designmd-raw-mode" />
+          <span>Raw</span>
+        </label>
+      </div>
+    </header>
+    <section class="viewer" aria-label="DesignMD artifact">
+      <article class="panel viewer-panel visual-panel" id="designmd-visual">
+        <div class="panel-title"><span>Visual</span><span>Rendered DESIGN.md</span></div>
+        <div class="visual">${visualHtml}</div>
+      </article>
+      <article class="panel viewer-panel raw-panel" id="designmd-raw">
+        <div class="panel-title"><span>Raw</span><span>Markdown source</span></div>
+        <pre>${rawMarkdown}</pre>
+      </article>
+    </section>
+  </main>
+</body>
+</html>`;
+};
+const renderDesignMarkdown = (markdown) => {
+    const lines = markdown.replace(/\r\n/g, '\n').split('\n');
+    const output = [];
+    const paragraph = [];
+    const listItems = [];
+    const codeLines = [];
+    let isCodeBlock = false;
+    const flushParagraph = () => {
+        if (paragraph.length === 0)
+            return;
+        output.push(`<p>${renderInlineMarkdown(paragraph.join(' '))}</p>`);
+        paragraph.length = 0;
+    };
+    const flushList = () => {
+        if (listItems.length === 0)
+            return;
+        output.push(`<ul>${listItems.map((item) => `<li>${renderInlineMarkdown(item)}</li>`).join('')}</ul>`);
+        listItems.length = 0;
+    };
+    const flushCode = () => {
+        if (codeLines.length === 0)
+            return;
+        output.push(`<pre>${escapeHtml(codeLines.join('\n'))}</pre>`);
+        codeLines.length = 0;
+    };
+    lines.forEach((line) => {
+        if (line.trim().startsWith('```')) {
+            if (isCodeBlock) {
+                flushCode();
+                isCodeBlock = false;
+                return;
+            }
+            flushParagraph();
+            flushList();
+            isCodeBlock = true;
+            return;
+        }
+        if (isCodeBlock) {
+            codeLines.push(line);
+            return;
+        }
+        const trimmed = line.trim();
+        if (!trimmed) {
+            flushParagraph();
+            flushList();
+            return;
+        }
+        if (/^---+$/.test(trimmed)) {
+            flushParagraph();
+            flushList();
+            output.push('<hr />');
+            return;
+        }
+        const headingMatch = trimmed.match(/^(#{1,6})\s+(.+)$/);
+        if (headingMatch) {
+            flushParagraph();
+            flushList();
+            const level = Math.min(headingMatch[1].length, 3);
+            output.push(`<h${level}>${renderInlineMarkdown(headingMatch[2])}</h${level}>`);
+            return;
+        }
+        const listMatch = trimmed.match(/^[-*]\s+(.+)$/);
+        if (listMatch) {
+            flushParagraph();
+            listItems.push(listMatch[1]);
+            return;
+        }
+        const quoteMatch = trimmed.match(/^>\s?(.+)$/);
+        if (quoteMatch) {
+            flushParagraph();
+            flushList();
+            output.push(`<blockquote>${renderInlineMarkdown(quoteMatch[1])}</blockquote>`);
+            return;
+        }
+        paragraph.push(trimmed);
+    });
+    flushCode();
+    flushParagraph();
+    flushList();
+    return output.join('\n');
+};
+const renderInlineMarkdown = (value) => {
+    return escapeHtml(value)
+        .replace(/\*\*([^*]+)\*\*/g, '<strong>$1</strong>')
+        .replace(/`([^`]+)`/g, '<code>$1</code>')
+        .replace(/\*([^*]+)\*/g, '<em>$1</em>');
+};
+const escapeHtml = (value) => {
+    return value
+        .replace(/&/g, '&amp;')
+        .replace(/</g, '&lt;')
+        .replace(/>/g, '&gt;')
+        .replace(/"/g, '&quot;')
+        .replace(/'/g, '&#39;');
+};
 /**
  * Resolve a per-variant design context entry into the raw DESIGN.md markdown
  * the worktree scaffolder writes, plus a small `designSource` descriptor for