@polymorphism-tech/morph-spec 4.5.0 → 4.7.0

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

@@ -216,6 +216,11 @@ async function runSingleValidator(validatorId, projectPath, featureName, options
       return await validateDesignSystem(projectPath, featureName, options);
     }
 
+    case 'nextjs-component': {
+      const { validateNextComponentFiles } = await import('./nextjs/next-component-validator.js');
+      return await validateNextComponentFiles(projectPath, options);
+    }
+
     default:
       if (options.verbose) {
         console.log(chalk.gray(`  Unknown validator: ${validatorId}`));

package/src/utils/agents-installer.js

@@ -17,8 +17,12 @@ import { join } from 'path';
  *
  * @param {string} projectDir - Target project directory
  * @param {string} frameworkDir - Path to morph-spec framework/ directory
+ * @param {object} options - Optional settings
+ * @param {string|null} options.projectStack - Detected project stack (e.g. 'nextjs', 'blazor')
  */
-export async function installAgents(projectDir, frameworkDir = 'framework') {
+export async function installAgents(projectDir, frameworkDir = 'framework', options = {}) {
+  const { projectStack = null } = options;
+
   const agentsJsonPath = join(frameworkDir, 'agents.json');
   const agentsJson = JSON.parse(readFileSync(agentsJsonPath, 'utf-8'));
 
@@ -33,7 +37,15 @@ export async function installAgents(projectDir, frameworkDir = 'framework') {
   const targetDir = join(projectDir, '.claude', 'agents');
   mkdirSync(targetDir, { recursive: true });
 
-  const eligible = agents.filter(a => a.tier === 1 || a.tier === 2);
+  const DOTNET_STACKS = ['dotnet', 'blazor', 'dotnet-api', 'fullstack'];
+  const eligible = agents.filter(a => {
+    if (a.tier !== 1 && a.tier !== 2) return false;
+    // Skip dotnet-senior for non-.NET projects
+    if (a.id === 'dotnet-senior' && projectStack && !DOTNET_STACKS.includes(projectStack)) {
+      return false;
+    }
+    return true;
+  });
 
   for (const agent of eligible) {
     const slug = agent.id ?? agent.name?.toLowerCase().replace(/\s+/g, '-');
@@ -171,14 +183,14 @@ export function collectSkillFiles(dir) {
 }
 
 /**
- * Installs level-2-domains skill files as native Claude Code subagents
+ * Installs domain agent files as native Claude Code subagents
  * in .claude/agents/ with memory:project, model:sonnet, maxTurns:20.
  *
  * @param {string} projectDir - Target project directory
  * @param {string} frameworkDir - Path to morph-spec framework/ directory
  */
 export async function installDomainAgents(projectDir, frameworkDir = 'framework') {
-  const domainsDir = join(frameworkDir, 'skills', 'level-2-domains');
+  const domainsDir = join(frameworkDir, 'agents');
   if (!existsSync(domainsDir)) return;
 
   const targetDir = join(projectDir, '.claude', 'agents');

package/src/utils/skills-installer.js

@@ -2,11 +2,18 @@
  * Skills Installer
  *
  * Copies framework skills to .claude/skills/ during morph-spec init.
- * Installs level-0-meta, level-1-workflows, and level-2-domains skills using
- * the native Claude Code subdirectory format: .claude/skills/{skill-name}/SKILL.md
- * so Claude Code can discover them via /<skill-name> syntax.
- * Level-3 and level-4 only contain README.md placeholder files and
- * are intentionally skipped.
+ * Installs level-0-meta and level-1-workflows skills using the native Claude Code
+ * subdirectory format: .claude/skills/{skill-name}/SKILL.md (plus optional
+ * scripts/, references/, and assets/ subdirectories).
+ * Level-2 domain specialists are installed as native subagents via installDomainAgents().
+ * Level-3 and level-4 only contain README.md placeholder files and are skipped.
+ *
+ * Source skills can be either:
+ *   - Directory-based: framework/skills/{level}/{skill-name}/SKILL.md  (preferred)
+ *   - Flat file: framework/skills/{level}/{skill-name}.md               (legacy, still supported)
+ *
+ * Directory-based skills have their entire directory copied (scripts/, references/,
+ * assets/) so Claude Code can execute scripts and load references on demand.
  */
 
 import { mkdirSync, copyFileSync, existsSync, readdirSync, statSync } from 'fs';
@@ -26,15 +33,42 @@ const FRAMEWORK_SKILLS_DIR = join(__dirname, '..', '..', 'framework', 'skills');
 const SKILL_LEVELS_TO_INSTALL = ['level-0-meta', 'level-1-workflows'];
 
 /**
- * Recursively walk srcDir and install each .md skill file (excluding README.md)
- * into destDir using the native Claude Code subdirectory format:
- *   destDir/{skill-name}/SKILL.md
+ * Recursively copy a directory tree from src to dest.
+ * Creates dest if it doesn't exist. Skips README.md files.
+ *
+ * @param {string} src - Source directory path
+ * @param {string} dest - Destination directory path
+ */
+function copyDirectory(src, dest) {
+  mkdirSync(dest, { recursive: true });
+  for (const entry of readdirSync(src)) {
+    if (entry === 'README.md') continue;
+    const srcPath = join(src, entry);
+    const destPath = join(dest, entry);
+    if (statSync(srcPath).isDirectory()) {
+      copyDirectory(srcPath, destPath);
+    } else {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+
+/**
+ * Walk srcDir and install skills into destDir.
+ *
+ * Handles two source formats:
+ *   1. Directory-based skill: srcDir/{skill-name}/SKILL.md
+ *      → copies entire directory (SKILL.md + scripts/ + references/ + assets/)
+ *      → destDir/{skill-name}/
+ *
+ *   2. Flat .md skill (legacy): srcDir/{skill-name}.md
+ *      → destDir/{skill-name}/SKILL.md
  *
- * Each skill file must have a unique name across all subdirectories;
- * duplicate filenames would cause silent overwrites of the SKILL.md inside
- * the subdirectory.
+ * Level directories (level-0-meta, level-1-workflows, sub-categories) are
+ * traversed recursively. A directory is recognized as a skill directory when
+ * it contains a SKILL.md file.
  *
- * @param {string} srcDir - Source directory to walk recursively
+ * @param {string} srcDir - Source directory to walk
  * @param {string} destDir - Destination base directory (.claude/skills/)
  */
 function installSkillsFromDir(srcDir, destDir) {
@@ -44,9 +78,18 @@ function installSkillsFromDir(srcDir, destDir) {
     const stat = statSync(srcPath);
 
     if (stat.isDirectory()) {
-      installSkillsFromDir(srcPath, destDir);
+      const skillMdPath = join(srcPath, 'SKILL.md');
+      if (existsSync(skillMdPath)) {
+        // Directory-based skill — copy entire directory including scripts/, references/, assets/
+        const skillDestDir = join(destDir, entry);
+        copyDirectory(srcPath, skillDestDir);
+      } else {
+        // Level/category directory — recurse
+        installSkillsFromDir(srcPath, destDir);
+      }
     } else if (entry.endsWith('.md') && entry !== 'README.md') {
-      const skillName = entry.slice(0, -3); // strip .md
+      // Legacy flat .md skill — wrap in subdirectory as SKILL.md
+      const skillName = entry.slice(0, -3);
       const skillDir = join(destDir, skillName);
       mkdirSync(skillDir, { recursive: true });
       copyFileSync(srcPath, join(skillDir, 'SKILL.md'));
@@ -58,7 +101,8 @@ function installSkillsFromDir(srcDir, destDir) {
  * Install morph framework skills to .claude/skills/ in the target project.
  * Skills are copied into subdirectories as SKILL.md files so Claude Code can
  * discover them natively via /<skill-name> syntax (e.g., /phase-design,
- * /blazor-builder).
+ * /blazor-builder). Directory-based skills also get their scripts/,
+ * references/, and assets/ subdirectories copied for on-demand loading.
  *
  * @param {string} projectDir - Target project root directory
  */

package/.morph/.morphversion

@@ -1,5 +0,0 @@
-{
-  "morphVersion": "4.4.0",
-  "installedAt": "2026-02-22T05:30:23.083Z",
-  "cliVersion": "4.4.0"
-}

package/.morph/analytics/threads-log.jsonl

@@ -1,44 +0,0 @@
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T04:19:13.804Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T04:32:32.224Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T04:38:49.705Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T04:40:40.242Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T04:40:43.745Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T04:42:19.855Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T04:59:28.383Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:07:53.092Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:08:09.448Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:14:06.092Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:19:45.336Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:19:58.813Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:21:14.483Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:21:26.818Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:24:09.909Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:25:43.672Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:27:36.789Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:27:50.246Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:28:51.618Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:29:07.678Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:29:21.818Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:30:47.980Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T05:32:09.408Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T11:16:53.842Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T16:34:34.819Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T16:34:40.400Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T16:56:39.831Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T16:56:52.757Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T16:57:06.641Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:00:30.000Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:04:19.128Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:06:45.301Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:07:53.055Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:08:05.762Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:09:35.411Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:09:47.946Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:16:01.517Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:16:13.802Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:17:41.413Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:20:34.355Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:20:46.312Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:22:03.137Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:22:14.869Z"}
-{"type":"fusion_started","feature":"test-feature","data":{"count":3,"strategy":"best-of-n","agents":["fusion-agent-1","fusion-agent-2","fusion-agent-3"]},"timestamp":"2026-02-22T17:29:45.187Z"}

package/.morph/config/config.json

@@ -1,8 +0,0 @@
-{
-  "framework": "global",
-  "frameworkVersion": "4.4.0",
-  "project": {
-    "name": "morph-spec-framework",
-    "architecture": "unknown"
-  }
-}

package/.morph/context/README.md

@@ -1,17 +0,0 @@
-# morph-spec-framework - Project Context
-
-## Overview
-
-This file will be auto-updated by MORPH-SPEC detection system.
-
-## Stack
-
-Run `morph-spec detect` to analyze your project.
-
-## Technologies
-
-(To be detected)
-
-## Architecture
-
-(To be detected)