specsmd 0.1.39 → 0.1.41

package/lib/dashboard/index.js

@@ -172,12 +172,19 @@ async function runFlowDashboard(options, flow, availableFlows = []) {
   }
 
   const ink = await import('ink');
+  let inkUi = null;
+  try {
+    inkUi = await import('@inkjs/ui');
+  } catch {
+    inkUi = null;
+  }
   const reactNamespace = await import('react');
   const React = reactNamespace.default || reactNamespace;
 
   const App = createDashboardApp({
     React,
     ink,
+    inkUi,
     parseSnapshotForFlow,
     workspacePath,
     flow,

package/lib/dashboard/tui/app.js

@@ -124,7 +124,8 @@ function normalizePanelLine(line) {
       text: typeof line.text === 'string' ? line.text : String(line.text ?? ''),
       color: line.color,
       bold: Boolean(line.bold),
-      selected: Boolean(line.selected)
+      selected: Boolean(line.selected),
+      loading: Boolean(line.loading)
     };
   }
 
@@ -132,7 +133,8 @@ function normalizePanelLine(line) {
     text: String(line ?? ''),
     color: undefined,
     bold: false,
-    selected: false
+    selected: false,
+    loading: false
   };
 }
 
@@ -879,6 +881,30 @@ function pushFileEntry(entries, seenPaths, candidate) {
   });
 }
 
