specsmd 0.1.70 → 0.1.72

package/lib/dashboard/aidlc/parser.js

@@ -114,6 +114,25 @@ function normalizeTimestamp(value) {
   return parsed.toISOString();
 }
 
+function compareByCreatedAtThenId(a, b) {
+  const aTime = a?.createdAt ? Date.parse(a.createdAt) : NaN;
+  const bTime = b?.createdAt ? Date.parse(b.createdAt) : NaN;
+  const aHasTime = !Number.isNaN(aTime);
+  const bHasTime = !Number.isNaN(bTime);
+
+  if (aHasTime && bHasTime && aTime !== bTime) {
+    return aTime - bTime;
+  }
+  if (aHasTime && !bHasTime) {
+    return -1;
+  }
+  if (!aHasTime && bHasTime) {
+    return 1;
+  }
+
+  return String(a?.id || '').localeCompare(String(b?.id || ''));
+}
+
 function parseIntentFolderName(folderName) {
   const match = String(folderName).match(/^(\d{3})-(.+)$/);
   if (!match) {
@@ -272,7 +291,8 @@ function parseIntent(intentPath, warnings) {
     completedStories: storyStats.completed,
     inProgressStories: storyStats.inProgress,
     pendingStories: storyStats.pending,
-    blockedStories: storyStats.blocked
+    blockedStories: storyStats.blocked,
+    createdAt: normalizeTimestamp(requirementsFrontmatter.created)
   };
 }
 
@@ -486,7 +506,7 @@ function parseAidlcDashboard(workspacePath) {
   const intents = intentFolders
     .map((intentFolder) => parseIntent(path.join(intentsPath, intentFolder), warnings))
     .filter(Boolean)
-    .sort((a, b) => a.id.localeCompare(b.id));
+    .sort(compareByCreatedAtThenId);
 
   if (intentFolders.length === 0) {
     warnings.push('No intents found under memory-bank/intents.');

package/lib/dashboard/fire/model.js

@@ -350,7 +350,8 @@ function buildPendingItems(intents) {
         mode: item.mode,
         complexity: item.complexity,
         dependencies: item.dependencies || [],
-        filePath: item.filePath
+        filePath: item.filePath,
+        createdAt: item.createdAt
       });
     }
   }
@@ -360,6 +361,19 @@ function buildPendingItems(intents) {
     if (depDiff !== 0) {
       return depDiff;
     }
+    const aTime = a.createdAt ? Date.parse(a.createdAt) : NaN;
+    const bTime = b.createdAt ? Date.parse(b.createdAt) : NaN;
+    const aHasTime = !Number.isNaN(aTime);
+    const bHasTime = !Number.isNaN(bTime);
+    if (aHasTime && bHasTime && aTime !== bTime) {
+      return aTime - bTime;
+    }
+    if (aHasTime && !bHasTime) {
+      return -1;
+    }
+    if (!aHasTime && bHasTime) {
+      return 1;
+    }
     return a.id.localeCompare(b.id);
   });
 

package/lib/dashboard/fire/parser.js

