@polymorphism-tech/morph-spec 9.0.0 → 9.1.0

package/src/commands/project/status.js

@@ -1,24 +1,7 @@
-/**
- * MORPH-SPEC Feature Status Command
- *
- * Displays a comprehensive dashboard showing feature progress, phase status,
- * outputs, slices, approvals, and next steps.
- *
- * Usage:
- *   morph-spec status <feature-name>
- *   morph-spec status <feature-name> --json
- *
- * Example:
- *   morph-spec status user-portal
- */
-
 import chalk from 'chalk';
 import { loadState, getFeature, derivePhase, deriveOutputs } from '../../core/state/state-manager.js';
 import { sliceProgress } from '../../../framework/hooks/shared/slice-progress.js';
 
-/**
- * Phase symbols for visual representation
- */
 const PHASE_SYMBOLS = {
   completed: '✅',
   current: '⏸️',
@@ -26,9 +9,6 @@ const PHASE_SYMBOLS = {
   skipped: '⊘'
 };
 
-/**
- * Phase definitions with order
- */
 const PHASE_ORDER = [
   { key: 'plan', name: 'FASE 1: PLAN', order: 0 },
   { key: 'uiux', name: 'FASE 2: UI/UX', order: 1, optional: true },
@@ -43,18 +23,13 @@ const PHASE_OUTPUTS = {
   review: ['verifierReport', 'reviewerReport']
 };
 
-/**
- * Calculate phase status (completed, current, pending, skipped)
- */
 function getPhaseStatus(phaseKey, currentPhase, feature) {
   const phase = PHASE_ORDER.find(p => p.key === phaseKey);
   const current = PHASE_ORDER.find(p => p.key === currentPhase);
 
   if (!phase || !current) return 'pending';
 
-  // Check if phase was skipped (optional phases)
   if (phase.optional && phase.order < current.order) {
-    // Check if any outputs were created for this phase
     const hasOutputs = checkPhaseOutputs(phaseKey, feature);
     if (!hasOutputs) return 'skipped';
   }
@@ -64,17 +39,11 @@ function getPhaseStatus(phaseKey, currentPhase, feature) {
   return 'pending';
 }
 
-/**
- * Check if phase has any outputs created
- */
 function checkPhaseOutputs(phaseKey, feature) {
   const outputs = PHASE_OUTPUTS[phaseKey] || [];
   return outputs.some(output => feature.outputs[output]?.created);
 }
 
-/**
- * Format phase display with symbol and status
- */
 function formatPhase(phaseKey, currentPhase, feature, options = {}) {
   const phase = PHASE_ORDER.find(p => p.key === phaseKey);
   const status = getPhaseStatus(phaseKey, currentPhase, feature);
@@ -96,7 +65,6 @@ function formatPhase(phaseKey, currentPhase, feature, options = {}) {
     display = chalk.gray(display);
   }
 
-  // Add output files if verbose
   if (options.verbose && status !== 'pending' && status !== 'skipped') {
     const outputs = PHASE_OUTPUTS[phaseKey] || [];
     const created = outputs.filter(o => feature.outputs[o]?.created);
@@ -108,9 +76,6 @@ function formatPhase(phaseKey, currentPhase, feature, options = {}) {
   return display;
 }
 
-/**
- * Calculate completion percentage
- */
 function calculateCompletionPercentage(feature) {
   const totalPhases = PHASE_ORDER.filter(p => !p.optional).length;
   const completedPhases = PHASE_ORDER.filter(p => {
@@ -122,13 +87,9 @@ function calculateCompletionPercentage(feature) {
   return Math.round((completedPhases / totalPhases) * 100);
 }
 
-/**
- * Get next steps based on current phase
- */
 function getNextSteps(feature) {
   const steps = [];
 
-  // Check for pending approvals relevant to current phase
   const phaseApprovalMap = {
     plan: 'plan',
     uiux: 'uiux',
@@ -147,7 +108,6 @@ function getNextSteps(feature) {
     });
   }
 
-  // Check for missing outputs in current phase
   const requiredOutputs = feature.phase === 'uiux' ? [] : PHASE_OUTPUTS[feature.phase] || [];
   const missingOutputs = requiredOutputs.filter(o => !feature.outputs[o]?.created);
 
@@ -159,7 +119,6 @@ function getNextSteps(feature) {
     });
   }
 
-  // Suggest next phase if current is complete
   const hasApprovalPending = relevantGate && approvalGates[relevantGate] && !approvalGates[relevantGate].approved;
   if (missingOutputs.length === 0 && !hasApprovalPending) {
     const currentPhaseIndex = PHASE_ORDER.findIndex(p => p.key === feature.phase);
@@ -182,9 +141,6 @@ function getNextSteps(feature) {
   return steps;
 }
 
-/**
- * Main status command
- */
 export async function statusCommand(featureName, options = {}) {
   if (!featureName) {
     console.error(chalk.red('✗ Error: Feature name required'));
@@ -206,7 +162,6 @@ export async function statusCommand(featureName, options = {}) {
     process.exit(1);
   }
 
-  // Derive phase and outputs from filesystem if not stored in state
   const { join } = await import('path');
   const featurePath = join(process.cwd(), '.morph', 'features', featureName);
   if (!feature.phase) {
@@ -217,7 +172,6 @@ export async function statusCommand(featureName, options = {}) {
   }
   const slices = sliceProgress(featurePath);
 
-  // JSON output mode
   if (options.json) {
     const status = {
       feature: featureName,
@@ -244,18 +198,15 @@ export async function statusCommand(featureName, options = {}) {
     return;
   }
 
-  // Visual dashboard output
   console.log(chalk.cyan('\n┌────────────────────────────────────────────────────────────┐'));
   console.log(chalk.cyan('│                   MORPH-SPEC STATUS                       │'));
   console.log(chalk.cyan('└────────────────────────────────────────────────────────────┘\n'));
 
-  // Feature info
   console.log(chalk.white.bold(`Feature: ${featureName}`));
   console.log(chalk.gray(`Status: ${feature.status || 'unknown'}`));
   console.log(chalk.gray(`Completion: ${calculateCompletionPercentage(feature)}%`));
   console.log('');
 
-  // Phase progression
   console.log(chalk.white.bold('Phases:'));
   console.log(chalk.cyan('├─────────────────────────────────────────────────────────────┤'));
   PHASE_ORDER.forEach(phase => {
@@ -264,7 +215,6 @@ export async function statusCommand(featureName, options = {}) {
   console.log(chalk.cyan('└─────────────────────────────────────────────────────────────┘'));
   console.log('');
 
-  // Outputs summary
   const totalOutputs = Object.keys(feature.outputs).length;
   const createdOutputs = Object.values(feature.outputs).filter(o => o.created).length;
   console.log(chalk.white.bold(`Outputs: ${createdOutputs}/${totalOutputs} complete`));
@@ -289,7 +239,6 @@ export async function statusCommand(featureName, options = {}) {
     console.log('');
   }
 
-  // Approval gates
   if (feature.approvalGates) {
     const gates = Object.entries(feature.approvalGates);
     const approved = gates.filter(([_, g]) => g.approved).length;
@@ -309,7 +258,6 @@ export async function statusCommand(featureName, options = {}) {
     console.log('');
   }
 
-  // Next steps
   const nextSteps = getNextSteps(feature);
   if (nextSteps.length > 0) {
     console.log(chalk.white.bold('Next Steps:'));
@@ -324,7 +272,6 @@ export async function statusCommand(featureName, options = {}) {
     console.log(chalk.green('✓ Nada pendente.\n'));
   }
 
-  // Footer
   console.log(chalk.gray('─'.repeat(60)));
   console.log(chalk.gray('Run with --verbose for detailed output'));
   console.log(chalk.gray('Run with --json for JSON output\n'));