@polymorphism-tech/morph-spec 4.10.6 → 4.10.8

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

@@ -20,6 +20,15 @@ const DOTNET_ONLY_VALIDATORS = new Set([
   'blazor-state', 'contract-compliance'
 ]);
 
+/**
+ * Heavy validators skipped in 'light' mode (checkpoint-only).
+ * Light mode runs only spec, content, and stack-specific lightweight validators.
+ */
+const HEAVY_VALIDATORS = new Set([
+  'architecture', 'packages', 'contract-compliance',
+  'blazor-concurrency', 'css', 'design-system'
+]);
+
 /**
  * Load agent → validators map from agents.json (data-driven)
  * @param {string} projectPath - Root path of the project
@@ -74,6 +83,17 @@ export async function runValidation(projectPath, featureName, options = {}) {
   // Determine which validators to run
   const validatorIds = options.validators || detectValidators(featureName, projectPath);
 
+  // Filter by mode: 'light' skips heavy validators, 'full' (default) runs all
+  const mode = options.mode || 'full';
+  if (mode === 'light') {
+    const beforeCount = validatorIds.length;
+    for (let i = validatorIds.length - 1; i >= 0; i--) {
+      if (HEAVY_VALIDATORS.has(validatorIds[i])) {
+        validatorIds.splice(i, 1);
+      }
+    }
+  }
+
   // Merge constraint-enabled validators
   validatorIds.push(...constraints.enabledValidators);
 

package/src/scripts/global-install.js

@@ -1,58 +1,58 @@
-// src/scripts/global-install.js
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import { homedir } from 'os';
-import { mkdir, copyFile } from 'fs/promises';
-import { existsSync } from 'fs';
-import { installGlobalStatusline } from '../utils/hooks-installer.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const FRAMEWORK_DIR = join(__dirname, '..', '..', 'framework');
-
-/**
- * Install morph-init skill to a Claude global skills directory.
- * @param {string} claudeDir - target ~/.claude dir (defaults to real ~/.claude)
- */
-export async function installGlobalSkill(claudeDir = join(homedir(), '.claude')) {
-  const src = join(FRAMEWORK_DIR, 'skills', 'level-0-meta', 'morph-init', 'SKILL.md');
-  const destDir = join(claudeDir, 'skills', 'morph-init');
-  const dest = join(destDir, 'SKILL.md');
-
-  if (!existsSync(src)) {
-    console.warn(`morph-init skill not found at ${src} — skipping global install`);
-    return;
-  }
-
-  await mkdir(destDir, { recursive: true });
-  await copyFile(src, dest);
-}
-
-// Run as postinstall script
-if (process.argv[1] === fileURLToPath(import.meta.url)) {
-  const HOOKS_SRC = join(FRAMEWORK_DIR, 'hooks', 'claude-code');
-  const { readFileSync } = await import('fs');
-  const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
-
-  const [skillResult, statuslineResult] = await Promise.allSettled([
-    installGlobalSkill(),
-    installGlobalStatusline(HOOKS_SRC),
-  ]);
-
-  const results = [
-    {
-      ok: skillResult.status === 'fulfilled',
-      label: 'morph-init skill',
-      path: '~/.claude/skills/',
-      error: skillResult.reason?.message,
-    },
-    {
-      ok: statuslineResult.status === 'fulfilled',
-      label: 'statusline',
-      path: '~/.claude/',
-      error: statuslineResult.reason?.message,
-    },
-  ];
-
-  const { printInstallBanner } = await import('../utils/banner.js');
-  printInstallBanner({ version: pkg.version, nodeVersion: process.version, results });
-}
+// src/scripts/global-install.js
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { homedir } from 'os';
+import { mkdir, copyFile } from 'fs/promises';
+import { existsSync } from 'fs';
+import { installGlobalStatusline } from '../utils/hooks-installer.js';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const FRAMEWORK_DIR = join(__dirname, '..', '..', 'framework');
+
+/**
+ * Install morph-init skill to a Claude global skills directory.
+ * @param {string} claudeDir - target ~/.claude dir (defaults to real ~/.claude)
+ */
+export async function installGlobalSkill(claudeDir = join(homedir(), '.claude')) {
+  const src = join(FRAMEWORK_DIR, 'skills', 'level-0-meta', 'morph-init', 'SKILL.md');
+  const destDir = join(claudeDir, 'skills', 'morph-init');
+  const dest = join(destDir, 'SKILL.md');
+
+  if (!existsSync(src)) {
+    console.warn(`morph-init skill not found at ${src} — skipping global install`);
+    return;
+  }
+
+  await mkdir(destDir, { recursive: true });
+  await copyFile(src, dest);
+}
+
+// Run as postinstall script
+if (process.argv[1] === fileURLToPath(import.meta.url)) {
+  const HOOKS_SRC = join(FRAMEWORK_DIR, 'hooks', 'claude-code');
+  const { readFileSync } = await import('fs');
+  const pkg = JSON.parse(readFileSync(new URL('../../package.json', import.meta.url), 'utf8'));
+
+  const [skillResult, statuslineResult] = await Promise.allSettled([
+    installGlobalSkill(),
+    installGlobalStatusline(HOOKS_SRC),
+  ]);
+
+  const results = [
+    {
+      ok: skillResult.status === 'fulfilled',
+      label: 'morph-init skill',
+      path: '~/.claude/skills/',
+      error: skillResult.reason?.message,
+    },
+    {
+      ok: statuslineResult.status === 'fulfilled',
+      label: 'statusline',
+      path: '~/.claude/',
+      error: statuslineResult.reason?.message,
+    },
+  ];
+
+  const { printInstallBanner } = await import('../utils/banner.js');
+  printInstallBanner({ version: pkg.version, nodeVersion: process.version, results });
+}

