@polymorphism-tech/morph-spec 4.7.0 → 4.7.2

package/framework/CLAUDE.md

@@ -56,7 +56,7 @@
 proposal → setup → [uiux] → design → clarify → tasks → implement → [sync]
 ```
 
-Use `morph-spec state show {feature}` to see current phase and pending approval gates.
+Use `morph-spec status {feature}` to see current phase and pending approval gates.
 
 ---
 

package/framework/hooks/README.md

@@ -47,13 +47,13 @@ framework/hooks/
 |-------|------|------|---------|
 | **SessionStart** | inject-morph-context.js | Inject context | Shows active feature, phase, pending approvals |
 | **UserPromptSubmit** | enrich-prompt.js | Inject context | Warns about wrong-phase work, injects commands |
-| **PreToolUse** (Write\|Edit) | protect-readonly-files.js | Block | Blocks edits to state.json and .morph/framework/ |
+| **PreToolUse** (Write\|Edit) | _(native permissions.deny)_ | Block | Blocks edits to state.json and .morph/framework/ |
 | **PreToolUse** (Write\|Edit) | protect-spec-files.js | Block | Blocks edits to spec files after approval |
 | **PreToolUse** (Write\|Edit) | enforce-phase-writes.js | Block | Ensures writes go to current phase directory |
 | **PreToolUse** (Bash) | _(prompt-type inline guard)_ | Block | Blocks `rm -rf .morph/` and direct state edits via Claude's reasoning |
-| **PostToolUse** (Write) | track-output-creation.js | Auto-state | Marks outputs as created when files are written |
 | **PostToolUse** (Bash) | dispatch.js | Dispatch | Triggers checkpoints on task completion |
-| **Stop** | validate-completion.js | Advisory | Warns about incomplete tasks/outputs |
+| **PostToolUseFailure** | handle-tool-failure.js | Logging | Appends structured JSON to .morph/logs/tool-failures.log |
+| **Stop** | validate-completion.js | Advisory | Warns about incomplete tasks/missing outputs/pending gates |
 | **PreCompact** | save-morph-context.js | Snapshot | Saves state to .morph/memory/ before compaction |
 | **Notification** | approval-reminder.js | Advisory | Reminds about pending approval gates |
 
@@ -69,6 +69,10 @@ framework/hooks/
 
 Hooks are automatically installed by `morph-spec init` and updated by `morph-spec update`.
 
+During init/update, the entire `framework/hooks/` directory is copied to `.morph/framework/hooks/`.
+Hook commands in `.claude/settings.local.json` reference `$CLAUDE_PROJECT_DIR/.morph/framework/hooks/`
+so they work correctly in any project regardless of how morph-spec was installed.
+
 The installer writes to `.claude/settings.local.json`:
 
 ```json
@@ -122,10 +126,10 @@ Claude calls Write/Edit tool
     ↓
 Claude Code sends JSON to stdin: { tool_input: { file_path: "..." } }
     ↓
