@polymorphism-tech/morph-spec 4.3.7 → 4.6.0

package/src/commands/analytics/analytics.js

@@ -1,176 +0,0 @@
-/**
- * Analytics CLI command — Metrics dashboards
- *
- * Usage:
- *   morph-spec analytics feature <name>
- *   morph-spec analytics context <name>
- *   morph-spec analytics project [--period=30d]
- */
-
-import chalk from 'chalk';
-import {
-  getFeatureAnalytics, getProjectAnalytics,
-  generateAsciiChart, generateTimelineChart,
-  recordEvent
-} from '../../lib/analytics/analytics-engine.js';
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-// ============================================================================
-// Feature Analytics Dashboard
-// ============================================================================
-
-export async function analyticsFeatureCommand(featureName, options) {
-  try {
-    const analytics = getFeatureAnalytics(featureName);
-
-    console.log(chalk.cyan(`\n  Feature Analytics — ${featureName}\n`));
-    console.log('  ' + '─'.repeat(50));
-
-    console.log(`\n  Threads:`);
-    for (const [status, count] of Object.entries(analytics.threads)) {
-      console.log(`    ${status.padEnd(12)} ${count}`);
-    }
-
-    console.log(`\n  Performance:`);
-    console.log(`    Checkpoint pass rate:  ${analytics.checkpointPassRate}%`);
-    console.log(`    Total duration:        ${formatDuration(analytics.totalDuration)}`);
-    console.log(`    Total tool calls:      ${analytics.totalToolCalls}`);
-    console.log(`    Total tokens used:     ${analytics.totalTokensUsed.toLocaleString()}`);
-    console.log(`    Context optimizations: ${analytics.optimizationEvents}`);
-
-    if (Object.keys(analytics.threads).length > 0) {
-      console.log('\n' + generateAsciiChart(analytics.threads, { title: 'Threads by Status' }));
-    }
-
-    console.log('');
-  } catch (err) {
-    console.error(chalk.red(`Error: ${err.message}`));
-    process.exit(1);
-  }
-}
-
-// ============================================================================
-// Context Analytics Dashboard
-// ============================================================================
-
-export async function analyticsContextCommand(featureName, options) {
-  try {
-    // Load context events from JSONL
-    const contextLogPath = join(process.cwd(), '.morph/analytics/context-log.jsonl');
-
-    if (!existsSync(contextLogPath)) {
-      console.log(chalk.gray(`  No context analytics found for: ${featureName}`));
-      console.log(chalk.gray('  Run a session with context tracking to populate analytics.\n'));
-      return;
-    }
-
-    const lines = readFileSync(contextLogPath, 'utf8').trim().split('\n').filter(Boolean);
-    const events = lines.map(l => { try { return JSON.parse(l); } catch { return null; } }).filter(Boolean);
-    const featureEvents = events.filter(e => e.feature === featureName);
-
-    const tokenSamples = featureEvents.filter(e => e.type === 'token_usage');
-    const criticalMoments = featureEvents.filter(e => e.type === 'context_critical');
-    const optimizations = featureEvents.filter(e => e.type === 'context_optimized');
-
-    console.log(chalk.cyan(`\n  Context Analytics — ${featureName}\n`));
-    console.log('  ' + '─'.repeat(50));
-
-    if (tokenSamples.length === 0) {
-      console.log(chalk.gray('  No token usage data available.\n'));
-      return;
-    }
-
-    const avgTokens = Math.round(tokenSamples.reduce((s, e) => s + (e.data?.tokensUsed || 0), 0) / tokenSamples.length);
-    const peakTokens = Math.max(...tokenSamples.map(e => e.data?.tokensUsed || 0));
-    const avgUtilization = Math.round(tokenSamples.reduce((s, e) => s + (e.data?.utilization || 0), 0) / tokenSamples.length * 100);
-
-    console.log(`\n  Token Usage:`);
-    console.log(`    Average tokens:      ${avgTokens.toLocaleString()}`);
-    console.log(`    Peak tokens:         ${peakTokens.toLocaleString()}`);
-    console.log(`    Avg utilization:     ${avgUtilization}%`);
-    console.log(`    Critical moments:    ${criticalMoments.length}`);
-    console.log(`    Optimizations applied: ${optimizations.length}`);
-
-    // Optimization opportunities
-    if (criticalMoments.length > 0) {
-      console.log(chalk.yellow('\n  ⚠ Optimization Opportunities:'));
-      const recs = criticalMoments.flatMap(e => e.data?.recommendations || []);
-      const uniqueStrategies = [...new Set(recs.map(r => r.strategy))];
-      for (const strategy of uniqueStrategies) {
-        const rec = recs.find(r => r.strategy === strategy);
-        console.log(`    • ${strategy}: ${rec?.description || ''}`);
-        console.log(`      Savings: ${rec?.estimatedSavings || 'unknown'}`);
-      }
-    }
-
-    console.log('');
-  } catch (err) {
-    console.error(chalk.red(`Error: ${err.message}`));
-    process.exit(1);
-  }
-}
-
-// ============================================================================
-// Project-Wide Dashboard
-// ============================================================================
-
-export async function analyticsProjectCommand(options) {
-  try {
-    const analytics = getProjectAnalytics();
-
-    console.log(chalk.cyan(`\n  Project Analytics Dashboard — ${analytics.period}\n`));
-    console.log('  ' + '═'.repeat(55));
-
-    console.log(`\n  📊 Overview`);
-    console.log(`    Features tracked:   ${analytics.features}`);
-    console.log(`    Total threads:      ${analytics.threads.total}`);
-    console.log(`      Completed:        ${analytics.threads.completed}`);
-    console.log(`      Failed:           ${analytics.threads.failed}`);
-
-    console.log(`\n  ✓ Checkpoints`);
-    console.log(`    Total run:          ${analytics.checkpoints.total}`);
-    console.log(`    Passed:             ${analytics.checkpoints.passed}`);
-    console.log(`    Pass rate:          ${analytics.checkpoints.passRate}%`);
-
-    if (analytics.checkpoints.total > 0) {
-      const bar = buildBar(analytics.checkpoints.passRate, 30);
-      console.log(`    ${bar}`);
-    }
-
-    console.log(`\n  ⫸ Parallelization`);
-    console.log(`    Avg concurrency:    ${analytics.parallelization.avgConcurrency}x`);
-    console.log(`    Parallel threads:   ${analytics.parallelization.parallelThreads}`);
-
-    console.log(`\n  ⚡ Trust & Auto-Approval`);
-    console.log(`    Auto-approvals:     ${analytics.trust.autoApprovals}`);
-    console.log(`    Trust level changes: ${analytics.trust.trustChanges}`);
-
-    console.log(`\n  🧠 Context`);
-    console.log(`    Avg tokens/session: ${analytics.context.avgTokensPerSession.toLocaleString()}`);
-    console.log(`    Optimizations:      ${analytics.context.optimizations}`);
-
-    console.log('\n  ' + '─'.repeat(55));
-    console.log('');
-  } catch (err) {
-    console.error(chalk.red(`Error: ${err.message}`));
-    process.exit(1);
-  }
-}
-
-// ============================================================================
-// Helpers
-// ============================================================================
-
-function formatDuration(seconds) {
-  if (!seconds) return '—';
-  if (seconds < 60) return `${seconds}s`;
-  if (seconds < 3600) return `${Math.floor(seconds / 60)}m ${seconds % 60}s`;
-  return `${Math.floor(seconds / 3600)}h ${Math.floor((seconds % 3600) / 60)}m`;
-}
-
-function buildBar(pct, width) {
-  const filled = Math.round(pct / 100 * width);
-  const color = pct >= 90 ? chalk.green : pct >= 70 ? chalk.yellow : chalk.red;
-  return color('[' + '█'.repeat(filled) + '░'.repeat(width - filled) + `] ${pct}%`);
-}

