@polymorphism-tech/morph-spec 4.10.2 → 4.10.3

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:** 4.10.2  
+**Version:** 4.10.3  
 **Requires:** Node.js 18+, Claude Code
 
 ---
@@ -376,4 +376,4 @@ Code generated by morph-spec (contracts, templates, implementation output) belon
 
 ---
 
-*morph-spec v4.10.2 by [Polymorphism Tech](https://polymorphism.tech)*
+*morph-spec v4.10.3 by [Polymorphism Tech](https://polymorphism.tech)*

package/claude-plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "morph-spec",
-  "version": "4.10.2",
+  "version": "4.10.3",
   "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

@@ -198,4 +198,4 @@ These files are never edited directly. Use CLI commands or `morph-spec update` i
 
 ---
 
-*morph-spec v4.10.2 by Polymorphism Tech*
+*morph-spec v4.10.3 by Polymorphism Tech*

package/docs/QUICKSTART.md

@@ -203,4 +203,4 @@ morph-spec doctor
 
 ---
 
-*morph-spec v4.10.2 by Polymorphism Tech*
+*morph-spec v4.10.3 by Polymorphism Tech*

package/framework/agents.json

@@ -178,6 +178,7 @@
       "tier": 2,
       "role": "domain-leader",
       "title": "Backend Squad Leader",
+      "stacks": ["dotnet", "blazor"],
       "domains": [
         "backend"
       ],
@@ -249,6 +250,7 @@
       "tier": 2,
       "role": "domain-leader",
       "title": "Infrastructure Squad Leader",
+      "stacks": ["azure", "docker"],
       "domains": [
         "infrastructure"
       ],
@@ -2322,6 +2324,7 @@
       "tier": 4,
       "role": "validator",
       "title": "Blazor Concurrency Validator",
+      "stacks": ["blazor"],
       "domains": [
         "blazor-concurrency"
       ],
@@ -2428,6 +2431,7 @@
     },
     "nextjs-component-validator": {
       "tier": 4,
+      "stacks": ["nextjs"],
       "title": "Next.js Component Validator",
       "description": "Tier-4 validator for Next.js Server/Client component patterns",
       "keywords": [

package/framework/skills/level-1-workflows/morph-phase-clarify/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 3 (Clarify). Iterative clarification loop driven b
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 ---
 
 # MORPH Clarify — Phase 3

package/framework/skills/level-1-workflows/morph-phase-codebase-analysis/SKILL.md

@@ -3,7 +3,7 @@ name: morph:phase-codebase-analysis
 description: MORPH-SPEC Design sub-phase that analyzes existing codebase and database schema, producing schema-analysis.md with real column names, types, relationships, and field mismatches. Use at the start of Design phase before generating contracts.cs to prevent incorrect field names or types.
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 ---
 
 # MORPH Codebase Analysis - Design Sub-phase

package/framework/skills/level-1-workflows/morph-phase-design/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 2 (Design). Schema-first interactive design: reads
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Agent
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 ---
 
 # MORPH Design — Phase 2

package/framework/skills/level-1-workflows/morph-phase-implement/SKILL.md

@@ -6,7 +6,7 @@ disable-model-invocation: true
 context: fork
 agent: general-purpose
 user-invocable: false
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion, Agent
 ---
 

package/framework/skills/level-1-workflows/morph-phase-plan/SKILL.md

@@ -5,7 +5,7 @@ argument-hint: "[feature-name]"
 disable-model-invocation: true
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 ---
 
 # MORPH Plan — Phase 4

package/framework/skills/level-1-workflows/morph-phase-setup/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 1 (Setup). Reads project context, detects tech sta
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 ---
 
 # MORPH Setup — Phase 1
@@ -151,6 +151,26 @@ MCP Readiness:
 
 ---
 
+### Step 2.9: Check for Missing Agents
+
+Run a quick check to verify all expected agents are installed for this project's stack:
+
+```bash
+npx morph-spec doctor 2>&1 | grep -A 1 "agents completeness"
+```
+
+If the output shows **missing agents**, inform the user:
+
+> ⚠ Some agents for your stack are not installed. Run `npx morph-spec init --force` to install them.
+
+Use `AskUserQuestion` with header `"Agents"` and options:
+- **Install now** — run `npx morph-spec init --force` to reinstall with current stack tags
+- **Continue without** — proceed with available agents (may lack specialized support)
+
+If "Install now" is selected, run the command and continue.
+
+---
+
 ### Step 3: Confirm Stack
 
 Based on the proposal and context, confirm:

package/framework/skills/level-1-workflows/morph-phase-tasks/SKILL.md

@@ -5,7 +5,7 @@ argument-hint: "[feature-name]"
 disable-model-invocation: true
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 ---
 
 # MORPH Tasks — Phase 4

package/framework/skills/level-1-workflows/morph-phase-uiux/SKILL.md

@@ -4,7 +4,7 @@ description: MORPH-SPEC Phase 1.5 (UI/UX). Creates design-system.md, mockups.md,
 argument-hint: "[feature-name]"
 user-invocable: false
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
-cliVersion: "4.10.2"
+cliVersion: "4.10.3"
 ---
 
 # MORPH UI/UX Design - Phase 1.5

package/framework/skills/level-1-workflows/morph-scope-escalation/SKILL.md

@@ -4,6 +4,7 @@ description: Guided workflow for mid-implementation scope escalation — analyze
 user-invocable: true
 argument-hint: "[feature-name]"
 allowed-tools: Read, Write, Edit, Bash, Glob, Grep, AskUserQuestion
+cliVersion: "4.10.3"
 ---
 
 # Scope Escalation Workflow

package/package.json

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

package/src/commands/project/doctor.js

@@ -12,6 +12,8 @@ import {
   getInstalledCLIVersion
 } from '../../utils/version-checker.js';
 import { resetMorphSettings } from '../../utils/claude-settings-manager.js';
+import { checkMissingAgents } from '../../utils/agents-installer.js';
+import { getProjectTags } from '../../lib/stack-filter.js';
 
 const isWindows = platform() === 'win32';
 /**
@@ -687,11 +689,32 @@ export async function doctorCommand(options = {}) {
       }
 
       // Check .claude/agents/
-      const agentsPath = join(claudePath, 'agents');
-      if (await pathExists(agentsPath)) {
-        const agentFiles = await fs.readdir(agentsPath);
+      const agentsPathClaude = join(claudePath, 'agents');
+      if (await pathExists(agentsPathClaude)) {
+        const agentFiles = await fs.readdir(agentsPathClaude);
         const morphAgents = agentFiles.filter(f => f.startsWith('morph-') && f.endsWith('.md'));
         checks.push({ name: '.claude/agents/', status: 'ok', msg: `${morphAgents.length} agents` });
+
+        // Check for missing agents based on stack tags
+        try {
+          const config = await readJson(configPath);
+          const projectTags = getProjectTags(config);
+          if (projectTags.length > 0) {
+            const frameworkDir = join(import.meta.dirname, '..', '..', '..', 'framework');
+            const { missing } = checkMissingAgents(targetPath, frameworkDir, projectTags);
+            if (missing.length > 0) {
+              const names = missing.map(m => m.name).join(', ');
+              checks.push({
+                name: 'agents completeness',
+                status: 'warn',
+                msg: `${missing.length} agent(s) missing for [${projectTags.join(', ')}]: ${names} — run morph-spec init --force`
+              });
+              hasWarnings = true;
+            } else {
+              checks.push({ name: 'agents completeness', status: 'ok', msg: `all agents for [${projectTags.join(', ')}]` });
+            }
+          }
+        } catch { /* config not readable — skip completeness check */ }
       } else {
         checks.push({ name: '.claude/agents/', status: 'warn', msg: 'missing — run morph-spec update' });
         hasWarnings = true;

package/src/commands/project/init.js

@@ -1,4 +1,5 @@
-import { join } from 'path';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
 import { homedir } from 'os';
 import fs from 'fs-extra';
 import ora from 'ora';
@@ -22,7 +23,10 @@ import {
   generateSetupInstructions,
   formatMcpStatusTable
 } from '../../lib/installers/mcp-installer.js';
-import { setupInfra } from '../../scripts/setup-infra.js';
+import { setupInfra, installRulesForStack } from '../../scripts/setup-infra.js';
+import { installSkills } from '../../utils/skills-installer.js';
+import { installAgents, installDomainAgents } from '../../utils/agents-installer.js';
+import { getProjectTags } from '../../lib/stack-filter.js';
 
 export async function initCommand(options) {
   const targetPath = options.path || process.cwd();
@@ -147,6 +151,9 @@ export async function initCommand(options) {
           if (structure?.uiLibrary) {
             config.project.uiLibrary = structure.uiLibrary;
           }
+          if (structure?.integrations?.length > 0) {
+            config.project.integrations = structure.integrations;
+          }
           await writeJson(configPath, config);
 
           spinner.stop();
@@ -155,6 +162,7 @@ export async function initCommand(options) {
           logger.info(`Stack detected: ${structure.stack}`);
           if (structure?.architecture) logger.dim(`Architecture: ${structure.architecture}`);
           if (structure?.uiLibrary) logger.dim(`UI Library: ${structure.uiLibrary}`);
+          if (structure?.integrations?.length > 0) logger.dim(`Integrations: ${structure.integrations.join(', ')}`);
 
           const { standardsChoice } = await inquirer.prompt([{
             type: 'list',
@@ -175,6 +183,28 @@ export async function initCommand(options) {
             logger.dim('Review and edit .morph/context/standards.md as needed.');
           }
 
+          // Re-install stack-filtered assets now that we know the stack
+          const stackTags = getProjectTags(config);
+          if (stackTags.length > 0) {
+            spinner.start('Re-installing stack-filtered assets...');
+            const frameworkDir = join(targetPath, '.morph', 'framework');
+            const fwSrcDir = join(dirname(fileURLToPath(import.meta.url)), '..', '..', '..', 'framework');
+
+            // Rules
+            const rulesSrc = join(fwSrcDir, 'rules');
+            const rulesDest = join(targetPath, '.claude', 'rules');
+            installRulesForStack(rulesSrc, rulesDest, stackTags);
+
+            // Skills
+            await installSkills(targetPath, { projectTags: stackTags });
+
+            // Agents (tier 1/2/4 from agents.json + domain agents)
+            await installAgents(targetPath, fwSrcDir, { projectTags: stackTags });
+            await installDomainAgents(targetPath, fwSrcDir, { projectTags: stackTags });
+
+            spinner.succeed(`Stack-filtered assets reinstalled for [${stackTags.join(', ')}]`);
+          }
+
           spinner.start('Continuing...');
         }
       } catch (error) {

package/src/lib/detectors/index.js

@@ -86,29 +86,39 @@ export function detectProject(targetPath, opts = {}) {
     }
 
     // ── .csproj detection ──────────────────────────────────────────────────
-    if (structure.stack === 'unknown') {
-      // Check for .csproj in common locations
-      const csprojLocations = ['.', 'src', 'src/Api', 'src/Web'];
-      for (const loc of csprojLocations) {
-        try {
-          const dir = join(targetPath, loc);
-          if (existsSync(dir)) {
-            const entries = readdirSyncSafe(dir);
-            if (entries.some(e => e.endsWith('.csproj'))) {
-              structure.stack = 'dotnet';
-              // Check for Blazor
-              for (const entry of entries.filter(e => e.endsWith('.csproj'))) {
-                try {
-                  const content = readFileSync(join(dir, entry), 'utf8');
-                  if (content.includes('Microsoft.AspNetCore.Components') || content.includes('Blazor')) {
-                    structure.stack = 'blazor';
-                  }
-                } catch { /* ignore */ }
+    let hasDotnet = false;
+    let hasBlazer = false;
+    const csprojLocations = ['.', 'src', 'src/Api', 'src/Web', 'src/backend'];
+    for (const loc of csprojLocations) {
+      try {
+        const dir = join(targetPath, loc);
+        if (existsSync(dir)) {
+          const entries = readdirSyncSafe(dir);
+          for (const entry of entries.filter(e => e.endsWith('.csproj'))) {
+            hasDotnet = true;
+            try {
+              const content = readFileSync(join(dir, entry), 'utf8');
+              if (content.includes('Microsoft.AspNetCore.Components') || content.includes('Blazor')) {
+                hasBlazer = true;
+              }
+              if (content.includes('Hangfire')) {
+                if (!structure.integrations.includes('hangfire')) structure.integrations.push('hangfire');
               }
-              break;
-            }
+            } catch { /* ignore */ }
           }
-        } catch { /* ignore */ }
+        }
+      } catch { /* ignore */ }
+    }
+
+    // Determine stack: monorepo (nextjs+dotnet), blazor, dotnet, or keep frontend stack
+    if (hasDotnet) {
+      if (structure.stack === 'nextjs' || structure.stack === 'react' || structure.stack === 'vue') {
+        // Monorepo: frontend + .NET backend
+        structure.stack = `${structure.stack}+dotnet`;
+      } else if (hasBlazer) {
+        structure.stack = 'blazor';
+      } else if (structure.stack === 'unknown') {
+        structure.stack = 'dotnet';
       }
     }
 
@@ -137,7 +147,27 @@ export function detectProject(targetPath, opts = {}) {
     if (existsSync(join(targetPath, 'docker-compose.yml')) ||
         existsSync(join(targetPath, 'docker-compose.yaml')) ||
         existsSync(join(targetPath, 'Dockerfile'))) {
-      structure.integrations.push('docker');
+      if (!structure.integrations.includes('docker')) structure.integrations.push('docker');
+    }
+
+    // ── Azure detection ────────────────────────────────────────────────────
+    const azureSignals = [
+      '.azure',
+      'azure-pipelines.yml',
+      'infra/main.bicep',
+      'infra',
+    ];
+    const hasAzure = azureSignals.some(signal => {
+      const p = join(targetPath, signal);
+      if (!existsSync(p)) return false;
+      if (signal === 'infra') {
+        // Check for .bicep files inside infra/
+        return readdirSyncSafe(p).some(f => f.endsWith('.bicep'));
+      }
+      return true;
+    });
+    if (hasAzure && !structure.integrations.includes('azure')) {
+      structure.integrations.push('azure');
     }
   } catch {
     // Fail-safe — return defaults

package/src/lib/stack-filter.js

@@ -37,13 +37,20 @@ export function parseStacks(content) {
 }
 
 /**
- * Extract project stack tags from config object.
- * Splits `project.stack` by '-' or '+' to produce tag array.
+ * Extract project tags from config object.
+ * Combines stack tags (from `project.stack` split by '-' or '+')
+ * with integration tags (from `project.integrations` array).
+ * Deduplicates the result.
  */
 export function getProjectTags(config) {
   const stack = config?.project?.stack;
-  if (!stack || typeof stack !== 'string') return [];
-  return stack.split(/[-+]/).filter(Boolean);
+  const stackTags = (stack && typeof stack === 'string')
+    ? stack.split(/[-+]/).filter(Boolean)
+    : [];
+  const integrations = Array.isArray(config?.project?.integrations)
+    ? config.project.integrations
+    : [];
+  return [...new Set([...stackTags, ...integrations])];
 }
 
 /**

package/src/scripts/setup-infra.js

@@ -212,7 +212,7 @@ export async function setupInfra(targetPath, { _exec = execSync } = {}) {
 
   // --- 12. installAgents ---
   log('Step 12: Installing agents...');
-  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectStack: null });
+  const agentCounts = await installAgents(targetPath, FRAMEWORK_DIR, { projectTags });
 
   // --- 13. installDomainAgents (filtered by stack) ---
   log('Step 13: Installing domain agents...');

package/src/utils/agents-installer.js

@@ -22,7 +22,7 @@ import { parseStacks, shouldInstall } from '../lib/stack-filter.js';
  * @param {string|null} options.projectStack - Detected project stack (e.g. 'nextjs', 'blazor')
  */
 export async function installAgents(projectDir, frameworkDir = 'framework', options = {}) {
-  const { projectStack = null } = options;
+  const { projectTags = [] } = options;
 
   const agentsJsonPath = join(frameworkDir, 'agents.json');
   const agentsJson = JSON.parse(readFileSync(agentsJsonPath, 'utf-8'));
@@ -38,21 +38,30 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
   const targetDir = join(projectDir, '.claude', 'agents');
   mkdirSync(targetDir, { recursive: true });
 
-  const DOTNET_STACKS = ['dotnet', 'blazor', 'dotnet-api', 'fullstack'];
   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;
-    // Skip dotnet-senior for non-.NET projects
-    if (a.id === 'dotnet-senior' && projectStack && !DOTNET_STACKS.includes(projectStack)) {
-      return false;
-    }
+    // Filter by stacks if the agent declares them
+    const stacks = a.stacks ?? [];
+    if (!shouldInstall(stacks, projectTags)) return false;
     return true;
   });
 
   let tier1 = 0;
   let tier2 = 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;
+    const slug = a.id ?? a.name?.toLowerCase().replace(/\s+/g, '-');
+    const prefix = a.tier === 4 ? 'morph-validator-' : 'morph-';
+    allPossible.add(`${prefix}${slug}.md`);
+  }
+
   for (const agent of eligible) {
     const slug = agent.id ?? agent.name?.toLowerCase().replace(/\s+/g, '-');
     const prefix = agent.tier === 4 ? 'morph-validator-' : 'morph-';
@@ -65,11 +74,20 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
     const frontmatter = buildFrontmatter(agent, description);
     const content = `---\n${frontmatter}---\n\n${body}\n`;
     writeFileSync(targetPath, content, 'utf-8');
+    installed.add(filename);
 
     if (agent.tier === 1) tier1++;
     else if (agent.tier === 2) tier2++;
     else if (agent.tier === 4) tier4++;
   }
+
+  // Cleanup orphan morph-* / morph-validator-* files that were filtered out
+  for (const file of readdirSync(targetDir)) {
+    if (allPossible.has(file) && !installed.has(file)) {
+      unlinkSync(join(targetDir, file));
+    }
+  }
+
   return { tier1, tier2, tier4 };
 }
 
@@ -259,3 +277,69 @@ export async function installDomainAgents(projectDir, frameworkDir = 'framework'
 
   return { specialists };
 }
+
+/**
+ * Check which agents SHOULD be installed but are NOT.
+ * Returns a list of missing agent names with their source (agents.json or domain).
+ *
+ * @param {string} projectDir - Target project directory
+ * @param {string} frameworkDir - Path to morph-spec framework/ directory
+ * @param {string[]} projectTags - Stack + integration tags
+ * @returns {{ missing: Array<{ name: string, stacks: string[], source: string }>, installed: number, expected: number }}
+ */
+export function checkMissingAgents(projectDir, frameworkDir, projectTags = []) {
+  const targetDir = join(projectDir, '.claude', 'agents');
+  const installedFiles = new Set();
+  if (existsSync(targetDir)) {
+    for (const f of readdirSync(targetDir)) installedFiles.add(f);
+  }
+
+  const missing = [];
+  let expected = 0;
+
+  // Check tier 1/2/4 from agents.json
+  const agentsJsonPath = join(frameworkDir, 'agents.json');
+  if (existsSync(agentsJsonPath)) {
+    const agentsJson = JSON.parse(readFileSync(agentsJsonPath, 'utf-8'));
+    const agentsRaw = agentsJson.agents ?? agentsJson;
+    const agents = Array.isArray(agentsRaw)
+      ? agentsRaw
+      : Object.entries(agentsRaw)
+          .filter(([key]) => !key.startsWith('_comment'))
+          .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;
+      const stacks = a.stacks ?? [];
+      if (!shouldInstall(stacks, projectTags)) continue;
+
+      expected++;
+      const slug = a.id ?? a.name?.toLowerCase().replace(/\s+/g, '-');
+      const prefix = a.tier === 4 ? 'morph-validator-' : 'morph-';
+      const filename = `${prefix}${slug}.md`;
+      if (!installedFiles.has(filename)) {
+        missing.push({ name: a.title ?? slug, stacks, source: `tier-${a.tier}` });
+      }
+    }
+  }
+
+  // Check domain agents
+  const domainsDir = join(frameworkDir, 'agents');
+  if (existsSync(domainsDir)) {
+    for (const filePath of collectSkillFiles(domainsDir)) {
+      const raw = readFileSync(filePath, 'utf-8');
+      const { name, stacks } = parseSkillFile(raw);
+      if (!name) continue;
+      if (!shouldInstall(stacks, projectTags)) continue;
+
+      expected++;
+      const filename = `morph-domain-${name}.md`;
+      if (!installedFiles.has(filename)) {
+        missing.push({ name, stacks, source: 'domain' });
+      }
+    }
+  }
+
+  return { missing, installed: installedFiles.size, expected };
+}