@polymorphism-tech/morph-spec 7.9.4 → 8.1.0

package/framework/rules/ai-agents-standards.md

@@ -1,45 +1,45 @@
----
-paths:
-  - "**/Agents/**"
-  - "**/agents/**"
-  - "**/*Agent*.cs"
-stacks:
-  - dotnet
----
-
-# Microsoft Agent Framework Standards
-
-> **Layer 0/1 — auto-carregados.** São os standards core: aplicam-se a praticamente todo
-> agente MAF. Carregue-os sempre que tocar código de agentes.
-
-@.morph/framework/standards/ai-agents/setup.md
-@.morph/framework/standards/ai-agents/sweet-spot.md
-@.morph/framework/standards/ai-agents/providers/model-registry.md
-@.morph/framework/standards/ai-agents/structured-output.md
-@.morph/framework/standards/ai-agents/multi-agent-patterns.md
-@.morph/framework/standards/ai-agents/prompts-in-db.md
-@.morph/framework/standards/ai-agents/rag-custom-pgvector.md
-@.morph/framework/standards/ai-agents/middleware-patterns.md
-@.morph/framework/standards/ai-agents/workflows.md
-@.morph/framework/standards/ai-agents/production.md
-
----
-
-> **Layer 2 — sob demanda (NÃO auto-carregados).** São standards de modalidade, otimização e
-> MCP: relevantes apenas quando a feature usa especificamente esse recurso. Carregue via
-> `morph-standards` quando uma keyword corresponder — manter fora do auto-load preserva o
-> context window para o trabalho que importa.
-
-| Standard | Carregue quando a feature envolve |
-|----------|-----------------------------------|
-| `ai-agents/modalities-vision.md` | imagem → texto (OCR, análise de documento, visão) |
-| `ai-agents/modalities-image-gen.md` | texto → imagem (geração de mockups, posts, assets) |
-| `ai-agents/modalities-speech-to-text.md` | áudio → texto (transcrição, legendagem) |
-| `ai-agents/modalities-text-to-speech.md` | texto → áudio (síntese de voz) |
-| `ai-agents/batching.md` | processar N prompts independentes em lote (Batch API) |
-| `ai-agents/service-tier-flex.md` | otimização de custo em jobs assíncronos (tier flex) |
-| `ai-agents/agent-session.md` | agentes conversacionais com histórico/reducers |
-| `ai-agents/context-providers.md` | injeção dinâmica de contexto (`AIContextProvider`) |
-| `ai-agents/mcp-tools.md` | agente MAF consome um MCP server externo |
-| `ai-agents/mcp-server.md` | projeto expõe capacidades como MCP server |
-| `integration/mcp/mcp-tools.md` | integração MCP cross-domain (fora do escopo MAF) |
+---
+paths:
+  - "**/Agents/**"
+  - "**/agents/**"
+  - "**/*Agent*.cs"
+stacks:
+  - dotnet
+---
+
+# Microsoft Agent Framework Standards
+
+> **Layer 0/1 — auto-carregados.** São os standards core: aplicam-se a praticamente todo
+> agente MAF. Carregue-os sempre que tocar código de agentes.
+
+@.morph/framework/standards/ai-agents/setup.md
+@.morph/framework/standards/ai-agents/sweet-spot.md
+@.morph/framework/standards/ai-agents/providers/model-registry.md
+@.morph/framework/standards/ai-agents/structured-output.md
+@.morph/framework/standards/ai-agents/multi-agent-patterns.md
+@.morph/framework/standards/ai-agents/prompts-in-db.md
+@.morph/framework/standards/ai-agents/rag-custom-pgvector.md
+@.morph/framework/standards/ai-agents/middleware-patterns.md
+@.morph/framework/standards/ai-agents/workflows.md
+@.morph/framework/standards/ai-agents/production.md
+
+---
+
+> **Layer 2 — sob demanda (NÃO auto-carregados).** São standards de modalidade, otimização e
+> MCP: relevantes apenas quando a feature usa especificamente esse recurso. Carregue via
+> `morph-standards` quando uma keyword corresponder — manter fora do auto-load preserva o
+> context window para o trabalho que importa.
+
+| Standard | Carregue quando a feature envolve |
+|----------|-----------------------------------|
+| `ai-agents/modalities-vision.md` | imagem → texto (OCR, análise de documento, visão) |
+| `ai-agents/modalities-image-gen.md` | texto → imagem (geração de mockups, posts, assets) |
+| `ai-agents/modalities-speech-to-text.md` | áudio → texto (transcrição, legendagem) |
+| `ai-agents/modalities-text-to-speech.md` | texto → áudio (síntese de voz) |
+| `ai-agents/batching.md` | processar N prompts independentes em lote (Batch API) |
+| `ai-agents/service-tier-flex.md` | otimização de custo em jobs assíncronos (tier flex) |
+| `ai-agents/agent-session.md` | agentes conversacionais com histórico/reducers |
+| `ai-agents/context-providers.md` | injeção dinâmica de contexto (`AIContextProvider`) |
+| `ai-agents/mcp-tools.md` | agente MAF consome um MCP server externo |
+| `ai-agents/mcp-server.md` | projeto expõe capacidades como MCP server |
+| `integration/mcp/mcp-tools.md` | integração MCP cross-domain (fora do escopo MAF) |

