@polymorphism-tech/morph-spec 4.10.9 → 4.11.0

package/framework/workflows/README.md

@@ -371,7 +371,7 @@ Keywords like: `bicep`, `azure`, `deploy`, `docker`, `kubernetes`, `infrastructu
 
 ```bash
 # When creating a feature
-npx morph-spec feature create user-pagination \
+morph-spec feature create user-pagination \
   --request "add pagination to users table"
 
 # System automatically:
@@ -385,7 +385,7 @@ npx morph-spec feature create user-pagination \
 
 ```bash
 # Analyze request without creating feature
-npx morph-spec detect-workflow "implement complete authentication system"
+morph-spec detect-workflow "implement complete authentication system"
 
 # Output:
 Detected Workflow: full-morph (92% confidence)
@@ -407,7 +407,7 @@ Alternative Workflows:
 ### JSON Output (for automation)
 
 ```bash
-npx morph-spec detect-workflow "add pagination" --json
+morph-spec detect-workflow "add pagination" --json
 
 # Output:
 {
@@ -435,17 +435,17 @@ npx morph-spec detect-workflow "add pagination" --json
 
 ```bash
 # Force specific workflow
-npx morph-spec state set user-auth workflow full-morph
+morph-spec state set user-auth workflow full-morph
 
 # Re-detect after request changes
-npx morph-spec state detect-workflow user-auth \
+morph-spec state detect-workflow user-auth \
   "implement basic login only (no OAuth)"
 ```
 
 ### View Current Workflow
 
 ```bash
-npx morph-spec state get user-auth workflow
+morph-spec state get user-auth workflow
 
 # Output:
 Workflow: standard
@@ -594,7 +594,7 @@ Create `framework/workflows/docs/my-workflow.md` explaining the workflow.
 **3. Test Detection:**
 
 ```bash
-npx morph-spec detect-workflow "request with custom-keyword"
+morph-spec detect-workflow "request with custom-keyword"
 ```
 
 ### Modifying Existing Workflows
@@ -675,7 +675,7 @@ Phases: Quick Analysis → Implement
 
 **User Experience:**
 ```bash
-npx morph-spec feature create login-typo --request "fix typo in login button"
+morph-spec feature create login-typo --request "fix typo in login button"
 
 # Output:
 ✓ Detected workflow: fast-track
@@ -683,7 +683,7 @@ npx morph-spec feature create login-typo --request "fix typo in login button"
 📝 Write quick analysis (1 paragraph) and implement
 
 # User writes quick analysis, then:
-npx morph-spec phase advance login-typo
+morph-spec phase advance login-typo
 
 # Output:
 ⏩ Skipping: setup, uiux, design, clarify, tasks, sync
@@ -704,7 +704,7 @@ Phases: PROPOSAL → DESIGN → TASKS → IMPLEMENT
 
 **User Experience:**
 ```bash
-npx morph-spec feature create user-pagination \
+morph-spec feature create user-pagination \
   --request "add pagination to users table"
 
 # Output:
@@ -727,7 +727,7 @@ Phases: ALL (9 phases mandatory)
 
 **User Experience:**
 ```bash
-npx morph-spec feature create user-auth \
+morph-spec feature create user-auth \
   --request "implement complete authentication system with OAuth"
 
 # Output:
@@ -750,7 +750,7 @@ Phases: PROTOTYPE ANALYSIS → TASKS → IMPLEMENT
 
 **User Experience:**
 ```bash
-npx morph-spec feature create dashboard-screens \
+morph-spec feature create dashboard-screens \
   --request "implement screens from Figma design"
 
 # Output:
@@ -774,7 +774,7 @@ Phases: VISUAL ANALYSIS → DESIGN SYSTEM → IMPLEMENT
 
 **User Experience:**
 ```bash
-npx morph-spec feature create dashboard-redesign \
+morph-spec feature create dashboard-redesign \
   --request "redesign dashboard to look more modern"
 
 # Output:
@@ -794,13 +794,13 @@ npx morph-spec feature create dashboard-redesign \
 
 **Solution 1: Provide more context**
 ```bash
-npx morph-spec feature create simple-fix \
+morph-spec feature create simple-fix \
   --request "add pagination (simple, already have paginator component)"
 ```
 
 **Solution 2: Manual override**
 ```bash
-npx morph-spec state set my-feature workflow standard
+morph-spec state set my-feature workflow standard
 ```
 
 **Solution 3: Improve keywords**
@@ -849,7 +849,7 @@ If this happens often, add keywords to workflow config:
 **Alternative:**
 Use `detect-workflow` first to see both options:
 ```bash
-npx morph-spec detect-workflow "add authentication"
+morph-spec detect-workflow "add authentication"
 
 # Review both workflows
 # Decide based on:
@@ -891,13 +891,13 @@ Create `framework/workflows/configs/blazor-standard.json`:
 **Solution 1: Force phase**
 ```bash
 # Manually go to UIUX phase
-npx morph-spec phase set my-feature uiux
+morph-spec phase set my-feature uiux
 ```
 
 **Solution 2: Override workflow**
 ```bash
 # Use full-morph (includes all phases)
-npx morph-spec state set my-feature workflow full-morph
+morph-spec state set my-feature workflow full-morph
 ```
 
 **Solution 3: Document in decisions.md**

package/framework/workflows/docs/enforcement-pipeline.md

@@ -113,7 +113,7 @@ export function loadStandardsForAgent(agentId, projectPath) {
 
 ```bash
 # Standards auto-injected when running detect-agents with --json
-npx morph-spec detect-agents --json "create blazor dashboard"
+morph-spec detect-agents --json "create blazor dashboard"
 
 # Output includes standardsSummary for each agent:
 {

package/framework/workflows/docs/full-morph.md

@@ -18,7 +18,7 @@
 6. Ativar agentes baseado em stack + keywords
 
 ### FASE 0: PROPOSAL
-1. `npx morph-spec detect "{user-request}"`
+1. `morph-spec detect "{user-request}"`
 2. Analisar solicitação, identificar stack, estimar complexidade
 3. Gerar proposal.md, registrar agentes no state.json
 - **⛔ PAUSA:** 3 itens (1 ação + 1 pergunta + 1 sugestão)
@@ -55,7 +55,7 @@
 
 ### FASE 5: IMPLEMENT
 1. Implementar task por task
-2. `npx morph-spec task done {feature} {task-id}` após cada task
+2. `morph-spec task done {feature} {task-id}` após cada task
 3. Framework gerencia checkpoints automaticamente (a cada 3 tasks)
 4. Gerar recap.md ao final
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "4.10.9",
+  "version": "4.11.0",
   "description": "MORPH-SPEC: AI-First development framework with validation pipeline and multi-stack support",
   "keywords": [
     "claude-code",

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

@@ -22,6 +22,7 @@ import { fileURLToPath } from 'url';
 import { loadState, stateExists } from '../../core/state/state-manager.js';
 import { buildAgentBriefing, buildValidatorPrompt } from '../../lib/standards/digest-builder.js';
 import { agentIdToSubagentType } from '../../utils/agent-id-mapper.js';
+import { shouldInstall, getProjectTags } from '../../lib/stack-filter.js';
 import { parseAndGroupTasks } from '../../lib/tasks/task-parser.js';
 export { parseAndGroupTasks } from '../../lib/tasks/task-parser.js';
 import chalk from 'chalk';
@@ -222,6 +223,16 @@ export async function buildDispatchConfig(projectPath, featureName, phase, opts
     // Non-blocking — fail silent, skills block will be omitted
   }
 
+  // Load project config for stack filtering
+  const configPath = join(projectPath, '.morph', 'config.json');
+  let projectTags = [];
+  try {
+    if (existsSync(configPath)) {
+      const config = JSON.parse(readFileSync(configPath, 'utf8'));
+      projectTags = getProjectTags(config);
+    }
+  } catch { /* non-blocking */ }
+
   // Active agents from state (keyword-detected during setup phase)
   const activeAgentIds = new Set(feature.activeAgents || []);
 
@@ -259,6 +270,12 @@ export async function buildDispatchConfig(projectPath, featureName, phase, opts
     // Phase relevance check (tier-4 bypass in validate mode)
     if (!isRelevantForPhase(agentId, agentData, phase) && !(isValidateMode && isTier4)) continue;
 
+    // Stack filtering (Tier 1/2 exempt — always dispatched)
+    if (agentData.tier >= 3 && projectTags.length > 0) {
+      const agentStacks = agentData.stacks || [];
+      if (!shouldInstall(agentStacks, projectTags)) continue;
+    }
+
     const group = getAgentGroup(agentId, agentData);
 
     // Build task prompt: validator prompt for tier-4 in validate mode, else spawn_prompt

package/src/commands/agents/index.js

@@ -1,13 +1,13 @@
-/**
- * Agent Commands
- */
-export { dispatchAgentsCommand, buildDispatchConfig } from './dispatch-agents.js';
-export { auditDispatchCommand } from './audit-dispatch.js';
-export { detectAgentsCommand, detectAgents } from './detect-agents.js';
-export {
-  agentListCommand,
-  agentShowCommand,
-  agentAddCommand,
-  agentEditCommand,
-  agentRemoveCommand,
-} from './manage-agents.js';
+/**
+ * Agent Commands
+ */
+export { dispatchAgentsCommand, buildDispatchConfig } from './dispatch-agents.js';
+export { auditDispatchCommand } from './audit-dispatch.js';
+export { detectAgentsCommand, detectAgents } from './detect-agents.js';
+export {
+  agentListCommand,
+  agentShowCommand,
+  agentAddCommand,
+  agentEditCommand,
+  agentRemoveCommand,
+} from './manage-agents.js';

package/src/commands/agents/project-metrics.js

@@ -0,0 +1,74 @@
+/**
+ * project-metrics — Project-level metrics aggregation CLI
+ *
+ * Aggregates feature data from state.json into a project-wide summary.
+ *
+ * Usage:
+ *   morph-spec project-metrics [--json] [--save]
+ */
+
+import { writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { loadState, stateExists } from '../../core/state/state-manager.js';
+import { aggregateProjectMetrics } from '../../lib/agents/metrics-aggregator.js';
+import chalk from 'chalk';
+
+/**
+ * CLI command: morph-spec project-metrics [--json] [--save]
+ */
+export async function projectMetricsCommand(options = {}) {
+  if (!stateExists()) {
+    console.error(chalk.red('No state.json found. Run morph-spec state init first.'));
+    process.exit(1);
+  }
+
+  try {
+    const state = loadState(false);
+    if (!state) {
+      console.error(chalk.red('Failed to load state.json.'));
+      process.exit(1);
+    }
+
+    const metrics = aggregateProjectMetrics(state);
+
+    if (options.save) {
+      const morphDir = join(process.cwd(), '.morph');
+      if (!existsSync(morphDir)) {
+        mkdirSync(morphDir, { recursive: true });
+      }
+      const outPath = join(morphDir, 'metrics.json');
+      writeFileSync(outPath, JSON.stringify(metrics, null, 2) + '\n', 'utf8');
+      console.log(chalk.green(`Metrics saved to ${outPath}`));
+    }
+
+    if (options.json) {
+      console.log(JSON.stringify(metrics, null, 2));
+      return;
+    }
+
+    // Human-readable table
+    const s = metrics.summary;
+    console.log(chalk.bold('\n  Project Metrics'));
+    console.log('  ' + '─'.repeat(50));
+    console.log(`  Features:      ${s.totalFeatures} (${s.completedFeatures} completed)`);
+    console.log(`  Tasks:         ${s.completedTasks}/${s.totalTasks} (${s.completionRate}%)`);
+    console.log(`  Avg tasks/feat: ${s.avgTasksPerFeature}`);
+    console.log(`  Dispatches:    ${s.totalDispatches}`);
+
+    if (metrics.features.length > 0) {
+      console.log(chalk.bold('\n  Features:'));
+      console.log(`  ${'Name'.padEnd(24)} ${'Phase'.padEnd(14)} ${'Tasks'.padEnd(10)} Dispatches`);
+      console.log('  ' + '─'.repeat(60));
+      for (const f of metrics.features) {
+        const taskStr = `${f.completedTasks}/${f.taskCount}`;
+        console.log(
+          `  ${f.name.padEnd(24)} ${chalk.cyan(f.phase.padEnd(14))} ${taskStr.padEnd(10)} ${f.dispatchCount}`
+        );
+      }
+    }
+    console.log();
+  } catch (err) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/project/doctor.js

@@ -947,13 +947,12 @@ export async function doctorCommand(options = {}) {
         logger.dim('  PowerShell (as Administrator):');
         console.log(chalk.gray(`    [Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";${prefix}", "User")`));
         logger.blank();
-        logger.dim('  Or use npx instead:');
-        logger.dim('    npx @polymorphism-tech/morph-spec init');
+        logger.dim('  Then open a new terminal.');
         logger.blank();
       } else if (!inPath) {
         logger.info('morph-spec not in PATH:');
-        logger.dim('  Use npx instead:');
-        logger.dim('    npx @polymorphism-tech/morph-spec init');
+        logger.dim('  Open a new terminal — the installer adds npm global to $PROFILE automatically.');
+        logger.dim('  If it persists, add manually: npm config get prefix → add to PATH');
         logger.blank();
       }
     }

package/src/commands/project/install-plugin-cmd.js

@@ -1,28 +1,28 @@
-// src/commands/project/install-plugin-cmd.js
-import { installPlugin } from '../../scripts/install-plugin.js';
-import { logger } from '../../utils/logger.js';
-
-export async function installPluginCommand(pluginName, _options) {
-  if (!pluginName) {
-    logger.error('Plugin name required. Usage: morph-spec install-plugin <name>');
-    logger.dim('  Available: superpowers, context7');
-    process.exit(1);
-  }
-  try {
-    const result = await installPlugin(pluginName);
-    if (result.alreadyInstalled) {
-      logger.dim(`  ✓ ${pluginName} already installed (${result.version})`);
-    } else {
-      logger.success(`  ✓ ${pluginName} installed (${result.version})`);
-      logger.dim('  Restart Claude Code to activate.');
-    }
-  } catch (err) {
-    logger.error(`Failed to install plugin "${pluginName}": ${err.message}`);
-    logger.blank();
-    logger.warn('Manual installation:');
-    logger.dim('  1. Claude Code → Settings (Cmd/Ctrl+,) → Extensions');
-    logger.dim(`  2. Browse → search "${pluginName}" → Install`);
-    logger.dim('  3. Restart Claude Code');
-    process.exit(1);
-  }
-}
+// src/commands/project/install-plugin-cmd.js
+import { installPlugin } from '../../scripts/install-plugin.js';
+import { logger } from '../../utils/logger.js';
+
+export async function installPluginCommand(pluginName, _options) {
+  if (!pluginName) {
+    logger.error('Plugin name required. Usage: morph-spec install-plugin <name>');
+    logger.dim('  Available: superpowers, context7');
+    process.exit(1);
+  }
+  try {
+    const result = await installPlugin(pluginName);
+    if (result.alreadyInstalled) {
+      logger.dim(`  ✓ ${pluginName} already installed (${result.version})`);
+    } else {
+      logger.success(`  ✓ ${pluginName} installed (${result.version})`);
+      logger.dim('  Restart Claude Code to activate.');
+    }
+  } catch (err) {
+    logger.error(`Failed to install plugin "${pluginName}": ${err.message}`);
+    logger.blank();
+    logger.warn('Manual installation:');
+    logger.dim('  1. Claude Code → Settings (Cmd/Ctrl+,) → Extensions');
+    logger.dim(`  2. Browse → search "${pluginName}" → Install`);
+    logger.dim('  3. Restart Claude Code');
+    process.exit(1);
+  }
+}

package/src/commands/project/setup-infra-cmd.js

@@ -1,12 +1,12 @@
-import { setupInfra } from '../../scripts/setup-infra.js';
-import { logger } from '../../utils/logger.js';
-
-export async function setupInfraCommand(options) {
-  const targetPath = options.path || process.cwd();
-  try {
-    await setupInfra(targetPath);
-  } catch (err) {
-    logger.error(`setup-infra failed: ${err.message}`);
-    process.exit(1);
-  }
-}
+import { setupInfra } from '../../scripts/setup-infra.js';
+import { logger } from '../../utils/logger.js';
+
+export async function setupInfraCommand(options) {
+  const targetPath = options.path || process.cwd();
+  try {
+    await setupInfra(targetPath);
+  } catch (err) {
+    logger.error(`setup-infra failed: ${err.message}`);
+    process.exit(1);
+  }
+}

package/src/commands/project/status.js

@@ -236,7 +236,14 @@ export async function statusCommand(featureName, options = {}) {
     process.exit(1);
   }
 
-  const feature = getFeature(featureName);
+  let feature;
+  try {
+    feature = getFeature(featureName);
+  } catch (err) {
+    console.error(chalk.red(`✗ Error: ${err.message}`));
+    console.error(chalk.gray('Run \'morph-spec doctor\' to diagnose or fix your state.json'));
+    process.exit(1);
+  }
   if (!feature) {
     console.error(chalk.red(`✗ Error: Feature '${featureName}' not found`));
     console.error(chalk.gray(`Run 'morph-spec state get ${featureName}' to check if feature exists`));

package/src/commands/scope/escalate.js

@@ -13,7 +13,7 @@
 import chalk from 'chalk';
 import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
 import { join } from 'path';
-import { loadState, saveState } from '../../core/state/state-manager.js';
+import { loadState, saveState, derivePhase } from '../../core/state/state-manager.js';
 import { analyzeImpact } from '../../lib/scope/impact-analyzer.js';
 
 /**
@@ -35,8 +35,10 @@ export async function escalateScope(featureName, options) {
     return { success: false, error: `Feature "${featureName}" not found in state.json` };
   }
 
-  if (feature.phase !== 'implement') {
-    return { success: false, error: `Scope escalation only available during implement phase (current: ${feature.phase})` };
+  const featurePath = join(process.cwd(), '.morph', 'features', featureName);
+  const currentPhase = feature.phase || derivePhase(featurePath);
+  if (currentPhase !== 'implement') {
+    return { success: false, error: `Scope escalation only available during implement phase (current: ${currentPhase})` };
   }
 
   // Read tasks.md

package/src/commands/standards/context-budget.js

@@ -0,0 +1,89 @@
+/**
+ * context-budget — Token budget tracking for standards context
+ *
+ * Shows estimated token usage for agent briefings built from STANDARDS.json digests.
+ *
+ * Usage:
+ *   morph-spec context-budget [--phase <phase>] [--json]
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { buildAgentBriefing, estimateTokens, clearCache } from '../../lib/standards/digest-builder.js';
+import chalk from 'chalk';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENTS_JSON_PATH = join(__dirname, '../../../framework/agents.json');
+
+/**
+ * CLI command: morph-spec context-budget [--phase <phase>] [--json]
+ */
+export async function contextBudgetCommand(options = {}) {
+  const phase = options.phase || 'implement';
+
+  if (!existsSync(AGENTS_JSON_PATH)) {
+    console.error(chalk.red('framework/agents.json not found.'));
+    process.exit(1);
+  }
+
+  try {
+    clearCache();
+    const agentsData = JSON.parse(readFileSync(AGENTS_JSON_PATH, 'utf8'));
+    const allAgents = agentsData.agents || {};
+
+    const results = [];
+
+    for (const [agentId, agentData] of Object.entries(allAgents)) {
+      if (agentId.startsWith('_comment')) continue;
+      if (!agentData.standards || agentData.standards.length === 0) continue;
+
+      const briefing = buildAgentBriefing(agentId, phase);
+      if (!briefing) continue;
+
+      const tokens = estimateTokens(briefing);
+      results.push({
+        agentId,
+        tier: agentData.tier,
+        standardsCount: agentData.standards.length,
+        tokens,
+        overBudget: tokens > 8000,
+      });
+    }
+
+    // Sort by tokens descending
+    results.sort((a, b) => b.tokens - a.tokens);
+
+    const totalTokens = results.reduce((sum, r) => sum + r.tokens, 0);
+    const overBudget = results.filter(r => r.overBudget);
+
+    if (options.json) {
+      console.log(JSON.stringify({ phase, totalTokens, overBudgetCount: overBudget.length, agents: results }, null, 2));
+      return;
+    }
+
+    // Human-readable
+    console.log(chalk.bold(`\n  Context Budget — phase: ${phase}`));
+    console.log('  ' + '─'.repeat(62));
+    console.log(`  ${'Agent'.padEnd(32)} ${'Tier'.padEnd(6)} ${'Stds'.padEnd(6)} Tokens`);
+    console.log('  ' + '─'.repeat(62));
+
+    for (const r of results) {
+      const tokenStr = r.overBudget ? chalk.red(String(r.tokens)) : String(r.tokens);
+      const flag = r.overBudget ? ' ⚠' : '';
+      console.log(
+        `  ${r.agentId.padEnd(32)} ${String(r.tier).padEnd(6)} ${String(r.standardsCount).padEnd(6)} ${tokenStr}${flag}`
+      );
+    }
+
+    console.log('  ' + '─'.repeat(62));
+    console.log(`  Total: ${results.length} agents, ${totalTokens} tokens`);
+    if (overBudget.length > 0) {
+      console.log(chalk.yellow(`  ⚠ ${overBudget.length} agent(s) exceed 8000 token threshold`));
+    }
+    console.log();
+  } catch (err) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+}

package/src/commands/tasks/index.js

@@ -1,4 +1,4 @@
-/**
- * Task Management Commands
- */
-export { taskCommand } from './task.js';
+/**
+ * Task Management Commands
+ */
+export { taskCommand } from './task.js';

package/src/commands/templates/index.js

@@ -1,5 +1,5 @@
-/**
- * Template Commands
- */
-export { templateRenderCommand } from './template-render.js';
-export { generateContractsCommand, parseSchemaAnalysisMd } from './generate-contracts.js';
+/**
+ * Template Commands
+ */
+export { templateRenderCommand } from './template-render.js';
+export { generateContractsCommand, parseSchemaAnalysisMd } from './generate-contracts.js';

package/src/commands/utils/index.js

@@ -1,3 +1,3 @@
-/**
- * Utility Commands — no active commands after CLI simplification
- */
+/**
+ * Utility Commands — no active commands after CLI simplification
+ */

package/src/commands/validation/index.js

@@ -1,4 +1,4 @@
-/**
- * Validation Commands
- */
-export { validateFeatureCommand } from './validate-feature.js';
+/**
+ * Validation Commands
+ */
+export { validateFeatureCommand } from './validate-feature.js';

package/src/commands/validation/validate-feature.js

@@ -70,6 +70,19 @@ const PHASE_OUTPUTS = {
   implement: ['spec.md', 'contracts.cs', 'tasks.md']
 };
 
+/**
+ * Phase-to-folder mapping (filesystem convention)
+ */
+const PHASE_FOLDERS = {
+  proposal: '0-proposal',
+  uiux: '2-ui',
+  design: '1-design',
+  clarify: '1-design',
+  plan: '3-plan',
+  tasks: '4-tasks',
+  implement: '5-implement',
+};
+
 /**
  * Validate a single output file
  */
@@ -254,12 +267,28 @@ export async function validateFeatureCommand(featureName, options = {}) {
       process.exit(1);
     }
   } else {
-    // Validate all existing outputs
-    outputFiles = fs.readdirSync(featurePath).filter(f => f.endsWith('.md') || f.endsWith('.cs'));
+    // Validate all existing outputs across all phase folders
+    outputFiles = [];
+    const entries = fs.readdirSync(featurePath, { withFileTypes: true });
+    for (const entry of entries) {
+      if (entry.isDirectory()) {
+        const subDir = path.join(featurePath, entry.name);
+        const files = fs.readdirSync(subDir).filter(f => f.endsWith('.md') || f.endsWith('.cs'));
+        outputFiles.push(...files.map(f => ({ file: f, dir: subDir })));
+      } else if (entry.name.endsWith('.md') || entry.name.endsWith('.cs')) {
+        outputFiles.push({ file: entry.name, dir: featurePath });
+      }
+    }
   }
 
+  // Resolve phase folder for path lookup
+  const phaseFolder = phase ? PHASE_FOLDERS[phase] : null;
+  const searchPath = phaseFolder ? path.join(featurePath, phaseFolder) : featurePath;
+
   // Run validation
-  const results = outputFiles.map(file => validateOutput(featurePath, file));
+  const results = phase
+    ? outputFiles.map(file => validateOutput(searchPath, file))
+    : outputFiles.map(({ file, dir }) => validateOutput(dir, file));
   const schemaWarnings = crossValidateSchema(featurePath);
 
   // Aggregate results