@polymorphism-tech/morph-spec 7.2.0 → 7.4.0

package/src/dashboard/app/App.jsx

@@ -1,31 +1,29 @@
-import { Routes, Route, Navigate } from 'react-router-dom';
-import Sidebar from './components/Sidebar.jsx';
-import AgentMap from './pages/AgentMap.jsx';
-import PhasePipeline from './pages/PhasePipeline.jsx';
-import HookInspector from './pages/HookInspector.jsx';
-import SkillsLibrary from './pages/SkillsLibrary.jsx';
-import RulesMap from './pages/RulesMap.jsx';
-import Standards from './pages/Standards.jsx';
-import Workflows from './pages/Workflows.jsx';
-import LiveState from './pages/LiveState.jsx';
-
-export default function App() {
-  return (
-    <div className="flex h-screen bg-gray-950 text-gray-100 overflow-hidden">
-      <Sidebar />
-      <main className="flex-1 overflow-auto">
-        <Routes>
-          <Route path="/" element={<Navigate to="/agents" replace />} />
-          <Route path="/agents" element={<AgentMap />} />
-          <Route path="/phases" element={<PhasePipeline />} />
-          <Route path="/hooks" element={<HookInspector />} />
-          <Route path="/skills" element={<SkillsLibrary />} />
-          <Route path="/rules" element={<RulesMap />} />
-          <Route path="/standards" element={<Standards />} />
-          <Route path="/workflows" element={<Workflows />} />
-          <Route path="/state" element={<LiveState />} />
-        </Routes>
-      </main>
-    </div>
-  );
-}
+import { Routes, Route, Navigate } from 'react-router-dom';
+import Sidebar from './components/Sidebar.jsx';
+import AgentMap from './pages/AgentMap.jsx';
+import PhasePipeline from './pages/PhasePipeline.jsx';
+import HookInspector from './pages/HookInspector.jsx';
+import SkillsLibrary from './pages/SkillsLibrary.jsx';
+import RulesMap from './pages/RulesMap.jsx';
+import Standards from './pages/Standards.jsx';
+import LiveState from './pages/LiveState.jsx';
+
+export default function App() {
+  return (
+    <div className="flex h-screen bg-gray-950 text-gray-100 overflow-hidden">
+      <Sidebar />
+      <main className="flex-1 overflow-auto">
+        <Routes>
+          <Route path="/" element={<Navigate to="/agents" replace />} />
+          <Route path="/agents" element={<AgentMap />} />
+          <Route path="/phases" element={<PhasePipeline />} />
+          <Route path="/hooks" element={<HookInspector />} />
+          <Route path="/skills" element={<SkillsLibrary />} />
+          <Route path="/rules" element={<RulesMap />} />
+          <Route path="/standards" element={<Standards />} />
+          <Route path="/state" element={<LiveState />} />
+        </Routes>
+      </main>
+    </div>
+  );
+}

package/src/dashboard/app/components/Sidebar.jsx

