@polymorphism-tech/morph-spec 1.0.4 → 2.1.0

package/content/.morph/hooks/pre-commit-costs.sh

@@ -0,0 +1,91 @@
+#!/bin/bash
+
+# MORPH-SPEC Pre-commit Hook: Cost Validation
+#
+# Valida custos de arquivos Bicep antes de permitir commit.
+# Bloqueia commits que excedem o limite configurado sem ADR.
+#
+# Instalação:
+#   cp .morph/hooks/pre-commit-costs.sh .git/hooks/pre-commit
+#   chmod +x .git/hooks/pre-commit
+#
+# Ou use symlink:
+#   ln -s ../../.morph/hooks/pre-commit-costs.sh .git/hooks/pre-commit
+
+set -e
+
+# Colors
+RED='\033[0;31m'
+YELLOW='\033[1;33m'
+GREEN='\033[0;32m'
+NC='\033[0m' # No Color
+
+echo -e "${GREEN}🔍 MORPH-SPEC: Validating infrastructure costs...${NC}"
+
+# Encontrar arquivos Bicep modificados no staged area
+BICEP_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.bicep$' || true)
+
+if [ -z "$BICEP_FILES" ]; then
+  echo -e "${GREEN}✓ No Bicep files changed, skipping cost validation.${NC}"
+  exit 0
+fi
+
+echo "Found Bicep files:"
+echo "$BICEP_FILES" | sed 's/^/  - /'
+
+# Rodar cost calculator
+RESULT=$(node bin/calculate-costs.js $BICEP_FILES --json 2>&1)
+EXIT_CODE=$?
+
+# Parse result JSON
+MONTHLY_COST=$(echo "$RESULT" | grep -o '"monthly":[^,]*' | cut -d':' -f2 | tr -d ' ')
+REQUIRES_ADR=$(echo "$RESULT" | grep -o '"requiresADR":[^,]*' | cut -d':' -f2 | tr -d ' ')
+
+echo -e "\n${YELLOW}Estimated Monthly Cost: \$${MONTHLY_COST}${NC}"
+
+# Se não requer ADR, aprovar
+if [ "$REQUIRES_ADR" != "true" ]; then
+  echo -e "${GREEN}✓ Cost is within limits. Proceeding with commit.${NC}"
+  exit 0
+fi
+
+# Se requer ADR, verificar se existe decisions.md com ADR de custo
+echo -e "\n${YELLOW}⚠️  Cost exceeds ADR threshold!${NC}"
+echo "Checking for cost ADR in decisions.md..."
+
+# Procurar decisions.md em outputs de features
+DECISIONS_FILES=$(find .morph/project/outputs -name "decisions.md" 2>/dev/null || true)
+
+ADR_FOUND=false
+
+for file in $DECISIONS_FILES; do
+  # Procurar por ADR que menciona "cost" ou "Infrastructure Costs"
+  if grep -qi "ADR.*cost\|Infrastructure Costs" "$file"; then
+    echo -e "${GREEN}✓ Found cost ADR in: $file${NC}"
+    ADR_FOUND=true
+    break
+  fi
+done
+
+if [ "$ADR_FOUND" = true ]; then
+  echo -e "${GREEN}✓ Cost ADR documented. Proceeding with commit.${NC}"
+  exit 0
+else
+  echo -e "${RED}❌ COMMIT BLOCKED!${NC}"
+  echo ""
+  echo "Monthly cost (\$$MONTHLY_COST) exceeds the configured ADR threshold."
+  echo ""
+  echo "To proceed, you must:"
+  echo "  1. Document a cost ADR in .morph/project/outputs/{feature}/decisions.md"
+  echo "  2. Include justification for infrastructure costs"
+  echo ""
+  echo "Example ADR:"
+  echo "  ## ADR-XXX: Infrastructure Costs"
+  echo "  "
+  echo "  **Estimated Monthly Cost:** \$$MONTHLY_COST"
+  echo "  "
+  echo "  **Justification:**"
+  echo "  {Why these resources are necessary and cost-effective}"
+  echo ""
+  exit 1
+fi

package/content/.morph/hooks/pre-commit-specs.sh

@@ -0,0 +1,49 @@
+#!/bin/bash
+# MORPH-SPEC Pre-Commit Hook: Spec Validation
+# Validates that spec.md files have required sections
+
+echo "🔍 Validating spec files..."
+
+# Find modified spec.md files
+SPEC_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep 'spec\.md$')
+
+if [ -z "$SPEC_FILES" ]; then
+  echo "✓ No spec files modified"
+  exit 0
+fi
+
+HAS_ERRORS=false
+
+for spec_file in $SPEC_FILES; do
+  echo "Checking: $spec_file"
+
+  # Required sections
+  REQUIRED_SECTIONS=(
+    "## 📋 Metadata"
+    "## 🎯 Overview"
+    "## 🏗️ Technical Design"
+    "## ✅ Acceptance Criteria"
+  )
+
+  for section in "${REQUIRED_SECTIONS[@]}"; do
+    if ! grep -q "$section" "$spec_file"; then
+      echo "  ❌ Missing section: $section"
+      HAS_ERRORS=true
+    fi
+  done
+
+  # Check if has at least one user story or requirement
+  if ! grep -qi "user story\|requirement\|acceptance criteria" "$spec_file"; then
+    echo "  ⚠️  Warning: No user stories or requirements found"
+  fi
+done
+
+if [ "$HAS_ERRORS" = true ]; then
+  echo ""
+  echo "❌ COMMIT BLOCKED: spec.md files are incomplete"
+  echo "   Add missing sections before committing"
+  exit 1
+fi
+
+echo "✓ All spec files are valid"
+exit 0