package/src/commands/context/context-prime.js

@@ -1,63 +0,0 @@
-/**
- * Context Prime CLI command — Load minimal context priming files
- *
- * Usage:
- *   morph-spec prime feature   (outputs feature-prime.md to stdout)
- *   morph-spec prime bug
- *   morph-spec prime refactor
- *   morph-spec prime design
- *   morph-spec prime infra
- */
-
-import chalk from 'chalk';
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-const PRIME_FILES = {
-  feature: '.morph/context/feature-prime.md',
-  bug: '.morph/context/bug-prime.md',
-  refactor: '.morph/context/refactor-prime.md',
-  design: '.morph/context/design-prime.md',
-  infra: '.morph/context/infra-prime.md'
-};
-
-const PRIME_TYPES = Object.keys(PRIME_FILES);
-
-export async function contextPrimeCommand(type, options) {
-  if (!type) {
-    console.log(chalk.cyan('\n  Available prime types:\n'));
-    for (const [key, path] of Object.entries(PRIME_FILES)) {
-      const exists = existsSync(join(process.cwd(), path));
-      const status = exists ? chalk.green('✓') : chalk.red('✗');
-      console.log(`  ${status} ${key.padEnd(10)} → ${path}`);
-    }
-    console.log('');
-    console.log(chalk.gray('  Usage: morph-spec prime <type>'));
-    console.log(chalk.gray('  Example: morph-spec prime feature\n'));
-    return;
-  }
-
-  if (!PRIME_TYPES.includes(type)) {
-    console.error(chalk.red(`Unknown prime type: ${type}`));
-    console.error(chalk.gray(`Valid types: ${PRIME_TYPES.join(', ')}`));
-    process.exit(1);
-  }
-
-  const filePath = join(process.cwd(), PRIME_FILES[type]);
-
-  if (!existsSync(filePath)) {
-    console.error(chalk.red(`Prime file not found: ${filePath}`));
-    console.error(chalk.gray('Run `morph-spec init` to initialize MORPH-SPEC files.'));
-    process.exit(1);
-  }
-
-  const content = readFileSync(filePath, 'utf8');
-
-  if (options.json) {
-    console.log(JSON.stringify({ type, path: filePath, content }));
-    return;
-  }
-
-  // Output to stdout — designed to be read into context
-  console.log(content);
-}

