@polymorphism-tech/morph-spec 4.2.0 → 4.3.1

package/src/lib/validators/content-validator.js

@@ -1,164 +0,0 @@
-/**
- * Content Validator
- *
- * Validates the content and structure of spec.md, tasks.json, and other feature outputs
- *
- * MORPH-SPEC 3.0 - Phase Validation
- */
-
-import { readFileSync, existsSync } from 'fs';
-
-/**
- * Validate spec.md content and structure
- *
- * @param {string} specPath - Path to spec.md file
- * @returns {Object} { valid, errors }
- */
-export function validateSpecContent(specPath) {
-  if (!existsSync(specPath)) {
-    return {
-      valid: false,
-      errors: ['Spec file does not exist']
-    };
-  }
-
-  const content = readFileSync(specPath, 'utf8');
-  const errors = [];
-
-  // Required sections for spec.md
-  const requiredSections = [
-    '## Overview',
-    '## Functional Requirements',
-    '## Technical Architecture',
-    '## Data Model'
-  ];
-
-  for (const section of requiredSections) {
-    if (!content.includes(section) && !content.match(new RegExp(`##\\s+\\d+\\.\\s+${section.replace('## ', '')}`, 'i'))) {
-      errors.push(`Missing required section: ${section}`);
-    }
-  }
-
-  // Check minimum length
-  if (content.length < 500) {
-    errors.push('Spec content is too short (minimum 500 characters)');
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors
-  };
-}
-
-/**
- * Validate tasks.json content and structure
- *
- * @param {string} tasksPath - Path to tasks.json file
- * @returns {Object} { valid, errors }
- */
-export function validateTasksContent(tasksPath) {
-  if (!existsSync(tasksPath)) {
-    return {
-      valid: false,
-      errors: ['Tasks file does not exist']
-    };
-  }
-
-  try {
-    const content = readFileSync(tasksPath, 'utf8');
-    const tasks = JSON.parse(content);
-    const errors = [];
-
-    // Check if it's an array
-    if (!Array.isArray(tasks)) {
-      errors.push('tasks.json must contain an array of tasks');
-      return { valid: false, errors };
-    }
-
-    // Validate each task
-    for (const task of tasks) {
-      if (!task.id) {
-        errors.push(`Task missing required field: id`);
-      }
-      if (!task.description) {
-        errors.push(`Task ${task.id || '(unknown)'} missing required field: description`);
-      }
-      if (!task.status) {
-        errors.push(`Task ${task.id || '(unknown)'} missing required field: status`);
-      }
-      if (task.status && !['pending', 'in_progress', 'completed'].includes(task.status)) {
-        errors.push(`Task ${task.id} has invalid status: ${task.status}`);
-      }
-    }
-
-    // Check for duplicate IDs
-    const ids = tasks.map(t => t.id);
-    const duplicates = ids.filter((id, index) => ids.indexOf(id) !== index);
-    if (duplicates.length > 0) {
-      errors.push(`Duplicate task IDs found: ${duplicates.join(', ')}`);
-    }
-
-    // Check for circular dependencies
-    for (const task of tasks) {
-      if (task.dependencies && Array.isArray(task.dependencies)) {
-        for (const depId of task.dependencies) {
-          if (!ids.includes(depId)) {
-            errors.push(`Task ${task.id} depends on non-existent task: ${depId}`);
-          }
-          if (depId === task.id) {
-            errors.push(`Task ${task.id} cannot depend on itself`);
-          }
-        }
-      }
-    }
-
-    return {
-      valid: errors.length === 0,
-      errors
-    };
-  } catch (err) {
-    return {
-      valid: false,
-      errors: [`Failed to parse tasks.json: ${err.message}`]
-    };
-  }
-}
-
-/**
- * Validate feature outputs (proposal, spec, tasks, etc.)
- *
- * @param {string} projectPath - Project root path
- * @param {string} featureName - Feature name
- * @param {string} phase - Current phase
- * @returns {Object} { valid, errors }
- */
-export function validateFeatureOutputs(projectPath, featureName, phase) {
-  const errors = [];
-
-  // Phase-specific output requirements
-  const phaseOutputs = {
-    proposal: ['proposal.md'],
-    setup: [], // No specific outputs required
-    uiux: ['ui-design-system.md'],
-    design: ['spec.md'],
-    clarify: [], // Updates to spec.md
-    tasks: ['tasks.json'],
-    implement: [], // Code files
-    sync: ['decisions.md', 'recap.md']
-  };
-
-  const requiredOutputs = phaseOutputs[phase] || [];
-
-  // Check if required outputs exist
-  for (const output of requiredOutputs) {
-    const outputPath = `${projectPath}/.morph/project/outputs/${featureName}/${output}`;
-    if (!existsSync(outputPath)) {
-      errors.push(`Missing required output for phase ${phase}: ${output}`);
-    }
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors
-  };
-}