@@ -12,7 +12,8 @@ const {
   calculateStats,
   parseDependencies,
   buildPendingItems,
-  normalizeRunWorkItem
+  normalizeRunWorkItem,
+  normalizeTimestamp
 } = require('./model');
 
 const STANDARD_TYPES = [
@@ -80,6 +81,46 @@ function getFirstStringValue(record, keys) {
   return undefined;
 }
 
+function compareByCreatedAtThenId(a, b) {
+  const aTime = a?.createdAt ? Date.parse(a.createdAt) : NaN;
+  const bTime = b?.createdAt ? Date.parse(b.createdAt) : NaN;
+  const aHasTime = !Number.isNaN(aTime);
+  const bHasTime = !Number.isNaN(bTime);
+
+  if (aHasTime && bHasTime && aTime !== bTime) {
+    return aTime - bTime;
+  }
+  if (aHasTime && !bHasTime) {
+    return -1;
+  }
+  if (!aHasTime && bHasTime) {
+    return 1;
+  }
+
+  return String(a?.id || '').localeCompare(String(b?.id || ''));
+}
+
+function compareRunDatesDesc(a, b) {
+  const aDate = a?.completedAt || a?.startedAt;
+  const bDate = b?.completedAt || b?.startedAt;
+  const aTime = aDate ? Date.parse(aDate) : NaN;
+  const bTime = bDate ? Date.parse(bDate) : NaN;
+  const aHasTime = !Number.isNaN(aTime);
+  const bHasTime = !Number.isNaN(bTime);
+
+  if (aHasTime && bHasTime && aTime !== bTime) {
+    return bTime - aTime;
+  }
+  if (aHasTime && !bHasTime) {
+    return -1;
+  }
+  if (!aHasTime && bHasTime) {
+    return 1;
+  }
+
+  return String(b?.id || '').localeCompare(String(a?.id || ''));
+}
+
 function parseRunLog(runLogPath) {
   const content = readFileSafe(runLogPath);
   if (!content) {
@@ -210,8 +251,8 @@ function scanWorkItems(intentPath, intentId, stateWorkItems, warnings) {
       filePath,
       description: typeof frontmatter.description === 'string' ? frontmatter.description : undefined,
       dependencies,
-      createdAt: typeof frontmatter.created === 'string' ? frontmatter.created : undefined,
-      completedAt: typeof frontmatter.completed_at === 'string' ? frontmatter.completed_at : undefined
+      createdAt: normalizeTimestamp(frontmatter.created),
+      completedAt: normalizeTimestamp(frontmatter.completed_at)
     };
   });
 }
@@ -252,8 +293,8 @@ function scanIntents(rootPath, normalizedState, warnings) {
       filePath: briefPath,
       description: typeof frontmatter.description === 'string' ? frontmatter.description : undefined,
       workItems,
-      createdAt: typeof frontmatter.created === 'string' ? frontmatter.created : undefined,
-      completedAt: typeof frontmatter.completed_at === 'string' ? frontmatter.completed_at : undefined
+      createdAt: normalizeTimestamp(frontmatter.created),
+      completedAt: normalizeTimestamp(frontmatter.completed_at)
     };
   });
 }
@@ -325,7 +366,8 @@ function buildActiveRuns(runs, normalizedState) {
 
   return (normalizedState.runs?.active || [])
     .map((active) => byId.get(active.id) || null)
-    .filter(Boolean);
+    .filter(Boolean)
+    .sort(compareRunDatesDesc);
 }
 
 function buildCompletedRuns(runs) {
@@ -430,8 +472,8 @@ function parseFireDashboard(workspacePath) {
 
   const warnings = [];
   const normalizedState = normalizeState(rawState);
-  const intents = scanIntents(rootPath, normalizedState, warnings);
-  const runs = scanRuns(rootPath, normalizedState);
+  const intents = scanIntents(rootPath, normalizedState, warnings).sort(compareByCreatedAtThenId);
+  const runs = scanRuns(rootPath, normalizedState).sort(compareRunDatesDesc);
   const activeRuns = buildActiveRuns(runs, normalizedState);
   const completedRuns = buildCompletedRuns(runs);
   const standards = scanStandards(rootPath);

package/lib/dashboard/web/extension-adapter.js

@@ -248,7 +248,8 @@ function buildSpecsData(snapshot) {
       path: intent.path,
       storiesComplete: units.reduce((sum, unit) => sum + unit.storiesComplete, 0),
       storiesTotal: units.reduce((sum, unit) => sum + unit.storiesTotal, 0),
-      units
+      units,
+      createdAt: intent.createdAt
     };
   });
 
@@ -400,7 +401,8 @@ function buildFireViewData(snapshot) {
     mode: normalizeFireMode(item.mode),
     complexity: normalizeFireComplexity(item.complexity),
     filePath: item.filePath,
-    dependencies: item.dependencies || []
+    dependencies: item.dependencies || [],
+    createdAt: item.createdAt
   }));
 
   const completedRuns = (snapshot.completedRuns || []).map((run) => ({
@@ -418,13 +420,15 @@ function buildFireViewData(snapshot) {
     status: normalizeFireStatus(intent.status),
     filePath: intent.filePath,
     description: intent.description,
+    createdAt: intent.createdAt,
     workItems: (intent.workItems || []).map((item) => ({
       id: item.id,
       title: item.title || item.id,
       status: normalizeFireStatus(item.status),
       mode: normalizeFireMode(item.mode),
       complexity: normalizeFireComplexity(item.complexity),
-      filePath: item.filePath
+      filePath: item.filePath,
+      createdAt: item.createdAt
     }))
   }));
 
@@ -706,12 +710,16 @@ function createSetDataMessage(data) {
     };
   }
 
