@polymorphism-tech/morph-spec 8.38.0 → 8.41.0

package/src/dashboard/scanner/state-scanner.js

@@ -1,85 +0,0 @@
-import { readFileSync, existsSync, readdirSync } from 'fs';
-import { join } from 'path';
-import { WORKTREE_DIR_NAMES } from '../../commands/project/worktree.js';
-
-export function scanState(projectDir) {
-  const statePath = join(projectDir, '.morph', 'state.json');
-  let state = null;
-  if (existsSync(statePath)) {
-    try { state = JSON.parse(readFileSync(statePath, 'utf8')); } catch { state = null; }
-  }
-
-  // Hydrate full feature objects from the authoritative per-feature files. The
-  // root state.json is now a thin, derivable index (status + updatedAt only), so
-  // the dashboard must read .morph/features/{name}/feature.json for full data.
-  const featuresDir = join(projectDir, '.morph', 'features');
-  if (existsSync(featuresDir)) {
-    let names = [];
-    try {
-      names = readdirSync(featuresDir, { withFileTypes: true })
-        .filter((e) => e.isDirectory())
-        .map((e) => e.name);
-    } catch { names = []; }
-    for (const name of names) {
-      const fjPath = join(featuresDir, name, 'feature.json');
-      if (!existsSync(fjPath)) continue;
-      try {
-        const fj = JSON.parse(readFileSync(fjPath, 'utf8'));
-        state = state || { features: {} };
-        state.features = state.features || {};
-        state.features[name] = fj;
-      } catch { /* skip a corrupt feature.json */ }
-    }
-  }
-
-  // Aggregate in-progress features that only exist inside a feature worktree
-  // (worktrees/{wt}/.morph/features/*/feature.json). In the v8 multi-instance
-  // model a feature's authoritative feature.json is committed on its
-  // `morph/{feature}` branch and only lands in the root .morph/features/ after
-  // `morph-spec finish`. This is read-only visibility for the dashboard — root
-  // features (the merged, authoritative state) always take precedence, and
-  // worktree-sourced entries are tagged with `_worktree` so the UI can
-  // distinguish them.
-  //
-  // BOTH directory names are scanned: this scanner resolves worktrees by
-  // CONVENTION (unlike fleet/finish, which read `git worktree list`), so it is
-  // the one that would otherwise go blind to pre-C1 `.worktrees/` checkouts.
-  const worktreeDirs = WORKTREE_DIR_NAMES
-    .map((name) => join(projectDir, name))
-    .filter((dir) => existsSync(dir));
-
-  for (const worktreesDir of worktreeDirs) {
-    let worktreeNames = [];
-    try {
-      worktreeNames = readdirSync(worktreesDir, { withFileTypes: true })
-        .filter((e) => e.isDirectory())
-        .map((e) => e.name);
-    } catch { worktreeNames = []; }
-
-    for (const wt of worktreeNames) {
-      const wtFeaturesDir = join(worktreesDir, wt, '.morph', 'features');
-      if (!existsSync(wtFeaturesDir)) continue;
-      let wtFeatureNames = [];
-      try {
-        wtFeatureNames = readdirSync(wtFeaturesDir, { withFileTypes: true })
-          .filter((e) => e.isDirectory())
-          .map((e) => e.name);
-      } catch { continue; }
-
-      for (const name of wtFeatureNames) {
-        state = state || { features: {} };
-        state.features = state.features || {};
-        if (state.features[name]) continue; // root feature already present — it wins
-
-        const fjPath = join(wtFeaturesDir, name, 'feature.json');
-        if (!existsSync(fjPath)) continue;
-        try {
-          const fj = JSON.parse(readFileSync(fjPath, 'utf8'));
-          state.features[name] = { ...fj, _worktree: wt };
-        } catch { /* skip a corrupt feature.json */ }
-      }
-    }
-  }
-
-  return state;
-}

package/src/lib/generators/index.js

@@ -1,10 +0,0 @@
-/**
- * Code Generators
- *
- * Code and documentation generation utilities.
- */
-
-export * from './design-system-generator.js';
-export * from './handoff-generator.js';
-export * from './architecture-scanner.js';
-export * from './scaffold-generator.js';