package/src/commands/context/core-four.js

@@ -1,54 +0,0 @@
-/**
- * Core Four CLI command — Context/Model/Prompt/Tools dashboard
- *
- * Usage:
- *   morph-spec core-four <feature>
- *   morph-spec core-four <feature> --json
- */
-
-import chalk from 'chalk';
-import { getCoreFour, formatCoreFour, initCoreFour } from '../../lib/context/core-four-tracker.js';
-import { loadState } from '../../core/state/state-manager.js';
-
-export async function coreFourCommand(featureName, options) {
-  try {
-    // Initialize with defaults if not already set
-    initCoreFour({
-      model: 'claude-sonnet-4-6',
-      contextWindow: 200000,
-      feature: featureName
-    });
-
-    // Try to populate context breakdown from feature state
-    try {
-      const state = loadState(false);
-      if (state?.features?.[featureName]) {
-        const feature = state.features[featureName];
-        // Attempt to estimate context breakdown from known files
-        const breakdown = {
-          'CLAUDE.md': 23000,
-          standards: feature.activeAgents ? feature.activeAgents.length * 500 : 0,
-          spec: feature.outputs?.includes('spec') ? 8000 : 0,
-          conversation: 5000,
-          other: 2000
-        };
-        const { updateContextBreakdown } = await import('../../lib/context/core-four-tracker.js');
-        updateContextBreakdown(breakdown);
-      }
-    } catch {
-      // Best-effort
-    }
-
-    if (options.json) {
-      const data = getCoreFour();
-      console.log(JSON.stringify(data, null, 2));
-      return;
-    }
-
-    console.log('\n' + formatCoreFour());
-    console.log('');
-  } catch (err) {
-    console.error(chalk.red(`Error: ${err.message}`));
-    process.exit(1);
-  }
-}

package/src/commands/generation/generate-context.js