-  const flowInfo = {
-    id: data.flow,
-    displayName: flowDisplayName(data.flow),
-    icon: flowIcon(data.flow),
-    rootFolder: flowRootFolder(data.flow)
-  };
+  const availableFlows = (data.availableFlows && data.availableFlows.length > 0
+    ? data.availableFlows
+    : [data.flow])
+    .filter(Boolean)
+    .map((flow) => ({
+      id: flow,
+      displayName: flowDisplayName(flow),
+      icon: flowIcon(flow),
+      rootFolder: flowRootFolder(flow)
+    }));
 
   if (data.flow === 'fire') {
     return {
@@ -733,7 +741,7 @@ function createSetDataMessage(data) {
       specsHtml: '',
       overviewHtml: '',
       fireData: buildFireViewData(data.snapshot),
-      availableFlows: [flowInfo],
+      availableFlows,
       activeFlowId: data.flow
     };
   }
@@ -757,7 +765,7 @@ function createSetDataMessage(data) {
     },
     specsHtml: getSpecsViewHtml(webviewData),
     overviewHtml: getOverviewViewHtml(webviewData),
-    availableFlows: [flowInfo],
+    availableFlows,
     activeFlowId: data.flow
   };
 }

package/lib/dashboard/web/public/app.js

@@ -28,6 +28,103 @@
     document.documentElement.style.colorScheme = theme;
   }
 
+  function copyText(text) {
+    if (navigator.clipboard && navigator.clipboard.writeText) {
+      return navigator.clipboard.writeText(text);
+    }
+
+    var textarea = document.createElement('textarea');
+    textarea.value = text;
+    textarea.setAttribute('readonly', 'readonly');
+    textarea.style.position = 'fixed';
+    textarea.style.opacity = '0';
+    document.body.appendChild(textarea);
+    textarea.select();
+
+    try {
+      document.execCommand('copy');
+      return Promise.resolve();
+    } catch (error) {
+      return Promise.reject(error);
+    } finally {
+      textarea.remove();
+    }
+  }
+
+  function closeCommandDialog() {
+    var existing = document.querySelector('.specsmd-command-dialog');
+    if (existing) {
+      existing.remove();
+    }
+  }
+
+  function showCommandDialog(command) {
+    closeCommandDialog();
+
+    var overlay = document.createElement('div');
+    overlay.className = 'specsmd-command-dialog';
+    overlay.setAttribute('role', 'dialog');
+    overlay.setAttribute('aria-modal', 'true');
+    overlay.setAttribute('aria-label', 'Start FIRE run command');
+
+    var panel = document.createElement('div');
+    panel.className = 'specsmd-command-dialog-panel';
+
+    var title = document.createElement('div');
+    title.className = 'specsmd-command-dialog-title';
+    title.textContent = 'Start FIRE run';
+
+    var description = document.createElement('div');
+    description.className = 'specsmd-command-dialog-description';
+    description.textContent = 'Run this command from your project folder.';
+
+    var commandBox = document.createElement('textarea');
+    commandBox.className = 'specsmd-command-dialog-command';
+    commandBox.value = command;
+    commandBox.readOnly = true;
+    commandBox.rows = 2;
+
+    var actions = document.createElement('div');
+    actions.className = 'specsmd-command-dialog-actions';
+
+    var copyButton = document.createElement('button');
+    copyButton.type = 'button';
+    copyButton.className = 'specsmd-command-dialog-copy';
+    copyButton.textContent = 'Copy Command';
+
+    var closeButton = document.createElement('button');
+    closeButton.type = 'button';
+    closeButton.className = 'specsmd-command-dialog-close';
+    closeButton.textContent = 'Close';
+
+    copyButton.addEventListener('click', function () {
+      copyText(command).then(function () {
+        copyButton.textContent = 'Copied';
+      }).catch(function () {
+        commandBox.focus();
+        commandBox.select();
+      });
+    });
+
+    closeButton.addEventListener('click', closeCommandDialog);
+    overlay.addEventListener('click', function (event) {
+      if (event.target === overlay) {
+        closeCommandDialog();
+      }
+    });
+
+    actions.appendChild(copyButton);
+    actions.appendChild(closeButton);
+    panel.appendChild(title);
+    panel.appendChild(description);
+    panel.appendChild(commandBox);
+    panel.appendChild(actions);
+    overlay.appendChild(panel);
+    document.body.appendChild(overlay);
+    commandBox.focus();
+    commandBox.select();
+  }
+
   document.documentElement.dataset.host = 'dashboard-web';
   applyTheme(readTheme());
 
