@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "2.4.0",
+  "version": "3.0.0",
   "description": "MORPH-SPEC v2.0: AI-First development framework with .NET 10, Microsoft Agent Framework, and Fluent UI Blazor",
   "keywords": [
     "claude-code",

package/scripts/postinstall.js

@@ -1,132 +1,132 @@
-#!/usr/bin/env node
-
-/**
- * Postinstall script for @polymorphism-tech/morph-spec
- *
- * Checks if morph-spec is accessible in PATH and warns users
- * if it's not (common issue with nvm-windows).
- */
-
-import { execSync } from 'child_process';
-import { platform } from 'os';
-import chalk from 'chalk';
-
-const isWindows = platform() === 'win32';
-
-/**
- * Check if morph-spec command is in PATH
- */
-function isMorphSpecInPath() {
-  try {
-    const command = isWindows ? 'where morph-spec' : 'which morph-spec';
-    execSync(command, { stdio: 'ignore' });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Detect if nvm-windows is installed
- */
-function isUsingNvmWindows() {
-  if (!isWindows) return false;
-
-  try {
-    const path = process.env.PATH || '';
-    return path.includes('nvm4w') || path.includes('\\nvm\\');
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Get npm global prefix
- */
-function getNpmGlobalPrefix() {
-  try {
-    const prefix = execSync('npm config get prefix', { encoding: 'utf8' }).trim();
-    return prefix;
-  } catch {
-    return null;
-  }
-}
-
-/**
- * Show installation success message
- */
-function showSuccessMessage() {
-  console.log('');
-  console.log(chalk.green('✓ @polymorphism-tech/morph-spec installed successfully!'));
-  console.log('');
-  console.log(chalk.cyan('Quick start:'));
-  console.log(chalk.white('  morph-spec init'));
-  console.log(chalk.white('  morph-spec --help'));
-  console.log('');
-}
-
-/**
- * Show PATH warning for nvm-windows users
- */
-function showPathWarning() {
-  console.log('');
-  console.log(chalk.yellow('⚠ Warning: morph-spec command not found in PATH'));
-  console.log('');
-
-  if (isUsingNvmWindows()) {
-    console.log(chalk.white('You are using nvm-windows, which does not automatically add'));
-    console.log(chalk.white('npm global packages to your PATH.'));
-    console.log('');
-    console.log(chalk.cyan('Solution 1: Add npm global directory to PATH'));
-
-    const prefix = getNpmGlobalPrefix();
-    if (prefix) {
-      console.log(chalk.white(`  Add this to your PATH: ${chalk.yellow(prefix)}`));
-      console.log('');
-      console.log(chalk.gray('  PowerShell (as Administrator):'));
-      console.log(chalk.white(`    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";${prefix}", "User")`));
-      console.log('');
-      console.log(chalk.gray('  Or manually via System Properties > Environment Variables'));
-    }
-
-    console.log('');
-    console.log(chalk.cyan('Solution 2: Use npx (recommended)'));
-    console.log(chalk.white('  npx @polymorphism-tech/morph-spec init'));
-    console.log(chalk.white('  npx @polymorphism-tech/morph-spec --help'));
-  } else {
-    console.log(chalk.white('The morph-spec command was not found in your PATH.'));
-    console.log('');
-    console.log(chalk.cyan('Solution: Use npx instead'));
-    console.log(chalk.white('  npx @polymorphism-tech/morph-spec init'));
-    console.log(chalk.white('  npx @polymorphism-tech/morph-spec --help'));
-  }
-
-  console.log('');
-  console.log(chalk.gray('For more help, see: https://github.com/lucasPolymorphism/morph-spec-framework#troubleshooting'));
-  console.log('');
-}
-
-/**
- * Main postinstall check
- */
-function main() {
-  // Only show messages for global installs
-  // Skip for local installs (when used as dependency)
-  const isGlobalInstall = process.env.npm_config_global === 'true';
-
-  if (!isGlobalInstall) {
-    // Silent exit for local installs
-    return;
-  }
-
-  // Give npm a moment to set up the symlinks
-  setTimeout(() => {
-    if (isMorphSpecInPath()) {
-      showSuccessMessage();
-    } else {
-      showPathWarning();
-    }
-  }, 100);
-}
-
-main();
+#!/usr/bin/env node
+
+/**
+ * Postinstall script for @polymorphism-tech/morph-spec
+ *
+ * Checks if morph-spec is accessible in PATH and warns users
+ * if it's not (common issue with nvm-windows).
+ */
+
+import { execSync } from 'child_process';
+import { platform } from 'os';
+import chalk from 'chalk';
+
+const isWindows = platform() === 'win32';
+
+/**
+ * Check if morph-spec command is in PATH
+ */
+function isMorphSpecInPath() {
+  try {
+    const command = isWindows ? 'where morph-spec' : 'which morph-spec';
+    execSync(command, { stdio: 'ignore' });
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Detect if nvm-windows is installed
+ */
+function isUsingNvmWindows() {
+  if (!isWindows) return false;
+
+  try {
+    const path = process.env.PATH || '';
+    return path.includes('nvm4w') || path.includes('\\nvm\\');
+  } catch {
+    return false;
+  }
+}
+
+/**
+ * Get npm global prefix
+ */
+function getNpmGlobalPrefix() {
+  try {
+    const prefix = execSync('npm config get prefix', { encoding: 'utf8' }).trim();
+    return prefix;
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * Show installation success message
+ */
+function showSuccessMessage() {
+  console.log('');
+  console.log(chalk.green('✓ @polymorphism-tech/morph-spec installed successfully!'));
+  console.log('');
+  console.log(chalk.cyan('Quick start:'));
+  console.log(chalk.white('  morph-spec init'));
+  console.log(chalk.white('  morph-spec --help'));
+  console.log('');
+}
+
+/**
+ * Show PATH warning for nvm-windows users
+ */
+function showPathWarning() {
+  console.log('');
+  console.log(chalk.yellow('⚠ Warning: morph-spec command not found in PATH'));
+  console.log('');
+
+  if (isUsingNvmWindows()) {
+    console.log(chalk.white('You are using nvm-windows, which does not automatically add'));
+    console.log(chalk.white('npm global packages to your PATH.'));
+    console.log('');
+    console.log(chalk.cyan('Solution 1: Add npm global directory to PATH'));
+
+    const prefix = getNpmGlobalPrefix();
+    if (prefix) {
+      console.log(chalk.white(`  Add this to your PATH: ${chalk.yellow(prefix)}`));
+      console.log('');
+      console.log(chalk.gray('  PowerShell (as Administrator):'));
+      console.log(chalk.white(`    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";${prefix}", "User")`));
+      console.log('');
+      console.log(chalk.gray('  Or manually via System Properties > Environment Variables'));
+    }
+
+    console.log('');
+    console.log(chalk.cyan('Solution 2: Use npx (recommended)'));
+    console.log(chalk.white('  npx @polymorphism-tech/morph-spec init'));
+    console.log(chalk.white('  npx @polymorphism-tech/morph-spec --help'));
+  } else {
+    console.log(chalk.white('The morph-spec command was not found in your PATH.'));
+    console.log('');
+    console.log(chalk.cyan('Solution: Use npx instead'));
+    console.log(chalk.white('  npx @polymorphism-tech/morph-spec init'));
+    console.log(chalk.white('  npx @polymorphism-tech/morph-spec --help'));
+  }
+
+  console.log('');
+  console.log(chalk.gray('For more help, see: https://github.com/lucasPolymorphism/morph-spec-framework#troubleshooting'));
+  console.log('');
+}
+
+/**
+ * Main postinstall check
+ */
+function main() {
+  // Only show messages for global installs
+  // Skip for local installs (when used as dependency)
+  const isGlobalInstall = process.env.npm_config_global === 'true';
+
+  if (!isGlobalInstall) {
+    // Silent exit for local installs
+    return;
+  }
+
+  // Give npm a moment to set up the symlinks
+  setTimeout(() => {
+    if (isMorphSpecInPath()) {
+      showSuccessMessage();
+    } else {
+      showPathWarning();
+    }
+  }, 100);
+}
+
+main();

package/src/commands/advance-phase.js

@@ -12,6 +12,8 @@
 import chalk from 'chalk';
 import { loadState, saveState, getFeature } from '../lib/state-manager.js';
 import { PHASES, validatePhase } from './validate-phase.js';
+import { detectDesignSystem, hasUIAgentsActive } from '../lib/design-system-detector.js';
+import { validateSpec } from '../lib/spec-validator.js';
 
 // Phase order for advancing (skips optional phases unless active)
 const PHASE_ORDER = ['proposal', 'setup', 'uiux', 'design', 'clarify', 'tasks', 'implement', 'sync'];
@@ -110,6 +112,48 @@ export async function advancePhaseCommand(feature, options = {}) {
     console.log(chalk.yellow(`\n⚠️  ${validation.stateWarning}`));
   }
 
+  // Gate: Validate spec.md and contracts.cs when advancing from design phase
+  if (currentPhase === 'design' && (nextPhase === 'clarify' || nextPhase === 'tasks')) {
+    const specValidation = await validateSpec('.', feature);
+
+    if (specValidation.errors > 0) {
+      console.log(chalk.red('\n✗ Spec validation failed — fix errors before advancing:'));
+      specValidation.issues.filter(i => i.level === 'error').forEach(issue => {
+        console.log(chalk.red(`  - ${issue.message}`));
+        console.log(chalk.yellow(`    → ${issue.solution}`));
+      });
+      console.log('');
+      process.exit(1);
+    }
+
+    if (specValidation.warnings > 0 && !options.skipWarnings) {
+      console.log(chalk.yellow('\n⚠️  Spec validation warnings:'));
+      specValidation.issues.filter(i => i.level === 'warning').forEach(issue => {
+        console.log(chalk.yellow(`  - ${issue.message}`));
+      });
+      console.log(chalk.gray('\n  (Use --skip-warnings to ignore warnings)\n'));
+    }
+  }
+
+  // Gate: Check design system when advancing to implement with UI agents
+  if (nextPhase === 'implement') {
+    const gateResult = designSystemGate(feature);
+
+    if (gateResult.blocked) {
+      console.log(chalk.red(`\n✗ ${gateResult.message}`));
+      console.log('');
+      gateResult.solution.forEach(line => {
+        if (line === '') {
+          console.log('');
+        } else {
+          console.log(chalk.yellow(`  ${line}`));
+        }
+      });
+      console.log('');
+      process.exit(1);
+    }
+  }
+
   // Advance the phase
   const state = loadState();
   state.features[feature].phase = nextPhase;
@@ -181,3 +225,42 @@ function getPhaseGuidance(phase, feature) {
 
   return guides[phase] || null;
 }
+
+/**
+ * Gate: Check design system exists when advancing to implement with UI agents
+ * @param {string} feature - Feature name
+ * @param {string} projectPath - Project root path
+ * @returns {Object} { blocked: boolean, message?: string, solution?: string[] }
+ */
+function designSystemGate(feature, projectPath = '.') {
+  // Check if UI agents are active
+  const hasUIAgents = hasUIAgentsActive(projectPath, feature);
+
+  if (!hasUIAgents) {
+    return { blocked: false }; // No UI agents, gate doesn't apply
+  }
+
+  // Check if design system exists
+  const dsDetection = detectDesignSystem(projectPath, feature);
+
+  if (dsDetection.hasDesignSystem) {
+    return { blocked: false }; // Design system exists, gate passed
+  }
+
+  // Block advancement - no design system found with UI agents active
+  return {
+    blocked: true,
+    message: 'Cannot advance to implementation — UI agents are active but no design system found',
+    solution: [
+      'Design system is required when UI agents (blazor-builder, ui-designer, css-specialist) are active',
+      '',
+      'Create a design system with one of these options:',
+      '  1. Project-level: .morph/project/design-system.md (shared across features)',
+      `  2. Feature-level: .morph/project/outputs/${feature}/ui-design-system.md (feature-specific)`,
+      '  3. Auto-generate: morph-spec generate design-system (scans existing CSS)',
+      '',
+      'Or remove UI agents if they are not needed:',
+      `  morph-spec state remove-agent ${feature} blazor-builder`
+    ]
+  };
+}