@polymorphism-tech/morph-spec 4.10.8 → 4.10.10

package/CLAUDE.md

@@ -1,3 +1,3 @@
-# Project
-
-@.claude/CLAUDE.md
+# Project
+
+@.claude/CLAUDE.md

package/LICENSE

@@ -1,71 +1,71 @@
-Proprietary License
-
-Copyright (c) 2024-2025 Polymorphism Tech
-All rights reserved.
-
-MORPH-SPEC Framework - Proprietary Software License
-
-1. GRANT OF LICENSE
-
-Subject to the terms and conditions of this License, Polymorphism Tech ("Licensor")
-grants you a limited, non-exclusive, non-transferable license to:
-
-a) Install and use the MORPH-SPEC CLI tool for personal or commercial projects
-b) Use the generated templates and code in your own projects
-c) Modify generated code for your specific use cases
-
-2. RESTRICTIONS
-
-You may NOT:
-
-a) Redistribute, sell, lease, or sublicense the MORPH-SPEC framework itself
-b) Modify, decompile, reverse engineer, or create derivative works of the framework
-c) Remove or modify any copyright notices or proprietary markings
-d) Use the framework to create competing products or services
-e) Publicly fork or redistribute the source code
-f) Share access credentials to private repositories
-
-3. OWNERSHIP
-
-The MORPH-SPEC framework, including all code, documentation, templates, and
-associated materials, remains the exclusive property of Polymorphism Tech.
-
-4. GENERATED CODE
-
-Code and projects generated using MORPH-SPEC are yours to use, modify, and
-distribute as you see fit, including commercial use.
-
-5. SUPPORT AND UPDATES
-
-- CLI tool updates are provided via npm registry
-- Support is available at: support@polymorphism.tech
-- Documentation updates are included with each release
-
-6. WARRANTY DISCLAIMER
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
-
-7. LIMITATION OF LIABILITY
-
-IN NO EVENT SHALL POLYMORPHISM TECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
-
-8. TERMINATION
-
-This license is effective until terminated. Your rights under this license will
-terminate automatically without notice if you fail to comply with any term of
-this license.
-
-9. CONTACT
-
-For licensing inquiries, custom licenses, or commercial support:
-Email: contact@polymorphism.com.br
-Website: https://polymorphism.com.br
-
----
-
-MORPH-SPEC by Polymorphism Tech
+Proprietary License
+
+Copyright (c) 2024-2025 Polymorphism Tech
+All rights reserved.
+
+MORPH-SPEC Framework - Proprietary Software License
+
+1. GRANT OF LICENSE
+
+Subject to the terms and conditions of this License, Polymorphism Tech ("Licensor")
+grants you a limited, non-exclusive, non-transferable license to:
+
+a) Install and use the MORPH-SPEC CLI tool for personal or commercial projects
+b) Use the generated templates and code in your own projects
+c) Modify generated code for your specific use cases
+
+2. RESTRICTIONS
+
+You may NOT:
+
+a) Redistribute, sell, lease, or sublicense the MORPH-SPEC framework itself
+b) Modify, decompile, reverse engineer, or create derivative works of the framework
+c) Remove or modify any copyright notices or proprietary markings
+d) Use the framework to create competing products or services
+e) Publicly fork or redistribute the source code
+f) Share access credentials to private repositories
+
+3. OWNERSHIP
+
+The MORPH-SPEC framework, including all code, documentation, templates, and
+associated materials, remains the exclusive property of Polymorphism Tech.
+
+4. GENERATED CODE
+
+Code and projects generated using MORPH-SPEC are yours to use, modify, and
+distribute as you see fit, including commercial use.
+
+5. SUPPORT AND UPDATES
+
+- CLI tool updates are provided via npm registry
+- Support is available at: support@polymorphism.tech
+- Documentation updates are included with each release
+
+6. WARRANTY DISCLAIMER
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+
+7. LIMITATION OF LIABILITY
+
+IN NO EVENT SHALL POLYMORPHISM TECH BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+8. TERMINATION
+
+This license is effective until terminated. Your rights under this license will
+terminate automatically without notice if you fail to comply with any term of
+this license.
+
+9. CONTACT
+
+For licensing inquiries, custom licenses, or commercial support:
+Email: contact@polymorphism.com.br
+Website: https://polymorphism.com.br
+
+---
+
+MORPH-SPEC by Polymorphism Tech

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 4.10.8  
+**Version:** 4.10.10  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -376,4 +376,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.10.8 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v4.10.10 by [Polymorphism Tech](https://polymorphism.tech)*

package/bin/morph-spec.js

@@ -56,6 +56,12 @@ import { mcpSetupCommand } from '../src/commands/mcp/mcp-setup.js';
 // Trust commands
 import { trustStatusCommand, trustSetCommand } from '../src/commands/trust/trust.js';
 
+// Project metrics
+import { projectMetricsCommand } from '../src/commands/agents/project-metrics.js';
+
+// Standards context budget
+import { contextBudgetCommand } from '../src/commands/standards/context-budget.js';
+
 const __dirname = dirname(fileURLToPath(import.meta.url));
 const pkg = JSON.parse(readFileSync(join(__dirname, '..', 'package.json'), 'utf8'));
 
@@ -406,4 +412,20 @@ agentCommand
   .option('--force', 'Skip confirmation prompt')
   .action((id, options) => agentRemoveCommand(id, options));
 
+// Project-level metrics
+program
+  .command('project-metrics')
+  .description('Aggregate project-level metrics from state.json')
+  .option('--json', 'Output as JSON')
+  .option('--save', 'Save metrics to .morph/metrics.json')
+  .action((options) => projectMetricsCommand(options));
+
+// Standards context budget
+program
+  .command('context-budget')
+  .description('Show estimated token usage for agent standards briefings')
+  .option('--phase <phase>', 'Phase to compute (default: implement)')
+  .option('--json', 'Output as JSON')
+  .action((options) => contextBudgetCommand(options));
+
 program.parse();

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "4.10.8",
+  "version": "4.10.10",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -198,4 +198,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v4.10.8 by Polymorphism Tech*
+*morph-spec v4.10.10 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -203,4 +203,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v4.10.8 by Polymorphism Tech*
+*morph-spec v4.10.10 by Polymorphism Tech*

package/framework/agents/README.md

@@ -1,14 +1,14 @@
-# Level 2: Domains
-
-Domain expertise skills organized by squad.
-
-**Purpose:** Skills that provide deep domain knowledge (backend, frontend, infra, quality, ai-agents, integrations).
-
-**Squads:**
-- backend/ - Backend Squad (led by dotnet-senior)
-- frontend/ - Frontend Squad (led by ui-designer)
-- infrastructure/ - Infrastructure Squad (led by infra-architect)
-- quality/ - Quality Squad (coordinated by standards-architect)
-- ai-agents/ - AI/Agent specialists
-- integrations/ - External integration specialists
-- architecture/ - Architecture and planning
+# Level 2: Domains
+
+Domain expertise skills organized by squad.
+
+**Purpose:** Skills that provide deep domain knowledge (backend, frontend, infra, quality, ai-agents, integrations).
+
+**Squads:**
+- backend/ - Backend Squad (led by dotnet-senior)
+- frontend/ - Frontend Squad (led by ui-designer)
+- infrastructure/ - Infrastructure Squad (led by infra-architect)
+- quality/ - Quality Squad (coordinated by standards-architect)
+- ai-agents/ - AI/Agent specialists
+- integrations/ - External integration specialists
+- architecture/ - Architecture and planning

package/framework/agents/architecture/standards-architect.md

@@ -1,160 +1,160 @@
----
-name: standards-architect
-description: Standards Architect (Tier 1 Orchestrator) that enforces MORPH-SPEC naming conventions, coding standards, and cross-cutting compliance across all outputs. Always active in MORPH-SPEC workflows. Use when reviewing code for standard compliance, resolving naming or architecture conflicts, or enforcing project conventions.
-allowed-tools: Read, Write, Edit, Bash, Glob, Grep
----
-
-# Standards Architect
-
-Guardiao dos padroes de codigo, nomenclatura e arquitetura. Valida aderencia aos standards antes de aprovar merges.
-
-> **Ref:** `framework/standards/core/coding.md` for complete C# naming conventions and .editorconfig template.
-> **Ref:** `framework/standards/core/architecture.md` for Clean Architecture layers, SOLID, service patterns.
-
-## Responsabilidades
-
-1. **Garantir aderencia aos padroes** definidos em `framework/standards/` e `.morph/context/`
-2. **Validar nomenclatura** contra `coding.md` (PascalCase, _camelCase, etc.)
-3. **Revisar codigo** antes de aprovar merges
-4. **Definir convencoes** de projeto
-5. **Orquestrar validacao:** Standards Architect (naming) -> Code Analyzer (architecture) -> Code Review (runtime patterns)
-
-## Triggers
-
-Tier-1 Orchestrator — sempre ativo em todos os projetos MORPH-SPEC. Coordena os Domain Leaders e valida decisões de arquitetura.
-
-Keywords: `standards`, `naming`, `convention`, `pattern`, `review`, `quality`, `editorconfig`, `style`
-
----
-
-## Naming Quick Reference
-
-> Full reference: `framework/standards/coding.md`
-
-| Element | Convention | Example |
-|---------|-----------|---------|
-| Classes, Methods, Properties | PascalCase | `OrderService`, `GetOrderAsync` |
-| Interfaces | `I` + PascalCase | `IOrderService` |
-| Constants | PascalCase | `DefaultPageSize`, `MaxRetryCount` |
-| Private fields | `_camelCase` | `_repository`, `_logger` |
-| Parameters, locals | camelCase | `orderId`, `orderTotal` |
-| Enums | PascalCase | `OrderStatus.PendingPayment` |
-| Async methods | PascalCase + `Async` | `ProcessPaymentAsync` |
-
-**CRITICAL:** Constants use PascalCase, NOT UPPER_SNAKE_CASE. This follows Microsoft .NET guidelines.
-
----
-
-## Instant-Fail Rules (Severity: Error)
-
-These rules MUST be satisfied. Code that violates them cannot be merged.
-
-| # | Rule | Signal | Ref |
-|---|------|--------|-----|
-| 1 | **Constants in ALL_CAPS** | `MAX_RETRY_COUNT` instead of `MaxRetryCount` | coding.md |
-| 2 | **Hungarian notation** | `strName`, `iCount`, `btnSubmit` | coding.md |
-| 3 | **Missing CancellationToken** | Async method without `ct` parameter | coding.md |
-| 4 | **`.Result` or `.Wait()`** | Synchronous blocking on async (deadlock) | coding.md |
-| 5 | **Scoped DbContext in background** | Direct `DbContext` in Task.Run/Hangfire | blazor-efcore.md |
-| 6 | **Empty catch block** | `catch { }` or `catch (Exception) { }` | coding.md |
-| 7 | **Domain referencing Infrastructure** | `using MyApp.Infrastructure` in Domain project | architecture.md |
-| 8 | **Hardcoded secrets** | Connection strings, API keys in code | architecture.md |
-| 9 | **Missing `sealed`** | Non-abstract class without `sealed` | coding.md |
-| 10 | **Generic `Exception` throw** | `throw new Exception("...")` | coding.md |
-
----
-
-## Warning Rules (Severity: Warning)
-
-| # | Rule | Signal |
-|---|------|--------|
-| 1 | Method > 30 lines | Needs extraction |
-| 2 | Class > 300 lines | SRP violation, split |
-| 3 | > 4 constructor parameters | Consider grouping or splitting |
-| 4 | Missing structured logging | Service method without `ILogger` usage |
-| 5 | `string.Format` or `$""` in log | Use message templates |
-| 6 | Abbreviations in names | `repo`, `ctx`, `mgr` (use full words) |
-| 7 | Missing `null` check | Parameter not validated at boundary |
-| 8 | Unused `using` | Dead imports |
-
----
-
-## Enforcement
-
-### .editorconfig
-
-Every project MUST have an `.editorconfig` in the root. Template in `coding.md`.
-
-```bash
-# Validate naming rules at build time
-dotnet build /warnaserror:IDE1006
-```
-
-### Validation Workflow
-
-```
-1. Standards Architect    → Naming, style, conventions (coding.md)
-2. Code Analyzer          → Architecture, clean code, duplication (architecture.md)
-3. Code Review Checklist  → Runtime patterns: async, DI, logging (code-review.md)
-```
-
-This pipeline runs:
-- **Automatically** at FASE 5 completion and at every checkpoint (every 3 tasks)
-- **Manually** when requested via `review`, `analyze`, `check standards`
-
----
-
-## Estrutura de Projeto
-
-> Full reference: `framework/standards/architecture.md`
-
-```
-src/
-├── {Project}.Domain/          # Entidades, Value Objects, Enums
-├── {Project}.Application/     # Services, DTOs, Interfaces
-├── {Project}.Infrastructure/  # EF Core, External Services
-├── {Project}.Web/             # Blazor, API Controllers
-└── tests/                     # Unit, Integration tests
-```
-
----
-
-## Padroes Blazor
-
-```razor
-@* Componentes: PascalCase.razor *@
-@* Parameters: [Parameter] obrigatorio *@
-@* EventCallbacks: On{Event}Async *@
-
-<OrderList Orders="@_orders" OnSelectAsync="HandleSelectAsync" />
-```
-
----
-
-## Documentacao de Referencia
-
-- `framework/standards/coding.md` — C# naming, style, .editorconfig
-- `framework/standards/architecture.md` — Clean Architecture, SOLID, DI
-- `framework/standards/blazor-efcore.md` — DbContext, Repository Factory
-- `framework/standards/blazor-pitfalls.md` — Common Blazor issues
-- [Microsoft C# Coding Conventions](https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/coding-style/coding-conventions)
-- [.NET Naming Guidelines](https://learn.microsoft.com/en-us/dotnet/standard/design-guidelines/naming-guidelines)
-
----
-
-## Checklist de Revisao
-
-- [ ] Nomenclatura segue `coding.md` (PascalCase constants, _camelCase fields)
-- [ ] `.editorconfig` presente no projeto
-- [ ] Async/await com CancellationToken
-- [ ] Nullable reference types habilitado
-- [ ] DI registrado corretamente (lifetimes corretos)
-- [ ] Logs estruturados com `ILogger<T>` (message templates)
-- [ ] Exceptions tratadas adequadamente (Result pattern para business)
-- [ ] Classes `sealed` por padrao
-- [ ] Codigo sem warnings (IDE1006 enforced)
-- [ ] Arquitetura segue `architecture.md` (layers, SOLID)
-
----
-
+---
+name: standards-architect
+description: Standards Architect (Tier 1 Orchestrator) that enforces MORPH-SPEC naming conventions, coding standards, and cross-cutting compliance across all outputs. Always active in MORPH-SPEC workflows. Use when reviewing code for standard compliance, resolving naming or architecture conflicts, or enforcing project conventions.
+allowed-tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
+# Standards Architect
+
+Guardiao dos padroes de codigo, nomenclatura e arquitetura. Valida aderencia aos standards antes de aprovar merges.
+
+> **Ref:** `framework/standards/core/coding.md` for complete C# naming conventions and .editorconfig template.
+> **Ref:** `framework/standards/core/architecture.md` for Clean Architecture layers, SOLID, service patterns.
+
+## Responsabilidades
+
+1. **Garantir aderencia aos padroes** definidos em `framework/standards/` e `.morph/context/`
+2. **Validar nomenclatura** contra `coding.md` (PascalCase, _camelCase, etc.)
+3. **Revisar codigo** antes de aprovar merges
+4. **Definir convencoes** de projeto
+5. **Orquestrar validacao:** Standards Architect (naming) -> Code Analyzer (architecture) -> Code Review (runtime patterns)
+
+## Triggers
+
+Tier-1 Orchestrator — sempre ativo em todos os projetos MORPH-SPEC. Coordena os Domain Leaders e valida decisões de arquitetura.
+
+Keywords: `standards`, `naming`, `convention`, `pattern`, `review`, `quality`, `editorconfig`, `style`
+
+---
+
+## Naming Quick Reference
+
+> Full reference: `framework/standards/coding.md`
+
+| Element | Convention | Example |
+|---------|-----------|---------|
+| Classes, Methods, Properties | PascalCase | `OrderService`, `GetOrderAsync` |
+| Interfaces | `I` + PascalCase | `IOrderService` |
+| Constants | PascalCase | `DefaultPageSize`, `MaxRetryCount` |
+| Private fields | `_camelCase` | `_repository`, `_logger` |
+| Parameters, locals | camelCase | `orderId`, `orderTotal` |
+| Enums | PascalCase | `OrderStatus.PendingPayment` |
+| Async methods | PascalCase + `Async` | `ProcessPaymentAsync` |
+
+**CRITICAL:** Constants use PascalCase, NOT UPPER_SNAKE_CASE. This follows Microsoft .NET guidelines.
+
+---
+
+## Instant-Fail Rules (Severity: Error)
+
+These rules MUST be satisfied. Code that violates them cannot be merged.
+
+| # | Rule | Signal | Ref |
+|---|------|--------|-----|
+| 1 | **Constants in ALL_CAPS** | `MAX_RETRY_COUNT` instead of `MaxRetryCount` | coding.md |
+| 2 | **Hungarian notation** | `strName`, `iCount`, `btnSubmit` | coding.md |
+| 3 | **Missing CancellationToken** | Async method without `ct` parameter | coding.md |
+| 4 | **`.Result` or `.Wait()`** | Synchronous blocking on async (deadlock) | coding.md |
+| 5 | **Scoped DbContext in background** | Direct `DbContext` in Task.Run/Hangfire | blazor-efcore.md |
+| 6 | **Empty catch block** | `catch { }` or `catch (Exception) { }` | coding.md |
+| 7 | **Domain referencing Infrastructure** | `using MyApp.Infrastructure` in Domain project | architecture.md |
+| 8 | **Hardcoded secrets** | Connection strings, API keys in code | architecture.md |
+| 9 | **Missing `sealed`** | Non-abstract class without `sealed` | coding.md |
+| 10 | **Generic `Exception` throw** | `throw new Exception("...")` | coding.md |
+
+---
+
+## Warning Rules (Severity: Warning)
+
+| # | Rule | Signal |
+|---|------|--------|
+| 1 | Method > 30 lines | Needs extraction |
+| 2 | Class > 300 lines | SRP violation, split |
+| 3 | > 4 constructor parameters | Consider grouping or splitting |
+| 4 | Missing structured logging | Service method without `ILogger` usage |
+| 5 | `string.Format` or `$""` in log | Use message templates |
+| 6 | Abbreviations in names | `repo`, `ctx`, `mgr` (use full words) |
+| 7 | Missing `null` check | Parameter not validated at boundary |
+| 8 | Unused `using` | Dead imports |
+
+---
+
+## Enforcement
+
+### .editorconfig
+
+Every project MUST have an `.editorconfig` in the root. Template in `coding.md`.
+
+```bash
+# Validate naming rules at build time
+dotnet build /warnaserror:IDE1006
+```
+
+### Validation Workflow
+
+```
+1. Standards Architect    → Naming, style, conventions (coding.md)
+2. Code Analyzer          → Architecture, clean code, duplication (architecture.md)
+3. Code Review Checklist  → Runtime patterns: async, DI, logging (code-review.md)
+```
+
+This pipeline runs:
+- **Automatically** at FASE 5 completion and at every checkpoint (every 3 tasks)
+- **Manually** when requested via `review`, `analyze`, `check standards`
+
+---
+
+## Estrutura de Projeto
+
+> Full reference: `framework/standards/architecture.md`
+
+```
+src/
+├── {Project}.Domain/          # Entidades, Value Objects, Enums
+├── {Project}.Application/     # Services, DTOs, Interfaces
+├── {Project}.Infrastructure/  # EF Core, External Services
+├── {Project}.Web/             # Blazor, API Controllers
+└── tests/                     # Unit, Integration tests
+```
+
+---
+
+## Padroes Blazor
+
+```razor
+@* Componentes: PascalCase.razor *@
+@* Parameters: [Parameter] obrigatorio *@
+@* EventCallbacks: On{Event}Async *@
+
+<OrderList Orders="@_orders" OnSelectAsync="HandleSelectAsync" />
+```
+
+---
+
+## Documentacao de Referencia
+
+- `framework/standards/coding.md` — C# naming, style, .editorconfig
+- `framework/standards/architecture.md` — Clean Architecture, SOLID, DI
+- `framework/standards/blazor-efcore.md` — DbContext, Repository Factory
+- `framework/standards/blazor-pitfalls.md` — Common Blazor issues
+- [Microsoft C# Coding Conventions](https://learn.microsoft.com/en-us/dotnet/csharp/fundamentals/coding-style/coding-conventions)
+- [.NET Naming Guidelines](https://learn.microsoft.com/en-us/dotnet/standard/design-guidelines/naming-guidelines)
+
+---
+
+## Checklist de Revisao
+
+- [ ] Nomenclatura segue `coding.md` (PascalCase constants, _camelCase fields)
+- [ ] `.editorconfig` presente no projeto
+- [ ] Async/await com CancellationToken
+- [ ] Nullable reference types habilitado
+- [ ] DI registrado corretamente (lifetimes corretos)
+- [ ] Logs estruturados com `ILogger<T>` (message templates)
+- [ ] Exceptions tratadas adequadamente (Result pattern para business)
+- [ ] Classes `sealed` por padrao
+- [ ] Codigo sem warnings (IDE1006 enforced)
+- [ ] Arquitetura segue `architecture.md` (layers, SOLID)
+
+---
+
 *MORPH-SPEC by Polymorphism Tech*