@polymorphism-tech/morph-spec 4.8.19 → 4.10.0

package/src/commands/tasks/task.js

@@ -1,99 +1,78 @@
-/**
- * Task management commands
- * Spawns bin/task-manager.js (ESM) as a subprocess.
- */
-
-import { spawn } from 'child_process';
-import { fileURLToPath } from 'url';
-import { dirname, join } from 'path';
-import chalk from 'chalk';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const taskManagerPath = join(__dirname, '..', '..', '..', 'bin', 'task-manager.js');
-
-/**
- * Execute task-manager.js with given arguments
- */
-function executeTaskManager(args) {
-  return new Promise((resolve, reject) => {
-    // Note: shell: false (default) is intentional to preserve arguments with spaces
-    const child = spawn('node', [taskManagerPath, ...args], {
-      stdio: 'inherit'
-    });
-
-    child.on('close', (code) => {
-      if (code === 0) {
-        resolve();
-      } else {
-        reject(new Error(`Task manager exited with code ${code}`));
-      }
-    });
-
-    child.on('error', (error) => {
-      reject(error);
-    });
-  });
-}
-
-/**
- * Complete tasks command
- */
-export async function taskDoneCommand(featureName, taskIds, options) {
-  try {
-    const args = ['done', featureName, ...taskIds];
-    if (options.skipValidation) args.push('--skip-validation');
-    if (options.dryRun) args.push('--dry-run');
-    await executeTaskManager(args);
-  } catch (error) {
-    console.error(chalk.red(`Error: ${error.message}`));
-    process.exit(1);
-  }
-}
-
-/**
- * Bulk-complete tasks command
- */
-export async function taskBulkDoneCommand(featureName, rangeArg, options) {
-  try {
-    const args = ['bulk-done', featureName];
-    if (options.all) {
-      args.push('--all');
-    } else if (options.from && options.to) {
-      args.push('--from', options.from, '--to', options.to);
-    } else if (rangeArg) {
-      args.push(rangeArg);
-    }
-    if (options.skipValidation) args.push('--skip-validation');
-    if (options.dryRun) args.push('--dry-run');
-    await executeTaskManager(args);
-  } catch (error) {
-    console.error(chalk.red(`Error: ${error.message}`));
-    process.exit(1);
-  }
-}
-
-/**
- * Start task command
- */
-export async function taskStartCommand(featureName, taskId, options) {
-  try {
-    const args = ['start', featureName, taskId];
-    await executeTaskManager(args);
-  } catch (error) {
-    console.error(chalk.red(`Error: ${error.message}`));
-    process.exit(1);
-  }
-}
-
-/**
- * Get next task command
- */
-export async function taskNextCommand(featureName, options) {
-  try {
-    const args = ['next', featureName];
-    await executeTaskManager(args);
-  } catch (error) {
-    console.error(chalk.red(`Error: ${error.message}`));
-    process.exit(1);
-  }
-}
+/**
+ * Task management commands
+ * Spawns bin/task-manager.js (ESM) as a subprocess.
+ */
+
+import { spawn } from 'child_process';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import chalk from 'chalk';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const taskManagerPath = join(__dirname, '..', '..', '..', 'bin', 'task-manager.js');
+
+/**
+ * Execute task-manager.js with given arguments
+ */
+function executeTaskManager(args) {
+  return new Promise((resolve, reject) => {
+    // Note: shell: false (default) is intentional to preserve arguments with spaces
+    const child = spawn('node', [taskManagerPath, ...args], {
+      stdio: 'inherit'
+    });
+
+    child.on('close', (code) => {
+      if (code === 0) {
+        resolve();
+      } else {
+        reject(new Error(`Task manager exited with code ${code}`));
+      }
+    });
+
+    child.on('error', (error) => {
+      reject(error);
+    });
+  });
+}
+
+/**
+ * Complete tasks command
+ */
+export async function taskDoneCommand(featureName, taskIds, options) {
+  try {
+    const args = ['done', featureName, ...taskIds];
+    if (options.skipValidation) args.push('--skip-validation');
+    if (options.dryRun) args.push('--dry-run');
+    await executeTaskManager(args);
+  } catch (error) {
+    console.error(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+/**
+/**
+ * Start task command
+ */
+export async function taskStartCommand(featureName, taskId, options) {
+  try {
+    const args = ['start', featureName, taskId];
+    await executeTaskManager(args);
+  } catch (error) {
+    console.error(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+}
+
+/**
+ * Get next task command
+ */
+export async function taskNextCommand(featureName, options) {
+  try {
+    const args = ['next', featureName];
+    await executeTaskManager(args);
+  } catch (error) {
+    console.error(chalk.red(`Error: ${error.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/templates/template-render.js

@@ -1,173 +1,93 @@
-/**
- * Template Render Command - Render a template by ID with variables
- */
-
-import { writeFileSync, mkdirSync } from 'fs';
-import { dirname, join } from 'path';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { getTemplateById, resolveTemplatePathById } from '../../core/templates/template-registry.js';
-import { renderTemplate } from '../../core/templates/template-renderer.js';
-import { renderHOP, listAvailableHOPs } from '../../lib/hops/hop-composer.js';
-
-/**
- * Render HOP (Higher-Order Prompt) template command
- */
-export async function hopRenderCommand(hopId, outputPath, variablesJson, options) {
-  logger.header(`Rendering HOP: ${hopId}`);
-  logger.blank();
-
-  try {
-    // Parse variables
-    let variables = {};
-    try {
-      variables = JSON.parse(variablesJson || '{}');
-    } catch (error) {
-      logger.error('Invalid JSON in variables argument');
-      logger.dim(`  ${error.message}`);
-      process.exit(1);
-    }
-
-    // Add defaults
-    variables.DATE = variables.DATE || new Date().toISOString().split('T')[0];
-    variables.YEAR = variables.YEAR || new Date().getFullYear().toString();
-    variables.TIMESTAMP = variables.TIMESTAMP || new Date().toISOString();
-
-    // Render via hop-composer
-    const frameworkRoot = join(process.cwd(), 'framework');
-    const rendered = renderHOP(hopId, variables, { frameworkRoot });
-
-    if (options?.dryRun || !outputPath) {
-      logger.info(chalk.cyan('📋 HOP Preview:'));
-      logger.blank();
-      console.log(rendered);
-      logger.blank();
-      if (outputPath) logger.dim(`Would be written to: ${outputPath}`);
-    } else {
-      mkdirSync(dirname(outputPath), { recursive: true });
-      writeFileSync(outputPath, rendered, 'utf-8');
-      logger.success(`✅ HOP rendered: ${chalk.cyan(outputPath)}`);
-    }
-  } catch (error) {
-    logger.error(`Failed to render HOP: ${error.message}`);
-    process.exit(1);
-  }
-}
-
-/**
- * List available HOPs
- */
-export async function hopListCommand(options) {
-  logger.header('Available HOPs (Higher-Order Prompts)');
-  logger.blank();
-
-  const frameworkRoot = join(process.cwd(), 'framework');
-  const hops = listAvailableHOPs(frameworkRoot);
-
-  if (hops.length === 0) {
-    logger.warn('No HOPs found in framework/templates/meta-prompts/');
-    return;
-  }
-
-  const byType = {};
-  for (const hop of hops) {
-    const type = hop.type || 'other';
-    if (!byType[type]) byType[type] = [];
-    byType[type].push(hop);
-  }
-
-  for (const [type, list] of Object.entries(byType)) {
-    console.log(chalk.cyan(`\n  ${type.toUpperCase()}`));
-    for (const hop of list) {
-      console.log(`    ${chalk.white(hop.id.padEnd(30))} ${chalk.gray(hop.description || hop.path)}`);
-    }
-  }
-
-  logger.blank();
-  logger.dim(`Total: ${hops.length} HOPs`);
-  logger.dim(`Render: morph-spec hop render <hop-id> <output-file> '<variables-json>'`);
-}
-
-/**
- * Render template command
- */
-export async function templateRenderCommand(templateId, outputPath, variablesJson, options) {
-  logger.header(`Rendering Template: ${templateId}`);
-  logger.blank();
-
-  try {
-    // 1. Validate template exists
-    const template = getTemplateById(templateId);
-
-    if (!template) {
-      logger.error(`Template not found: ${templateId}`);
-      logger.dim('\n💡 Use `morph-spec template list` to see available templates');
-      process.exit(1);
-    }
-
-    // 2. Resolve template path
-    const projectPath = options.projectPath || process.cwd();
-    const templatePath = resolveTemplatePathById(templateId, projectPath);
-
-    if (!templatePath) {
-      logger.error(`Template file not found for ${templateId}`);
-      logger.dim('  Searched in: .morph/framework/templates/ and framework/templates/');
-      process.exit(1);
-    }
-
-    logger.dim(`Template: ${templatePath}`);
-
-    // 3. Parse variables
-    let variables = {};
-    try {
-      variables = JSON.parse(variablesJson);
-    } catch (error) {
-      logger.error('Invalid JSON in variables argument');
-      logger.dim(`  ${error.message}`);
-      process.exit(1);
-    }
-
-    // 4. Add default variables
-    const defaults = {
-      DATE: new Date().toISOString().split('T')[0],
-      YEAR: new Date().getFullYear().toString(),
-      TIMESTAMP: new Date().toISOString()
-    };
-
-    const allVariables = { ...defaults, ...variables };
-
-    logger.dim(`Variables: ${Object.keys(allVariables).length} provided`);
-    logger.blank();
-
-    // 5. Render template
-    const renderedContent = renderTemplate(templatePath, allVariables);
-
-    // 6. Output
-    if (options.dryRun) {
-      logger.info(chalk.cyan('📋 DRY RUN - Preview (file will NOT be written)'));
-      logger.blank();
-      console.log(renderedContent);
-      logger.blank();
-      logger.dim(`Would be written to: ${outputPath}`);
-    } else {
-      // Create output directory if needed
-      const outputDir = dirname(outputPath);
-      mkdirSync(outputDir, { recursive: true });
-
-      // Write file
-      writeFileSync(outputPath, renderedContent, 'utf-8');
-
-      logger.success(`✅ Template rendered successfully`);
-      logger.dim(`  Output: ${chalk.cyan(outputPath)}`);
-    }
-
-    logger.blank();
-
-  } catch (error) {
-    logger.error(`Failed to render template: ${error.message}`);
-    if (options.verbose) {
-      console.error(error.stack);
-    }
-    process.exit(1);
-  }
-}
+/**
+ * Template Render Command - Render a template by ID with variables
+ */
+
+import { writeFileSync, mkdirSync } from 'fs';
+import { dirname, join } from 'path';
+import chalk from 'chalk';
+import { logger } from '../../utils/logger.js';
+import { getTemplateById, resolveTemplatePathById } from '../../core/templates/template-registry.js';
+import { renderTemplate } from '../../core/templates/template-renderer.js';
+/**
+ * Render template command
+ */
+export async function templateRenderCommand(templateId, outputPath, variablesJson, options) {
+  logger.header(`Rendering Template: ${templateId}`);
+  logger.blank();
+
+  try {
+    // 1. Validate template exists
+    const template = getTemplateById(templateId);
+
+    if (!template) {
+      logger.error(`Template not found: ${templateId}`);
+      logger.dim('\n💡 Available template IDs are listed in framework/templates/ — check subdirectories code/, frontend/, meta-prompts/');
+      process.exit(1);
+    }
+
+    // 2. Resolve template path
+    const projectPath = options.projectPath || process.cwd();
+    const templatePath = resolveTemplatePathById(templateId, projectPath);
+
+    if (!templatePath) {
+      logger.error(`Template file not found for ${templateId}`);
+      logger.dim('  Searched in: .morph/framework/templates/ and framework/templates/');
+      process.exit(1);
+    }
+
+    logger.dim(`Template: ${templatePath}`);
+
+    // 3. Parse variables
+    let variables = {};
+    try {
+      variables = JSON.parse(variablesJson);
+    } catch (error) {
+      logger.error('Invalid JSON in variables argument');
+      logger.dim(`  ${error.message}`);
+      process.exit(1);
+    }
+
+    // 4. Add default variables
+    const defaults = {
+      DATE: new Date().toISOString().split('T')[0],
+      YEAR: new Date().getFullYear().toString(),
+      TIMESTAMP: new Date().toISOString()
+    };
+
+    const allVariables = { ...defaults, ...variables };
+
+    logger.dim(`Variables: ${Object.keys(allVariables).length} provided`);
+    logger.blank();
+
+    // 5. Render template
+    const renderedContent = renderTemplate(templatePath, allVariables);
+
+    // 6. Output
+    if (options.dryRun) {
+      logger.info(chalk.cyan('📋 DRY RUN - Preview (file will NOT be written)'));
+      logger.blank();
+      console.log(renderedContent);
+      logger.blank();
+      logger.dim(`Would be written to: ${outputPath}`);
+    } else {
+      // Create output directory if needed
+      const outputDir = dirname(outputPath);
+      mkdirSync(outputDir, { recursive: true });
+
+      // Write file
+      writeFileSync(outputPath, renderedContent, 'utf-8');
+
+      logger.success(`✅ Template rendered successfully`);
+      logger.dim(`  Output: ${chalk.cyan(outputPath)}`);
+    }
+
+    logger.blank();
+
+  } catch (error) {
+    logger.error(`Failed to render template: ${error.message}`);
+    if (options.verbose) {
+      console.error(error.stack);
+    }
+    process.exit(1);
+  }
+}

package/src/commands/trust/trust.js

@@ -4,6 +4,11 @@
  * Usage:
  *   morph-spec trust status [feature]
  *   morph-spec trust set <feature> <level> [reason]
+ *
+ * Levels:
+ *   manual  — nothing auto-approved (default)
+ *   high    — auto-approve low-risk gates (design, tasks)
+ *   auto    — auto-approve all gates
  */
 
 import chalk from 'chalk';
@@ -11,10 +16,15 @@ import {
   getTrust,
   setTrust,
   getTrustHistory,
-  TRUST_THRESHOLDS,
   AUTO_APPROVE_GATES
 } from '../../lib/trust/trust-manager.js';
 
+const LEVEL_DESCRIPTIONS = {
+  manual: 'manual approval required for all gates',
+  high:   'auto-approves low-risk gates (design, tasks)',
+  auto:   'auto-approves all gates'
+};
+
 /**
  * Trust status — current trust level for a feature or all features
  */
@@ -25,15 +35,13 @@ export async function trustStatusCommand(featureName, options) {
     console.log(chalk.bold(`\n  Trust Status — ${featureName}`));
     console.log('  ' + '─'.repeat(50));
 
-    const levelColor = trust.level === 'maximum' ? chalk.green
+    const levelColor = trust.level === 'auto' ? chalk.green
       : trust.level === 'high' ? chalk.cyan
-      : trust.level === 'medium' ? chalk.yellow
-      : chalk.red;
+      : chalk.yellow;
 
     console.log(`  Level:       ${levelColor(trust.level.toUpperCase())}`);
-    console.log(`  Pass Rate:   ${Math.round((trust.passRate || 0) * 100)}%`);
-    console.log(`  Checkpoints: ${trust.passed || 0}/${trust.total || 0} passed`);
-    console.log(`  Source:      ${trust.source || 'calculated'}`);
+    console.log(`  Description: ${LEVEL_DESCRIPTIONS[trust.level] || trust.level}`);
+    console.log(`  Source:      ${trust.source || 'default'}`);
 
     if (trust.source === 'manual') {
       console.log(chalk.yellow(`  Override:    ${trust.overrideReason || 'No reason provided'}`));
@@ -46,11 +54,12 @@ export async function trustStatusCommand(featureName, options) {
       trust.autoApprove.forEach(g => console.log(chalk.green(`    ✓ ${g}`)));
     }
 
-    console.log(`\n  Trust thresholds:`);
-    for (const [level, threshold] of Object.entries(TRUST_THRESHOLDS)) {
+    console.log(`\n  Available trust levels:`);
+    for (const [level, desc] of Object.entries(LEVEL_DESCRIPTIONS)) {
       const gates = AUTO_APPROVE_GATES[level] || [];
       const marker = trust.level === level ? chalk.bold(' ← current') : '';
-      console.log(`    ${level.padEnd(10)} ≥ ${Math.round(threshold * 100)}%  auto-approves: ${gates.join(', ') || 'none'}${marker}`);
+      const gateList = gates.length > 0 ? gates.join(', ') : 'none';
+      console.log(`    ${level.padEnd(10)} auto-approves: ${gateList}${marker}`);
     }
 
     console.log();
@@ -63,21 +72,18 @@ export async function trustStatusCommand(featureName, options) {
     }
 
     console.log(chalk.bold('\n  Trust Overview'));
-    console.log('  ' + '─'.repeat(70));
-    console.log(`  ${'Feature'.padEnd(25)} ${'Level'.padEnd(10)} ${'Pass%'.padEnd(8)} ${'CPs'.padEnd(8)} Phase`);
-    console.log('  ' + '─'.repeat(70));
+    console.log('  ' + '─'.repeat(60));
+    console.log(`  ${'Feature'.padEnd(25)} ${'Level'.padEnd(10)} Phase`);
+    console.log('  ' + '─'.repeat(60));
 
     for (const f of history) {
-      const levelColor = f.level === 'maximum' ? chalk.green
+      const levelColor = f.level === 'auto' ? chalk.green
         : f.level === 'high' ? chalk.cyan
-        : f.level === 'medium' ? chalk.yellow
-        : chalk.red;
+        : chalk.yellow;
 
       console.log(
         `  ${f.feature.padEnd(25)} ` +
         `${levelColor(f.level.padEnd(10))} ` +
-        `${String(Math.round(f.passRate * 100) + '%').padEnd(8)} ` +
-        `${String(f.checkpointsTotal).padEnd(8)} ` +
         `${f.phase || 'N/A'}`
       );
     }
@@ -91,7 +97,7 @@ export async function trustStatusCommand(featureName, options) {
 export async function trustSetCommand(featureName, level, reason, options) {
   if (!featureName || !level) {
     console.error(chalk.red('Usage: morph-spec trust set <feature> <level> [reason]'));
-    console.error(chalk.gray('Levels: low, medium, high, maximum'));
+    console.error(chalk.gray('Levels: manual, high, auto'));
     process.exit(1);
   }
 
@@ -104,10 +110,9 @@ export async function trustSetCommand(featureName, level, reason, options) {
     console.log(`  Level:         ${result.level}`);
     console.log(`  Auto-approves: ${result.autoApprove.join(', ') || 'none'}`);
     console.log(`  Reason:        ${result.reason}`);
-    console.log(chalk.gray('\n  Note: Trust reverts to calculated level after next checkpoint.\n'));
+    console.log();
   } catch (err) {
     console.error(chalk.red(`Error: ${err.message}`));
     process.exit(1);
   }
 }
-

package/src/core/paths/output-schema.js

@@ -26,16 +26,18 @@ export const OUTPUT_SCHEMA = {
   proposal:      { filename: 'proposal.md',        phaseDir: '0-proposal',  phase: 'proposal',  protected: false },
   schemaAnalysis:{ filename: 'schema-analysis.md', phaseDir: '1-design',    phase: 'design',    protected: true,  approvalGate: 'design' },
   spec:          { filename: 'spec.md',             phaseDir: '1-design',    phase: 'design',    protected: true,  approvalGate: 'design' },
-  clarifications:{ filename: 'clarifications.md',  phaseDir: '2-clarify',   phase: 'clarify',   protected: false },
+  clarifications:{ filename: 'clarifications.md',  phaseDir: '1-design',    phase: 'clarify',   protected: false },
   contracts:     { filename: 'contracts.cs',        phaseDir: '1-design',    phase: 'design',    protected: true,  approvalGate: 'design' },
+  contractsTs:   { filename: 'contracts.ts',        phaseDir: '1-design',    phase: 'design',    protected: true,  approvalGate: 'design' },
   contractsVsa:  { filename: 'contracts-vsa.cs',    phaseDir: '1-design',    phase: 'design',    protected: true,  approvalGate: 'design' },
-  tasks:         { filename: 'tasks.md',            phaseDir: '3-tasks',     phase: 'tasks',     protected: true,  approvalGate: 'tasks' },
+  plan:          { filename: 'plan.md',             phaseDir: '3-plan',      phase: 'plan',      protected: true,  approvalGate: 'plan' },
+  tasks:         { filename: 'tasks.md',            phaseDir: '4-tasks',     phase: 'tasks',     protected: true,  approvalGate: 'tasks' },
   uiDesignSystem:{ filename: 'design-system.md',   phaseDir: '2-ui',        phase: 'uiux',      protected: true,  approvalGate: 'uiux' },
   uiMockups:     { filename: 'mockups.md',          phaseDir: '2-ui',        phase: 'uiux',      protected: true,  approvalGate: 'uiux' },
   uiComponents:  { filename: 'components.md',       phaseDir: '2-ui',        phase: 'uiux',      protected: true,  approvalGate: 'uiux' },
   uiFlows:       { filename: 'flows.md',            phaseDir: '2-ui',        phase: 'uiux',      protected: true,  approvalGate: 'uiux' },
   decisions:     { filename: 'decisions.md',        phaseDir: '1-design',    phase: 'design',    protected: false },
-  recap:         { filename: 'recap.md',            phaseDir: '4-implement', phase: 'implement', protected: false },
+  recap:         { filename: 'recap.md',            phaseDir: '5-implement', phase: 'implement', protected: false },
 };
 
 // ============================================================================
@@ -134,3 +136,17 @@ export const PROTECTED_SPEC_FILES = Object.fromEntries(
     .filter(([, entry]) => entry.protected && entry.approvalGate)
     .map(([, entry]) => [entry.filename, entry.approvalGate])
 );
+
+// ============================================================================
+// Stack-aware Helpers
+// ============================================================================
+
+/**
+ * Resolve the correct contracts output type key for a given stack.
+ * @param {string|null} stack
+ * @returns {'contracts'|'contractsTs'}
+ */
+export function resolveContractsOutputType(stack) {
+  const NEXTJS_STACKS = new Set(['nextjs', 'next', 'next.js']);
+  return NEXTJS_STACKS.has(stack?.toLowerCase?.()) ? 'contractsTs' : 'contracts';
+}

package/src/core/state/phase-state-machine.js

@@ -14,7 +14,8 @@ const VALID_TRANSITIONS = {
   'setup': ['uiux', 'design'], // Can skip UI/UX if no frontend
   'uiux': ['design'],
   'design': ['clarify'],
-  'clarify': ['tasks'],
+  'clarify': ['plan'],
+  'plan': ['tasks'],
   'tasks': ['implement'],
   'implement': ['sync', 'archived'], // Can skip sync
   'sync': ['archived']
@@ -29,9 +30,10 @@ const PHASE_NAMES = {
   'uiux': 'UI/UX Design (Phase 1.5)',
   'design': 'Design (Phase 2)',
   'clarify': 'Clarify (Phase 3)',
-  'tasks': 'Tasks (Phase 4)',
-  'implement': 'Implement (Phase 5)',
-  'sync': 'Sync (Phase 6)',
+  'plan': 'Plan (Phase 4)',
+  'tasks': 'Tasks (Phase 5)',
+  'implement': 'Implement (Phase 6)',
+  'sync': 'Sync (Phase 7)',
   'archived': 'Archived'
 };
 
@@ -124,6 +126,7 @@ export function getPhaseSequence() {
     'uiux',     // optional
     'design',
     'clarify',
+    'plan',
     'tasks',
     'implement',
     'sync',     // optional