@polymorphism-tech/morph-spec 3.2.0 → 4.3.0

package/bin/validate-agents-skills.js

@@ -1,257 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * MORPH-SPEC Agent-Skill Validator
- *
- * Valida a consistência entre agents.json e arquivos de skills.
- * Garante que não há agentes sem skills ou skills sem agentes (orphans).
- *
- * Uso:
- *   node bin/validate-agents-skills.js
- *   node bin/validate-agents-skills.js --verbose
- */
-
-import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { resolveAgentsConfigPath, resolveStackPath } from '../src/lib/stack-resolver.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const frameworkRoot = join(__dirname, '..');
-const AGENTS_CONFIG_PATH = resolveAgentsConfigPath(frameworkRoot);
-const SKILLS_BASE_PATH = join(resolveStackPath(frameworkRoot), '.claude/skills');
-
-// Cores para output
-const colors = {
-  reset: '\x1b[0m',
-  bright: '\x1b[1m',
-  green: '\x1b[32m',
-  yellow: '\x1b[33m',
-  red: '\x1b[31m',
-  cyan: '\x1b[36m',
-  gray: '\x1b[90m'
-};
-
-function log(message, color = 'reset') {
-  console.log(`${colors[color]}${message}${colors.reset}`);
-}
-
-/**
- * Carrega agents.json
- */
-function loadAgentsConfig() {
-  try {
-    const content = readFileSync(AGENTS_CONFIG_PATH, 'utf8');
-    return JSON.parse(content);
-  } catch (err) {
-    log(`ERROR: Failed to load agents.json: ${err.message}`, 'red');
-    process.exit(1);
-  }
-}
-
-/**
- * Recursivamente lista todos os arquivos .md no diretório de skills
- */
-function getAllSkillFiles(dir, fileList = []) {
-  const files = readdirSync(dir);
-
-  files.forEach(file => {
-    const filePath = join(dir, file);
-    const stat = statSync(filePath);
-
-    if (stat.isDirectory()) {
-      getAllSkillFiles(filePath, fileList);
-    } else if (file.endsWith('.md')) {
-      // Converter para path relativo ao stacks/blazor-azure/
-      const stackPath = resolveStackPath(frameworkRoot).replace(/\\/g, '/');
-      const normalizedFile = filePath.replace(/\\/g, '/');
-      const relativePath = normalizedFile.startsWith(stackPath)
-        ? normalizedFile.slice(stackPath.length + 1)
-        : normalizedFile;
-      fileList.push(relativePath);
-    }
-  });
-
-  return fileList;
-}
-
-/**
- * Valida agents vs skills
- */
-function validateAgentsSkills(config, verbose = false) {
-  const errors = [];
-  const warnings = [];
-  const info = [];
-
-  // 1. Coletar todos os agentes e seus skillPaths
-  const allAgents = [...config.agents.core, ...config.agents.specialists];
-  const agentSkillPaths = new Set();
-
-  for (const agent of allAgents) {
-    if (agent.skillPath) {
-      agentSkillPaths.add(agent.skillPath);
-
-      // Verificar se skill file existe
-      const skillFilePath = join(__dirname, '../content', agent.skillPath);
-      if (!existsSync(skillFilePath)) {
-        errors.push({
-          type: 'missing-skill',
-          agent: agent.id,
-          skillPath: agent.skillPath,
-          message: `Agent '${agent.id}' references non-existent skill: ${agent.skillPath}`
-        });
-      } else if (verbose) {
-        info.push({
-          type: 'valid-mapping',
-          agent: agent.id,
-          skillPath: agent.skillPath,
-          message: `✓ ${agent.id} → ${agent.skillPath}`
-        });
-      }
-    } else if (verbose) {
-      warnings.push({
-        type: 'no-skill',
-        agent: agent.id,
-        message: `Agent '${agent.id}' has no skillPath defined (metadata-only agent)`
-      });
-    }
-  }
-
-  // 2. Verificar skills órfãs (sem agente correspondente)
-  const allSkillFiles = getAllSkillFiles(SKILLS_BASE_PATH);
-
-  for (const skillFile of allSkillFiles) {
-    const skillPath = `.claude/skills/${skillFile.replace('.claude/skills/', '')}`;
-
-    if (!agentSkillPaths.has(skillPath)) {
-      // Orphan skills são OK - podem ser usados manualmente
-      // Apenas reportar em verbose mode
-      if (verbose) {
-        info.push({
-          type: 'manual-skill',
-          skillPath: skillPath,
-          message: `ℹ️  Manual skill: ${skillPath} (no auto-activation)`
-        });
-      }
-    }
-  }
-
-  return { errors, warnings, info };
-}
-
-/**
- * Formata e exibe resultados
- */
-function displayResults(results, verbose) {
-  const { errors, warnings, info } = results;
-
-  log('\n╔════════════════════════════════════════════════════════════════╗', 'cyan');
-  log('║           MORPH-SPEC AGENT-SKILL VALIDATION REPORT            ║', 'cyan');
-  log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-
-  // Erros
-  if (errors.length > 0) {
-    log('║ ERRORS                                                         ║', 'red');
-    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-
-    errors.forEach(err => {
-      log(`║ ❌ ${err.message.substring(0, 61).padEnd(61)}║`, 'red');
-    });
-
-    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-  }
-
-  // Warnings
-  if (warnings.length > 0) {
-    log('║ WARNINGS                                                       ║', 'yellow');
-    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-
-    warnings.forEach(warn => {
-      // Quebrar mensagens longas
-      const lines = warn.message.match(/.{1,60}/g) || [warn.message];
-      lines.forEach((line, idx) => {
-        if (idx === 0) {
-          log(`║ ⚠️  ${line.padEnd(61)}║`, 'yellow');
-        } else {
-          log(`║    ${line.padEnd(61)}║`, 'yellow');
-        }
-      });
-    });
-
-    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-  }
-
-  // Info (verbose mode)
-  if (verbose && info.length > 0) {
-    log('║ VALID MAPPINGS                                                 ║', 'green');
-    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-
-    info.forEach(item => {
-      log(`║ ${item.message.substring(0, 62).padEnd(62)}║`, 'gray');
-    });
-
-    log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-  }
-
-  // Summary
-  log('║ SUMMARY                                                        ║', 'cyan');
-  log('╠════════════════════════════════════════════════════════════════╣', 'cyan');
-  log(`║ Errors: ${errors.length.toString().padEnd(56)}║`, errors.length > 0 ? 'red' : 'green');
-  log(`║ Warnings: ${warnings.length.toString().padEnd(54)}║`, warnings.length > 0 ? 'yellow' : 'green');
-
-  if (errors.length === 0 && warnings.length === 0) {
-    log('║                                                                ║', 'cyan');
-    log('║ ✅ All agents and skills are properly mapped!                  ║', 'green');
-  }
-
-  // Nota sobre manual skills
-  const manualSkills = info.filter(i => i.type === 'manual-skill').length;
-  if (manualSkills > 0 && verbose) {
-    log('║                                                                ║', 'cyan');
-    log(`║ ℹ️  ${manualSkills} manual-only skills found (use --verbose to see)    ║`, 'gray');
-    log('║   These are extra skills without auto-activation.             ║', 'gray');
-  }
-
-  log('╚════════════════════════════════════════════════════════════════╝\n', 'cyan');
-}
-
-// ============================================================================
-// MAIN
-// ============================================================================
-
-function main() {
-  const args = process.argv.slice(2);
-  const verbose = args.includes('--verbose') || args.includes('-v');
-  const hasHelp = args.includes('--help') || args.includes('-h');
-
-  if (hasHelp) {
-    log('\nMORPH-SPEC Agent-Skill Validator', 'bright');
-    log('\nUsage:', 'cyan');
-    log('  node bin/validate-agents-skills.js [options]', 'gray');
-    log('\nOptions:', 'cyan');
-    log('  -v, --verbose     Show all valid mappings', 'gray');
-    log('  -h, --help        Show this help', 'gray');
-    log('\nDescription:', 'cyan');
-    log('  Validates consistency between agents.json and skill files.', 'gray');
-    log('  - Checks if all skillPaths exist', 'gray');
-    log('  - Detects orphan skills (no corresponding agent)', 'gray');
-    log('  - Exit code 0 if valid, 1 if errors found\n', 'gray');
-    process.exit(0);
-  }
-
-  // Load config and validate
-  const config = loadAgentsConfig();
-  const results = validateAgentsSkills(config, verbose);
-
-  // Display results
-  displayResults(results, verbose);
-
-  // Exit with appropriate code
-  if (results.errors.length > 0) {
-    process.exit(1);
-  }
-
-  process.exit(0);
-}
-
-main();

