@polymorphism-tech/morph-spec 7.8.1 → 7.9.0

package/src/lib/agents/metrics-aggregator.js

@@ -1,56 +1,56 @@
-/**
- * Project-level metrics aggregator
- *
- * Aggregates feature-level data from state.json into a project-wide
- * metrics summary. Pure computation — no I/O.
- */
-
-/**
- * Aggregate project-level metrics from state.json data.
- *
- * @param {Object} state - Parsed state.json content
- * @returns {Object} Aggregated metrics
- */
-export function aggregateProjectMetrics(state) {
-  const features = state?.features || {};
-  const featureNames = Object.keys(features);
-
-  const featureMetrics = featureNames.map(name => {
-    const f = features[name];
-    const tasks = f.tasks || {};
-    const taskIds = Object.keys(tasks);
-    const completedTasks = taskIds.filter(id => tasks[id]?.status === 'completed').length;
-    const dispatchLog = f.dispatchLog || [];
-
-    return {
-      name,
-      phase: f.phase || f.currentPhase || 'unknown',
-      taskCount: taskIds.length,
-      completedTasks,
-      dispatchCount: dispatchLog.length,
-    };
-  });
-
-  const totalFeatures = featureMetrics.length;
-  const completedFeatures = featureMetrics.filter(f => f.phase === 'review').length;
-  const totalTasks = featureMetrics.reduce((sum, f) => sum + f.taskCount, 0);
-  const completedTasks = featureMetrics.reduce((sum, f) => sum + f.completedTasks, 0);
-  const totalDispatches = featureMetrics.reduce((sum, f) => sum + f.dispatchCount, 0);
-  const completionRate = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
-  const avgTasksPerFeature = totalFeatures > 0 ? Math.round((totalTasks / totalFeatures) * 10) / 10 : 0;
-
-  return {
-    version: state?.version || 'unknown',
-    updatedAt: new Date().toISOString(),
-    summary: {
-      totalFeatures,
-      completedFeatures,
-      avgTasksPerFeature,
-      totalTasks,
-      completedTasks,
-      completionRate,
-      totalDispatches,
-    },
-    features: featureMetrics,
-  };
-}
+/**
+ * Project-level metrics aggregator
+ *
+ * Aggregates feature-level data from state.json into a project-wide
+ * metrics summary. Pure computation — no I/O.
+ */
+
+/**
+ * Aggregate project-level metrics from state.json data.
+ *
+ * @param {Object} state - Parsed state.json content
+ * @returns {Object} Aggregated metrics
+ */
+export function aggregateProjectMetrics(state) {
+  const features = state?.features || {};
+  const featureNames = Object.keys(features);
+
+  const featureMetrics = featureNames.map(name => {
+    const f = features[name];
+    const tasks = f.tasks || {};
+    const taskIds = Object.keys(tasks);
+    const completedTasks = taskIds.filter(id => tasks[id]?.status === 'completed').length;
+    const dispatchLog = f.dispatchLog || [];
+
+    return {
+      name,
+      phase: f.phase || f.currentPhase || 'unknown',
+      taskCount: taskIds.length,
+      completedTasks,
+      dispatchCount: dispatchLog.length,
+    };
+  });
+
+  const totalFeatures = featureMetrics.length;
+  const completedFeatures = featureMetrics.filter(f => f.phase === 'review').length;
+  const totalTasks = featureMetrics.reduce((sum, f) => sum + f.taskCount, 0);
+  const completedTasks = featureMetrics.reduce((sum, f) => sum + f.completedTasks, 0);
+  const totalDispatches = featureMetrics.reduce((sum, f) => sum + f.dispatchCount, 0);
+  const completionRate = totalTasks > 0 ? Math.round((completedTasks / totalTasks) * 100) : 0;
+  const avgTasksPerFeature = totalFeatures > 0 ? Math.round((totalTasks / totalFeatures) * 10) / 10 : 0;
+
+  return {
+    version: state?.version || 'unknown',
+    updatedAt: new Date().toISOString(),
+    summary: {
+      totalFeatures,
+      completedFeatures,
+      avgTasksPerFeature,
+      totalTasks,
+      completedTasks,
+      completionRate,
+      totalDispatches,
+    },
+    features: featureMetrics,
+  };
+}

package/src/lib/agents/metrics-calculator.js

