@polymorphism-tech/morph-spec 4.3.6 → 4.5.0

package/bin/morph-spec.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 import { program } from 'commander';
 import chalk from 'chalk';
@@ -9,11 +9,18 @@ import { readFileSync } from 'fs';
 // Project commands
 import { initCommand } from '../src/commands/project/init.js';
 import { updateCommand } from '../src/commands/project/update.js';
+import { updateAgentsCommand } from '../src/commands/project/update-agents.js';
 import { doctorCommand } from '../src/commands/project/doctor.js';
 import { detectCommand } from '../src/commands/project/detect.js';
-import { detectAgentsCommand } from '../src/commands/project/detect-agents.js';
-import { detectWorkflowCommand } from '../src/commands/project/detect-workflow.js';
+
 import { syncCommand } from '../src/commands/project/sync.js';
+import { statusCommand } from '../src/commands/project/status.js';
+import { diffCommand, diffSaveCommand } from '../src/commands/project/diff.js';
+import { costCommand } from '../src/commands/project/cost.js';
+import { revertCommand } from '../src/commands/project/revert.js';
+import { checkpointSaveCommand, checkpointRestoreCommand, checkpointListCommand } from '../src/commands/project/checkpoint.js';
+
+import { changesCommand } from '../src/commands/project/changes.js';
 
 // Feature commands
 import { createStoryCommand } from '../src/commands/feature/create-story.js';
@@ -32,7 +39,7 @@ import { taskDoneCommand, taskStartCommand, taskNextCommand } from '../src/comma
 
 // Generation commands
 import { generateDesignSystemCommand, generateMetadataCommand } from '../src/commands/generation/generate.js';
-import { generateContextCommand } from '../src/commands/generation/generate-context.js';
+import { generateOnboardingCommand } from '../src/commands/generation/generate-onboarding.js';
 
 // Validation commands
 import { validateCommand } from './validate.js';
@@ -41,6 +48,7 @@ import { lintFluentCommand } from '../src/commands/validation/lint-fluent.js';
 import { analyzeBlazorConcurrencyCommand } from '../src/commands/validation/analyze-blazor-concurrency.js';
 import { validateBlazorStateCommand } from '../src/commands/validation/validate-blazor-state.js';
 import { validateCssCommand } from '../src/commands/validation/validate-css.js';
+import { validateFeatureCommand } from '../src/commands/validation/validate-feature.js';
 
 // Template commands
 import { templateListCommand } from '../src/commands/templates/template-list.js';
@@ -50,7 +58,6 @@ import { templateCustomizeCommand } from '../src/commands/templates/template-cus
 import { templateValidateCommand } from '../src/commands/templates/template-validate.js';
 
 // Agent commands
-import { spawnTeamCommand } from '../src/commands/agents/spawn-team.js';
 
 // Learning commands
 import capturePatternProgram from '../src/commands/learning/capture-pattern.js';
@@ -58,39 +65,10 @@ import searchPatternsProgram from '../src/commands/learning/search-patterns.js';
 
 // Utility commands
 import troubleshootCommand from '../src/commands/utils/troubleshoot.js';
-import { sessionSummaryCommand } from '../src/commands/utils/session-summary.js';
-
-// Thread, Analytics, Core Four commands
-import {
-  threadsListCommand, threadsStatusCommand, threadsKillCommand,
-  threadsAnalyticsCommand, threadsWaitAllCommand, threadsWaitAnyCommand
-} from '../src/commands/threads/threads.js';
-import {
-  analyticsFeatureCommand, analyticsContextCommand, analyticsProjectCommand
-} from '../src/commands/analytics/analytics.js';
-import { coreFourCommand } from '../src/commands/context/core-four.js';
 
 // Context Optimization commands
 import { mcpOptimizeCommand, mcpListCommand } from '../src/commands/mcp/mcp.js';