package/bin/validate-agents.js

@@ -1,70 +0,0 @@
-#!/usr/bin/env node
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import Ajv from 'ajv';
-import addFormats from 'ajv-formats';
-import { resolveAgentsConfigPath, resolveStackPath } from '../src/lib/stack-resolver.js';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-function main() {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h')) {
-    console.log('Usage: node bin/validate-agents.js [agents-file-path]');
-    process.exit(0);
-  }
-
-  const defaultPath = resolveAgentsConfigPath(process.cwd());
-  const agentsPath = args[0] || defaultPath;
-  const schemaPath = path.join(resolveStackPath(path.join(__dirname, '..')), '.morph/schemas/agent.schema.json');
-
-  if (!fs.existsSync(agentsPath)) {
-    console.error('Error: agents.json not found at', agentsPath);
-    process.exit(1);
-  }
-
-  if (!fs.existsSync(schemaPath)) {
-    console.error('Error: Schema not found at', schemaPath);
-    process.exit(1);
-  }
-
-  try {
-    const schema = JSON.parse(fs.readFileSync(schemaPath, 'utf-8'));
-    const agents = JSON.parse(fs.readFileSync(agentsPath, 'utf-8'));
-
-    const ajv = new Ajv({ allErrors: true, verbose: true, strict: true });
-    addFormats(ajv);
-
-    const validate = ajv.compile(schema);
-    const valid = validate(agents);
-
-    console.log('\n=== MORPH-SPEC Agent Validator ===\n');
-    console.log('Version:', agents.version || 'unknown');
-    console.log('Core Agents:', agents.agents?.core?.length || 0);
-    console.log('Specialist Agents:', agents.agents?.specialists?.length || 0);
-
-    if (valid) {
-      console.log('\n✓ Validation PASSED\n');
-      process.exit(0);
-    } else {
-      console.log('\n✗ Validation FAILED\n');
-      console.log('Errors:');
-      validate.errors.forEach((err, i) => {
-        console.log(`${i + 1}. ${err.instancePath || '/'}: ${err.message}`);
-        if (err.params) {
-          console.log('   Params:', JSON.stringify(err.params));
-        }
-      });
-      console.log('');
-      process.exit(1);
-    }
-  } catch (error) {
-    console.error('Error:', error.message);
-    process.exit(1);
-  }
-}
-
-main();

