@polymorphism-tech/morph-spec 2.4.0 → 3.0.0

package/content/.morph/examples/state-v3.json

@@ -1,188 +1,188 @@
-{
-  "version": "3.0.0",
-  "project": {
-    "name": "FishArt",
-    "type": "blazor-server",
-    "createdAt": "2024-01-15T10:00:00Z",
-    "updatedAt": "2024-01-15T14:30:00Z"
-  },
-  "features": {
-    "scheduled-reports": {
-      "status": "in_progress",
-      "phase": "implement",
-      "activeAgents": [
-        "standards-architect",
-        "blazor-builder",
-        "ef-modeler",
-        "hangfire-orchestrator"
-      ],
-      "tasks": [
-        {
-          "id": "T001",
-          "title": "Create ScheduledReport entity",
-          "status": "completed",
-          "completedAt": "2024-01-15T10:30:00Z",
-          "completedBy": "claude",
-          "dependencies": [],
-          "files": [
-            "Domain/Entities/ScheduledReport.cs",
-            "Infrastructure/Persistence/Config/ScheduledReportConfig.cs"
-          ],
-          "checkpoint": "CHECKPOINT_001"
-        },
-        {
-          "id": "T002",
-          "title": "Create CreateReportCommand + Handler",
-          "status": "completed",
-          "completedAt": "2024-01-15T11:15:00Z",
-          "completedBy": "claude",
-          "dependencies": ["T001"],
-          "files": [
-            "Application/Commands/CreateReport/CreateReportCommand.cs",
-            "Application/Commands/CreateReport/CreateReportHandler.cs"
-          ]
-        },
-        {
-          "id": "T003",
-          "title": "Create Hangfire job for report generation",
-          "status": "completed",
-          "completedAt": "2024-01-15T12:00:00Z",
-          "completedBy": "claude",
-          "dependencies": ["T002"],
-          "files": [
-            "Infrastructure/Jobs/GenerateReportJob.cs"
-          ],
-          "checkpoint": "CHECKPOINT_002"
-        },
-        {
-          "id": "T004",
-          "title": "Create ReportList component (Blazor)",
-          "status": "in_progress",
-          "startedAt": "2024-01-15T13:00:00Z",
-          "dependencies": ["T001"],
-          "files": [
-            "Components/Reports/ReportList.razor",
-            "Components/Reports/ReportList.razor.cs",
-            "Components/Reports/ReportList.razor.css"
-          ]
-        },
-        {
-          "id": "T005",
-          "title": "Create CreateReportForm component (Blazor)",
-          "status": "pending",
-          "dependencies": ["T002"],
-          "files": [
-            "Components/Reports/CreateReportForm.razor",
-            "Components/Reports/CreateReportForm.razor.cs",
-            "Components/Reports/CreateReportForm.razor.css"
-          ]
-        },
-        {
-          "id": "T006",
-          "title": "Create API controller for reports",
-          "status": "pending",
-          "dependencies": ["T002"],
-          "files": [
-            "API/Controllers/ReportsController.cs"
-          ]
-        },
-        {
-          "id": "T007",
-          "title": "Add Hangfire dashboard configuration",
-          "status": "pending",
-          "dependencies": ["T003"],
-          "files": [
-            "Program.cs"
-          ]
-        },
-        {
-          "id": "T008",
-          "title": "Create unit tests for CreateReportCommand",
-          "status": "pending",
-          "dependencies": ["T002"],
-          "files": [
-            "Tests/Application/Commands/CreateReportCommandTests.cs"
-          ]
-        },
-        {
-          "id": "T009",
-          "title": "Create integration tests for report generation",
-          "status": "pending",
-          "dependencies": ["T003", "T006"],
-          "files": [
-            "Tests/Integration/ReportGenerationTests.cs"
-          ],
-          "checkpoint": "CHECKPOINT_003"
-        }
-      ],
-      "progress": {
-        "total": 9,
-        "completed": 3,
-        "inProgress": 1,
-        "pending": 5,
-        "percentage": 33
-      },
-      "checkpoints": [
-        {
-          "id": "CHECKPOINT_001",
-          "timestamp": "2024-01-15T10:30:00Z",
-          "tasksCompleted": ["T001"],
-          "note": "Checkpoint: Create ScheduledReport entity"
-        },
-        {
-          "id": "CHECKPOINT_002",
-          "timestamp": "2024-01-15T12:00:00Z",
-          "tasksCompleted": ["T003"],
-          "note": "Checkpoint: Create Hangfire job for report generation"
-        },
-        {
-          "id": "CHECKPOINT_AUTO_1705326000000",
-          "timestamp": "2024-01-15T12:00:00Z",
-          "tasksCompleted": ["T001", "T002", "T003"],
-          "note": "Auto-checkpoint: 3 tasks completed"
-        }
-      ],
-      "outputs": {
-        "proposal": {
-          "created": true,
-          "path": ".morph/project/outputs/scheduled-reports/proposal.md"
-        },
-        "spec": {
-          "created": true,
-          "path": ".morph/project/outputs/scheduled-reports/spec.md"
-        },
-        "contracts": {
-          "created": true,
-          "path": ".morph/project/outputs/scheduled-reports/contracts.cs"
-        },
-        "ui-spec": {
-          "created": true,
-          "path": ".morph/project/outputs/scheduled-reports/ui-spec.md"
-        },
-        "tasks": {
-          "created": true,
-          "note": "Tasks are now inline in state.json (schema 3.0.0)"
-        },
-        "decisions": {
-          "created": true,
-          "path": ".morph/project/outputs/scheduled-reports/decisions.md"
-        }
-      },
-      "costs": {
-        "estimated": 5.50,
-        "approved": true,
-        "breakdown": {
-          "hangfire": 0,
-          "storage": 0.02,
-          "sql": 4.99,
-          "containerApp": 0.49
-        }
-      }
-    }
-  },
-  "metadata": {
-    "totalFeatures": 1,
-    "completedFeatures": 0,
-    "totalCostEstimated": 5.50
-  }
-}
+{
+  "version": "3.0.0",
+  "project": {
+    "name": "FishArt",
+    "type": "blazor-server",
+    "createdAt": "2024-01-15T10:00:00Z",
+    "updatedAt": "2024-01-15T14:30:00Z"
+  },
+  "features": {
+    "scheduled-reports": {
+      "status": "in_progress",
+      "phase": "implement",
+      "activeAgents": [
+        "standards-architect",
+        "blazor-builder",
+        "ef-modeler",
+        "hangfire-orchestrator"
+      ],
+      "tasks": [
+        {
+          "id": "T001",
+          "title": "Create ScheduledReport entity",
+          "status": "completed",
+          "completedAt": "2024-01-15T10:30:00Z",
+          "completedBy": "claude",
+          "dependencies": [],
+          "files": [
+            "Domain/Entities/ScheduledReport.cs",
+            "Infrastructure/Persistence/Config/ScheduledReportConfig.cs"
+          ],
+          "checkpoint": "CHECKPOINT_001"
+        },
+        {
+          "id": "T002",
+          "title": "Create CreateReportCommand + Handler",
+          "status": "completed",
+          "completedAt": "2024-01-15T11:15:00Z",
+          "completedBy": "claude",
+          "dependencies": ["T001"],
+          "files": [
+            "Application/Commands/CreateReport/CreateReportCommand.cs",
+            "Application/Commands/CreateReport/CreateReportHandler.cs"
+          ]
+        },
+        {
+          "id": "T003",
+          "title": "Create Hangfire job for report generation",
+          "status": "completed",
+          "completedAt": "2024-01-15T12:00:00Z",
+          "completedBy": "claude",
+          "dependencies": ["T002"],
+          "files": [
+            "Infrastructure/Jobs/GenerateReportJob.cs"
+          ],
+          "checkpoint": "CHECKPOINT_002"
+        },
+        {
+          "id": "T004",
+          "title": "Create ReportList component (Blazor)",
+          "status": "in_progress",
+          "startedAt": "2024-01-15T13:00:00Z",
+          "dependencies": ["T001"],
+          "files": [
+            "Components/Reports/ReportList.razor",
+            "Components/Reports/ReportList.razor.cs",
+            "Components/Reports/ReportList.razor.css"
+          ]
+        },
+        {
+          "id": "T005",
+          "title": "Create CreateReportForm component (Blazor)",
+          "status": "pending",
+          "dependencies": ["T002"],
+          "files": [
+            "Components/Reports/CreateReportForm.razor",
+            "Components/Reports/CreateReportForm.razor.cs",
+            "Components/Reports/CreateReportForm.razor.css"
+          ]
+        },
+        {
+          "id": "T006",
+          "title": "Create API controller for reports",
+          "status": "pending",
+          "dependencies": ["T002"],
+          "files": [
+            "API/Controllers/ReportsController.cs"
+          ]
+        },
+        {
+          "id": "T007",
+          "title": "Add Hangfire dashboard configuration",
+          "status": "pending",
+          "dependencies": ["T003"],
+          "files": [
+            "Program.cs"
+          ]
+        },
+        {
+          "id": "T008",
+          "title": "Create unit tests for CreateReportCommand",
+          "status": "pending",
+          "dependencies": ["T002"],
+          "files": [
+            "Tests/Application/Commands/CreateReportCommandTests.cs"
+          ]
+        },
+        {
+          "id": "T009",
+          "title": "Create integration tests for report generation",
+          "status": "pending",
+          "dependencies": ["T003", "T006"],
+          "files": [
+            "Tests/Integration/ReportGenerationTests.cs"
+          ],
+          "checkpoint": "CHECKPOINT_003"
+        }
+      ],
+      "progress": {
+        "total": 9,
+        "completed": 3,
+        "inProgress": 1,
+        "pending": 5,
+        "percentage": 33
+      },
+      "checkpoints": [
+        {
+          "id": "CHECKPOINT_001",
+          "timestamp": "2024-01-15T10:30:00Z",
+          "tasksCompleted": ["T001"],
+          "note": "Checkpoint: Create ScheduledReport entity"
+        },
+        {
+          "id": "CHECKPOINT_002",
+          "timestamp": "2024-01-15T12:00:00Z",
+          "tasksCompleted": ["T003"],
+          "note": "Checkpoint: Create Hangfire job for report generation"
+        },
+        {
+          "id": "CHECKPOINT_AUTO_1705326000000",
+          "timestamp": "2024-01-15T12:00:00Z",
+          "tasksCompleted": ["T001", "T002", "T003"],
+          "note": "Auto-checkpoint: 3 tasks completed"
+        }
+      ],
+      "outputs": {
+        "proposal": {
+          "created": true,
+          "path": ".morph/project/outputs/scheduled-reports/proposal.md"
+        },
+        "spec": {
+          "created": true,
+          "path": ".morph/project/outputs/scheduled-reports/spec.md"
+        },
+        "contracts": {
+          "created": true,
+          "path": ".morph/project/outputs/scheduled-reports/contracts.cs"
+        },
+        "ui-spec": {
+          "created": true,
+          "path": ".morph/project/outputs/scheduled-reports/ui-spec.md"
+        },
+        "tasks": {
+          "created": true,
+          "note": "Tasks are now inline in state.json (schema 3.0.0)"
+        },
+        "decisions": {
+          "created": true,
+          "path": ".morph/project/outputs/scheduled-reports/decisions.md"
+        }
+      },
+      "costs": {
+        "estimated": 5.50,
+        "approved": true,
+        "breakdown": {
+          "hangfire": 0,
+          "storage": 0.02,
+          "sql": 4.99,
+          "containerApp": 0.49
+        }
+      }
+    }
+  },
+  "metadata": {
+    "totalFeatures": 1,
+    "completedFeatures": 0,
+    "totalCostEstimated": 5.50
+  }
+}