-import {
-  microAgentCreateCommand, microAgentListCommand, microAgentShowCommand
-} from '../src/commands/agents/micro-agent.js';
-import { contextPrimeCommand } from '../src/commands/context/context-prime.js';
-
-// Parallelization commands
-import {
-  squadTemplateListCommand, squadTemplateUseCommand, squadTemplateShowCommand
-} from '../src/commands/agents/squad-template.js';
-import {
-  threadTemplateListCommand, threadTemplateUseCommand
-} from '../src/commands/threads/thread-template.js';
-import { spawnTeamParallelCommand } from '../src/commands/agents/spawn-team.js';
-
-// Fusion commands
-import { agentsFuseCommand, agentsReviewAggregateCommand } from '../src/commands/agents/agents-fuse.js';
-
-// Meta-Prompts (HOP) commands
-import { hopRenderCommand, hopListCommand } from '../src/commands/templates/template-render.js';
+import { mcpSetupCommand } from '../src/commands/mcp/mcp-setup.js';
 
 // Trust commands
 import {
@@ -127,6 +105,7 @@ program
   .description('Initialize MORPH-SPEC in current directory')
   .option('-f, --force', 'Overwrite existing MORPH installation')
   .option('-p, --path <path>', 'Target path (default: current directory)')
+  .option('--skip-mcp', 'Skip MCP server auto-setup')
   .action(initCommand);
 
 program
@@ -136,10 +115,16 @@ program
   .option('--standards', 'Update only standards')
   .action(updateCommand);
 
+program
+  .command('update-agents')
+  .description('Refresh .claude/agents/ with latest morph orchestrator and domain agents')
+  .action(updateAgentsCommand);
+
 program
   .command('doctor')
   .description('Check MORPH installation health')
   .option('--full', 'Run full health check (lib files, commands, HOPs, standards, agents, state)')
+  .option('--reset', 'Remove morph-managed entries from .claude/settings.local.json')
   .action(doctorCommand);
 
 program
@@ -150,22 +135,6 @@ program
   .option('--no-save', 'Do not save results to .morph/project/')
   .action(detectCommand);
 
-program
-  .command('detect-agents <input...>')
-  .description('Detect which agents to activate based on keywords in user input')
-  .option('-v, --verbose', 'Show detailed detection results')
-  .option('-j, --json', 'Output full result as JSON')
-  .option('-i, --ids-only', 'Output only agent IDs (one per line)')
-  .action(detectAgentsCommand);
-
-program
-  .command('detect-workflow <input...>')
-  .description('Detect appropriate workflow for a feature request')
-  .option('-v, --verbose', 'Show detailed detection reasoning')
-  .option('-j, --json', 'Output as JSON')
-  .option('-p, --project-path <path>', 'Project path (default: current directory)')
-  .action(detectWorkflowCommand);
-
 program
   .command('sync')
   .description('Sync standards from feature decisions')
@@ -173,6 +142,19 @@ program
   .option('--dry-run', 'Show what would be synced without updating files')
   .action(syncCommand);
 
+program
+  .command('status <feature>')
+  .description('Show comprehensive feature status dashboard')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Show detailed output')
+  .action(statusCommand);
+
+program
+  .command('changes <feature>')
+  .description('List files created/modified by a feature, grouped by phase')
+  .option('--json', 'Output as JSON')
+  .action((feature, options) => changesCommand(feature, options));
+
 // Story-driven development commands
 const storyCommand = program
   .command('story')
@@ -258,13 +240,6 @@ generateCommand
     await generateRecap('.', feature, options);
   });
 
-generateCommand
-  .command('context [feature]')
-  .description('Generate CONTEXT.md with full project data for Claude Code')
-  .action(async (feature) => {
-    await generateContextCommand('.', feature);
-  });
-
 generateCommand
   .command('metadata <feature>')
   .description('Generate metadata.json summary from markdown outputs')
@@ -272,6 +247,11 @@ generateCommand
   .option('--verbose', 'Show detailed extraction info')
   .action((feature, options) => generateMetadataCommand(feature, options));
 
+generateCommand
+  .command('onboarding')
+  .description('Generate onboarding.md guide with project context, MCPs, agents, and workflows')
+  .action(generateOnboardingCommand);
+
 // Validation commands (Sprint 4: Continuous Validation)
 program
   .command('validate [validator]')
@@ -404,6 +384,26 @@ learnCommand
     console.log(chalk.green('\n✅ Knowledge base reset\n'));
   });
 
+// Standards browsing command
+program
+  .command('standards')
+  .description('Browse framework standards library')
+  .option('--list', 'List all standards')
+  .option('--search <query>', 'Search standards by keyword')
+  .option('--show <id>', 'Show full content of a standard')
+  .option('--category <cat>', 'Filter by category (core, backend, frontend, infrastructure, ...)')
+  .option('--json', 'Output as JSON')
+  .action(async (opts) => {
+    const { listStandards, searchStandards, showStandard } = await import('../src/commands/project/standards.js');
+    if (opts.search) {
+      await searchStandards(opts.search, opts);
+    } else if (opts.show) {
+      await showStandard(opts.show);
+    } else {
+      await listStandards(opts);
+    }
+  });
+
 // Template management commands
 const templateCommand = program
   .command('template')
