@polymorphism-tech/morph-spec 4.8.18 → 4.9.0

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,

package/src/commands/project/doctor.js

@@ -67,20 +67,6 @@ function getNpmGlobalPrefix() {
 
 // lib files
 const REQUIRED_LIB_FILES = [
-  'src/lib/analytics/analytics-engine.js',
-  'src/lib/tracking/artifact-trail.js',
-  'src/lib/context/context-bundler.js',
-  'src/lib/context/context-optimizer.js',
-  'src/lib/context/context-tracker.js',
-  'src/lib/context/core-four-tracker.js',
-  'src/lib/execution/fusion-executor.js',
-  'src/lib/hops/hop-composer.js',
-  'src/lib/context/mcp-optimizer.js',
-  'src/lib/agents/micro-agent-factory.js',
-  'src/lib/execution/parallel-executor.js',
-  'src/lib/hooks/stop-hook-executor.js',  // Legacy — retained for backward compat
-  'src/lib/threads/thread-coordinator.js',
-  'src/lib/threads/thread-manager.js',
   'src/lib/trust/trust-manager.js'
 ];
 
@@ -90,7 +76,6 @@ const REQUIRED_COMMAND_FILES = [
   'src/commands/project/update.js',
   'src/commands/project/doctor.js',
   'src/commands/project/status.js',
-  'src/commands/project/tutorial.js',
   'src/commands/state/state.js',
   'src/commands/state/advance-phase.js',
   'src/commands/state/approve.js',
@@ -99,23 +84,7 @@ const REQUIRED_COMMAND_FILES = [
   'src/commands/validation/validate-feature.js',
   'src/commands/templates/template-render.js',
   'src/commands/agents/dispatch-agents.js',
-  'src/commands/templates/generate-contracts.js'
-];
-
-// HOP templates (meta-prompts)
-const HOP_TEMPLATES = [
-  'framework/templates/meta-prompts/squad-leaders/backend-squad.md',
-  'framework/templates/meta-prompts/squad-leaders/frontend-squad.md',
-  'framework/templates/meta-prompts/parallel-workers/parallel-worker.md',
-  'framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md',
-  'framework/templates/meta-prompts/hops/hop-wrapper.md',
-  'framework/templates/meta-prompts/hops/hop-retry.md',
-  'framework/templates/meta-prompts/hops/hop-validation.md',
-  'framework/templates/meta-prompts/validators/checkpoint-validator.md',
-  'framework/templates/meta-prompts/validators/pre-commit-validator.md',
-  'framework/templates/meta-prompts/fusion/fusion-agent.md',
-  'framework/templates/meta-prompts/fusion/fusion-aggregator.md',
-  'framework/templates/REGISTRY.json'
+  'src/commands/project/worktree.js'
 ];
 
 // framework standards
@@ -195,17 +164,7 @@ async function doctorFullCommand(frameworkRoot) {
     missingCmds.length === 0, false,
     missingCmds.length > 0 ? `missing: ${missingCmds.join(', ')}` : '');
 
-  // ── 3. HOP Templates ────────────────────────────────────────────────────
-  console.log(chalk.cyan(`\n  framework/templates/meta-prompts/ — HOP Templates (${HOP_TEMPLATES.length})`));
-  const missingHOPs = [];
-  for (const f of HOP_TEMPLATES) {
-    if (!(await pathExists(join(frameworkRoot, f)))) missingHOPs.push(f.split('/').pop());
-  }
-  check(`HOP Templates (${HOP_TEMPLATES.length - missingHOPs.length}/${HOP_TEMPLATES.length})`,
-    missingHOPs.length === 0, false,
-    missingHOPs.length > 0 ? `missing: ${missingHOPs.join(', ')}` : '');
-
-  // ── 4. Framework Standards ───────────────────────────────────────────────
+  // ── 3. Framework Standards ───────────────────────────────────────────────
   console.log(chalk.cyan(`\n  framework/standards/ — Framework Standards (${FRAMEWORK_STANDARDS.length} files)`));
   const missingStds = [];
   for (const f of FRAMEWORK_STANDARDS) {
@@ -233,10 +192,10 @@ async function doctorFullCommand(frameworkRoot) {
     check('agents.json', false, false, 'file not found');
   }
 
-  // ── 7. Zero-Touch Workflow Config ───────────────────────────────────────
-  console.log(chalk.cyan('\n  framework/workflows/ — Zero-Touch Config'));
-  const ztPath = join(frameworkRoot, 'framework/workflows/configs/zero-touch.json');
-  check('zero-touch.json workflow config', await pathExists(ztPath));
+  // ── 7. Workflow Configs ──────────────────────────────────────────────────
+  console.log(chalk.cyan('\n  framework/workflows/ — Workflow Configs'));
+  const stdPath = join(frameworkRoot, 'framework/workflows/configs/standard.json');
+  check('standard.json workflow config', await pathExists(stdPath));
 
   // ── 8. state.json schema version ────────────────────────────────────────
   console.log(chalk.cyan('\n  .morph/state.json — Schema Version'));
@@ -454,6 +413,16 @@ export async function doctorCommand(options = {}) {
   let hasErrors = false;
   let hasWarnings = false;
 
+  const check = (name, passed, warnOnly = false, msg = '') => {
+    if (passed) {
+      checks.push({ name, status: 'ok' });
+    } else {
+      checks.push({ name, status: warnOnly ? 'warn' : 'missing', msg });
+      if (warnOnly) hasWarnings = true;
+      else hasErrors = true;
+    }
+  };
+
   // Check versions first
   const cliCheck = await checkCLIOutdated();
   const projectCheck = await checkProjectOutdated(targetPath);

package/src/commands/project/init.js

@@ -385,7 +385,7 @@ export async function initCommand(options) {
     // Suggest tutorial for first-time users
     if (integrationsCreated) {
       logger.blank();
-      logger.info('First time using morph-spec? Run `morph-spec tutorial` to get started.');
+      logger.info('First time using morph-spec? Run `/morph-proposal <feature>` to start a new feature.');
     }
 
     logger.blank();

package/src/commands/project/status.js

@@ -14,7 +14,7 @@
 
 import chalk from 'chalk';
 import { loadState, getFeature, derivePhase, deriveOutputs } from '../../core/state/state-manager.js';
-import { PHASES } from '../state/validate-phase.js';
+import { PHASES } from '../../lib/phase-chain/phase-validator.js';
 
 /**
  * Phase symbols for visual representation
@@ -243,7 +243,7 @@ export async function statusCommand(featureName, options = {}) {
     process.exit(1);
   }
 
-  // Derive phase and outputs from filesystem if not stored in state (v5.0.0+)
+  // Derive phase and outputs from filesystem if not stored in state
   const { join } = await import('path');
   const featurePath = join(process.cwd(), '.morph', 'features', featureName);
   if (!feature.phase) {