@polymorphism-tech/morph-spec 3.1.0 → 4.2.0

package/bin/semantic-detect-agents.js

@@ -1,247 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * MORPH-SPEC Semantic Agent Detection (LLM-based)
- *
- * Uses LLM analysis to detect which agents should be activated based on user request.
- * More accurate than keyword matching - understands context and implicit needs.
- *
- * Usage:
- *   export ANTHROPIC_API_KEY=sk-...
- *   node bin/semantic-detect-agents.js "user request here"
- *
- * Falls back to keyword-based detection if API key not available.
- */
-
-import fs from 'fs';
-import path from 'path';
-import { fileURLToPath } from 'url';
-import { execSync } from 'child_process';
-import { resolveAgentsConfigPath } from '../src/lib/stack-resolver.js';
-
-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'
-};
-
-/**
- * Call Anthropic Claude API for semantic analysis
- */
-async function callClaudeAPI(userRequest, agentDescriptions) {
-  const apiKey = process.env.ANTHROPIC_API_KEY;
-
-  if (!apiKey) {
-    return null; // Will fall back to keyword detection
-  }
-
-  const prompt = `You are an expert at analyzing software development requests and determining which specialist agents are needed.
-
-Given this user request:
-"${userRequest}"
-
-And these available specialist agents:
-${agentDescriptions}
-
-Analyze the request and determine which specialist agents should be activated. Consider:
-- Explicit mentions (e.g., "create a dashboard" → UI/UX Designer)
-- Implicit needs (e.g., "show data to users" → UI/UX Designer)
-- Technical requirements (e.g., "scheduled tasks" → Hangfire Orchestrator)
-- Architecture patterns (e.g., "RAG pipeline" → AI System Architect)
-
-Respond with ONLY a JSON array of agent IDs, like:
-["uiux-designer", "hangfire-orchestrator"]
-
-If no specialists are needed, respond with: []
-Do not include core agents (they are always active).`;
-
-  try {
-    const response = await fetch('https://api.anthropic.com/v1/messages', {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'application/json',
-        'x-api-key': apiKey,
-        'anthropic-version': '2023-06-01'
-      },
-      body: JSON.stringify({
-        model: 'claude-3-haiku-20240307',
-        max_tokens: 200,
-        messages: [{
-          role: 'user',
-          content: prompt
-        }]
-      })
-    });
-
-    if (!response.ok) {
-      const error = await response.text();
-      console.error(`${colors.yellow}⚠ Claude API error: ${error}${colors.reset}`);
-      return null;
-    }
-
-    const data = await response.json();
-    const content = data.content[0].text.trim();
-
-    // Parse JSON response
-    const agentIds = JSON.parse(content);
-    return agentIds;
-  } catch (error) {
-    console.error(`${colors.yellow}⚠ Claude API failed: ${error.message}${colors.reset}`);
-    return null;
-  }
-}
-
-/**
- * Fallback: keyword-based detection (existing behavior)
- */
-function keywordBasedDetection(userRequest) {
-  console.log(`${colors.yellow}ℹ Using keyword-based detection (fallback)${colors.reset}`);
-
-  try {
-    const result = execSync(`node bin/detect-agents.js "${userRequest}" --json`, {
-      encoding: 'utf-8',
-      cwd: process.cwd()
-    });
-
-    const parsed = JSON.parse(result);
-    return parsed.specialists || [];
-  } catch (error) {
-    console.error(`${colors.red}✗ Fallback detection failed: ${error.message}${colors.reset}`);
-    return [];
-  }
-}
-
-/**
- * Load agent descriptions for LLM context
- */
-function loadAgentDescriptions() {
-  const agentsPath = resolveAgentsConfigPath(process.cwd());
-
-  if (!fs.existsSync(agentsPath)) {
-    throw new Error('agents.json not found');
-  }
-
-  const agents = JSON.parse(fs.readFileSync(agentsPath, 'utf-8'));
-  const specialists = agents.agents.specialists || [];
-
-  return specialists.map(agent =>
-    `- ${agent.id}: ${agent.description}`
-  ).join('\n');
-}
-
-/**
- * Print detection results
- */
-function printResults(agentIds, method, userRequest) {
-  console.log(`\n${colors.cyan}╔════════════════════════════════════════════════╗${colors.reset}`);
-  console.log(`${colors.cyan}║     MORPH-SPEC SEMANTIC AGENT DETECTION        ║${colors.reset}`);
-  console.log(`${colors.cyan}╚════════════════════════════════════════════════╝${colors.reset}\n`);
-
-  console.log(`${colors.gray}Request:${colors.reset} "${userRequest}"`);
-  console.log(`${colors.gray}Method:${colors.reset} ${method}`);
-  console.log(`${colors.gray}Agents Detected:${colors.reset} ${agentIds.length}`);
-
-  if (agentIds.length > 0) {
-    console.log('');
-    agentIds.forEach(id => {
-      console.log(`  ${colors.green}✓${colors.reset} ${id}`);
-    });
-  } else {
-    console.log(`\n  ${colors.gray}(No specialist agents needed)${colors.reset}`);
-  }
-
-  console.log('');
-}
-
-/**
- * Print help
- */
-function printHelp() {
-  console.log(`
-${colors.cyan}MORPH-SPEC Semantic Agent Detection${colors.reset}
-
-Uses LLM analysis to detect which agents should be activated.
-More accurate than keyword matching - understands context.
-
-${colors.green}Setup:${colors.reset}
-  export ANTHROPIC_API_KEY=sk-ant-...
-
-${colors.green}Usage:${colors.reset}
-  node bin/semantic-detect-agents.js "user request here"
-
-${colors.green}Examples:${colors.reset}
-  # Detects UI/UX Designer (implicit need)
-  node bin/semantic-detect-agents.js "sistema que mostra dados ao usuário"
-
-  # Detects Hangfire Orchestrator
-  node bin/semantic-detect-agents.js "processar arquivos todo dia às 3h"
-
-  # Detects AI System Architect
-  node bin/semantic-detect-agents.js "pipeline de RAG com chunking"
-
-${colors.green}Fallback:${colors.reset}
-  If ANTHROPIC_API_KEY is not set, falls back to keyword-based detection.
-
-${colors.green}Benefits:${colors.reset}
-  ✓ Understands context ("show data to users" → UI)
-  ✓ Works in any language (not just keywords)
-  ✓ Eliminates false positives/negatives
-  ✓ Detects implicit needs
-
-${colors.green}Output:${colors.reset}
-  Prints detected agent IDs, one per line, for use in scripts.
-  `);
-}
-
-/**
- * Main function
- */
-async function main() {
-  const args = process.argv.slice(2);
-
-  if (args.includes('--help') || args.includes('-h') || args.length === 0) {
-    printHelp();
-    process.exit(args.length === 0 ? 1 : 0);
-  }
-
-  const userRequest = args.join(' ');
-  const hasApiKey = !!process.env.ANTHROPIC_API_KEY;
-
-  let agentIds;
-  let method;
-
-  if (hasApiKey) {
-    method = `${colors.green}LLM-based (Claude Haiku)${colors.reset}`;
-    const agentDescriptions = loadAgentDescriptions();
-    agentIds = await callClaudeAPI(userRequest, agentDescriptions);
-
-    if (!agentIds) {
-      // API failed, fall back
-      method = `${colors.yellow}Keyword-based (API fallback)${colors.reset}`;
-      agentIds = keywordBasedDetection(userRequest);
-    }
-  } else {
-    method = `${colors.yellow}Keyword-based (no API key)${colors.reset}`;
-    agentIds = keywordBasedDetection(userRequest);
-  }
-
-  printResults(agentIds, method, userRequest);
-
-  // Output for scripting (one ID per line)
-  if (args.includes('--quiet') || args.includes('-q')) {
-    console.clear();
-    agentIds.forEach(id => console.log(id));
-  }
-}
-
-main().catch(error => {
-  console.error(`${colors.red}✗ Error: ${error.message}${colors.reset}`);
-  process.exit(1);
-});

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();