package/src/scripts/install-plugin.js

@@ -1,126 +1,126 @@
-// src/scripts/install-plugin.js
-import { join } from 'path';
-import { homedir } from 'os';
-import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
-import { mkdir, writeFile } from 'fs/promises';
-import https from 'node:https';
-
-const PLUGINS_DIR = join(homedir(), '.claude', 'plugins');
-const CACHE_DIR = join(PLUGINS_DIR, 'cache', 'claude-plugins-official');
-const INSTALLED_FILE = join(PLUGINS_DIR, 'installed_plugins.json');
-const GH_REPO = 'anthropics/claude-plugins-official';
-
-/** Fetch JSON from GitHub API (no auth — public repo) */
-async function fetchGitHub(path) {
-  return new Promise((resolve, reject) => {
-    const opts = {
-      hostname: 'api.github.com',
-      path,
-      headers: { 'User-Agent': 'morph-spec', 'Accept': 'application/vnd.github.v3+json' }
-    };
-    https.get(opts, (res) => {
-      let data = '';
-      res.on('data', c => data += c);
-      res.on('end', () => {
-        try { resolve(JSON.parse(data)); }
-        catch (e) { reject(new Error(`GitHub API parse error: ${data.slice(0, 200)}`)); }
-      });
-    }).on('error', reject);
-  });
-}
-
-/** Download raw file content from a URL, following one redirect */
-async function downloadFile(rawUrl) {
-  return new Promise((resolve, reject) => {
-    const doGet = (url) => {
-      const parsed = new URL(url);
-      https.get({
-        hostname: parsed.hostname,
-        path: parsed.pathname + parsed.search,
-        headers: { 'User-Agent': 'morph-spec' }
-      }, (res) => {
-        if (res.statusCode === 301 || res.statusCode === 302) {
-          return doGet(res.headers.location);
-        }
-        const chunks = [];
-        res.on('data', c => chunks.push(c));
-        res.on('end', () => resolve(Buffer.concat(chunks)));
-      }).on('error', reject);
-    };
-    doGet(rawUrl);
-  });
-}
-
-/** Read installed_plugins.json safely */
-export function readInstalledPlugins() {
-  if (!existsSync(INSTALLED_FILE)) return { version: 2, plugins: {} };
-  try { return JSON.parse(readFileSync(INSTALLED_FILE, 'utf8')); }
-  catch { return { version: 2, plugins: {} }; }
-}
-
-/** Check if plugin key exists in the plugins map */
-export function isPluginInstalled(plugins, name) {
-  return `${name}@claude-plugins-official` in plugins;
-}
-
-/** Build an installed_plugins.json entry */
-export function buildInstallEntry(pluginName, installPath, gitCommitSha, version) {
-  const now = new Date().toISOString();
-  return { scope: 'user', installPath, version, installedAt: now, lastUpdated: now, gitCommitSha };
-}
-
-/** Resolve latest commit SHA for a plugin path in the repo */
-export async function resolvePluginVersion(pluginName) {
-  const commits = await fetchGitHub(`/repos/${GH_REPO}/commits?path=${pluginName}&per_page=1`);
-  if (!Array.isArray(commits) || commits.length === 0) {
-    throw new Error(`Could not resolve version for plugin: ${pluginName}`);
-  }
-  const sha = commits[0].sha;
-  return { sha, shortSha: sha.slice(0, 12) };
-}
-
-/** Download all files for a plugin from the repo tree */
-async function downloadPluginFiles(pluginName, sha, destDir) {
-  const tree = await fetchGitHub(`/repos/${GH_REPO}/git/trees/${sha}?recursive=1`);
-  if (!tree.tree) throw new Error('GitHub tree API returned unexpected shape');
-
-  const pluginFiles = tree.tree.filter(f => f.path.startsWith(`${pluginName}/`) && f.type === 'blob');
-  if (pluginFiles.length === 0) throw new Error(`Plugin "${pluginName}" not found in repository`);
-
-  for (const file of pluginFiles) {
-    const relativePath = file.path.slice(pluginName.length + 1);
-    const destPath = join(destDir, relativePath);
-    await mkdir(join(destPath, '..'), { recursive: true });
-    const content = await downloadFile(
-      `https://raw.githubusercontent.com/${GH_REPO}/${sha}/${file.path}`
-    );
-    await writeFile(destPath, content);
-  }
-}
-
-/**
- * Install a Claude Code plugin from GitHub.
- * @param {string} pluginName - e.g. "superpowers"
- * @returns {{ installed: boolean, version: string, alreadyInstalled: boolean }}
- */
-export async function installPlugin(pluginName) {
-  const data = readInstalledPlugins();
-  if (isPluginInstalled(data.plugins, pluginName)) {
-    const existing = data.plugins[`${pluginName}@claude-plugins-official`];
-    const version = Array.isArray(existing) ? existing[0]?.version : 'unknown';
-    return { installed: true, alreadyInstalled: true, version };
-  }
-
-  const { sha, shortSha } = await resolvePluginVersion(pluginName);
-  const installPath = join(CACHE_DIR, pluginName, shortSha);
-
-  await mkdir(installPath, { recursive: true });
-  await downloadPluginFiles(pluginName, sha, installPath);
-
-  const entry = buildInstallEntry(pluginName, installPath, sha, shortSha);
-  data.plugins[`${pluginName}@claude-plugins-official`] = [entry];
-  mkdirSync(PLUGINS_DIR, { recursive: true });
-  writeFileSync(INSTALLED_FILE, JSON.stringify(data, null, 2));
-
-  return { installed: true, alreadyInstalled: false, version: shortSha };
-}
+// src/scripts/install-plugin.js
+import { join } from 'path';
+import { homedir } from 'os';
+import { existsSync, mkdirSync, writeFileSync, readFileSync } from 'fs';
+import { mkdir, writeFile } from 'fs/promises';
+import https from 'node:https';
+
+const PLUGINS_DIR = join(homedir(), '.claude', 'plugins');
+const CACHE_DIR = join(PLUGINS_DIR, 'cache', 'claude-plugins-official');
+const INSTALLED_FILE = join(PLUGINS_DIR, 'installed_plugins.json');
+const GH_REPO = 'anthropics/claude-plugins-official';
+
+/** Fetch JSON from GitHub API (no auth — public repo) */
+async function fetchGitHub(path) {
+  return new Promise((resolve, reject) => {
+    const opts = {
+      hostname: 'api.github.com',
+      path,
+      headers: { 'User-Agent': 'morph-spec', 'Accept': 'application/vnd.github.v3+json' }
+    };
+    https.get(opts, (res) => {
+      let data = '';
+      res.on('data', c => data += c);
+      res.on('end', () => {
+        try { resolve(JSON.parse(data)); }
+        catch (e) { reject(new Error(`GitHub API parse error: ${data.slice(0, 200)}`)); }
+      });
+    }).on('error', reject);
+  });
+}
+
+/** Download raw file content from a URL, following one redirect */
+async function downloadFile(rawUrl) {
+  return new Promise((resolve, reject) => {
+    const doGet = (url) => {
+      const parsed = new URL(url);
+      https.get({
+        hostname: parsed.hostname,
+        path: parsed.pathname + parsed.search,
+        headers: { 'User-Agent': 'morph-spec' }
+      }, (res) => {
+        if (res.statusCode === 301 || res.statusCode === 302) {
+          return doGet(res.headers.location);
+        }
+        const chunks = [];
+        res.on('data', c => chunks.push(c));
+        res.on('end', () => resolve(Buffer.concat(chunks)));
+      }).on('error', reject);
+    };
+    doGet(rawUrl);
+  });
+}
+
+/** Read installed_plugins.json safely */
+export function readInstalledPlugins() {
+  if (!existsSync(INSTALLED_FILE)) return { version: 2, plugins: {} };
+  try { return JSON.parse(readFileSync(INSTALLED_FILE, 'utf8')); }
+  catch { return { version: 2, plugins: {} }; }
+}
+
+/** Check if plugin key exists in the plugins map */
+export function isPluginInstalled(plugins, name) {
+  return `${name}@claude-plugins-official` in plugins;
+}
+
+/** Build an installed_plugins.json entry */
+export function buildInstallEntry(pluginName, installPath, gitCommitSha, version) {
+  const now = new Date().toISOString();
+  return { scope: 'user', installPath, version, installedAt: now, lastUpdated: now, gitCommitSha };
+}
+
+/** Resolve latest commit SHA for a plugin path in the repo */
+export async function resolvePluginVersion(pluginName) {
+  const commits = await fetchGitHub(`/repos/${GH_REPO}/commits?path=${pluginName}&per_page=1`);
+  if (!Array.isArray(commits) || commits.length === 0) {
+    throw new Error(`Could not resolve version for plugin: ${pluginName}`);
+  }
+  const sha = commits[0].sha;
+  return { sha, shortSha: sha.slice(0, 12) };
+}
+
+/** Download all files for a plugin from the repo tree */
+async function downloadPluginFiles(pluginName, sha, destDir) {
+  const tree = await fetchGitHub(`/repos/${GH_REPO}/git/trees/${sha}?recursive=1`);
+  if (!tree.tree) throw new Error('GitHub tree API returned unexpected shape');
+
+  const pluginFiles = tree.tree.filter(f => f.path.startsWith(`${pluginName}/`) && f.type === 'blob');
+  if (pluginFiles.length === 0) throw new Error(`Plugin "${pluginName}" not found in repository`);
+
+  for (const file of pluginFiles) {
+    const relativePath = file.path.slice(pluginName.length + 1);
+    const destPath = join(destDir, relativePath);
+    await mkdir(join(destPath, '..'), { recursive: true });
+    const content = await downloadFile(
+      `https://raw.githubusercontent.com/${GH_REPO}/${sha}/${file.path}`
+    );
+    await writeFile(destPath, content);
+  }
+}
+
+/**
+ * Install a Claude Code plugin from GitHub.
+ * @param {string} pluginName - e.g. "superpowers"
+ * @returns {{ installed: boolean, version: string, alreadyInstalled: boolean }}
+ */
+export async function installPlugin(pluginName) {
+  const data = readInstalledPlugins();
+  if (isPluginInstalled(data.plugins, pluginName)) {
+    const existing = data.plugins[`${pluginName}@claude-plugins-official`];
+    const version = Array.isArray(existing) ? existing[0]?.version : 'unknown';
+    return { installed: true, alreadyInstalled: true, version };
+  }
+
+  const { sha, shortSha } = await resolvePluginVersion(pluginName);
+  const installPath = join(CACHE_DIR, pluginName, shortSha);
+
+  await mkdir(installPath, { recursive: true });
+  await downloadPluginFiles(pluginName, sha, installPath);
+
+  const entry = buildInstallEntry(pluginName, installPath, sha, shortSha);
+  data.plugins[`${pluginName}@claude-plugins-official`] = [entry];
+  mkdirSync(PLUGINS_DIR, { recursive: true });
+  writeFileSync(INSTALLED_FILE, JSON.stringify(data, null, 2));
+
+  return { installed: true, alreadyInstalled: false, version: shortSha };
+}

