@polymorphism-tech/morph-spec 7.4.0 → 7.5.0

package/framework/skills/core/morph-proposal/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a fase de proposta+plano de uma feature morph-spec. Encad
 version: core
 when-to-invoke: ao receber instrução "use /morph-proposal" do usuário, ou ao iniciar uma nova feature
 user-invokable: true
-cliVersion: "7.4.0"
+cliVersion: "7.5.0"
 ---
 
 # morph-proposal
@@ -17,7 +17,7 @@ Conduzir uma feature do request inicial até o plano aprovado (Gate 2), sem inte
 
 - Usuário pede "use /morph-proposal {feature}" ou "vamos planejar {feature}".
 - Início de qualquer feature nova num projeto morph-spec.
-- Em sessões retomadas, antes de continuar uma feature em progresso, verificar via `.morph/state.json` se a feature já passou pelos Gates.
+- Em sessões retomadas, antes de continuar uma feature em progresso, verificar via `.morph/features/{feature-name}/feature.json` (estado autoritativo da feature) se ela já passou pelos Gates.
 
 ## Argumentos
 
@@ -82,11 +82,12 @@ Escopo: {incluído} | Excluído: {exclusões}
 Stack: {compliance}
 ```
 
-O hook `state-sync.js` registra a aprovação automaticamente via PostToolUse em AskUserQuestion. Quando auto-aprovado, marcar manualmente:
+No caminho manual, o hook `state-sync.js` registra a aprovação automaticamente via PostToolUse quando a `AskUserQuestion` é respondida com "aprovado" (grava o gate no `feature.json` autoritativo, `approvedBy: "manual"`). Em `trust: auto` (sem AskUserQuestion), **aprove via CLI — nunca via Edit à mão de state.json**:
 
-```js
-// auto-aprovação: o hook detecta "aprovado" no answer label, mas em auto-mode
-// não há AskUserQuestion. Skill atualiza .morph/state.json via Edit fallback.
+```
+morph-spec approve {feature} proposal --mode auto
+# ou, para já aprovar o Gate 1 e criar a pasta 2-plan/ num passo só:
+morph-spec advance {feature}
 ```
 
 ### 4. Verificar retomada antes de morph-plan
@@ -128,7 +129,7 @@ Lógica idêntica ao passo 3 (`shouldPauseGate` + AskUserQuestion ou auto-aprova
 - `.morph/features/{feature}/2-plan/spec.md`
 - `.morph/features/{feature}/2-plan/mandate.md`
 - `.morph/features/{feature}/2-plan/tasks.json`
-- Gates 1 e 2 marcados aprovados em `.morph/state.json` (via hook state-sync).
+- Gates 1 e 2 registrados aprovados em `.morph/features/{feature}/feature.json` (autoritativo) — via `morph-spec approve`/`morph-spec advance` em auto, ou via hook state-sync no caminho manual.
 
 ## Referências
 

package/framework/skills/core/morph-review/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a fase de revisão e produz o review-report.md para o Gate 3
 version: core
 when-to-invoke: ao iniciar a fase review, após todas as tasks de tasks.json estarem com status `done`
 user-invokable: true
-cliVersion: "7.4.0"
+cliVersion: "7.5.0"
 ---
 
 # morph-review
@@ -88,12 +88,12 @@ e o `recap.md` estar atualizado. Normalmente invocada pela skill orquestradora `
    **Recomendação:** Aprovado
    ```
 
-   O hook state-sync detecta a aprovação em answers de AskUserQuestion e marca `features[X].approvalGates.review = true`. Em auto sem AskUserQuestion, a skill atualiza state.json direto.
+   No caminho manual, o hook state-sync detecta a aprovação em answers de AskUserQuestion e grava `approvalGates.review = { approved: true, timestamp, approvedBy: "manual" }` no `feature.json` autoritativo da feature. Em auto sem AskUserQuestion, aprove via `morph-spec approve {feature} review --mode auto` — nunca via Edit à mão de state.json.
 
 ## Output esperado
 - `.morph/features/{feature}/4-review/review-report.md` com scores e recomendação
 - Trace da fase com `phase_summary` preenchido
-- Gate 3 marcado aprovado em state.json (auto ou manual)
+- Gate 3 registrado aprovado em `.morph/features/{feature}/feature.json` (autoritativo), na forma canônica `{ approved, timestamp, approvedBy }` — via `morph-spec approve` em auto, ou pelo hook state-sync no caminho manual
 
 ## Referências
 - `.morph/framework/MORPH.md` — seção 5 (Gate 3), seção 1 (papel Evaluator), Trust Mode

package/framework/skills/core/morph-stack-scan/SKILL.md

@@ -4,7 +4,7 @@ description: Varre o codebase existente, detecta stack atual, compara com o stac
 version: core
 when-to-invoke: ao iniciar uma feature em projeto brownfield (codebase já existente)
 user-invokable: true
-cliVersion: "7.4.0"
+cliVersion: "7.5.0"
 ---
 
 # morph-stack-scan

package/framework/skills/core/morph-standards/SKILL.md

@@ -4,7 +4,7 @@ description: Localiza e carrega um standard específico do STANDARDS.json sob de
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "7.4.0"
+cliVersion: "7.5.0"
 ---
 
 # morph-standards

package/framework/templates/REGISTRY.json

@@ -193,7 +193,6 @@
         "COMPLEXITY",
         "CONTRACTS_PATH",
         "CURRENT_TASK",
-        "CURRENT_TASK_ID",
         "DECISIONS_PATH",
         "DESCRIPTION",
         "FEATURE_ID",
@@ -213,8 +212,7 @@
         "TASKS_TOTAL",
         "TEAM_LEAD",
         "TIMESTAMP",
-        "VALIDATION_TIMESTAMP",
-        "VALIDATOR"
+        "VALIDATION_TIMESTAMP"
       ],
       "stackSpecific": false,
       "engine": "handlebars",

