specsmd 0.1.33 → 0.1.35

package/lib/dashboard/tui/app.js

@@ -689,15 +689,70 @@ function buildOverviewProjectLines(snapshot, width, flow) {
   return buildFireOverviewProjectLines(snapshot, width);
 }
 
-function buildOverviewIntentLines(snapshot, width, flow) {
+function listOverviewIntentEntries(snapshot, flow) {
   const effectiveFlow = getEffectiveFlow(flow, snapshot);
   if (effectiveFlow === 'aidlc') {
-    return buildAidlcOverviewIntentLines(snapshot, width);
+    const intents = Array.isArray(snapshot?.intents) ? snapshot.intents : [];
+    return intents.map((intent) => ({
+      id: intent?.id || 'unknown',
+      status: intent?.status || 'pending',
+      line: `${intent?.id || 'unknown'}: ${intent?.status || 'pending'} (${intent?.completedStories || 0}/${intent?.storyCount || 0} stories, ${intent?.completedUnits || 0}/${intent?.unitCount || 0} units)`
+    }));
   }
   if (effectiveFlow === 'simple') {
-    return buildSimpleOverviewIntentLines(snapshot, width);
+    const specs = Array.isArray(snapshot?.specs) ? snapshot.specs : [];
+    return specs.map((spec) => ({
+      id: spec?.name || 'unknown',
+      status: spec?.state || 'pending',
+      line: `${spec?.name || 'unknown'}: ${spec?.state || 'pending'} (${spec?.tasksCompleted || 0}/${spec?.tasksTotal || 0} tasks)`
+    }));
   }
-  return buildFireOverviewIntentLines(snapshot, width);
+  const intents = Array.isArray(snapshot?.intents) ? snapshot.intents : [];
+  return intents.map((intent) => {
+    const workItems = Array.isArray(intent?.workItems) ? intent.workItems : [];
+    const done = workItems.filter((item) => item.status === 'completed').length;
+    return {
+      id: intent?.id || 'unknown',
+      status: intent?.status || 'pending',
+      line: `${intent?.id || 'unknown'}: ${intent?.status || 'pending'} (${done}/${workItems.length} work items)`
+    };
+  });
+}
+
+function buildOverviewIntentLines(snapshot, width, flow, filter = 'next') {
+  const entries = listOverviewIntentEntries(snapshot, flow);
+  const normalizedFilter = filter === 'completed' ? 'completed' : 'next';
+  const isNextFilter = normalizedFilter === 'next';
+  const nextLabel = isNextFilter ? '[NEXT]' : ' next ';
+  const completedLabel = !isNextFilter ? '[COMPLETED]' : ' completed ';
+
+  const filtered = entries.filter((entry) => {
+    if (normalizedFilter === 'completed') {
+      return entry.status === 'completed';
+    }
+    return entry.status !== 'completed';
+  });
+
+  const lines = [{
+    text: truncate(`filter ${nextLabel} | ${completedLabel}  (←/→ or n/x)`, width),
+    color: 'cyan',
+    bold: true
+  }];
+
+  if (filtered.length === 0) {
+    lines.push({
+      text: truncate(
+        normalizedFilter === 'completed' ? 'No completed intents yet' : 'No upcoming intents',
+        width
+      ),
+      color: 'gray',
+      bold: false
+    });
+    return lines;
+  }
+
+  lines.push(...filtered.map((entry) => truncate(entry.line, width)));
+  return lines;
 }
 
 function buildOverviewStandardsLines(snapshot, width, flow) {
@@ -739,12 +794,12 @@ function getPanelTitles(flow, snapshot) {
 
 function getSectionOrderForView(view) {
   if (view === 'overview') {
-    return ['project', 'intent-status', 'standards'];
+    return ['intent-status', 'completed-runs', 'standards', 'project'];
   }
   if (view === 'health') {
     return ['stats', 'warnings', 'error-details'];
   }
-  return ['current-run', 'run-files', 'pending', 'completed'];
+  return ['current-run', 'run-files', 'pending'];
 }
 
 function cycleSection(view, currentSectionKey, direction = 1, availableSections = null) {
@@ -1342,6 +1397,81 @@ function openFileWithDefaultApp(filePath) {
   };
 }
 
+function buildQuickHelpText(view, options = {}) {
+  const {
+    previewOpen = false,
+    availableFlowCount = 1
+  } = options;
+
+  const parts = ['1/2/3 views', 'g/G sections'];
+
+  if (view === 'runs') {
+    if (previewOpen) {
+      parts.push('tab pane', '↑/↓ nav/scroll', 'v close');
+    } else {
+      parts.push('↑/↓ navigate', 'enter expand', 'v preview');
+    }
+  }
+
+  if (availableFlowCount > 1) {
+    parts.push('[/] flow');
+  }
+
+  parts.push('r refresh', '? shortcuts', 'q quit');
+  return parts.join(' | ');
+}
+
+function buildHelpOverlayLines(options = {}) {
+  const {
+    view = 'runs',
+    previewOpen = false,
+    paneFocus = 'main',
+    availableFlowCount = 1,
+    showErrorSection = false
+  } = options;
+
+  const lines = [
+    { text: 'Global', color: 'cyan', bold: true },
+    'q or Ctrl+C quit',
+    'r refresh snapshot',
+    '1 runs | 2 overview | 3 health',
+    'g next section | G previous section',
+    'h/? toggle this shortcuts overlay',
+    'esc close overlays (help/preview/fullscreen)',
+    { text: '', color: undefined, bold: false },
+    { text: 'Runs View', color: 'yellow', bold: true },
+    'a current | f files | p pending',
+    'up/down or j/k move selection',
+    'enter expand/collapse pending/completed groups',
+    'v preview selected file',
+    'v twice quickly opens fullscreen preview overlay',
+    'tab switch focus between main and preview panes',
+    'o open selected file in system default app'
+  ];
+
+  if (previewOpen) {
+    lines.push(`preview is open (focus: ${paneFocus})`);
+  }
+
+  if (availableFlowCount > 1) {
+    lines.push('[/] (and m) switch flow');
+  }
+
+  lines.push(
+    { text: '', color: undefined, bold: false },
+    { text: 'Overview View', color: 'green', bold: true },
+    'i intents | c completed | s standards | p project',
+    'when Intents is focused: n next | x completed | left/right toggle filter',
+    { text: '', color: undefined, bold: false },
+    { text: 'Health View', color: 'magenta', bold: true },
+    `t stats | w warnings${showErrorSection ? ' | e errors' : ''}`,
+    { text: '', color: undefined, bold: false },
+    { text: `Current view: ${String(view || 'runs').toUpperCase()}`, color: 'gray', bold: false }
+  );
+
+  return lines;
+}
+
 function colorizeMarkdownLine(line, inCodeBlock) {
   const text = String(line ?? '');
 
@@ -1638,6 +1768,7 @@ function createDashboardApp(deps) {
     });
     const [expandedGroups, setExpandedGroups] = useState({});
     const [previewTarget, setPreviewTarget] = useState(null);
+    const [overviewIntentFilter, setOverviewIntentFilter] = useState('next');
     const [previewOpen, setPreviewOpen] = useState(false);
     const [paneFocus, setPaneFocus] = useState('main');
     const [overlayPreviewOpen, setOverlayPreviewOpen] = useState(false);
@@ -1767,6 +1898,15 @@ function createDashboardApp(deps) {
         return;
       }
 
+      if (key.escape && ui.showHelp) {
+        setUi((previous) => ({ ...previous, showHelp: false }));
+        return;
+      }
+
+      if (ui.showHelp) {
+        return;
+      }
+
       if (input === '1') {
         setUi((previous) => ({ ...previous, view: 'runs' }));
         setPaneFocus('main');
@@ -1807,6 +1947,7 @@ function createDashboardApp(deps) {
           overview: 'project',
           health: 'stats'
         });
+        setOverviewIntentFilter('next');
         setExpandedGroups({});
         setPreviewTarget(null);
         setPreviewOpen(false);
@@ -1838,6 +1979,7 @@ function createDashboardApp(deps) {
           overview: 'project',
           health: 'stats'
         });
+        setOverviewIntentFilter('next');
         setExpandedGroups({});
         setPreviewTarget(null);
         setPreviewOpen(false);
@@ -1857,7 +1999,22 @@ function createDashboardApp(deps) {
         return;
       }
 
-      if (key.rightArrow || input === 'g') {
+      if (ui.view === 'overview' && activeSection === 'intent-status') {
+        if (input === 'n') {
+          setOverviewIntentFilter('next');
+          return;
+        }
+        if (input === 'x') {
+          setOverviewIntentFilter('completed');
+          return;
+        }
+        if (key.rightArrow || key.leftArrow) {
+          setOverviewIntentFilter((previous) => (previous === 'completed' ? 'next' : 'completed'));
+          return;
+        }
+      }
+
+      if (input === 'g' || key.rightArrow) {
         setSectionFocus((previous) => ({
           ...previous,
           [ui.view]: cycleSection(ui.view, activeSection, 1, availableSections)
@@ -1866,7 +2023,7 @@ function createDashboardApp(deps) {
         return;
       }
 
-      if (key.leftArrow || input === 'G') {
+      if (input === 'G' || key.leftArrow) {
         setSectionFocus((previous) => ({
           ...previous,
           [ui.view]: cycleSection(ui.view, activeSection, -1, availableSections)
@@ -1891,11 +2048,6 @@ function createDashboardApp(deps) {
           setPaneFocus('main');
           return;
         }
-        if (input === 'c') {
-          setSectionFocus((previous) => ({ ...previous, runs: 'completed' }));
-          setPaneFocus('main');
-          return;
-        }
       } else if (ui.view === 'overview') {
         if (input === 'p') {
           setSectionFocus((previous) => ({ ...previous, overview: 'project' }));
@@ -1909,6 +2061,10 @@ function createDashboardApp(deps) {
           setSectionFocus((previous) => ({ ...previous, overview: 'standards' }));
           return;
         }
+        if (input === 'c') {
+          setSectionFocus((previous) => ({ ...previous, overview: 'completed-runs' }));
+          return;
+        }
       } else if (ui.view === 'health') {
         if (input === 't') {
           setSectionFocus((previous) => ({ ...previous, health: 'stats' }));
@@ -2168,16 +2324,16 @@ function createDashboardApp(deps) {
     const rows = Number.isFinite(terminalSize.rows) ? terminalSize.rows : (process.stdout.rows || 40);
 
     const fullWidth = Math.max(40, cols - 1);
-    const showHelpLine = ui.showHelp && rows >= 14;
+    const showFooterHelpLine = rows >= 10;
     const showErrorPanel = Boolean(error) && rows >= 18;
     const showErrorInline = Boolean(error) && !showErrorPanel;
     const densePanels = rows <= 28 || cols <= 120;
 
-    const reservedRows = 2 + (showHelpLine ? 1 : 0) + (showErrorPanel ? 5 : 0) + (showErrorInline ? 1 : 0);
+    const reservedRows = 2 + (showFooterHelpLine ? 1 : 0) + (showErrorPanel ? 5 : 0) + (showErrorInline ? 1 : 0);
     const contentRowsBudget = Math.max(4, rows - reservedRows);
     const ultraCompact = rows <= 14;
     const panelTitles = getPanelTitles(activeFlow, snapshot);
-    const splitPreviewLayout = ui.view === 'runs' && previewOpen && !overlayPreviewOpen && cols >= 110 && rows >= 16;
+    const splitPreviewLayout = ui.view === 'runs' && previewOpen && !overlayPreviewOpen && !ui.showHelp && cols >= 110 && rows >= 16;
     const mainPaneWidth = splitPreviewLayout
       ? Math.max(34, Math.floor((fullWidth - 1) * 0.52))
       : fullWidth;
@@ -2201,13 +2357,6 @@ function createDashboardApp(deps) {
       mainCompactWidth,
       ui.view === 'runs' && focusedSection === 'pending' && paneFocus === 'main'
     );
-    const completedLines = buildInteractiveRowsLines(
-      completedRows,
-      selectionBySection.completed || 0,
-      icons,
-      mainCompactWidth,
-      ui.view === 'runs' && focusedSection === 'completed' && paneFocus === 'main'
-    );
     const effectivePreviewTarget = previewTarget || selectedFocusedFile;
     const previewLines = previewOpen
       ? buildPreviewLines(effectivePreviewTarget, previewCompactWidth, previewScroll, {
@@ -2215,8 +2364,30 @@ function createDashboardApp(deps) {
       })
       : [];
 
+    const shortcutsOverlayLines = buildHelpOverlayLines({
+      view: ui.view,
+      previewOpen,
+      paneFocus,
+      availableFlowCount: availableFlowIds.length,
+      showErrorSection: showErrorPanel
+    });
+    const quickHelpText = buildQuickHelpText(ui.view, {
+      previewOpen,
+      paneFocus,
+      availableFlowCount: availableFlowIds.length
+    });
+
     let panelCandidates;
-    if (ui.view === 'runs' && previewOpen && overlayPreviewOpen) {
+    if (ui.showHelp) {
+      panelCandidates = [
+        {
+          key: 'shortcuts-overlay',
+          title: 'Keyboard Shortcuts',
+          lines: shortcutsOverlayLines,
+          borderColor: 'cyan'
+        }
+      ];
+    } else if (ui.view === 'runs' && previewOpen && overlayPreviewOpen) {
       panelCandidates = [
         {
           key: 'preview-overlay',
@@ -2227,23 +2398,29 @@ function createDashboardApp(deps) {
       ];
     } else if (ui.view === 'overview') {
       panelCandidates = [
-        {
-          key: 'project',
-          title: 'Project + Workspace',
-          lines: buildOverviewProjectLines(snapshot, mainCompactWidth, activeFlow),
-          borderColor: 'green'
-        },
         {
           key: 'intent-status',
-          title: 'Intent Status',
-          lines: buildOverviewIntentLines(snapshot, mainCompactWidth, activeFlow),
+          title: 'Intents',
+          lines: buildOverviewIntentLines(snapshot, mainCompactWidth, activeFlow, overviewIntentFilter),
           borderColor: 'yellow'
         },
+        {
+          key: 'completed-runs',
+          title: panelTitles.completed,
+          lines: buildCompletedLines(snapshot, mainCompactWidth, activeFlow),
+          borderColor: 'blue'
+        },
         {
           key: 'standards',
           title: 'Standards',
           lines: buildOverviewStandardsLines(snapshot, mainCompactWidth, activeFlow),
           borderColor: 'blue'
+        },
+        {
+          key: 'project',
+          title: 'Project + Workspace',
+          lines: buildOverviewProjectLines(snapshot, mainCompactWidth, activeFlow),
+          borderColor: 'green'
         }
       ];
     } else if (ui.view === 'health') {
@@ -2298,12 +2475,6 @@ function createDashboardApp(deps) {
           title: panelTitles.pending,
           lines: pendingLines,
           borderColor: 'yellow'
-        },
-        {
-          key: 'completed',
-          title: panelTitles.completed,
-          lines: completedLines,
-          borderColor: 'blue'
         }
       ];
     }
@@ -2317,16 +2488,6 @@ function createDashboardApp(deps) {
     }
 
     const panels = allocateSingleColumnPanels(panelCandidates, contentRowsBudget);
-    const flowSwitchHint = availableFlowIds.length > 1 ? ' | [ or ] switch flow' : '';
-    const sectionHint = ui.view === 'runs'
-      ? ' | a active | f files | p pending | c done'
-      : (ui.view === 'overview' ? ' | p project | i intents | s standards' : ' | t stats | w warnings | e errors');
-    const previewHint = ui.view === 'runs'
-      ? (previewOpen
-        ? ` | tab ${paneFocus === 'preview' ? 'main' : 'preview'} | ↑/↓ ${paneFocus === 'preview' ? 'scroll' : 'navigate'} | v close | vv fullscreen`
-        : ' | ↑/↓ navigate | enter expand | v preview | vv fullscreen | o open')
-      : '';
-    const helpText = `q quit | r refresh | h/? help | 1 runs | 2 overview | 3 health | g/G section${sectionHint}${previewHint}${flowSwitchHint}`;
 
     const renderPanel = (panel, index, width, isFocused) => React.createElement(SectionPanel, {
       key: panel.key,
@@ -2390,9 +2551,11 @@ function createDashboardApp(deps) {
         panel,
         index,
         fullWidth,
-        (panel.key === 'preview' || panel.key === 'preview-overlay')
+        ui.showHelp
+          ? true
+          : ((panel.key === 'preview' || panel.key === 'preview-overlay')
           ? paneFocus === 'preview'
-          : (paneFocus === 'main' && panel.key === focusedSection)
+          : (paneFocus === 'main' && panel.key === focusedSection))
       ));
     }
 
@@ -2421,8 +2584,8 @@ function createDashboardApp(deps) {
       statusLine !== ''
         ? React.createElement(Text, { color: 'yellow' }, truncate(statusLine, fullWidth))
         : null,
-      showHelpLine
-        ? React.createElement(Text, { color: 'gray' }, truncate(helpText, fullWidth))
+      showFooterHelpLine
+        ? React.createElement(Text, { color: 'gray' }, truncate(quickHelpText, fullWidth))
         : null
     );
   }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.1.33",
+  "version": "0.1.35",
   "description": "Multi-agent orchestration system for AI-native software development. Delivers AI-DLC, Agile, and custom SDLC flows as markdown-based agent systems.",
   "main": "lib/installer.js",
   "bin": {