package/src/lib/hooks/hook-executor.js

@@ -1,167 +0,0 @@
-/**
- * Hook Executor — Agent Teams hook validation
- *
- * Executes validation hooks triggered by Claude Code agent-teams events:
- *   TeammateIdle, TaskCompleted, PhaseAdvanced
- *
- * Reads agents.json to find validators with matching hook_triggers,
- * then runs each validator's checks against the current project state.
- *
- * @module hook-executor
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-// ============================================================================
-// Loaders
-// ============================================================================
-
-function loadAgents(projectPath) {
-  const agentPaths = [
-    join(projectPath, '.morph/framework/agents.json'),
-  ];
-
-  const allAgents = {};
-  for (const agentPath of agentPaths) {
-    if (existsSync(agentPath)) {
-      try {
-        const data = JSON.parse(readFileSync(agentPath, 'utf8'));
-        Object.assign(allAgents, data.agents || {});
-      } catch (e) { /* skip malformed files */ }
-    }
-  }
-  return allAgents;
-}
-
-function loadStateFeature(projectPath, featureName) {
-  const statePath = join(projectPath, '.morph/state.json');
-  if (!existsSync(statePath)) return null;
-
-  const state = JSON.parse(readFileSync(statePath, 'utf8'));
-  const features = state.features;
-
-  // Support both object format { featureName: {...} } and array format [{name, ...}]
-  if (Array.isArray(features)) {
-    return features.find(f => f.name === featureName) || null;
-  }
-  return features[featureName] || null;
-}
-
-// ============================================================================
-// Main Executor
-// ============================================================================
-
-/**
- * Execute agent-teams hook validation
- * @param {string} projectPath - Absolute path to project root
- * @param {string} featureName - Feature to validate
- * @param {string} hookEvent - Event name (TeammateIdle, TaskCompleted, PhaseAdvanced)
- * @param {Object} [opts]
- * @param {boolean} [opts.dryRun=false] - Identify validators without running them
- * @param {boolean} [opts.verbose=true] - Print results to console
- * @returns {Promise<Object>} { passed, blocked, errors, warnings }
- */
-export async function executeHook(projectPath, featureName, hookEvent, opts = {}) {
-  const { dryRun = false } = opts;
-
-  // Load feature state
-  const feature = loadStateFeature(projectPath, featureName);
-  if (!feature) {
-    return {
-      passed: false,
-      blocked: true,
-      errors: [`Feature not found: ${featureName}`],
-      warnings: []
-    };
-  }
-
-  // Load all available agents
-  const agents = loadAgents(projectPath);
-
-  // Filter: agents that run in hooks AND trigger on this event
-  const hookValidators = Object.entries(agents)
-    .filter(([, agent]) =>
-      agent.relationships?.runs_in === 'hooks' &&
-      Array.isArray(agent.relationships?.hook_triggers) &&
-      agent.relationships.hook_triggers.includes(hookEvent)
-    )
-    .map(([agentId, agent]) => ({ agentId, ...agent }));
-
-  // No validators configured for this event, or dry run — pass immediately
-  if (hookValidators.length === 0 || dryRun) {
-    return { passed: true, blocked: false, errors: [], warnings: [] };
-  }
-
-  // Run validators
-  // In production, each validator would execute its actual checks.
-  // This implementation returns pass since real validation requires external tooling.
-  const errors = [];
-  const warnings = [];
-
-  const passed = errors.length === 0;
-  const blocked = errors.some(e => typeof e === 'object' && e.blocksOnFail !== false);
-
-  return { passed, blocked, errors, warnings };
-}
-
-// ============================================================================
-// Formatter
-// ============================================================================
-
-/**
- * Format hook execution results as a human-readable string
- * @param {Object} results - Result from executeHook
- * @param {string} hookEvent - Event name
- * @returns {string} Formatted output
- */
-export function formatHookResults(results, hookEvent) {
-  const { passed, blocked, errors = [], warnings = [] } = results;
-  const lines = [];
-
-  if (!passed && errors.length > 0) {
-    lines.push(`❌ Hook: ${hookEvent}`);
-    lines.push('FAILED');
-    lines.push('ERRORS (blocking):');
-
-    for (const err of errors) {
-      if (err.issues && Array.isArray(err.issues)) {
-        for (const issue of err.issues) {
-          lines.push(`  ${issue.message}`);
-          if (issue.file && issue.line !== undefined) {
-            lines.push(`  ${issue.file}:${issue.line}`);
-          }
-        }
-      } else if (err.error) {
-        lines.push(`  Error: ${err.error}`);
-      } else if (typeof err === 'string') {
-        lines.push(`  ${err}`);
-      }
-    }
-
-    if (blocked) {
-      lines.push('BLOCKED');
-    }
-  } else if (warnings.length === 0) {
-    lines.push(`✅ Hook: ${hookEvent}`);
-    lines.push('All validators passed');
-  }
-
-  if (warnings.length > 0) {
-    lines.push(`⚠️ Hook: ${hookEvent}`);
-    lines.push('WARNINGS (non-blocking):');
-
-    for (const warn of warnings) {
-      if (warn.issues && Array.isArray(warn.issues)) {
-        for (const issue of warn.issues) {
-          lines.push(`  ${issue.message}`);
-          if (issue.file && issue.line !== undefined) {
-            lines.push(`  ${issue.file}:${issue.line}`);
-          }
-        }
-      }
-    }
-  }
-
-  return lines.join('\n');
-}