@@ -1,125 +1,125 @@
-/**
- * Agent Metrics Calculator — Pure computation, no I/O.
- *
- * Calculates per-agent performance metrics from dispatch log entries.
- */
-
-/**
- * Calculate per-agent metrics from dispatch log entries.
- * @param {Array} dispatchLog - Array of dispatch entries
- * @returns {{ agents: Array, summary: Object }}
- */
-export function calculateMetrics(dispatchLog) {
-  if (!Array.isArray(dispatchLog) || dispatchLog.length === 0) {
-    return {
-      agents: [],
-      summary: { totalDispatches: 0, totalTasks: 0, completedTasks: 0, completionRate: 0, avgTaskDurationMs: null }
-    };
-  }
-
-  const agentMap = new Map();
-
-  for (const entry of dispatchLog) {
-    for (const agent of entry.agents || []) {
-      if (!agentMap.has(agent.id)) {
-        agentMap.set(agent.id, { dispatches: 0, tasksAssigned: 0, tasksCompleted: 0, durations: [] });
-      }
-      const acc = agentMap.get(agent.id);
-      acc.dispatches += 1;
-      acc.tasksAssigned += (agent.tasks || []).length;
-      acc.tasksCompleted += (agent.tasksCompleted || []).length;
-
-      if (agent.startedAt && agent.completedAt) {
-        const start = new Date(agent.startedAt).getTime();
-        const end = new Date(agent.completedAt).getTime();
-        if (!isNaN(start) && !isNaN(end) && end >= start) {
-          acc.durations.push(end - start);
-        }
-      }
-    }
-  }
-
-  const agents = [];
-  let totalDurationAll = 0;
-  let agentsWithDuration = 0;
-
-  for (const [id, acc] of agentMap) {
-    const totalDurationMs = acc.durations.length > 0
-      ? acc.durations.reduce((s, d) => s + d, 0)
-      : null;
-    const avgDurationMs = acc.durations.length > 0
-      ? Math.round(totalDurationMs / acc.durations.length)
-      : null;
-
-    if (totalDurationMs !== null) {
-      totalDurationAll += totalDurationMs;
-      agentsWithDuration++;
-    }
-
-    agents.push({
-      id,
-      dispatches: acc.dispatches,
-      tasksAssigned: acc.tasksAssigned,
-      tasksCompleted: acc.tasksCompleted,
-      completionRate: acc.tasksAssigned > 0 ? acc.tasksCompleted / acc.tasksAssigned : 0,
-      avgDurationMs,
-      totalDurationMs
-    });
-  }
-
-  agents.sort((a, b) => b.tasksCompleted - a.tasksCompleted);
-
-  const totalTasks = agents.reduce((s, a) => s + a.tasksAssigned, 0);
-  const completedTasks = agents.reduce((s, a) => s + a.tasksCompleted, 0);
-
-  return {
-    agents,
-    summary: {
-      totalDispatches: dispatchLog.length,
-      totalTasks,
-      completedTasks,
-      completionRate: totalTasks > 0 ? completedTasks / totalTasks : 0,
-      avgTaskDurationMs: completedTasks > 0 && totalDurationAll > 0
-        ? Math.round(totalDurationAll / completedTasks)
-        : null
-    }
-  };
-}
-
-/**
- * Format milliseconds as human-readable duration.
- * @param {number|null} ms
- * @returns {string}
- */
-export function formatDuration(ms) {
-  if (ms == null || ms < 0) return '\u2014';
-  if (ms === 0) return '0s';
-
-  const totalSeconds = Math.floor(ms / 1000);
-  const hours = Math.floor(totalSeconds / 3600);
-  const minutes = Math.floor((totalSeconds % 3600) / 60);
-  const seconds = totalSeconds % 60;
-
-  if (hours > 0) return `${hours}h ${minutes}m`;
-  if (minutes > 0) return `${minutes}m`;
-  return `${seconds}s`;
-}
-
-/**
- * Calculate cross-feature aggregated metrics.
- * @param {Object} features - state.features object
- * @returns {{ agents: Array, summary: Object, featureCount: number }}
- */
-export function calculateAggregatedMetrics(features) {
-  const allEntries = [];
-  let featureCount = 0;
-
-  for (const feature of Object.values(features || {})) {
-    featureCount++;
-    const log = feature.dispatchLog || [];
-    allEntries.push(...log);
-  }
-
-  const result = calculateMetrics(allEntries);
-  return { ...result, featureCount };
-}
+/**
+ * Agent Metrics Calculator — Pure computation, no I/O.
+ *
+ * Calculates per-agent performance metrics from dispatch log entries.
+ */
+
+/**
+ * Calculate per-agent metrics from dispatch log entries.
+ * @param {Array} dispatchLog - Array of dispatch entries
+ * @returns {{ agents: Array, summary: Object }}
+ */
+export function calculateMetrics(dispatchLog) {
+  if (!Array.isArray(dispatchLog) || dispatchLog.length === 0) {
+    return {
+      agents: [],
+      summary: { totalDispatches: 0, totalTasks: 0, completedTasks: 0, completionRate: 0, avgTaskDurationMs: null }
+    };
+  }
+
+  const agentMap = new Map();
+
+  for (const entry of dispatchLog) {
+    for (const agent of entry.agents || []) {
+      if (!agentMap.has(agent.id)) {
+        agentMap.set(agent.id, { dispatches: 0, tasksAssigned: 0, tasksCompleted: 0, durations: [] });
+      }
+      const acc = agentMap.get(agent.id);
+      acc.dispatches += 1;
+      acc.tasksAssigned += (agent.tasks || []).length;
+      acc.tasksCompleted += (agent.tasksCompleted || []).length;
+
+      if (agent.startedAt && agent.completedAt) {
+        const start = new Date(agent.startedAt).getTime();
+        const end = new Date(agent.completedAt).getTime();
+        if (!isNaN(start) && !isNaN(end) && end >= start) {
+          acc.durations.push(end - start);
+        }
+      }
+    }
+  }
+
+  const agents = [];
+  let totalDurationAll = 0;
+  let agentsWithDuration = 0;
+
+  for (const [id, acc] of agentMap) {
+    const totalDurationMs = acc.durations.length > 0
+      ? acc.durations.reduce((s, d) => s + d, 0)
+      : null;
+    const avgDurationMs = acc.durations.length > 0
+      ? Math.round(totalDurationMs / acc.durations.length)
+      : null;
+
+    if (totalDurationMs !== null) {
+      totalDurationAll += totalDurationMs;
+      agentsWithDuration++;
+    }
+
+    agents.push({
+      id,
+      dispatches: acc.dispatches,
+      tasksAssigned: acc.tasksAssigned,
+      tasksCompleted: acc.tasksCompleted,
+      completionRate: acc.tasksAssigned > 0 ? acc.tasksCompleted / acc.tasksAssigned : 0,
+      avgDurationMs,
+      totalDurationMs
+    });
+  }
+
+  agents.sort((a, b) => b.tasksCompleted - a.tasksCompleted);
+
+  const totalTasks = agents.reduce((s, a) => s + a.tasksAssigned, 0);
+  const completedTasks = agents.reduce((s, a) => s + a.tasksCompleted, 0);
+
+  return {
+    agents,
+    summary: {
+      totalDispatches: dispatchLog.length,
+      totalTasks,
+      completedTasks,
+      completionRate: totalTasks > 0 ? completedTasks / totalTasks : 0,
+      avgTaskDurationMs: completedTasks > 0 && totalDurationAll > 0
+        ? Math.round(totalDurationAll / completedTasks)
+        : null
+    }
+  };
+}
+
+/**
+ * Format milliseconds as human-readable duration.
+ * @param {number|null} ms
+ * @returns {string}
+ */
+export function formatDuration(ms) {
+  if (ms == null || ms < 0) return '\u2014';
+  if (ms === 0) return '0s';
+
+  const totalSeconds = Math.floor(ms / 1000);
+  const hours = Math.floor(totalSeconds / 3600);
+  const minutes = Math.floor((totalSeconds % 3600) / 60);
+  const seconds = totalSeconds % 60;
+
+  if (hours > 0) return `${hours}h ${minutes}m`;
+  if (minutes > 0) return `${minutes}m`;
+  return `${seconds}s`;
+}
+
+/**
+ * Calculate cross-feature aggregated metrics.
+ * @param {Object} features - state.features object
+ * @returns {{ agents: Array, summary: Object, featureCount: number }}
+ */
+export function calculateAggregatedMetrics(features) {
+  const allEntries = [];
+  let featureCount = 0;
+
+  for (const feature of Object.values(features || {})) {
+    featureCount++;
+    const log = feature.dispatchLog || [];
+    allEntries.push(...log);
+  }
+
+  const result = calculateMetrics(allEntries);
+  return { ...result, featureCount };
+}