@@ -1,45 +1,44 @@
-import { NavLink } from 'react-router-dom';
-
-const NAV_ITEMS = [
-  { to: '/agents', label: 'Agent Map', icon: '🗺️' },
-  { to: '/phases', label: 'Phases', icon: '⚡' },
-  { to: '/hooks', label: 'Hooks', icon: '🔗' },
-  { to: '/skills', label: 'Skills', icon: '🧩' },
-  { to: '/rules', label: 'Rules', icon: '📏' },
-  { to: '/standards', label: 'Standards', icon: '📋' },
-  { to: '/workflows', label: 'Workflows', icon: '🔄' },
-  { to: '/state', label: 'Live State', icon: '📊' },
-];
-
-export default function Sidebar() {
-  return (
-    <nav className="w-52 flex-shrink-0 bg-gray-900 border-r border-gray-800 flex flex-col">
-      <div className="px-4 py-4 border-b border-gray-800">
-        <h1 className="text-sm font-semibold text-gray-300 tracking-wide uppercase">
-          morph-spec
-        </h1>
-        <p className="text-xs text-gray-500 mt-0.5">Dashboard</p>
-      </div>
-      <ul className="flex-1 py-2">
-        {NAV_ITEMS.map(({ to, label, icon }) => (
-          <li key={to}>
-            <NavLink
-              to={to}
-              className={({ isActive }) =>
-                [
-                  'flex items-center gap-2.5 px-4 py-2 text-sm transition-colors',
-                  isActive
-                    ? 'bg-blue-900/40 border-r-2 border-blue-500 text-blue-300'
-                    : 'text-gray-400 hover:bg-gray-800 hover:text-gray-200',
-                ].join(' ')
-              }
-            >
-              <span className="text-base leading-none">{icon}</span>
-              <span>{label}</span>
-            </NavLink>
-          </li>
-        ))}
-      </ul>
-    </nav>
-  );
-}
+import { NavLink } from 'react-router-dom';
+
+const NAV_ITEMS = [
+  { to: '/agents', label: 'Agent Map', icon: '🗺️' },
+  { to: '/phases', label: 'Phases', icon: '⚡' },
+  { to: '/hooks', label: 'Hooks', icon: '🔗' },
+  { to: '/skills', label: 'Skills', icon: '🧩' },
+  { to: '/rules', label: 'Rules', icon: '📏' },
+  { to: '/standards', label: 'Standards', icon: '📋' },
+  { to: '/state', label: 'Live State', icon: '📊' },
+];
+
+export default function Sidebar() {
+  return (
+    <nav className="w-52 flex-shrink-0 bg-gray-900 border-r border-gray-800 flex flex-col">
+      <div className="px-4 py-4 border-b border-gray-800">
+        <h1 className="text-sm font-semibold text-gray-300 tracking-wide uppercase">
+          morph-spec
+        </h1>
+        <p className="text-xs text-gray-500 mt-0.5">Dashboard</p>
+      </div>
+      <ul className="flex-1 py-2">
+        {NAV_ITEMS.map(({ to, label, icon }) => (
+          <li key={to}>
+            <NavLink
+              to={to}
+              className={({ isActive }) =>
+                [
+                  'flex items-center gap-2.5 px-4 py-2 text-sm transition-colors',
+                  isActive
+                    ? 'bg-blue-900/40 border-r-2 border-blue-500 text-blue-300'
+                    : 'text-gray-400 hover:bg-gray-800 hover:text-gray-200',
+                ].join(' ')
+              }
+            >
+              <span className="text-base leading-none">{icon}</span>
+              <span>{label}</span>
+            </NavLink>
+          </li>
+        ))}
+      </ul>
+    </nav>
+  );
+}

package/src/dashboard/scanner/index.js

@@ -1,21 +1,20 @@
-import { scanAgents } from './agents-scanner.js';
-import { scanPhases } from './phases-scanner.js';
-import { scanHooks } from './hooks-scanner.js';
-import { scanSkills } from './skills-scanner.js';
-import { scanStandards } from './standards-scanner.js';
-import { scanWorkflows } from './workflows-scanner.js';
-import { scanRules } from './rules-scanner.js';
-import { scanSquads } from './squads-scanner.js';
-import { scanRubrics } from './rubrics-scanner.js';
-import { scanState } from './state-scanner.js';
-
-export function scanAll(frameworkDir, projectDir) {
-  const agents = scanAgents(frameworkDir);
-  return {
-    agents, phases: scanPhases(frameworkDir), hooks: scanHooks(frameworkDir),
-    skills: scanSkills(frameworkDir), standards: scanStandards(frameworkDir, agents.list),
-    workflows: scanWorkflows(frameworkDir), rules: scanRules(frameworkDir),
-    squads: scanSquads(frameworkDir), rubrics: scanRubrics(frameworkDir),
-    liveState: scanState(projectDir || process.cwd()),
-  };
-}
+import { scanAgents } from './agents-scanner.js';
+import { scanPhases } from './phases-scanner.js';
+import { scanHooks } from './hooks-scanner.js';
+import { scanSkills } from './skills-scanner.js';
+import { scanStandards } from './standards-scanner.js';
+import { scanRules } from './rules-scanner.js';
+import { scanSquads } from './squads-scanner.js';
+import { scanRubrics } from './rubrics-scanner.js';
+import { scanState } from './state-scanner.js';
+
+export function scanAll(frameworkDir, projectDir) {
+  const agents = scanAgents(frameworkDir);
+  return {
+    agents, phases: scanPhases(frameworkDir), hooks: scanHooks(frameworkDir),
+    skills: scanSkills(frameworkDir), standards: scanStandards(frameworkDir, agents.list),
+    rules: scanRules(frameworkDir),
+    squads: scanSquads(frameworkDir), rubrics: scanRubrics(frameworkDir),
+    liveState: scanState(projectDir || process.cwd()),
+  };
+}