package/framework/rules/dotnet-templates.md

@@ -1,86 +1,86 @@
----
-paths:
-  - "**/*.cs"
-  - "**/*.csproj"
-stacks:
-  - dotnet
----
-
-# .NET Code Templates
-
-When implementing .NET features, use these templates as reference patterns.
-Read the template file to see the exact pattern, then generate code following it.
-
-## Scaffold (preferred for new slices)
-
-**Always use scaffold for new VSA slices — never create feature files manually.**
-
-```bash
-morph-spec scaffold dotnet <feature> <slice-name> [--namespace <ns>] [--dry-run]
-```
-
-Examples:
-```bash
-morph-spec scaffold dotnet book create-book
-morph-spec scaffold dotnet book get-book-by-id
-morph-spec scaffold dotnet book update-book
-morph-spec scaffold dotnet book delete-book
-morph-spec scaffold dotnet book get-all-books
-```
-
-Generates 7 files: endpoint, handler, request, response, validator + entity, errors (shared at feature level). Entity/errors auto-skipped if they already exist.
-
-**Only use `template render` for individual files when adding to an existing slice.**
-
-## VSA Feature Templates (Vertical Slice Architecture)
-
-For each new feature slice, follow the patterns in these templates:
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| Endpoint | `.morph/framework/templates/code/dotnet/feature/endpoint.cs.hbs` | IApiEndpoint with MapEndpoint() |
-| Handler | `.morph/framework/templates/code/dotnet/feature/handler.cs.hbs` | IHandler<TRequest, TResponse> |
-| Request | `.morph/framework/templates/code/dotnet/feature/request.cs.hbs` | Sealed record DTO |
-| Response | `.morph/framework/templates/code/dotnet/feature/response.cs.hbs` | Sealed record DTO |
-| Validator | `.morph/framework/templates/code/dotnet/feature/validator.cs.hbs` | FluentValidation AbstractValidator |
-| Entity | `.morph/framework/templates/code/dotnet/feature/entity.cs.hbs` | Domain entity |
-| Errors | `.morph/framework/templates/code/dotnet/feature/errors.cs.hbs` | Error factory |
-
-## Base Abstractions (read once per project setup)
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| IHandler | `.morph/framework/templates/code/dotnet/abstractions/handler.cs` | Handler interface |
-| Result<T> | `.morph/framework/templates/code/dotnet/abstractions/result.cs` | Railway-oriented result |
-| Error | `.morph/framework/templates/code/dotnet/abstractions/error.cs` | Error types |
-| IApiEndpoint | `.morph/framework/templates/code/dotnet/abstractions/api-endpoint.cs` | Endpoint interface |
-
-## Extensions & Pipeline (read once per project setup)
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| Handler Registration | `.morph/framework/templates/code/dotnet/extensions/handler-registration.cs` | Scrutor auto-discovery |
-| Map Endpoints | `.morph/framework/templates/code/dotnet/extensions/map-endpoints.cs` | IApiEndpoint discovery |
-| Result Extensions | `.morph/framework/templates/code/dotnet/extensions/result-extensions.cs` | Match() pattern |
-| Database Config | `.morph/framework/templates/code/dotnet/extensions/database-extensions.cs` | EF Core + Npgsql |
-| Health Checks | `.morph/framework/templates/code/dotnet/extensions/health-checks.cs` | Health endpoints |
-| Validation Decorator | `.morph/framework/templates/code/dotnet/pipelines/validation-decorator.cs` | FluentValidation pipeline |
-| Logging Decorator | `.morph/framework/templates/code/dotnet/pipelines/logging-decorator.cs` | Duration tracking |
-| Exception Handler | `.morph/framework/templates/code/dotnet/exceptions/exception-handler.cs` | ProblemDetails |
-| API Tags | `.morph/framework/templates/code/dotnet/constants/api-tags.cs` | Scalar/Swagger groups |
-
-## Specialized Templates
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| Migration | `.morph/framework/templates/code/dotnet/database/migration.cs` | EF Core migration |
-| Hangfire Job | `.morph/framework/templates/code/dotnet/jobs/job.cs` | Background job |
-| MAF Agent | `.morph/framework/templates/code/dotnet/jobs/agent.cs` | MS Agent Framework |
-| Unit Test | `.morph/framework/templates/code/dotnet/test.cs` | xUnit AAA test |
-| Contracts VSA | `.morph/framework/templates/code/dotnet/contracts/contracts-vsa.cs` | Full slice contracts |
-
-## Usage
-
-1. **Read the template** to see the exact pattern
-2. **Generate code following the same structure** (naming, namespaces, imports)
-3. Or render via CLI: `morph-spec template render <id> <output> '<variables>'`
+---
+paths:
+  - "**/*.cs"
+  - "**/*.csproj"
+stacks:
+  - dotnet
+---
+
+# .NET Code Templates
+
+When implementing .NET features, use these templates as reference patterns.
+Read the template file to see the exact pattern, then generate code following it.
+
+## Scaffold (preferred for new slices)
+
+**Always use scaffold for new VSA slices — never create feature files manually.**
+
+```bash
+morph-spec scaffold dotnet <feature> <slice-name> [--namespace <ns>] [--dry-run]
+```
+
+Examples:
+```bash
+morph-spec scaffold dotnet book create-book
+morph-spec scaffold dotnet book get-book-by-id
+morph-spec scaffold dotnet book update-book
+morph-spec scaffold dotnet book delete-book
+morph-spec scaffold dotnet book get-all-books
+```
+
+Generates 7 files: endpoint, handler, request, response, validator + entity, errors (shared at feature level). Entity/errors auto-skipped if they already exist.
+
+**Only use `template render` for individual files when adding to an existing slice.**
+
+## VSA Feature Templates (Vertical Slice Architecture)
+
+For each new feature slice, follow the patterns in these templates:
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| Endpoint | `.morph/framework/templates/code/dotnet/feature/endpoint.cs.hbs` | IApiEndpoint with MapEndpoint() |
+| Handler | `.morph/framework/templates/code/dotnet/feature/handler.cs.hbs` | IHandler<TRequest, TResponse> |
+| Request | `.morph/framework/templates/code/dotnet/feature/request.cs.hbs` | Sealed record DTO |
+| Response | `.morph/framework/templates/code/dotnet/feature/response.cs.hbs` | Sealed record DTO |
+| Validator | `.morph/framework/templates/code/dotnet/feature/validator.cs.hbs` | FluentValidation AbstractValidator |
+| Entity | `.morph/framework/templates/code/dotnet/feature/entity.cs.hbs` | Domain entity |
+| Errors | `.morph/framework/templates/code/dotnet/feature/errors.cs.hbs` | Error factory |
+
+## Base Abstractions (read once per project setup)
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| IHandler | `.morph/framework/templates/code/dotnet/abstractions/handler.cs` | Handler interface |
+| Result<T> | `.morph/framework/templates/code/dotnet/abstractions/result.cs` | Railway-oriented result |
+| Error | `.morph/framework/templates/code/dotnet/abstractions/error.cs` | Error types |
+| IApiEndpoint | `.morph/framework/templates/code/dotnet/abstractions/api-endpoint.cs` | Endpoint interface |
+
+## Extensions & Pipeline (read once per project setup)
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| Handler Registration | `.morph/framework/templates/code/dotnet/extensions/handler-registration.cs` | Scrutor auto-discovery |
+| Map Endpoints | `.morph/framework/templates/code/dotnet/extensions/map-endpoints.cs` | IApiEndpoint discovery |
+| Result Extensions | `.morph/framework/templates/code/dotnet/extensions/result-extensions.cs` | Match() pattern |
+| Database Config | `.morph/framework/templates/code/dotnet/extensions/database-extensions.cs` | EF Core + Npgsql |
+| Health Checks | `.morph/framework/templates/code/dotnet/extensions/health-checks.cs` | Health endpoints |
+| Validation Decorator | `.morph/framework/templates/code/dotnet/pipelines/validation-decorator.cs` | FluentValidation pipeline |
+| Logging Decorator | `.morph/framework/templates/code/dotnet/pipelines/logging-decorator.cs` | Duration tracking |
+| Exception Handler | `.morph/framework/templates/code/dotnet/exceptions/exception-handler.cs` | ProblemDetails |
+| API Tags | `.morph/framework/templates/code/dotnet/constants/api-tags.cs` | Scalar/Swagger groups |
+
+## Specialized Templates
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| Migration | `.morph/framework/templates/code/dotnet/database/migration.cs` | EF Core migration |
+| Hangfire Job | `.morph/framework/templates/code/dotnet/jobs/job.cs` | Background job |
+| MAF Agent | `.morph/framework/templates/code/dotnet/jobs/agent.cs` | MS Agent Framework |
+| Unit Test | `.morph/framework/templates/code/dotnet/test.cs` | xUnit AAA test |
+| Contracts VSA | `.morph/framework/templates/code/dotnet/contracts/contracts-vsa.cs` | Full slice contracts |
+
+## Usage
+
+1. **Read the template** to see the exact pattern
+2. **Generate code following the same structure** (naming, namespaces, imports)
+3. Or render via CLI: `morph-spec template render <id> <output> '<variables>'`

