@deskwork/studio 0.13.0 → 0.14.0

package/dist/pages/shortform-review.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Shortform review surface — `/dev/editorial-review/<workflow-id>`
+ * (when the bare-UUID resolves to a workflow record, not an entry).
+ *
+ * Phase 34a (#171): the longform/outline halves of `pages/review.ts`
+ * were retired. The workflow-keyed shortform pipeline survives
+ * intentionally — operator decision recorded in the PRD ("Not a
+ * shortform retirement"). This file holds the slim subset of the
+ * old renderer that shortform actually uses.
+ *
+ * Retirement: when shortform's own migration phase ships (tracked
+ * separately from #171), `pages/shortform-review.ts` and the bare-UUID
+ * route's workflow branch get deleted together. Until then, this file
+ * is a stable backwards-compat shim — not a "for now" code-comment IOU.
+ *
+ * Workflow-keyed wording in this file is documenting that deliberate
+ * deferral; do not flag in audits.
+ */
+import type { StudioContext } from '../routes/api.ts';
+interface ShortformReviewQuery {
+    /** ?v=<n>; null shows the workflow's currentVersion. */
+    version: string | null;
+}
+/**
+ * Render the shortform review surface for a workflow id. The bare-UUID
+ * route in `server.ts` calls this when `:id` resolves to a workflow
+ * record (i.e. shortform). Longform UUIDs 301-redirect to the
+ * entry-keyed surface instead.
+ */
+export declare function renderShortformReviewPage(ctx: StudioContext, workflowId: string, query: ShortformReviewQuery): Promise<string>;
+export {};
+//# sourceMappingURL=shortform-review.d.ts.map

package/dist/pages/shortform-review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortform-review.d.ts","sourceRoot":"","sources":["../../src/pages/shortform-review.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAWH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAMtD,UAAU,oBAAoB;IAC5B,wDAAwD;IACxD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AA6MD;;;;;GAKG;AACH,wBAAsB,yBAAyB,CAC7C,GAAG,EAAE,aAAa,EAClB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,oBAAoB,GAC1B,OAAO,CAAC,MAAM,CAAC,CAyFjB"}

package/dist/pages/shortform-review.js

@@ -0,0 +1,270 @@
+/**
+ * Shortform review surface — `/dev/editorial-review/<workflow-id>`
+ * (when the bare-UUID resolves to a workflow record, not an entry).
+ *
+ * Phase 34a (#171): the longform/outline halves of `pages/review.ts`
+ * were retired. The workflow-keyed shortform pipeline survives
+ * intentionally — operator decision recorded in the PRD ("Not a
+ * shortform retirement"). This file holds the slim subset of the
+ * old renderer that shortform actually uses.
+ *
+ * Retirement: when shortform's own migration phase ships (tracked
+ * separately from #171), `pages/shortform-review.ts` and the bare-UUID
+ * route's workflow branch get deleted together. Until then, this file
+ * is a stable backwards-compat shim — not a "for now" code-comment IOU.
+ *
+ * Workflow-keyed wording in this file is documenting that deliberate
+ * deferral; do not flag in audits.
+ */
+import { handleGetWorkflow } from '@deskwork/core/review/handlers';
+import { parseDraftFrontmatter, renderMarkdownToHtml, } from '@deskwork/core/review/render';
+import { html, unsafe } from "./html.js";
+import { layout } from "./layout.js";
+import { renderEditorialFolio } from "./chrome.js";
+import { escapeHtml, gloss } from "./html.js";
+function isSuccessBody(body) {
+    if (typeof body !== 'object' || body === null)
+        return false;
+    return 'workflow' in body && 'versions' in body;
+}
+function errorFromBody(body) {
+    if (typeof body === 'object' && body !== null) {
+        const value = Reflect.get(body, 'error');
+        if (typeof value === 'string')
+            return value;
+    }
+    return 'unknown error';
+}
+function stringField(v) {
+    return typeof v === 'string' ? v : undefined;
+}
+function stateLabel(state) {
+    return (state ?? '').replace('-', ' ');
+}
+async function prepareShortformRender(markdown) {
+    const parsed = parseDraftFrontmatter(markdown);
+    const fm = parsed.frontmatter;
+    const bodyHtml = await renderMarkdownToHtml(parsed.body);
+    // Inject the description as a dek after the body's first <h1>.
+    const description = stringField(fm.description);
+    const dekHtml = description
+        ? `<p class="er-dispatch-dek">${escapeHtml(description)}</p>`
+        : '';
+    const h1Close = bodyHtml.indexOf('</h1>');
+    const renderedHtml = dekHtml && h1Close >= 0
+        ? bodyHtml.slice(0, h1Close + 5) + dekHtml + bodyHtml.slice(h1Close + 5)
+        : dekHtml + bodyHtml;
+    return { fm, bodyHtml: renderedHtml };
+}
+function renderVersionsStrip(versions, current) {
+    if (versions.length <= 1)
+        return unsafe('');
+    const links = versions
+        .map((v) => {
+        const isActive = v.version === current.version;
+        const href = `?v=${v.version}`;
+        return html `<a href="${href}" class="${isActive ? 'active' : ''}">v${v.version}</a>`;
+    })
+        .join('');
+    return unsafe(html `<span class="er-strip-versions">${unsafe(links)}</span>`);
+}
+function pendingSkillCmd(workflow) {
+    const { site, slug, state } = workflow;
+    if (state === 'iterating') {
+        return `/deskwork:iterate --site ${site} ${slug}`;
+    }
+    if (state === 'approved') {
+        return `/deskwork:approve --site ${site} ${slug}`;
+    }
+    return '';
+}
+function shortcutChipWrap(buttonHtml, letter) {
+    return html `<span class="er-shortcut-chip-wrap">${unsafe(buttonHtml)}<small class="er-shortcut-chip"><kbd>${letter}</kbd><kbd>${letter}</kbd></small></span>`;
+}
+function renderControlsRight(workflow) {
+    const isActive = workflow.state === 'open' || workflow.state === 'in-review';
+    const isApproved = workflow.state === 'approved';
+    const isIterating = workflow.state === 'iterating';
+    const isTerminal = workflow.state === 'applied' || workflow.state === 'cancelled';
+    const buttons = [];
+    buttons.push(html `<button class="er-btn er-btn-small" data-action="toggle-edit" type="button">Edit</button><span class="er-edit-mode-label" data-mode="preview">preview</span>`);
+    if (isActive) {
+        buttons.push(shortcutChipWrap(html `<button class="er-btn er-btn-small er-btn-approve" data-action="approve" type="button">Approve</button>`, 'a'));
+        buttons.push(shortcutChipWrap(html `<button class="er-btn er-btn-small" data-action="iterate" type="button">Iterate</button>`, 'i'));
+        buttons.push(shortcutChipWrap(html `<button class="er-btn er-btn-small er-btn-reject" data-action="reject" type="button">Reject</button>`, 'r'));
+    }
+    if (isApproved) {
+        const applyCmd = pendingSkillCmd(workflow);
+        buttons.push(html `<span class="er-pending-state">awaiting apply…</span>`);
+        buttons.push(html `<button class="er-btn er-btn-small" data-action="copy-cmd" data-cmd="${applyCmd}" title="Copy ${applyCmd} to clipboard" type="button">copy <code>/deskwork:approve</code></button>`);
+        buttons.push(shortcutChipWrap(html `<button class="er-btn er-btn-small er-btn-reject" data-action="reject" type="button">Reject</button>`, 'r'));
+    }
+    if (isIterating) {
+        const iterateCmd = pendingSkillCmd(workflow);
+        buttons.push(html `<span class="er-pending-state">agent iterating…</span>`);
+        buttons.push(html `<button class="er-btn er-btn-small" data-action="copy-cmd" data-cmd="${iterateCmd}" title="Copy ${iterateCmd} to clipboard" type="button">copy <code>/deskwork:iterate</code></button>`);
+    }
+    if (isTerminal) {
+        buttons.push(html `<span class="er-pending-state er-pending-state--filed">filed (${workflow.state})</span>`);
+    }
+    buttons.push(html `<button class="er-btn er-btn-small" data-action="shortcuts" type="button" aria-label="Show keyboard shortcuts" title="Keyboard shortcuts">?</button>`);
+    return unsafe(`<span class="er-strip-right">${buttons.join('')}</span>`);
+}
+function renderShortcutsOverlay() {
+    return unsafe(html `
+    <div class="er-shortcuts" data-shortcuts-overlay hidden role="dialog" aria-modal="true" aria-label="Keyboard shortcuts">
+      <div class="er-shortcuts-backdrop" data-shortcuts-backdrop></div>
+      <div class="er-shortcuts-panel">
+        <h2>Keyboard</h2>
+        <dl>
+          <dt><kbd>e</kbd> / dbl-click</dt><dd>toggle edit mode</dd>
+          <dt><kbd>a</kbd> <kbd>a</kbd></dt><dd>approve <em>— press twice within 500ms</em></dd>
+          <dt><kbd>i</kbd> <kbd>i</kbd></dt><dd>iterate <em>— press twice within 500ms</em></dd>
+          <dt><kbd>r</kbd> <kbd>r</kbd></dt><dd>reject <em>— press twice within 500ms</em></dd>
+          <dt><kbd>?</kbd></dt><dd>this panel</dd>
+          <dt><kbd>esc</kbd></dt><dd>close</dd>
+        </dl>
+        <p class="er-shortcuts-footer">Press <kbd>?</kbd> anytime.</p>
+      </div>
+    </div>`);
+}
+function renderEditToolbar() {
+    return unsafe(html `
+    <div class="er-edit-toolbar" data-edit-toolbar hidden>
+      <div class="er-edit-modes" role="tablist" aria-label="Editor mode">
+        <button class="er-edit-mode-btn" data-edit-view="source" type="button" aria-pressed="true">Source</button>
+        <button class="er-edit-mode-btn" data-edit-view="split" type="button" aria-pressed="false">Split</button>
+        <button class="er-edit-mode-btn" data-edit-view="preview" type="button" aria-pressed="false">Preview</button>
+      </div>
+      <div class="er-edit-actions">
+        <button class="er-btn er-btn-small" data-action="focus-mode" type="button" title="Distraction-free mode (Shift+F)" aria-pressed="false">Focus ⛶</button>
+        <button class="er-btn er-btn-primary" data-action="save-version" type="button">Save as new version</button>
+        <button class="er-btn" data-action="cancel-edit" type="button">Cancel</button>
+        <span class="er-edit-hint" data-edit-hint></span>
+      </div>
+    </div>`);
+}
+function renderEditPanes() {
+    return unsafe(html `
+    <div class="er-edit-mode" data-edit-panes-host hidden>
+      <div class="er-edit-panes" data-edit-panes data-view="source">
+        <div class="er-edit-source" data-edit-source aria-label="Markdown source"></div>
+        <div class="er-edit-preview" data-edit-preview aria-label="Rendered preview"></div>
+      </div>
+      <textarea id="draft-edit" data-draft-edit hidden></textarea>
+      <div class="er-focus-exit" data-focus-exit aria-hidden="true">
+        <button type="button" data-action="exit-focus" title="Exit focus (Esc)">← exit focus</button>
+      </div>
+      <div class="er-focus-save" data-focus-save aria-hidden="true">
+        <button type="button" class="er-btn er-btn-small er-btn-primary" data-action="save-version">Save</button>
+        <span class="er-focus-save-hint" data-focus-save-hint></span>
+      </div>
+    </div>`);
+}
+function renderError(workflowId, message) {
+    const body = html `
+    <div data-review-ui="shortform">
+      ${renderEditorialFolio('shortform', `shortform · ${workflowId}`)}
+      <div class="er-error">
+        <h1>No galley to review.</h1>
+        <p><strong>Workflow:</strong> <code>${workflowId}</code></p>
+        <p>${message}</p>
+        <p style="margin-top: 2rem;"><a href="/dev/editorial-studio">← back to the studio</a></p>
+      </div>
+    </div>`;
+    return layout({
+        title: `Review — ${workflowId} — error`,
+        cssHrefs: [
+            '/static/css/editorial-review.css',
+            '/static/css/editorial-nav.css',
+        ],
+        bodyHtml: body,
+        scriptModules: [],
+    });
+}
+/**
+ * Render the shortform review surface for a workflow id. The bare-UUID
+ * route in `server.ts` calls this when `:id` resolves to a workflow
+ * record (i.e. shortform). Longform UUIDs 301-redirect to the
+ * entry-keyed surface instead.
+ */
+export async function renderShortformReviewPage(ctx, workflowId, query) {
+    const fetched = handleGetWorkflow(ctx.projectRoot, ctx.config, {
+        id: workflowId,
+        entryId: null,
+        site: null,
+        slug: null,
+        contentKind: null,
+        platform: null,
+        channel: null,
+    });
+    if (fetched.status !== 200 || !isSuccessBody(fetched.body)) {
+        return renderError(workflowId, errorFromBody(fetched.body));
+    }
+    const { workflow, versions } = fetched.body;
+    const slug = workflow.slug;
+    const requested = query.version ? parseInt(query.version, 10) : workflow.currentVersion;
+    const currentVersion = versions.find((v) => v.version === requested) ?? versions[versions.length - 1];
+    if (!currentVersion) {
+        return renderError(workflowId, 'no current version on this workflow');
+    }
+    const { fm, bodyHtml } = await prepareShortformRender(currentVersion.markdown);
+    const draftState = { workflow, currentVersion, versions };
+    const titleField = stringField(fm.title) ?? `Draft: ${slug}`;
+    const shortformMeta = unsafe(html `
+    <div class="er-shortform-meta">
+      <span class="er-platform">${workflow.platform ?? 'other'}</span>
+      ${workflow.channel
+        ? unsafe(html `<span class="er-channel">${workflow.channel}</span>`)
+        : ''}
+    </div>`);
+    const folioSpine = `shortform · ${workflow.platform ?? '?'}${workflow.channel ? ` · ${workflow.channel}` : ''} · ${slug}`;
+    const pageGrid = html `
+    <div class="er-page-grid">
+      <div class="er-draft-frame">
+        <div id="draft-body" data-draft-body
+          title="Double-click to edit">${unsafe(bodyHtml)}</div>
+        ${renderEditPanes()}
+      </div>
+    </div>`;
+    const body = html `
+    <div data-review-ui="shortform" class="er-review-shell">
+      ${renderEditorialFolio('shortform', folioSpine)}
+      ${shortformMeta}
+      <div class="er-strip">
+        <div class="er-strip-inner">
+          <a class="er-strip-back" href="/dev/editorial-studio" title="Back to the editorial studio">← studio</a>
+          <span class="er-strip-galley">${gloss('galley')} <em>№ ${currentVersion.version}</em></span>
+          <span class="er-strip-slug">${workflow.site} / ${workflow.slug}</span>
+          ${renderVersionsStrip(versions, currentVersion)}
+          <span class="er-strip-center">
+            <span class="er-stamp er-stamp-big er-stamp-${workflow.state}" data-state-label>
+              ${stateLabel(workflow.state)}
+            </span>
+            <span class="er-strip-hint">double-click to edit · <kbd>?</kbd> for shortcuts</span>
+          </span>
+          ${renderControlsRight(workflow)}
+        </div>
+      </div>
+      ${renderEditToolbar()}
+      <article class="er-page">
+        ${unsafe(pageGrid)}
+      </article>
+      <div class="er-toast" data-toast hidden></div>
+      ${renderShortcutsOverlay()}
+      <div class="er-poll-indicator" data-poll>auto-refresh · 8s</div>
+    </div>`;
+    return layout({
+        title: `${titleField} — Review`,
+        cssHrefs: [
+            '/static/css/editorial-review.css',
+            '/static/css/editorial-nav.css',
+            '/static/css/blog-figure.css',
+            '/static/css/review-viewport.css',
+        ],
+        bodyHtml: body,
+        embeddedJson: [{ id: 'draft-state', data: draftState }],
+        scriptModules: ['editorial-review-client'],
+    });
+}
+//# sourceMappingURL=shortform-review.js.map

package/dist/pages/shortform-review.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shortform-review.js","sourceRoot":"","sources":["../../src/pages/shortform-review.ts"],"names":[],"mappings":"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"}

package/dist/pages/shortform-review.ts

@@ -0,0 +1,342 @@
+/**
+ * Shortform review surface — `/dev/editorial-review/<workflow-id>`
+ * (when the bare-UUID resolves to a workflow record, not an entry).
+ *
+ * Phase 34a (#171): the longform/outline halves of `pages/review.ts`
+ * were retired. The workflow-keyed shortform pipeline survives
+ * intentionally — operator decision recorded in the PRD ("Not a
+ * shortform retirement"). This file holds the slim subset of the
+ * old renderer that shortform actually uses.
+ *
+ * Retirement: when shortform's own migration phase ships (tracked
+ * separately from #171), `pages/shortform-review.ts` and the bare-UUID
+ * route's workflow branch get deleted together. Until then, this file
+ * is a stable backwards-compat shim — not a "for now" code-comment IOU.
+ *
+ * Workflow-keyed wording in this file is documenting that deliberate
+ * deferral; do not flag in audits.
+ */
+
+import { handleGetWorkflow } from '@deskwork/core/review/handlers';
+import type {
+  DraftVersion,
+  DraftWorkflowItem,
+} from '@deskwork/core/review/types';
+import {
+  parseDraftFrontmatter,
+  renderMarkdownToHtml,
+} from '@deskwork/core/review/render';
+import type { StudioContext } from '../routes/api.ts';
+import { html, unsafe, type RawHtml } from './html.ts';
+import { layout } from './layout.ts';
+import { renderEditorialFolio } from './chrome.ts';
+import { escapeHtml, gloss } from './html.ts';
+
+interface ShortformReviewQuery {
+  /** ?v=<n>; null shows the workflow's currentVersion. */
+  version: string | null;
+}
+
+function isSuccessBody(
+  body: unknown,
+): body is { workflow: DraftWorkflowItem; versions: DraftVersion[] } {
+  if (typeof body !== 'object' || body === null) return false;
+  return 'workflow' in body && 'versions' in body;
+}
+
+function errorFromBody(body: unknown): string {
+  if (typeof body === 'object' && body !== null) {
+    const value = Reflect.get(body, 'error');
+    if (typeof value === 'string') return value;
+  }
+  return 'unknown error';
+}
+
+function stringField(v: unknown): string | undefined {
+  return typeof v === 'string' ? v : undefined;
+}
+
+function stateLabel(state?: string): string {
+  return (state ?? '').replace('-', ' ');
+}
+
+interface PreparedRender {
+  fm: Record<string, unknown>;
+  bodyHtml: string;
+}
+
+async function prepareShortformRender(markdown: string): Promise<PreparedRender> {
+  const parsed = parseDraftFrontmatter(markdown);
+  const fm = parsed.frontmatter;
+  const bodyHtml = await renderMarkdownToHtml(parsed.body);
+
+  // Inject the description as a dek after the body's first <h1>.
+  const description = stringField(fm.description);
+  const dekHtml = description
+    ? `<p class="er-dispatch-dek">${escapeHtml(description)}</p>`
+    : '';
+  const h1Close = bodyHtml.indexOf('</h1>');
+  const renderedHtml =
+    dekHtml && h1Close >= 0
+      ? bodyHtml.slice(0, h1Close + 5) + dekHtml + bodyHtml.slice(h1Close + 5)
+      : dekHtml + bodyHtml;
+
+  return { fm, bodyHtml: renderedHtml };
+}
+
+function renderVersionsStrip(
+  versions: readonly DraftVersion[],
+  current: DraftVersion,
+): RawHtml {
+  if (versions.length <= 1) return unsafe('');
+  const links = versions
+    .map((v) => {
+      const isActive = v.version === current.version;
+      const href = `?v=${v.version}`;
+      return html`<a href="${href}" class="${isActive ? 'active' : ''}">v${v.version}</a>`;
+    })
+    .join('');
+  return unsafe(html`<span class="er-strip-versions">${unsafe(links)}</span>`);
+}
+
+function pendingSkillCmd(workflow: DraftWorkflowItem): string {
+  const { site, slug, state } = workflow;
+  if (state === 'iterating') {
+    return `/deskwork:iterate --site ${site} ${slug}`;
+  }
+  if (state === 'approved') {
+    return `/deskwork:approve --site ${site} ${slug}`;
+  }
+  return '';
+}
+
+function shortcutChipWrap(buttonHtml: string, letter: 'a' | 'i' | 'r'): string {
+  return html`<span class="er-shortcut-chip-wrap">${unsafe(buttonHtml)}<small class="er-shortcut-chip"><kbd>${letter}</kbd><kbd>${letter}</kbd></small></span>`;
+}
+
+function renderControlsRight(workflow: DraftWorkflowItem): RawHtml {
+  const isActive = workflow.state === 'open' || workflow.state === 'in-review';
+  const isApproved = workflow.state === 'approved';
+  const isIterating = workflow.state === 'iterating';
+  const isTerminal = workflow.state === 'applied' || workflow.state === 'cancelled';
+  const buttons: string[] = [];
+  buttons.push(html`<button class="er-btn er-btn-small" data-action="toggle-edit" type="button">Edit</button><span class="er-edit-mode-label" data-mode="preview">preview</span>`);
+  if (isActive) {
+    buttons.push(
+      shortcutChipWrap(
+        html`<button class="er-btn er-btn-small er-btn-approve" data-action="approve" type="button">Approve</button>`,
+        'a',
+      ),
+    );
+    buttons.push(
+      shortcutChipWrap(
+        html`<button class="er-btn er-btn-small" data-action="iterate" type="button">Iterate</button>`,
+        'i',
+      ),
+    );
+    buttons.push(
+      shortcutChipWrap(
+        html`<button class="er-btn er-btn-small er-btn-reject" data-action="reject" type="button">Reject</button>`,
+        'r',
+      ),
+    );
+  }
+  if (isApproved) {
+    const applyCmd = pendingSkillCmd(workflow);
+    buttons.push(html`<span class="er-pending-state">awaiting apply…</span>`);
+    buttons.push(html`<button class="er-btn er-btn-small" data-action="copy-cmd" data-cmd="${applyCmd}" title="Copy ${applyCmd} to clipboard" type="button">copy <code>/deskwork:approve</code></button>`);
+    buttons.push(
+      shortcutChipWrap(
+        html`<button class="er-btn er-btn-small er-btn-reject" data-action="reject" type="button">Reject</button>`,
+        'r',
+      ),
+    );
+  }
+  if (isIterating) {
+    const iterateCmd = pendingSkillCmd(workflow);
+    buttons.push(html`<span class="er-pending-state">agent iterating…</span>`);
+    buttons.push(html`<button class="er-btn er-btn-small" data-action="copy-cmd" data-cmd="${iterateCmd}" title="Copy ${iterateCmd} to clipboard" type="button">copy <code>/deskwork:iterate</code></button>`);
+  }
+  if (isTerminal) {
+    buttons.push(html`<span class="er-pending-state er-pending-state--filed">filed (${workflow.state})</span>`);
+  }
+  buttons.push(html`<button class="er-btn er-btn-small" data-action="shortcuts" type="button" aria-label="Show keyboard shortcuts" title="Keyboard shortcuts">?</button>`);
+  return unsafe(`<span class="er-strip-right">${buttons.join('')}</span>`);
+}
+
+function renderShortcutsOverlay(): RawHtml {
+  return unsafe(html`
+    <div class="er-shortcuts" data-shortcuts-overlay hidden role="dialog" aria-modal="true" aria-label="Keyboard shortcuts">
+      <div class="er-shortcuts-backdrop" data-shortcuts-backdrop></div>
+      <div class="er-shortcuts-panel">
+        <h2>Keyboard</h2>
+        <dl>
+          <dt><kbd>e</kbd> / dbl-click</dt><dd>toggle edit mode</dd>
+          <dt><kbd>a</kbd> <kbd>a</kbd></dt><dd>approve <em>— press twice within 500ms</em></dd>
+          <dt><kbd>i</kbd> <kbd>i</kbd></dt><dd>iterate <em>— press twice within 500ms</em></dd>
+          <dt><kbd>r</kbd> <kbd>r</kbd></dt><dd>reject <em>— press twice within 500ms</em></dd>
+          <dt><kbd>?</kbd></dt><dd>this panel</dd>
+          <dt><kbd>esc</kbd></dt><dd>close</dd>
+        </dl>
+        <p class="er-shortcuts-footer">Press <kbd>?</kbd> anytime.</p>
+      </div>
+    </div>`);
+}
+
+function renderEditToolbar(): RawHtml {
+  return unsafe(html`
+    <div class="er-edit-toolbar" data-edit-toolbar hidden>
+      <div class="er-edit-modes" role="tablist" aria-label="Editor mode">
+        <button class="er-edit-mode-btn" data-edit-view="source" type="button" aria-pressed="true">Source</button>
+        <button class="er-edit-mode-btn" data-edit-view="split" type="button" aria-pressed="false">Split</button>
+        <button class="er-edit-mode-btn" data-edit-view="preview" type="button" aria-pressed="false">Preview</button>
+      </div>
+      <div class="er-edit-actions">
+        <button class="er-btn er-btn-small" data-action="focus-mode" type="button" title="Distraction-free mode (Shift+F)" aria-pressed="false">Focus ⛶</button>
+        <button class="er-btn er-btn-primary" data-action="save-version" type="button">Save as new version</button>
+        <button class="er-btn" data-action="cancel-edit" type="button">Cancel</button>
+        <span class="er-edit-hint" data-edit-hint></span>
+      </div>
+    </div>`);
+}
+
+function renderEditPanes(): RawHtml {
+  return unsafe(html`
+    <div class="er-edit-mode" data-edit-panes-host hidden>
+      <div class="er-edit-panes" data-edit-panes data-view="source">
+        <div class="er-edit-source" data-edit-source aria-label="Markdown source"></div>
+        <div class="er-edit-preview" data-edit-preview aria-label="Rendered preview"></div>
+      </div>
+      <textarea id="draft-edit" data-draft-edit hidden></textarea>
+      <div class="er-focus-exit" data-focus-exit aria-hidden="true">
+        <button type="button" data-action="exit-focus" title="Exit focus (Esc)">← exit focus</button>
+      </div>
+      <div class="er-focus-save" data-focus-save aria-hidden="true">
+        <button type="button" class="er-btn er-btn-small er-btn-primary" data-action="save-version">Save</button>
+        <span class="er-focus-save-hint" data-focus-save-hint></span>
+      </div>
+    </div>`);
+}
+
+function renderError(workflowId: string, message: string): string {
+  const body = html`
+    <div data-review-ui="shortform">
+      ${renderEditorialFolio('shortform', `shortform · ${workflowId}`)}
+      <div class="er-error">
+        <h1>No galley to review.</h1>
+        <p><strong>Workflow:</strong> <code>${workflowId}</code></p>
+        <p>${message}</p>
+        <p style="margin-top: 2rem;"><a href="/dev/editorial-studio">← back to the studio</a></p>
+      </div>
+    </div>`;
+  return layout({
+    title: `Review — ${workflowId} — error`,
+    cssHrefs: [
+      '/static/css/editorial-review.css',
+      '/static/css/editorial-nav.css',
+    ],
+    bodyHtml: body,
+    scriptModules: [],
+  });
+}
+
+/**
+ * Render the shortform review surface for a workflow id. The bare-UUID
+ * route in `server.ts` calls this when `:id` resolves to a workflow
+ * record (i.e. shortform). Longform UUIDs 301-redirect to the
+ * entry-keyed surface instead.
+ */
+export async function renderShortformReviewPage(
+  ctx: StudioContext,
+  workflowId: string,
+  query: ShortformReviewQuery,
+): Promise<string> {
+  const fetched = handleGetWorkflow(ctx.projectRoot, ctx.config, {
+    id: workflowId,
+    entryId: null,
+    site: null,
+    slug: null,
+    contentKind: null,
+    platform: null,
+    channel: null,
+  });
+
+  if (fetched.status !== 200 || !isSuccessBody(fetched.body)) {
+    return renderError(workflowId, errorFromBody(fetched.body));
+  }
+
+  const { workflow, versions } = fetched.body;
+  const slug = workflow.slug;
+
+  const requested = query.version ? parseInt(query.version, 10) : workflow.currentVersion;
+  const currentVersion =
+    versions.find((v) => v.version === requested) ?? versions[versions.length - 1];
+
+  if (!currentVersion) {
+    return renderError(workflowId, 'no current version on this workflow');
+  }
+
+  const { fm, bodyHtml } = await prepareShortformRender(currentVersion.markdown);
+  const draftState = { workflow, currentVersion, versions };
+  const titleField = stringField(fm.title) ?? `Draft: ${slug}`;
+
+  const shortformMeta: RawHtml = unsafe(html`
+    <div class="er-shortform-meta">
+      <span class="er-platform">${workflow.platform ?? 'other'}</span>
+      ${workflow.channel
+        ? unsafe(html`<span class="er-channel">${workflow.channel}</span>`)
+        : ''}
+    </div>`);
+
+  const folioSpine = `shortform · ${workflow.platform ?? '?'}${workflow.channel ? ` · ${workflow.channel}` : ''} · ${slug}`;
+
+  const pageGrid = html`
+    <div class="er-page-grid">
+      <div class="er-draft-frame">
+        <div id="draft-body" data-draft-body
+          title="Double-click to edit">${unsafe(bodyHtml)}</div>
+        ${renderEditPanes()}
+      </div>
+    </div>`;
+
+  const body = html`
+    <div data-review-ui="shortform" class="er-review-shell">
+      ${renderEditorialFolio('shortform', folioSpine)}
+      ${shortformMeta}
+      <div class="er-strip">
+        <div class="er-strip-inner">
+          <a class="er-strip-back" href="/dev/editorial-studio" title="Back to the editorial studio">← studio</a>
+          <span class="er-strip-galley">${gloss('galley')} <em>№ ${currentVersion.version}</em></span>
+          <span class="er-strip-slug">${workflow.site} / ${workflow.slug}</span>
+          ${renderVersionsStrip(versions, currentVersion)}
+          <span class="er-strip-center">
+            <span class="er-stamp er-stamp-big er-stamp-${workflow.state}" data-state-label>
+              ${stateLabel(workflow.state)}
+            </span>
+            <span class="er-strip-hint">double-click to edit · <kbd>?</kbd> for shortcuts</span>
+          </span>
+          ${renderControlsRight(workflow)}
+        </div>
+      </div>
+      ${renderEditToolbar()}
+      <article class="er-page">
+        ${unsafe(pageGrid)}
+      </article>
+      <div class="er-toast" data-toast hidden></div>
+      ${renderShortcutsOverlay()}
+      <div class="er-poll-indicator" data-poll>auto-refresh · 8s</div>
+    </div>`;
+
+  return layout({
+    title: `${titleField} — Review`,
+    cssHrefs: [
+      '/static/css/editorial-review.css',
+      '/static/css/editorial-nav.css',
+      '/static/css/blog-figure.css',
+      '/static/css/review-viewport.css',
+    ],
+    bodyHtml: body,
+    embeddedJson: [{ id: 'draft-state', data: draftState }],
+    scriptModules: ['editorial-review-client'],
+  });
+}