package/src/lib/agents/output-collector.js

@@ -1,73 +1,73 @@
-/**
- * output-collector — Collect phase output files for multi-source agent detection
- *
- * Reads all existing phase outputs for a feature and returns them as
- * weighted TextSource[] for use in detectAgents().
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { OUTPUT_SCHEMA, getAbsoluteOutputPath } from '../../core/paths/output-schema.js';
-
-/**
- * Default source weights per output type.
- * Keys match OUTPUT_SCHEMA keys (camelCase).
- */
-export const SOURCE_WEIGHTS = {
-  proposal:       1.0,
-  stackScan:      0.8,
-  migrationPlan:  0.8,
-  spec:           1.5,
-  mandate:        1.3,
-  tasks:          1.3,
-  decisions:      1.0,
-  uiDesignSystem: 1.0,
-  uiMockups:      1.0,
-  uiComponents:   1.0,
-  uiFlows:        1.0,
-  recap:          1.0,
-  reviewReport:   1.0,
-};
-
-/** Phase order for sorting collected outputs (v5 NLH model) */
-const PHASE_ORDER = ['proposal', 'uiux', 'plan', 'implement', 'review'];
-
-/**
- * Collect all existing phase output files for a feature.
- *
- * @param {string} projectRoot - Absolute path to project root
- * @param {string} featureName - Feature name
- * @returns {Array<{source: string, content: string, weight: number}>}
- */
-export function collectPhaseOutputs(projectRoot, featureName) {
-  const results = [];
-
-  for (const [key, entry] of Object.entries(OUTPUT_SCHEMA)) {
-    const absPath = getAbsoluteOutputPath(projectRoot, featureName, key);
-    if (!existsSync(absPath)) continue;
-
-    try {
-      const content = readFileSync(absPath, 'utf8');
-      if (!content.trim()) continue; // Skip empty files
-
-      results.push({
-        source: entry.filename,
-        content,
-        weight: SOURCE_WEIGHTS[key] ?? 1.0,
-        _phase: entry.phase,
-      });
-    } catch {
-      // Skip unreadable files — fail-open
-      continue;
-    }
-  }
-
-  // Sort by phase order
-  results.sort((a, b) => {
-    const orderA = PHASE_ORDER.indexOf(a._phase);
-    const orderB = PHASE_ORDER.indexOf(b._phase);
-    return (orderA === -1 ? 99 : orderA) - (orderB === -1 ? 99 : orderB);
-  });
-
-  // Remove internal _phase field
-  return results.map(({ source, content, weight }) => ({ source, content, weight }));
-}
+/**
+ * output-collector — Collect phase output files for multi-source agent detection
+ *
+ * Reads all existing phase outputs for a feature and returns them as
+ * weighted TextSource[] for use in detectAgents().
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { OUTPUT_SCHEMA, getAbsoluteOutputPath } from '../../core/paths/output-schema.js';
+
+/**
+ * Default source weights per output type.
+ * Keys match OUTPUT_SCHEMA keys (camelCase).
+ */
+export const SOURCE_WEIGHTS = {
+  proposal:       1.0,
+  stackScan:      0.8,
+  migrationPlan:  0.8,
+  spec:           1.5,
+  mandate:        1.3,
+  tasks:          1.3,
+  decisions:      1.0,
+  uiDesignSystem: 1.0,
+  uiMockups:      1.0,
+  uiComponents:   1.0,
+  uiFlows:        1.0,
+  recap:          1.0,
+  reviewReport:   1.0,
+};
+
+/** Phase order for sorting collected outputs (v5 NLH model) */
+const PHASE_ORDER = ['proposal', 'uiux', 'plan', 'implement', 'review'];
+
+/**
+ * Collect all existing phase output files for a feature.
+ *
+ * @param {string} projectRoot - Absolute path to project root
+ * @param {string} featureName - Feature name
+ * @returns {Array<{source: string, content: string, weight: number}>}
+ */
+export function collectPhaseOutputs(projectRoot, featureName) {
+  const results = [];
+
+  for (const [key, entry] of Object.entries(OUTPUT_SCHEMA)) {
+    const absPath = getAbsoluteOutputPath(projectRoot, featureName, key);
+    if (!existsSync(absPath)) continue;
+
+    try {
+      const content = readFileSync(absPath, 'utf8');
+      if (!content.trim()) continue; // Skip empty files
+
+      results.push({
+        source: entry.filename,
+        content,
+        weight: SOURCE_WEIGHTS[key] ?? 1.0,
+        _phase: entry.phase,
+      });
+    } catch {
+      // Skip unreadable files — fail-open
+      continue;
+    }
+  }
+
+  // Sort by phase order
+  results.sort((a, b) => {
+    const orderA = PHASE_ORDER.indexOf(a._phase);
+    const orderB = PHASE_ORDER.indexOf(b._phase);
+    return (orderA === -1 ? 99 : orderA) - (orderB === -1 ? 99 : orderB);
+  });
+
+  // Remove internal _phase field
+  return results.map(({ source, content, weight }) => ({ source, content, weight }));
+}