@deskwork/studio 0.9.8 → 0.10.0

package/dist/pages/index.ts

@@ -17,6 +17,8 @@
  * Read-only — links to existing routes only. No editing capability here.
  */
 
+import { readWorkflows } from '@deskwork/core/review/pipeline';
+import type { DraftWorkflowItem } from '@deskwork/core/review/types';
 import type { StudioContext } from '../routes/api.ts';
 import { html, unsafe, type RawHtml } from './html.ts';
 import { layout } from './layout.ts';
@@ -29,8 +31,17 @@ interface IndexEntry {
   titleHtml: string;
   /** Plain-text fallback for accessibility (used as link text). */
   titleText: string;
-  /** Route path. When `template` is set, no link renders. */
+  /** Route path. When `template` is set, the path is shown but the
+   *  hyperlink target comes from `linkHref` instead. */
   route: string;
+  /**
+   * Explicit link target. When set, the title becomes a link to this
+   * URL — even for templated entries (where the visual route hint
+   * stays alongside as a placeholder). When omitted, behavior depends
+   * on `template`: non-templated entries link to `route`; templated
+   * entries render as plain text.
+   */
+  linkHref?: string;
   /**
    * For templated routes (longform reviews, scrapbook), this is the
    * placeholder text shown in red-pencil italic. The route string still
@@ -52,90 +63,139 @@ interface IndexSection {
   entries: IndexEntry[];
 }
 
-const SECTIONS: readonly IndexSection[] = [
-  {
-    ornament: '¶',
-    name: 'Pipeline',
-    count: 'i. — 1 surface',
-    entries: [
-      {
-        numeral: 'I',
-        titleHtml: 'Dashboard',
-        titleText: 'Dashboard',
-        route: '/dev/editorial-studio',
-        desc: 'Press-check. The calendar across all sites; awaiting press; recent proofs; voice-drift signal.',
-      },
-    ],
-  },
-  {
-    ornament: '¶',
-    name: 'Review desk',
-    count: 'ii.–iii. — 2 surfaces',
-    entries: [
-      {
-        numeral: 'II',
-        titleHtml: 'Shortform reviews',
-        titleText: 'Shortform reviews',
-        route: '/dev/editorial-review-shortform',
-        desc: 'Cross-platform copy desk. Reddit, LinkedIn, YouTube, Instagram — galley slips, one per platform.',
-      },
-      {
-        numeral: 'III',
-        titleHtml: 'Longform reviews',
-        titleText: 'Longform reviews',
-        route: '/dev/editorial-review/<slug>',
-        template: { prefix: '/dev/editorial-review/', placeholder: '<slug>' },
-        desc: 'Per-entry margin notes, decisions, iterate flow.',
-        hint: 'entry-by-entry',
-        postHint: 'Reach via the Dashboard or Content view; each review is opened against a specific slug.',
-      },
-    ],
-  },
-  {
-    ornament: '¶',
-    name: 'Browse',
-    count: 'iv.–v. — 2 surfaces',
-    entries: [
-      {
-        numeral: 'IV',
-        titleHtml: 'Content view',
-        titleText: 'Content view',
-        route: '/dev/content',
-        desc: 'The shape of the work. A drillable tree of nodes; click any to read its head matter and browse its scrapbook.',
-      },
-      {
-        numeral: 'V',
-        titleHtml: 'Scrapbook',
-        titleText: 'Scrapbook',
-        route: '/dev/scrapbook/<site>/<path>',
-        template: { prefix: '/dev/scrapbook/', placeholder: '<site>/<path>' },
-        desc: 'Research, receipts, working notes. Addressed by hierarchical path; secret items appear in their own section.',
-        hint: 'path-addressed',
-        postHint: "Reach via the Content view's per-node drawer, or address directly.",
-      },
-    ],
-  },
-  {
-    ornament: '¶',
-    name: 'Reference',
-    count: 'vi. — 1 surface',
-    entries: [
-      {
-        numeral: 'VI',
-        titleHtml: "The Compositor's <em>Manual</em>",
-        titleText: "The Compositor's Manual",
-        route: '/dev/editorial-help',
-        desc: 'The workflow, the skill catalogue, the names of the things — read once, return when the work asks.',
-      },
-    ],
-  },
-];
+/**
+ * Pick the workflow that should be the default Longform-reviews target —
+ * the most-recent open longform workflow (in-review or open). Returns
+ * null when no candidate exists; the caller falls back to the dashboard's
+ * Review section anchor.
+ */
+function pickDefaultLongformWorkflow(
+  workflows: readonly DraftWorkflowItem[],
+): DraftWorkflowItem | null {
+  const candidates = workflows
+    .filter((w) => w.contentKind === 'longform')
+    .filter((w) => w.state === 'in-review' || w.state === 'open')
+    .slice()
+    .sort((a, b) => b.updatedAt.localeCompare(a.updatedAt));
+  return candidates[0] ?? null;
+}
+
+function buildSections(ctx: StudioContext): readonly IndexSection[] {
+  const workflows: readonly DraftWorkflowItem[] = (() => {
+    try {
+      return readWorkflows(ctx.projectRoot, ctx.config);
+    } catch {
+      return [];
+    }
+  })();
+  const longformDefault = pickDefaultLongformWorkflow(workflows);
+  // Issue #107: III links to the most-recent in-review longform when
+  // one exists, else falls back to the dashboard's Review section
+  // anchor (`#stage-review`, mounted in sub-phase D). The visual
+  // template hint stays alongside the link so adopters still see the
+  // URL shape — `<slug>` placeholder shown in red-pencil italic.
+  const longformLinkHref =
+    longformDefault !== null
+      ? `/dev/editorial-review/${longformDefault.id}`
+      : '/dev/editorial-studio#stage-review';
+
+  return [
+    {
+      ornament: '¶',
+      name: 'Pipeline',
+      count: 'i. — 1 surface',
+      entries: [
+        {
+          numeral: 'I',
+          titleHtml: 'Dashboard',
+          titleText: 'Dashboard',
+          route: '/dev/editorial-studio',
+          desc: 'Press-check. The calendar across all sites; awaiting press; recent proofs; voice-drift signal.',
+        },
+      ],
+    },
+    {
+      ornament: '¶',
+      name: 'Review desk',
+      count: 'ii.–iii. — 2 surfaces',
+      entries: [
+        {
+          numeral: 'II',
+          titleHtml: 'Shortform reviews',
+          titleText: 'Shortform reviews',
+          route: '/dev/editorial-review-shortform',
+          desc: 'Cross-platform copy desk. Reddit, LinkedIn, YouTube, Instagram — galley slips, one per platform.',
+        },
+        {
+          numeral: 'III',
+          titleHtml: 'Longform reviews',
+          titleText: 'Longform reviews',
+          route: '/dev/editorial-review/<slug>',
+          linkHref: longformLinkHref,
+          template: { prefix: '/dev/editorial-review/', placeholder: '<slug>' },
+          desc: 'Per-entry margin notes, decisions, iterate flow.',
+          hint: 'entry-by-entry',
+          postHint:
+            longformDefault !== null
+              ? `Defaults to the most-recent in-review longform (${longformDefault.slug}). Or reach via the Dashboard or Content view.`
+              : 'Defaults to the dashboard\'s Review section. Open a longform workflow to populate the per-entry deep-link.',
+        },
+      ],
+    },
+    {
+      ornament: '¶',
+      name: 'Browse',
+      count: 'iv.–v. — 2 surfaces',
+      entries: [
+        {
+          numeral: 'IV',
+          titleHtml: 'Content view',
+          titleText: 'Content view',
+          route: '/dev/content',
+          desc: 'The shape of the work. A drillable tree of nodes; click any to read its head matter and browse its scrapbook.',
+        },
+        {
+          numeral: 'V',
+          titleHtml: 'Scrapbook',
+          titleText: 'Scrapbook',
+          route: '/dev/scrapbook/<site>/<path>',
+          // Issue #107: scrapbook is reached by drilling into a content
+          // node. Default link points at the content view; the URL
+          // template hint stays so adopters see the addressing shape.
+          linkHref: '/dev/content',
+          template: { prefix: '/dev/scrapbook/', placeholder: '<site>/<path>' },
+          desc: 'Research, receipts, working notes. Addressed by hierarchical path; secret items appear in their own section.',
+          hint: 'path-addressed',
+          postHint: "Reach via the Content view's per-node drawer, or address directly.",
+        },
+      ],
+    },
+    {
+      ornament: '¶',
+      name: 'Reference',
+      count: 'vi. — 1 surface',
+      entries: [
+        {
+          numeral: 'VI',
+          titleHtml: "The Compositor's <em>Manual</em>",
+          titleText: "The Compositor's Manual",
+          route: '/dev/editorial-help',
+          desc: 'The workflow, the skill catalogue, the names of the things — read once, return when the work asks.',
+        },
+      ],
+    },
+  ];
+}
 
 function renderEntryTitle(entry: IndexEntry): string {
-  if (entry.template) {
+  // Explicit linkHref wins. Otherwise: non-templated entries link to
+  // their route; templated entries with no fallback render as plain
+  // text (the route is templated, can't be linked verbatim).
+  const href = entry.linkHref ?? (entry.template ? null : entry.route);
+  if (href === null) {
     return html`<span class="er-toc-entry__title">${unsafe(entry.titleHtml)}</span>`;
   }
-  return html`<a class="er-toc-entry__title" href="${entry.route}">${unsafe(entry.titleHtml)}</a>`;
+  return html`<a class="er-toc-entry__title" href="${href}">${unsafe(entry.titleHtml)}</a>`;
 }
 
 function renderEntryRoute(entry: IndexEntry): string {
@@ -181,7 +241,8 @@ function renderSection(section: IndexSection): RawHtml {
     </section>`);
 }
 
-export function renderStudioIndex(_ctx: StudioContext): string {
+export function renderStudioIndex(ctx: StudioContext): string {
+  const sections = buildSections(ctx);
   const body = html`
     ${renderEditorialFolio('index', 'index of the press')}
     <main class="er-toc-page">
@@ -193,9 +254,9 @@ export function renderStudioIndex(_ctx: StudioContext): string {
           Begin where the work is.
         </p>
       </header>
-      ${SECTIONS.map(renderSection)}
+      ${sections.map(renderSection)}
       <footer class="er-toc-colophon">
-        Pressed in the deskwork studio. Loopback only.<br>
+        Pressed in the deskwork studio.<br>
         <span class="er-toc-colophon__rule"></span>
       </footer>
     </main>`;

package/dist/pages/review.js

@@ -190,9 +190,9 @@ function renderShortcutsOverlay() {
           <dt><kbd>e</kbd> / dbl-click</dt><dd>toggle edit mode</dd>
           <dt>select text</dt><dd>leave a margin note</dd>
           <dt><kbd>⌘</kbd><kbd>↵</kbd> / <kbd>ctrl</kbd><kbd>↵</kbd></dt><dd>save margin note (in composer)</dd>
-          <dt><kbd>a</kbd></dt><dd>approve</dd>
-          <dt><kbd>i</kbd></dt><dd>iterate</dd>
-          <dt><kbd>r</kbd></dt><dd>reject</dd>
+          <dt><kbd>a</kbd> <kbd>a</kbd></dt><dd>approve <em>— press twice within 500ms; first press arms, second fires</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>j</kbd> / <kbd>k</kbd></dt><dd>next / previous margin note</dd>
           <dt><kbd>?</kbd></dt><dd>this panel</dd>
           <dt><kbd>esc</kbd></dt><dd>close / cancel composer</dd>

package/dist/pages/review.ts

@@ -275,9 +275,9 @@ function renderShortcutsOverlay(): RawHtml {
           <dt><kbd>e</kbd> / dbl-click</dt><dd>toggle edit mode</dd>
           <dt>select text</dt><dd>leave a margin note</dd>
           <dt><kbd>⌘</kbd><kbd>↵</kbd> / <kbd>ctrl</kbd><kbd>↵</kbd></dt><dd>save margin note (in composer)</dd>
-          <dt><kbd>a</kbd></dt><dd>approve</dd>
-          <dt><kbd>i</kbd></dt><dd>iterate</dd>
-          <dt><kbd>r</kbd></dt><dd>reject</dd>
+          <dt><kbd>a</kbd> <kbd>a</kbd></dt><dd>approve <em>— press twice within 500ms; first press arms, second fires</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>j</kbd> / <kbd>k</kbd></dt><dd>next / previous margin note</dd>
           <dt><kbd>?</kbd></dt><dd>this panel</dd>
           <dt><kbd>esc</kbd></dt><dd>close / cancel composer</dd>

package/dist/pages/shortform.js

@@ -95,7 +95,7 @@ function renderEmptyState() {
       No short-form galleys on the desk.<br />
       Supported platforms: <em>${platformList}</em>.<br />
       Start a new shortform draft from the dashboard's
-      <a href="/dev/editorial-studio">coverage matrix</a>.
+      <a href="/dev/editorial-studio#stage-drafting">Drafting list</a>.
     </div>`);
 }
 export function renderShortformPage(ctx) {

package/dist/pages/shortform.ts

@@ -111,7 +111,7 @@ function renderEmptyState(): RawHtml {
       No short-form galleys on the desk.<br />
       Supported platforms: <em>${platformList}</em>.<br />
       Start a new shortform draft from the dashboard's
-      <a href="/dev/editorial-studio">coverage matrix</a>.
+      <a href="/dev/editorial-studio#stage-drafting">Drafting list</a>.
     </div>`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@deskwork/studio",
-  "version": "0.9.8",
+  "version": "0.10.0",
   "type": "module",
   "description": "Editorial review studio — local web UI for the deskwork plugin",
   "homepage": "https://github.com/audiocontrol-org/deskwork#readme",
@@ -45,7 +45,7 @@
     "@codemirror/language": "^6.12.3",
     "@codemirror/state": "^6.6.0",
     "@codemirror/view": "^6.41.1",
-    "@deskwork/core": "0.9.8",
+    "@deskwork/core": "0.10.0",
     "@hono/node-server": "^1.13.7",
     "@lezer/highlight": "^1.2.3",
     "esbuild": "^0.28.0",