@polymorphism-tech/morph-spec 4.10.6 → 4.10.8

package/src/commands/project/doctor.js

@@ -199,6 +199,20 @@ async function doctorFullCommand(frameworkRoot) {
     check('agents.json', false, false, 'file not found');
   }
 
+  // ── 6. agents.json version freshness ──────────────────────────────────
+  const canonicalAgentsPath = join(frameworkRoot, 'framework/agents.json');
+  if (await pathExists(agentsPath) && await pathExists(canonicalAgentsPath)) {
+    try {
+      const installed = JSON.parse(await fs.readFile(agentsPath, 'utf8'));
+      const canonical = JSON.parse(await fs.readFile(canonicalAgentsPath, 'utf8'));
+      const installedVer = installed.version || 'unknown';
+      const canonicalVer = canonical.version || 'unknown';
+      const isFresh = installedVer === canonicalVer;
+      check(`agents.json version (${installedVer})`, isFresh, true,
+        isFresh ? '' : `stale — canonical is v${canonicalVer}, run 'morph-spec update' to sync`);
+    } catch { /* ignore parse errors — already caught above */ }
+  }
+
   // ── 7. Workflow Configs ──────────────────────────────────────────────────
   console.log(chalk.cyan('\n  framework/workflows/ — Workflow Configs'));
   const stdPath = join(frameworkRoot, 'framework/workflows/configs/standard.json');
@@ -599,6 +613,51 @@ export async function doctorCommand(options = {}) {
       } else {
         checks.push({ name: 'agents.json tier counts', status: 'ok' });
       }