@@ -454,23 +454,6 @@ templateCommand
   .option('-v, --verbose', 'Show detailed validation information')
   .action(templateValidateCommand);
 
-// HOP (Higher-Order Prompts) commands
-const hopCommand = program
-  .command('hop')
-  .description('Higher-Order Prompts — render and manage meta-prompt templates');
-
-hopCommand
-  .command('list')
-  .description('List all available HOP templates')
-  .action(hopListCommand);
-
-hopCommand
-  .command('render <hop-id> [output-path]')
-  .description('Render a HOP template with variables')
-  .option('--variables <json>', 'Variables JSON string', '{}')
-  .option('--dry-run', 'Preview without writing file')
-  .action((hopId, outputPath, options) => hopRenderCommand(hopId, outputPath, options.variables, options));
-
 // Trust commands
 const trustCommand = program
   .command('trust')
@@ -529,13 +512,60 @@ program
   .option('-v, --verbose', 'Show detailed output')
   .action(validatePhaseCommand);
 
-// Session summary command
+// Feature validation command (content-aware)
+program
+  .command('validate-feature <feature>')
+  .alias('vf')
+  .description('Content-aware validation of feature outputs (sections, schema, contracts)')
+  .option('--phase <phase>', 'Validate outputs for a specific phase')
+  .option('--json', 'Output as JSON')
+  .option('-v, --verbose', 'Show detailed output')
+  .action(validateFeatureCommand);
+
+// Diff command
+program
+  .command('diff <feature> [output-file]')
+  .description('Show changes to specifications since last snapshot')
+  .option('--json', 'Output as JSON')
+  .action(diffCommand);
+
+program
+  .command('diff-save <feature>')
+  .description('Save current outputs as snapshot for future diffs')
+  .action(diffSaveCommand);
+
+// Cost tracking command
+program
+  .command('cost <feature>')
+  .description('Track token usage and cost estimates across phases')
+  .option('--json', 'Output as JSON')
+  .action(costCommand);
+
+// Revert command
 program
-  .command('session-summary <feature>')
-  .alias('summary')
-  .description('Show summary of current session (phases, decisions, progress)')
+  .command('revert <feature>')
+  .description('Revert feature to a previous phase')
+  .option('--to <phase>', 'Target phase to revert to')
+  .option('--delete-outputs', 'Delete output files (default: preserve files, reset state)')
+  .action(revertCommand);
+
+// Checkpoint save/restore commands
+program
+  .command('checkpoint-save <feature>')
+  .description('Save full context at current phase boundary')
+  .option('--label <label>', 'Custom label for checkpoint')
+  .action(checkpointSaveCommand);
+
+program
+  .command('checkpoint-restore <feature> [checkpoint]')
+  .description('Restore feature from a checkpoint (latest if no name given)')
+  .action(checkpointRestoreCommand);
+
+program
+  .command('checkpoint-list <feature>')
+  .description('List all checkpoints for a feature')
   .option('--json', 'Output as JSON')
-  .action(sessionSummaryCommand);
+  .action(checkpointListCommand);
 
 // Rollback phase command
 program
@@ -564,93 +594,10 @@ program
   .option('--json', 'Output as JSON')
   .action((feature, options) => approvalStatusCommand(feature, options));
 
-// Agent team spawning
-program
-  .command('spawn-team <feature>')
-  .description('Generate agent team configuration for Task tool')
-  .option('--json', 'Output as JSON')
-  .option('--verbose', 'Show detailed team configuration')
-  .action((feature, options) => spawnTeamCommand(feature, options));
-
 // Pattern learning system - Add as subcommands
 program.addCommand(capturePatternProgram);
 program.addCommand(searchPatternsProgram);
 
