@aemonge-dev/pi-stardeck 0.14.0 → 0.15.0

package/README.md

@@ -28,8 +28,21 @@ The package composes four bounded modules in dependency-safe order:
 
 - **Footer telemetry** — session usage cost for the deck's telemetry row, with an
   empty quota seam;
-- **Status provider** — lifecycle, OpenSpec, Session Work, and diagnostic state;
-- **Header Deck** — current activity, focus, project state, and compact telemetry.
+- **Status provider** — lifecycle, the room aim's OpenSpec state, and diagnostic
+  state;
+- **Header Deck** — current activity, the focused change, project state, and compact
+  telemetry.
+
+The focused change is the room aim — `openspec/.focus`, written by your terminal
+(`eospec`/`pios-gate` verbs) and read verbatim by the cockpit:
+
+```text
+{icon} {artifact-name} {artifact-idx} › {task} ⟩ {next-step}   ← line 2, right
+{icon} {change}                                                ← engine row, right
+```
+
+An aimless room wears gray `(unfocus openspec)` in that slot; warnings speak on their
+own dynamic line; nothing renders when there is nothing to say.
   Companion extensions surface as leading telemetry icons:
 
   | Chip | Extension | Meaning |
@@ -54,6 +67,11 @@ fail soft when absent. Pi core remains the API authority.
   its only argument, opens it in the enclosing Neovim instance, and exits when that
   buffer closes.
 