package/content/.morph/features/.gitkeep

@@ -1,25 +1,25 @@
-# Features em Desenvolvimento
-
-Esta pasta contém as features ATIVAS em desenvolvimento.
-
-## Estrutura
-
-```
-features/
-└── {feature-name}/
-    ├── proposal.md    # Proposta (por que e o quê)
-    ├── spec.md        # Especificação técnica
-    ├── tasks.md       # Checklist de implementação
-    ├── contracts.cs   # Interfaces e DTOs
-    ├── decisions.md   # ADRs
-    └── recap.md       # Resumo pós-implementação
-```
-
-## Workflow
-
-1. `/morph-proposal {feature}` - Criar nova feature
-2. Revisar e aprovar proposal
-3. `/morph-apply {feature}` - Implementar
-4. `/morph-archive {feature}` - Arquivar quando concluída
-
-*Gerado pelo MORPH Framework*
+# Features em Desenvolvimento
+
+Esta pasta contém as features ATIVAS em desenvolvimento.
+
+## Estrutura
+
+```
+features/
+└── {feature-name}/
+    ├── proposal.md    # Proposta (por que e o quê)
+    ├── spec.md        # Especificação técnica
+    ├── tasks.md       # Checklist de implementação
+    ├── contracts.cs   # Interfaces e DTOs
+    ├── decisions.md   # ADRs
+    └── recap.md       # Resumo pós-implementação
+```
+
+## Workflow
+
+1. `/morph-proposal {feature}` - Criar nova feature
+2. Revisar e aprovar proposal
+3. `/morph-apply {feature}` - Implementar
+4. `/morph-archive {feature}` - Arquivar quando concluída
+
+*Gerado pelo MORPH Framework*