package/src/lib/context/context-builder.js

@@ -144,11 +144,11 @@ export function buildAgentDigests(agentId) {
 }
 
 /**
- * Extract FR IDs from a task's title/body in tasks.md format.
- * Format: ### T001 — Title [FR001, FR003]
+ * Extract FR IDs referenced by a task. Reads `[FR001, FR003]` markers from the
+ * task title and any `FR...` references in the task description/body.
  *
  * @param {string} taskTitle - Task title that may contain [FR...] references
- * @param {string} [taskBlock] - Full task block for body references
+ * @param {string} [taskBlock] - Task description/body for further references
  * @returns {string[]}
  */
 export function extractFRIds(taskTitle, taskBlock) {

package/src/lib/generators/context-generator.js

@@ -347,7 +347,7 @@ export async function generateFeatureContext(projectPath, featureName) {
   }
 
   try {
-    const tasksPath = path.join(outputsDir, '2-plan', 'tasks.md');
+    const tasksPath = path.join(outputsDir, '2-plan', 'tasks.json');
     const tasksContent = await fs.readFile(tasksPath, 'utf8');
     tasks = JSON.parse(tasksContent).tasks || [];
   } catch (err) {
@@ -380,7 +380,6 @@ export async function generateFeatureContext(projectPath, featureName) {
   const data = {
     FEATURE_NAME: feature.name,
     PHASE: feature.phase,
-    WORKFLOW_TYPE: feature.workflow || 'standard',
     STATUS: feature.status,
     COMPLEXITY: feature.complexity || 'medium',
     DESCRIPTION: feature.description || '',
@@ -460,7 +459,7 @@ export async function generateFeatureContext(projectPath, featureName) {
     PROPOSAL_PATH: getOutputPath(featureName, 'proposal'),
     SPEC_PATH: getOutputPath(featureName, 'spec'),
     CONTRACTS_PATH: getOutputPath(featureName, 'contracts'),
-    TASKS_PATH: `.morph/features/${featureName}/2-plan/tasks.md`,
+    TASKS_PATH: `.morph/features/${featureName}/2-plan/tasks.json`,
     DECISIONS_PATH: getOutputPath(featureName, 'decisions'),
     RECAP_PATH: getOutputPath(featureName, 'recap'),
 

package/src/lib/generators/mandate-generator.js

@@ -1,8 +1,9 @@
 /**
  * Implementation Mandate Generator
  *
- * Synthesizes all spec phase outputs (spec.md, contracts, plan.md, tasks.md,
- * decisions.md) into a single task-structured implementation mandate.
+ * Synthesizes the plan-phase outputs (spec.md, tasks.json, decisions.md) into
+ * a single task-structured implementation mandate. Contracts are read from
+ * spec.md (v5 keeps contracts inside the spec, not in separate files).
  *
  * The mandate is the primary context artifact for the implement phase —
  * each task section is self-contained with acceptance criteria, contracts,
@@ -11,17 +12,28 @@
 
 import { readFileSync, existsSync } from 'fs';
 import { join } from 'path';
+import { validateTasksJson } from '../tasks/tasks-json-parser.js';
 
 /**
- * v5: parseTaskFromMarkdown lived in sprint-contract-generator. Inlined here.
+ * Resolve a single task object from parsed tasks.json data.
+ * FR references are extracted from the task `description` (v5 convention:
+ * tasks reference their FR(s) inline in the description).
+ *
+ * @param {object} tasksData - Parsed tasks.json structure
+ * @param {string} taskId - Task id (e.g. 'T1')
+ * @returns {{ id: string, title: string, description: string, frs: string[] }|null}
  */
-function parseTaskFromMarkdown(tasksContent, taskId) {
-  const headingRe = new RegExp(`^### ${taskId}\\b[^\\n]*\\n([\\s\\S]*?)(?=^### |\\Z)`, 'm');
-  const match = tasksContent.match(headingRe);
-  if (!match) return null;
-  const block = match[1];
-  const frRefs = [...block.matchAll(/\bFR-?\d+\b/g)].map(m => m[0]);
-  return { id: taskId, frs: [...new Set(frRefs)], block };
+function resolveTask(tasksData, taskId) {
+  const task = tasksData.tasks.find(t => t.id === taskId);
+  if (!task) return null;
+  const frRefs = [...(task.description || '').matchAll(/\bFR-?\d+\b/g)].map(m => m[0]);
+  return {
+    id: task.id,
+    title: task.title || '',
+    description: task.description || '',
+    frs: [...new Set(frRefs)],
+    files: Array.isArray(task.outputs) ? task.outputs : [],
+  };
 }
 
 /**
@@ -30,7 +42,7 @@ function parseTaskFromMarkdown(tasksContent, taskId) {
  * @param {string} specContent - Full spec.md content
  * @returns {Map<string, { title: string, content: string, criteria: string[] }>}
  */
-export function parseFRSections(specContent) {
+function parseFRSections(specContent) {
   const sections = new Map();
   const frPattern = /^##\s+(FR\d+)[:\s—–-]+(.+?)$/gm;
   let match;
@@ -69,13 +81,14 @@ export function parseFRSections(specContent) {
 }
 
 /**
- * Extract contract types/interfaces from contracts file content.
- * Matches C# records, classes, interfaces and TypeScript types/interfaces.
+ * Extract contract types/interfaces from content. Matches C# records, classes,
+ * interfaces and TypeScript types/interfaces — v5 contracts are defined inside
+ * spec.md, so this scans the spec content.
  *
- * @param {string} contractsContent - Full contracts.cs or contracts.ts content
+ * @param {string} contractsContent - Content to scan for contract definitions
  * @returns {Map<string, string>} Map of type name → definition
  */
-export function parseContracts(contractsContent) {
+function parseContracts(contractsContent) {
   const types = new Map();
 
   // C# sealed records: sealed record Foo(...)
@@ -109,52 +122,13 @@ export function parseContracts(contractsContent) {
   return types;
 }
 
-/**
- * Extract file paths per task from plan.md.
- * Looks for task references followed by file paths.
- *
- * @param {string} planContent - Full plan.md content
- * @param {string} taskId - Task ID (e.g., 'T001')
- * @returns {string[]} File paths
- */
-export function extractTaskFilePaths(planContent, taskId) {
-  const paths = [];
-
-  // Look for task section in plan
-  const taskSectionPattern = new RegExp(
-    `(?:^|\\n).*${taskId}[^\\n]*\\n([\\s\\S]*?)(?=\\n(?:#+\\s|$)|$)`,
-    'i'
-  );
-  const sectionMatch = planContent.match(taskSectionPattern);
-  if (!sectionMatch) return paths;
-
-  const section = sectionMatch[1];
-  // Extract file paths (common patterns)
-  const filePatterns = [
-    /`([^`]+\.\w{1,6})`/g,                          // backtick-wrapped paths
-    /(?:^|\s)([\w/.]+\.(?:cs|ts|tsx|js|jsx|json|md|yaml|yml|csproj))/gm,  // bare paths
-  ];
-
-  for (const pattern of filePatterns) {
-    let fileMatch;
-    while ((fileMatch = pattern.exec(section)) !== null) {
-      const filePath = fileMatch[1].trim();
-      if (filePath.length > 3 && !paths.includes(filePath)) {
-        paths.push(filePath);
-      }
-    }
-  }
-
-  return paths;
-}
-
 /**
  * Extract architectural constraints from decisions.md.
  *
  * @param {string} decisionsContent - Full decisions.md content
  * @returns {string[]} One-line constraint summaries
  */
-export function parseDecisions(decisionsContent) {
+function parseDecisions(decisionsContent) {
   const constraints = [];
   const adrPattern = /^###?\s+(ADR-\d+)[:\s—–-]+(.+?)$/gm;
   let match;
@@ -167,21 +141,13 @@ export function parseDecisions(decisionsContent) {
 }
 
 /**
- * Extract all task IDs from tasks.md in order.
+ * Extract all task IDs from parsed tasks.json data, in declared order.
  *
- * @param {string} tasksContent - Full tasks.md content
- * @returns {string[]} Task IDs in order (e.g., ['T001', 'T002', ...])
+ * @param {object} tasksData - Parsed tasks.json structure
+ * @returns {string[]} Task IDs in order (e.g., ['T1', 'T2', ...])
  */
-export function extractTaskIds(tasksContent) {
-  const ids = [];
-  const pattern = /^##\s+(T\d+)[:\s]/gm;
-  let match;
-  while ((match = pattern.exec(tasksContent)) !== null) {
-    if (!ids.includes(match[1])) {
-      ids.push(match[1]);
-    }
-  }
-  return ids;
+function extractTaskIds(tasksData) {
+  return tasksData.tasks.map(t => t.id);
 }
 
 /**
@@ -227,29 +193,21 @@ export function generateMandate(projectPath, featureName) {
   const featureDir = join(projectPath, '.morph/features', featureName);
 
   // Read required files
-  const tasksPath = join(featureDir, '2-plan/tasks.md');
+  const tasksPath = join(featureDir, '2-plan/tasks.json');
   const specPath = join(featureDir, '2-plan/spec.md');
 
   if (!existsSync(tasksPath) || !existsSync(specPath)) return null;
 
-  const tasksContent = readFileSync(tasksPath, 'utf-8');
+  let tasksData;
+  try {
+    tasksData = JSON.parse(readFileSync(tasksPath, 'utf-8'));
+  } catch {
+    return null;
+  }
+  if (!validateTasksJson(tasksData).valid) return null;
   const specContent = readFileSync(specPath, 'utf-8');
 
   // Read optional files
-  const contractsPaths = [
-    join(featureDir, '2-plan/contracts.cs'),
-    join(featureDir, '2-plan/contracts.ts'),
-  ];
-  let contractsContent = '';
-  for (const cp of contractsPaths) {
-    if (existsSync(cp)) {
-      contractsContent += readFileSync(cp, 'utf-8') + '\n';
-    }
-  }
-
-  const planPath = join(featureDir, '2-plan/plan.md');
-  const planContent = existsSync(planPath) ? readFileSync(planPath, 'utf-8') : '';
-
   const decisionsPath = join(featureDir, '2-plan/decisions.md');
   const decisionsContent = existsSync(decisionsPath) ? readFileSync(decisionsPath, 'utf-8') : '';
 
@@ -259,22 +217,21 @@ export function generateMandate(projectPath, featureName) {
   // Read project config
   let stack = '';
   let architecture = '';
-  let workflow = '';
   try {
     const configPath = join(projectPath, '.morph/config/config.json');
     if (existsSync(configPath)) {
       const config = JSON.parse(readFileSync(configPath, 'utf-8'));
       stack = config?.project?.stack || '';
       architecture = config?.architecture?.style || '';
-      workflow = config?.workflow || '';
     }
   } catch { /* ignore */ }
 
-  // Parse all inputs
+  // Parse all inputs. v5: contracts live inside spec.md (no separate
+  // contracts.cs/.ts file) — parseContracts scans the spec content.
   const frSections = parseFRSections(specContent);
-  const contracts = parseContracts(contractsContent);
+  const contracts = parseContracts(specContent);
   const decisions = parseDecisions(decisionsContent);
-  const taskIds = extractTaskIds(tasksContent);
+  const taskIds = extractTaskIds(tasksData);
 
   // Build mandate
   const lines = [];
@@ -312,7 +269,7 @@ export function generateMandate(projectPath, featureName) {
 
   // Task sections
   for (const taskId of taskIds) {
-    const task = parseTaskFromMarkdown(tasksContent, taskId);
+    const task = resolveTask(tasksData, taskId);
     if (!task) continue;
 
     lines.push('');
@@ -323,8 +280,7 @@ export function generateMandate(projectPath, featureName) {
     // Metadata line
     const metaParts = [];
     if (task.frs.length > 0) metaParts.push(`**FRs:** ${task.frs.join(', ')}`);
-    const filePaths = planContent ? extractTaskFilePaths(planContent, taskId) : [];
-    if (filePaths.length > 0) metaParts.push(`**Files:** ${filePaths.join(', ')}`);
+    if (task.files.length > 0) metaParts.push(`**Files:** ${task.files.join(', ')}`);
     if (metaParts.length > 0) lines.push(metaParts.join(' | '));
 
     // Acceptance criteria from FR sections