+**Recommended pairing — [pi-title](https://www.npmjs.com/package/pi-title):** the deck's
+left title band prefers the native session name, and pi-title names each session from
+its first request. Install it alongside the deck and every session opens already named;
+manual titles are never replaced automatically.
+
 The bridge is deliberately not shipped: connecting to a private Neovim server is
 machine-specific and belongs in your trusted user configuration.
 

package/demo/pi-stardeck.tape

@@ -21,7 +21,7 @@ Set PlaybackSpeed 1
 # stays attached so the recording does not stall on a cold cache. Keep setup
 # out of the recording.
 Hide
-Type "export DEMO_HOME=/tmp/pi-stardeck-demo && rm -rf $DEMO_HOME && mkdir -p $DEMO_HOME && export NPM_CACHE_KEEP=$HOME/.npm && export HOME=$DEMO_HOME && export NPM_CONFIG_PREFIX=$HOME/.npm-global && export npm_config_cache=$NPM_CACHE_KEEP && export PATH=$NPM_CONFIG_PREFIX/bin:$PATH && clear"
+Type "export DEMO_HOME=/tmp/pi-stardeck-demo && rm -rf $DEMO_HOME && mkdir -p $DEMO_HOME/demo-room/openspec/changes/hello-script && printf '# one active change per room — eospec writes, verbs refresh\nchange: hello-script\nartifact-name: 1-brainstorm.md\nartifact-idx: 1/4\ntask: \"\"\nnext-step: draft 1-brainstorm.md\n' > $DEMO_HOME/demo-room/openspec/.focus && export NPM_CACHE_KEEP=$HOME/.npm && export HOME=$DEMO_HOME && export NPM_CONFIG_PREFIX=$HOME/.npm-global && export npm_config_cache=$NPM_CACHE_KEEP && export PATH=$NPM_CONFIG_PREFIX/bin:$PATH && clear"
 Enter
 Wait
 Show
@@ -37,13 +37,16 @@ Show
 Wait+Screen@30s /Installed npm:@aemonge-dev\/pi-stardeck/
 Sleep 1s
 
-# Launch a clean cockpit session from the fresh install.
-Type "clear && pi --offline --no-session --no-context-files --tui-mode regular"
+# Launch a clean cockpit session inside the aimed demo room: the room aim
+# (openspec/.focus) drives the verbatim work tile and the focus spec on
+# the engine row.
+Type "cd $DEMO_HOME/demo-room && clear && pi --offline --no-session --no-context-files --tui-mode regular"
 Enter
 Hide
 Sleep 12s
 Show
 Wait+Screen@60s /waiting/
+Wait+Screen@10s /hello-script/
 Sleep 4s
 
 # Exercise a real ephemeral title change without creating a session.

package/docs/architecture.md

@@ -44,7 +44,8 @@ The composed modules currently coordinate through:
 
 These channels are compatibility boundaries. Consolidation may centralize their types
 but must not silently change semantics or permit sensitive payloads. Selection is an
-additive protocol-1 projection of explicit OpenSpec or Session Work state;
+additive protocol-1 projection of explicit Session Work state; the focused change
+lives in the room aim (`openspec/.focus`) and renders verbatim without selection;
 suggestion is controlled vocabulary rather than generated prose. Active-run telemetry
 contains only bounded child and subagent counts derived from Pi lifecycle events. It
 never carries prompts, names, process identities, arguments, or child output. The deck

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aemonge-dev/pi-stardeck",
-  "version": "0.14.0",
+  "version": "0.15.0",
   "description": "A Vim- and tmux-inspired command deck for Pi",
   "type": "module",
   "keywords": [
@@ -48,11 +48,10 @@
     "check:openspec": "node scripts/check-openspec.mjs",
     "test:tooling": "node --import tsx/esm --test test/*.test.ts",
     "test:status": "npm --prefix packages/status test",
-    "test:work-state": "npm --prefix packages/work-state test",
     "test:stardeck": "npm --prefix packages/pi-stardeck test",
     "test:footer": "npm --prefix packages/footer test",
     "test:vim": "npm --prefix packages/pi-vim-top-border test",
-    "test:components": "npm run test:status && npm run test:work-state && npm run test:stardeck && npm run test:footer && npm run test:vim"
+    "test:components": "npm run test:status && npm run test:stardeck && npm run test:footer && npm run test:vim"
   },
   "peerDependencies": {
     "@earendil-works/pi-ai": "*",

package/packages/pi-stardeck/index.ts

@@ -125,13 +125,6 @@ export function installEmptyDeckFooter(
   return () => ctx.ui.setFooter(undefined);
 }
 
-/** Git-style short id of the running Pi session — 8 hex chars of the
- * UUIDv7, undefined when the id does not match the expected shape. */
-function shortSessionId(ctx: ExtensionContext): string | undefined {
-  const short = ctx.sessionManager.getSessionId().slice(0, 8);
-  return /^[0-9a-f]{8}$/u.test(short) ? short : undefined;
-}
-
 export default function galacticaContextHeader(
   pi: ExtensionAPI,
   options: ContextHeaderOptions = {},
@@ -149,7 +142,6 @@ export default function galacticaContextHeader(
   let lastObservedActivityAt: number | null = null;
   let activityAgeTimer: ReturnType<typeof setInterval> | undefined;
   let sessionGeneration = 0;
-  let sessionShortId: string | undefined;
   let activeCwd = '';
   let activeCtx: ExtensionContext | undefined;
   let gitRefreshInFlight = false;
@@ -369,7 +361,6 @@ export default function galacticaContextHeader(
     resourceTimer = undefined;
     ++sessionGeneration;
     activeCtx = ctx;
-    sessionShortId = shortSessionId(ctx);
     activeCwd = '';
     branch = '';
     gitAvailable = false;
@@ -444,7 +435,6 @@ export default function galacticaContextHeader(
           lsp: lspCapability,
           mcp: mcpCapability,
           mode: vimMode,
-          ...(sessionShortId !== undefined ? { sessionShortId } : {}),
         },
         width,
         theme,

package/packages/pi-stardeck/src/deck.ts

@@ -11,7 +11,7 @@ import type {
 } from './gauge.ts';
 import type { ResourceTelemetry } from './process-resources.ts';
 import { formatDeckCountdown } from './gauge.ts';
-import { deckWorkSegments } from './title-state.ts';
+import { deckWorkSegments, OPEN_SPEC_ICON } from './title-state.ts';
 
 export interface HeaderDeckModeRail {
   plain: string;
@@ -39,8 +39,6 @@ export interface HeaderDeckState {
   lsp: LspCapability | null;
   mcp: McpCapability | null;
   mode: VimMode;
-  /** Git-style first 8 chars of the Pi session id; worn by the sentinel. */
-  sessionShortId?: string;
 }
 
 const ANSI_ESCAPE = new RegExp(
@@ -242,7 +240,7 @@ function workTile(state: HeaderDeckState, theme: Theme, width: number): string {
   if (!title) return '';
   const work = title.work;
   if (!work) return '';
-  return deckWorkSegments(work, Date.now(), width < 56)
+  return deckWorkSegments(work, width < 56)
     .map((segment) => color(theme, segment.color, segment.text, segment.bold === true))
     .join('');
 }
@@ -400,7 +398,7 @@ const COMPANION_ERROR_PATTERN = /(error|fail|down|unreachable|unhealthy)/iu;
 type ChipSeverity = 'healthy' | 'degraded' | 'error' | 'off';
 
 function companionSeverity(text: string | undefined): ChipSeverity {
-  // Error-grade words outrank degrade-grade when both appear.
+  // Error-grade words win over degrade-grade when both appear.
   if (text === undefined) return 'off';
   if (COMPANION_ERROR_PATTERN.test(text)) return 'error';
   if (COMPANION_DEGRADE_PATTERN.test(text)) return 'degraded';
@@ -471,14 +469,9 @@ function identityCluster(
 const BLOCKED_NOTICE = '\u26d4 blocked';
 const APPROVAL_NOTICE = 'approval required';
 
-/** Narrowest frame that hosts the id-bearing sentinel cluster (12 cells
- * plus breathing room for the machine ladder). */
-const SENTINEL_ID_MIN_WIDTH = 24;
-const SENTINEL_BUG = '\u{F082D}';
-
 function companionWarningTexts(state: HeaderDeckState): string[] {
   // Same sources as the capability-health chips: the known companions'
-  // native-status texts, ranked after blocked/approval.
+  // native-status texts, ordered after blocked/approval.
   const texts = new Map<string, string>();
   for (const item of state.piStatus?.nativeStatuses ?? []) {
     if (texts.has(item.key)) continue;
@@ -499,7 +492,7 @@ function companionWarningTexts(state: HeaderDeckState): string[] {
 
 /**
  * Aggregate the deck's scattered warning signals into one notice slot
- * (Task 3.1). Ranked per the spec's accepted mixed render: the companion
+ * (Task 3.1). Ordered per the spec's accepted mixed render: the companion
  * group (blocked, approval, warning texts), then the diagnostics count —
  * `·`-joined, empty when clean.
  */
@@ -519,24 +512,12 @@ export function collectDeckNotices(state: HeaderDeckState): string[] {
   return waiver ? notices.filter((notice) => notice !== waiver.notice) : notices;
 }
 
-function noticeTile(state: HeaderDeckState, theme: Theme, width: number): string {
+function warningLine(state: HeaderDeckState, theme: Theme): string {
+  // Dynamic line, Human-directed 2026-11-11 (reorder-deck-frame): the
+  // warning exists only when there is something to say — its dotted seam
+  // exists with it. Silence renders nothing, never a reserved slot.
   const notices = collectDeckNotices(state);
-  // Healthy sentinel (Human-directed 2026-10-19, reversing the retirement):
-  // when the ladder is silent the dim ladybug holds the right end — the
-  // deck's signature glyph and a reserved one (safeText strips 󰠭 from
-  // published text), so the status row always speaks: ⚠ with notices,
-  // the quiet ladybug when all is well. Ladybug-session-id amendment
-  // (Human-directed 2026-10-20): a clean frame with a known session id
-  // wears it between two ladybugs — blue bugs, purple id — so the deck
-  // doubles as a track-and-restore handle; the plain dim bug stays when
-  // the id is unknown or the frame is too narrow for the cluster.
-  if (notices.length === 0) {
-    const id = state.sessionShortId;
-    if (id !== undefined && width >= SENTINEL_ID_MIN_WIDTH) {
-      return `${color(theme, 'accent', SENTINEL_BUG)} ${color(theme, 'thinkingHigh', id)} ${color(theme, 'accent', SENTINEL_BUG)}`;
-    }
-    return color(theme, 'dim', SENTINEL_BUG);
-  }
+  if (notices.length === 0) return '';
   // Blocked carries the error severity it wore on the deleted lifecycle
   // tile; every other notice renders at warning.
   const semantic = notices.includes(BLOCKED_NOTICE) ? 'error' : 'warning';
@@ -615,7 +596,7 @@ function deckCornerRight(state: HeaderDeckState, theme: Theme, width: number): s
   return width - visibleWidth(engine) - 1 >= 20 ? engine : '';
 }
 
-function machineCornerLadder(
+function machineCornerNotices(
   state: HeaderDeckState,
   theme: Theme,
   width: number,
@@ -771,21 +752,23 @@ export function renderHeaderDeck(
         boundedWidth,
       )
     : '';
-  // deck-reshape, swap amendment: the bottom row carries the MACHINE
-  // tail on the left (yielding right-to-left into whatever width the
-  // status leaves) and the status on the right — which always speaks
-  // now: ⚠ notices or the dim ladybug sentinel when clean. The engine
-  // group moved to line 1 right.
-  const statusRight = noticeTile(state, theme, boundedWidth);
-  const machineRow = machineCornerLadder(
+  // deck-reshape, swap amendment (reorder-deck-frame 2026-11-11): the
+  // bottom row carries the MACHINE tail on the left and THE FOCUS SPEC
+  // on the right — the room aim's change slug, read as-is from
+  // `openspec/.focus`. An aimless room wears the gray placeholder;
+  // nothing else ever sits in this seat.
+  const focusSpec = safeText(state.header?.title?.work?.change ?? '');
+  const aimRight =
+    focusSpec === ''
+      ? color(theme, 'dim', '(unfocus openspec)')
+      : color(theme, 'success', `${OPEN_SPEC_ICON} ${focusSpec}`);
+  const machineRow = machineCornerNotices(
     state,
     theme,
-    statusRight === '' ? boundedWidth : boundedWidth - visibleWidth(statusRight) - 1,
+    boundedWidth - visibleWidth(aimRight) - 1,
   );
-  const engineRow =
-    statusRight === '' && machineRow === ''
-      ? ''
-      : alignedSingleRow(machineRow, statusRight, boundedWidth);
+  const engineRow = alignedSingleRow(machineRow, aimRight, boundedWidth);
+  const warning = warningLine(state, theme);
 
   // Band adjacency (Human-directed, accepted mockups; third 2.4
   // amendment): the deck opens with a full ─ rule directly beneath the
@@ -813,6 +796,7 @@ export function renderHeaderDeck(
     ...(bandSpeaks ? [activityRow] : []),
     ...spanRows,
     ...(engineRow.trim() !== '' ? [dottedRule, engineRow] : []),
+    ...(warning.trim() !== '' ? [dottedRule, warning] : []),
   ];
   return rows.map((line) => fitWithoutDanglingSeparator(line, boundedWidth));
 }

package/packages/pi-stardeck/src/title-state.ts

@@ -1,5 +1,5 @@
 /**
- * Deck-side defensive parser for the title-state contract v1
+ * Deck-side defensive parser for the title-state contract v2
  * (`deck-title-state`, published as the `title` field on
  * `galactica-status:header` with the per-turn `turn` meter beside it).
  *
@@ -12,8 +12,6 @@
  * the legacy selection/activity rendering.
  */
 
-import { compactActivityAge } from './activity-age.ts';
-
 export const DECK_TITLE_STATE_VERSION = 2 as const;
 
 export const DECK_TITLE_ACTIVITY_CLASSES = [
@@ -31,39 +29,23 @@ export type DeckTitleActivityClass = (typeof DECK_TITLE_ACTIVITY_CLASSES)[number
  * render-time width crop owns the real limit now). */
 export const DECK_TITLE_TARGET_MAX = 120;
 
-/** Task/step totals bound from the accepted schema. */
-export const DECK_TITLE_TOTAL_MAX = 999;
-
 const SUBJECT_MAX = 180;
 const IDENTIFIER_MAX = 120;
 const TASK_ID_MAX = 32;
 const SPAN_ID_MAX = 64;
 const WAIVER_ID_MAX = 64;
 const NOTICE_MAX = 180;
-const ARTIFACTS_MAX = 16;
-const GATE_ACT_MAX = 180;
 const TURN_TOKENS_MAX = 999_999_999;
 const TURN_ELAPSED_MAX = (99 * 60 + 59) * 1_000 + 999;
 
-export type DeckTitleArtifactState = {
-  id: string;
-  done: boolean;
-  items?: { done: number; total: number };
-};
-
 export type DeckTitleWorkState = {
   change: string;
+  /** Room-aim verbatim fields (observe-room-aim render law): printed
+   * as-is — the deck is a printer, not a translator. */
+  artifactName?: string;
+  artifactIdx?: string;
   task?: string;
-  schemaName?: string;
-  artifacts?: DeckTitleArtifactState[];
-  /** The artifact the work is in — first not done, else last done. */
-  currentArtifact?: string;
-  /** Attention facts, derived from publisher-owned truth only. */
-  awaitingValidation?: boolean;
-  focusAt?: number;
-  focusStale?: boolean;
-  /** The gate's relayed act line — dim commentary in the optional slot. */
-  gateAct?: string;
+  nextStep?: string;
 };
 
 export type DeckTitleActivityState = {
@@ -103,15 +85,6 @@ function boundedText(
   return points.join('');
 }
 
-function boundedTotal(value: unknown): number | null {
-  return typeof value === 'number' &&
-    Number.isInteger(value) &&
-    value >= 0 &&
-    value <= DECK_TITLE_TOTAL_MAX
-    ? value
-    : null;
-}
-
 function parseTitleActivity(value: unknown): DeckTitleActivityState | null | undefined {
   if (value === null) return null;
   if (!isRecord(value)) return undefined;
@@ -137,69 +110,25 @@ function parseTitleWork(value: unknown): DeckTitleWorkState | null | undefined {
   if (!isRecord(value)) return undefined;
   const change = boundedText(value.change, IDENTIFIER_MAX);
   if (!change) return undefined;
-  const task = boundedText(value.task, TASK_ID_MAX, { required: false });
-  if (task === null) return undefined;
-  const schemaName = boundedText(value.schemaName, IDENTIFIER_MAX, {
+  const artifactName = boundedText(value.artifactName, IDENTIFIER_MAX, {
     required: false,
   });
-  if (schemaName === null) return undefined;
-  const currentArtifact = boundedText(value.currentArtifact, TASK_ID_MAX, {
+  if (artifactName === null) return undefined;
+  const artifactIdx = boundedText(value.artifactIdx, TASK_ID_MAX, {
     required: false,
   });
-  if (currentArtifact === null) return undefined;
-  let artifacts: DeckTitleArtifactState[] | undefined;
-  if ('artifacts' in value) {
-    if (!Array.isArray(value.artifacts) || value.artifacts.length > ARTIFACTS_MAX) {
-      return undefined;
-    }
-    const parsed: DeckTitleArtifactState[] = [];
-    for (const entry of value.artifacts) {
-      if (!isRecord(entry)) return undefined;
-      const id = boundedText(entry.id, TASK_ID_MAX);
-      if (!id) return undefined;
-      if (typeof entry.done !== 'boolean') return undefined;
-      const artifactDone = entry.done;
-      let items: { done: number; total: number } | undefined;
-      if ('items' in entry) {
-        if (!isRecord(entry.items)) return undefined;
-        const done = boundedTotal(entry.items.done);
-        const total = boundedTotal(entry.items.total);
-        if (done === null || total === null) return undefined;
-        items = { done, total };
-      }
-      parsed.push({ id, done: artifactDone, ...(items ? { items } : {}) });
-    }
-    artifacts = parsed;
-  }
-  if ('awaitingValidation' in value && typeof value.awaitingValidation !== 'boolean') {
-    return undefined;
-  }
-  let focusAt: number | undefined;
-  if ('focusAt' in value) {
-    if (
-      typeof value.focusAt !== 'number' ||
-      !Number.isSafeInteger(value.focusAt) ||
-      value.focusAt < 0
-    ) {
-      return undefined;
-    }
-    focusAt = value.focusAt;
-  }
-  if ('focusStale' in value && typeof value.focusStale !== 'boolean') {
-    return undefined;
-  }
-  const gateAct = boundedText(value.gateAct, GATE_ACT_MAX, { required: false });
-  if (gateAct === null) return undefined;
-  const extras = {
-    ...(schemaName ? { schemaName } : {}),
-    ...(artifacts ? { artifacts } : {}),
-    ...(currentArtifact ? { currentArtifact } : {}),
-    ...(value.awaitingValidation === true ? { awaitingValidation: true } : {}),
-    ...(focusAt !== undefined ? { focusAt } : {}),
-    ...(value.focusStale === true ? { focusStale: true } : {}),
-    ...(gateAct ? { gateAct } : {}),
+  if (artifactIdx === null) return undefined;
+  const task = boundedText(value.task, TASK_ID_MAX, { required: false });
+  if (task === null) return undefined;
+  const nextStep = boundedText(value.nextStep, NOTICE_MAX, { required: false });
+  if (nextStep === null) return undefined;
+  return {
+    change,
+    ...(artifactName ? { artifactName } : {}),
+    ...(artifactIdx ? { artifactIdx } : {}),
+    ...(task ? { task } : {}),
+    ...(nextStep ? { nextStep } : {}),
   };
-  return task === undefined ? { change, ...extras } : { change, task, ...extras };
 }
 
 function parseTitleWaiver(value: unknown): DeckTitleWaiverState | null | undefined {
@@ -271,87 +200,60 @@ export function parseDeckTurnCost(value: unknown): DeckTurnCost | null {
 export type DeckWorkSegment = { text: string; color: string; bold?: boolean };
 
 /**
- * The Work label as colored segments — the truthful, de-duplicated tile
- * under the layout law (truthful-rendered-state 2026-11-10):
- * `<slug> › <artifact> <done/total> › gate: <act> › 󰄱 <items>` — the
- * slug leads because openspec identity renders exclusively on the right
- * (the left band is Human-owned title), then current artifact + artifact
- * progress, the gate's relayed act dim in the optional slot, and the
- * current artifact's file-truth item count. Attention is derived, never authored:
- * `⏸ awaiting you` (warning) replaces the whole tile; a stale focus fact
- * (`⚠ focus <age> old`, dim, humanized at render time) replaces the artifact
- * group. Unknown facts drop their segments — absent items never render as
- * zeros. Compact width: the attention/progress side yields first, the item
- * count survives longest. Separators are chrome with hard deck-wide colors —
- * `›` accent like every minor separator.
+ * The Work label as colored segments — the render law (observe-room-aim
+ * 2026-11-11), the room aim printed verbatim:
+ *
+ * `{change} ⟩ {artifact_name} {artifact-idx} › {task} ⟩ {next-step}`
+ *
+ * Read as-is, printed as-is: the deck is a printer, not a translator.
+ * No prefixes, no relabeling, no mapping into cockpit words. A missing
+ * field drops its segment and the separator that led it; absence never
+ * becomes zero. Compact width yields the dim `next-step` first —
+ * identity and progress survive longest. Separators are chrome with
+ * hard deck-wide colors — `›` accent like every minor separator.
  */
+/** The OpenSpec mark — nf-md file-document-outline. One constant: the
+ * glyph is a taste choice, the placement is law (both lines). */
+export const OPEN_SPEC_ICON = '󰈙';
+
 export function deckWorkSegments(
   work: DeckTitleWorkState,
-  now: number = Date.now(),
   compact = false,
 ): DeckWorkSegment[] {
-  if (work.awaitingValidation) {
-    return compact ? [] : [{ text: '⏸ awaiting you', color: 'warning' }];
-  }
-  // The slug leads the right side — openspec identity renders exclusively
-  // here (Human layout law 2026-11-10); the left band is Human-owned.
-  const segments: DeckWorkSegment[] = [
-    { text: work.change, color: 'success', bold: true },
-  ];
-  const stale = work.focusStale === true && work.focusAt !== undefined;
-  if (!compact) {
-    if (stale) {
-      segments.push({ text: ' › ', color: 'accent' });
-      segments.push({
-        text: `⚠ focus ${compactActivityAge(Math.max(0, now - (work.focusAt ?? 0)))} old`,
-        color: 'dim',
-      });
-    } else {
-      const artifacts = work.artifacts;
-      const current = work.currentArtifact;
-      if (artifacts && artifacts.length > 0 && current) {
-        const done = artifacts.filter((artifact) => artifact.done).length;
-        const currentItems = artifacts.find(
-          (artifact) => artifact.id === current,
-        )?.items;
-        const itemsSettled =
-          currentItems === undefined ||
-          currentItems.total === 0 ||
-          currentItems.done >= currentItems.total;
-        // One hue per state: success only when the artifacts are done AND
-        // the current artifact's items are settled — otherwise work is open.
-        const complete = done === artifacts.length && itemsSettled;
-        segments.push(
-          { text: ' › ', color: 'accent' },
-          {
-            text: `${current} ${done}/${artifacts.length}`,
-            color: complete ? 'success' : 'accent',
-          },
-        );
-      }
-    }
-    // The {optional} slot: the gate's relayed act — dim commentary that
-    // yields first on narrow frames.
-    if (work.gateAct) {
-      segments.push(
-        { text: ' › ', color: 'accent' },
-        { text: `gate: ${work.gateAct}`, color: 'dim' },
-      );
+  // Human amendment (reorder-deck-frame, 2026-11-11): the slug moved to
+  // the engine row — the focus spec's home. Line 2 carries the progress
+  // fields and the dim action hint:
+  // `{icon} {artifact_name} {artifact-idx} › {task} ⟩ {next-step}` — read
+  // as-is, printed as-is; the icon leads the first rendered segment; the
+  // dim hint yields first on narrow frames.
+  const segments: DeckWorkSegment[] = [];
+  let iconPending = true;
+  const lead = (segment: DeckWorkSegment): void => {
+    if (iconPending) {
+      iconPending = false;
+      segments.push({ ...segment, text: `${OPEN_SPEC_ICON} ${segment.text}` });
+      return;
     }
+    segments.push(segment);
+  };
+  if (work.artifactName) {
+    lead({
+      text: work.artifactIdx
+        ? `${work.artifactName} ${work.artifactIdx}`
+        : work.artifactName,
+      color: 'accent',
+    });
   }
-  const items = work.currentArtifact
-    ? work.artifacts?.find((artifact) => artifact.id === work.currentArtifact)?.items
-    : undefined;
-  if (items && items.total > 0) {
-    const complete = items.done >= items.total;
+  if (work.task) {
+    // A separator only follows a segment — a leading one dangles.
     if (segments.length > 0) {
       segments.push({ text: ' › ', color: 'accent' });
     }
-    segments.push({
-      text: `${complete ? '✔' : '󰄱'} ${items.done}/${items.total}`,
-      color: complete ? 'success' : 'accent',
-      ...(complete ? { bold: true } : {}),
-    });
+    lead({ text: work.task, color: 'accent' });
+  }
+  if (work.nextStep && !compact) {
+    if (segments.length > 0) segments.push({ text: ' ⟩ ', color: 'accent' });
+    lead({ text: work.nextStep, color: 'dim' });
   }
   return segments;
 }