@polymorphism-tech/morph-spec 3.2.0 → 4.2.0

package/docs/validation-checklist.md

@@ -25,7 +25,6 @@ Checklist para validar o framework em um projeto real.
 - [ ] `.morph/templates/infra/` contém 9 arquivos Bicep
 - [ ] `.morph/templates/integrations/` contém 4 arquivos
 - [ ] `.morph/templates/saas/` contém 2 arquivos
-- [ ] `.morph/examples/` contém 3 exemplos
 - [ ] `.claude/commands/` contém 6 comandos
 - [ ] `.claude/skills/` contém 17 skills
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "3.2.0",
+  "version": "4.2.0",
   "description": "MORPH-SPEC v3: AI-First development framework with validation pipeline, .NET 10, Microsoft Agent Framework, and Fluent UI Blazor",
   "keywords": [
     "claude-code",

package/src/commands/agents/index.js

@@ -0,0 +1,4 @@
+/**
+ * Agent Team Commands
+ */
+export { spawnTeamCommand } from './spawn-team.js';

package/src/commands/{spawn-team.js → agents/spawn-team.js}

@@ -1,172 +1,172 @@
-import { Command } from 'commander';
-import chalk from 'chalk';
-import { getFeature } from '../lib/state-manager.js';
-import { orchestrateTeam } from '../lib/team-orchestrator.js';
-
-/**
- * Spawn Team Command - Generate agent team configurations
- *
- * Reads active agents from feature state and generates ready-to-use
- * Task tool configurations for spawning agent teams.
- */
-
-const program = new Command();
-
-/**
- * Spawn team action function
- */
-export async function spawnTeamCommand(featureName, options = {}) {
-    try {
-      // Get feature state
-      const feature = getFeature(featureName);
-      if (!feature) {
-        console.error(chalk.red(`\n❌ Feature not found: ${featureName}\n`));
-        process.exit(1);
-      }
-
-      if (!feature.activeAgents || feature.activeAgents.length === 0) {
-        console.error(chalk.yellow(`\n⚠️  No active agents found for feature: ${featureName}`));
-        console.log(chalk.gray('Run "morph-spec detect-agents" first to identify agents.\n'));
-        process.exit(1);
-      }
-
-      // Determine if multi-domain
-      const domains = new Set();
-      feature.activeAgents.forEach(agentId => {
-        if (agentId.includes('dotnet') || agentId.includes('ef') || agentId.includes('api')) {
-          domains.add('backend');
-        }
-        if (agentId.includes('blazor') || agentId.includes('nextjs') || agentId.includes('ui')) {
-          domains.add('frontend');
-        }
-        if (agentId.includes('azure') || agentId.includes('bicep') || agentId.includes('container')) {
-          domains.add('infrastructure');
-        }
-      });
-
-      const multiDomain = domains.size > 1;
-
-      // Orchestrate team
-      const teamConfig = orchestrateTeam({
-        activeAgents: feature.activeAgents,
-        complexity: options.complexity,
-        estimatedFiles: parseInt(options.estimatedFiles, 10),
-        multiDomain
-      });
-
-      if (options.json) {
-        // Output as JSON for programmatic use
-        console.log(JSON.stringify(teamConfig, null, 2));
-        return;
-      }
-
-      // Pretty output for human reading
-      console.log(chalk.bold(`\n🤖 Agent Team Configuration for: ${featureName}`));
-      console.log('━'.repeat(60));
-
-      console.log(chalk.cyan(`\nShould Spawn Agents: ${teamConfig.useAgentTeams ? chalk.green('YES') : chalk.yellow('NO')}`));
-      console.log(chalk.gray(`Reason: ${teamConfig.useAgentTeams ? 'Meets spawn threshold' : 'Below threshold - implement directly'}`));
-
-      if (!teamConfig.useAgentTeams) {
-        console.log(chalk.yellow('\n⚠️  Team spawning not recommended for this feature.'));
-        console.log(chalk.gray('Implement directly in main session.\n'));
-        return;
-      }
-
-      console.log(chalk.cyan(`\nDisplay Mode: ${teamConfig.displayMode}`));
-      console.log(chalk.cyan(`Total Teammates: ${teamConfig.teamHierarchy.totalTeammates}`));
-
-      // Show team hierarchy
-      console.log(chalk.bold('\nTeam Hierarchy:'));
-      console.log(chalk.green(`  Team Lead: ${teamConfig.teamHierarchy.teamLead}`));
-
-      if (teamConfig.teamHierarchy.squads && teamConfig.teamHierarchy.squads.length > 0) {
-        console.log(chalk.cyan('\n  Squad Leaders:'));
-        teamConfig.teamHierarchy.squads.forEach(squad => {
-          console.log(chalk.cyan(`    • ${squad}`));
-        });
-      }
-
-      if (teamConfig.teamHierarchy.validators && teamConfig.teamHierarchy.validators.length > 0) {
-        console.log(chalk.gray('\n  Validators (run in hooks):'));
-        teamConfig.teamHierarchy.validators.forEach(validator => {
-          console.log(chalk.gray(`    • ${validator}`));
-        });
-      }
-
-      // Show Task tool usage
-      console.log(chalk.bold('\n📝 Task Tool Usage:'));
-      console.log(chalk.gray('\nUse the following pattern to spawn the team:\n'));
-
-      console.log(chalk.cyan('```typescript'));
-      console.log(chalk.white(`{
-  subagent_type: "general-purpose",
-  description: "Implement ${featureName}",
-  prompt: \`You are the Team Lead (${teamConfig.teamHierarchy.teamLead})...
-
-Your Mission: Implement ${featureName}
-
-Your Domain Leaders:
-${teamConfig.teammates
-  .filter(t => t.tier === 2)
-  .map(t => `- ${t.id}: ${t.role}`)
-  .join('\n')}
-
-Your Specialists:
-${teamConfig.teammates
-  .filter(t => t.tier === 3)
-  .map(t => `- ${t.id}: ${t.role}`)
-  .join('\n')}
-
-Standards to follow: [coding.md, architecture.md]
-
-Deliverables: [list specific outputs]
-\`
-}`));
-      console.log(chalk.cyan('```\n'));
-
-      // Show individual teammates
-      console.log(chalk.bold('Individual Teammates:'));
-      teamConfig.teammates.forEach(teammate => {
-        console.log(chalk.cyan(`\n  ${teammate.icon} ${teammate.id} (Tier ${teammate.tier})`));
-        console.log(chalk.gray(`     Role: ${teammate.role}`));
-
-        if (teammate.spawnPrompt && teammate.spawnPrompt.length < 200) {
-          console.log(chalk.gray(`     Prompt: ${teammate.spawnPrompt.substring(0, 100)}...`));
-        }
-      });
-
-      console.log('\n' + '━'.repeat(60));
-      console.log(chalk.green('\n✅ Team configuration generated successfully\n'));
-
-    } catch (error) {
-      console.error(chalk.red(`\n❌ Error generating team configuration: ${error.message}\n`));
-      if (error.stack) {
-        console.error(chalk.gray(error.stack));
-      }
-      process.exit(1);
-    }
-  }
-
-/**
- * Commander program command
- */
-program
-  .name('spawn-team')
-  .description('Generate agent team configuration for Task tool spawning')
-  .argument('<feature>', 'Feature name')
-  .option('--json', 'Output as JSON')
-  .option('--complexity <level>', 'Override complexity level (low/medium/high/critical)', 'high')
-  .option('--estimated-files <count>', 'Override estimated file count', '20')
-  .action(spawnTeamCommand);
-
-// Only parse if run directly (not imported as module)
-if (import.meta.url === `file://${process.argv[1]}`) {
-  if (process.argv.length > 2) {
-    program.parse(process.argv);
-  } else {
-    program.help();
-  }
-}
-
-export default program;
+import { Command } from 'commander';
+import chalk from 'chalk';
+import { getFeature } from '../../core/state/state-manager.js';
+import { orchestrateTeam } from '../../lib/orchestration/team-orchestrator.js';
+
+/**
+ * Spawn Team Command - Generate agent team configurations
+ *
+ * Reads active agents from feature state and generates ready-to-use
+ * Task tool configurations for spawning agent teams.
+ */
+
+const program = new Command();
+
+/**
+ * Spawn team action function
+ */
+export async function spawnTeamCommand(featureName, options = {}) {
+    try {
+      // Get feature state
+      const feature = getFeature(featureName);
+      if (!feature) {
+        console.error(chalk.red(`\n❌ Feature not found: ${featureName}\n`));
+        process.exit(1);
+      }
+
+      if (!feature.activeAgents || feature.activeAgents.length === 0) {
+        console.error(chalk.yellow(`\n⚠️  No active agents found for feature: ${featureName}`));
+        console.log(chalk.gray('Run "morph-spec detect-agents" first to identify agents.\n'));
+        process.exit(1);
+      }
+
+      // Determine if multi-domain
+      const domains = new Set();
+      feature.activeAgents.forEach(agentId => {
+        if (agentId.includes('dotnet') || agentId.includes('ef') || agentId.includes('api')) {
+          domains.add('backend');
+        }
+        if (agentId.includes('blazor') || agentId.includes('nextjs') || agentId.includes('ui')) {
+          domains.add('frontend');
+        }
+        if (agentId.includes('azure') || agentId.includes('bicep') || agentId.includes('container')) {
+          domains.add('infrastructure');
+        }
+      });
+
+      const multiDomain = domains.size > 1;
+
+      // Orchestrate team
+      const teamConfig = orchestrateTeam({
+        activeAgents: feature.activeAgents,
+        complexity: options.complexity,
+        estimatedFiles: parseInt(options.estimatedFiles, 10),
+        multiDomain
+      });
+
+      if (options.json) {
+        // Output as JSON for programmatic use
+        console.log(JSON.stringify(teamConfig, null, 2));
+        return;
+      }
+
+      // Pretty output for human reading
+      console.log(chalk.bold(`\n🤖 Agent Team Configuration for: ${featureName}`));
+      console.log('━'.repeat(60));
+
+      console.log(chalk.cyan(`\nShould Spawn Agents: ${teamConfig.useAgentTeams ? chalk.green('YES') : chalk.yellow('NO')}`));
+      console.log(chalk.gray(`Reason: ${teamConfig.useAgentTeams ? 'Meets spawn threshold' : 'Below threshold - implement directly'}`));
+
+      if (!teamConfig.useAgentTeams) {
+        console.log(chalk.yellow('\n⚠️  Team spawning not recommended for this feature.'));
+        console.log(chalk.gray('Implement directly in main session.\n'));
+        return;
+      }
+
+      console.log(chalk.cyan(`\nDisplay Mode: ${teamConfig.displayMode}`));
+      console.log(chalk.cyan(`Total Teammates: ${teamConfig.teamHierarchy.totalTeammates}`));
+
+      // Show team hierarchy
+      console.log(chalk.bold('\nTeam Hierarchy:'));
+      console.log(chalk.green(`  Team Lead: ${teamConfig.teamHierarchy.teamLead}`));
+
+      if (teamConfig.teamHierarchy.squads && teamConfig.teamHierarchy.squads.length > 0) {
+        console.log(chalk.cyan('\n  Squad Leaders:'));
+        teamConfig.teamHierarchy.squads.forEach(squad => {
+          console.log(chalk.cyan(`    • ${squad}`));
+        });
+      }
+
+      if (teamConfig.teamHierarchy.validators && teamConfig.teamHierarchy.validators.length > 0) {
+        console.log(chalk.gray('\n  Validators (run in hooks):'));
+        teamConfig.teamHierarchy.validators.forEach(validator => {
+          console.log(chalk.gray(`    • ${validator}`));
+        });
+      }
+
+      // Show Task tool usage
+      console.log(chalk.bold('\n📝 Task Tool Usage:'));
+      console.log(chalk.gray('\nUse the following pattern to spawn the team:\n'));
+
+      console.log(chalk.cyan('```typescript'));
+      console.log(chalk.white(`{
+  subagent_type: "general-purpose",
+  description: "Implement ${featureName}",
+  prompt: \`You are the Team Lead (${teamConfig.teamHierarchy.teamLead})...
+
+Your Mission: Implement ${featureName}
+
+Your Domain Leaders:
+${teamConfig.teammates
+  .filter(t => t.tier === 2)
+  .map(t => `- ${t.id}: ${t.role}`)
+  .join('\n')}
+
+Your Specialists:
+${teamConfig.teammates
+  .filter(t => t.tier === 3)
+  .map(t => `- ${t.id}: ${t.role}`)
+  .join('\n')}
+
+Standards to follow: [coding.md, architecture.md]
+
+Deliverables: [list specific outputs]
+\`
+}`));
+      console.log(chalk.cyan('```\n'));
+
+      // Show individual teammates
+      console.log(chalk.bold('Individual Teammates:'));
+      teamConfig.teammates.forEach(teammate => {
+        console.log(chalk.cyan(`\n  ${teammate.icon} ${teammate.id} (Tier ${teammate.tier})`));
+        console.log(chalk.gray(`     Role: ${teammate.role}`));
+
+        if (teammate.spawnPrompt && teammate.spawnPrompt.length < 200) {
+          console.log(chalk.gray(`     Prompt: ${teammate.spawnPrompt.substring(0, 100)}...`));
+        }
+      });
+
+      console.log('\n' + '━'.repeat(60));
+      console.log(chalk.green('\n✅ Team configuration generated successfully\n'));
+
+    } catch (error) {
+      console.error(chalk.red(`\n❌ Error generating team configuration: ${error.message}\n`));
+      if (error.stack) {
+        console.error(chalk.gray(error.stack));
+      }
+      process.exit(1);
+    }
+  }
+
+/**
+ * Commander program command
+ */
+program
+  .name('spawn-team')
+  .description('Generate agent team configuration for Task tool spawning')
+  .argument('<feature>', 'Feature name')
+  .option('--json', 'Output as JSON')
+  .option('--complexity <level>', 'Override complexity level (low/medium/high/critical)', 'high')
+  .option('--estimated-files <count>', 'Override estimated file count', '20')
+  .action(spawnTeamCommand);
+
+// Only parse if run directly (not imported as module)
+if (import.meta.url === `file://${process.argv[1]}`) {
+  if (process.argv.length > 2) {
+    program.parse(process.argv);
+  } else {
+    program.help();
+  }
+}
+
+export default program;