specsmd 0.1.61 → 0.1.63

package/flows/fire/agents/builder/skills/run-execute/scripts/complete-run.cjs

@@ -704,7 +704,7 @@ function printUsage() {
   console.error('');
   console.error('Arguments:');
   console.error('  rootPath  - Project root directory');
-  console.error('  runId     - Run ID to complete (e.g., run-003)');
+  console.error('  runId     - Run ID to complete (e.g., run-fabriqa-2026-003)');
   console.error('');
   console.error('Flags:');
   console.error('  --complete-item  - Complete only the current work item (batch/wide runs)');
@@ -718,8 +718,8 @@ function printUsage() {
   console.error('  --coverage=N           - Coverage percentage');
   console.error('');
   console.error('Examples:');
-  console.error('  node complete-run.cjs /project run-003 --complete-item');
-  console.error('  node complete-run.cjs /project run-003 --complete-run --tests=5 --coverage=85');
+  console.error('  node complete-run.cjs /project run-fabriqa-2026-003 --complete-item');
+  console.error('  node complete-run.cjs /project run-fabriqa-2026-003 --complete-run --tests=5 --coverage=85');
 }
 
 // =============================================================================

package/flows/fire/agents/builder/skills/run-execute/scripts/init-run.cjs

@@ -152,26 +152,61 @@ function writeState(statePath, state) {
 }
 
 // =============================================================================
-// Run ID Generation (CRITICAL - checks both history and file system)
+// Run ID Generation (CRITICAL - checks state and file system)
 // =============================================================================
 
-function generateRunId(runsPath, state) {
+function sanitizeWorktreeToken(value) {
+  const normalized = String(value || '')
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, '-')
+    .replace(/^-+|-+$/g, '');
+  return normalized || 'workspace';
+}
+
+function resolveWorktreeToken(rootPath) {
+  const baseName = path.basename(path.resolve(String(rootPath || '')));
+  return sanitizeWorktreeToken(baseName);
+}
+
+function parseRunSequence(runId, worktreeToken) {
+  if (typeof runId !== 'string' || runId.trim() === '') {
+    return null;
+  }
+
+  const legacyMatch = runId.match(/^run-(\d+)$/);
+  if (legacyMatch) {
+    const parsed = parseInt(legacyMatch[1], 10);
+    return Number.isFinite(parsed) ? parsed : null;
+  }
+
+  const worktreeMatch = runId.match(/^run-([a-z0-9][a-z0-9-]*)-(\d+)$/);
+  if (worktreeMatch && worktreeMatch[1] === worktreeToken) {
+    const parsed = parseInt(worktreeMatch[2], 10);
+    return Number.isFinite(parsed) ? parsed : null;
+  }
+
+  return null;
+}
+
+function generateRunId(rootPath, runsPath, state) {
   // Ensure runs directory exists
   if (!fs.existsSync(runsPath)) {
     fs.mkdirSync(runsPath, { recursive: true });
   }
 
-  // Source 1: Get max from state.yaml runs.completed history
-  let maxFromHistory = 0;
-  if (state.runs && Array.isArray(state.runs.completed)) {
-    for (const run of state.runs.completed) {
-      if (run.id) {
-        const match = run.id.match(/^run-(\d+)$/);
-        if (match) {
-          const num = parseInt(match[1], 10);
-          if (num > maxFromHistory) maxFromHistory = num;
-        }
-      }
+  const worktreeToken = resolveWorktreeToken(rootPath);
+  let maxFromState = 0;
+
+  // Source 1: Get max from state.yaml run history (active + completed)
+  const stateRuns = state?.runs || {};
+  const stateRunRecords = [
+    ...(Array.isArray(stateRuns.active) ? stateRuns.active : []),
+    ...(Array.isArray(stateRuns.completed) ? stateRuns.completed : [])
+  ];
+  for (const run of stateRunRecords) {
+    const num = parseRunSequence(run?.id, worktreeToken);
+    if (num != null && num > maxFromState) {
+      maxFromState = num;
     }
   }
 
@@ -180,9 +215,9 @@ function generateRunId(runsPath, state) {
   try {
     const entries = fs.readdirSync(runsPath);
     for (const entry of entries) {
-      if (/^run-\d{3,}$/.test(entry)) {
-        const num = parseInt(entry.replace('run-', ''), 10);
-        if (num > maxFromFileSystem) maxFromFileSystem = num;
+      const num = parseRunSequence(entry, worktreeToken);
+      if (num != null && num > maxFromFileSystem) {
+        maxFromFileSystem = num;
       }
     }
   } catch (err) {
@@ -194,10 +229,10 @@ function generateRunId(runsPath, state) {
   }
 
   // Use MAX of both to ensure no duplicates
-  const maxNum = Math.max(maxFromHistory, maxFromFileSystem);
+  const maxNum = Math.max(maxFromState, maxFromFileSystem);
   const nextNum = maxNum + 1;
 
-  return `run-${String(nextNum).padStart(3, '0')}`;
+  return `run-${worktreeToken}-${String(nextNum).padStart(3, '0')}`;
 }
 
 // =============================================================================
@@ -333,7 +368,7 @@ function initRun(rootPath, workItems, scope) {
   }
 
   // Generate run ID (checks both history AND file system)
-  const runId = generateRunId(runsPath, state);
+  const runId = generateRunId(rootPath, runsPath, state);
   const runPath = path.join(runsPath, runId);
 
   // Create run folder

package/flows/fire/agents/builder/skills/run-execute/scripts/update-checkpoint.cjs

@@ -9,8 +9,8 @@
  *   node update-checkpoint.cjs <rootPath> <runId> <checkpointState> [--item=<workItemId>] [--checkpoint=<name>]
  *
  * Examples:
- *   node update-checkpoint.cjs /project run-001 awaiting_approval --checkpoint=plan
- *   node update-checkpoint.cjs /project run-001 approved
+ *   node update-checkpoint.cjs /project run-fabriqa-2026-001 awaiting_approval --checkpoint=plan
+ *   node update-checkpoint.cjs /project run-fabriqa-2026-001 approved
  */
 
 const fs = require('fs');
@@ -223,8 +223,8 @@ function printUsage() {
   console.error(`  ${VALID_STATES.join(', ')}`);
   console.error('');
   console.error('Examples:');
-  console.error('  node update-checkpoint.cjs /project run-001 awaiting_approval --checkpoint=plan');
-  console.error('  node update-checkpoint.cjs /project run-001 approved');
+  console.error('  node update-checkpoint.cjs /project run-fabriqa-2026-001 awaiting_approval --checkpoint=plan');
+  console.error('  node update-checkpoint.cjs /project run-fabriqa-2026-001 approved');
 }
 
 if (require.main === module) {

package/flows/fire/agents/builder/skills/run-execute/scripts/update-phase.cjs

@@ -10,9 +10,9 @@
  *   node update-phase.cjs <rootPath> <runId> <phase>
  *
  * Examples:
- *   node update-phase.cjs /project run-001 execute
- *   node update-phase.cjs /project run-001 test
- *   node update-phase.cjs /project run-001 review
+ *   node update-phase.cjs /project run-fabriqa-2026-001 execute
+ *   node update-phase.cjs /project run-fabriqa-2026-001 test
+ *   node update-phase.cjs /project run-fabriqa-2026-001 review
  */
 
 const fs = require('fs');
@@ -219,12 +219,12 @@ function printUsage() {
   console.error('');
   console.error('Arguments:');
   console.error('  rootPath  - Project root directory');
-  console.error('  runId     - Run ID (e.g., run-001)');
+  console.error('  runId     - Run ID (e.g., run-fabriqa-2026-001)');
   console.error('  phase     - New phase: plan, execute, test, review');
   console.error('');
   console.error('Examples:');
-  console.error('  node update-phase.cjs /project run-001 execute');
-  console.error('  node update-phase.cjs /project run-001 test');
+  console.error('  node update-phase.cjs /project run-fabriqa-2026-001 execute');
+  console.error('  node update-phase.cjs /project run-fabriqa-2026-001 test');
 }
 
 if (require.main === module) {

package/lib/dashboard/tui/app.js

@@ -1127,12 +1127,6 @@ function createDashboardApp(deps) {
           columns: Math.max(1, stdout.columns || process.stdout.columns || 120),
           rows: Math.max(1, stdout.rows || process.stdout.rows || 40)
         });
-
-        // Resize in some terminals can leave stale frame rows behind.
-        // Keep the clear operation minimal to avoid triggering scrollback churn.
-        if (typeof stdout.write === 'function' && stdout.isTTY !== false) {
-          stdout.write('\u001B[H\u001B[J');
-        }
       };
 
       updateSize();

package/lib/dashboard/tui/preview.js

@@ -6,6 +6,73 @@ const {
   loadGitCommitPreview
 } = require('../git/changes');
 
+const MAX_PREVIEW_CACHE_ENTRIES = 64;
+const previewContentCache = new Map();
+
+function getFilePreviewCacheKey(filePath) {
+  if (typeof filePath !== 'string' || filePath.trim() === '') {
+    return null;
+  }
+
+  try {
+    const stat = fs.statSync(filePath);
+    return `file:${filePath}:${stat.size}:${Math.floor(stat.mtimeMs)}`;
+  } catch {
+    return `file:${filePath}:missing`;
+  }
+}
+
+function getGitPreviewCacheKey(fileEntry, isGitCommitPreview) {
+  if (!fileEntry || typeof fileEntry !== 'object') {
+    return null;
+  }
+
+  const repoRoot = typeof fileEntry.repoRoot === 'string' ? fileEntry.repoRoot : '';
+  if (isGitCommitPreview) {
+    const commitHash = typeof fileEntry.commitHash === 'string' ? fileEntry.commitHash : '';
+    return `git-commit:${repoRoot}:${commitHash}`;
+  }
+
+  const bucket = typeof fileEntry.bucket === 'string' ? fileEntry.bucket : '';
+  const relativePath = typeof fileEntry.relativePath === 'string' ? fileEntry.relativePath : '';
+  const pathValue = typeof fileEntry.path === 'string' ? fileEntry.path : '';
+  return `git-diff:${repoRoot}:${bucket}:${relativePath}:${pathValue}`;
+}
+
+function getCachedPreviewContent(cacheKey) {
+  if (!cacheKey || !previewContentCache.has(cacheKey)) {
+    return null;
+  }
+
+  const cached = previewContentCache.get(cacheKey);
+  previewContentCache.delete(cacheKey);
+  previewContentCache.set(cacheKey, cached);
+  return Array.isArray(cached) ? cached : null;
+}
+
+function setCachedPreviewContent(cacheKey, lines) {
+  if (!cacheKey || !Array.isArray(lines)) {
+    return;
+  }
+
+  if (previewContentCache.has(cacheKey)) {
+    previewContentCache.delete(cacheKey);
+  }
+  previewContentCache.set(cacheKey, lines);
+
+  while (previewContentCache.size > MAX_PREVIEW_CACHE_ENTRIES) {
+    const oldest = previewContentCache.keys().next().value;
+    if (!oldest) {
+      break;
+    }
+    previewContentCache.delete(oldest);
+  }
+}
+
+function clearPreviewContentCache() {
+  previewContentCache.clear();
+}
+
 function buildPreviewLines(fileEntry, width, scrollOffset, options = {}) {
   const fullDocument = options?.fullDocument === true;
 
@@ -16,24 +83,31 @@ function buildPreviewLines(fileEntry, width, scrollOffset, options = {}) {
   const isGitFilePreview = fileEntry.previewType === 'git-diff';
   const isGitCommitPreview = fileEntry.previewType === 'git-commit-diff';
   const isGitPreview = isGitFilePreview || isGitCommitPreview;
-  let rawLines = [];
-  if (isGitPreview) {
-    const diffText = isGitCommitPreview
-      ? loadGitCommitPreview(fileEntry)
-      : loadGitDiffPreview(fileEntry);
-    rawLines = String(diffText || '').split(/\r?\n/);
-  } else {
-    let content;
-    try {
-      content = fs.readFileSync(fileEntry.path, 'utf8');
-    } catch (error) {
-      return [{
-        text: truncate(`Unable to read ${fileEntry.label || fileEntry.path}: ${error.message}`, width),
-        color: 'red',
-        bold: false
-      }];
+  const cacheKey = isGitPreview
+    ? getGitPreviewCacheKey(fileEntry, isGitCommitPreview)
+    : getFilePreviewCacheKey(fileEntry.path);
+  let rawLines = getCachedPreviewContent(cacheKey);
+  if (!rawLines) {
+    if (isGitPreview) {
+      const diffText = isGitCommitPreview
+        ? loadGitCommitPreview(fileEntry)
+        : loadGitDiffPreview(fileEntry);
+      rawLines = String(diffText || '').split(/\r?\n/);
+    } else {
+      let content;
+      try {
+        content = fs.readFileSync(fileEntry.path, 'utf8');
+      } catch (error) {
+        return [{
+          text: truncate(`Unable to read ${fileEntry.label || fileEntry.path}: ${error.message}`, width),
+          color: 'red',
+          bold: false
+        }];
+      }
+      rawLines = String(content).split(/\r?\n/);
     }
-    rawLines = String(content).split(/\r?\n/);
+
+    setCachedPreviewContent(cacheKey, rawLines);
   }
 
   const headLine = {
@@ -141,5 +215,6 @@ function allocateSingleColumnPanels(candidates, rowsBudget) {
 
 module.exports = {
   buildPreviewLines,
-  allocateSingleColumnPanels
+  allocateSingleColumnPanels,
+  clearPreviewContentCache
 };

package/package.json

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