@polymorphism-tech/morph-spec 4.8.18 → 4.9.0

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

@@ -1,276 +1,276 @@
-# {{FEATURE_NAME}} - Feature Context
-
-> Auto-generated by MORPH-SPEC Framework
-> Last updated: {{TIMESTAMP}}
-
-## Feature Overview
-
-**Name:** {{FEATURE_NAME}}
-**Phase:** {{PHASE}} ({{WORKFLOW_TYPE}})
-**Status:** {{STATUS}}
-**Complexity:** {{COMPLEXITY}}
-
-{{#if DESCRIPTION}}
-{{DESCRIPTION}}
-{{/if}}
-
----
-
-## Progress Tracking
-
-### Current Phase: {{PHASE}}
-
-{{PHASE_DESCRIPTION}}
-
-**Completed Phases:**
-{{#each COMPLETED_PHASES}}
-- ✅ {{name}} - {{completedAt}}
-{{/each}}
-
-**Next Phases:**
-{{#each UPCOMING_PHASES}}
-- ⏭️ {{name}}
-{{/each}}
-
-### Task Progress
-
-**Total Tasks:** {{TASKS_TOTAL}}
-**Completed:** {{TASKS_COMPLETED}} ({{TASKS_PROGRESS}}%)
-**In Progress:** {{TASKS_IN_PROGRESS}}
-**Blocked:** {{TASKS_BLOCKED}}
-
-{{#if CURRENT_TASK}}
-**Current Task:** {{CURRENT_TASK.id}} - {{CURRENT_TASK.title}}
-{{/if}}
-
----
-
-## Active Agents ({{ACTIVE_AGENTS_COUNT}})
-
-### Team Structure
-
-{{#if TEAM_LEAD}}
-**Team Lead:** {{TEAM_LEAD.title}} (`{{TEAM_LEAD.id}}`)
-{{/if}}
-
-{{#each SQUADS}}
-### {{leader.title}} Squad
-**Leader:** `{{leader.id}}`
-**Members ({{members.length}}):**
-{{#each members}}
-- {{title}} (`{{id}}`) {{#if status}}[{{status}}]{{/if}}
-{{/each}}
-{{/each}}
-
-### Validators (Run in Hooks)
-{{#each VALIDATORS}}
-- {{title}} (`{{id}}`)
-{{/each}}
-
----
-
-## Agent Teams
-
-{{#if AGENT_TEAMS_DECISION}}
-{{#if AGENT_TEAMS_DECISION.useAgentTeams}}
-✅ **Agent Teams Recommended**
-
-**Reason:** {{AGENT_TEAMS_DECISION.reason}}
-**Display Mode:** {{AGENT_TEAMS_DECISION.displayMode}}
-**Total Teammates:** {{AGENT_TEAMS_DECISION.totalTeammates}}
-
-**Team Composition:**
-- Team Lead: {{AGENT_TEAMS_DECISION.teamLead}}
-- Domain Leaders: {{AGENT_TEAMS_DECISION.squads}}
-- Validators (hooks): {{AGENT_TEAMS_DECISION.validators}}
-
-{{else}}
-❌ **Single Session Recommended**
-
-**Reason:** {{AGENT_TEAMS_DECISION.reason}}
-**Recommendation:** {{AGENT_TEAMS_DECISION.recommendation}}
-{{/if}}
-{{/if}}
-
----
-
-## Outputs Generated
-
-{{#each OUTPUTS}}
-### {{type}}
-**Status:** {{#if generated}}✅ Generated{{else}}⏳ Pending{{/if}}
-{{#if path}}**Path:** `{{path}}`{{/if}}
-{{#if generatedAt}}**Generated:** {{generatedAt}}{{/if}}
-{{/each}}
-
----
-
-## Decisions Log
-
-{{#each DECISIONS}}
-### ADR-{{id}}: {{title}}
-
-**Status:** {{status}}
-**Date:** {{date}}
-**Decided By:** {{decidedBy}}
-
-**Context:** {{context}}
-
-**Decision:** {{decision}}
-
-{{#if constraints}}
-**Constraints for Validators:**
-```json
-{{constraints}}
-```
-{{/if}}
-
-{{#if alternatives}}
-**Alternatives Considered:**
-{{#each alternatives}}
-- {{name}}: {{rationale}}
-{{/each}}
-{{/if}}
-
----
-{{/each}}
-
-{{#unless DECISIONS}}
-No decisions documented yet. Decisions will be logged in `decisions.md` during Design phase.
-{{/unless}}
-
----
-
-## Validation Status
-
-{{#if VALIDATION_RESULTS}}
-### Latest Validation ({{VALIDATION_TIMESTAMP}})
-
-**Overall:** {{#if VALIDATION_PASSED}}✅ PASSED{{else}}❌ FAILED{{/if}}
-
-{{#each VALIDATION_RESULTS}}
-#### {{validator}}
-**Status:** {{#if passed}}✅ PASSED{{else}}❌ FAILED{{/if}}
-{{#if issues}}
-**Issues ({{issues.length}}):**
-{{#each issues}}
-- [{{severity}}] {{message}} ({{file}}:{{line}})
-{{/each}}
-{{/if}}
-{{/each}}
-
-{{else}}
-No validation runs yet. Validators run automatically via checkpoints.
-{{/if}}
-
----
-
-## Tasks Breakdown
-
-{{#each TASKS}}
-### {{id}}: {{title}}
-
-**Status:** {{status}}
-{{#if priority}}**Priority:** {{priority}}{{/if}}
-{{#if estimatedFiles}}**Estimated Files:** {{estimatedFiles}}{{/if}}
-{{#if dependencies}}**Dependencies:** {{dependencies}}{{/if}}
-
-{{#if description}}
-{{description}}
-{{/if}}
-
-{{#if agent}}**Assigned Agent:** `{{agent}}`{{/if}}
-
-{{#if checkpointAfter}}🔖 **Checkpoint after this task**{{/if}}
-
-{{#if completedAt}}✅ Completed: {{completedAt}}{{/if}}
-{{#if blockedReason}}❌ Blocked: {{blockedReason}}{{/if}}
-
----
-{{/each}}
-
----
-
-## Checkpoints
-
-{{#each CHECKPOINTS}}
-### {{timestamp}}
-**Phase:** {{phase}}
-**Tasks Completed:** {{tasksCompleted}}/{{tasksTotal}}
-
-{{#if note}}
-**Note:** {{note}}
-{{/if}}
-
-{{#if validation}}
-**Validation:** {{validation.passed}}/{{validation.total}} checks passed
-{{#if validation.issues}}
-- Issues: {{validation.issues}}
-{{/if}}
-{{/if}}
-
----
-{{/each}}
-
----
-
-## Related Standards
-
-{{#each RELATED_STANDARDS}}
-### {{name}}
-**Path:** `{{path}}`
-{{#if relevantSections}}
-**Relevant Sections:** {{relevantSections}}
-{{/if}}
-{{/each}}
-
----
-
-## Quick Actions
-
-### Continue Implementation
-```bash
-# Start next task
-morph-spec task next {{FEATURE_NAME}}
-
-# 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}}
-```
-
-### Advance Phase
-```bash
-# Check prerequisites and advance
-morph-spec phase advance {{FEATURE_NAME}}
-
-# Validate current phase before advancing
-morph-spec validate-phase {{FEATURE_NAME}} {{PHASE}}
-```
-
-### Validation
-```bash
-# Run all validators for active agents
-morph-spec validate {{FEATURE_NAME}}
-
-# Run specific validator
-morph-spec validate-{{VALIDATOR}} {{FEATURE_NAME}}
-```
-
----
-
-## File Paths
-
-- **Outputs Directory:** `.morph/features/{{FEATURE_NAME}}/`
-- **Proposal:** `{{PROPOSAL_PATH}}`
-- **Spec:** `{{SPEC_PATH}}`
-- **Contracts:** `{{CONTRACTS_PATH}}`
-- **Tasks:** `{{TASKS_PATH}}`
-- **Decisions:** `{{DECISIONS_PATH}}`
-- **Recap:** `{{RECAP_PATH}}`
-
----
-
-*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
-*Feature ID: {{FEATURE_ID}}*
+# {{FEATURE_NAME}} - Feature Context
+
+> Auto-generated by MORPH-SPEC Framework
+> Last updated: {{TIMESTAMP}}
+
+## Feature Overview
+
+**Name:** {{FEATURE_NAME}}
+**Phase:** {{PHASE}} ({{WORKFLOW_TYPE}})
+**Status:** {{STATUS}}
+**Complexity:** {{COMPLEXITY}}
+
+{{#if DESCRIPTION}}
+{{DESCRIPTION}}
+{{/if}}
+
+---
+
+## Progress Tracking
+
+### Current Phase: {{PHASE}}
+
+{{PHASE_DESCRIPTION}}
+
+**Completed Phases:**
+{{#each COMPLETED_PHASES}}
+- ✅ {{name}} - {{completedAt}}
+{{/each}}
+
+**Next Phases:**
+{{#each UPCOMING_PHASES}}
+- ⏭️ {{name}}
+{{/each}}
+
+### Task Progress
+
+**Total Tasks:** {{TASKS_TOTAL}}
+**Completed:** {{TASKS_COMPLETED}} ({{TASKS_PROGRESS}}%)
+**In Progress:** {{TASKS_IN_PROGRESS}}
+**Blocked:** {{TASKS_BLOCKED}}
+
+{{#if CURRENT_TASK}}
+**Current Task:** {{CURRENT_TASK.id}} - {{CURRENT_TASK.title}}
+{{/if}}
+
+---
+
+## Active Agents ({{ACTIVE_AGENTS_COUNT}})
+
+### Team Structure
+
+{{#if TEAM_LEAD}}
+**Team Lead:** {{TEAM_LEAD.title}} (`{{TEAM_LEAD.id}}`)
+{{/if}}
+
+{{#each SQUADS}}
+### {{leader.title}} Squad
+**Leader:** `{{leader.id}}`
+**Members ({{members.length}}):**
+{{#each members}}
+- {{title}} (`{{id}}`) {{#if status}}[{{status}}]{{/if}}
+{{/each}}
+{{/each}}
+
+### Validators (Run in Hooks)
+{{#each VALIDATORS}}
+- {{title}} (`{{id}}`)
+{{/each}}
+
+---
+
+## Agent Teams
+
+{{#if AGENT_TEAMS_DECISION}}
+{{#if AGENT_TEAMS_DECISION.useAgentTeams}}
+✅ **Agent Teams Recommended**
+
+**Reason:** {{AGENT_TEAMS_DECISION.reason}}
+**Display Mode:** {{AGENT_TEAMS_DECISION.displayMode}}
+**Total Teammates:** {{AGENT_TEAMS_DECISION.totalTeammates}}
+
+**Team Composition:**
+- Team Lead: {{AGENT_TEAMS_DECISION.teamLead}}
+- Domain Leaders: {{AGENT_TEAMS_DECISION.squads}}
+- Validators (hooks): {{AGENT_TEAMS_DECISION.validators}}
+
+{{else}}
+❌ **Single Session Recommended**
+
+**Reason:** {{AGENT_TEAMS_DECISION.reason}}
+**Recommendation:** {{AGENT_TEAMS_DECISION.recommendation}}
+{{/if}}
+{{/if}}
+
+---
+
+## Outputs Generated
+
+{{#each OUTPUTS}}
+### {{type}}
+**Status:** {{#if generated}}✅ Generated{{else}}⏳ Pending{{/if}}
+{{#if path}}**Path:** `{{path}}`{{/if}}
+{{#if generatedAt}}**Generated:** {{generatedAt}}{{/if}}
+{{/each}}
+
+---
+
+## Decisions Log
+
+{{#each DECISIONS}}
+### ADR-{{id}}: {{title}}
+
+**Status:** {{status}}
+**Date:** {{date}}
+**Decided By:** {{decidedBy}}
+
+**Context:** {{context}}
+
+**Decision:** {{decision}}
+
+{{#if constraints}}
+**Constraints for Validators:**
+```json
+{{constraints}}
+```
+{{/if}}
+
+{{#if alternatives}}
+**Alternatives Considered:**
+{{#each alternatives}}
+- {{name}}: {{rationale}}
+{{/each}}
+{{/if}}
+
+---
+{{/each}}
+
+{{#unless DECISIONS}}
+No decisions documented yet. Decisions will be logged in `decisions.md` during Design phase.
+{{/unless}}
+
+---
+
+## Validation Status
+
+{{#if VALIDATION_RESULTS}}
+### Latest Validation ({{VALIDATION_TIMESTAMP}})
+
+**Overall:** {{#if VALIDATION_PASSED}}✅ PASSED{{else}}❌ FAILED{{/if}}
+
+{{#each VALIDATION_RESULTS}}
+#### {{validator}}
+**Status:** {{#if passed}}✅ PASSED{{else}}❌ FAILED{{/if}}
+{{#if issues}}
+**Issues ({{issues.length}}):**
+{{#each issues}}
+- [{{severity}}] {{message}} ({{file}}:{{line}})
+{{/each}}
+{{/if}}
+{{/each}}
+
+{{else}}
+No validation runs yet. Validators run automatically via checkpoints.
+{{/if}}
+
+---
+
+## Tasks Breakdown
+
+{{#each TASKS}}
+### {{id}}: {{title}}
+
+**Status:** {{status}}
+{{#if priority}}**Priority:** {{priority}}{{/if}}
+{{#if estimatedFiles}}**Estimated Files:** {{estimatedFiles}}{{/if}}
+{{#if dependencies}}**Dependencies:** {{dependencies}}{{/if}}
+
+{{#if description}}
+{{description}}
+{{/if}}
+
+{{#if agent}}**Assigned Agent:** `{{agent}}`{{/if}}
+
+{{#if checkpointAfter}}🔖 **Checkpoint after this task**{{/if}}
+
+{{#if completedAt}}✅ Completed: {{completedAt}}{{/if}}
+{{#if blockedReason}}❌ Blocked: {{blockedReason}}{{/if}}
+
+---
+{{/each}}
+
+---
+
+## Checkpoints
+
+{{#each CHECKPOINTS}}
+### {{timestamp}}
+**Phase:** {{phase}}
+**Tasks Completed:** {{tasksCompleted}}/{{tasksTotal}}
+
+{{#if note}}
+**Note:** {{note}}
+{{/if}}
+
+{{#if validation}}
+**Validation:** {{validation.passed}}/{{validation.total}} checks passed
+{{#if validation.issues}}
+- Issues: {{validation.issues}}
+{{/if}}
+{{/if}}
+
+---
+{{/each}}
+
+---
+
+## Related Standards
+
+{{#each RELATED_STANDARDS}}
+### {{name}}
+**Path:** `{{path}}`
+{{#if relevantSections}}
+**Relevant Sections:** {{relevantSections}}
+{{/if}}
+{{/each}}
+
+---
+
+## Quick Actions
+
+### Continue Implementation
+```bash
+# Start next task
+morph-spec task next {{FEATURE_NAME}}
+
+# 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}}
+```
+
+### Advance Phase
+```bash
+# Check prerequisites and advance
+morph-spec phase advance {{FEATURE_NAME}}
+
+# Validate feature outputs
+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}}
+```
+
+---
+
+## File Paths
+
+- **Outputs Directory:** `.morph/features/{{FEATURE_NAME}}/`
+- **Proposal:** `{{PROPOSAL_PATH}}`
+- **Spec:** `{{SPEC_PATH}}`
+- **Contracts:** `{{CONTRACTS_PATH}}`
+- **Tasks:** `{{TASKS_PATH}}`
+- **Decisions:** `{{DECISIONS_PATH}}`
+- **Recap:** `{{RECAP_PATH}}`
+
+---
+
+*Generated by MORPH-SPEC Framework v{{MORPH_VERSION}}*
+*Feature ID: {{FEATURE_ID}}*

package/framework/templates/docs/onboarding.md

@@ -71,12 +71,8 @@ morph-spec task next <feature>
 morph-spec task start <feature> <task-id>
 morph-spec task done <feature> <task-id>
 
-# Save/restore checkpoints
+# Save a checkpoint
 morph-spec checkpoint-save <feature>
-morph-spec checkpoint-list <feature>
-
-# View changes since last snapshot
-morph-spec diff <feature>
 
 # Health check
 morph-spec doctor

package/framework/workflows/configs/nodejs-cli.json

@@ -0,0 +1,40 @@
+{
+  "id": "nodejs-cli",
+  "name": "Node.js CLI Development",
+  "description": "Workflow otimizado para desenvolvimento de features em projetos CLI Node.js/ESM, como o morph-spec-framework.",
+  "criteria": {
+    "maxFiles": 15,
+    "maxLines": 400,
+    "maxComponents": 0,
+    "noInfrastructure": true,
+    "noArchitecturalDecisions": false
+  },
+  "keywords": [
+    "nodejs", "javascript", "esm", "cli", "commander", "command", "morph-spec",
+    "hook", "validator", "plugin", "script"
+  ],
+  "phases": {
+    "run": ["proposal", "setup", "design", "tasks", "implement"],
+    "skip": ["uiux", "clarify", "sync"],
+    "combined": {}
+  },
+  "pausePoints": [
+    {
+      "phase": "design",
+      "question": "O design da feature está correto? Approve para gerar tasks."
+    },
+    {
+      "phase": "tasks",
+      "question": "As tasks estão bem definidas? Approve para iniciar implementação."
+    }
+  ],
+  "outputs": {
+    "required": ["proposal", "spec", "tasks"],
+    "optional": ["contracts", "decisions", "recap"]
+  },
+  "agentPreferences": {
+    "specialists": ["morph-spec-architect", "nodejs-cli-expert"],
+    "validators": ["morph-spec-validator"]
+  },
+  "priority": 5
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "4.8.18",
+  "version": "4.9.0",
   "description": "MORPH-SPEC: AI-First development framework with validation pipeline and multi-stack support",
   "keywords": [
     "claude-code",
@@ -52,18 +52,14 @@
     "postinstall": "node src/scripts/global-install.js"
   },
   "dependencies": {
-    "ajv": "^8.12.0",
-    "ajv-formats": "^3.0.1",
     "chalk": "^5.3.0",
     "commander": "^12.0.0",
-    "diff": "^5.2.0",
     "fs-extra": "^11.2.0",
     "glob": "^10.3.0",
     "handlebars": "^4.7.8",
     "inquirer": "^9.2.0",
     "minimatch": "^9.0.5",
-    "ora": "^8.0.0",
-    "yaml": "^2.3.4"
+    "ora": "^8.0.0"
   },
   "repository": {
     "type": "git",