@@ -44,4 +141,18 @@
       document.documentElement.dataset.loaded = 'true';
     }
   });
+
+  window.addEventListener('specsmd-dashboard-command', function (event) {
+    if (!event.detail || !event.detail.command) {
+      return;
+    }
+
+    showCommandDialog(String(event.detail.command));
+  });
+
+  window.addEventListener('keydown', function (event) {
+    if (event.key === 'Escape') {
+      closeCommandDialog();
+    }
+  });
 }());

package/lib/dashboard/web/public/styles.css

@@ -64,3 +64,77 @@ specsmd-app {
   width: 100vw;
   height: 100vh;
 }
+
+.specsmd-command-dialog {
+  position: fixed;
+  inset: 0;
+  z-index: 1000;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  padding: 24px;
+  background: rgba(0, 0, 0, 0.45);
+}
+
+.specsmd-command-dialog-panel {
+  width: min(520px, 100%);
+  padding: 16px;
+  border: 1px solid var(--vscode-sideBarSectionHeader-border);
+  border-radius: 8px;
+  background: var(--vscode-sideBar-background);
+  color: var(--vscode-foreground);
+  box-shadow: 0 18px 56px rgba(0, 0, 0, 0.28);
+}
+
+.specsmd-command-dialog-title {
+  font-size: 15px;
+  font-weight: 700;
+  margin-bottom: 4px;
+}
+
+.specsmd-command-dialog-description {
+  margin-bottom: 12px;
+  color: var(--vscode-descriptionForeground);
+  font-size: 12px;
+}
+
+.specsmd-command-dialog-command {
+  box-sizing: border-box;
+  width: 100%;
+  min-height: 58px;
+  resize: vertical;
+  padding: 10px;
+  border: 1px solid var(--vscode-input-border);
+  border-radius: 6px;
+  background: var(--vscode-input-background);
+  color: var(--vscode-foreground);
+  font: 12px ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, monospace;
+}
+
+.specsmd-command-dialog-actions {
+  display: flex;
+  justify-content: flex-end;
+  gap: 8px;
+  margin-top: 12px;
+}
+
+.specsmd-command-dialog-actions button {
+  min-width: 88px;
+  padding: 7px 10px;
+  border: 1px solid var(--vscode-input-border);
+  border-radius: 6px;
+  color: var(--vscode-foreground);
+  background: transparent;
+  font: inherit;
+  cursor: pointer;
+}
+
+.specsmd-command-dialog-actions button:hover {
+  background: var(--vscode-list-hoverBackground);
+}
+
+.specsmd-command-dialog-copy {
+  border-color: var(--vscode-button-background) !important;
+  background: var(--vscode-button-background) !important;
+  color: var(--vscode-button-foreground) !important;
+}

package/lib/dashboard/web/public/webview-bundle.js

@@ -6167,6 +6167,31 @@
 
                 <!-- Resources Footer -->
                 <div class="resources-footer">