-protect-readonly-files.js
+[native permissions.deny]
     ├── Is .morph/state.json? → BLOCK (use CLI)
     ├── Is .morph/framework/**? → BLOCK (read-only)
-    └── Other → pass
+    └── Other → continue
     ↓
 protect-spec-files.js
     ├── Is in .morph/features/{feature}/?
@@ -198,4 +202,4 @@ morph-spec doctor --reset
 
 ---
 
-*MORPH-SPEC v4.3.7 — Hooks Architecture v2*
+*MORPH-SPEC v4.5.0 — Hooks Architecture v2.5*

package/framework/hooks/claude-code/notification/approval-reminder.js

@@ -26,6 +26,8 @@ try {
 
   // Only remind about gates relevant to the current phase
   const phaseGateRelevance = {
+    proposal: ['proposal'],
+    setup: ['proposal'],
     design: ['design'],
     clarify: ['design'],
     tasks: ['design', 'tasks'],

package/framework/hooks/claude-code/post-tool-use/dispatch.js

@@ -46,7 +46,7 @@ function dispatch(command) {
         const completed = (feature.tasks.completed || 0) + 1; // +1 because task-done hasn't executed yet
         if (completed > 0 && completed % 3 === 0) {
           const checkpointNum = Math.floor(completed / 3);
-          run(`node bin/morph-spec.js checkpoint-save ${featureName} --note "Auto-checkpoint #${checkpointNum} at task ${completed}"`);
+          run(`morph-spec checkpoint-save ${featureName} --note "Auto-checkpoint #${checkpointNum} at task ${completed}"`);
         }
       }
     } catch {

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

@@ -58,7 +58,7 @@ try {
   // Check pending approval gates
   if (feature.approvalGates) {
     const pendingGates = Object.entries(feature.approvalGates)
-      .filter(([, gate]) => !gate.approved && gate.timestamp === null)
+      .filter(([, gate]) => !gate.approved && !gate.timestamp)
       .map(([name]) => name);
 
     // Only warn about gates relevant to current/past phases

package/framework/hooks/claude-code/user-prompt/enrich-prompt.js

@@ -24,7 +24,7 @@ try {
   const payload = await readStdin();
   if (!payload) pass();
 
-  const userPrompt = payload?.user_prompt || payload?.content || '';
+  const userPrompt = payload?.prompt || payload?.user_prompt || payload?.content || '';
   if (!userPrompt || userPrompt.length < 3) pass();
 
   const promptLower = userPrompt.toLowerCase();

package/package.json

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

package/src/commands/project/init.js

@@ -18,8 +18,6 @@ import { saveProjectMorphVersion, getInstalledCLIVersion } from '../../utils/ver
 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 { AutoContextOrchestrator } from '../../core/orchestrator.js';
-import { detectClaudeCode } from '../../llm/environment-detector.js';
 import inquirer from 'inquirer';
 import { detectProject } from '../../lib/detectors/index.js';
 import { detectClaudeConfig, mapMcpsToPhases, formatConfigSummary } from '../../lib/detectors/claude-config-detector.js';
@@ -102,11 +100,11 @@ export async function initCommand(options) {
 
 ## Overview
 
-This file will be auto-updated by MORPH-SPEC detection system.
+This file describes your project context for MORPH-SPEC agents.
 
 ## Stack
 
-Run \`morph-spec detect\` to analyze your project.
+Edit this file to describe your project context.
 
 ## Technologies
 
@@ -139,6 +137,14 @@ Run \`morph-spec detect\` to analyze your project.
       logger.dim('  ✓ Copied framework standards: core/, backend/, frontend/, infrastructure/');
     }
 
+    // 6c. Copy hooks to .morph/framework/hooks/ (required for hook commands at runtime)
+    spinner.text = 'Copying hooks...';
+    const hooksSrc = join(import.meta.dirname, '..', '..', '..', 'framework', 'hooks');
+    const hooksDest = join(frameworkDestDir, 'hooks');
+    if (await pathExists(hooksSrc)) {
+      await copyDirectory(hooksSrc, hooksDest);
+    }
+
     // 7. Copy agents.json (sourced from framework/ — canonical single source of truth)
     spinner.text = 'Copying agents configuration...';
     const agentsSrc = join(import.meta.dirname, '..', '..', '..', 'framework', 'agents.json');
@@ -467,10 +473,9 @@ Run \`morph-spec detect\` to analyze your project.
     logger.blank();
     logger.header('Next Steps');
 
-    logger.step(1, 'Run detection: morph-spec detect');
-    logger.step(2, 'Review .morph/config/config.json and .morph/context/standards.md');
-    logger.step(3, 'Open project in VS Code with Claude Code');
-    logger.step(4, 'Start your first feature:');
+    logger.step(1, 'Review .morph/config/config.json');
+    logger.step(2, 'Open project in VS Code with Claude Code');
+    logger.step(3, 'Start your first feature:');
     logger.blank();
     logger.box([
       'Ask Claude Code to implement a feature'
@@ -480,7 +485,7 @@ Run \`morph-spec detect\` to analyze your project.
     logger.info('Files installed:');
     logger.dim(`  ✓ CLAUDE.md`);
     logger.dim(`  ✓ .morph/config/ (config.json)`);
-    logger.dim(`  ✓ .morph/framework/ (agents.json, standards/, templates/)`);
+    logger.dim(`  ✓ .morph/framework/ (agents.json, standards/, templates/, hooks/)`);
     logger.dim(`  ✓ .morph/context/ (project context)`);
     logger.dim(`  ✓ .morph/features/ (feature outputs)`);
     if (commandsCopied) {
@@ -503,42 +508,10 @@ Run \`morph-spec detect\` to analyze your project.
 
     logger.dim('  ✓ .claude/skills/ (installed as skill directories)');
     logger.dim('  ✓ .claude/agents/ (native subagents installed)');
+    logger.dim('  ✓ ~/.claude/statusline.sh (global statusline installed)');
 
     logger.blank();
 
-    // 13. LLM-based auto-detect project context (if Claude Code is available and not --skip-detection)
-    if (!options.skipDetection && detectClaudeCode()) {
-      logger.blank();
-      logger.header('Auto-Detecting Project Context');
-      logger.dim('Using Claude Code LLM to analyze your project...');
-      logger.blank();
-
-      try {
-        const orchestrator = new AutoContextOrchestrator();
-        const result = await orchestrator.execute(targetPath, {
-          skipReview: false,
-          fallbackOnError: true,
-          wizardMode: options.wizard || false
-        });
-
-        if (result.success) {
-          logger.success('Project context detected and saved to .morph/project.md');
-        } else {
-          logger.warn('Auto-detection incomplete. Run "morph-spec update" to retry.');
-        }
-      } catch (error) {
-        logger.warn(`Auto-detection failed: ${error.message}`);
-        logger.dim('You can run "morph-spec update" later to re-analyze your project.');
-      }
-    } else if (options.skipDetection) {
-      logger.dim('\nSkipped auto-detection (--skip-detection flag)');
-      logger.dim('Run "morph-spec update" later to analyze your project.');
-    } else {
-      logger.warn('\n⚠️  Claude Code not detected');
-      logger.dim('Auto-detection requires Claude Code CLI.');
-      logger.dim('Run "morph-spec update --wizard" to configure manually.');
-    }
-
     // Suggest tutorial for first-time users
     if (integrationsCreated) {
       logger.blank();

package/src/commands/project/update.js

@@ -24,11 +24,9 @@ import {
   getUpdateInstructions,
   detectInstallMethod
 } from '../../utils/version-checker.js';
-import { installClaudeHooks } 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 { AutoContextOrchestrator } from '../../core/orchestrator.js';
-import { detectClaudeCode } from '../../llm/environment-detector.js';
 
 /**
  * Backup user's config.json before cleaning
@@ -57,6 +55,7 @@ async function cleanFrameworkDirs(morphPath, targetPath) {
   const dirsToClean = [
     join(morphPath, 'framework', 'templates'),
     join(morphPath, 'framework', 'standards'),
+    join(morphPath, 'framework', 'hooks'),
     join(morphPath, 'config'),
     join(targetPath, '.claude')
   ];
@@ -208,6 +207,14 @@ export async function updateCommand(options) {
       await copyDirectory(standardsSrc, standardsDest);
     }
 
+    // Update hooks (runtime hook scripts under .morph/framework/hooks/)
+    updateSpinner.text = 'Updating hooks...';
+    const hooksSrc = join(__dirname, '..', '..', '..', 'framework', 'hooks');
+    const hooksDest = join(morphPath, 'framework', 'hooks');
+    if (await pathExists(hooksSrc)) {
+      await copyDirectory(hooksSrc, hooksDest);
+    }
+
     // Update agents.json (sourced from framework/ — canonical single source of truth)
     updateSpinner.text = 'Updating agents configuration...';
     const agentsSrc = join(__dirname, '..', '..', '..', 'framework', 'agents.json');
@@ -279,6 +286,16 @@ export async function updateCommand(options) {
       await copyFile(runtimeSrc, runtimeDest);
     }
 
+    // Sync statusline globally to ~/.claude/
+    updateSpinner.text = 'Syncing statusline to ~/.claude/...';
+    const HOOKS_SRC = join(__dirname, '..', '..', '..', 'framework', 'hooks', 'claude-code');
+    try {
+      await installGlobalStatusline(HOOKS_SRC);
+    } catch {
+      // Non-critical: global dir may not be writable in all environments
+      logger.dim('  ⚠ Could not install statusline globally (non-critical)');
+    }
+
     // Update Claude Code hooks in .claude/settings.local.json
     updateSpinner.text = 'Updating Claude Code hooks...';
     const hooksResult = await installClaudeHooks(targetPath);
@@ -314,6 +331,7 @@ export async function updateCommand(options) {
     logger.info('Updated files:');
     if (updateTemplates) logger.dim('  ✓ .morph/framework/templates/');
     if (updateStandards) logger.dim('  ✓ .morph/framework/standards/');
+    logger.dim('  ✓ .morph/framework/hooks/');
     logger.dim('  ✓ .morph/framework/agents.json');
     if (commandsCopied) logger.dim('  ✓ .claude/commands/');
 
@@ -322,46 +340,13 @@ export async function updateCommand(options) {
     logger.dim('  ✓ .claude/agents/ (native subagents refreshed)');
     logger.dim('  ✓ .claude/rules/ (path-scoped rules synced)');
     logger.dim('  ✓ .claude/CLAUDE.md (runtime quick reference)');
+    logger.dim('  ✓ ~/.claude/statusline.sh (global statusline synced)');
     logger.dim('  ✓ CLAUDE.md');
     logger.blank();
     logger.info('Your config.json was preserved.');
     logger.dim('Review the updated files for any new features.');
     logger.blank();
 
-    // Re-analyze project context (unless --skip-detection)
-    if (!options.skipDetection && detectClaudeCode()) {
-      logger.header('Re-Analyzing Project Context');
-      logger.dim('Using Claude Code LLM to update project detection...');
-      logger.blank();
-
-      try {
-        const orchestrator = new AutoContextOrchestrator();
-        const result = await orchestrator.execute(targetPath, {
-          skipReview: false,
-          fallbackOnError: true,
-          wizardMode: options.wizard || false
-        });
-
-        if (result.success) {
-          logger.success('Project context re-analyzed and updated');
-          logger.dim('  ✓ .morph/project.md updated with latest detection');
-          logger.dim('  ✓ .morph/config/config.json updated with stack info');
-        } else {
-          logger.warn('Context re-analysis incomplete');
-        }
-      } catch (error) {
-        logger.warn(`Auto-detection failed: ${error.message}`);
-        logger.dim('Your existing config.json was preserved.');
-      }
-
-      logger.blank();
-    } else if (options.skipDetection) {
-      logger.dim('Skipped auto-detection (--skip-detection flag)');
-    } else {
-      logger.warn('⚠️  Claude Code not detected - skipping auto-detection');
-      logger.dim('Run with --wizard to configure manually.');
-    }
-
   } catch (error) {
     updateSpinner.fail('Update failed');
     logger.error(error.message);

package/src/lib/installers/mcp-installer.js

@@ -96,6 +96,21 @@ export function checkPrerequisites(mcpEntry) {
   return results;
 }
 
+/**
+ * Patch MCP config for the current platform.
+ * On Windows, npx must be invoked via `cmd /C` to avoid ENOENT errors.
+ * @param {Object} config - MCP server config { command, args, env? }
+ * @returns {Object} Patched config (new object, original unmodified)
+ */
+export function patchConfigForPlatform(config) {
+  if (process.platform !== 'win32' || config.command !== 'npx') return config;
+  return {
+    ...config,
+    command: 'cmd',
+    args: ['/C', 'npx', ...(config.args || [])]
+  };
+}
+
 /**
  * Install auto-installable MCPs (no credentials, no prerequisites)
  * @param {string} targetPath - Project root directory
@@ -106,12 +121,12 @@ export async function installAutoMcps(targetPath, mcpsToInstall) {
   const servers = {};
 
   for (const [name, entry] of Object.entries(mcpsToInstall)) {
-    const config = { ...entry.install.config };
+    let config = { ...entry.install.config };
     // Only include env if it has actual values
     if (config.env && Object.values(config.env).every(v => !v)) {
       delete config.env;
     }
-    servers[name] = config;
+    servers[name] = patchConfigForPlatform(config);
   }
 
   return installMcpServers(targetPath, servers);
@@ -126,7 +141,7 @@ export async function installAutoMcps(targetPath, mcpsToInstall) {
  * @returns {Promise<Object>} Result from installMcpServers
  */
 export async function installMcpWithCredentials(targetPath, name, mcpEntry, credentialValues) {
-  const config = { ...mcpEntry.install.config };
+  const config = patchConfigForPlatform({ ...mcpEntry.install.config });
   config.env = { ...config.env, ...credentialValues };
   return installMcpServers(targetPath, { [name]: config });
 }