package/framework/rules/frontend-standards.md

@@ -1,13 +1,13 @@
----
-paths:
-  - "**/*.tsx"
-  - "**/*.css"
-  - "**/*.scss"
-stacks:
-  - nextjs
----
-
-# Frontend Standards
-
-@.morph/framework/standards/frontend/design-system/naming.md
-@.morph/framework/standards/frontend/design-system/animations.md
+---
+paths:
+  - "**/*.tsx"
+  - "**/*.css"
+  - "**/*.scss"
+stacks:
+  - nextjs
+---
+
+# Frontend Standards
+
+@.morph/framework/standards/frontend/design-system/naming.md
+@.morph/framework/standards/frontend/design-system/animations.md

package/framework/rules/infrastructure-standards.md

@@ -1,27 +1,27 @@
----
-paths:
-  - "**/Dockerfile*"
-  - "**/docker-compose*"
-  - "**/.github/**"
-  - "**/coolify*"
-stacks:
-  - docker
----
-
-# Infrastructure Standards
-
-@.morph/framework/standards/infrastructure/docker/coolify-deploy.md
-
-## Infrastructure Templates
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| .NET API Dockerfile | `.morph/framework/templates/infrastructure/docker/dockerfile-api.dockerfile` | Multi-stage .NET |
-| Next.js Dockerfile | `.morph/framework/templates/infrastructure/docker/dockerfile-web.dockerfile` | Multi-stage Next.js |
-| Docker Compose | `.morph/framework/templates/infrastructure/docker/docker-compose.template.yml` | Local dev env |
-| Coolify Config | `.morph/framework/templates/infrastructure/docker/coolify.template.json` | Deployment config |
-| .NET Build CI | `.morph/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs` | CI workflow |
-| Docker Push CI | `.morph/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs` | Build & push |
-| Deploy Coolify | `.morph/framework/templates/infrastructure/github/workflows/deploy-coolify.yml.hbs` | CD via SSH |
-
-Read the template and adapt to your project structure.
+---
+paths:
+  - "**/Dockerfile*"
+  - "**/docker-compose*"
+  - "**/.github/**"
+  - "**/coolify*"
+stacks:
+  - docker
+---
+
+# Infrastructure Standards
+
+@.morph/framework/standards/infrastructure/docker/coolify-deploy.md
+
+## Infrastructure Templates
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| .NET API Dockerfile | `.morph/framework/templates/infrastructure/docker/dockerfile-api.dockerfile` | Multi-stage .NET |
+| Next.js Dockerfile | `.morph/framework/templates/infrastructure/docker/dockerfile-web.dockerfile` | Multi-stage Next.js |
+| Docker Compose | `.morph/framework/templates/infrastructure/docker/docker-compose.template.yml` | Local dev env |
+| Coolify Config | `.morph/framework/templates/infrastructure/docker/coolify.template.json` | Deployment config |
+| .NET Build CI | `.morph/framework/templates/infrastructure/github/workflows/dotnet-build.yml.hbs` | CI workflow |
+| Docker Push CI | `.morph/framework/templates/infrastructure/github/workflows/docker-build-push.yml.hbs` | Build & push |
+| Deploy Coolify | `.morph/framework/templates/infrastructure/github/workflows/deploy-coolify.yml.hbs` | CD via SSH |
+
+Read the template and adapt to your project structure.

