@polymorphism-tech/morph-spec 4.22.0 → 6.0.0

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

@@ -1,275 +0,0 @@
-/**
- * detect-agents — Detect relevant agents for a feature based on keywords
- *
- * Supports single string input (legacy) and multi-source TextSource[] input
- * with weighted keyword scoring. Also provides refreshAgents() for additive
- * agent detection at phase boundaries.
- *
- * Usage:
- *   morph-spec detect-agents <feature> [--proposal <path>] [--refresh] [--json] [--table]
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-import chalk from 'chalk';
-import { collectPhaseOutputs } from '../../lib/agents/output-collector.js';
-import { loadAgentsFile } from '../../lib/agents/agents-manager.js';
-import { loadState, saveState, addAgent } from '../../core/state/state-manager.js';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-
-/** Default path to agents.json in the installed package */
-const AGENTS_JSON_PATH = join(__dirname, '../../../framework/agents.json');
-
-/** Match weight constants */
-const MATCH_WEIGHTS = {
-  heading: 3,
-  body: 1,
-  domain: 2,
-};
-
-/**
- * Detect agents relevant to a feature.
- *
- * @param {string|Array<{source: string, content: string, weight: number}>} sourcesOrText - Text sources or legacy string
- * @param {Object} agentsJson - Parsed agents.json content
- * @param {Object} [opts] - Options
- * @param {string[]} [opts.excludeIds] - Agent IDs to exclude from detection
- * @returns {{ detected: Array<{id: string, reason: string, keywords_matched: string[], score: number, sources: Array}>, skipped: Array<{id: string, reason: string}> }}
- */
-export function detectAgents(sourcesOrText, agentsJson, opts = {}) {
-  // Backward compatibility: wrap string as single source
-  const sources = typeof sourcesOrText === 'string'
-    ? [{ source: 'proposal.md', content: sourcesOrText, weight: 1.0 }]
-    : sourcesOrText;
-
-  const allAgents = agentsJson.agents || {};
-  const excludeIds = new Set(opts.excludeIds || []);
-
-  const detected = [];
-  const skipped = [];
-
-  for (const [agentId, agentData] of Object.entries(allAgents)) {
-    if (excludeIds.has(agentId)) continue;
-    if (!agentData || typeof agentData !== 'object' || !agentData.tier) continue;
-
-    // Always-active agents (active_phases includes '*')
-    if (Array.isArray(agentData.active_phases) && agentData.active_phases.includes('*')) {
-      detected.push({
-        id: agentId,
-        reason: 'active_phases: *',
-        keywords_matched: [],
-        score: 0,
-        sources: [],
-      });
-      continue;
-    }
-
-    // Score across all sources
-    const keywords = agentData.keywords || [];
-    const domains = agentData.domains || [];
-    let totalScore = 0;
-    const allMatched = new Set();
-    const sourceBreakdown = [];
-
-    for (const src of sources) {
-      const textLower = src.content.toLowerCase();
-      const lines = src.content.split('\n');
-      let srcScore = 0;
-      const srcKeywords = [];
-
-      // Check keywords
-      for (const kw of keywords) {
-        const kwLower = kw.toLowerCase();
-        if (!textLower.includes(kwLower)) continue;
-
-        allMatched.add(kw);
-        srcKeywords.push(kw);
-
-        // Check if keyword appears in a heading line
-        const inHeading = lines.some(line =>
-          /^#{1,6}\s/.test(line) && line.toLowerCase().includes(kwLower)
-        );
-        srcScore += (inHeading ? MATCH_WEIGHTS.heading : MATCH_WEIGHTS.body) * src.weight;
-      }
-
-      // Check domains
-      for (const domain of domains) {
-        const domLower = domain.toLowerCase();
-        if (!textLower.includes(domLower)) continue;
-
-        allMatched.add(domain);
-        srcKeywords.push(domain);
-        srcScore += MATCH_WEIGHTS.domain * src.weight;
-      }
-
-      if (srcScore > 0) {
-        sourceBreakdown.push({
-          source: src.source,
-          keywords: srcKeywords,
-          score: srcScore,
-        });
-        totalScore += srcScore;
-      }
-    }
-
-    if (totalScore > 0) {
-      detected.push({
-        id: agentId,
-        reason: 'keyword',
-        keywords_matched: [...allMatched],
-        score: totalScore,
-        sources: sourceBreakdown,
-      });
-    } else {
-      skipped.push({
-        id: agentId,
-        reason: 'no_keyword_match',
-      });
-    }
-  }
-
-  return { detected, skipped };
-}
-
-/**
- * Refresh agent detection using all available phase outputs.
- * Additive only — never removes existing agents.
- *
- * @param {string} projectRoot - Absolute path
- * @param {string} featureName - Feature name
- * @returns {Promise<{added: Array, unchanged: number, total: number}>}
- */
-export async function refreshAgents(projectRoot, featureName) {
-  const state = loadState(false);
-  const feature = state?.features?.[featureName];
-  if (!feature) {
-    return { added: [], unchanged: 0, total: 0 };
-  }
-
-  const currentAgents = new Set(feature.activeAgents || []);
-
-  const sources = collectPhaseOutputs(projectRoot, featureName);
-  if (sources.length === 0) {
-    return { added: [], unchanged: currentAgents.size, total: currentAgents.size };
-  }
-
-  let agentsJson;
-  try {
-    agentsJson = loadAgentsFile(AGENTS_JSON_PATH);
-  } catch {
-    return { added: [], unchanged: currentAgents.size, total: currentAgents.size };
-  }
-  const { detected } = detectAgents(sources, agentsJson);
-
-  const added = detected.filter(a => !currentAgents.has(a.id));
-
-  // Additive: add new agents to state
-  for (const agent of added) {
-    await addAgent(featureName, agent.id);
-  }
-
-  return {
-    added,
-    unchanged: currentAgents.size,
-    total: currentAgents.size + added.length,
-  };
-}
-
-/**
- * Display detection diff after refresh.
- *
- * @param {{added: Array, unchanged: number, total: number}} result
- * @param {string} fromPhase
- * @param {string} toPhase
- */
-export function displayDetectionDiff(result, fromPhase, toPhase) {
-  console.log(chalk.cyan(`\nAgent Detection Refresh (${fromPhase} \u2192 ${toPhase}):`));
-
-  for (const agent of result.added) {
-    const kws = agent.keywords_matched.join('", "');
-    console.log(chalk.green(`  + ${agent.id.padEnd(24)} (keyword: "${kws}" | score: ${agent.score})`));
-  }
-
-  console.log(chalk.gray(`  = ${result.unchanged} agents unchanged`));
-  console.log(chalk.white(`  Total: ${result.total} active agents\n`));
-}
-
-/**
- * CLI command: morph-spec detect-agents <feature>
- */
-export async function detectAgentsCommand(featureName, options = {}) {
-  if (!featureName) {
-    console.error(chalk.red('Usage: morph-spec detect-agents <feature> [--proposal <path>] [--refresh] [--json] [--table]'));
-    process.exit(1);
-  }
-
-  // --refresh mode: use all phase outputs and mutate state
-  if (options.refresh) {
-    const result = await refreshAgents(process.cwd(), featureName);
-    if (options.json) {
-      console.log(JSON.stringify(result, null, 2));
-    } else {
-      displayDetectionDiff(result, 'manual', 'refresh');
-    }
-    return;
-  }
-
-  // Resolve proposal path
-  const proposalPath = options.proposal
-    || join(process.cwd(), `.morph/features/${featureName}/0-proposal/proposal.md`);
-
-  if (!existsSync(proposalPath)) {
-    console.error(chalk.red(`Proposal not found: ${proposalPath}`));
-    console.error(chalk.gray('Create the proposal first or use --proposal <path> to specify a custom path.'));
-    process.exit(1);
-  }
-
-  // Load agents.json
-  const agentsPath = options.agentsJson || AGENTS_JSON_PATH;
-  let agentsJson;
-  try {
-    agentsJson = loadAgentsFile(agentsPath);
-  } catch (err) {
-    console.error(chalk.red(err.message));
-    process.exit(1);
-  }
-
-  const proposalText = readFileSync(proposalPath, 'utf8');
-
-  const result = detectAgents(proposalText, agentsJson, {
-    excludeIds: options.exclude ? options.exclude.split(',') : [],
-  });
-
-  const output = {
-    feature: featureName,
-    ...result,
-  };
-
-  if (options.table) {
-    // Human-readable table
-    console.log(chalk.bold(`\n  Detected Agents \u2014 ${featureName}`));
-    console.log('  ' + '\u2500'.repeat(62));
-
-    if (result.detected.length > 0) {
-      console.log(`  ${'ID'.padEnd(28)} ${'Reason'.padEnd(16)} Keywords`);
-      console.log('  ' + '\u2500'.repeat(62));
-      for (const agent of result.detected) {
-        const reason = agent.reason === 'active_phases: *' ? 'always' : agent.reason;
-        const kw = agent.keywords_matched.length > 0 ? agent.keywords_matched.join(', ') : '\u2014';
-        console.log(
-          `  ${agent.id.padEnd(28)} ${chalk.cyan(reason.padEnd(16))} ${kw}`
-        );
-      }
-    } else {
-      console.log(chalk.gray('  No agents detected.'));
-    }
-
-    console.log(`\n  Skipped: ${result.skipped.length} agents (no keyword match)`);
-    console.log();
-  } else {
-    // JSON output (default)
-    console.log(JSON.stringify(output, null, 2));
-  }
-}