package/src/lib/validators/package-validator.js

@@ -1,61 +0,0 @@
-/**
- * Package Validator
- *
- * Validates NuGet package dependencies for .NET projects
- *
- * MORPH-SPEC 3.0 - Continuous Validation
- */
-
-import { execSync } from 'child_process';
-import { existsSync } from 'fs';
-import { join } from 'path';
-
-/**
- * Validate package dependencies
- *
- * @param {string} projectPath - Project root path
- * @param {Object} options - Validation options
- * @returns {Object} { passed, errors, warnings, issues }
- */
-export async function validatePackages(projectPath, options = {}) {
-  const issues = [];
-
-  // Find .csproj files
-  try {
-    const csprojFiles = execSync('find . -name "*.csproj" -type f 2>/dev/null || true', {
-      cwd: projectPath,
-      encoding: 'utf8'
-    }).trim().split('\n').filter(Boolean);
-
-    if (csprojFiles.length === 0) {
-      return {
-        passed: true,
-        errors: 0,
-        warnings: 0,
-        issues: [],
-        message: 'No .NET projects found to validate'
-      };
-    }
-
-    // Basic package validation (stub implementation)
-    // TODO: Implement actual package conflict detection
-
-  } catch (err) {
-    issues.push({
-      level: 'warning',
-      type: 'package',
-      message: `Failed to validate packages: ${err.message}`,
-      solution: 'Run dotnet restore manually to check for package issues'
-    });
-  }
-
-  const errors = issues.filter(i => i.level === 'error').length;
-  const warnings = issues.filter(i => i.level === 'warning').length;
-
-  return {
-    passed: errors === 0,
-    errors,
-    warnings,
-    issues
-  };
-}

package/src/lib/validators/ui-contrast-validator.js

@@ -1,44 +0,0 @@
-/**
- * UI Contrast Validator
- *
- * Validates WCAG color contrast ratios
- *
- * MORPH-SPEC 3.0 - Continuous Validation
- */
-
-/**
- * Validate color contrast ratios
- *
- * @param {string} projectPath - Project root path
- * @param {Object} options - Validation options
- * @returns {Object} { passed, errors, warnings, issues }
- */
-export async function validateContrast(projectPath, options = {}) {
-  const issues = [];
-
-  // Basic contrast validation (stub implementation)
-  // TODO: Implement actual WCAG contrast ratio validation
-
-  const errors = issues.filter(i => i.level === 'error').length;
-  const warnings = issues.filter(i => i.level === 'warning').length;
-
-  return {
-    passed: errors === 0,
-    errors,
-    warnings,
-    issues,
-    message: 'Contrast validation not yet implemented'
-  };
-}
-
-/**
- * Calculate contrast ratio between two colors
- *
- * @param {string} color1 - First color (hex)
- * @param {string} color2 - Second color (hex)
- * @returns {number} Contrast ratio
- */
-export function calculateContrast(color1, color2) {
-  // Stub implementation
-  return 4.5; // Placeholder
-}

package/stacks/blazor-azure/.claude/commands/morph-apply.md