+                    <div class="fabriqa-card">
+                        <div class="fabriqa-brand">
+                            <div class="fabriqa-mark">FA</div>
+                            <div>
+                                <div class="fabriqa-title">specs.md by Fabriqa.AI</div>
+                                <div class="fabriqa-subtitle">Spec-native agentic development environment</div>
+                            </div>
+                        </div>
+                        <div class="fabriqa-copy">
+                            Use Fabriqa.AI with your existing AI subscription to design, run, and reuse agentic workflows around your specs. It is free to try.
+                        </div>
+                        <div class="fabriqa-actions">
+                            <div class="fabriqa-link" @click=${() => this._openExternal("https://fabriqa.ai")}>Explore Fabriqa.AI</div>
+                            <div class="fabriqa-link secondary" @click=${() => this._openExternal("https://specs.md")}>Open specs.md</div>
+                        </div>
+                    </div>
+                    <div class="dashboard-tip">
+                        <div class="dashboard-tip-title">Did you know?</div>
+                        <div class="dashboard-tip-copy">
+                            You can use the specs.md dashboard outside VS Code and VS Code variants. Run <code>npx specsmd@latest dashboard</code> from your project folder.
+                        </div>
+                        <div class="fabriqa-actions">
+                            <div class="fabriqa-link secondary" @click=${() => this._openExternal("https://specs.md/getting-started/cli-dashboard")}>Dashboard docs</div>
+                        </div>
+                    </div>
                     <div class="resources-title">Links</div>
                     <div class="resources-links">
                         <div class="resource-link" @click=${() => this._openExternal("https://specs.md")} title="Website">
@@ -6497,6 +6522,104 @@
             .feedback-link:hover {
                 opacity: 0.8;
             }