package/framework/templates/context/CONTEXT-FEATURE.md

@@ -229,21 +229,17 @@ No validation runs yet. Validators run automatically via checkpoints.
 ## Quick Actions
 
 ### Continue Implementation
-```bash
-# Start a task (dispatch gate + state tracking)
-morph-spec task start {{FEATURE_NAME}} <task-id>
-
-# Complete current task (runs validators)
-morph-spec task done {{FEATURE_NAME}} {{CURRENT_TASK_ID}}
-
-# Generate recap after task completion
-morph-spec generate recap {{FEATURE_NAME}}
-```
+During the implement phase, track your work with the native `TaskCreate`/`TaskUpdate`
+tools. Persist progress by writing `tasks.json` (`2-plan/tasks.json`), touching ONLY
+the mutable fields `status`, `outputs`, and `notes` — via the `Write` tool or an `Edit`
+that touches only those fields. The plan contract (`title`, `description`,
+`dependencies`, `effort`, `doneCriteria`, `group`) is frozen after Gate 2. The recap is
+written by the implement skill; state syncs automatically via the `state-sync` hook.
 
 ### Advance Phase
 ```bash
-# Check prerequisites and advance
-morph-spec phase advance {{FEATURE_NAME}}
+# Approve the current gate and scaffold the next phase folder in one step
+morph-spec advance {{FEATURE_NAME}}
 
 # Validate feature outputs
 morph-spec validate-feature {{FEATURE_NAME}}
@@ -251,11 +247,8 @@ morph-spec validate-feature {{FEATURE_NAME}}
 
 ### Validation
 ```bash