package/content/.morph/hooks/pre-commit-tests.sh

@@ -0,0 +1,60 @@
+#!/bin/bash
+# MORPH-SPEC Pre-Commit Hook: Test Coverage
+# Ensures new code has corresponding tests
+
+echo "🧪 Checking test coverage..."
+
+# Find modified C# files (excluding tests)
+CS_FILES=$(git diff --cached --name-only --diff-filter=ACM | grep '\.cs$' | grep -v 'Tests\|Test\.cs$')
+
+if [ -z "$CS_FILES" ]; then
+  echo "✓ No production code modified"
+  exit 0
+fi
+
+MISSING_TESTS=false
+
+for cs_file in $CS_FILES; do
+  # Extract class name
+  class_name=$(basename "$cs_file" .cs)
+
+  # Look for corresponding test file
+  test_patterns=(
+    "*/${class_name}Tests.cs"
+    "*/${class_name}Test.cs"
+    "*/Test${class_name}.cs"
+  )
+
+  FOUND_TEST=false
+  for pattern in "${test_patterns[@]}"; do
+    if find . -path "$pattern" 2>/dev/null | grep -q .; then
+      FOUND_TEST=true
+      break
+    fi
+  done
+
+  if [ "$FOUND_TEST" = false ]; then
+    # Check if it's a trivial file (DTO, model, etc.)
+    if grep -qi 'record\|DTO\|Model\|Entity' "$cs_file" && ! grep -qi 'class.*{.*public.*{' "$cs_file"; then
+      echo "  ℹ️  Skipping trivial file: $cs_file"
+      continue
+    fi
+
+    echo "  ⚠️  No test found for: $cs_file"
+    MISSING_TESTS=true
+  else
+    echo "  ✓ Test found for: $cs_file"
+  fi
+done
+
+if [ "$MISSING_TESTS" = true ]; then
+  echo ""
+  echo "⚠️  WARNING: Some files don't have tests"
+  echo "   Consider adding tests before committing"
+  echo "   Override with: git commit --no-verify"
+  # Don't block, just warn
+  exit 0
+fi
+
+echo "✓ Test coverage looks good"
+exit 0

package/content/.morph/project.md

@@ -15,11 +15,12 @@
 
 | Layer | Technology | Version |
 |-------|------------|---------|
-| Frontend | Blazor Server | .NET 9 |
-| Backend | ASP.NET Core | 9.0 |
+| Frontend | Blazor Server | .NET 10 |
+| UI Library | Fluent UI Blazor (recomendado) | 4.0+ |
+| Backend | ASP.NET Core | 10.0 |
 | Database | Azure SQL | Free Tier |
-| ORM | Entity Framework Core | 9.0 |
-| AI | MS Agent Framework / Semantic Kernel | Latest |
+| ORM | Entity Framework Core | 10.0 |
+| AI | Microsoft Agent Framework | .NET 10 |
 | Jobs | Hangfire | Latest |
 | Hosting | Azure Container Apps | Consumption |
 

package/content/.morph/schemas/agent.schema.json