package/framework/rules/neon-standards.md

@@ -1,25 +1,25 @@
----
-paths:
-  - "**/neon/**"
-  - "**/database/**"
-  - "**/*Migration*.sql"
-  - "**/*migration*.sql"
-stacks:
-  - neon
----
-
-# Neon PostgreSQL Standards
-
-@.morph/framework/standards/infrastructure/neon/neon-setup.md
-@.morph/framework/standards/infrastructure/neon/neon-pgvector.md
-@.morph/framework/standards/infrastructure/neon/neon-pgrag.md
-@.morph/framework/standards/backend/integrations/neon-auth/neon-auth.md
-
-## SQL Templates
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| PostgreSQL Migration | `.morph/framework/templates/code/sql/postgresql-migration.sql` | Database migration |
-| PostgreSQL RLS Policy | `.morph/framework/templates/code/sql/postgresql-rls-policy.sql` | Row-level security |
-
-Read the template and adapt to your project structure.
+---
+paths:
+  - "**/neon/**"
+  - "**/database/**"
+  - "**/*Migration*.sql"
+  - "**/*migration*.sql"
+stacks:
+  - neon
+---
+
+# Neon PostgreSQL Standards
+
+@.morph/framework/standards/infrastructure/neon/neon-setup.md
+@.morph/framework/standards/infrastructure/neon/neon-pgvector.md
+@.morph/framework/standards/infrastructure/neon/neon-pgrag.md
+@.morph/framework/standards/backend/integrations/neon-auth/neon-auth.md
+
+## SQL Templates
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| PostgreSQL Migration | `.morph/framework/templates/code/sql/postgresql-migration.sql` | Database migration |
+| PostgreSQL RLS Policy | `.morph/framework/templates/code/sql/postgresql-rls-policy.sql` | Row-level security |
+
+Read the template and adapt to your project structure.