+
+      // Check 4: v4 schema validation
+      const version = agentsData.version || 'unknown';
+      const isV4 = version.startsWith('4.');
+      const v3Fields = [];
+      const missingV4Fields = [];
+
+      for (const [id, data] of agentEntries) {
+        if (data.role !== undefined) v3Fields.push(`${id}.role`);
+        if (data.always_active !== undefined) v3Fields.push(`${id}.always_active`);
+        if (data.relationships !== undefined) v3Fields.push(`${id}.relationships`);
+        if (!data.group) missingV4Fields.push(`${id}.group`);
+        if (!Array.isArray(data.active_phases)) missingV4Fields.push(`${id}.active_phases`);
+      }
+
+      if (isV4) {
+        checks.push({ name: `agents.json schema (v${version})`, status: 'ok' });
+      } else {
+        checks.push({
+          name: `agents.json schema (v${version})`,
+          status: 'warn',
+          msg: 'expected v4.x — run agents migration'
+        });
+        hasWarnings = true;
+      }
+
+      if (v3Fields.length > 0) {
+        const sample = v3Fields.slice(0, 3).join(', ');
+        checks.push({
+          name: 'agents.json deprecated fields',
+          status: 'warn',
+          msg: `${v3Fields.length} v3 field(s) found: ${sample}${v3Fields.length > 3 ? '...' : ''}`
+        });
+        hasWarnings = true;
+      }
+
+      if (missingV4Fields.length > 0 && isV4) {
+        const sample = missingV4Fields.slice(0, 3).join(', ');
+        checks.push({
+          name: 'agents.json v4 required fields',
+          status: 'warn',
+          msg: `${missingV4Fields.length} missing: ${sample}${missingV4Fields.length > 3 ? '...' : ''}`
+        });
+        hasWarnings = true;
+      }
     } catch {
       checks.push({ name: 'agents.json', status: 'error', msg: 'invalid JSON' });
       hasErrors = true;

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/update.js

@@ -25,7 +25,7 @@ import {
   getUpdateInstructions,
   detectInstallMethod
 } 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';
 import { injectMorphImport } from '../../utils/claude-md-injector.js';
@@ -309,22 +309,6 @@ export async function updateCommand(options) {
     updateSpinner.text = 'Updating Claude Code hooks...';
     const hooksResult = await installClaudeHooks(targetPath);
 
-    // Install shell integration (terminal title watcher)
-    updateSpinner.text = 'Installing shell integration...';
-    try {
-      await installShellIntegration();
-    } catch {
-      logger.dim('  ⚠ Could not install shell integration (non-critical)');
-    }
-
-    // Configure VS Code terminal settings (enable OSC title sequences)
-    updateSpinner.text = 'Configuring VS Code terminal settings...';
-    try {
-      await installVSCodeTerminalSettings();
-    } catch {
-      logger.dim('  ⚠ Could not configure VS Code terminal settings (non-critical)');
-    }
-
     // Ensure root CLAUDE.md has morph-spec @import (preserves user content)
     updateSpinner.text = 'Checking CLAUDE.md import...';
     const claudeMdDest = join(targetPath, 'CLAUDE.md');

package/src/commands/project/worktree.js

@@ -14,8 +14,8 @@
  */
 
 import { execSync } from 'child_process';
-import { existsSync, mkdirSync } from 'fs';
-import { join } from 'path';
+import { existsSync, mkdirSync, symlinkSync, linkSync, copyFileSync } from 'fs';
+import { join, resolve, dirname } from 'path';
 
 // ── Pure helpers (exported for tests) ──────────────────────────────────────
 
@@ -93,6 +93,59 @@ function getDateSuffix() {
   return new Date().toISOString().slice(0, 10).replace(/-/g, '');
 }
 
+// ── Infrastructure linking ───────────────────────────────────────────────────
+
+/**
+ * Create symlinks/junctions in the worktree for shared infrastructure files
+ * that are gitignored (state.json, .claude/, .morph/framework/, node_modules/).
+ *
+ * Uses junctions for directories (no admin required on Windows).
+ * File symlinks fall back to copy if symlink fails.
+ * Fail-open: any error is silently ignored.
+ *
+ * @param {string} worktreePath - Absolute path to the worktree
+ * @param {string} mainCwd - Absolute path to the main project root
+ */
+export function setupInfraLinks(worktreePath, mainCwd) {
+  const mainAbs = resolve(mainCwd);
+  const wtAbs = resolve(worktreePath);
+
+  // Directory junctions — shared across worktrees
+  const dirLinks = ['node_modules', '.claude'];
+
+  // .morph/framework/ — client projects (in framework repo, framework/ is tracked)
+  if (existsSync(join(mainAbs, '.morph', 'framework'))) {
+    dirLinks.push(join('.morph', 'framework'));
+  }
+
+  for (const rel of dirLinks) {
+    const target = join(mainAbs, rel);
+    const linkPath = join(wtAbs, rel);
+    if (!existsSync(target) || existsSync(linkPath)) continue;
+    try {
+      const parent = dirname(linkPath);
+      if (!existsSync(parent)) mkdirSync(parent, { recursive: true });
+      symlinkSync(target, linkPath, 'junction');
+    } catch { /* fail-open */ }
+  }
+
+  // state.json — shared state via hard link (works on Windows without admin,
+  // same NTFS volume). Falls back to symlink, then copy.
+  const stateTarget = join(mainAbs, '.morph', 'state.json');
+  const stateLink = join(wtAbs, '.morph', 'state.json');
+  if (existsSync(stateTarget) && !existsSync(stateLink)) {
+    const morphDir = join(wtAbs, '.morph');
+    if (!existsSync(morphDir)) {
+      try { mkdirSync(morphDir, { recursive: true }); } catch { /* */ }
+    }
+    try {
+      linkSync(stateTarget, stateLink); // hard link — no admin, shared data
+    } catch {
+      try { copyFileSync(stateTarget, stateLink); } catch { /* fail-open */ }
+    }
+  }
+}
+
 // ── Command handler ─────────────────────────────────────────────────────────
 
 /**
@@ -133,6 +186,9 @@ export async function worktreeSetupCommand(feature, options = {}) {
     // Add worktree
     execSync(`git worktree add "${worktreePath}" ${branch}`, { cwd, stdio: 'pipe' });
 
+    // Set up infrastructure symlinks so the worktree has state.json, .claude/, etc.
+    setupInfraLinks(worktreePath, cwd);
+
     // Persist in state (non-blocking — feature may not be in state yet)
     try {
       const { loadState, saveState } = await import('../../lib/state/state-manager.js');

package/src/commands/state/advance-phase.js

@@ -269,9 +269,6 @@ export async function advancePhaseCommand(feature, options = {}) {
 
       if (!specContentValidation.valid) {
         console.log(chalk.red('\n✗ Spec content validation failed:'));
-        specContentValidation.missing.forEach(section => {
-          console.log(chalk.red(`  - Missing section: ${section}`));
-        });
         specContentValidation.errors.forEach(error => {
           console.log(chalk.red(`  - ${error}`));
         });
@@ -441,6 +438,17 @@ export async function advancePhaseCommand(feature, options = {}) {
     // Hook executor unavailable — non-blocking
   }
 
+  // Agent detection refresh (fail-open)
+  try {
+    const { refreshAgents, displayDetectionDiff } = await import('../agents/detect-agents.js');
+    const refreshResult = await refreshAgents(process.cwd(), feature);
+    if (refreshResult.added.length > 0) {
+      displayDetectionDiff(refreshResult, currentPhase, nextPhase);
+    }
+  } catch {
+    // Refresh is diagnostic — fail-open, phase advance already completed
+  }
+
   // Emit Tier-4 validator dispatch when advancing into implement or sync phase
   const phasesNeedingValidation = ['implement', 'sync'];
   if (phasesNeedingValidation.includes(nextPhase) || phasesNeedingValidation.includes(currentPhase)) {

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';