@@ -0,0 +1,296 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://polymorphism.com.br/morph-spec/schemas/agent.schema.json",
+  "title": "MORPH-SPEC Agent Configuration Schema",
+  "description": "JSON Schema for validating agents.json configuration file",
+  "type": "object",
+  "required": ["version", "agents"],
+  "properties": {
+    "version": {
+      "type": "string",
+      "description": "Schema version",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "examples": ["1.0.0", "2.1.0"]
+    },
+    "agents": {
+      "type": "object",
+      "description": "Agent definitions organized by type",
+      "required": ["core", "specialists"],
+      "properties": {
+        "core": {
+          "type": "array",
+          "description": "Core agents (always active)",
+          "items": {
+            "$ref": "#/definitions/agent"
+          },
+          "minItems": 1
+        },
+        "specialists": {
+          "type": "array",
+          "description": "Specialist agents (activated on-demand by keywords)",
+          "items": {
+            "$ref": "#/definitions/specialistAgent"
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "agent": {
+      "type": "object",
+      "description": "Base agent definition",
+      "required": ["id", "name", "emoji", "type", "description", "responsibilities"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique agent identifier (kebab-case)",
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "examples": ["standards-architect", "azure-architect"]
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable agent name",
+          "minLength": 3,
+          "maxLength": 50,
+          "examples": ["Standards Architect", "Azure Architect"]
+        },
+        "emoji": {
+          "type": "string",
+          "description": "Agent emoji (single character)",
+          "pattern": "^.{1,2}$",
+          "examples": ["📐", "☁️", "🔥"]
+        },
+        "type": {
+          "type": "string",
+          "description": "Agent type",
+          "enum": ["core", "specialist"],
+          "examples": ["core", "specialist"]
+        },
+        "skillPath": {
+          "type": "string",
+          "description": "Path to agent skill file (relative to repo root)",
+          "pattern": "^[^/].*\\.md$",
+          "examples": [".claude/skills/specialists/standards-architect.md"]
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief agent description (PT-BR or EN)",
+          "minLength": 10,
+          "maxLength": 200,
+          "examples": ["Guardião dos padrões de código e arquitetura"]
+        },
+        "responsibilities": {
+          "type": "array",
+          "description": "List of agent responsibilities",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 150
+          },
+          "minItems": 1,
+          "maxItems": 10,
+          "examples": [
+            ["Validar aderência aos padrões", "Revisar nomenclatura"]
+          ]
+        },
+        "validatesPhases": {
+          "type": "array",
+          "description": "Which MORPH phases this agent validates",
+          "items": {
+            "type": "string",
+            "enum": ["setup", "uiux-design", "design", "clarify", "tasks", "implement", "sync"]
+          },
+          "uniqueItems": true,
+          "examples": [["design", "implement"]]
+        },
+        "expertise": {
+          "type": "array",
+          "description": "Areas of expertise",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["Container Apps", "Azure SQL", "Bicep"]]
+        },
+        "patterns": {
+          "type": "array",
+          "description": "Technical patterns the agent specializes in",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["CQRS", "Repository", "DI"]]
+        },
+        "limits": {
+          "type": "object",
+          "description": "Agent-specific limits (e.g., for Cost Guardian)",
+          "additionalProperties": true
+        },
+        "defaultModel": {
+          "type": "string",
+          "description": "Default AI model for this agent",
+          "examples": ["gpt-4o-mini", "claude-3-5-sonnet"]
+        },
+        "deliverables": {
+          "type": "array",
+          "description": "Outputs this agent is responsible for",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["ui-design-system.md", "ui-mockups.md"]]
+        },
+        "workflow": {
+          "type": "array",
+          "description": "Step-by-step workflow for this agent",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 200
+          },
+          "examples": [
+            ["1. Analisar contexto", "2. Gerar proposta", "3. Validar com usuário"]
+          ]
+        },
+        "techniques": {
+          "type": "array",
+          "description": "Techniques or methodologies the agent uses",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          },
+          "examples": [["5 Whys", "MoSCoW", "User story mapping"]]
+        }
+      },
+      "additionalProperties": false
+    },
+    "specialistAgent": {
+      "type": "object",
+      "required": ["id", "name", "emoji", "type", "description", "responsibilities", "autoActivation"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique agent identifier (kebab-case)",
+          "pattern": "^[a-z][a-z0-9-]*$"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable agent name",
+          "minLength": 3,
+          "maxLength": 50
+        },
+        "emoji": {
+          "type": "string",
+          "description": "Agent emoji (single character)",
+          "pattern": "^.{1,2}$"
+        },
+        "type": {
+          "const": "specialist"
+        },
+        "skillPath": {
+          "type": "string",
+          "description": "Path to agent skill file",
+          "pattern": "^[^/].*\\.md$"
+        },
+        "description": {
+          "type": "string",
+          "description": "Brief agent description",
+          "minLength": 10,
+          "maxLength": 200
+        },
+        "responsibilities": {
+          "type": "array",
+          "description": "List of agent responsibilities",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 150
+          },
+          "minItems": 1,
+          "maxItems": 10
+        },
+        "autoActivation": {
+          "type": "object",
+          "description": "Auto-activation configuration for specialist agents",
+          "required": ["keywords"],
+          "properties": {
+            "keywords": {
+              "type": "array",
+              "description": "Keywords that trigger this agent (lowercase, alphanumeric + hyphens/underscores)",
+              "items": {
+                "type": "string",
+                "pattern": "^[a-z][a-z0-9_-]*$",
+                "minLength": 2,
+                "maxLength": 50
+              },
+              "minItems": 1,
+              "uniqueItems": true
+            },
+            "minKeywords": {
+              "type": "integer",
+              "description": "Minimum number of keyword matches required (default: 1)",
+              "minimum": 1,
+              "default": 1
+            }
+          },
+          "additionalProperties": false
+        },
+        "validatesPhases": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": ["setup", "uiux-design", "design", "clarify", "tasks", "implement", "sync"]
+          },
+          "uniqueItems": true
+        },
+        "expertise": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        },
+        "patterns": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        },
+        "deliverables": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        },
+        "workflow": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 5,
+            "maxLength": 200
+          }
+        },
+        "techniques": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "minLength": 3,
+            "maxLength": 100
+          }
+        }
+      },
+      "additionalProperties": false
+    }
+  }
+}