@polymorphism-tech/morph-spec 8.1.1 → 8.1.2

package/README.md

@@ -3,7 +3,7 @@
 > Spec-driven development framework for multi-stack projects. Turns feature requests into implementation-ready code through structured, AI-orchestrated phases.
 
 **Package:** `@polymorphism-tech/morph-spec`
-**Version:** 8.1.1  
+**Version:** 8.1.2  
 **Requires:** Node.js 22+, Claude Code
 
 ---
@@ -394,4 +394,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v8.1.1 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v8.1.2 by [Polymorphism Tech](https://polymorphism.tech)*

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "8.1.1",
+  "version": "8.1.2",
   "displayName": "MORPH-SPEC Framework",
   "description": "Spec-driven development with 38 agents and 8-phase workflow for .NET/Blazor/Next.js/Azure",
   "publisher": "polymorphism-tech",

package/docs/CHEATSHEET.md

@@ -237,4 +237,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v8.1.1 by Polymorphism Tech*
+*morph-spec v8.1.2 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -256,4 +256,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v8.1.1 by Polymorphism Tech*
+*morph-spec v8.1.2 by Polymorphism Tech*

package/framework/hooks/claude-code/core/validate-completion.js

@@ -179,8 +179,9 @@ try {
     if (existsSync(configPath)) {
       const config = JSON.parse(readFileSync(configPath, 'utf-8'));
       const stack = config?.project?.stack;
+      const { frontendPath, backendPath } = config?.project ?? {};
       if (stack && currentPhase === 'implement') {
-        const buildResult = runBuildCheck(cwd, stack);
+        const buildResult = runBuildCheck(cwd, stack, undefined, { frontendPath, backendPath });
         if (buildResult.status === 'fail') {
           warnings.push('⚠ Build/typecheck failed:');
           warnings.push(buildResult.output);

package/framework/hooks/shared/build-check.js

@@ -1,8 +1,8 @@
 /**
  * Build/Typecheck verification utility.
  *
- * Stack-aware: determines the correct build command based on project stack.
- * Used by the Stop hook to verify code health before session ends.
+ * Stack-aware: determines the correct build command(s) based on project stack.
+ * Used by the Stop hook and `morph-spec verify` to verify code health.
  *
  * Pure functions — no I/O except the actual build execution.
  */
@@ -11,8 +11,31 @@ import { execSync } from 'child_process';
 import { existsSync } from 'fs';
 import { join } from 'path';
 
+const DOTNET_BUILD_CMD = 'dotnet build --no-restore --nologo -v q';
+const TSC_BUILD_CMD = 'npx tsc --noEmit';
+
+function isDotnetStack(s) {
+  return s.includes('dotnet') || s.includes('aspnet');
+}
+
+function isFrontendStack(s) {
+  return s.includes('nextjs') || s.includes('node') || s.includes('react') || s.includes('vue');
+}
+
 /**
- * Determine the build command for a given stack.
+ * Determine the build command for a SINGLE (non-monorepo) stack string.
+ *
+ * Kept for backward compatibility with single-stack projects and existing
+ * callers. A monorepo stack that mixes a frontend token with "dotnet" (e.g.
+ * the detector's own `${frontendStack}+dotnet` format, or a hyphenated
+ * `dotnet-nextjs`) should resolve through `getBuildSteps()` instead: this
+ * function alone can only ever return ONE command, and — because it checks
+ * `dotnet` before the frontend tokens — a compound stack always resolves to
+ * `dotnet build` even when the frontend is what actually needs checking (or
+ * when there's no root-level `.sln`/`.csproj`, e.g. in a monorepo where the
+ * backend lives in a subfolder). `getBuildSteps()` runs BOTH sides, each
+ * from its own working directory, instead of one command winning by
+ * substring match order.
  *
  * @param {string} stack - Project stack (e.g., 'dotnet-nextjs', 'nextjs')
  * @param {boolean} [hasTsConfig] - Whether tsconfig.json exists (for TS projects)
@@ -22,17 +45,53 @@ export function getBuildCommand(stack, hasTsConfig = false) {
   if (!stack) return null;
   const s = stack.toLowerCase();
 
-  if (s.includes('dotnet')) {
-    return 'dotnet build --no-restore --nologo -v q';
+  if (isDotnetStack(s)) {
+    return DOTNET_BUILD_CMD;
   }
 
-  if ((s.includes('nextjs') || s.includes('node') || s.includes('react')) && hasTsConfig) {
-    return 'npx tsc --noEmit';
+  if (isFrontendStack(s) && hasTsConfig) {
+    return TSC_BUILD_CMD;
   }
 
   return null;
 }
 
+/**
+ * Resolve the build step(s) to run for a project, monorepo-aware.
+ *
+ * A monorepo stack mixes a frontend token and "dotnet" (see
+ * `detectProject()`'s own `${frontendStack}+dotnet` format) — in that case
+ * BOTH sides are checked, each from its own working directory
+ * (`frontendPath` / `backendPath`, as stored in
+ * `.morph/config/config.json → project`), instead of one command silently
+ * winning — or running from the wrong cwd — by substring match order.
+ * Single-stack projects (no `frontendPath`/`backendPath`, or a stack that
+ * only matches one side) resolve to exactly one step, from `cwd`, matching
+ * `getBuildCommand()`'s existing single-stack behavior.
+ *
+ * @param {string} stack
+ * @param {{ cwd: string, frontendPath?: string, backendPath?: string }} opts
+ * @returns {Array<{ command: string, cwd: string }>}
+ */
+export function getBuildSteps(stack, { cwd, frontendPath, backendPath } = {}) {
+  if (!stack || !cwd) return [];
+  const s = stack.toLowerCase();
+  const steps = [];
+
+  if (isDotnetStack(s)) {
+    steps.push({ command: DOTNET_BUILD_CMD, cwd: backendPath ? join(cwd, backendPath) : cwd });
+  }
+
+  if (isFrontendStack(s)) {
+    const frontendDir = frontendPath ? join(cwd, frontendPath) : cwd;
+    if (existsSync(join(frontendDir, 'tsconfig.json'))) {
+      steps.push({ command: TSC_BUILD_CMD, cwd: frontendDir });
+    }
+  }
+
+  return steps;
+}
+
 /**
  * Parse build command result into a structured object.
  *
@@ -52,28 +111,42 @@ export function parseBuildResult(exitCode, output) {
 }
 
 /**
- * Run build check for a project.
+ * Run build check for a project — monorepo-aware (see `getBuildSteps()`).
+ *
+ * For a compound stack (e.g. "nextjs+dotnet"), runs each resolved step in
+ * its own working directory and fails if any step fails; output from all
+ * failing steps is concatenated (prefixed by the command that produced it)
+ * so a frontend typecheck failure and a backend build failure are never
+ * silently masked by one another.
  *
  * @param {string} cwd - Project root directory
  * @param {string} stack - Project stack string
  * @param {number} [timeout=30000] - Timeout in ms
+ * @param {{ frontendPath?: string, backendPath?: string }} [paths] - Monorepo sub-paths, from config.json → project
  * @returns {{ status: 'pass'|'fail'|'skip', output: string }}
  */
-export function runBuildCheck(cwd, stack, timeout = 30000) {
-  const hasTsConfig = existsSync(join(cwd, 'tsconfig.json'));
-  const cmd = getBuildCommand(stack, hasTsConfig);
-  if (!cmd) return { status: 'skip', output: '' };
-
-  try {
-    const output = execSync(cmd, {
-      cwd,
-      encoding: 'utf-8',
-      timeout,
-      stdio: ['pipe', 'pipe', 'pipe']
-    });
-    return parseBuildResult(0, output);
-  } catch (err) {
-    const output = (err.stdout || '') + (err.stderr || '');
-    return parseBuildResult(err.status || 1, output);
+export function runBuildCheck(cwd, stack, timeout = 30000, paths = {}) {
+  const steps = getBuildSteps(stack, { cwd, frontendPath: paths.frontendPath, backendPath: paths.backendPath });
+  if (steps.length === 0) return { status: 'skip', output: '' };
+
+  const failures = [];
+  for (const step of steps) {
+    try {
+      execSync(step.command, {
+        cwd: step.cwd,
+        encoding: 'utf-8',
+        timeout,
+        stdio: ['pipe', 'pipe', 'pipe'],
+      });
+    } catch (err) {
+      const output = (err.stdout || '') + (err.stderr || '');
+      const parsed = parseBuildResult(err.status || 1, output);
+      failures.push(`[${step.command}] ${parsed.output}`);
+    }
+  }
+
+  if (failures.length > 0) {
+    return { status: 'fail', output: failures.join('\n\n') };
   }
+  return { status: 'pass', output: '' };
 }

package/framework/skills/core/create-umbraco-lp/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a criação de uma landing page nova ponta-a-ponta a partir do
 version: core
 when-to-invoke: ao iniciar um novo projeto de LP com o template Umbraco genérico
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # create-umbraco-lp

package/framework/skills/core/migrate-lp-to-umbraco/SKILL.md

@@ -4,7 +4,7 @@ description: Migra uma landing page existente (React/Vite, Next.js estático ou
 version: core
 when-to-invoke: ao receber instrução "use /migrate-lp-to-umbraco {projeto}" do usuário, ou quando o usuário descrever necessidade de migrar uma LP para Umbraco
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # migrate-lp-to-umbraco

package/framework/skills/core/morph-apply/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a execução autônoma de tasks de uma feature morph-spec
 version: core
 when-to-invoke: após Gate 2 aprovado, ao receber instrução "use /morph-apply" ou "implementar feature"
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-apply

package/framework/skills/core/morph-brainstorming/SKILL.md

@@ -4,7 +4,7 @@ description: Entende o negócio, os usuários e a arquitetura antes de qualquer
 version: core
 when-to-invoke: ao receber um novo request de feature, antes de morph-plan
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-brainstorming

package/framework/skills/core/morph-eval/SKILL.md

@@ -4,7 +4,7 @@ description: Avalia a qualidade de uma tarefa ou fase com rubricas graduadas 0-1
 version: core
 when-to-invoke: ao completar uma tarefa ou ao finalizar uma fase de implementação
 user-invokable: false
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-eval

package/framework/skills/core/morph-hotfix/SKILL.md

@@ -4,7 +4,7 @@ description: ADW cirúrgico de hotfix — resolve uma queda/bug crítico de prod
 version: core
 when-to-invoke: ao receber "/morph-hotfix {feature}", quando a morph-proposal classifica o pedido como workType hotfix (Passo 0), ou o usuário diz "produção caiu / hotfix / urgente"
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-hotfix

package/framework/skills/core/morph-implement/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a execução de cada tarefa de implementação com standard e
 version: core
 when-to-invoke: ao iniciar cada task de implementação listada em tasks.json
 user-invokable: false
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-implement

package/framework/skills/core/morph-plan/SKILL.md

@@ -4,7 +4,7 @@ description: Guia a produção dos três artefatos de planejamento de uma featur
 version: core
 when-to-invoke: ao iniciar a fase plan de uma feature, após o Gate 1 (proposal aprovado)
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-plan

package/framework/skills/core/morph-proposal/SKILL.md

@@ -4,7 +4,7 @@ description: Orquestra a fase de proposta+plano de uma feature morph-spec. Encad
 version: core
 when-to-invoke: ao receber instrução "use /morph-proposal" do usuário, ou ao iniciar uma nova feature
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-proposal

package/framework/skills/core/morph-review/SKILL.md

@@ -4,7 +4,7 @@ description: Conduz a fase de revisão e produz o review-report.md para o Gate 3
 version: core
 when-to-invoke: ao iniciar a fase review, após todas as tasks de tasks.json estarem com status `done`
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-review

package/framework/skills/core/morph-stack-scan/SKILL.md

@@ -4,7 +4,7 @@ description: Varre o codebase existente, detecta stack atual, compara com o stac
 version: core
 when-to-invoke: ao iniciar uma feature em projeto brownfield (codebase já existente)
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-stack-scan

package/framework/skills/core/morph-standards/SKILL.md

@@ -4,7 +4,7 @@ description: Localiza e carrega um standard específico do STANDARDS.json sob de
 version: core
 when-to-invoke: quando precisar consultar um standard específico durante a implementação
 user-invokable: true
-cliVersion: "8.1.1"
+cliVersion: "8.1.2"
 ---
 
 # morph-standards

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@polymorphism-tech/morph-spec",
-  "version": "8.1.1",
+  "version": "8.1.2",
   "description": "MORPH-SPEC: NLH (Natural Language Harness) for spec-driven development with Claude Code",
   "keywords": [
     "claude-code",

package/src/lib/validators/verify-runner.js

@@ -18,7 +18,7 @@
 import { existsSync, readFileSync } from 'fs';
 import { join } from 'path';
 
-import { runBuildCheck, getBuildCommand } from '../../../framework/hooks/shared/build-check.js';
+import { runBuildCheck, getBuildSteps } from '../../../framework/hooks/shared/build-check.js';
 import { runTestSuite, resolveTestCommand } from '../tasks/test-runner.js';
 import { runValidation } from './validation-runner.js';
 import { loadRubric, aggregateScores } from './score-aggregator.js';
@@ -58,12 +58,13 @@ export async function runVerify(projectPath, featureName, taskId, options = {})
   } = options;
 
   const stack = readStack(projectPath);
+  const paths = readProjectPaths(projectPath);
 
   const nodes = {};
   const feedback = [];
 
   // 1. build
-  nodes.build = await runBuildNode({ projectPath, stack, timeout, skipBuild, _runBuildCheck });
+  nodes.build = await runBuildNode({ projectPath, stack, paths, timeout, skipBuild, _runBuildCheck });
   appendBuildFeedback(feedback, nodes.build);
 
   // 2. tests — skipped entirely (no invocation) when build already failed.
@@ -94,20 +95,20 @@ export async function runVerify(projectPath, featureName, taskId, options = {})
 // Build node
 // ============================================================================
 
-async function runBuildNode({ projectPath, stack, timeout, skipBuild, _runBuildCheck }) {
+async function runBuildNode({ projectPath, stack, paths = {}, timeout, skipBuild, _runBuildCheck }) {
   if (skipBuild) {
     return { status: 'skip', command: null, durationMs: 0, reason: 'requested', output: '' };
   }
 
-  const hasTsConfig = existsSync(join(projectPath, 'tsconfig.json'));
-  const command = getBuildCommand(stack, hasTsConfig);
-  if (!command) {
+  const steps = getBuildSteps(stack, { cwd: projectPath, frontendPath: paths.frontendPath, backendPath: paths.backendPath });
+  if (steps.length === 0) {
     const reason = stack ? `no build command for stack "${stack}"` : 'no stack configured';
     return { status: 'skip', command: null, durationMs: 0, reason, output: '' };
   }
+  const command = steps.map((s) => s.command).join(' && ');
 
   const start = Date.now();
-  const result = await _runBuildCheck(projectPath, stack, timeout);
+  const result = await _runBuildCheck(projectPath, stack, timeout, paths);
   const durationMs = Date.now() - start;
 
   return {
@@ -311,6 +312,22 @@ function readStack(projectPath) {
   }
 }
 
+/** Read frontend/backend sub-paths for a monorepo, so the build node can run
+ *  each stack's build command from its own directory instead of assuming a
+ *  single root (see getBuildSteps() in build-check.js). Absent in single-stack
+ *  projects — every consumer treats missing paths as "use projectPath". */
+function readProjectPaths(projectPath) {
+  try {
+    const configPath = join(projectPath, '.morph', 'config', 'config.json');
+    if (!existsSync(configPath)) return {};
+    const config = JSON.parse(readFileSync(configPath, 'utf8'));
+    const { frontendPath, backendPath } = config?.project ?? {};
+    return { frontendPath, backendPath };
+  } catch {
+    return {};
+  }
+}
+
 function linesOf(text) {
   const trimmed = (text || '').trim();
   return trimmed ? trimmed.split('\n') : [];