package/src/lib/validators/checkpoint-persistence.js

@@ -1,39 +0,0 @@
-/**
- * Checkpoint Validation Persistence
- *
- * Persists checkpoint validation results to disk for traceability.
- * Each checkpoint writes a JSON file to:
- *   .morph/features/{feature}/3-implement/validations/checkpoint-{N}.json
- */
-
-import { mkdirSync, writeFileSync } from 'fs';
-import { join } from 'path';
-
-/**
- * Persist a checkpoint validation result to disk.
- *
- * @param {string} projectPath - Project root
- * @param {string} featureName - Feature name
- * @param {{ checkpointNum: number, timestamp: string, passed: boolean, validators: Object, summary: string, feature?: string, phase?: string }} result - Validation result
- * @returns {string} Path to the saved JSON file
- */
-export function persistCheckpointValidation(projectPath, featureName, result) {
-  const dir = join(projectPath, `.morph/features/${featureName}/3-implement/validations`);
-  mkdirSync(dir, { recursive: true });
-
-  const filename = `checkpoint-${result.checkpointNum}.json`;
-  const filePath = join(dir, filename);
-
-  const output = {
-    checkpointNum: result.checkpointNum,
-    timestamp: result.timestamp || new Date().toISOString(),
-    passed: result.passed,
-    validators: result.validators || {},
-    summary: result.summary || '',
-    feature: result.feature || featureName,
-    phase: result.phase || 'implement',
-  };
-
-  writeFileSync(filePath, JSON.stringify(output, null, 2), 'utf8');
-  return filePath;
-}

package/src/lib/validators/shared/emit-validator-dispatch.js

@@ -1,14 +0,0 @@
-/**
- * Stub: validation dispatch was driven by tier-4 agents in v4.
- * In v5, validation is handled by morph-eval skill invoked directly
- * by the Evaluator role. This function is kept for call-site compatibility.
- *
- * @module emit-validator-dispatch
- */
-
-/**
- * No-op in v5. Validation dispatch is now handled by morph-eval skill.
- */
-export async function emitValidatorDispatch(_featureName, _phase, _cwd) {
-  // v5: evaluation driven by morph-eval skill, not CLI dispatch
-}

package/src/lib/validators/shared/index.js

@@ -1,12 +0,0 @@
-/**
- * Shared validator utilities
- *
- * Common functionality used across multiple validators.
- */
-
-export { countIssues } from './issue-counter.js';
-export {
-  formatValidationSummary,
-  formatValidationIssues,
-  formatValidationStatus,
-} from './result-formatter.js';

package/src/lib/validators/shared/issue-counter.js

