@polymorphism-tech/morph-spec 4.10.8 → 4.10.10

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

@@ -0,0 +1,74 @@
+/**
+ * project-metrics — Project-level metrics aggregation CLI
+ *
+ * Aggregates feature data from state.json into a project-wide summary.
+ *
+ * Usage:
+ *   morph-spec project-metrics [--json] [--save]
+ */
+
+import { writeFileSync, existsSync, mkdirSync } from 'fs';
+import { join } from 'path';
+import { loadState, stateExists } from '../../core/state/state-manager.js';
+import { aggregateProjectMetrics } from '../../lib/agents/metrics-aggregator.js';
+import chalk from 'chalk';
+
+/**
+ * CLI command: morph-spec project-metrics [--json] [--save]
+ */
+export async function projectMetricsCommand(options = {}) {
+  if (!stateExists()) {
+    console.error(chalk.red('No state.json found. Run morph-spec state init first.'));
+    process.exit(1);
+  }
+
+  try {
+    const state = loadState(false);
+    if (!state) {
+      console.error(chalk.red('Failed to load state.json.'));
+      process.exit(1);
+    }
+
+    const metrics = aggregateProjectMetrics(state);
+
+    if (options.save) {
+      const morphDir = join(process.cwd(), '.morph');
+      if (!existsSync(morphDir)) {
+        mkdirSync(morphDir, { recursive: true });
+      }
+      const outPath = join(morphDir, 'metrics.json');
+      writeFileSync(outPath, JSON.stringify(metrics, null, 2) + '\n', 'utf8');
+      console.log(chalk.green(`Metrics saved to ${outPath}`));
+    }
+
+    if (options.json) {
+      console.log(JSON.stringify(metrics, null, 2));
+      return;
+    }
+
+    // Human-readable table
+    const s = metrics.summary;
+    console.log(chalk.bold('\n  Project Metrics'));
+    console.log('  ' + '─'.repeat(50));
+    console.log(`  Features:      ${s.totalFeatures} (${s.completedFeatures} completed)`);
+    console.log(`  Tasks:         ${s.completedTasks}/${s.totalTasks} (${s.completionRate}%)`);
+    console.log(`  Avg tasks/feat: ${s.avgTasksPerFeature}`);
+    console.log(`  Dispatches:    ${s.totalDispatches}`);
+
+    if (metrics.features.length > 0) {
+      console.log(chalk.bold('\n  Features:'));
+      console.log(`  ${'Name'.padEnd(24)} ${'Phase'.padEnd(14)} ${'Tasks'.padEnd(10)} Dispatches`);
+      console.log('  ' + '─'.repeat(60));
+      for (const f of metrics.features) {
+        const taskStr = `${f.completedTasks}/${f.taskCount}`;
+        console.log(
+          `  ${f.name.padEnd(24)} ${chalk.cyan(f.phase.padEnd(14))} ${taskStr.padEnd(10)} ${f.dispatchCount}`
+        );
+      }
+    }
+    console.log();
+  } catch (err) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+}

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/standards/context-budget.js

@@ -0,0 +1,89 @@
+/**
+ * context-budget — Token budget tracking for standards context
+ *
+ * Shows estimated token usage for agent briefings built from STANDARDS.json digests.
+ *
+ * Usage:
+ *   morph-spec context-budget [--phase <phase>] [--json]
+ */
+
+import { readFileSync, existsSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { buildAgentBriefing, estimateTokens, clearCache } from '../../lib/standards/digest-builder.js';
+import chalk from 'chalk';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const AGENTS_JSON_PATH = join(__dirname, '../../../framework/agents.json');
+
+/**
+ * CLI command: morph-spec context-budget [--phase <phase>] [--json]
+ */
+export async function contextBudgetCommand(options = {}) {
+  const phase = options.phase || 'implement';
+
+  if (!existsSync(AGENTS_JSON_PATH)) {
+    console.error(chalk.red('framework/agents.json not found.'));
+    process.exit(1);
+  }
+
+  try {
+    clearCache();
+    const agentsData = JSON.parse(readFileSync(AGENTS_JSON_PATH, 'utf8'));
+    const allAgents = agentsData.agents || {};
+
+    const results = [];
+
+    for (const [agentId, agentData] of Object.entries(allAgents)) {
+      if (agentId.startsWith('_comment')) continue;
+      if (!agentData.standards || agentData.standards.length === 0) continue;
+
+      const briefing = buildAgentBriefing(agentId, phase);
+      if (!briefing) continue;
+
+      const tokens = estimateTokens(briefing);
+      results.push({
+        agentId,
+        tier: agentData.tier,
+        standardsCount: agentData.standards.length,
+        tokens,
+        overBudget: tokens > 8000,
+      });
+    }
+
+    // Sort by tokens descending
+    results.sort((a, b) => b.tokens - a.tokens);
+
+    const totalTokens = results.reduce((sum, r) => sum + r.tokens, 0);
+    const overBudget = results.filter(r => r.overBudget);
+
+    if (options.json) {
+      console.log(JSON.stringify({ phase, totalTokens, overBudgetCount: overBudget.length, agents: results }, null, 2));
+      return;
+    }
+
+    // Human-readable
+    console.log(chalk.bold(`\n  Context Budget — phase: ${phase}`));
+    console.log('  ' + '─'.repeat(62));
+    console.log(`  ${'Agent'.padEnd(32)} ${'Tier'.padEnd(6)} ${'Stds'.padEnd(6)} Tokens`);
+    console.log('  ' + '─'.repeat(62));
+
+    for (const r of results) {
+      const tokenStr = r.overBudget ? chalk.red(String(r.tokens)) : String(r.tokens);
+      const flag = r.overBudget ? ' ⚠' : '';
+      console.log(
+        `  ${r.agentId.padEnd(32)} ${String(r.tier).padEnd(6)} ${String(r.standardsCount).padEnd(6)} ${tokenStr}${flag}`
+      );
+    }
+
+    console.log('  ' + '─'.repeat(62));
+    console.log(`  Total: ${results.length} agents, ${totalTokens} tokens`);
+    if (overBudget.length > 0) {
+      console.log(chalk.yellow(`  ⚠ ${overBudget.length} agent(s) exceed 8000 token threshold`));
+    }
+    console.log();
+  } catch (err) {
+    console.error(chalk.red(`Error: ${err.message}`));
+    process.exit(1);
+  }
+}

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