-# Run all validators for active agents
-morph-spec validate {{FEATURE_NAME}}
-
-# Run specific validator
-morph-spec validate-{{VALIDATOR}} {{FEATURE_NAME}}
+# Validate this feature's outputs against active standards
+morph-spec validate-feature {{FEATURE_NAME}}
 ```
 
 ---

package/framework/templates/context/CONTEXT.md

@@ -1,180 +1,181 @@
-# {{PROJECT_NAME}} - Project Context
-
-> Auto-generated by MORPH-SPEC Framework
-> Last updated: {{TIMESTAMP}}
-
-## Project Overview
-
-**Name:** {{PROJECT_NAME}}
-**Type:** {{PROJECT_TYPE}}
-**Repository:** {{REPOSITORY_URL}}
-
-{{PROJECT_DESCRIPTION}}
-
----
-
-## Technology Stack
-
-### Frontend
-{{#if NEXTJS_ENABLED}}- **Next.js** {{NEXTJS_VERSION}}{{/if}}
-{{#if UI_LIBRARY}}- **UI Library:** {{UI_LIBRARY}}{{/if}}
-
-### Backend
-- **.NET** {{DOTNET_VERSION}}
-{{#if EF_VERSION}}- **Entity Framework Core** {{EF_VERSION}}{{/if}}
-{{#if DAPPER_ENABLED}}- **Dapper** (Micro-ORM){{/if}}
-{{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
-{{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
-
-### Database
-{{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
-{{#if NEON_ENABLED}}- **Neon** (PostgreSQL + Connection Pooling)
-  - Project: {{NEON_PROJECT_ID}}
-  - Region: {{NEON_REGION}}
-{{/if}}
-
-### Infrastructure
-{{#if AZURE_ENABLED}}- **Azure** ({{AZURE_LOCATION}})
-{{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
-{{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
-{{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/if}}
-{{/if}}
-
-{{#if EASYPANEL_ENABLED}}- **EasyPanel** (Docker Deployment)
-  - API: {{EASYPANEL_API_URL}}
-  - Web: {{EASYPANEL_WEB_URL}}
-{{/if}}
-
----
-
-## Active Features
-
-{{#each ACTIVE_FEATURES}}
-### {{name}} ({{phase}})
-**Status:** {{status}}
-**Complexity:** {{complexity}}
-**Active Agents:** {{activeAgents}}
-
-{{#if description}}{{description}}{{/if}}
-
-**Progress:**
-- Tasks: {{tasks.completed}}/{{tasks.total}}
-- Outputs: {{outputs}}
-
-{{/each}}
-
----
-
-## Project Standards
-
-### Coding Standards
-{{#each PROJECT_STANDARDS}}
-- [{{name}}]({{path}}){{#if description}} - {{description}}{{/if}}
-{{/each}}
-
-### Inferred Patterns
-{{#if INFERRED_STANDARDS}}
-{{INFERRED_STANDARDS}}
-{{/if}}
-
----
-
-## Active Agents ({{AGENT_COUNT}})
-
-### Tier 1: Orchestrators
-{{#each TIER_1_AGENTS}}
-- **{{title}}** (`{{id}}`) {{#if always_active}}[Always Active]{{/if}}
-{{/each}}
-
-### Tier 2: Domain Leaders
-{{#each TIER_2_AGENTS}}
-- **{{title}}** (`{{id}}`) - {{domains}}
-{{/each}}
-
-### Tier 3: Specialists
-{{#each TIER_3_AGENTS}}
-- **{{title}}** (`{{id}}`) - Reports to `{{reports_to}}`
-{{/each}}
-
----
-
-## Agent Teams Status
-
-{{#if AGENT_TEAMS_ENABLED}}
-✅ **Enabled** (Display Mode: {{AGENT_TEAMS_DISPLAY_MODE}})
-
-**Spawn Thresholds:**
-- Complexity: {{AGENT_TEAMS_THRESHOLDS.complexity}}
-- Estimated Files: ≥ {{AGENT_TEAMS_THRESHOLDS.estimatedFiles}}
-- Active Agents: ≥ {{AGENT_TEAMS_THRESHOLDS.activeAgents}}
-- Multi-Domain: {{AGENT_TEAMS_THRESHOLDS.multiDomain}}
-
-{{else}}
-❌ **Disabled** - Use single session with subagents
-{{/if}}
-
----
-
-## Recent Checkpoints
-
-{{#each RECENT_CHECKPOINTS}}
-### {{timestamp}}
-**Feature:** {{feature}}
-**Phase:** {{phase}}
-**Note:** {{note}}
-
-{{#if validation}}
-**Validation:** {{validation.passed}}/{{validation.total}} checks passed
-{{/if}}
-
-{{/each}}
-
----
-
-{{#if DEVOPS_ENABLED}}
-## DevOps Integration
-
-**Organization:** {{DEVOPS_ORG}}
-**Project:** {{DEVOPS_PROJECT}}
-
-- **Boards:** {{#if DEVOPS_BOARDS_ENABLED}}Enabled ({{DEVOPS_AREA_PATH}}){{else}}Disabled{{/if}}
-- **Wiki:** {{#if DEVOPS_WIKI_ENABLED}}Enabled ({{DEVOPS_WIKI_NAME}}){{else}}Disabled{{/if}}
-- **Pipelines:** CI: {{DEVOPS_BUILD_PIPELINE}}, CD: {{DEVOPS_RELEASE_PIPELINE}}
-
----
-
-{{/if}}
-
-## Quick Reference
-
-### Workflow Commands
-```bash
-# Detect agents for feature
-morph-spec detect-agents "{feature description}"
-
-# Initialize new feature
-morph-spec state init
-
-# Update design system (run morph-phase-uiux skill or edit manually)
-# .morph/context/design-system.md
-
-# Advance to next phase
-morph-spec phase advance {feature}
-
-# Mark task complete (runs validators)
-morph-spec task done {feature} {task-id}
-
-# Generate recap
-morph-spec generate recap {feature}
-```
-
-### Key Paths
-- **Outputs:** `.morph/features/{feature}/`
-- **Standards:** `.morph/context/` (project overrides)
-- **Config:** `.morph/config/config.json`
-- **State:** `.morph/state.json`
-- **Templates:** `.morph/framework/templates/`
-
----
-
-*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
+# {{PROJECT_NAME}} - Project Context
+
+> Auto-generated by MORPH-SPEC Framework
+> Last updated: {{TIMESTAMP}}
+
+## Project Overview
+
+**Name:** {{PROJECT_NAME}}
+**Type:** {{PROJECT_TYPE}}
+**Repository:** {{REPOSITORY_URL}}
+
+{{PROJECT_DESCRIPTION}}
+
+---
+
+## Technology Stack
+
+### Frontend
+{{#if NEXTJS_ENABLED}}- **Next.js** {{NEXTJS_VERSION}}{{/if}}
+{{#if UI_LIBRARY}}- **UI Library:** {{UI_LIBRARY}}{{/if}}
+
+### Backend
+- **.NET** {{DOTNET_VERSION}}
+{{#if EF_VERSION}}- **Entity Framework Core** {{EF_VERSION}}{{/if}}
+{{#if DAPPER_ENABLED}}- **Dapper** (Micro-ORM){{/if}}
+{{#if HANGFIRE_ENABLED}}- **Hangfire** (Background Jobs){{/if}}
+{{#if AGENT_FRAMEWORK_ENABLED}}- **Microsoft Agent Framework** (AI Agents){{/if}}
+
+### Database
+{{#if SQL_ENABLED}}- **Azure SQL** ({{SQL_SERVER}}/{{SQL_DATABASE}}){{/if}}
+{{#if NEON_ENABLED}}- **Neon** (PostgreSQL + Connection Pooling)
+  - Project: {{NEON_PROJECT_ID}}
+  - Region: {{NEON_REGION}}
+{{/if}}
+
+### Infrastructure
+{{#if AZURE_ENABLED}}- **Azure** ({{AZURE_LOCATION}})
+{{#if CONTAINER_APPS_ENABLED}}- **Container Apps** ({{CONTAINER_ENV}}){{/if}}
+{{#if OPENAI_ENABLED}}- **Azure OpenAI** ({{OPENAI_MODEL}}){{/if}}
+{{#if MONITORING_ENABLED}}- **Application Insights** ({{APP_INSIGHTS}}){{/if}}
+{{/if}}
+
+{{#if EASYPANEL_ENABLED}}- **EasyPanel** (Docker Deployment)
+  - API: {{EASYPANEL_API_URL}}
+  - Web: {{EASYPANEL_WEB_URL}}
+{{/if}}
+
+---
+
+## Active Features
+
+{{#each ACTIVE_FEATURES}}
+### {{name}} ({{phase}})
+**Status:** {{status}}
+**Complexity:** {{complexity}}
+**Active Agents:** {{activeAgents}}
+
+{{#if description}}{{description}}{{/if}}
+
+**Progress:**
+- Tasks: {{tasks.completed}}/{{tasks.total}}
+- Outputs: {{outputs}}
+
+{{/each}}
+
+---
+
+## Project Standards
+
+### Coding Standards
+{{#each PROJECT_STANDARDS}}
+- [{{name}}]({{path}}){{#if description}} - {{description}}{{/if}}
+{{/each}}
+
+### Inferred Patterns
+{{#if INFERRED_STANDARDS}}
+{{INFERRED_STANDARDS}}
+{{/if}}
+
+---
+
+## Active Agents ({{AGENT_COUNT}})
+
+### Tier 1: Orchestrators
+{{#each TIER_1_AGENTS}}
+- **{{title}}** (`{{id}}`) {{#if always_active}}[Always Active]{{/if}}
+{{/each}}
+
+### Tier 2: Domain Leaders
+{{#each TIER_2_AGENTS}}
+- **{{title}}** (`{{id}}`) - {{domains}}
+{{/each}}
+
+### Tier 3: Specialists
+{{#each TIER_3_AGENTS}}
+- **{{title}}** (`{{id}}`) - Reports to `{{reports_to}}`
+{{/each}}
+
+---
+
+## Agent Teams Status
+
+{{#if AGENT_TEAMS_ENABLED}}
+✅ **Enabled** (Display Mode: {{AGENT_TEAMS_DISPLAY_MODE}})
+
+**Spawn Thresholds:**
+- Complexity: {{AGENT_TEAMS_THRESHOLDS.complexity}}
+- Estimated Files: ≥ {{AGENT_TEAMS_THRESHOLDS.estimatedFiles}}
+- Active Agents: ≥ {{AGENT_TEAMS_THRESHOLDS.activeAgents}}
+- Multi-Domain: {{AGENT_TEAMS_THRESHOLDS.multiDomain}}
+
+{{else}}
+❌ **Disabled** - Use single session with subagents
+{{/if}}
+
+---
+
+## Recent Checkpoints
+
+{{#each RECENT_CHECKPOINTS}}
+### {{timestamp}}
+**Feature:** {{feature}}
+**Phase:** {{phase}}
+**Note:** {{note}}
+
+{{#if validation}}
+**Validation:** {{validation.passed}}/{{validation.total}} checks passed
+{{/if}}
+
+{{/each}}
+
+---
+
+{{#if DEVOPS_ENABLED}}
+## DevOps Integration
+
+**Organization:** {{DEVOPS_ORG}}
+**Project:** {{DEVOPS_PROJECT}}
+
+- **Boards:** {{#if DEVOPS_BOARDS_ENABLED}}Enabled ({{DEVOPS_AREA_PATH}}){{else}}Disabled{{/if}}
+- **Wiki:** {{#if DEVOPS_WIKI_ENABLED}}Enabled ({{DEVOPS_WIKI_NAME}}){{else}}Disabled{{/if}}
+- **Pipelines:** CI: {{DEVOPS_BUILD_PIPELINE}}, CD: {{DEVOPS_RELEASE_PIPELINE}}
+
+---
+
+{{/if}}
+
+## Quick Reference
+
+### Workflow Commands
+```bash
+# Check feature status and pending gates
+morph-spec status {feature}
+morph-spec approval-status {feature}
+
+# Approve the current gate and scaffold the next phase folder in one step
+morph-spec advance {feature}
+
+# Validate feature outputs
+morph-spec validate-feature {feature}
+
+# Archive a finished feature (after Gate 3)
+morph-spec archive {feature}
+```
+
+> Feature work starts by asking Claude Code to implement something — the proposal
+> phase is created for you. During the implement phase, task progress is tracked
+> with the native `TaskCreate`/`TaskUpdate` tools and persisted by writing
+> `tasks.json` (only `status`, `outputs`, `notes`); the recap is written by the
+> implement skill. State syncs automatically via the `state-sync` hook.
+
+### Key Paths
+- **Outputs:** `.morph/features/{feature}/`
+- **Standards:** `.morph/context/` (project overrides)
+- **Config:** `.morph/config/config.json`
+- **State:** `.morph/state.json`
+- **Templates:** `.morph/framework/templates/`
+
+---
+
+*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*