@@ -1,14 +0,0 @@
-/**
- * Shared issue counting utility for validators
- *
- *
- * @param {Array} issues - Array of validation issues with type property
- * @returns {{errors: number, warnings: number, infos: number}} Count by type
- */
-export function countIssues(issues) {
-  return {
-    errors: issues.filter((i) => i.type === 'error').length,
-    warnings: issues.filter((i) => i.type === 'warning').length,
-    infos: issues.filter((i) => i.type === 'info').length,
-  };
-}

package/src/lib/validators/shared/result-formatter.js

@@ -1,124 +0,0 @@
-/**
- * Shared validation result formatting utilities
- *
- * Provides common formatting patterns for validation results.
- * Domain-specific formatters (CSS, template, etc.) can extend these.
- */
-
-import chalk from 'chalk';
-
-/**
- * Format a generic validation result summary
- *
- * @param {Object} summary - Validation summary object
- * @param {string} title - Title for the results section
- * @returns {string[]} Array of formatted lines
- */
-export function formatValidationSummary(summary, title = 'Validation Results') {
-  const lines = [];
-
-  lines.push('');
-  lines.push(title);
-  lines.push('='.repeat(50));
-  lines.push('');
-
-  // Format summary key-value pairs
-  for (const [key, value] of Object.entries(summary)) {
-    const label = key
-      .replace(/([A-Z])/g, ' $1')
-      .replace(/^./, str => str.toUpperCase())
-      .trim();
-    lines.push(`${label}: ${value}`);
-  }
-
-  lines.push('');
-
-  return lines;
-}
-
-/**
- * Format validation issues with consistent styling
- *
- * @param {Array} issues - Array of validation issues
- * @param {boolean} verbose - Include detailed output
- * @returns {string[]} Array of formatted issue lines
- */
-export function formatValidationIssues(issues, verbose = false) {
-  const lines = [];
-
-  if (issues.length === 0) {
-    return lines;
-  }
-
-  // Group by type
-  const errors = issues.filter(i => i.type === 'error');
-  const warnings = issues.filter(i => i.type === 'warning');
-
-  if (errors.length > 0) {
-    lines.push(chalk.red.bold(`Errors (${errors.length}):`));
-    lines.push('-'.repeat(50));
-    for (const issue of errors) {
-      lines.push(formatIssue(issue, verbose));
-    }
-    lines.push('');
-  }
-
-  if (warnings.length > 0) {
-    lines.push(chalk.yellow.bold(`Warnings (${warnings.length}):`));
-    lines.push('-'.repeat(50));
-    for (const issue of warnings) {
-      lines.push(formatIssue(issue, verbose));
-    }
-    lines.push('');
-  }
-
-  return lines;
-}
-
-/**
- * Format a single validation issue
- *
- * @param {Object} issue - Validation issue
- * @param {boolean} verbose - Include additional details
- * @returns {string} Formatted issue string
- */
-function formatIssue(issue, verbose = false) {
-  const color = issue.type === 'error' ? chalk.red : chalk.yellow;
-  const icon = issue.type === 'error' ? '✗' : '⚠';
-
-  let formatted = `  ${icon} ${issue.message}`;
-
-  if (issue.file) {
-    formatted += chalk.dim(` (${issue.file}`);
-    if (issue.line) {
-      formatted += `:${issue.line}`;
-    }
-    formatted += chalk.dim(')');
-  }
-
-  if (verbose && issue.suggestion) {
-    formatted += `\n    ${chalk.cyan('→')} ${issue.suggestion}`;
-  }
-
-  return formatted;
-}
-
-/**
- * Format final validation status
- *
- * @param {boolean} valid - Whether validation passed
- * @param {number} errorCount - Number of errors
- * @param {number} warningCount - Number of warnings
- * @returns {string} Status message with appropriate styling
- */
-export function formatValidationStatus(valid, errorCount = 0, warningCount = 0) {
-  if (valid && errorCount === 0 && warningCount === 0) {
-    return chalk.green('✓ All validations passed');
-  }
-
-  if (errorCount > 0) {
-    return chalk.red(`✗ Validation failed with ${errorCount} error(s) and ${warningCount} warning(s)`);
-  }
-
-  return chalk.yellow(`⚠ Validation passed with ${warningCount} warning(s)`);
-}