package/bin/validate-phase.js

@@ -1,263 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * MORPH-SPEC Phase Validator
- *
- * Validates that required previous phases have been completed before advancing.
- * Prevents skipping phases accidentally.
- *
- * Usage:
- *   node bin/validate-phase.js <feature-name> <target-phase>
- *
- * Example:
- *   node bin/validate-phase.js scheduled-reports implement
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
-
-// ANSI colors
-const colors = {
-  green: '\x1b[32m',
-  red: '\x1b[31m',
-  yellow: '\x1b[33m',
-  cyan: '\x1b[36m',
-  gray: '\x1b[90m',
-  reset: '\x1b[0m'
-};
-
-// Phase definitions with requirements
-const PHASES = {
-  'proposal': {
-    order: 0,
-    name: 'FASE 0: PROPOSAL',
-    requiredOutputs: ['proposal.md'],
-    description: 'Initial proposal and agent detection'
-  },
-  'setup': {
-    order: 1,
-    name: 'FASE 1: SETUP',
-    requiredOutputs: ['proposal.md'],
-    description: 'Load context and standards'
-  },
-  'uiux-design': {
-    order: 2,
-    name: 'FASE 1.5: UI/UX DESIGN',
-    requiredOutputs: ['proposal.md', 'ui-design-system.md', 'ui-mockups.md', 'ui-components.md', 'ui-flows.md'],
-    description: 'UI/UX design (conditional - only if frontend)',
-    optional: true
-  },
-  'design': {
-    order: 3,
-    name: 'FASE 2: DESIGN',
-    requiredOutputs: ['proposal.md', 'spec.md', 'contracts.cs', 'decisions.md'],
-    description: 'Technical specification and contracts'
-  },
-  'clarify': {
-    order: 4,
-    name: 'FASE 3: CLARIFY',
-    requiredOutputs: ['proposal.md', 'spec.md', 'contracts.cs'],
-    description: 'Clarify ambiguities and edge cases'
-  },
-  'tasks': {
-    order: 5,
-    name: 'FASE 4: TASKS',
-    requiredOutputs: ['proposal.md', 'spec.md', 'contracts.cs', 'tasks.json'],
-    description: 'Break down into executable tasks'
-  },
-  'implement': {
-    order: 6,
-    name: 'FASE 5: IMPLEMENT',
-    requiredOutputs: ['proposal.md', 'spec.md', 'contracts.cs', 'tasks.json'],
-    description: 'Execute tasks and implement code'
-  },
-  'sync': {
-    order: 7,
-    name: 'FASE 6: SYNC',
-    requiredOutputs: ['proposal.md', 'spec.md', 'decisions.md', 'recap.md'],
-    description: 'Sync decisions to project standards',
-    optional: true
-  }
-};
-
-/**
- * Check if output file exists
- */
-function checkOutput(featurePath, outputFile) {
-  const filePath = path.join(featurePath, outputFile);
-  return fs.existsSync(filePath);
-}
-
-/**
- * Validate phase requirements
- */
-function validatePhase(featureName, targetPhase) {
-  const featurePath = path.join(process.cwd(), '.morph/project/outputs', featureName);
-
-  // Check if feature directory exists
-  if (!fs.existsSync(featurePath)) {
-    return {
-      valid: false,
-      error: `Feature directory not found: ${featurePath}`,
-      missingOutputs: [],
-      phase: null
-    };
-  }
-
-  // Get target phase definition
-  const phaseDefinition = PHASES[targetPhase];
-  if (!phaseDefinition) {
-    return {
-      valid: false,
-      error: `Unknown phase: ${targetPhase}`,
-      validPhases: Object.keys(PHASES),
-      missingOutputs: [],
-      phase: null
-    };
-  }
-
-  // Check required outputs
-  const missingOutputs = [];
-  for (const output of phaseDefinition.requiredOutputs) {
-    if (!checkOutput(featurePath, output)) {
-      missingOutputs.push(output);
-    }
-  }
-
-  // Special validation: if target is 'implement', check tasks.json structure
-  if (targetPhase === 'implement' && checkOutput(featurePath, 'tasks.json')) {
-    try {
-      const tasksPath = path.join(featurePath, 'tasks.json');
-      const tasks = JSON.parse(fs.readFileSync(tasksPath, 'utf-8'));
-
-      if (!tasks.tasks || !Array.isArray(tasks.tasks) || tasks.tasks.length === 0) {
-        missingOutputs.push('tasks.json (must contain tasks array)');
-      }
-    } catch (error) {
-      missingOutputs.push('tasks.json (invalid JSON)');
-    }
-  }
-
-  return {
-    valid: missingOutputs.length === 0,
-    error: null,
-    missingOutputs,
-    phase: phaseDefinition,
-    featurePath
-  };
-}
-
-/**
- * Print validation result
- */
-function printResult(result, featureName, targetPhase) {
-  console.log(`\n${colors.cyan}╔════════════════════════════════════════════════╗${colors.reset}`);
-  console.log(`${colors.cyan}║     MORPH-SPEC PHASE VALIDATOR                 ║${colors.reset}`);
-  console.log(`${colors.cyan}╚════════════════════════════════════════════════╝${colors.reset}\n`);
-
-  console.log(`${colors.gray}Feature:${colors.reset} ${featureName}`);
-  console.log(`${colors.gray}Target Phase:${colors.reset} ${result.phase ? result.phase.name : targetPhase}`);
-
-  if (result.phase) {
-    console.log(`${colors.gray}Description:${colors.reset} ${result.phase.description}`);
-  }
-
-  if (result.valid) {
-    console.log(`\n${colors.green}✓ VALIDATION PASSED${colors.reset}`);
-    console.log(`${colors.green}  All required outputs are present.${colors.reset}`);
-    console.log(`${colors.green}  Safe to proceed to ${result.phase.name}${colors.reset}\n`);
-  } else {
-    console.log(`\n${colors.red}✗ VALIDATION FAILED${colors.reset}`);
-
-    if (result.error) {
-      console.log(`${colors.red}  Error: ${result.error}${colors.reset}\n`);
-
-      if (result.validPhases) {
-        console.log(`${colors.yellow}Valid phases:${colors.reset}`);
-        result.validPhases.forEach(phase => {
-          console.log(`  - ${phase}`);
-        });
-      }
-    } else {
-      console.log(`${colors.red}  Missing required outputs:${colors.reset}`);
-      result.missingOutputs.forEach(output => {
-        console.log(`  ${colors.gray}-${colors.reset} ${output}`);
-      });
-
-      console.log(`\n${colors.yellow}Action required:${colors.reset}`);
-      console.log(`  Complete the missing outputs before advancing to ${result.phase.name}`);
-    }
-    console.log('');
-  }
-}
-
-/**
- * Print help
- */
-function printHelp() {
-  console.log(`
-${colors.cyan}MORPH-SPEC Phase Validator${colors.reset}
-
-Validates that required previous phases have been completed before advancing.
-
-${colors.green}Usage:${colors.reset}
-  node bin/validate-phase.js <feature-name> <target-phase>
-
-${colors.green}Arguments:${colors.reset}
-  feature-name    Name of the feature (kebab-case)
-  target-phase    Phase you want to advance to
-
-${colors.green}Valid Phases:${colors.reset}
-  proposal        FASE 0: Initial proposal
-  setup           FASE 1: Load context and standards
-  uiux-design     FASE 1.5: UI/UX design (optional)
-  design          FASE 2: Technical specification
-  clarify         FASE 3: Clarify ambiguities
-  tasks           FASE 4: Break down into tasks
-  implement       FASE 5: Execute implementation
-  sync            FASE 6: Sync to project standards (optional)
-
-${colors.green}Examples:${colors.reset}
-  # Check if ready to implement
-  node bin/validate-phase.js scheduled-reports implement
-
-  # Check if ready for design phase
-  node bin/validate-phase.js user-auth design
-
-  # Use in slash command
-  node bin/validate-phase.js my-feature implement || exit 1
-
-${colors.green}Exit Codes:${colors.reset}
-  0 - Validation passed (safe to proceed)
-  1 - Validation failed (missing requirements)
-
-${colors.green}Integration:${colors.reset}
-  This validator is designed to be called from slash commands like
-  /morph-apply to ensure phase gates are respected.
-  `);
-}
-
-/**
- * Main function
- */
-function main() {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h') || args.length < 2) {
-    printHelp();
-    process.exit(args.length < 2 ? 1 : 0);
-  }
-
-  const [featureName, targetPhase] = args;
-
-  const result = validatePhase(featureName, targetPhase);
-  printResult(result, featureName, targetPhase);
-
-  process.exit(result.valid ? 0 : 1);
-}
-
-main();