+function buildIntentScopedLabel(snapshot, intentId, filePath, fallbackName = 'file.md') {
+  const safeIntentId = typeof intentId === 'string' && intentId.trim() !== ''
+    ? intentId
+    : '';
+  const safeFallback = typeof fallbackName === 'string' && fallbackName.trim() !== ''
+    ? fallbackName
+    : 'file.md';
+
+  if (typeof filePath === 'string' && filePath.trim() !== '') {
+    if (safeIntentId && typeof snapshot?.rootPath === 'string' && snapshot.rootPath.trim() !== '') {
+      const intentPath = path.join(snapshot.rootPath, 'intents', safeIntentId);
+      const relativePath = path.relative(intentPath, filePath);
+      if (relativePath && !relativePath.startsWith('..') && !path.isAbsolute(relativePath)) {
+        return `${safeIntentId}/${relativePath.split(path.sep).join('/')}`;
+      }
+    }
+
+    const basename = path.basename(filePath);
+    return safeIntentId ? `${safeIntentId}/${basename}` : basename;
+  }
+
+  return safeIntentId ? `${safeIntentId}/${safeFallback}` : safeFallback;
+}
+
 function collectFireRunFiles(run) {
   if (!run || typeof run.folderPath !== 'string') {
     return [];
@@ -1021,14 +1047,24 @@ function getRunFileEntries(snapshot, flow, options = {}) {
   const pendingItems = Array.isArray(snapshot?.pendingItems) ? snapshot.pendingItems : [];
   for (const pendingItem of pendingItems) {
     pushFileEntry(entries, seenPaths, {
-      label: `${pendingItem?.intentId || 'intent'}/${pendingItem?.id || 'work-item'}.md`,
+      label: buildIntentScopedLabel(
+        snapshot,
+        pendingItem?.intentId,
+        pendingItem?.filePath,
+        `${pendingItem?.id || 'work-item'}.md`
+      ),
       path: pendingItem?.filePath,
       scope: 'upcoming'
     });
 
     if (pendingItem?.intentId) {
       pushFileEntry(entries, seenPaths, {
-        label: `${pendingItem.intentId}/brief.md`,
+        label: buildIntentScopedLabel(
+          snapshot,
+          pendingItem.intentId,
+          path.join(snapshot?.rootPath || '', 'intents', pendingItem.intentId, 'brief.md'),
+          'brief.md'
+        ),
         path: path.join(snapshot?.rootPath || '', 'intents', pendingItem.intentId, 'brief.md'),
         scope: 'intent'
       });
@@ -1047,7 +1083,12 @@ function getRunFileEntries(snapshot, flow, options = {}) {
     : [];
   for (const intent of completedIntents) {
     pushFileEntry(entries, seenPaths, {
-      label: `${intent.id}/brief.md`,
+      label: buildIntentScopedLabel(
+        snapshot,
+        intent?.id,
+        path.join(snapshot?.rootPath || '', 'intents', intent?.id || '', 'brief.md'),
+        'brief.md'
+      ),
       path: path.join(snapshot?.rootPath || '', 'intents', intent.id, 'brief.md'),
       scope: 'intent'
     });
@@ -1265,6 +1306,15 @@ function toInfoRows(lines, keyPrefix, emptyLabel = 'No data') {
   });
 }
 
+function toLoadingRows(label, keyPrefix = 'loading') {
+  return [{
+    kind: 'loading',
+    key: `${keyPrefix}:row`,
+    label: typeof label === 'string' && label !== '' ? label : 'Loading...',
+    selectable: false
+  }];
+}
+
 function buildOverviewIntentGroups(snapshot, flow, filter = 'next') {
   const effectiveFlow = getEffectiveFlow(flow, snapshot);
   const normalizedFilter = filter === 'completed' ? 'completed' : 'next';
@@ -1304,11 +1354,16 @@ function buildOverviewIntentGroups(snapshot, flow, filter = 'next') {
       const workItems = Array.isArray(intent?.workItems) ? intent.workItems : [];
       const done = workItems.filter((item) => item.status === 'completed').length;
       const files = [{
-        label: `${intent?.id || 'intent'}/brief.md`,
+        label: buildIntentScopedLabel(snapshot, intent?.id, intent?.filePath, 'brief.md'),
         path: intent?.filePath,
         scope: 'intent'
       }, ...workItems.map((item) => ({
-        label: `${intent?.id || 'intent'}/${item?.id || 'work-item'}.md`,
+        label: buildIntentScopedLabel(
+          snapshot,
+          intent?.id,
+          item?.filePath,
+          `${item?.id || 'work-item'}.md`
+        ),
         path: item?.filePath,
         scope: item?.status === 'completed' ? 'completed' : 'upcoming'
       }))];
@@ -1444,14 +1499,24 @@ function buildPendingGroups(snapshot, flow) {
 
     if (item?.filePath) {
       files.push({
-        label: `${item?.intentId || 'intent'}/${item?.id || 'work-item'}.md`,
+        label: buildIntentScopedLabel(
+          snapshot,
+          item?.intentId,
+          item?.filePath,
+          `${item?.id || 'work-item'}.md`
+        ),
         path: item.filePath,
         scope: 'upcoming'
       });
     }
     if (item?.intentId) {
       files.push({
-        label: `${item.intentId}/brief.md`,
+        label: buildIntentScopedLabel(
+          snapshot,
+          item.intentId,
+          path.join(snapshot?.rootPath || '', 'intents', item.intentId, 'brief.md'),
+          'brief.md'
+        ),
         path: path.join(snapshot?.rootPath || '', 'intents', item.intentId, 'brief.md'),
         scope: 'intent'
       });
@@ -1512,7 +1577,12 @@ function buildCompletedGroups(snapshot, flow) {
       key: `completed:intent:${intent?.id || index}`,
       label: `intent ${intent?.id || 'unknown'} [completed]`,
       files: filterExistingFiles([{
-        label: `${intent?.id || 'intent'}/brief.md`,
+        label: buildIntentScopedLabel(
+          snapshot,
+          intent?.id,
+          path.join(snapshot?.rootPath || '', 'intents', intent?.id || '', 'brief.md'),
+          'brief.md'
+        ),
         path: path.join(snapshot?.rootPath || '', 'intents', intent?.id || '', 'brief.md'),
         scope: 'intent'
       }])
@@ -1602,6 +1672,16 @@ function buildInteractiveRowsLines(rows, selectedIndex, icons, width, isFocusedS
       };
     }
 
+    if (row.kind === 'loading') {
+      return {
+        text: truncate(row.label || 'Loading...', width),
+        color: 'cyan',
+        bold: false,
+        selected: false,
+        loading: true
+      };
+    }
+
     return {
       text: truncate(`${isSelected ? `${cursor} ` : '  '}${row.label || ''}`, width),
       color: isSelected ? (isFocusedSection ? 'green' : 'cyan') : (row.color || 'gray'),
@@ -1941,6 +2021,7 @@ function createDashboardApp(deps) {
   const {
     React,
     ink,
+    inkUi,
     parseSnapshot,
     parseSnapshotForFlow,
     workspacePath,
@@ -1956,6 +2037,9 @@ function createDashboardApp(deps) {
 
   const { Box, Text, useApp, useInput, useStdout } = ink;
   const { useState, useEffect, useCallback, useRef } = React;
+  const Spinner = inkUi && typeof inkUi.Spinner === 'function'
+    ? inkUi.Spinner
+    : null;
 
   function SectionPanel(props) {
     const {
@@ -1990,15 +2074,25 @@ function createDashboardApp(deps) {
         { bold: true, color: titleColor, backgroundColor: titleBackground },
         truncate(title, contentWidth)
       ),
-      ...visibleLines.map((line, index) => React.createElement(
-        Text,
-        {
-          key: `${title}-${index}`,
-          color: line.color,
-          bold: line.bold
-        },
-        line.text
-      ))
+      ...visibleLines.map((line, index) => {
+        if (line.loading && Spinner) {
+          return React.createElement(
+            Box,
+            { key: `${title}-${index}` },
+            React.createElement(Spinner, { label: truncate(line.text, contentWidth) })
+          );
+        }
+
+        return React.createElement(
+          Text,
+          {
+            key: `${title}-${index}`,
+            color: line.color,
+            bold: line.bold
+          },
+          line.text
+        );
+      })
     );
   }
 
@@ -2178,42 +2272,42 @@ function createDashboardApp(deps) {
           expandedGroups
         )
       ]
-      : toInfoRows(['Loading intents...'], 'intent-loading');
+      : toLoadingRows('Loading intents...', 'intent-loading');
     const completedRows = shouldHydrateSecondaryTabs
       ? toExpandableRows(
         buildCompletedGroups(snapshot, activeFlow),
         getNoCompletedMessage(effectiveFlow),
         expandedGroups
       )
-      : toInfoRows(['Loading completed items...'], 'completed-loading');
+      : toLoadingRows('Loading completed items...', 'completed-loading');
     const standardsRows = shouldHydrateSecondaryTabs
       ? toExpandableRows(
         buildStandardsGroups(snapshot, activeFlow),
         effectiveFlow === 'simple' ? 'No standards for SIMPLE flow' : 'No standards found',
         expandedGroups
       )
-      : toInfoRows(['Loading standards...'], 'standards-loading');
+      : toLoadingRows('Loading standards...', 'standards-loading');
     const statsRows = shouldHydrateSecondaryTabs
       ? toInfoRows(
         buildStatsLines(snapshot, 200, activeFlow),
         'stats',
         'No stats available'
       )
-      : toInfoRows(['Loading stats...'], 'stats-loading');
+      : toLoadingRows('Loading stats...', 'stats-loading');
     const warningsRows = shouldHydrateSecondaryTabs
       ? toInfoRows(
         buildWarningsLines(snapshot, 200),
         'warnings',
         'No warnings'
       )
-      : toInfoRows(['Loading warnings...'], 'warnings-loading');
+      : toLoadingRows('Loading warnings...', 'warnings-loading');
     const errorDetailsRows = shouldHydrateSecondaryTabs
       ? toInfoRows(
         buildErrorLines(error, 200),
         'error-details',
         'No error details'
       )
-      : toInfoRows(['Loading error details...'], 'error-loading');
+      : toLoadingRows('Loading error details...', 'error-loading');
 
     const rowsBySection = {
       'current-run': currentRunRows,
@@ -2771,7 +2865,8 @@ function createDashboardApp(deps) {
       (showGlobalErrorPanel ? 5 : 0) +
       (showErrorInline ? 1 : 0) +
       (showStatusLine ? 1 : 0);
-    const contentRowsBudget = Math.max(4, rows - reservedRows);
+    const frameSafetyRows = 2;
+    const contentRowsBudget = Math.max(4, rows - reservedRows - frameSafetyRows);
     const ultraCompact = rows <= 14;
     const panelTitles = getPanelTitles(activeFlow, snapshot);
     const splitPreviewLayout = previewOpen && !overlayPreviewOpen && !ui.showHelp && cols >= 110 && rows >= 16;
@@ -2936,12 +3031,13 @@ function createDashboardApp(deps) {
 
     let contentNode;
     if (splitPreviewLayout && !overlayPreviewOpen) {
+      const previewBodyLines = Math.max(1, contentRowsBudget - 3);
       const previewPanel = {
         key: 'preview-split',
         title: `Preview: ${effectivePreviewTarget?.label || 'unknown'}`,
         lines: previewLines,
         borderColor: 'magenta',
-        maxLines: Math.max(4, contentRowsBudget)
+        maxLines: previewBodyLines
       };
 
       contentNode = React.createElement(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.1.39",
+  "version": "0.1.41",
   "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": {
@@ -40,6 +40,7 @@
     "README.md"
   ],
   "dependencies": {
+    "@inkjs/ui": "^2.0.0",
     "chalk": "^4.1.2",
     "chokidar": "^4.0.3",
     "commander": "^11.1.0",