package/framework/rules/nextjs-standards.md

@@ -1,20 +1,20 @@
----
-paths:
-  - "**/*.tsx"
-  - "**/*.ts"
-stacks:
-  - nextjs
----
-
-# Next.js Standards
-
-@.morph/framework/standards/frontend/nextjs/naming-conventions.md
-@.morph/framework/standards/frontend/nextjs/project-structure.md
-@.morph/framework/standards/frontend/nextjs/app-router.md
-@.morph/framework/standards/frontend/nextjs/components.md
-@.morph/framework/standards/frontend/nextjs/data-fetching.md
-@.morph/framework/standards/frontend/nextjs/forms.md
-@.morph/framework/standards/frontend/nextjs/state-management.md
-@.morph/framework/standards/frontend/nextjs/testing.md
-@.morph/framework/standards/frontend/nextjs/nextjs-patterns.md
-@.morph/framework/standards/frontend/nextjs/motion-patterns.md
+---
+paths:
+  - "**/*.tsx"
+  - "**/*.ts"
+stacks:
+  - nextjs
+---
+
+# Next.js Standards
+
+@.morph/framework/standards/frontend/nextjs/naming-conventions.md
+@.morph/framework/standards/frontend/nextjs/project-structure.md
+@.morph/framework/standards/frontend/nextjs/app-router.md
+@.morph/framework/standards/frontend/nextjs/components.md
+@.morph/framework/standards/frontend/nextjs/data-fetching.md
+@.morph/framework/standards/frontend/nextjs/forms.md
+@.morph/framework/standards/frontend/nextjs/state-management.md
+@.morph/framework/standards/frontend/nextjs/testing.md
+@.morph/framework/standards/frontend/nextjs/nextjs-patterns.md
+@.morph/framework/standards/frontend/nextjs/motion-patterns.md

package/framework/rules/nextjs-templates.md

