@polymorphism-tech/morph-spec 4.21.0 → 5.0.1

package/src/commands/scope/escalate.js

@@ -1,217 +0,0 @@
-/**
- * MORPH-SPEC Scope Escalate Command
- *
- * Handles mid-implementation scope discovery by analyzing impact,
- * regressing phase or expanding tasks, and creating an audit trail.
- *
- * Usage:
- *   morph-spec scope escalate <feature> --task <id> --reason "..."
- *   morph-spec scope escalate <feature> --task <id> --reason "..." --dry-run
- *   morph-spec scope escalate <feature> --task <id> --reason "..." --target design
- */
-
-import chalk from 'chalk';
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
-import { loadState, saveState, derivePhase } from '../../core/state/state-manager.js';
-import { analyzeImpact } from '../../lib/scope/impact-analyzer.js';
-
-/**
- * Core escalation logic — exported for testing.
- *
- * @param {string} featureName
- * @param {Object} options
- * @param {string} options.task - Trigger task ID
- * @param {string} options.reason - Reason for escalation
- * @param {string} [options.target] - Override target phase
- * @param {boolean} [options.dryRun] - Don't execute, just recommend
- * @returns {Promise<{ success: boolean, error?: string, recommendation?: Object }>}
- */
-export async function escalateScope(featureName, options) {
-  const state = loadState();
-  const feature = state.features[featureName];
-
-  if (!feature) {
-    return { success: false, error: `Feature "${featureName}" not found in state.json` };
-  }
-
-  const featurePath = join(process.cwd(), '.morph', 'features', featureName);
-  const currentPhase = feature.phase || derivePhase(featurePath);
-  if (currentPhase !== 'implement') {
-    return { success: false, error: `Scope escalation only available during implement phase (current: ${currentPhase})` };
-  }
-
-  // Read tasks.md
-  const tasksPath = join(process.cwd(), '.morph', 'features', featureName, '4-tasks', 'tasks.md');
-  let tasksMd = '';
-  try {
-    tasksMd = readFileSync(tasksPath, 'utf-8');
-  } catch {
-    return { success: false, error: 'tasks.md not found' };
-  }
-
-  // Read spec.md (optional — not all features have it)
-  const specPath = join(process.cwd(), '.morph', 'features', featureName, '2-design', 'spec.md');
-  let specMd = '';
-  try { specMd = readFileSync(specPath, 'utf-8'); } catch { /* ok */ }
-
-  // Analyze impact
-  const analysis = analyzeImpact({
-    triggerTaskId: options.task,
-    tasksMd,
-    specMd,
-    reason: options.reason
-  });
-
-  // Apply target override
-  if (options.target) {
-    analysis.recommendation = `regress-${options.target}`;
-    analysis.targetPhase = options.target;
-    if (analysis.targetPhase === 'design') analysis.impact = 'high';
-    else if (analysis.targetPhase === 'tasks') analysis.impact = 'medium';
-  }
-
-  // Dry-run: return recommendation without modifying state
-  if (options.dryRun) {
-    return { success: true, recommendation: analysis };
-  }
-
-  // Build escalation record
-  const escId = `ESC-${String((feature.escalations?.length || 0) + 1).padStart(3, '0')}`;
-  const record = {
-    id: escId,
-    triggerTask: options.task,
-    reason: options.reason,
-    impact: analysis.impact,
-    action: analysis.recommendation,
-    affectedTasks: analysis.affectedTasks,
-    reviewedTasks: [],
-    targetPhase: analysis.targetPhase || 'tasks',
-    previousPhase: 'implement',
-    createdAt: new Date().toISOString(),
-    resolvedAt: null
-  };
-
-  // Execute based on recommendation
-  if (analysis.recommendation.startsWith('regress')) {
-    const targetPhase = analysis.targetPhase || 'tasks';
-
-    // Flag completed tasks as needsReview (supports both v2 'done' and v3 'completed')
-    if (feature.taskList) {
-      for (const task of feature.taskList) {
-        if (task.status === 'done' || task.status === 'completed') {
-          task.needsReview = true;
-        }
-      }
-    }
-
-    // Reset phase
-    feature.phase = targetPhase;
-
-    // Reset relevant approval gates
-    if (feature.approvalGates) {
-      if (targetPhase === 'tasks' && feature.approvalGates.tasks) {
-        feature.approvalGates.tasks = { approved: false, timestamp: null, approvedBy: null };
-      }
-      if (targetPhase === 'design') {
-        if (feature.approvalGates.design) {
-          feature.approvalGates.design = { approved: false, timestamp: null, approvedBy: null };
-        }
-        if (feature.approvalGates.tasks) {
-          feature.approvalGates.tasks = { approved: false, timestamp: null, approvedBy: null };
-        }
-      }
-    }
-  }
-
-  // Write escalation record to state
-  if (!feature.escalations) feature.escalations = [];
-  feature.escalations.push(record);
-  feature.updatedAt = new Date().toISOString();
-
-  saveState(state);
-
-  // Create/append escalation-log.md
-  writeEscalationLog(featureName, record);
-
-  return { success: true, recommendation: analysis, escalationId: escId };
-}
-
-/**
- * Write escalation log entry to 4-tasks/escalation-log.md
- */
-function writeEscalationLog(featureName, record) {
-  const logDir = join(process.cwd(), '.morph', 'features', featureName, '4-tasks');
-  mkdirSync(logDir, { recursive: true });
-  const logPath = join(logDir, 'escalation-log.md');
-
-  const doneTasks = record.reviewedTasks?.length > 0
-    ? record.reviewedTasks.join(', ')
-    : '(all completed tasks flagged)';
-
-  const entry = `
-## ${record.id} — ${record.createdAt.split('T')[0]}
-- **Trigger:** ${record.triggerTask}
-- **Discovery:** ${record.reason}
-- **Impact:** ${record.impact} (${record.affectedTasks.length} tasks affected: ${record.affectedTasks.join(', ')})
-- **Action:** ${record.action} → ${record.targetPhase} phase
-- **Affected completed tasks flagged for review:** ${doneTasks}
-`;
-
-  let existing = '';
-  try { existing = readFileSync(logPath, 'utf-8'); } catch { /* new file */ }
-
-  if (!existing) {
-    writeFileSync(logPath, `# Scope Escalation Log\n${entry}`);
-  } else {
-    writeFileSync(logPath, existing + entry);
-  }
-}
-
-/**
- * CLI command handler
- */
-export async function scopeEscalateCommand(feature, options) {
-  console.log(chalk.cyan('\n========================================'));
-  console.log(chalk.cyan('  MORPH-SPEC SCOPE ESCALATION'));
-  console.log(chalk.cyan('========================================\n'));
-
-  if (!options.task) {
-    console.error(chalk.red('--task <id> is required'));
-    process.exit(1);
-  }
-  if (!options.reason) {
-    console.error(chalk.red('--reason "..." is required'));
-    process.exit(1);
-  }
-
-  const result = await escalateScope(feature, options);
-
-  if (!result.success) {
-    console.error(chalk.red(`\n  ${result.error}`));
-    process.exit(1);
-  }
-
-  const rec = result.recommendation;
-  console.log(chalk.gray('Trigger task:'), rec.triggerTask);
-  console.log(chalk.gray('Impact:'), rec.impact);
-  console.log(chalk.gray('Affected tasks:'), rec.affectedTasks.join(', '));
-  console.log(chalk.gray('Recommendation:'), rec.recommendation);
-  if (rec.targetPhase) console.log(chalk.gray('Target phase:'), rec.targetPhase);
-
-  if (options.dryRun) {
-    console.log(chalk.cyan('\n  Dry-run — no changes made'));
-    process.exit(2);
-  }
-
-  if (rec.recommendation === 'expand') {
-    console.log(chalk.green(`\n  Escalation ${result.escalationId} recorded (low impact)`));
-    console.log(chalk.yellow(`  Action: Use task expand to split the task:`));
-    console.log(chalk.gray(`    morph-spec task expand ${feature} ${options.task} --into "ID: Title" ...`));
-  } else {
-    console.log(chalk.green(`\n  Escalation ${result.escalationId} executed`));
-    console.log(chalk.yellow(`  Phase regressed to: ${rec.targetPhase || 'tasks'}`));
-  }
-  console.log(chalk.gray(`  Escalation log: .morph/features/${feature}/4-tasks/escalation-log.md`));
-  console.log('');
-}