+
+            .fabriqa-card {
+                padding: 12px;
+                margin-bottom: 12px;
+                border: 1px solid rgba(249, 115, 22, 0.35);
+                border-radius: 6px;
+                background: linear-gradient(135deg, rgba(249, 115, 22, 0.12), rgba(34, 197, 94, 0.08));
+            }
+
+            .fabriqa-brand {
+                display: flex;
+                align-items: center;
+                gap: 10px;
+                margin-bottom: 8px;
+            }
+
+            .fabriqa-mark {
+                display: flex;
+                align-items: center;
+                justify-content: center;
+                flex: 0 0 30px;
+                height: 30px;
+                border-radius: 6px;
+                background: var(--status-active);
+                color: #ffffff;
+                font-size: 11px;
+                font-weight: 700;
+            }
+
+            .fabriqa-title {
+                font-size: 13px;
+                font-weight: 700;
+                color: var(--foreground);
+            }
+
+            .fabriqa-subtitle,
+            .fabriqa-copy,
+            .dashboard-tip-copy {
+                font-size: 11px;
+                line-height: 1.45;
+                color: var(--description-foreground);
+            }
+
+            .fabriqa-copy {
+                margin-bottom: 10px;
+            }
+
+            .fabriqa-actions {
+                display: flex;
+                flex-wrap: wrap;
+                gap: 8px;
+            }
+
+            .fabriqa-link {
+                display: inline-flex;
+                align-items: center;
+                justify-content: center;
+                padding: 6px 9px;
+                border-radius: 5px;
+                background: var(--status-active);
+                color: #ffffff;
+                font-size: 11px;
+                font-weight: 600;
+                cursor: pointer;
+            }
+
+            .fabriqa-link.secondary {
+                border: 1px solid var(--border-color);
+                background: var(--editor-background);
+                color: var(--foreground);
+            }
+
+            .fabriqa-link:hover {
+                opacity: 0.86;
+            }
+
+            .dashboard-tip {
+                padding: 10px;
+                margin-bottom: 12px;
+                border: 1px solid var(--border-color);
+                border-radius: 6px;
+                background: var(--editor-background);
+            }
+
+            .dashboard-tip-title {
+                margin-bottom: 4px;
+                color: var(--foreground);
+                font-size: 11px;
+                font-weight: 700;
+            }
+
+            .dashboard-tip code {
+                padding: 1px 4px;
+                border-radius: 4px;
+                background: var(--background);
+                color: var(--foreground);
+                font-family: var(--font-family);
+            }
         `
   ];
   __decorateClass([
@@ -6644,6 +6767,15 @@
     connectEvents();
     return {
       postMessage(message) {
+        if (isStandaloneStartRunMessage(message)) {
+          window.dispatchEvent(new CustomEvent("specsmd-dashboard-command", {
+            detail: {
+              command: buildFireStartRunCommand(message.workItemIds),
+              workItemIds: message.workItemIds
+            }
+          }));
+          return;
+        }
         fetch("/api/message", {
           method: "POST",
           headers: { "content-type": "application/json" },
@@ -6665,6 +6797,13 @@
       }
     };
   }
+  function isStandaloneStartRunMessage(message) {
+    return typeof message === "object" && message !== null && message.type === "startRun" && Array.isArray(message.workItemIds);
+  }
+  function buildFireStartRunCommand(workItemIds) {
+    const ids = workItemIds.map((id) => String(id).trim()).filter(Boolean);
+    return ["/specsmd-fire-builder", ...ids].join(" ");
+  }
   var vscode = typeof acquireVsCodeApi === "function" ? acquireVsCodeApi() : createStandaloneApi();
 
   // src/webview/components/app.ts
@@ -7105,6 +7244,15 @@
       }
     }
     _handleFireFilterChange(e7) {
+      if (this._fireData) {
+        this._fireData = {
+          ...this._fireData,
+          intentsData: {
+            ...this._fireData.intentsData,
+            filter: e7.detail.filter
+          }
+        };
+      }
       vscode.postMessage({ type: "fireIntentsFilter", filter: e7.detail.filter });
     }
     _handleFireToggleExpand(e7) {

package/lib/dashboard/web/server.js

@@ -5,7 +5,7 @@ const { URL } = require('url');
 const { spawn } = require('child_process');
 const crypto = require('crypto');
 const { createWatchRuntime } = require('../runtime/watch-runtime');
-const { detectFlow } = require('../flow-detect');
+const { detectAvailableFlows, detectFlow } = require('../flow-detect');
 const { loadWebDashboardData } = require('./snapshot');
 
 const PUBLIC_DIR = path.join(__dirname, 'public');
@@ -179,9 +179,13 @@ async function startDashboardWeb(options = {}) {
   const clients = new Set();
   let watcher = null;
   let lastData = null;
+  let activeFlow = options.flow || null;
 
   async function loadAndBroadcast() {
-    lastData = await loadWebDashboardData({ workspacePath, flow: options.flow });
+    lastData = await loadWebDashboardData({ workspacePath, flow: activeFlow });
+    if (lastData.flow) {
+      activeFlow = lastData.flow;
+    }
     const message = lastData.webviewMessage || lastData;
     const payload = `event: message\ndata: ${JSON.stringify(message)}\n\n`;
     for (const client of clients) {
@@ -218,6 +222,19 @@ async function startDashboardWeb(options = {}) {
           sendJson(res, 200, { ok: true, data });
           return;
         }
+        if (message.type === 'switchFlow') {
+          const availableFlows = detectAvailableFlows(workspacePath);
+          const requestedFlow = typeof message.flowId === 'string' ? message.flowId : null;
+          if (requestedFlow && availableFlows.includes(requestedFlow)) {
+            activeFlow = requestedFlow;
+          } else if (availableFlows.length > 0) {
+            const currentIndex = availableFlows.indexOf(activeFlow);
+            activeFlow = availableFlows[(currentIndex + 1) % availableFlows.length];
+          }
+          const data = await loadAndBroadcast();
+          sendJson(res, 200, { ok: true, data });
+          return;
+        }
         if (message.type === 'openExternal') {
           const opened = openExternal(message.url);
           sendJson(res, opened ? 200 : 400, opened
@@ -308,14 +325,9 @@ async function startDashboardWeb(options = {}) {
 
   const initialData = await loadAndBroadcast();
   if (options.watch !== false && initialData.flow) {
-    let detection = null;
-    try {
-      detection = detectFlow(workspacePath, options.flow);
-    } catch {
-      detection = null;
-    }
-    const flow = detection?.flow || initialData.flow;
-    const roots = buildWatchRoots(workspacePath, flow).filter((root) => fs.existsSync(root));
+    const roots = detectAvailableFlows(workspacePath)
+      .flatMap((flow) => buildWatchRoots(workspacePath, flow))
+      .filter((root) => fs.existsSync(root));
     if (roots.length > 0) {
       watcher = createWatchRuntime({
         rootPaths: roots,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specsmd",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "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": {