@@ -1,40 +1,40 @@
----
-paths:
-  - "**/*.tsx"
-  - "**/*.ts"
-stacks:
-  - nextjs
----
-
-# Next.js Code Templates
-
-When implementing Next.js features, use these templates as reference patterns.
-Read the template file to see the exact pattern, then generate code following it.
-
-## Scaffold (preferred for new features)
-
-**Always use scaffold for new feature pages — never create feature files manually.**
-
-```bash
-morph-spec scaffold nextjs <feature> [--dry-run]
-```
-
-Examples:
-```bash
-morph-spec scaffold nextjs book
-morph-spec scaffold nextjs user-profile
-```
-
-Generates 4 files: page (Server Component), list component, form component, TanStack Query hook.
-
-**Only use `template render` for individual files when modifying an existing feature.**
-
-| Template | Path | Purpose |
-|----------|------|---------|
-| Server Page | `.morph/framework/templates/frontend/nextjs/page.tsx.hbs` | App Router server component |
-| Client Component | `.morph/framework/templates/frontend/nextjs/client-component.tsx.hbs` | `'use client'` component |
-| Feature Form | `.morph/framework/templates/frontend/nextjs/feature-form.tsx.hbs` | react-hook-form + Zod + shadcn |
-| Custom Hook | `.morph/framework/templates/frontend/nextjs/use-feature.ts.hbs` | TanStack Query hook |
-| Env Config | `.morph/framework/templates/frontend/nextjs/env.mjs.hbs` | T3 Env validation |
-| TypeScript Config | `.morph/framework/templates/frontend/nextjs/tsconfig.json.hbs` | Path aliases |
-| Dockerfile | `.morph/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs` | Multi-stage build |
+---
+paths:
+  - "**/*.tsx"
+  - "**/*.ts"
+stacks:
+  - nextjs
+---
+
+# Next.js Code Templates
+
+When implementing Next.js features, use these templates as reference patterns.
+Read the template file to see the exact pattern, then generate code following it.
+
+## Scaffold (preferred for new features)
+
+**Always use scaffold for new feature pages — never create feature files manually.**
+
+```bash
+morph-spec scaffold nextjs <feature> [--dry-run]
+```
+
+Examples:
+```bash
+morph-spec scaffold nextjs book
+morph-spec scaffold nextjs user-profile
+```
+
+Generates 4 files: page (Server Component), list component, form component, TanStack Query hook.
+
+**Only use `template render` for individual files when modifying an existing feature.**
+
+| Template | Path | Purpose |
+|----------|------|---------|
+| Server Page | `.morph/framework/templates/frontend/nextjs/page.tsx.hbs` | App Router server component |
+| Client Component | `.morph/framework/templates/frontend/nextjs/client-component.tsx.hbs` | `'use client'` component |
+| Feature Form | `.morph/framework/templates/frontend/nextjs/feature-form.tsx.hbs` | react-hook-form + Zod + shadcn |
+| Custom Hook | `.morph/framework/templates/frontend/nextjs/use-feature.ts.hbs` | TanStack Query hook |
+| Env Config | `.morph/framework/templates/frontend/nextjs/env.mjs.hbs` | T3 Env validation |
+| TypeScript Config | `.morph/framework/templates/frontend/nextjs/tsconfig.json.hbs` | Path aliases |
+| Dockerfile | `.morph/framework/templates/frontend/nextjs/Dockerfile.nextjs.hbs` | Multi-stage build |

package/framework/schemas/feature.schema.json

@@ -78,6 +78,60 @@
         "additionalProperties": false
       }
     },