-// ─────────────────────────────────────────────────────────────────────────────
-// Thread Management
-// ─────────────────────────────────────────────────────────────────────────────
-const threadsCommand = program
-  .command('threads')
-  .description('Thread lifecycle management');
-
-threadsCommand
-  .command('list')
-  .description('List threads (optionally filtered by feature/status/type)')
-  .option('--feature <feature>', 'Filter by feature name')
-  .option('--status <status>', 'Filter by status (pending|running|completed|failed|killed)')
-  .option('--type <type>', 'Filter by type (base|parallel|fusion|long-running|zero-touch)')
-  .action((options) => threadsListCommand(options));
-
-threadsCommand
-  .command('status <id>')
-  .description('Show detailed status of a thread')
-  .action((id) => threadsStatusCommand(id));
-
-threadsCommand
-  .command('kill <id>')
-  .description('Terminate a running thread')
-  .action((id) => threadsKillCommand(id));
-
-threadsCommand
-  .command('analytics')
-  .description('Show thread analytics dashboard for a feature')
-  .option('--feature <feature>', 'Feature name (required)')
-  .action((options) => threadsAnalyticsCommand(options));
-
-threadsCommand
-  .command('wait-all <feature>')
-  .description('Block until all threads for a feature complete')
-  .option('--timeout <minutes>', 'Timeout in minutes (default: 60)', '60')
-  .action((feature, options) => threadsWaitAllCommand(feature, options));
-
-threadsCommand
-  .command('wait-any <feature>')
-  .description('Block until any thread for a feature completes')
-  .option('--timeout <minutes>', 'Timeout in minutes (default: 60)', '60')
-  .action((feature, options) => threadsWaitAnyCommand(feature, options));
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Analytics
-// ─────────────────────────────────────────────────────────────────────────────
-const analyticsCommand = program
-  .command('analytics')
-  .description('Metrics and analytics dashboards');
-
-analyticsCommand
-  .command('feature <name>')
-  .description('Show thread analytics dashboard for a feature')
-  .action((name, options) => analyticsFeatureCommand(name, options));
-
-analyticsCommand
-  .command('context <name>')
-  .description('Show context token usage and optimization opportunities')
-  .action((name, options) => analyticsContextCommand(name, options));
-
-analyticsCommand
-  .command('project')
-  .description('Show project-wide analytics dashboard (30-day summary)')
-  .option('--period <days>', 'Period in days (default: 30)', '30')
-  .action((options) => analyticsProjectCommand(options));
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Core Four
-// ─────────────────────────────────────────────────────────────────────────────
-program
-  .command('core-four <feature>')
-  .description('Show Core Four dashboard: Context/Model/Prompt/Tools')
-  .option('--json', 'Output as JSON')
-  .action((feature, options) => coreFourCommand(feature, options));
-
 // ─────────────────────────────────────────────────────────────────────────────
 // MCP Optimizer
 // ─────────────────────────────────────────────────────────────────────────────
@@ -668,108 +615,11 @@ mcpCommand
   .description('List configured MCP servers with usage stats')
   .action((options) => mcpListCommand(options));
 