@@ -1,221 +0,0 @@
-# Apply MORPH Feature Implementation - FASE 5
-
-Implemente a feature especificada seguindo as tasks definidas.
-
-## Uso
-
-```
-/morph-apply {feature-name}
-```
-
-## Pré-requisitos
-
-### CRÍTICO: Validar Fases Anteriores
-
-**SEMPRE verifique que fases anteriores foram concluídas:**
-
-```bash
-# Obter estado da feature
-npx morph-spec state get {feature-name}
-```
-
-**Validações obrigatórias:**
-
-1. **FASE 0 (Proposal):**
-   - [ ] Output `proposal` criado
-   - [ ] Agentes detectados e registrados
-
-2. **FASE 1 (Setup):**
-   - [ ] Phase passou por "setup"
-   - [ ] Contexto carregado
-
-3. **FASE 1.5 (UI/UX) - SE APLICÁVEL:**
-   - [ ] Se `uiux-designer` está nos activeAgents → outputs ui-* devem existir
-   - [ ] Se NÃO tem uiux-designer → pode pular
-
-4. **FASE 2 (Design):**
-   - [ ] Output `spec` criado
-   - [ ] Output `contracts` criado
-   - [ ] Output `decisions` criado
-
-5. **FASE 3 (Clarify):**
-   - [ ] Phase passou por "clarify"
-   - [ ] Spec atualizado com clarificações
-
-6. **FASE 4 (Tasks):**
-   - [ ] Output `tasks` criado
-   - [ ] `tasks.json` tem array de tasks
-   - [ ] `tasks.total` > 0 no state
-
-**Se QUALQUER validação falhar:**
-```
-❌ ERRO: Fase {X} não foi concluída!
-
-Para completar as fases de planejamento, execute:
-/morph-proposal {feature-name}
-(Resume automaticamente da fase atual: {current_phase})
-```
-
-**NÃO prossiga com implementação até todas as fases estarem completas!**
-
-### Arquivos Necessários
-
-- [ ] Feature existe em `.morph/project/outputs/{feature}/`
-- [ ] `spec.md` está aprovado
-- [ ] `tasks.json` tem tasks definidas
-- [ ] `contracts.cs` define as interfaces
-
-## Workflow
-
-1. **Carregue o contexto**:
-   - Leia `.morph/project/outputs/{feature}/spec.md`
-   - Leia `.morph/project/outputs/{feature}/tasks.json`
-   - Leia `.morph/project/outputs/{feature}/contracts.cs`
-   - Leia framework/standards/ e .morph/project/standards/ para padrões
-
-2. **Inicialize state tracking**:
-   ```bash
-   # Atualizar fase para implement
-   npx morph-spec state set {feature} phase implement
-   npx morph-spec state set {feature} status in_progress
-
-   # Definir total de tasks (baseado em tasks.json)
-   npx morph-spec state set {feature} tasks.total {N}
-   ```
-
-3. **Execute tasks em ordem**:
-   - Marque task como in progress: `npx morph-spec task start {feature} {task-id}`
-   - Implemente seguindo os padrões e contracts.cs
-   - Complete task: `npx morph-spec task done {feature} {task-id}`
-   - **Validators run automatically** on task-done. If validation fails:
-     - Read the error messages and fix violations
-     - Re-run `task done` — do NOT use `--skip-validation` unless user authorizes
-   - Framework auto-manages checkpoints (every 3 tasks, includes validation summary)
-
-4. **Phase advancement**:
-   ```bash
-   # Advance to next phase (validates → advances → shows next steps)
-   npx morph-spec phase advance {feature}
-   ```
-
-5. **Marcar outputs criados**:
-   Sempre que gerar um arquivo de output:
-   ```bash
-   npx morph-spec state mark-output {feature} spec
-   npx morph-spec state mark-output {feature} contracts
-   npx morph-spec state mark-output {feature} tasks
-   # etc.
-   ```
-
-6. **Ao finalizar**:
-   - Generate recap automatically: `npx morph-spec generate recap {feature}`
-   - Atualize state: `npx morph-spec state set {feature} status done`
-   - Marque recap: `npx morph-spec state mark-output {feature} recap`
-   - Liste arquivos criados/modificados
-   - Calcule custo real vs estimado
-
-## Padrões Obrigatórios
-
-Siga sempre (priorize project/standards/ se houver):
-- `framework/standards/coding.md` - Padrões base do MORPH
-- `.morph/project/standards/coding.md` - Padrões específicos do projeto
-- `.morph/project/standards/architecture.md` - Estrutura de projeto
-- `.morph/project/standards/azure.md` - Recursos e custos
-
----
-
-## Checklist Pré-Deploy Azure
-
-**ANTES de fazer deploy para Azure, execute `/morph-preflight azure` ou verifique manualmente:**
-
-### Packages e Build
-
-- [ ] Packages sem conflitos de versão (`dotnet restore` sem warnings NU1605/NU1608)
-- [ ] `Azure.Identity` especificado explicitamente no `.csproj`
-- [ ] Build passa sem erros (`dotnet build`)
-
-### EF Core Migrations
-
-- [ ] Sem pending model changes (`dotnet ef migrations has-pending-model-changes`)
-- [ ] Migration criada para todas as mudanças de schema
-- [ ] Migration script revisado (`dotnet ef migrations script --idempotent`)
-
-### Blazor .NET 10 (se aplicável)
-
-- [ ] `.csproj` contém `<RequiresAspNetWebAssets>true</RequiresAspNetWebAssets>`
-- [ ] Static assets funcionando localmente
-
-### Container/Docker (se Container Apps)
-
-- [ ] Dockerfile válido e testado localmente
-- [ ] `docker build` funciona sem erros
-- [ ] Container roda localmente (`docker run`)
-
-### Infraestrutura Azure
-
-- [ ] Bicep sem erros de sintaxe (`az bicep build`)
-- [ ] Key Vault URI configurado em `appsettings.Production.json`
-- [ ] Connection strings em Key Vault (não hardcoded)
-- [ ] Managed Identity habilitada nos recursos
-
-### Segurança
-
-- [ ] Sem secrets em código ou `appsettings.json` (exceto Development)
-- [ ] HTTPS enforçado
-- [ ] CORS configurado corretamente
-
-### Comandos de Verificação
-
-```bash
-# 1. Package conflicts
-dotnet restore 2>&1 | grep -E "NU1605|NU1608"
-
-# 2. Pending migrations
-dotnet ef migrations has-pending-model-changes \
-  --project src/Infrastructure \
-  --startup-project src/Web
-
-# 3. Bicep validation
-az bicep build --file infra/main.bicep --stdout > /dev/null
-
-# 4. Docker build
-docker build -t myapp:test .
-
-# 5. Secret scan (basic)
-grep -rE "(Password=|Pwd=|Secret=)" appsettings*.json | grep -v Development
-```
-
-### Se QUALQUER item falhar
-
-```
-❌ BLOQUEADO: Não faça deploy até resolver!
-
-Use /morph-preflight azure para diagnóstico detalhado.
-```
-
-## Validações
-
-Antes de marcar task como completa:
-- [ ] Código compila
-- [ ] Segue padrões de nomenclatura
-- [ ] Testes unitários (se aplicável)
-- [ ] Sem hardcoded secrets
-
-## Output
-
-Ao final de cada task, mostre:
-1. Task completada
-2. Arquivos criados/modificados
-3. Próxima task
-4. Progresso geral (X/Y tasks) - usar `npx morph-spec state get {feature}`
-
-Ao final de cada checkpoint:
-```bash
-npx morph-spec state list
-```
-
-Isso mostra o progresso atualizado automaticamente.
-
----
-
-**Feature:** $ARGUMENTS

