@polymorphism-tech/morph-spec 4.10.4 → 4.10.5

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'));
 }