@polymorphism-tech/morph-spec 4.10.4 → 4.10.6

package/src/commands/project/update.js

@@ -29,6 +29,7 @@ import { installClaudeHooks, installGlobalStatusline, installVSCodeTerminalSetti
 import { installSkills } from '../../utils/skills-installer.js';
 import { installAgents, installDomainAgents } from '../../utils/agents-installer.js';
 import { injectMorphImport } from '../../utils/claude-md-injector.js';
+import { getProjectTags } from '../../lib/stack-filter.js';
 
 /**
  * Backup user's config.json before cleaning
@@ -262,19 +263,21 @@ export async function updateCommand(options) {
       logger.warn('  ⚠ framework/commands/ source missing — commands not updated');
     }
 
+    // Compute project tags for stack-aware installation of skills, agents, and rules
+    let projectTags = [];
+    try {
+      const cfg = await readJson(join(morphPath, 'config', 'config.json'));
+      projectTags = getProjectTags(cfg);
+    } catch { /* ignore — config may not exist yet */ }
+
     // Sync morph skills to .claude/skills/ for native Claude Code discovery
     updateSpinner.text = 'Syncing morph skills to .claude/skills/...';
-    await installSkills(targetPath);
+    await installSkills(targetPath, { projectTags });
 
     // Sync native subagents to .claude/agents/
     updateSpinner.text = 'Syncing agents to .claude/agents/...';
-    let projectStack = null;
-    try {
-      const cfg = await readJson(join(morphPath, 'config', 'config.json'));
-      projectStack = cfg?.project?.stack ?? null;
-    } catch { /* ignore — config may not exist yet */ }
-    await installAgents(targetPath, frameworkDir, { projectStack });
-    await installDomainAgents(targetPath, frameworkDir);
+    await installAgents(targetPath, frameworkDir, { projectTags });
+    await installDomainAgents(targetPath, frameworkDir, { projectTags });
 
     // Sync path-scoped rules to .claude/rules/
     updateSpinner.text = 'Syncing rules to .claude/rules/...';

package/src/commands/state/advance-phase.js

@@ -20,7 +20,7 @@ import { validateTransition } from '../../core/state/phase-state-machine.js';
 import { validateSpecContent, validateTasksContent } from '../../lib/validators/content/content-validator.js';
 import { getWorkflowConfig } from '../../core/workflows/workflow-detector.js';
 import { getStackProfile } from '../../lib/stack/stack-profile.js';
-import { readFileSync, existsSync } from 'fs';
+import { readFileSync, existsSync, mkdirSync } from 'fs';
 import { join, dirname } from 'path';
 import { fileURLToPath } from 'url';
 import { emitValidatorDispatch } from '../../lib/validators/shared/emit-validator-dispatch.js';