+    "taskVerifications": {
+      "type": "object",
+      "description": "Deterministic verify results per task, written ONLY by `morph-spec verify` (task scope). updatedAt is server-side; attempts auto-increment. Persisted only from the primary root or the feature's own registered worktree — see verify.js decidePersistence().",
+      "propertyNames": { "pattern": "^T\\d+$" },
+      "additionalProperties": {
+        "type": "object",
+        "required": ["status", "nodes", "attempts", "updatedAt"],
+        "properties": {
+          "status": { "type": "string", "enum": ["pass", "fail"] },
+          "nodes": {
+            "type": "object",
+            "required": ["build", "tests", "validators"],
+            "properties": {
+              "build": { "type": "string", "enum": ["pass", "fail", "skip"] },
+              "tests": { "type": "string", "enum": ["pass", "fail", "skip"] },
+              "validators": { "type": "string", "enum": ["pass", "fail", "skip"] }
+            },
+            "additionalProperties": false
+          },
+          "score": { "type": ["number", "null"], "minimum": 0, "maximum": 10 },
+          "attempts": { "type": "integer", "minimum": 1 },
+          "updatedAt": { "type": "string", "format": "date-time" }
+        },
+        "additionalProperties": false
+      }
+    },
+    "verifications": {
+      "type": "object",
+      "description": "Deterministic verify results at feature scope, written ONLY by `morph-spec verify` (feature scope, no task id).",
+      "properties": {
+        "feature": {
+          "type": "object",
+          "required": ["status", "nodes", "attempts", "updatedAt"],
+          "properties": {
+            "status": { "type": "string", "enum": ["pass", "fail"] },
+            "nodes": {
+              "type": "object",
+              "required": ["build", "tests", "validators"],
+              "properties": {
+                "build": { "type": "string", "enum": ["pass", "fail", "skip"] },
+                "tests": { "type": "string", "enum": ["pass", "fail", "skip"] },
+                "validators": { "type": "string", "enum": ["pass", "fail", "skip"] }
+              },
+              "additionalProperties": false
+            },
+            "score": { "type": ["number", "null"], "minimum": 0, "maximum": 10 },
+            "attempts": { "type": "integer", "minimum": 1 },
+            "updatedAt": { "type": "string", "format": "date-time" }
+          },
+          "additionalProperties": false
+        }
+      },
+      "additionalProperties": false
+    },
     "tasks": {
       "type": "object",
       "description": "Aggregate task counters (informational — the source of truth is 2-plan/tasks.json).",
@@ -101,6 +155,46 @@
         "additionalProperties": true
       }
     },
+    "workType": {
+      "type": "string",
+      "enum": ["feature", "bug", "chore", "hotfix"],
+      "description": "Roteamento por tipo (v8). Ausente = 'feature'. Escrito só por `morph-spec create --type`/`retype` (shape em src/core/work-types.js)."
+    },
+    "workTypeDetection": {
+      "type": "object",
+      "description": "Auditoria de como workType foi resolvido, escrita só por `morph-spec create`. Todos os campos são opcionais.",
+      "properties": {
+        "source": { "type": "string", "enum": ["deterministic", "llm", "user"] },
+        "confidence": { "type": "string", "enum": ["high", "tie", "none"] },
+        "matched": { "type": "object", "description": "Keywords casados por tipo candidato (src/lib/work-type-detector.js)." },
+        "decidedAt": { "type": "string", "format": "date-time" }
+      },
+      "additionalProperties": true
+    },
+    "workTypeHistory": {
+      "type": "array",
+      "description": "Histórico de reclassificações, escrito por `morph-spec retype` (task futura).",
+      "items": {
+        "type": "object",
+        "properties": {
+          "from": { "type": "string" },
+          "to": { "type": "string" },
+          "reason": { "type": "string" },
+          "at": { "type": "string", "format": "date-time" }
+        },
+        "additionalProperties": true
+      }
+    },
+    "worktree": {
+      "type": "object",
+      "description": "Bookkeeping do worktree ativo desta feature no ROOT feature.json, gravado por `morph-spec worktree setup` (via `create --worktree` ou standalone). Removido por `worktree finish`.",
+      "properties": {
+        "path": { "type": "string" },
+        "branch": { "type": "string" },
+        "createdAt": { "type": "string", "format": "date-time" }
+      },
+      "additionalProperties": true
+    },
     "activeAgents": { "type": "array", "items": { "type": "string" } },
     "checkpoints": { "type": "array" },
     "dispatchLog": {
@@ -120,7 +214,7 @@
       "properties": {
         "approved": { "type": "boolean" },
         "timestamp": { "type": ["string", "null"], "description": "ISO timestamp of the approval/revocation, null while never evaluated." },
-        "approvedBy": { "type": ["string", "null"], "description": "\"auto\" (policy gate), \"manual\" (human in the loop), a --approver name, or null while never evaluated." }
+        "approvedBy": { "type": ["string", "null"], "description": "\"auto\" (approve/advance --mode auto), \"manual\" (human in the loop), \"policy:{workType}\" (gate stamped at birth by `morph-spec create` per the work type's skippedGates — see src/core/work-types.js; the gate-guard hook only special-cases \"auto\", so policy-stamped gates stay silent to it), a --approver name, or null while never evaluated." }
       },
       "additionalProperties": true
     }