@joewinke/jatui 0.24.0 → 0.25.0

package/dist/components/session-nav/transcriptModel.d.ts

@@ -34,6 +34,8 @@ export interface TranscriptItem {
     srcLines: number;
     /** id of the signal node that owns this item (assigned after parse) */
     signalId: string | null;
+    /** ISO write time of the first source message (null on line-parsed/live items) */
+    timestamp?: string | null;
 }
 export interface FileTouchedEntry {
     path: string;
@@ -65,11 +67,46 @@ export interface SignalNode {
     /** Net lines changed across all diffs for this block */
     linesAdded: number;
     linesRemoved: number;
+    /**
+     * Original signal JSON payload (full data for rich card rendering). Always
+     * set by the builders below; optional so SignalNodes constructed by hand
+     * (pre-0.25 callers) still type-check.
+     */
+    payload?: Record<string, unknown> | null;
+    /**
+     * True when this node represents the OPEN, in-progress turn — either a
+     * server-marked open block (`WorkBlockClient.open === true`) or the
+     * synthesized live node owning the trailing items past the last block.
+     * SessionNavigator uses this to render a ● live affordance. Optional so
+     * existing SignalNode consumers are unaffected.
+     */
+    isLive?: boolean;
 }
 export interface LinkedSession {
     items: TranscriptItem[];
     signals: SignalNode[];
 }
+/** Tone drives the marker's hue; deliberately NOT a session-state key. */
+export type MarkerTone = 'success' | 'error' | 'warn' | 'neutral' | 'info';
+/** What a card detector declares when its event deserves a rail marker. */
+export interface TimelineMarkerSpec {
+    /** glyph shown on the rail — keep it non-emoji so state glyphs stay distinct */
+    glyph: string;
+    /** short rail label, e.g. "subtask completed" */
+    label: string;
+    /** longer text for the title/tooltip */
+    detail?: string;
+    tone: MarkerTone;
+}
+/** A content event promoted onto the signal timeline, anchored to its row. */
+export interface TimelineMarker extends TimelineMarkerSpec {
+    /** rail id — "mrk-<itemId>" */
+    id: string;
+    /** transcript item this marker anchors to (its `[data-row]`) */
+    itemId: number;
+    /** signal owning that item — clicking a marker inks this signal's ribbon */
+    signalId: string | null;
+}
 export declare function rawTypeToState(raw: string): string;
 /** Build the linked model from rendered transcript lines. */
 export declare function buildLinkedSession(lines: string[]): LinkedSession;
@@ -99,6 +136,14 @@ export interface WorkBlockClient {
     }>;
     linesAdded?: number;
     linesRemoved?: number;
+    /**
+     * True when the server marks this block as the OPEN in-progress turn
+     * (populated by the navigator/sessionWork layer — sibling task jat-difet).
+     * Read defensively: may be undefined on blocks from older payloads. When
+     * true on the last block, that block's node becomes the live node (it
+     * absorbs any trailing items instead of synthesizing a separate one).
+     */
+    open?: boolean;
 }
 export interface WorkTranscriptItemClient {
     id: number;
@@ -107,6 +152,7 @@ export interface WorkTranscriptItemClient {
     detail: string[];
     srcLines: number;
     blockId: string | null;
+    timestamp?: string | null;
 }
 /**
  * Build a LinkedSession from the WorkBlock substrate (B1).

package/dist/components/session-nav/transcriptModel.js

@@ -41,10 +41,36 @@ function parseSignalBody(body) {
     if (!m)
         return null;
     let label = '';
-    const pick = body.match(/"(?:approach|question|reviewFocus|currentStep|summary|reason|taskTitle)"\s*:\s*"([^"]{3,90})/);
-    if (pick)
-        label = pick[1];
-    return { rawType: m[1], label };
+    let payload = null;
+    // Try to extract and parse the JSON payload from the signal call
+    const jsonMatch = body.match(/jat-signal\s+\w+\s+'(\{[\s\S]*?\})'\s*$/) ||
+        body.match(/jat-signal\s+\w+\s+"(\{[\s\S]*?\})"\s*$/) ||
+        body.match(/jat-signal\s+\w+\s+(\{[\s\S]*?\})\s*$/);
+    if (jsonMatch) {
+        try {
+            payload = JSON.parse(jsonMatch[1]);
+        }
+        catch {
+            // ignore parse errors — payload stays null
+        }
+    }
+    if (payload) {
+        // Extract label from full payload
+        const p = payload;
+        const candidate = (Array.isArray(p.summary) ? p.summary[0] : undefined) ??
+            (typeof p.approach === 'string' ? p.approach : undefined) ??
+            (typeof p.taskTitle === 'string' ? p.taskTitle : undefined) ??
+            (typeof p.question === 'string' ? p.question : undefined) ??
+            (typeof p.currentStep === 'string' ? p.currentStep : undefined);
+        if (candidate)
+            label = candidate.slice(0, 90);
+    }
+    else {
+        const pick = body.match(/"(?:approach|question|reviewFocus|currentStep|summary|reason|taskTitle)"\s*:\s*"([^"]{3,90})/);
+        if (pick)
+            label = pick[1];
+    }
+    return { rawType: m[1], label, payload };
 }
 /** Build the linked model from rendered transcript lines. */
 export function buildLinkedSession(lines) {
@@ -64,7 +90,14 @@ export function buildLinkedSession(lines) {
         } // blank ends a block
         if (line.startsWith('› ')) {
             flush();
-            cur = { kind: 'prompt', headline: line.slice(2), detail: [], srcLines: 1 };
+            const headline = line.slice(2);
+            // Claude Code's TUI draws a blank "› " input box while idle between
+            // turns; a capture that lands mid-frame leaks that empty prompt line
+            // into the transcript. Treat it like a blank line (below) rather than
+            // a zero-content prompt item — it never carries real content.
+            if (!headline.trim())
+                continue;
+            cur = { kind: 'prompt', headline, detail: [], srcLines: 1 };
             continue;
         }
         if (line.startsWith('⏺ ')) {
@@ -73,7 +106,7 @@ export function buildLinkedSession(lines) {
             if (sig) {
                 // signal emission = boundary; consume it, don't render as an item
                 flush();
-                emits.push({ afterIdx: items.length - 1, rawType: sig.rawType, label: sig.label });
+                emits.push({ afterIdx: items.length - 1, rawType: sig.rawType, label: sig.label, payload: sig.payload });
                 continue;
             }
             flush();
@@ -113,13 +146,33 @@ export function buildLinkedSession(lines) {
     }
     flush();
     // Build signal nodes from emission boundaries.
+    // Ownership is FORWARD: each signal owns the items that come AFTER it, up to
+    // (but not including) the next signal's emission point. The first signal also
+    // absorbs any preamble items that appear before it.
+    //
+    // Let B[i] = emits[i].afterIdx = last item index before signal[i].
+    //
+    // Partition (non-overlapping):
+    //   sig[0]    → [0 .. B[1]]           preamble + first forward region
+    //   sig[i>0]  → [B[i]+1 .. B[i+1]]   region after sig[i], before sig[i+1]
+    //   sig[last] → [B[last]+1 .. N-1]    region after last signal
+    //
+    // This ensures output printed AFTER a signal emission (e.g. the READY FOR
+    // REVIEW banner after `jat-signal review`) is attributed to that signal, not
+    // the subsequent one.
     const signals = [];
-    let prevBoundary = -1;
+    const N = items.length;
     emits.forEach((e, i) => {
-        const rowStart = Math.max(0, prevBoundary + 1);
-        const rowEnd = Math.max(rowStart, e.afterIdx);
+        // rowStart: first signal starts at 0 (absorbs preamble items before it);
+        // later signals start at the item immediately after this signal's emission.
+        const rowStart = i === 0 ? 0 : e.afterIdx + 1;
+        // naturalEnd: extends to the next signal's pre-boundary, or to the last item.
+        const naturalEnd = i + 1 < emits.length ? emits[i + 1].afterIdx : N - 1;
+        // rowEnd: capped at N-1 (never out of bounds); may be < rowStart when this
+        // signal has no items after it (e.g. last line is the signal itself).
+        const rowEnd = Math.min(naturalEnd, N - 1);
         let lineCount = 0;
-        for (let k = rowStart; k <= rowEnd && k < items.length; k++)
+        for (let k = rowStart; k <= rowEnd && k < N; k++)
             lineCount += items[k].srcLines;
         signals.push({
             id: `sig-${i}`,
@@ -135,9 +188,9 @@ export function buildLinkedSession(lines) {
             filesTouched: [],
             commits: [],
             linesAdded: 0,
-            linesRemoved: 0
+            linesRemoved: 0,
+            payload: e.payload
         });
-        prevBoundary = e.afterIdx;
     });
     for (const sig of signals) {
         for (let k = sig.rowStart; k <= sig.rowEnd && k < items.length; k++) {
@@ -168,9 +221,11 @@ export function buildLinkedSessionFromWork(blocks, items) {
         headline: it.headline,
         detail: it.detail,
         srcLines: it.srcLines,
-        signalId: null // filled in below
+        signalId: null, // filled in below
+        timestamp: it.timestamp ?? null
     }));
-    // Map WorkBlock → SignalNode
+    // Map WorkBlock → SignalNode. `isLive` is seeded from the server's open flag
+    // (read defensively — jat-difet adds it; may be undefined on older payloads).
     const signals = blocks.map((blk) => ({
         id: blk.id,
         state: rawTypeToState(blk.signal.type),
@@ -185,11 +240,80 @@ export function buildLinkedSessionFromWork(blocks, items) {
         filesTouched: blk.filesTouched,
         commits: blk.commits ?? [],
         linesAdded: blk.linesAdded ?? 0,
-        linesRemoved: blk.linesRemoved ?? 0
+        linesRemoved: blk.linesRemoved ?? 0,
+        payload: blk.signal.payload,
+        isLive: blk.open === true
     }));
-    // Assign signalId to transcript items via block ownership
+    const N = transcriptItems.length;
+    // Helper: synthesize the live node owning the open in-progress turn.
+    const makeLiveNode = (start, end, label) => {
+        let lineCount = 0;
+        for (let k = start; k <= end && k < N; k++)
+            lineCount += transcriptItems[k].srcLines;
+        return {
+            id: 'sig-live',
+            state: rawTypeToState('working'),
+            rawType: 'working',
+            label,
+            rowStart: start,
+            rowEnd: end,
+            lineCount: Math.max(1, lineCount),
+            blockId: null,
+            summary: null,
+            filesTouched: [],
+            commits: [],
+            linesAdded: 0,
+            linesRemoved: 0,
+            payload: null,
+            isLive: true
+        };
+    };
+    if (N > 0) {
+        if (signals.length === 0) {
+            // No blocks but live items exist → the whole transcript is the open
+            // turn. Give it a single live node so nothing is left unsignaled.
+            signals.push(makeLiveNode(0, N - 1, 'current'));
+        }
+        else {
+            // (#1 gap-fill) Guarantee a contiguous [0..N-1] partition so EVERY
+            // item ends up owning a signal:
+            //  (a) first signal absorbs any preamble before its range
+            signals[0].rowStart = 0;
+            //  (b) extend each signal's rowEnd to close the gap before the next
+            //      signal's range (no-op when ranges already touch/overlap)
+            for (let i = 0; i < signals.length - 1; i++) {
+                const nextStart = signals[i + 1].rowStart;
+                if (signals[i].rowEnd < nextStart - 1) {
+                    signals[i].rowEnd = nextStart - 1;
+                }
+            }
+            // (#2 live node) Trailing items past the last block's range are the
+            // OPEN in-progress turn — they must NOT be folded into the previous
+            // signal (e.g. a 'review'). Honor a server-marked open block first;
+            // otherwise synthesize a dedicated live node.
+            const lastSig = signals[signals.length - 1];
+            const lastBlockEnd = lastSig.rowEnd;
+            if (lastSig.isLive) {
+                // Server already marked the last block open → IT is the live node;
+                // extend it to absorb any trailing items.
+                lastSig.rowEnd = N - 1;
+            }
+            else if (lastBlockEnd < N - 1) {
+                // Synthesize a live node owning [lastBlockEnd+1 .. N-1]. Label from
+                // the live task title when available, else a neutral 'current'.
+                const p = lastSig.payload;
+                const title = p && typeof p.taskTitle === 'string' ? p.taskTitle.slice(0, 90) : null;
+                signals.push(makeLiveNode(lastBlockEnd + 1, N - 1, title ?? 'current'));
+            }
+            // else: the last block already reaches N-1 — nothing trailing.
+        }
+    }
+    // Assign signalId to transcript items via (gap-filled) ownership ranges.
+    // Clamp to bounds; later signals (incl. the live node) win on any overlap.
     for (const sig of signals) {
-        for (let k = sig.rowStart; k <= sig.rowEnd && k < transcriptItems.length; k++) {
+        const start = Math.max(0, sig.rowStart);
+        const end = Math.min(sig.rowEnd, N - 1);
+        for (let k = start; k <= end; k++) {
             transcriptItems[k].signalId = sig.id;
         }
     }
@@ -202,7 +326,7 @@ export function buildLinkedSessionFromWork(blocks, items) {
  */
 export const SAMPLE_TRANSCRIPT_LINES = [
     '',
-    '› /jat:start GentleCoast jat-7h2k',
+    '› /jat-start GentleCoast jat-7h2k',
     '⏺ Bash(get-current-session-id)',
     '  ⎿ 4f9c1a2e-7b3d-4c8a-9e1f-2a6b8c0d4e5f',
     '⏺ Bash(jat-signal starting \'{"agentName":"GentleCoast","taskTitle":"Add password reset flow"}\')',
@@ -256,7 +380,7 @@ export const SAMPLE_TRANSCRIPT_LINES = [
     '',
     '🔍 READY FOR REVIEW: jat-7h2k — password reset flow implemented, tested, rate-limited.',
     '',
-    '› /jat:complete',
+    '› /jat-complete',
     '⏺ Bash(jat-step committing --task jat-7h2k)',
     '  ⎿ Committed: feat(jat-7h2k): add password reset flow',
     '⏺ Bash(jat-signal complete \'{"taskId":"jat-7h2k","summary":"Shipped password reset flow"}\')',

package/dist/index.d.ts

@@ -25,7 +25,7 @@ export { default as Flythrough } from './components/Flythrough.svelte';
 export { default as LessonEmbed } from './components/LessonEmbed.svelte';
 export type { Collection, CollectionCut, CollectionBeat, } from './components/LessonEmbed.svelte';
 export { buildLinkedSession, buildLinkedSessionFromWork, rawTypeToState, sampleLinkedSession, SAMPLE_TRANSCRIPT_LINES, } from './components/session-nav/transcriptModel';
-export type { ItemKind, TranscriptItem, FileTouchedEntry, SignalNode, LinkedSession, WorkBlockClient, WorkTranscriptItemClient, } from './components/session-nav/transcriptModel';
+export type { ItemKind, TranscriptItem, FileTouchedEntry, SignalNode, LinkedSession, WorkBlockClient, WorkTranscriptItemClient, MarkerTone, TimelineMarkerSpec, TimelineMarker, } from './components/session-nav/transcriptModel';
 export { default as UserAvatar } from './components/UserAvatar.svelte';
 export { default as SidebarUserFooter } from './components/SidebarUserFooter.svelte';
 export { default as TaskTypeIcon } from './components/TaskTypeIcon.svelte';

package/dist/index.js

@@ -44,7 +44,8 @@ export { qrMatrix, qrCanvas } from './video/advisors/qr';
 // LessonEmbed renders a demo-assemble collection.json (cut picker + player).
 export { default as Flythrough } from './components/Flythrough.svelte';
 export { default as LessonEmbed } from './components/LessonEmbed.svelte';
-// Data models — Session transcript (from JAT IDE, jat-jj79f.16 G1)
+// Data models — Session transcript (from JAT IDE, jat-jj79f.16 G1; resynced
+// with the IDE's payload/timestamp/live-node/F13-marker model in jatui-ucmkz)
 export { buildLinkedSession, buildLinkedSessionFromWork, rawTypeToState, sampleLinkedSession, SAMPLE_TRANSCRIPT_LINES, } from './components/session-nav/transcriptModel';
 // Components — Universal
 export { default as UserAvatar } from './components/UserAvatar.svelte';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@joewinke/jatui",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "private": false,
   "description": "Shared Svelte 5 component library for JAT projects",
   "type": "module",