@@ -339,12 +339,12 @@ export async function advancePhaseCommand(feature, options = {}) {
 
   // === GATE 6: Clarifications Required ===
   // When advancing FROM clarify, clarifications.md must exist.
-  // This enforces that morph:phase-clarify was actually run (not just skipped).
+  // This enforces that morph-phase-clarify was actually run (not just skipped).
   if (currentPhase === 'clarify') {
     const clarPath = join(process.cwd(), '.morph', 'features', feature, '1-design', 'clarifications.md');
     if (!existsSync(clarPath)) {
       console.log(chalk.red('\n✗ Cannot advance from clarify — clarifications.md is missing'));
-      console.log(chalk.yellow('  Run the phase-clarify skill first: /morph:phase-clarify'));
+      console.log(chalk.yellow('  Run the phase-clarify skill first: /morph-phase-clarify'));
       console.log(chalk.gray('  Output expected at: .morph/features/' + feature + '/1-design/clarifications.md\n'));
       process.exit(1);
     }
@@ -373,6 +373,19 @@ export async function advancePhaseCommand(feature, options = {}) {
   const state = loadState();
   state.features[feature].phase = nextPhase;
   state.features[feature].updatedAt = new Date().toISOString();
+
+  // Create the target phase directory so derivePhase() reflects the new phase
+  const PHASE_DIR_MAP = {
+    'proposal': '0-proposal', 'design': '1-design', 'uiux': '2-ui',
+    'plan': '3-plan', 'tasks': '4-tasks', 'implement': '5-implement',
+  };
+  const targetDir = PHASE_DIR_MAP[nextPhase];
+  if (targetDir) {
+    const dirPath = join(featureFolderPath, targetDir);
+    if (!existsSync(dirPath)) {
+      mkdirSync(dirPath, { recursive: true });
+    }
+  }
   if (skippedPhases.length > 0) {
     const existingSkipped = state.features[feature].skippedPhases || [];
     state.features[feature].skippedPhases = [...new Set([...existingSkipped, ...skippedPhases])];
@@ -468,38 +481,38 @@ export async function advancePhaseCommand(feature, options = {}) {
 function getPhaseGuidance(phase, feature) {
   const guides = {
     'setup': [
-      `Resume spec pipeline: /morph:proposal ${feature}`,
+      `Resume spec pipeline: /morph-proposal ${feature}`,
       'Auto-continues from setup phase'
     ],
     'uiux': [
-      `Resume spec pipeline: /morph:proposal ${feature}`,
+      `Resume spec pipeline: /morph-proposal ${feature}`,
       'Provide layout references and preferences',
       'Review wireframes before proceeding'
     ],
     'design': (() => {
       const { isDotnet } = getStackProfile();
       return [
-        `Resume spec pipeline: /morph:proposal ${feature}`,
+        `Resume spec pipeline: /morph-proposal ${feature}`,
         'Review DECISION POINTS carefully',
         isDotnet ? 'Approve spec.md and contracts.cs' : 'Approve spec.md and contracts.ts (TypeScript + Zod schemas)'
       ];
     })(),
     'clarify': [
-      `Resume spec pipeline: /morph:proposal ${feature}`,
+      `Resume spec pipeline: /morph-proposal ${feature}`,
       'Resolve edge cases and unknowns'
     ],
     'plan': [
-      `Resume spec pipeline: /morph:proposal ${feature}`,
+      `Resume spec pipeline: /morph-proposal ${feature}`,
       'Review implementation plan for completeness',
       'Approve plan before generating task breakdown'
     ],
     'tasks': [
-      `Resume spec pipeline: /morph:proposal ${feature}`,
+      `Resume spec pipeline: /morph-proposal ${feature}`,
       'Review task order and dependencies',
       'Approve task list before implementing'
     ],
     'implement': [
-      `Start implementing: /morph:apply ${feature}`,
+      `Start implementing: /morph-apply ${feature}`,
       'Complete tasks one by one with: morph-spec task done',
       'Validators run automatically on task completion'
     ],
@@ -543,7 +556,7 @@ function designSystemGate(feature, projectPath = '.') {
       'Create a design system with one of these options:',
       '  1. Project-level: .morph/context/design-system.md (shared across features)',
       `  2. Feature-level: ${getOutputPath(feature, 'uiDesignSystem')} (feature-specific)`,
-      '  3. Run /morph:phase-uiux skill to auto-generate from existing codebase',
+      '  3. Run /morph-phase-uiux skill to auto-generate from existing codebase',
       '',
       'Or remove UI agents if they are not needed:',
       `  morph-spec state remove-agent ${feature} blazor-builder`

package/src/commands/state/approve.js

@@ -54,7 +54,7 @@ const program = new Command();
 /**
  * Valid approval gate names
  */
-const VALID_GATES = ['proposal', 'uiux', 'design', 'tasks'];
+const VALID_GATES = ['proposal', 'uiux', 'design', 'plan', 'tasks'];
 
 /**
  * Approve action function - Mark a gate as approved

package/src/commands/state/state.js

@@ -11,6 +11,24 @@ import { logger } from '../../utils/logger.js';
 import * as StateManager from '../../core/state/state-manager.js';
 import { derivePhase } from '../../core/state/state-manager.js';
 
+// ============================================================================
+// Phase Resolution
+// ============================================================================
+
+const PHASE_ORDER_LIST = ['setup', 'proposal', 'uiux', 'design', 'clarify', 'plan', 'tasks', 'implement', 'sync', 'archived'];
+
+/**
+ * Resolve the effective phase: pick whichever is further ahead between the
+ * stored phase (set by `phase advance`) and the derived phase (from filesystem).
+ */
+function resolvePhase(storedPhase, derivedPhase) {
+  if (!storedPhase) return derivedPhase;
+  if (!derivedPhase) return storedPhase;
+  const storedIdx = PHASE_ORDER_LIST.indexOf(storedPhase);
+  const derivedIdx = PHASE_ORDER_LIST.indexOf(derivedPhase);
+  return storedIdx > derivedIdx ? storedPhase : derivedPhase;
+}
+
 // ============================================================================
 // Phase Protection
 // ============================================================================
@@ -167,7 +185,9 @@ async function getCommand(featureName, options) {
       logger.header(`Feature: ${featureName}`);
       logger.blank();
       const featurePath = join(process.cwd(), '.morph/features', featureName);
-      const phase = derivePhase(featurePath);
+      const derivedPhase = derivePhase(featurePath);
+      // Use stored phase when it's ahead of derived (directory may not exist yet)
+      const phase = resolvePhase(feature.phase, derivedPhase);
       const tasks = feature.tasks || { completed: 0, total: 0 };
       // Prefer taskList.length as total when tasks.total is stale/zero (Problem 3 complement)
       const total = tasks.total || (Array.isArray(feature.taskList) ? feature.taskList.length : 0);
@@ -293,13 +313,14 @@ async function listCommand(options) {
       }[feature.status] || '❓';
 
       const tasks = feature.tasks || {};
-      const progress = (tasks.total || 0) > 0
-        ? `${tasks.completed || 0}/${tasks.total}`
-        : '0/0';
+      const total = tasks.total || (Array.isArray(feature.taskList) ? feature.taskList.length : 0);
+      const progress = total > 0
+        ? `${tasks.completed || 0}/${total}`
+        : '-';
 
       logger.info(`${statusEmoji}  ${chalk.bold(name)}`);
       const featurePath = join(process.cwd(), '.morph/features', name);
-      const featurePhase = derivePhase(featurePath);
+      const featurePhase = resolvePhase(feature.phase, derivePhase(featurePath));
       logger.dim(`   Phase: ${featurePhase.padEnd(16)} │ Tasks: ${progress}`);
       logger.dim(`   Agents: ${(feature.activeAgents || []).slice(0, 5).join(', ') || 'None'}`);
       logger.blank();

package/src/lib/phase-chain/phase-validator.js

@@ -99,7 +99,12 @@ const OUTPUT_PHASE_MAP = {
 function checkOutput(featurePath, outputFile) {
   const phaseDir = OUTPUT_PHASE_MAP[outputFile] || '';
   const filePath = path.join(featurePath, phaseDir, outputFile);
-  return fs.existsSync(filePath);
+  if (fs.existsSync(filePath)) return true;
+  // Fallback: check feature root (some generators place files there instead of phase subdirs)
+  if (phaseDir) {
+    return fs.existsSync(path.join(featurePath, outputFile));
+  }
+  return false;
 }
 
 /**

package/src/lib/tasks/task-parser.js

@@ -86,6 +86,10 @@ export async function ensureTaskList(feature, featureName, cwd = process.cwd())
  */
 export function syncCounters(feature) {
   if (Array.isArray(feature.tasks)) return; // v2 format — nothing to sync
+  // Safety: ensure feature.tasks is an object (may be undefined after migration or corruption)
+  if (!feature.tasks || typeof feature.tasks !== 'object') {
+    feature.tasks = { total: 0, completed: 0, inProgress: 0, pending: 0 };
+  }
   const list = feature.taskList || [];
   feature.tasks.total = list.length;
   feature.tasks.completed = list.filter(t => t.status === 'completed').length;

package/src/scripts/setup-infra.js

@@ -3,7 +3,7 @@
  *
  * Headless infrastructure setup for MORPH-SPEC.
  * Extracted from init.js (steps 1-10) so it can be called by the
- * /morph:init Claude Code skill via `morph-spec setup-infra` without
+ * /morph-init Claude Code skill via `morph-spec setup-infra` without
  * interactive prompts or stack detection.
  *
  * Usage:
@@ -141,7 +141,7 @@ export async function setupInfra(targetPath, { _exec = execSync } = {}) {
   const contextReadmePath = join(contextDir, 'README.md');
   if (!(await pathExists(contextReadmePath))) {
     const dirName = targetPath.split(/[\/]/).pop();
-    const readmeContent = `# ${dirName} — Project Context\n\nRun /morph:init to generate project context.\n`;
+    const readmeContent = `# ${dirName} — Project Context\n\nRun /morph-init to generate project context.\n`;
     await writeFile(contextReadmePath, readmeContent);
   }
 

package/src/utils/agents-installer.js

@@ -39,9 +39,9 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
   mkdirSync(targetDir, { recursive: true });
 
   const eligible = agents.filter(a => {
-    if (a.tier !== 1 && a.tier !== 2 && a.tier !== 4) return false;
-    // Tier 4 validators must have a teammate with spawn_prompt
-    if (a.tier === 4 && !a.teammate?.spawn_prompt) return false;
+    if (a.tier < 1 || a.tier > 4) return false;
+    // Must have a teammate with spawn_prompt (except tier-1 orchestrators which always have one)
+    if (a.tier >= 3 && !a.teammate?.spawn_prompt) return false;
     // Filter by stacks if the agent declares them
     const stacks = a.stacks ?? [];
     if (!shouldInstall(stacks, projectTags)) return false;
@@ -50,13 +50,14 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
 
   let tier1 = 0;
   let tier2 = 0;
+  let tier3 = 0;
   let tier4 = 0;
   const installed = new Set();
 
   // Build the full set of possible filenames for orphan cleanup
   const allPossible = new Set();
   for (const a of agents) {
-    if (a.tier !== 1 && a.tier !== 2 && a.tier !== 4) continue;
+    if (a.tier < 1 || a.tier > 4) continue;
     const slug = a.id ?? a.name?.toLowerCase().replace(/\s+/g, '-');
     const prefix = a.tier === 4 ? 'morph-validator-' : 'morph-';
     allPossible.add(`${prefix}${slug}.md`);
@@ -78,6 +79,7 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
 
     if (agent.tier === 1) tier1++;
     else if (agent.tier === 2) tier2++;
+    else if (agent.tier === 3) tier3++;
     else if (agent.tier === 4) tier4++;
   }
 
@@ -88,7 +90,7 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
     }
   }
 
-  return { tier1, tier2, tier4 };
+  return { tier1, tier2, tier3, tier4 };
 }
 
 /**
@@ -100,16 +102,23 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
 const TIER_DEFAULTS = {
   1: {
     model: 'inherit',
-    tools: 'Read, Grep, Glob, Bash, Task',
+    tools: 'Read, Grep, Glob, Bash, Task, Write, Edit',
     maxTurns: 30,
-    skills: ['morph:checklist'],
+    skills: ['morph-checklist'],
     memory: 'project',
   },
   2: {
     model: 'inherit',
-    tools: 'Read, Grep, Glob, Bash',
+    tools: 'Read, Write, Edit, Bash, Glob, Grep',
     maxTurns: 20,
-    skills: ['morph:checklist'],
+    skills: ['morph-checklist'],
+    memory: 'local',
+  },
+  3: {
+    model: 'sonnet',
+    tools: 'Read, Write, Edit, Bash, Glob, Grep',
+    maxTurns: 15,
+    skills: [],
     memory: 'local',
   },
   4: {
@@ -309,8 +318,8 @@ export function checkMissingAgents(projectDir, frameworkDir, projectTags = []) {
           .map(([id, data]) => ({ id, ...data }));
 
     for (const a of agents) {
-      if (a.tier !== 1 && a.tier !== 2 && a.tier !== 4) continue;
-      if (a.tier === 4 && !a.teammate?.spawn_prompt) continue;
+      if (a.tier < 1 || a.tier > 4) continue;
+      if (a.tier >= 3 && !a.teammate?.spawn_prompt) continue;
       const stacks = a.stacks ?? [];
       if (!shouldInstall(stacks, projectTags)) continue;
 

package/src/utils/banner.js

@@ -45,7 +45,7 @@ export function printInstallBanner({ version, nodeVersion, results = [] }) {
     '',
     sep('Next'),
     `  ${chalk.cyan('1.')} Open your project in Claude Code`,
-    `  ${chalk.cyan('2.')} Run ${chalk.bold.white('/morph:init')}`,
+    `  ${chalk.cyan('2.')} Run ${chalk.bold.white('/morph-init')}`,
     '',
   ].join('\n'));
 }