@polymorphism-tech/morph-spec 1.0.4 → 2.1.0

package/src/lib/design-system-generator.js

@@ -0,0 +1,298 @@
+/**
+ * MORPH-SPEC Design System Generator Library
+ *
+ * Reads ui-design-system.md and generates:
+ * - wwwroot/css/design-system.css (CSS variables)
+ * - Themes/FluentDesignTheme.cs (Fluent UI theme)
+ * - Themes/MudTheme.cs (MudBlazor theme)
+ *
+ * Used both by CLI commands and internal automation.
+ */
+
+import { readFileSync, existsSync } from 'fs';
+
+// ============================================================================
+// Parsing Functions
+// ============================================================================
+
+/**
+ * Parse colors from markdown
+ * @param {string} markdown - Markdown content
+ * @returns {Object} Colors object with primary, secondary, neutral, semantic
+ */
+export function parseColors(markdown) {
+  const colors = { primary: {}, secondary: {}, neutral: {}, semantic: {} };
+
+  // Match color definitions like: - **Primary 500** (`#...`) - ...
+  const colorRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^\(]*\(`(#[0-9A-Fa-f]{6})`\)/gm;
+
+  let match;
+  while ((match = colorRegex.exec(markdown)) !== null) {
+    const [, name, hex] = match;
+    const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
+
+    if (name.includes('Primary')) {
+      const variant = name.match(/\d+/)?.[0] || 'default';
+      colors.primary[variant] = hex;
+    } else if (name.includes('Secondary')) {
+      const variant = name.match(/\d+/)?.[0] || 'default';
+      colors.secondary[variant] = hex;
+    } else if (name.includes('Neutral') || name.includes('Gray')) {
+      const variant = name.match(/\d+/)?.[0] || 'default';
+      colors.neutral[variant] = hex;
+    } else if (name.includes('Success') || name.includes('Error') || name.includes('Warning') || name.includes('Info')) {
+      const type = name.toLowerCase().replace(/\s+/g, '-');
+      colors.semantic[type] = hex;
+    }
+  }
+
+  return colors;
+}
+
+/**
+ * Parse typography from markdown
+ * @param {string} markdown - Markdown content
+ * @returns {Object} Typography object with fontFamily, fontSize, fontWeight, lineHeight
+ */
+export function parseTypography(markdown) {
+  const typography = { fontFamily: {}, fontSize: {}, fontWeight: {}, lineHeight: {} };
+
+  // Match font family
+  const fontFamilyRegex = /(?:font[- ]?family|typeface)[:\s]+([^\n]+)/gi;
+  const fontMatch = fontFamilyRegex.exec(markdown);
+  if (fontMatch) {
+    typography.fontFamily.primary = fontMatch[1].trim();
+  }
+
+  // Match font sizes (but exclude spacing-related)
+  const fontSizeRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^:]*:\s*(\d+(?:\.\d+)?(?:rem|px|em))/gm;
+  let match;
+  while ((match = fontSizeRegex.exec(markdown)) !== null) {
+    const [, name, size] = match;
+    const lowerName = name.toLowerCase();
+    // Skip if it's spacing-related
+    if (lowerName.includes('spacing') || lowerName.includes('gap') || lowerName.includes('margin') || lowerName.includes('padding')) {
+      continue;
+    }
+    const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
+    typography.fontSize[cleanName] = size;
+  }
+
+  return typography;
+}
+
+/**
+ * Parse spacing from markdown
+ * @param {string} markdown - Markdown content
+ * @returns {Object} Spacing object with spacing values
+ */
+export function parseSpacing(markdown) {
+  const spacing = {};
+
+  // Match spacing definitions
+  const spacingRegex = /(?:^|\n)[-*]\s+\*\*([^*]+)\*\*[^:]*:\s*(\d+(?:\.\d+)?(?:rem|px|em))/gm;
+  let match;
+  while ((match = spacingRegex.exec(markdown)) !== null) {
+    const [, name, value] = match;
+    if (name.toLowerCase().includes('spacing') || name.toLowerCase().includes('gap') || name.toLowerCase().includes('margin') || name.toLowerCase().includes('padding')) {
+      const cleanName = name.trim().toLowerCase().replace(/\s+/g, '-');
+      spacing[cleanName] = value;
+    }
+  }
+
+  return spacing;
+}
+
+/**
+ * Parse all design system properties from markdown
+ * @param {string} markdownPath - Path to ui-design-system.md file
+ * @returns {Object} Parsed design system with colors, typography, spacing
+ */
+export function parseDesignSystem(markdownPath) {
+  if (!existsSync(markdownPath)) {
+    throw new Error(`File not found: ${markdownPath}`);
+  }
+
+  const markdown = readFileSync(markdownPath, 'utf-8');
+
+  return {
+    colors: parseColors(markdown),
+    typography: parseTypography(markdown),
+    spacing: parseSpacing(markdown)
+  };
+}
+
+// ============================================================================
+// Generation Functions
+// ============================================================================
+
+/**
+ * Generate CSS variables file
+ * @param {Object} colors - Colors object
+ * @param {Object} typography - Typography object
+ * @param {Object} spacing - Spacing object
+ * @returns {string} CSS content
+ */
+export function generateCSS(colors, typography, spacing) {
+  let css = `/* Auto-generated by MORPH-SPEC Design System Generator */\n`;
+  css += `/* Do not edit manually - regenerate from ui-design-system.md */\n\n`;
+  css += `:root {\n`;
+
+  // Colors
+  if (Object.keys(colors.primary).length > 0) {
+    css += `  /* Primary Colors */\n`;
+    Object.entries(colors.primary).forEach(([variant, hex]) => {
+      css += `  --color-primary-${variant}: ${hex};\n`;
+    });
+    css += `\n`;
+  }
+
+  if (Object.keys(colors.secondary).length > 0) {
+    css += `  /* Secondary Colors */\n`;
+    Object.entries(colors.secondary).forEach(([variant, hex]) => {
+      css += `  --color-secondary-${variant}: ${hex};\n`;
+    });
+    css += `\n`;
+  }
+
+  if (Object.keys(colors.neutral).length > 0) {
+    css += `  /* Neutral Colors */\n`;
+    Object.entries(colors.neutral).forEach(([variant, hex]) => {
+      css += `  --color-neutral-${variant}: ${hex};\n`;
+    });
+    css += `\n`;
+  }
+
+  if (Object.keys(colors.semantic).length > 0) {
+    css += `  /* Semantic Colors */\n`;
+    Object.entries(colors.semantic).forEach(([type, hex]) => {
+      css += `  --color-${type}: ${hex};\n`;
+    });
+    css += `\n`;
+  }
+
+  // Typography
+  if (typography.fontFamily.primary) {
+    css += `  /* Typography */\n`;
+    css += `  --font-family-primary: ${typography.fontFamily.primary};\n`;
+    css += `\n`;
+  }
+
+  if (Object.keys(typography.fontSize).length > 0) {
+    css += `  /* Font Sizes */\n`;
+    Object.entries(typography.fontSize).forEach(([name, size]) => {
+      css += `  --font-size-${name}: ${size};\n`;
+    });
+    css += `\n`;
+  }
+
+  // Spacing
+  if (Object.keys(spacing).length > 0) {
+    css += `  /* Spacing */\n`;
+    Object.entries(spacing).forEach(([name, value]) => {
+      css += `  --${name}: ${value};\n`;
+    });
+  }
+
+  css += `}\n`;
+
+  return css;
+}
+
+/**
+ * Generate Fluent UI theme (C#)
+ * @param {Object} colors - Colors object
+ * @param {Object} typography - Typography object
+ * @param {string} namespace - C# namespace (default: YourProject.Themes)
+ * @returns {string} C# code
+ */
+export function generateFluentTheme(colors, typography, namespace = 'YourProject.Themes') {
+  const primary500 = colors.primary['500'] || '#0078d4';
+
+  let csharp = `// Auto-generated by MORPH-SPEC Design System Generator\n`;
+  csharp += `// Do not edit manually - regenerate from ui-design-system.md\n\n`;
+  csharp += `using Microsoft.FluentUI.AspNetCore.Components;\n\n`;
+  csharp += `namespace ${namespace};\n\n`;
+  csharp += `public static class FluentDesignTheme\n{\n`;
+  csharp += `    public static DesignThemePalette GetPalette()\n`;
+  csharp += `    {\n`;
+  csharp += `        return new DesignThemePalette\n`;
+  csharp += `        {\n`;
+  csharp += `            Accent = "${primary500}",\n`;
+  csharp += `            // Add more theme properties as needed\n`;
+  csharp += `        };\n`;
+  csharp += `    }\n`;
+  csharp += `}\n`;
+
+  return csharp;
+}
+
+/**
+ * Generate MudBlazor theme (C#)
+ * @param {Object} colors - Colors object
+ * @param {Object} typography - Typography object
+ * @param {string} namespace - C# namespace (default: YourProject.Themes)
+ * @returns {string} C# code
+ */
+export function generateMudTheme(colors, typography, namespace = 'YourProject.Themes') {
+  const primary500 = colors.primary['500'] || '#594ae2';
+  const secondary500 = colors.secondary['500'] || '#ff4081';
+
+  let csharp = `// Auto-generated by MORPH-SPEC Design System Generator\n`;
+  csharp += `// Do not edit manually - regenerate from ui-design-system.md\n\n`;
+  csharp += `using MudBlazor;\n\n`;
+  csharp += `namespace ${namespace};\n\n`;
+  csharp += `public static class MudDesignTheme\n{\n`;
+  csharp += `    public static MudTheme GetTheme()\n`;
+  csharp += `    {\n`;
+  csharp += `        return new MudTheme\n`;
+  csharp += `        {\n`;
+  csharp += `            Palette = new PaletteLight\n`;
+  csharp += `            {\n`;
+  csharp += `                Primary = "${primary500}",\n`;
+  csharp += `                Secondary = "${secondary500}",\n`;
+  csharp += `                // Add more palette colors as needed\n`;
+  csharp += `            }\n`;
+  csharp += `        };\n`;
+  csharp += `    }\n`;
+  csharp += `}\n`;
+
+  return csharp;
+}
+
+/**
+ * Generate all design system files
+ * @param {string} designSystemPath - Path to ui-design-system.md
+ * @param {Object} options - Generation options
+ * @param {string} options.mode - Generation mode: 'fluent', 'mud', or 'both'
+ * @param {string} options.namespace - C# namespace
+ * @returns {Object} Generated files content
+ */
+export function generateDesignSystem(designSystemPath, options = {}) {
+  const { mode = 'both', namespace = 'YourProject.Themes' } = options;
+
+  // Parse design system
+  const { colors, typography, spacing } = parseDesignSystem(designSystemPath);
+
+  const generated = {
+    css: generateCSS(colors, typography, spacing),
+    stats: {
+      primaryColors: Object.keys(colors.primary).length,
+      neutralColors: Object.keys(colors.neutral).length,
+      semanticColors: Object.keys(colors.semantic).length,
+      fontSizes: Object.keys(typography.fontSize).length,
+      spacingValues: Object.keys(spacing).length
+    }
+  };
+
+  // Generate themes based on mode
+  if (mode === 'fluent' || mode === 'both') {
+    generated.fluentTheme = generateFluentTheme(colors, typography, namespace);
+  }
+
+  if (mode === 'mud' || mode === 'both') {
+    generated.mudTheme = generateMudTheme(colors, typography, namespace);
+  }
+
+  return generated;
+}