@@ -1,40 +0,0 @@
-/**
- * @fileoverview Generate Context Command
- *
- * CLI: morph-spec generate context [feature]
- *
- * Generates CONTEXT.md (project-level) or CONTEXT-{feature}.md (feature-level)
- * with all relevant project data for Claude's consumption.
- *
- * @module generate-context
- */
-
-import { generateContext } from '../../lib/generators/context-generator.js';
-
-/**
- * Generate context files
- * @param {string} projectPath - Root path of the project
- * @param {string} featureName - Optional feature name
- * @returns {Promise<void>}
- */
-export async function generateContextCommand(projectPath, featureName = null) {
-  console.log('📄 Generating CONTEXT files...\n');
-
-  try {
-    const results = await generateContext(projectPath, featureName);
-
-    console.log('✅ Generated:');
-    console.log(`   - ${results.projectContext}`);
-
-    if (results.featureContext) {
-      console.log(`   - ${results.featureContext}`);
-    }
-
-    console.log('\n💡 Use these files to provide full context to Claude Code.');
-
-  } catch (err) {
-    console.error('❌ Error generating context:');
-    console.error(`   ${err.message}`);
-    process.exit(1);
-  }
-}

package/src/commands/project/detect-agents.js

@@ -1,207 +0,0 @@
-import { readFileSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-import { logger } from '../../utils/logger.js';
-import { analyzeRequestComplexity } from '../../lib/analysis/complexity-analyzer.js';
-import { LearningSystem } from '../../lib/learning/learning-system.js';
-import { loadStandardsForAgent, getStandardsListForAgent } from '../../lib/standards/standards-context-injector.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const frameworkRoot = join(__dirname, '..', '..', '..');
-
-function loadAgentsConfig() {
-  try {
-    const configPath = join(frameworkRoot, '.morph/config/agents.json');
-    const content = readFileSync(configPath, 'utf8');
-    return JSON.parse(content);
-  } catch (err) {
-    logger.error(`Failed to load agents config: ${err.message}`);
-    process.exit(1);
-  }
-}
-
-function detectAgents(userInput, config) {
-  const input = userInput.toLowerCase();
-
-  // MORPH 3.0 Hierarchical: agents is a flat object, not arrays
-  const allAgents = Object.entries(config.agents || {})
-    .filter(([id]) => !id.startsWith('_comment'))
-    .map(([id, agent]) => ({ id, ...agent }));
-
-  // Core agents = always_active agents (typically Tier 1)
-  const coreAgents = allAgents.filter(a => a.always_active === true);
-  const coreIds = coreAgents.map(a => a.id);
-
-  // Specialist agents = keyword-matched agents
-  const specialistMatches = [];
-
-  for (const agent of allAgents) {
-    if (agent.always_active) continue; // Skip core agents
-
-    // MORPH 3.0.1: Check negative keywords first — if any match, skip agent entirely
-    const negativeKeywords = agent.negativeKeywords || [];
-    const hasNegativeMatch = negativeKeywords.some(neg =>
-      input.includes(neg.toLowerCase())
-    );
-    if (hasNegativeMatch) continue;
-
-    // MORPH 3.0: keywords is directly on agent, not nested in autoActivation
-    const keywords = agent.keywords || [];
-    const matchedKeywords = [];
-
-    for (const keyword of keywords) {
-      if (input.includes(keyword.toLowerCase())) {
-        matchedKeywords.push(keyword);
-      }
-    }
-
-    if (matchedKeywords.length > 0) {
-      specialistMatches.push({
-        id: agent.id,
-        name: agent.title || agent.id, // Use title as name
-        emoji: agent.teammate?.icon || '🤖',
-        matchedKeywords,
-        matchCount: matchedKeywords.length
-      });
-    }
-  }
-
-  specialistMatches.sort((a, b) => b.matchCount - a.matchCount);
-
-  const specialistIds = specialistMatches.map(m => m.id);
-  const allIds = [...new Set([...coreIds, ...specialistIds])];
-
-  return {
-    core: coreIds,
-    specialists: specialistIds,
-    all: allIds,
-    matches: specialistMatches,
-    input: userInput
-  };
-}
-
-function formatVerbose(result) {
-  logger.blank();
-  logger.header('AGENT DETECTION RESULT');
-  logger.info(`Input: ${chalk.white(result.input)}`);
-  logger.blank();
-
-  logger.header('CORE AGENTS (always active)');
-  result.core.forEach(id => {
-    logger.info(`  ${chalk.green('✓')} ${id}`);
-  });
-  logger.blank();
-
-  if (result.matches.length > 0) {
-    logger.header('SPECIALIST AGENTS (keyword matched)');
-    result.matches.forEach(match => {
-      logger.info(`  ${match.emoji} ${chalk.yellow(match.name)} (${match.matchCount} matches)`);
-      logger.dim(`     Keywords: ${match.matchedKeywords.join(', ')}`);
-    });
-  } else {
-    logger.dim('  No specialist agents matched');
-  }
-
-  logger.blank();
-  logger.info(`Total: ${chalk.cyan(result.all.length)} agents activated`);
-  logger.blank();
-}
-
-export { detectAgents, loadAgentsConfig };
-
-export function detectAgentsCommand(input, options) {
-  const userInput = Array.isArray(input) ? input.join(' ') : input;
-
-  if (!userInput) {
-    logger.error('User input is required');
-    logger.dim('Usage: morph-spec detect-agents "your feature description"');
-    process.exit(1);
-  }
-
-  const config = loadAgentsConfig();
-  const result = detectAgents(userInput, config);
-
-  // Stack-aware filtering: penalize stack-mismatched agents
-  try {
-    const projectConfigPath = join(process.cwd(), '.morph/config/config.json');
-    const projectConfig = JSON.parse(readFileSync(projectConfigPath, 'utf8'));
-    const stack = projectConfig?.project?.stack || projectConfig?.project?.language || '';
-    const isJsStack = stack === 'nodejs' || stack === 'javascript' || stack === 'nextjs';
-
-    if (isJsStack) {
-      const dotnetKeywords = ['dotnet', '.net', 'csharp', 'c#', 'blazor', 'razor', 'azure', 'bicep',
-        'ef core', 'entity framework', 'hangfire', 'mudblazor', 'fluent ui', 'asp.net'];
-      const hasExplicitDotnetRequest = dotnetKeywords.some(k => userInput.toLowerCase().includes(k));
-
-      if (!hasExplicitDotnetRequest) {
-        const dotnetAgents = new Set([
-          'dotnet-senior', 'azure-architect', 'ef-modeler', 'bicep-architect',
-          'blazor-builder', 'blazor-concurrency-validator', 'hangfire-orchestrator',
-          'azure-deploy-specialist'
-        ]);
-        result.core = result.core.filter(id => !dotnetAgents.has(id));
-        result.specialists = result.specialists.filter(id => !dotnetAgents.has(id));
-        result.all = result.all.filter(id => !dotnetAgents.has(id));
-        result.matches = result.matches.filter(m => !dotnetAgents.has(m.id));
-      }
-    }
-  } catch {
-    // Config not found or unreadable — skip stack filtering
-  }
-
-  // Enrich with complexity analysis
-  try {
-    result.complexity = analyzeRequestComplexity(userInput);
-    result.suggestedWorkflow = result.complexity.workflow;
-  } catch {
-    result.complexity = null;
-    result.suggestedWorkflow = 'standard';
-  }
-
-  // Enrich with learning suggestions
-  try {
-    const learner = new LearningSystem('.');
-    result.learningSuggestions = learner.getAllSuggestions();
-  } catch {
-    result.learningSuggestions = null;
-  }
-
-  // Enrich with skill paths for each detected agent
-  const allAgents = Object.entries(config.agents || {})
-    .filter(([id]) => !id.startsWith('_'))
-    .map(([id, agent]) => ({ id, ...agent }));
-  result.skillPaths = result.all
-    .map(id => {
-      const agent = allAgents.find(a => a.id === id);
-      return agent?.skillPath || null;
-    })
-    .filter(Boolean);
-
-  // Enrich with standards context when JSON output requested
-  if (options.json) {
-    const projectPath = process.cwd();
-    result.standardsSummary = {};
-
-    for (const agentId of result.all) {
-      const standardsList = getStandardsListForAgent(agentId);
-      const { fullContent } = loadStandardsForAgent(agentId, projectPath);
-
-      result.standardsSummary[agentId] = {
-        standards: standardsList,
-        fullContent: fullContent,
-        count: standardsList.length
-      };
-    }
-  }
-
-  if (options.json) {
-    console.log(JSON.stringify(result, null, 2));
-  } else if (options.verbose) {
-    formatVerbose(result);
-  } else if (options.idsOnly) {
-    result.all.forEach(id => console.log(id));
-  } else {
-    console.log(JSON.stringify(result.all));
-  }
-}