@polymorphism-tech/morph-spec 4.8.19 → 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "4.8.19",
+  "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",

package/src/commands/agents/dispatch-agents.js

@@ -28,6 +28,9 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 /** Path to agents.json in the installed package */
 const AGENTS_JSON_PATH = join(__dirname, '../../../framework/agents.json');
 
+/** Path to phases.json in the installed package */
+const PHASES_JSON_PATH = join(__dirname, '../../../framework/phases.json');
+
 /** Phases where agent dispatch is meaningful */
 const DISPATCHABLE_PHASES = ['design', 'tasks', 'implement'];
 
@@ -87,6 +90,40 @@ const TASK_CATEGORY_TO_GROUP = {
   'docs': 'docs',
 };
 
+// ─────────────────────────────────────────────────────────────────────────────
+// Required Skills Injection
+// ─────────────────────────────────────────────────────────────────────────────
+
+/**
+ * Build a mandatory skills block for the given phase.
+ * Reads requiredSkills from phases.json data and formats them as instructions for subagents.
+ * Returns null if no required skills for this phase.
+ *
+ * @param {string} phase - Phase id (e.g. 'implement')
+ * @param {Object|null} phasesData - Parsed phases.json content
+ * @returns {string|null}
+ */
+export function buildSkillsBlock(phase, phasesData) {
+  try {
+    const skills = phasesData?.phases?.[phase]?.requiredSkills;
+    if (!skills || skills.length === 0) return null;
+
+    const triggerLabel = trigger =>
+      trigger.replace(/([A-Z])/g, ' $1').toUpperCase().trim();
+
+    const lines = skills.map(s => `- ${triggerLabel(s.trigger)}: Invoke Skill(${s.skill})`);
+
+    return [
+      'Mandatory Skills (non-negotiable — invoke at the specified trigger points):',
+      ...lines,
+      '',
+      'Do NOT skip these skills. They are required by MORPH-SPEC for this phase.',
+    ].join('\n');
+  } catch {
+    return null;
+  }
+}
+
 // ─────────────────────────────────────────────────────────────────────────────
 // Helpers
 // ─────────────────────────────────────────────────────────────────────────────
@@ -248,6 +285,17 @@ export async function buildDispatchConfig(projectPath, featureName, phase, opts
   const agentsData = JSON.parse(readFileSync(agentsPath, 'utf8'));
   const allAgents = agentsData.agents || {};
 
+  // Load phases.json for required skills injection (opts.phasesJsonPath allows override for testing)
+  const phasesPath = opts.phasesJsonPath || PHASES_JSON_PATH;
+  let phasesData = null;
+  try {
+    if (existsSync(phasesPath)) {
+      phasesData = JSON.parse(readFileSync(phasesPath, 'utf8'));
+    }
+  } catch {
+    // Non-blocking — fail silent, skills block will be omitted
+  }
+
   // Active agents from state (keyword-detected during setup phase)
   const activeAgentIds = new Set(feature.activeAgents || []);
 
@@ -296,11 +344,14 @@ export async function buildDispatchConfig(projectPath, featureName, phase, opts
       rawPrompt = agentData.teammate.spawn_prompt;
     }
 
-    // Append standards digest as Constraints block
+    // Append standards digest as Constraints block, then required skills block
     const briefing = buildAgentBriefing(agentId, phase);
-    const fullTaskPrompt = briefing
-      ? `${rawPrompt}\n\nConstraints:\n${briefing}`
-      : rawPrompt;
+    const skillsBlock = buildSkillsBlock(phase, phasesData);
+    const fullTaskPrompt = [
+      rawPrompt,
+      briefing    ? `\n\nConstraints:\n${briefing}` : '',
+      skillsBlock ? `\n\n${skillsBlock}`            : '',
+    ].join('');
 
     dispatchableAgents.push({
       id: agentId,