package/src/lib/state-manager.js

@@ -0,0 +1,340 @@
+/**
+ * MORPH-SPEC State Manager Library
+ *
+ * Manages state.json for tracking features, progress, agents, and checkpoints.
+ * Used both by CLI commands and internal automation.
+ */
+
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join, dirname } from 'path';
+
+const STATE_FILE_NAME = '.morph/state.json';
+
+// ============================================================================
+// Core Functions
+// ============================================================================
+
+/**
+ * Get the state file path (looks in current working directory)
+ */
+export function getStatePath() {
+  return join(process.cwd(), STATE_FILE_NAME);
+}
+
+/**
+ * Check if state file exists
+ */
+export function stateExists() {
+  return existsSync(getStatePath());
+}
+
+/**
+ * Load state from disk
+ * @param {boolean} throwOnError - If false, returns null instead of throwing
+ * @returns {Object|null} State object or null
+ */
+export function loadState(throwOnError = true) {
+  const statePath = getStatePath();
+
+  if (!existsSync(statePath)) {
+    if (throwOnError) {
+      throw new Error(`State file not found: ${statePath}\nRun 'morph-spec state init' first.`);
+    }
+    return null;
+  }
+
+  try {
+    const content = readFileSync(statePath, 'utf8');
+    return JSON.parse(content);
+  } catch (err) {
+    if (throwOnError) {
+      throw new Error(`Failed to parse state.json: ${err.message}`);
+    }
+    return null;
+  }
+}
+
+/**
+ * Save state to disk
+ * @param {Object} state - State object to save
+ */
+export function saveState(state) {
+  state.metadata = state.metadata || {};
+  state.metadata.lastUpdated = new Date().toISOString();
+
+  const statePath = getStatePath();
+  const stateDir = dirname(statePath);
+
+  // Ensure .morph directory exists
+  if (!existsSync(stateDir)) {
+    mkdirSync(stateDir, { recursive: true });
+  }
+
+  writeFileSync(statePath, JSON.stringify(state, null, 2), 'utf8');
+}
+
+/**
+ * Initialize new state file
+ * @param {Object} options - Options
+ * @param {boolean} options.force - Overwrite existing file
+ * @param {string} options.projectName - Project name
+ * @param {string} options.projectType - Project type (e.g., 'blazor-server')
+ * @returns {Object} Initial state
+ */
+export function initState(options = {}) {
+  const { force = false, projectName = '{PROJECT_NAME}', projectType = 'blazor-server' } = options;
+
+  if (stateExists() && !force) {
+    throw new Error('State file already exists. Use force=true to overwrite.');
+  }
+
+  const initialState = {
+    version: "2.1.1",
+    project: {
+      name: projectName,
+      type: projectType,
+      createdAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString()
+    },
+    features: {},
+    metadata: {
+      totalFeatures: 0,
+      completedFeatures: 0,
+      totalCostEstimated: 0,
+      totalTimeSpent: 0,
+      lastUpdated: new Date().toISOString()
+    }
+  };
+
+  saveState(initialState);
+  return initialState;
+}
+
+// ============================================================================
+// Feature Operations
+// ============================================================================
+
+/**
+ * Get feature from state
+ * @param {string} featureName - Feature name
+ * @returns {Object|null} Feature object or null
+ */
+export function getFeature(featureName) {
+  const state = loadState();
+  return state.features[featureName] || null;
+}
+
+/**
+ * Create or get feature with default structure
+ * @param {string} featureName - Feature name
+ * @returns {Object} Feature object
+ */
+function ensureFeature(featureName) {
+  const state = loadState();
+
+  if (!state.features[featureName]) {
+    state.features[featureName] = {
+      status: "draft",
+      phase: "proposal",
+      workflow: "auto", // auto | fast-track | standard | full-morph
+      createdAt: new Date().toISOString(),
+      updatedAt: new Date().toISOString(),
+      activeAgents: [],
+      outputs: {
+        proposal: { created: false, path: `.morph/project/outputs/${featureName}/proposal.md` },
+        spec: { created: false, path: `.morph/project/outputs/${featureName}/spec.md` },
+        contracts: { created: false, path: `.morph/project/outputs/${featureName}/contracts.cs` },
+        tasks: { created: false, path: `.morph/project/outputs/${featureName}/tasks.json` },
+        uiDesignSystem: { created: false, path: `.morph/project/outputs/${featureName}/ui-design-system.md` },
+        uiMockups: { created: false, path: `.morph/project/outputs/${featureName}/ui-mockups.md` },
+        uiComponents: { created: false, path: `.morph/project/outputs/${featureName}/ui-components.md` },
+        uiFlows: { created: false, path: `.morph/project/outputs/${featureName}/ui-flows.md` },
+        decisions: { created: false, path: `.morph/project/outputs/${featureName}/decisions.md` },
+        recap: { created: false, path: `.morph/project/outputs/${featureName}/recap.md` }
+      },
+      tasks: {
+        total: 0,
+        completed: 0,
+        inProgress: 0,
+        pending: 0
+      },
+      checkpoints: [],
+      costs: {
+        estimated: 0,
+        approved: false,
+        approvedBy: null,
+        approvedAt: null
+      }
+    };
+
+    state.metadata.totalFeatures++;
+    saveState(state);
+  }
+
+  return state.features[featureName];
+}
+
+/**
+ * Update feature property (supports nested keys like "tasks.completed")
+ * @param {string} featureName - Feature name
+ * @param {string} key - Property key (supports dot notation)
+ * @param {any} value - Value to set
+ */
+export function updateFeature(featureName, key, value) {
+  ensureFeature(featureName);
+  const state = loadState(); // Load AFTER ensuring feature exists
+
+  const keys = key.split('.');
+  let target = state.features[featureName];
+
+  for (let i = 0; i < keys.length - 1; i++) {
+    if (!target[keys[i]]) {
+      target[keys[i]] = {};
+    }
+    target = target[keys[i]];
+  }
+
+  const finalKey = keys[keys.length - 1];
+  target[finalKey] = value;
+  state.features[featureName].updatedAt = new Date().toISOString();
+
+  saveState(state);
+}
+
+/**
+ * Update multiple feature properties at once
+ * @param {string} featureName - Feature name
+ * @param {Object} updates - Object with key-value pairs to update
+ */
+export function updateFeatureMultiple(featureName, updates) {
+  ensureFeature(featureName);
+  const state = loadState(); // Load AFTER ensuring feature exists
+
+  for (const [key, value] of Object.entries(updates)) {
+    const keys = key.split('.');
+    let target = state.features[featureName];
+
+    for (let i = 0; i < keys.length - 1; i++) {
+      if (!target[keys[i]]) {
+        target[keys[i]] = {};
+      }
+      target = target[keys[i]];
+    }
+
+    const finalKey = keys[keys.length - 1];
+    target[finalKey] = value;
+  }
+
+  state.features[featureName].updatedAt = new Date().toISOString();
+  saveState(state);
+}
+
+/**
+ * Add checkpoint to feature
+ * @param {string} featureName - Feature name
+ * @param {string} note - Checkpoint note
+ * @returns {Object} Checkpoint object
+ */
+export function addCheckpoint(featureName, note) {
+  ensureFeature(featureName);
+  const state = loadState();
+  const feature = state.features[featureName];
+
+  const checkpoint = {
+    timestamp: new Date().toISOString(),
+    phase: feature.phase,
+    completedTasks: feature.tasks.completed,
+    note: note
+  };
+
+  feature.checkpoints.push(checkpoint);
+  feature.updatedAt = new Date().toISOString();
+
+  saveState(state);
+  return checkpoint;
+}
+
+/**
+ * Add agent to feature
+ * @param {string} featureName - Feature name
+ * @param {string} agentId - Agent ID
+ * @returns {boolean} True if added, false if already exists
+ */
+export function addAgent(featureName, agentId) {
+  ensureFeature(featureName);
+  const state = loadState(); // Load AFTER ensuring feature exists
+
+  if (!state.features[featureName].activeAgents.includes(agentId)) {
+    state.features[featureName].activeAgents.push(agentId);
+    state.features[featureName].updatedAt = new Date().toISOString();
+    saveState(state);
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Remove agent from feature
+ * @param {string} featureName - Feature name
+ * @param {string} agentId - Agent ID
+ * @returns {boolean} True if removed, false if not found
+ */
+export function removeAgent(featureName, agentId) {
+  const state = loadState();
+
+  if (!state.features[featureName]) {
+    throw new Error(`Feature '${featureName}' not found.`);
+  }
+
+  const index = state.features[featureName].activeAgents.indexOf(agentId);
+  if (index > -1) {
+    state.features[featureName].activeAgents.splice(index, 1);
+    state.features[featureName].updatedAt = new Date().toISOString();
+    saveState(state);
+    return true;
+  }
+
+  return false;
+}
+
+/**
+ * Mark output as created
+ * @param {string} featureName - Feature name
+ * @param {string} outputType - Output type (proposal, spec, contracts, etc.)
+ */
+export function markOutput(featureName, outputType) {
+  ensureFeature(featureName);
+  const state = loadState();
+
+  if (!state.features[featureName].outputs[outputType]) {
+    throw new Error(`Output type '${outputType}' not valid. Valid types: proposal, spec, contracts, tasks, uiDesignSystem, uiMockups, uiComponents, uiFlows, decisions, recap`);
+  }
+
+  state.features[featureName].outputs[outputType].created = true;
+  state.features[featureName].updatedAt = new Date().toISOString();
+
+  saveState(state);
+}
+
+/**
+ * List all features
+ * @returns {Array} Array of [featureName, featureObject] tuples
+ */
+export function listFeatures() {
+  const state = loadState();
+  return Object.entries(state.features);
+}
+
+/**
+ * Get project summary
+ * @returns {Object} Summary with metadata
+ */
+export function getSummary() {
+  const state = loadState();
+  return {
+    project: state.project,
+    metadata: state.metadata,
+    featuresCount: Object.keys(state.features).length
+  };
+}

package/src/utils/file-copier.js

@@ -52,3 +52,62 @@ export async function removeDir(path) {
 export async function readFile(path) {
   return fs.readFile(path, 'utf8');
 }
+
+export async function updateGitignore(projectPath) {
+  const gitignorePath = join(projectPath, '.gitignore');
+
+  const morphRules = [
+    '',
+    '# MORPH-SPEC',
+    '.morph/examples/',
+    '.morph/templates/',
+    '.claude/settings.local.json',
+    ''
+  ];
+
+  let content = '';
+  let hasMorphSection = false;
+
+  // Read existing .gitignore if it exists
+  if (await pathExists(gitignorePath)) {
+    content = await readFile(gitignorePath);
+    hasMorphSection = content.includes('# MORPH-SPEC');
+  }
+
+  // If MORPH section already exists, check if rules are up to date
+  if (hasMorphSection) {
+    const lines = content.split('\n');
+    const morphStartIndex = lines.findIndex(line => line.trim() === '# MORPH-SPEC');
+
+    // Find the end of MORPH section (next empty line or section header)
+    let morphEndIndex = morphStartIndex + 1;
+    while (morphEndIndex < lines.length &&
+           lines[morphEndIndex].trim() !== '' &&
+           !lines[morphEndIndex].startsWith('#')) {
+      morphEndIndex++;
+    }
+
+    // Extract current MORPH rules
+    const currentMorphRules = lines.slice(morphStartIndex, morphEndIndex + 1);
+    const expectedMorphRules = morphRules.slice(1, -1); // Remove empty lines from comparison
+
+    // Check if all expected rules are present
+    const missingRules = expectedMorphRules.filter(rule =>
+      rule.startsWith('#') || !currentMorphRules.some(line => line.trim() === rule)
+    );
+
+    if (missingRules.length > 0) {
+      // Update the section with all rules
+      lines.splice(morphStartIndex, morphEndIndex - morphStartIndex, ...morphRules.slice(1, -1));
+      content = lines.join('\n');
+    }
+  } else {
+    // Add MORPH section
+    if (content && !content.endsWith('\n')) {
+      content += '\n';
+    }
+    content += morphRules.join('\n');
+  }
+
+  await writeFile(gitignorePath, content);
+}