bigpowers 1.3.1 → 1.4.0

package/dashboard/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "bigpowers-dashboard",
+  "version": "1.0.0",
+  "description": "Factory dashboard for bigpowers projects",
+  "private": true,
+  "main": "src/tui/index.js",
+  "scripts": {
+    "start": "node bin/dashboard.js",
+    "web": "node bin/dashboard.js --web",
+    "test": "node test/watcher.test.js && node test/smoke.test.js"
+  },
+  "dependencies": {
+    "blessed": "0.1.81",
+    "chokidar": "3.6.0",
+    "express": "4.19.0",
+    "js-yaml": "4.1.0"
+  }
+}

package/dashboard/src/data/gate-status.js

@@ -0,0 +1,32 @@
+const COLOR_MAP = {
+  ready: 'green',
+  blocked: 'red',
+  in_progress: 'yellow',
+  done: 'green',
+  pending: 'dim',
+  active: 'cyan'
+};
+
+const ICON_MAP = {
+  ready: '●',
+  blocked: '✕',
+  in_progress: '◐',
+  done: '✓',
+  pending: '○',
+  active: '◐'
+};
+
+function gateColor(gateStatus) {
+  return COLOR_MAP[gateStatus] || 'dim';
+}
+
+function gateIcon(gateStatus) {
+  return ICON_MAP[gateStatus] || '-';
+}
+
+module.exports = {
+  gateColor,
+  gateIcon,
+  COLOR_MAP,
+  ICON_MAP
+};

package/dashboard/src/data/metrics.js

@@ -0,0 +1,89 @@
+/**
+ * computeEpicMetrics(cycleTimes)
+ * Groups cycle times by epic prefix (e.g. e01 from e01s01)
+ * Returns Map of epicId to { avgCycleMin, totalBcps, avgBcpPerHour }
+ */
+function computeEpicMetrics(cycleTimes) {
+  if (!cycleTimes || cycleTimes.length === 0) {
+    return new Map();
+  }
+
+  const epicMap = new Map();
+  for (const story of cycleTimes) {
+    // Extract epic prefix: e01s01 -> e01
+    const epicId = story.id ? story.id.replace(/s\d+$/, '') : null;
+    if (!epicId) continue;
+
+    if (!epicMap.has(epicId)) {
+      epicMap.set(epicId, { stories: [] });
+    }
+    epicMap.get(epicId).stories.push(story);
+  }
+
+  const result = new Map();
+  for (const [epicId, data] of epicMap) {
+    const stories = data.stories;
+    const totalBcps = stories.reduce((sum, s) => sum + (s.bcps || 0), 0);
+    const totalMin = stories.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
+    const avgCycleMin = stories.length > 0 ? totalMin / stories.length : 0;
+    const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
+
+    result.set(epicId, {
+      avgCycleMin,
+      totalBcps,
+      avgBcpPerHour
+    });
+  }
+
+  return result;
+}
+
+/**
+ * computeProjectMetrics(cycleTimes)
+ * Returns { totalBcps, totalMin, avgBcpPerHour } or null if no data
+ */
+function computeProjectMetrics(cycleTimes) {
+  if (!cycleTimes || cycleTimes.length === 0) {
+    return null;
+  }
+
+  const totalBcps = cycleTimes.reduce((sum, s) => sum + (s.bcps || 0), 0);
+  const totalMin = cycleTimes.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
+  const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
+
+  return {
+    totalBcps,
+    totalMin,
+    avgBcpPerHour
+  };
+}
+
+/**
+ * computeCurrentVelocity(cycleTimes, windowStories=3)
+ * Rolling average of last N stories
+ * Returns { avgBcpPerHour, avgCycleMin } or null if no data
+ */
+function computeCurrentVelocity(cycleTimes, windowStories = 3) {
+  if (!cycleTimes || cycleTimes.length === 0) {
+    return null;
+  }
+
+  const window = Math.min(windowStories, cycleTimes.length);
+  const recentStories = cycleTimes.slice(-window);
+
+  const totalBcps = recentStories.reduce((sum, s) => sum + (s.bcps || 0), 0);
+  const totalMin = recentStories.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
+  const avgCycleMin = recentStories.length > 0 ? totalMin / recentStories.length : 0;
+  const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
+
+  return {
+    avgBcpPerHour,
+    avgCycleMin
+  };
+}
+
+module.exports = {
+  computeEpicMetrics,
+  computeProjectMetrics,
+  computeCurrentVelocity
+};