package/src/scripts/setup-infra.js

@@ -27,7 +27,7 @@ import {
 import { parseStacks, getProjectTags, shouldInstall } from '../lib/stack-filter.js';
 import { injectMorphImport } from '../utils/claude-md-injector.js';
 import { saveProjectMorphVersion, getInstalledCLIVersion } from '../utils/version-checker.js';
-import { installClaudeHooks, installGlobalStatusline, installVSCodeTerminalSettings, installShellIntegration } from '../utils/claude-settings-manager.js';
+import { installClaudeHooks, installGlobalStatusline } from '../utils/claude-settings-manager.js';
 import { installSkills } from '../utils/skills-installer.js';
 import { installAgents, installDomainAgents } from '../utils/agents-installer.js';
 
@@ -238,22 +238,6 @@ export async function setupInfra(targetPath, { _exec = execSync } = {}) {
   log('Step 16: Installing Claude Code hooks...');
   await installClaudeHooks(targetPath);
 
-  // --- 16a. installShellIntegration (non-critical) ---
-  log('Step 16a: Installing shell integration...');
-  try {
-    await installShellIntegration();
-  } catch {
-    // Non-critical — shell profile may not be writable
-  }
-
-  // --- 16b. installVSCodeTerminalSettings (non-critical) ---
-  log('Step 16b: Configuring VS Code terminal settings...');
-  try {
-    await installVSCodeTerminalSettings();
-  } catch {
-    // Non-critical — VS Code settings may not be present
-  }
-
   // --- 17. saveProjectMorphVersion ---
   log('Step 17: Saving version info...');
   const cliVersion = getInstalledCLIVersion();

package/src/utils/agent-id-mapper.js

@@ -0,0 +1,11 @@
+/**
+ * Map an agents.json ID to the Claude Code subagent_type.
+ *
+ * @param {string} id - Agent ID from agents.json (e.g., "nextjs-expert")
+ * @param {number} [tier] - Agent tier (1-4). Defaults to non-validator.
+ * @returns {string} subagent_type matching .claude/agents/ filename stem
+ */
+export function agentIdToSubagentType(id, tier) {
+  const prefix = tier === 4 ? 'morph-validator-' : 'morph-';
+  return `${prefix}${id}`;
+}

package/src/utils/agents-installer.js

@@ -8,7 +8,7 @@
  * maxTurns, skills, memory) followed by the agent's spawn prompt as the body.
  */
 
-import { readFileSync, writeFileSync, mkdirSync, existsSync, readdirSync, statSync, unlinkSync } from 'node:fs';
+import { readFileSync, writeFileSync, appendFileSync, mkdirSync, existsSync, readdirSync, statSync, unlinkSync } from 'node:fs';
 import { join } from 'path';
 import { parseStacks, shouldInstall } from '../lib/stack-filter.js';
 
@@ -88,6 +88,13 @@ export async function installAgents(projectDir, frameworkDir = 'framework', opti
     if (allPossible.has(file) && !installed.has(file)) {
       unlinkSync(join(targetDir, file));
     }
+    // Remove morph-domain-{name}.md when morph-{name}.md was installed from agents.json
+    if (file.startsWith('morph-domain-')) {
+      const suffix = file.slice('morph-domain-'.length);
+      if (installed.has(`morph-${suffix}`)) {
+        unlinkSync(join(targetDir, file));
+      }
+    }
   }
 
   return { tier1, tier2, tier3, tier4 };
@@ -170,6 +177,19 @@ function buildDescription(agent) {
   return base.length > 200 ? base.slice(0, 197) + '...' : base;
 }
 
+/**
+ * Serialize an AgentStandard to a readable markdown line.
+ *
+ * @param {string|{id: string, scope?: string, priority?: string}} standard
+ * @returns {string} e.g., "- core-coding (all, required)" or "- core-coding"
+ */
+export function formatStandardRef(standard) {
+  if (typeof standard === 'string') return `- ${standard}`;
+  const id = standard.id || String(standard);
+  const parts = [standard.scope, standard.priority].filter(Boolean);
+  return parts.length > 0 ? `- ${id} (${parts.join(', ')})` : `- ${id}`;
+}
+
 function buildBody(agent) {
   const lines = [];
   if (agent.teammate?.spawn_prompt) {
@@ -181,7 +201,7 @@ function buildBody(agent) {
     }
   }
   if (agent.standards?.length) {
-    lines.push(`\n## Standards to Reference\n${agent.standards.map(s => `- ${s}`).join('\n')}`);
+    lines.push(`\n## Standards to Reference\n${agent.standards.map(formatStandardRef).join('\n')}`);
   }
   return lines.join('\n');
 }
@@ -270,11 +290,19 @@ export async function installDomainAgents(projectDir, frameworkDir = 'framework'
       '',
     ].join('\n');
 
-    const filename = `morph-domain-${name}.md`;
-    const targetPath = join(targetDir, filename);
-    writeFileSync(targetPath, `---\n${frontmatter}---\n\n${body.trimStart()}`, 'utf-8');
-    installed.add(filename);
-    specialists++;
+    // If agents.json already generated morph-{name}.md, append domain content there
+    const agentsJsonFile = `morph-${name}.md`;
+    const agentsJsonPath = join(targetDir, agentsJsonFile);
+    if (existsSync(agentsJsonPath)) {
+      appendFileSync(agentsJsonPath, `\n\n---\n\n## Domain Knowledge\n\n${body.trimStart()}`, 'utf-8');
+      specialists++;
+    } else {
+      const filename = `morph-domain-${name}.md`;
+      const targetPath = join(targetDir, filename);
+      writeFileSync(targetPath, `---\n${frontmatter}---\n\n${body.trimStart()}`, 'utf-8');
+      installed.add(filename);
+      specialists++;
+    }
   }
 
   // Cleanup orphan morph-domain-* files
@@ -333,7 +361,7 @@ export function checkMissingAgents(projectDir, frameworkDir, projectTags = []) {
     }
   }
 
-  // Check domain agents
+  // Check domain agents (skip if merged into agents.json entry)
   const domainsDir = join(frameworkDir, 'agents');
   if (existsSync(domainsDir)) {
     for (const filePath of collectSkillFiles(domainsDir)) {
@@ -342,6 +370,10 @@ export function checkMissingAgents(projectDir, frameworkDir, projectTags = []) {
       if (!name) continue;
       if (!shouldInstall(stacks, projectTags)) continue;
 
+      // If agents.json has morph-{name}.md, domain content is merged there
+      const agentsJsonFile = `morph-${name}.md`;
+      if (installedFiles.has(agentsJsonFile)) continue;
+
       expected++;
       const filename = `morph-domain-${name}.md`;
       if (!installedFiles.has(filename)) {