@polymorphism-tech/morph-spec 3.2.0 → 4.3.0

package/src/commands/{detect.js → project/detect.js}

@@ -1,104 +1,104 @@
-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 } 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);
-
-      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);
-  }
-}
+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 } 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);
+
+      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);
+  }
+}

package/src/commands/{doctor.js → project/doctor.js}

@@ -3,13 +3,13 @@ import { execSync } from 'child_process';
 import { platform } from 'os';
 import fs from 'fs-extra';
 import chalk from 'chalk';
-import { logger } from '../utils/logger.js';
-import { pathExists, readJson } from '../utils/file-copier.js';
+import { logger } from '../../utils/logger.js';
+import { pathExists, readJson } from '../../utils/file-copier.js';
 import {
   checkCLIOutdated,
   checkProjectOutdated,
   getInstalledCLIVersion
-} from '../utils/version-checker.js';
+} from '../../utils/version-checker.js';
 
 const isWindows = platform() === 'win32';
 
@@ -52,7 +52,224 @@ function getNpmGlobalPrefix() {
   }
 }
 
-export async function doctorCommand() {
+// lib files
+const V3_LIB_FILES = [
+  'src/lib/analytics/analytics-engine.js',
+  'src/lib/tracking/artifact-trail.js',
+  'src/lib/context/context-bundler.js',
+  'src/lib/context/context-optimizer.js',
+  'src/lib/context/context-tracker.js',
+  'src/lib/context/core-four-tracker.js',
+  'src/lib/execution/fusion-executor.js',
+  'src/lib/hops/hop-composer.js',
+  'src/lib/context/mcp-optimizer.js',
+  'src/lib/agents/micro-agent-factory.js',
+  'src/lib/execution/parallel-executor.js',
+  'src/lib/hooks/stop-hook-executor.js',
+  'src/lib/threads/thread-coordinator.js',
+  'src/lib/threads/thread-manager.js',
+  'src/lib/trust/trust-manager.js'
+];
+
+// v3.0 command files (top-level new commands)
+const V3_COMMAND_FILES = [
+  'src/commands/agents-fuse.js',
+  'src/commands/analytics.js',
+  'src/commands/context-prime.js',
+  'src/commands/core-four.js',
+  'src/commands/mcp.js',
+  'src/commands/micro-agent.js',
+  'src/commands/squad-template.js',
+  'src/commands/thread-template.js',
+  'src/commands/threads.js',
+  'src/commands/trust.js'
+];
+
+// v3.0 HOP templates (meta-prompts)
+const V3_HOP_TEMPLATES = [
+  'framework/templates/meta-prompts/squad-leaders/backend-squad.md',
+  'framework/templates/meta-prompts/squad-leaders/frontend-squad.md',
+  'framework/templates/meta-prompts/parallel-workers/parallel-worker.md',
+  'framework/templates/meta-prompts/parallel-workers/parallel-coordinator.md',
+  'framework/templates/meta-prompts/hops/hop-wrapper.md',
+  'framework/templates/meta-prompts/hops/hop-retry.md',
+  'framework/templates/meta-prompts/hops/hop-validation.md',
+  'framework/templates/meta-prompts/validators/checkpoint-validator.md',
+  'framework/templates/meta-prompts/validators/pre-commit-validator.md',
+  'framework/templates/meta-prompts/fusion/fusion-agent.md',
+  'framework/templates/meta-prompts/fusion/fusion-aggregator.md',
+  'framework/templates/meta-prompts/REGISTRY.json'
+];
+
+// v3.0 new standards (framework-level)
+const V3_STANDARDS = [
+  'framework/standards/observability/monitoring.md',
+  'framework/standards/observability/logging.md',
+  'framework/standards/observability/tracing.md',
+  'framework/standards/observability/metrics.md',
+  'framework/standards/integration/event-driven/service-bus.md',
+  'framework/standards/integration/event-driven/cqrs.md',
+  'framework/standards/integration/event-driven/event-sourcing.md',
+  'framework/standards/data/nosql/cosmos-db.md',
+  'framework/standards/data/nosql/cache/redis.md',
+  'framework/standards/data/nosql/blob-storage.md',
+  'framework/standards/integration/api/rest-design.md',
+  'framework/standards/integration/api/graphql.md',
+  'framework/standards/integration/api/grpc.md',
+  'framework/standards/architecture/ddd/aggregates.md',
+  'framework/standards/architecture/ddd/entities.md',
+  'framework/standards/architecture/ddd/value-objects.md',
+  'framework/standards/data/vector-search/azure-ai-search.md',
+  'framework/standards/data/vector-search/rag-chunking.md',
+  'framework/standards/context/priming.md',
+  'framework/standards/context/bundles.md',
+  'framework/standards/context/analytics.md',
+  'framework/standards/workflows/thread-management.md',
+  'framework/standards/workflows/parallel-execution.md'
+];
+
+// v3.0 new agents expected in agents.json
+const V3_NEW_AGENTS = [
+  'vector-search-expert',
+  'thread-orchestrator',
+  'context-optimizer',
+  'observability-expert'
+];
+
+/**
+ * Run v3.0-specific health checks
+ */
+async function doctorV3Command(frameworkRoot) {
+  console.log(chalk.bold('\n🔬 MORPH-SPEC v3.0 Health Check\n'));
+  console.log('─'.repeat(60));
+
+  const checks = [];
+  let hasErrors = false;
+  let hasWarnings = false;
+
+  const check = (name, passed, warnOnly = false, msg = '') => {
+    if (passed) {
+      checks.push({ name, status: 'ok' });
+    } else {
+      checks.push({ name, status: warnOnly ? 'warn' : 'missing', msg });
+      if (warnOnly) hasWarnings = true;
+      else hasErrors = true;
+    }
+  };
+
+  // ── 1. v3.0 Lib Files (15) ──────────────────────────────────────────────
+  console.log(chalk.cyan('\n  src/lib/ — v3.0 Core Libraries (15 files)'));
+  const missingLibs = [];
+  for (const f of V3_LIB_FILES) {
+    if (!(await pathExists(join(frameworkRoot, f)))) missingLibs.push(f.split('/').pop());
+  }
+  check(`v3.0 lib files (${V3_LIB_FILES.length - missingLibs.length}/${V3_LIB_FILES.length})`,
+    missingLibs.length === 0, false,
+    missingLibs.length > 0 ? `missing: ${missingLibs.join(', ')}` : '');
+
+  // ── 2. v3.0 Command Files (11) ──────────────────────────────────────────
+  console.log(chalk.cyan('\n  src/commands/ — v3.0 Command Files (11 files)'));
+  const missingCmds = [];
+  for (const f of V3_COMMAND_FILES) {
+    if (!(await pathExists(join(frameworkRoot, f)))) missingCmds.push(f.split('/').pop());
+  }
+  check(`v3.0 command files (${V3_COMMAND_FILES.length - missingCmds.length}/${V3_COMMAND_FILES.length})`,
+    missingCmds.length === 0, false,
+    missingCmds.length > 0 ? `missing: ${missingCmds.join(', ')}` : '');
+
+  // ── 3. HOP Templates (12) ───────────────────────────────────────────────
+  console.log(chalk.cyan('\n  framework/templates/meta-prompts/ — HOP Templates (12)'));
+  const missingHOPs = [];
+  for (const f of V3_HOP_TEMPLATES) {
+    if (!(await pathExists(join(frameworkRoot, f)))) missingHOPs.push(f.split('/').pop());
+  }
+  check(`HOP templates (${V3_HOP_TEMPLATES.length - missingHOPs.length}/${V3_HOP_TEMPLATES.length})`,
+    missingHOPs.length === 0, false,
+    missingHOPs.length > 0 ? `missing: ${missingHOPs.join(', ')}` : '');
+
+  // ── 4. New Standards (23) ───────────────────────────────────────────────
+  console.log(chalk.cyan('\n  framework/standards/ — v3.0 Standards (23 files)'));
+  const missingStds = [];
+  for (const f of V3_STANDARDS) {
+    if (!(await pathExists(join(frameworkRoot, f)))) missingStds.push(f.replace('framework/standards/', ''));
+  }
+  check(`v3.0 standards (${V3_STANDARDS.length - missingStds.length}/${V3_STANDARDS.length})`,
+    missingStds.length === 0, false,
+    missingStds.length > 0 ? `missing: ${missingStds.join(', ')}` : '');
+
+  // ── 5. New Agents in agents.json ────────────────────────────────────────
+  console.log(chalk.cyan('\n  .morph/config/agents.json — v3.0 Agents (4 new)'));
+  const agentsPath = join(frameworkRoot, '.morph/config/agents.json');
+  if (await pathExists(agentsPath)) {
+    try {
+      const agentsConfig = JSON.parse(await fs.readFile(agentsPath, 'utf8'));
+      const agents = agentsConfig.agents || {};
+      const missingAgents = V3_NEW_AGENTS.filter(id => !agents[id]);
+      check(`v3.0 agents (${V3_NEW_AGENTS.length - missingAgents.length}/${V3_NEW_AGENTS.length})`,
+        missingAgents.length === 0, false,
+        missingAgents.length > 0 ? `missing: ${missingAgents.join(', ')}` : '');
+    } catch {
+      check('agents.json parse', false, false, 'invalid JSON');
+    }
+  } else {
+    check('agents.json', false, false, 'file not found');
+  }
+
+  // ── 7. Zero-Touch Workflow Config ───────────────────────────────────────
+  console.log(chalk.cyan('\n  framework/workflows/ — Zero-Touch Config'));
+  const ztPath = join(frameworkRoot, 'framework/workflows/configs/zero-touch.json');
+  check('zero-touch.json workflow config', await pathExists(ztPath));
+
+  // ── 8. state.json v3.0 version ──────────────────────────────────────────
+  console.log(chalk.cyan('\n  .morph/state.json — Schema Version'));
+  const statePath = join(frameworkRoot, '.morph/state.json');
+  if (await pathExists(statePath)) {
+    try {
+      const state = JSON.parse(await fs.readFile(statePath, 'utf8'));
+      const isV3 = state.version === '3.0.0';
+      check(`state.json schema (v${state.version})`, isV3, true,
+        isV3 ? '' : 'run: morph-spec migrate v2-to-v3');
+    } catch {
+      check('state.json parse', false, false, 'invalid JSON');
+    }
+  } else {
+    check('state.json', false, true, 'not found (run: morph-spec state init)');
+  }
+
+  // ── Display ──────────────────────────────────────────────────────────────
+  console.log('\n' + '─'.repeat(60));
+  console.log(chalk.bold('\nResults:\n'));
+  for (const c of checks) {
+    if (c.status === 'ok') {
+      console.log(chalk.green(`  ✓ ${c.name}`));
+    } else if (c.status === 'warn') {
+      console.log(chalk.yellow(`  ⚠ ${c.name}`) + chalk.gray(c.msg ? ` (${c.msg})` : ''));
+    } else {
+      console.log(chalk.red(`  ✗ ${c.name}`) + chalk.gray(c.msg ? ` — ${c.msg}` : ''));
+    }
+  }
+
+  console.log('');
+  const passed = checks.filter(c => c.status === 'ok').length;
+  const total = checks.length;
+
+  if (hasErrors) {
+    console.log(chalk.red(`\n❌ ${passed}/${total} checks passed — run "morph-spec migrate v2-to-v3" to fix\n`));
+    process.exit(1);
+  } else if (hasWarnings) {
+    console.log(chalk.yellow(`\n⚠️  ${passed}/${total} checks passed (warnings only)\n`));
+  } else {
+    console.log(chalk.green(`\n✅ ${passed}/${total} — All v3.0 checks passed!\n`));
+  }
+}
+
+export async function doctorCommand(options = {}) {
+  // v3-specific check mode
+  if (options.v3) {
+    const frameworkRoot = process.cwd();
+    return doctorV3Command(frameworkRoot);
+  }
+
   const targetPath = process.cwd();
 
   logger.header('MORPH-SPEC Health Check');

package/src/commands/project/index.js

@@ -0,0 +1,10 @@
+/**
+ * Project-Level Commands
+ */
+export { initCommand } from './init.js';
+export { doctorCommand } from './doctor.js';
+export { detectCommand } from './detect.js';
+export { detectWorkflowCommand } from './detect-workflow.js';
+export { detectAgentsCommand } from './detect-agents.js';
+export { syncCommand } from './sync.js';
+export { updateCommand } from './update.js';