-// ─────────────────────────────────────────────────────────────────────────────
-// Micro Agents
-// ─────────────────────────────────────────────────────────────────────────────
-const microAgentCommand = program
-  .command('micro-agent')
-  .description('Create and manage ultra-specialized micro-agents');
-
-microAgentCommand
-  .command('create <name>')
-  .description('Create a new micro-agent')
-  .option('--base-agent <agent>', 'Base agent ID to specialize from')
-  .option('--mission <mission>', 'Single focused mission for this agent')
-  .option('--standards <files>', 'Comma-separated standards files to load (1-3 max)')
-  .option('--tools <tools>', 'Comma-separated tools to allow (default: Read,Write,Edit)')
-  .action((name, options) => microAgentCreateCommand(name, options));
-
-microAgentCommand
-  .command('list')
-  .description('List all micro-agents')
-  .action((options) => microAgentListCommand(options));
-
-microAgentCommand
-  .command('show <name>')
-  .description('Show micro-agent details')
-  .option('--show-prompt', 'Show the generated system prompt')
-  .action((name, options) => microAgentShowCommand(name, options));
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Context Prime
-// ─────────────────────────────────────────────────────────────────────────────
-program
-  .command('prime [type]')
-  .description('Output context priming file (feature|bug|refactor|design|infra)')
-  .option('--json', 'Output as JSON')
-  .action((type, options) => contextPrimeCommand(type, options));
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Fusion (F-Thread)
-// ─────────────────────────────────────────────────────────────────────────────
-const agentsFuseCmd = program
-  .command('agents-fuse')
-  .description('F-Thread fusion execution: run N agents, aggregate best result');
-
-agentsFuseCmd
-  .command('run')
-  .description('Run fusion: spawn N agents with same prompt, aggregate results')
-  .option('--prompt <prompt>', 'Prompt/mission for all fusion agents (required)')
-  .option('--count <n>', 'Number of agents to run (default: 3)', '3')
-  .option('--strategy <strategy>', 'Aggregation strategy: best-of-n | consensus | manual-select', 'best-of-n')
-  .option('--feature <feature>', 'Feature name for tracking')
-  .option('--agents <list>', 'Comma-separated agent IDs to use')
-  .option('--json', 'Output as JSON')
-  .action((options) => agentsFuseCommand(options));
-
-agentsFuseCmd
-  .command('aggregate-reviews <feature>')
-  .description('Aggregate review results from N agents')
-  .option('--agents <list>', 'Comma-separated agent IDs (required)')
-  .option('--strategy <strategy>', 'Aggregation strategy', 'best-of-n')
-  .action((feature, options) => agentsReviewAggregateCommand(feature, options));
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Squad Templates
-// ─────────────────────────────────────────────────────────────────────────────
-const squadTemplateCmd = program
-  .command('squad-template')
-  .description('Squad template management for parallel execution');
-
-squadTemplateCmd
-  .command('list')
-  .description('List available squad templates')
-  .action((options) => squadTemplateListCommand(options));
-
-squadTemplateCmd
-  .command('use <template-id>')
-  .description('Configure a feature to use a squad template')
-  .option('--feature <feature>', 'Feature name (required)')
-  .action((id, options) => squadTemplateUseCommand(id, options));
-
-squadTemplateCmd
-  .command('show <template-id>')
-  .description('Show squad template details')
-  .option('--json', 'Output as JSON')
-  .action((id, options) => squadTemplateShowCommand(id, options));
-
-// ─────────────────────────────────────────────────────────────────────────────
-// Commands — Thread Templates
-// ─────────────────────────────────────────────────────────────────────────────
-const threadTemplateCmd = program
-  .command('thread-template')
-  .description('Thread type management');
-
-threadTemplateCmd
-  .command('list')
-  .description('List available thread types (B/P/F/L/Z-Thread)')
-  .action((options) => threadTemplateListCommand(options));
-
-threadTemplateCmd
-  .command('use <type>')
-  .description('Configure thread type for a feature')
-  .option('--feature <feature>', 'Feature name (required)')
-  .action((type, options) => threadTemplateUseCommand(type, options));
-
+mcpCommand
+  .command('setup [name]')
+  .description('Install and configure MCP servers')
+  .option('--list', 'Show MCP install status')
+  .option('--auto', 'Auto-install credential-free MCPs without prompts')
+  .action((name, options) => mcpSetupCommand(name, options));
 
 program.parse();

package/bin/task-manager.cjs

@@ -32,7 +32,7 @@ const chalk = {
  * Looks for headings like: ### T001 — Task title
  */
 async function parseTasksMd(featureName) {
-  const tasksPath = path.join(process.cwd(), `.morph/project/outputs/${featureName}/tasks.md`);
+  const tasksPath = path.join(process.cwd(), `.morph/features/${featureName}/tasks.md`);
   let content = '';
   try {
     content = await fs.readFile(tasksPath, 'utf-8');
@@ -423,7 +423,7 @@ class TaskManager {
 
       const outputPath = path.join(
         process.cwd(),
-        `.morph/project/outputs/${featureName}/metadata.json`
+        `.morph/features/${featureName}/metadata.json`
       );
 
       // Ensure directory exists

package/bin/validate.js

@@ -64,7 +64,7 @@ async function validateSpecVsTasks(projectPath, options = {}) {
     }
 
     for (const [featureName, feature] of Object.entries(state.features)) {
-      const outputsPath = path.join(projectPath, '.morph/project/outputs', featureName);
+      const outputsPath = path.join(projectPath, '.morph/features', featureName);
       const specPath = path.join(outputsPath, 'spec.md');
 
       if (!fs.existsSync(specPath)) {

package/claude-plugin.json

@@ -0,0 +1,14 @@
+{
+  "name": "morph-spec",
+  "version": "4.3.7",
+  "displayName": "MORPH-SPEC Framework",
+  "description": "Spec-driven development with 37 agents and 5-phase workflow for .NET/Blazor/Next.js",
+  "publisher": "polymorphism-tech",
+  "skills": {
+    "directory": "framework/skills",
+    "namespace": "morph-spec"
+  },
+  "hooks": {
+    "directory": "framework/hooks/claude-code"
+  }
+}