package/src/utils/hooks-installer.js

@@ -14,7 +14,7 @@ import { existsSync, chmodSync } from 'fs';
 import { homedir } from 'os';
 
 /** Current hooks schema version — bump when hook definitions change */
-const HOOKS_VERSION = '2.4.0';
+const HOOKS_VERSION = '2.5.0';
 
 /** Marker for old dispatch.js (v1) */
 const OLD_DISPATCH_COMMAND = 'node framework/hooks/agent-teams/dispatch.js';
@@ -104,19 +104,8 @@ Otherwise respond: {"ok": true}`
     event: 'Stop',
     matcher: null,
     hooks: [{
-      type: 'agent',
-      prompt: `Check if the active morph-spec feature phase outputs are complete.
-1. Read the file .morph/state.json to find features with status "in_progress".
-2. For each in_progress feature, check if required output files for the current phase exist and are non-empty.
-   - proposal phase: .morph/features/{feature}/0-proposal/proposal.md
-   - design phase: .morph/features/{feature}/1-design/spec.md
-   - tasks phase: .morph/features/{feature}/3-tasks/tasks.md
-   - implement phase: check tasks.completed vs tasks.total from state.json
-3. If all required outputs exist and tasks are complete, return {"ok": true}.
-4. If any required output is missing or empty, return {"ok": false, "reason": "Missing output: <path>"}.
-5. If state.json does not exist or no feature is in_progress, return {"ok": true}.
-Do NOT modify any files. Read only.`,
-      timeout: 60
+      type: 'command',
+      command: 'node framework/hooks/claude-code/stop/validate-completion.js'
     }]
   },
 
@@ -209,9 +198,10 @@ export async function installClaudeHooks(targetPath) {
         return agentHook;
       }
       // Command hooks: transform path to use $CLAUDE_PROJECT_DIR
+      // Hooks are copied to .morph/framework/hooks/ during `morph-spec init/update`
       return {
         type: h.type,
-        command: `node "$CLAUDE_PROJECT_DIR/framework/hooks/claude-code/${getHookSubpath(h.command)}"`,
+        command: `node "$CLAUDE_PROJECT_DIR/.morph/framework/hooks/claude-code/${getHookSubpath(h.command)}"`,
         ...(h.timeout !== undefined ? { timeout: h.timeout } : {})
       };
     });

package/src/commands/project/detect.js

@@ -1,114 +0,0 @@
-import { join } from 'path';
-import ora from 'ora';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { detectProject, getDetectionSummary } from '../../lib/detectors/index.js';
-import { ensureDir, writeFile, readJson, writeJson, pathExists } from '../../utils/file-copier.js';
-
-export async function detectCommand(options) {
-  const targetPath = options.path || process.cwd();
-
-  logger.header('MORPH-SPEC Project Detection');
-  logger.dim(`Analyzing: ${targetPath}`);
-  logger.blank();
-
-  const spinner = ora('Detecting project structure...').start();
-
-  try {
-    // Run detection
-    const results = await detectProject(targetPath, {
-      structure: true,
-      config: true,
-      conversation: true,
-      generateStandards: true
-    });
-
-    spinner.succeed('Detection complete!');
-    logger.blank();
-
-    // Display summary
-    logger.header('Detection Results');
-    logger.blank();
-
-    // Stack
-    logger.info(`Stack: ${chalk.cyan(results.structure.stack)}`);
-    logger.info(`Architecture: ${chalk.cyan(results.structure.architecture)}`);
-    if (results.structure.uiLibrary) {
-      logger.info(`UI Library: ${chalk.cyan(results.structure.uiLibrary)}`);
-    }
-    logger.blank();
-
-    // Technologies
-    if (results.config.technologies.length > 0) {
-      logger.header('Technologies:');
-      results.config.technologies.forEach(tech => {
-        logger.dim(`  - ${tech}`);
-      });
-      logger.blank();
-    }
-
-    // Patterns
-    if (results.structure.patterns.length > 0) {
-      logger.header('Patterns:');
-      results.structure.patterns.forEach(pattern => {
-        logger.dim(`  - ${pattern}`);
-      });
-      logger.blank();
-    }
-
-    // Recommendations
-    if (results.inferred.recommendations.length > 0) {
-      logger.header('Recommendations:');
-      results.inferred.recommendations.forEach(rec => {
-        logger.warn(`  ⚠ ${rec}`);
-      });
-      logger.blank();
-    }
-
-    // Save results if requested
-    if (options.save !== false) {
-      spinner.start('Saving detection results...');
-
-      const outputDir = join(targetPath, '.morph', 'project', 'context');
-      await ensureDir(outputDir);
-
-      // Save detection log
-      const logPath = join(outputDir, 'detection-log.md');
-      const summary = getDetectionSummary(results);
-      await writeFile(logPath, summary);
-
-      // Save inferred standards
-      const standardsDir = join(targetPath, '.morph', 'project', 'standards');
-      await ensureDir(standardsDir);
-
-      const standardsPath = join(standardsDir, 'inferred.md');
-      await writeFile(standardsPath, results.inferred.markdown);
-
-      // Update config.json with detected stack and architecture
-      const configPath = join(targetPath, '.morph', 'config', 'config.json');
-      if (await pathExists(configPath)) {
-        const projectConfig = await readJson(configPath);
-        projectConfig.project = projectConfig.project || {};
-        projectConfig.project.stack = results.structure.stack;
-        projectConfig.project.architecture = results.structure.architecture;
-        await writeJson(configPath, projectConfig);
-      }
-
-      spinner.succeed('Results saved!');
-      logger.dim(`  - ${logPath}`);
-      logger.dim(`  - ${standardsPath}`);
-    }
-
-    // Verbose output
-    if (options.verbose) {
-      logger.blank();
-      logger.header('Detailed Results (JSON):');
-      console.log(JSON.stringify(results, null, 2));
-    }
-
-  } catch (error) {
-    spinner.fail('Detection failed');
-    logger.error(error.message);
-    process.exit(1);
-  }
-}