package/content/.morph/hooks/README.md

@@ -187,4 +187,162 @@ bash -x content/.morph/hooks/pre-commit-costs.sh
 
 ---
 
+## Agent Teams Hooks (Claude Code)
+
+**New in MORPH 3.0:** Hooks for Claude Code's experimental Agent Teams feature.
+
+### Available Agent Teams Hooks
+
+| Hook | Event | Description | Action |
+|------|-------|-------------|--------|
+| `teammate-idle.js` | TeammateIdle | Validates teammate's work before proceeding | ❌ Blocks if errors |
+| `task-completed.js` | TaskCompleted | Validates task deliverables on completion | ❌ Blocks if errors |
+
+### teammate-idle.js
+
+**Triggered:** When a teammate in Agent Teams is idle and waiting for instructions
+**Purpose:** Quality gate to validate recent work before allowing teammate to proceed
+**Validates:** Security, code quality, standards compliance
+
+**Usage:**
+```bash
+node content/.morph/hooks/teammate-idle.js <feature-name> [--dry-run] [--verbose]
+```
+
+**Example:**
+```bash
+node content/.morph/hooks/teammate-idle.js user-authentication --verbose
+```
+
+**Output:**
+```
+🔔 TeammateIdle Hook Triggered
+   Feature: user-authentication
+   Event: Teammate is idle, validating recent work...
+
+🎯 Executing TeammateIdle hook for feature: user-authentication
+   Validators: security-expert
+
+🔍 Running security-expert validators...
+
+✅ TeammateIdle hook: All validators passed
+```
+
+**Configuration:**
+
+Validators are configured in `agents.json` for Tier 4 agents:
+
+```json
+{
+  "security-expert": {
+    "tier": 4,
+    "role": "validator",
+    "relationships": {
+      "runs_in": "hooks",
+      "hook_triggers": ["TeammateIdle", "TaskCompleted"]
+    },
+    "hook_behavior": {
+      "validates": [
+        "SQL injection (string concatenation in queries)",
+        "Hardcoded secrets (API keys, passwords, connection strings)",
+        "XSS (@Html.Raw usage in Razor/Blazor)"
+      ],
+      "severity": "error",
+      "blocks_on_fail": true
+    }
+  }
+}
+```
+
+### task-completed.js
+
+**Triggered:** When a task is marked as completed
+**Purpose:** Quality gate to validate task deliverables before marking done
+**Validates:** All active validators for the feature
+
+**Usage:**
+```bash
+node content/.morph/hooks/task-completed.js <feature-name> <task-id> [--dry-run] [--verbose]
+```
+
+**Example:**
+```bash
+node content/.morph/hooks/task-completed.js user-authentication T003 --verbose
+```
+
+**Output:**
+```
+🔔 TaskCompleted Hook Triggered
+   Feature: user-authentication
+   Task: T003
+   Event: Task marked complete, validating deliverables...
+
+🎯 Executing TaskCompleted hook for feature: user-authentication
+   Validators: security-expert
+
+🔍 Running security-expert validators...
+
+❌ TaskCompleted hook: Validation FAILED
+
+🚫 ERRORS (blocking):
+   security-expert → security
+      • Hardcoded secret detected: API key in appsettings.json (appsettings.json:15)
+      • SQL injection risk: String concatenation in UserService.cs (UserService.cs:42)
+
+⛔ Hook execution BLOCKED - fix errors before proceeding
+
+💡 TIP: Fix the errors above before the task can be marked complete.
+```
+
+### Integration with Claude Code
+
+When Agent Teams is enabled (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`), these hooks run automatically:
+
+1. **TeammateIdle**: When a teammate finishes work and waits
+2. **TaskCompleted**: When `morph-spec task done` is called
+
+**Claude Code Settings:**
+```json
+{
+  "hooks": {
+    "TeammateIdle": "node content/.morph/hooks/teammate-idle.js {feature}",
+    "TaskCompleted": "node content/.morph/hooks/task-completed.js {feature} {taskId}"
+  }
+}
+```
+
+### Dry Run Mode
+
+Test hooks without blocking:
+
+```bash
+# See what would run without executing
+node content/.morph/hooks/teammate-idle.js my-feature --dry-run
+
+# Output:
+# 🔍 DRY RUN - Would execute:
+#    - security-expert (severity: error)
+#      • SQL injection (string concatenation in queries)
+#      • Hardcoded secrets (API keys, passwords, connection strings)
+#      • XSS (@Html.Raw usage in Razor/Blazor)
+```
+
+### Hook Behavior Configuration
+
+| Field | Description | Values |
+|-------|-------------|--------|
+| `validates` | Array of validation checks | Descriptive strings |
+| `severity` | Error level | `"error"` (blocks) \| `"warning"` (warns only) |
+| `blocks_on_fail` | Block on failure | `true` (default) \| `false` |
+
+### Exit Codes
+
+| Code | Meaning |
+|------|---------|
+| 0 | All validators passed |
+| 1 | Validation failed and blocked |
+| 2 | Configuration error (missing feature, etc.) |
+
+---
+
 *MORPH-SPEC Framework - Git Hooks*