package/stacks/blazor-azure/.claude/commands/morph-archive.md

@@ -1,79 +0,0 @@
-# Archive MORPH Feature
-
-Arquive uma feature concluída, movendo-a de `project/outputs/` para `project/archive/`.
-
-## Pré-requisitos
-
-Verifique antes de arquivar:
-- [ ] Feature existe em `.morph/project/outputs/{feature}/`
-- [ ] Todas as tasks estão completas
-- [ ] `recap.md` está preenchido
-- [ ] Código está em produção (ou staging)
-
-## Workflow
-
-1. **Valide a conclusão**:
-   - Leia `.morph/project/outputs/{feature}/tasks.json`
-   - Verifique que todas tasks estão completadas
-   - Confirme com o usuário se pode arquivar
-
-2. **Complete o recap**:
-   - Atualize `.morph/project/outputs/{feature}/recap.md`
-   - Preencha métricas finais
-   - Documente lições aprendidas
-
-3. **Extraia specs**:
-   - Se a feature define comportamento permanente
-   - Copie spec relevante para `.morph/project/specs/`
-   - Isso vira a "verdade atual" do sistema
-
-4. **Mova para archive**:
-   ```
-   .morph/project/outputs/{feature}/  →  .morph/project/archive/{feature}/
-   ```
-
-5. **Atualize métricas do projeto**:
-   - Incremente contador de features
-   - Atualize custo total
-   - Atualize tempo total
-
-## Output
-
-Apresente resumo do arquivamento:
-
-```
-╔════════════════════════════════════════════╗
-║         FEATURE ARCHIVED                   ║
-╠════════════════════════════════════════════╣
-║ Feature: {name}                            ║
-║ Completed: {date}                          ║
-╠════════════════════════════════════════════╣
-║ METRICS                                    ║
-╠════════════════════════════════════════════╣
-║ Tasks: {X}/{X} completed                   ║
-║ Time: {X}h (estimated: {Y}h)               ║
-║ Cost Impact: +${X}/month                   ║
-╠════════════════════════════════════════════╣
-║ FILES                                      ║
-╠════════════════════════════════════════════╣
-║ Created: {X} files                         ║
-║ Modified: {Y} files                        ║
-║ Tests: {Z} files ({W}% coverage)           ║
-╠════════════════════════════════════════════╣
-║ ARCHIVED TO                                ║
-╠════════════════════════════════════════════╣
-║ .morph/project/archive/{feature}/          ║
-╚════════════════════════════════════════════╝
-```
-
-## Specs Extraídas
-
-Se houver specs extraídas:
-```
-Specs extracted to .morph/project/specs/:
-- {domain}/spec.md - {description}
-```
-
----
-
-**Feature to archive:** $ARGUMENTS