package/dashboard/src/data/pipeline-map.js

@@ -0,0 +1,32 @@
+const STEPS = [
+  'survey-context',
+  'plan-work',
+  'kickoff-branch',
+  'develop-tdd',
+  'verify-work',
+  'audit-code',
+  'commit-message',
+  'release-branch'
+];
+
+function stepIndex(currentStep) {
+  return STEPS.indexOf(currentStep);
+}
+
+function stepLabel(index) {
+  if (index < 0 || index >= STEPS.length) {
+    return '-';
+  }
+  return STEPS[index];
+}
+
+function allSteps() {
+  return [...STEPS];
+}
+
+module.exports = {
+  stepIndex,
+  stepLabel,
+  allSteps,
+  STEPS
+};

package/dashboard/src/data/reader.js

@@ -0,0 +1,122 @@
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+
+/**
+ * readStateYaml(projectRoot)
+ * Reads specs/state.yaml and returns an object with mapped fields
+ * Returns null if file doesn't exist
+ */
+function readStateYaml(projectRoot) {
+  try {
+    const filePath = path.join(projectRoot, 'specs', 'state.yaml');
+    if (!fs.existsSync(filePath)) {
+      return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const data = yaml.load(content);
+    return {
+      activeFlow: data.active_flow || null,
+      activeEpic: data.active_epic_id || null,
+      activeStory: data.active_story_id || null,
+      epicCycle: data.epic_cycle || {},
+      gitBranch: data.git?.branch || null,
+      metrics: data.metrics || null,
+      release: data.release || {},
+      handoff: data.handoff || {}
+    };
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * readExecutionStatus(projectRoot)
+ * Reads specs/execution-status.yaml and returns { epics: Map }
+ * Map keys are story/epic IDs, values are status strings
+ * Returns null if file doesn't exist
+ */
+function readExecutionStatus(projectRoot) {
+  try {
+    const filePath = path.join(projectRoot, 'specs', 'execution-status.yaml');
+    if (!fs.existsSync(filePath)) {
+      return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const data = yaml.load(content);
+    const statusMap = new Map();
+    const devStatus = data.development_status || {};
+    for (const [key, value] of Object.entries(devStatus)) {
+      statusMap.set(key, value);
+    }
+    return { epics: statusMap };
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * readEpicShards(projectRoot)
+ * Reads all files in specs/epics/*.yaml
+ * Returns array of { id, title, stories } objects or null
+ */
+function readEpicShards(projectRoot) {
+  try {
+    const epicsDir = path.join(projectRoot, 'specs', 'epics');
+    if (!fs.existsSync(epicsDir)) {
+      return null;
+    }
+    const files = fs.readdirSync(epicsDir)
+      .filter(f => f.endsWith('.yaml'))
+      .sort();
+
+    const epics = [];
+    for (const file of files) {
+      const filePath = path.join(epicsDir, file);
+      const content = fs.readFileSync(filePath, 'utf8');
+      const data = yaml.load(content);
+      epics.push({
+        id: data.id || null,
+        title: data.title || null,
+        stories: data.stories || []
+      });
+    }
+    return epics.length > 0 ? epics : null;
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * readCycleTimes(projectRoot)
+ * Reads specs/metrics/cycle-times.yaml stories array
+ * Returns array of { id, bcps, start, end, cycleMin, bcpPerHour } or null
+ */
+function readCycleTimes(projectRoot) {
+  try {
+    const filePath = path.join(projectRoot, 'specs', 'metrics', 'cycle-times.yaml');
+    if (!fs.existsSync(filePath)) {
+      return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const data = yaml.load(content);
+    const stories = data.stories || [];
+    return stories.map(s => ({
+      id: s.id || null,
+      bcps: s.bcps || 0,
+      start: s.start || null,
+      end: s.end || null,
+      cycleMin: s.cycle_min || 0,
+      bcpPerHour: s.bcp_per_hour || 0
+    }));
+  } catch (err) {
+    return null;
+  }
+}
+
+module.exports = {
+  readStateYaml,
+  readExecutionStatus,
+  readEpicShards,
+  readCycleTimes
+};

package/dashboard/src/data/watcher.js

@@ -0,0 +1,108 @@
+const EventEmitter = require('events');
+const fs = require('fs');
+const path = require('path');
+
+let chokidar;
+try {
+  chokidar = require('chokidar');
+} catch (err) {
+  chokidar = null;
+}
+
+function watch(projectRoot) {
+  const emitter = new EventEmitter();
+  const debounceTimers = {};
+
+  function notifyChange(file) {
+    const key = file;
+    if (debounceTimers[key]) {
+      clearTimeout(debounceTimers[key]);
+    }
+    debounceTimers[key] = setTimeout(() => {
+      emitter.emit('change', { file, data: null });
+      delete debounceTimers[key];
+    }, 300);
+  }
+
+  if (chokidar) {
+    const filesToWatch = [
+      path.join(projectRoot, 'specs/state.yaml'),
+      path.join(projectRoot, 'specs/execution-status.yaml'),
+      path.join(projectRoot, 'specs/metrics/cycle-times.yaml'),
+      path.join(projectRoot, 'specs/epics')
+    ];
+
+    const watcher = chokidar.watch(filesToWatch, {
+      persistent: true,
+      awaitWriteFinish: {
+        stabilityThreshold: 100,
+        pollInterval: 100
+      }
+    });
+
+    watcher.on('change', (file) => {
+      notifyChange(file);
+    });
+
+    watcher.on('add', (file) => {
+      notifyChange(file);
+    });
+
+    emitter.close = () => watcher.close();
+  } else {
+    const fileStats = {};
+    const filesToWatch = [
+      path.join(projectRoot, 'specs/state.yaml'),
+      path.join(projectRoot, 'specs/execution-status.yaml'),
+      path.join(projectRoot, 'specs/metrics/cycle-times.yaml')
+    ];
+
+    const pollInterval = setInterval(() => {
+      filesToWatch.forEach((file) => {
+        try {
+          const stat = fs.statSync(file);
+          const mtime = stat.mtime.getTime();
+
+          if (!fileStats[file]) {
+            fileStats[file] = mtime;
+          } else if (fileStats[file] !== mtime) {
+            fileStats[file] = mtime;
+            notifyChange(file);
+          }
+        } catch (err) {
+          // File doesn't exist yet or was deleted
+          if (fileStats[file]) {
+            delete fileStats[file];
+            notifyChange(file);
+          }
+        }
+      });
+
+      // Check specs/epics directory
+      const epicsDir = path.join(projectRoot, 'specs/epics');
+      try {
+        const entries = fs.readdirSync(epicsDir);
+        entries.forEach((entry) => {
+          const fullPath = path.join(epicsDir, entry);
+          const stat = fs.statSync(fullPath);
+          const mtime = stat.mtime.getTime();
+
+          if (!fileStats[fullPath]) {
+            fileStats[fullPath] = mtime;
+          } else if (fileStats[fullPath] !== mtime) {
+            fileStats[fullPath] = mtime;
+            notifyChange(fullPath);
+          }
+        });
+      } catch (err) {
+        // epics directory doesn't exist yet
+      }
+    }, 200);
+
+    emitter.close = () => clearInterval(pollInterval);
+  }
+
+  return emitter;
+}
+
+module.exports = { watch };

package/dashboard/src/loaders/gate-status.js

@@ -0,0 +1,32 @@
+const COLOR_MAP = {
+  ready: 'green',
+  blocked: 'red',
+  in_progress: 'yellow',
+  done: 'green',
+  pending: 'dim',
+  active: 'cyan'
+};
+
+const ICON_MAP = {
+  ready: '●',
+  blocked: '✕',
+  in_progress: '◐',
+  done: '✓',
+  pending: '○',
+  active: '◐'
+};
+
+function gateColor(gateStatus) {
+  return COLOR_MAP[gateStatus] || 'dim';
+}
+
+function gateIcon(gateStatus) {
+  return ICON_MAP[gateStatus] || '-';
+}
+
+module.exports = {
+  gateColor,
+  gateIcon,
+  COLOR_MAP,
+  ICON_MAP
+};

package/dashboard/src/loaders/metrics.js

@@ -0,0 +1,89 @@
+/**
+ * computeEpicMetrics(cycleTimes)
+ * Groups cycle times by epic prefix (e.g. e01 from e01s01)
+ * Returns Map of epicId to { avgCycleMin, totalBcps, avgBcpPerHour }
+ */
+function computeEpicMetrics(cycleTimes) {
+  if (!cycleTimes || cycleTimes.length === 0) {
+    return new Map();
+  }
+
+  const epicMap = new Map();
+  for (const story of cycleTimes) {
+    // Extract epic prefix: e01s01 -> e01
+    const epicId = story.id ? story.id.replace(/s\d+$/, '') : null;
+    if (!epicId) continue;
+
+    if (!epicMap.has(epicId)) {
+      epicMap.set(epicId, { stories: [] });
+    }
+    epicMap.get(epicId).stories.push(story);
+  }
+
+  const result = new Map();
+  for (const [epicId, data] of epicMap) {
+    const stories = data.stories;
+    const totalBcps = stories.reduce((sum, s) => sum + (s.bcps || 0), 0);
+    const totalMin = stories.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
+    const avgCycleMin = stories.length > 0 ? totalMin / stories.length : 0;
+    const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
+
+    result.set(epicId, {
+      avgCycleMin,
+      totalBcps,
+      avgBcpPerHour
+    });
+  }
+
+  return result;
+}
+
+/**
+ * computeProjectMetrics(cycleTimes)
+ * Returns { totalBcps, totalMin, avgBcpPerHour } or null if no data
+ */
+function computeProjectMetrics(cycleTimes) {
+  if (!cycleTimes || cycleTimes.length === 0) {
+    return null;
+  }
+
+  const totalBcps = cycleTimes.reduce((sum, s) => sum + (s.bcps || 0), 0);
+  const totalMin = cycleTimes.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
+  const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
+
+  return {
+    totalBcps,
+    totalMin,
+    avgBcpPerHour
+  };
+}
+
+/**
+ * computeCurrentVelocity(cycleTimes, windowStories=3)
+ * Rolling average of last N stories
+ * Returns { avgBcpPerHour, avgCycleMin } or null if no data
+ */
+function computeCurrentVelocity(cycleTimes, windowStories = 3) {
+  if (!cycleTimes || cycleTimes.length === 0) {
+    return null;
+  }
+
+  const window = Math.min(windowStories, cycleTimes.length);
+  const recentStories = cycleTimes.slice(-window);
+
+  const totalBcps = recentStories.reduce((sum, s) => sum + (s.bcps || 0), 0);
+  const totalMin = recentStories.reduce((sum, s) => sum + (s.cycleMin || 0), 0);
+  const avgCycleMin = recentStories.length > 0 ? totalMin / recentStories.length : 0;
+  const avgBcpPerHour = totalMin > 0 ? (totalBcps * 60) / totalMin : 0;
+
+  return {
+    avgBcpPerHour,
+    avgCycleMin
+  };
+}
+
+module.exports = {
+  computeEpicMetrics,
+  computeProjectMetrics,
+  computeCurrentVelocity
+};

package/dashboard/src/loaders/pipeline-map.js

@@ -0,0 +1,32 @@
+const STEPS = [
+  'survey-context',
+  'plan-work',
+  'kickoff-branch',
+  'develop-tdd',
+  'verify-work',
+  'audit-code',
+  'commit-message',
+  'release-branch'
+];
+
+function stepIndex(currentStep) {
+  return STEPS.indexOf(currentStep);
+}
+
+function stepLabel(index) {
+  if (index < 0 || index >= STEPS.length) {
+    return '-';
+  }
+  return STEPS[index];
+}
+
+function allSteps() {
+  return [...STEPS];
+}
+
+module.exports = {
+  stepIndex,
+  stepLabel,
+  allSteps,
+  STEPS
+};

package/dashboard/src/loaders/reader.js

@@ -0,0 +1,122 @@
+const fs = require('fs');
+const path = require('path');
+const yaml = require('js-yaml');
+
+/**
+ * readStateYaml(projectRoot)
+ * Reads specs/state.yaml and returns an object with mapped fields
+ * Returns null if file doesn't exist
+ */
+function readStateYaml(projectRoot) {
+  try {
+    const filePath = path.join(projectRoot, 'specs', 'state.yaml');
+    if (!fs.existsSync(filePath)) {
+      return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const data = yaml.load(content);
+    return {
+      activeFlow: data.active_flow || null,
+      activeEpic: data.active_epic_id || null,
+      activeStory: data.active_story_id || null,
+      epicCycle: data.epic_cycle || {},
+      gitBranch: data.git?.branch || null,
+      metrics: data.metrics || null,
+      release: data.release || {},
+      handoff: data.handoff || {}
+    };
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * readExecutionStatus(projectRoot)
+ * Reads specs/execution-status.yaml and returns { epics: Map }
+ * Map keys are story/epic IDs, values are status strings
+ * Returns null if file doesn't exist
+ */
+function readExecutionStatus(projectRoot) {
+  try {
+    const filePath = path.join(projectRoot, 'specs', 'execution-status.yaml');
+    if (!fs.existsSync(filePath)) {
+      return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const data = yaml.load(content);
+    const statusMap = new Map();
+    const devStatus = data.development_status || {};
+    for (const [key, value] of Object.entries(devStatus)) {
+      statusMap.set(key, value);
+    }
+    return { epics: statusMap };
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * readEpicShards(projectRoot)
+ * Reads all files in specs/epics/*.yaml
+ * Returns array of { id, title, stories } objects or null
+ */
+function readEpicShards(projectRoot) {
+  try {
+    const epicsDir = path.join(projectRoot, 'specs', 'epics');
+    if (!fs.existsSync(epicsDir)) {
+      return null;
+    }
+    const files = fs.readdirSync(epicsDir)
+      .filter(f => f.endsWith('.yaml'))
+      .sort();
+
+    const epics = [];
+    for (const file of files) {
+      const filePath = path.join(epicsDir, file);
+      const content = fs.readFileSync(filePath, 'utf8');
+      const data = yaml.load(content);
+      epics.push({
+        id: data.id || null,
+        title: data.title || null,
+        stories: data.stories || []
+      });
+    }
+    return epics.length > 0 ? epics : null;
+  } catch (err) {
+    return null;
+  }
+}
+
+/**
+ * readCycleTimes(projectRoot)
+ * Reads specs/metrics/cycle-times.yaml stories array
+ * Returns array of { id, bcps, start, end, cycleMin, bcpPerHour } or null
+ */
+function readCycleTimes(projectRoot) {
+  try {
+    const filePath = path.join(projectRoot, 'specs', 'metrics', 'cycle-times.yaml');
+    if (!fs.existsSync(filePath)) {
+      return null;
+    }
+    const content = fs.readFileSync(filePath, 'utf8');
+    const data = yaml.load(content);
+    const stories = data.stories || [];
+    return stories.map(s => ({
+      id: s.id || null,
+      bcps: s.bcps || 0,
+      start: s.start || null,
+      end: s.end || null,
+      cycleMin: s.cycle_min || 0,
+      bcpPerHour: s.bcp_per_hour || 0
+    }));
+  } catch (err) {
+    return null;
+  }
+}
+
+module.exports = {
+  readStateYaml,
+  readExecutionStatus,
+  readEpicShards,
+  readCycleTimes
+};