@polymorphism-tech/morph-spec 4.8.19 → 4.10.0

package/src/lib/hops/hop-composer.js

@@ -1,221 +0,0 @@
-/**
- * HOP Composer — Higher-Order Prompt rendering and nesting
- *
- * Compiles Handlebars templates for agent prompts (HOPs).
- * Supports:
- *   - renderHOP(templatePath, variables) → compiled prompt string
- *   - composeHOPs(hopChain[], variables) → nested HOPs (outer wraps inner)
- *   - listAvailableHOPs() → scan meta-prompts/ and return HOPDescriptor[]
- *
- * Standard HOP variables auto-injected:
- *   FEATURE_NAME, AGENT_ID, MISSION, SPEC_SUMMARY, STANDARDS, TASKS,
- *   DELIVERABLES, CONSTRAINTS, DATE, TIMESTAMP
- */
-
-import { readFileSync, existsSync, readdirSync, statSync } from 'fs';
-import { join, relative, extname, basename } from 'path';
-
-const META_PROMPTS_DIR = join(process.cwd(), 'framework/templates/meta-prompts');
-const REGISTRY_PATH = join(process.cwd(), 'framework/templates/REGISTRY.json');
-
-// ============================================================================
-// Handlebars-Compatible Mini-Compiler
-// ============================================================================
-
-/**
- * Compile a Handlebars template with variables (subset of Handlebars features)
- * Supports: {{variable}}, {{#if condition}}...{{/if}}, {{#each array}}...{{/each}}
- * Also supports built-in helpers: {{pascalCase}}, {{camelCase}}, {{snakeCase}}
- *
- * @param {string} template - Handlebars template string
- * @param {Object} variables - Variables to inject
- * @returns {string} Compiled template
- */
-export function compileTemplate(template, variables) {
-  const vars = {
-    DATE: new Date().toISOString().split('T')[0],
-    TIMESTAMP: new Date().toISOString(),
-    ...injectCasedHelpers(variables),
-    ...variables
-  };
-
-  let result = template;
-
-  // 1. Process {{#if VAR}}...{{/if}} blocks
-  result = result.replace(/\{\{#if\s+(\w+)\}\}([\s\S]*?)\{\{\/if\}\}/g, (_, key, content) => {
-    return vars[key] ? content : '';
-  });
-
-  // 2. Process {{#each ARRAY}}...{{/each}} blocks
-  result = result.replace(/\{\{#each\s+(\w+)\}\}([\s\S]*?)\{\{\/each\}\}/g, (_, key, content) => {
-    const arr = vars[key];
-    if (!Array.isArray(arr)) return '';
-    return arr.map(item => {
-      const itemVars = typeof item === 'object' ? { ...vars, ...item, this: item } : { ...vars, this: item };
-      return compileTemplate(content, itemVars);
-    }).join('');
-  });
-
-  // 3. Process helper calls: {{pascalCase VARIABLE}}, {{camelCase VARIABLE}}, etc.
-  result = result.replace(/\{\{(pascalCase|camelCase|snakeCase|titleCase|pluralize)\s+(\w+)\}\}/g, (_, helper, key) => {
-    const value = String(vars[key] || '');
-    return applyHelper(helper, value);
-  });
-
-  // 4. Process simple {{VARIABLE}} substitutions
-  result = result.replace(/\{\{(\w+)\}\}/g, (_, key) => {
-    return vars[key] !== undefined ? String(vars[key]) : `{{${key}}}`;
-  });
-
-  return result;
-}
-
-function injectCasedHelpers(variables) {
-  const extras = {};
-  for (const [key, value] of Object.entries(variables)) {
-    if (typeof value === 'string') {
-      extras[`${key}_PASCAL`] = applyHelper('pascalCase', value);
-      extras[`${key}_CAMEL`] = applyHelper('camelCase', value);
-      extras[`${key}_SNAKE`] = applyHelper('snakeCase', value);
-    }
-  }
-  return extras;
-}
-
-function applyHelper(helper, value) {
-  const words = value.replace(/[-_\s]+/g, ' ').trim().split(' ');
-  switch (helper) {
-    case 'pascalCase':
-      return words.map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');
-    case 'camelCase':
-      return words[0].toLowerCase() + words.slice(1).map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join('');
-    case 'snakeCase':
-      return value.replace(/[-\s]+/g, '_').replace(/([a-z])([A-Z])/g, '$1_$2').toLowerCase();
-    case 'titleCase':
-      return words.map(w => w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join(' ');
-    case 'pluralize':
-      const last = value.slice(-1);
-      if (last === 'y') return value.slice(0, -1) + 'ies';
-      if (last === 's') return value;
-      return value + 's';
-    default:
-      return value;
-  }
-}
-
-// ============================================================================
-// HOP Rendering
-// ============================================================================
-
-/**
- * Render a HOP template with variables
- * @param {string} templatePath - Path to template (relative to meta-prompts/ or absolute)
- * @param {Object} variables - Variables to inject
- * @returns {string} Rendered prompt string
- */
-export function renderHOP(templatePath, variables = {}) {
-  // Resolve template path
-  const paths = [
-    templatePath,
-    join(META_PROMPTS_DIR, templatePath),
-    join(META_PROMPTS_DIR, templatePath + '.md'),
-    join(process.cwd(), templatePath)
-  ];
-
-  let resolved = null;
-  for (const p of paths) {
-    if (existsSync(p)) {
-      resolved = p;
-      break;
-    }
-  }
-
-  if (!resolved) {
-    throw new Error(`HOP template not found: ${templatePath}\nSearched: ${paths.join(', ')}`);
-  }
-
-  const template = readFileSync(resolved, 'utf8');
-  return compileTemplate(template, variables);
-}
-
-/**
- * Compose nested HOPs (outer wraps inner, variables bubble down)
- * @param {Array} hopChain - Array of { templatePath, variables } objects (outer first)
- * @param {Object} [sharedVariables] - Variables shared across all HOPs
- * @returns {string} Composed prompt string
- */
-export function composeHOPs(hopChain, sharedVariables = {}) {
-  if (!hopChain || hopChain.length === 0) {
-    throw new Error('hopChain must be a non-empty array');
-  }
-
-  if (hopChain.length === 1) {
-    return renderHOP(hopChain[0].templatePath, { ...sharedVariables, ...hopChain[0].variables });
-  }
-
-  // Render inner HOPs first, then wrap with outer
-  let innerContent = '';
-  for (let i = hopChain.length - 1; i >= 1; i--) {
-    const hop = hopChain[i];
-    const vars = { ...sharedVariables, ...hop.variables, INNER_PROMPT: innerContent };
-    innerContent = renderHOP(hop.templatePath, vars);
-  }
-
-  // Render outermost HOP with inner content
-  const outerHop = hopChain[0];
-  return renderHOP(outerHop.templatePath, {
-    ...sharedVariables,
-    ...outerHop.variables,
-    INNER_PROMPT: innerContent
-  });
-}
-
-// ============================================================================
-// HOP Discovery
-// ============================================================================
-
-/**
- * List all available HOPs from the meta-prompts directory
- * @returns {Array} Array of HOPDescriptor objects
- */
-export function listAvailableHOPs() {
-  if (!existsSync(META_PROMPTS_DIR)) return [];
-
-  const hops = [];
-  scanDir(META_PROMPTS_DIR, META_PROMPTS_DIR, hops);
-  return hops;
-}
-
-function scanDir(dir, baseDir, hops) {
-  if (!existsSync(dir)) return;
-
-  for (const entry of readdirSync(dir, { withFileTypes: true })) {
-    const fullPath = join(dir, entry.name);
-    if (entry.isDirectory()) {
-      scanDir(fullPath, baseDir, hops);
-    } else if (entry.name.endsWith('.md') || entry.name.endsWith('.hbs')) {
-      const relPath = relative(baseDir, fullPath);
-      const content = readFileSync(fullPath, 'utf8');
-      const firstLine = content.split('\n')[0] || '';
-      const description = firstLine.startsWith('#')
-        ? firstLine.replace(/^#+\s*/, '')
-        : 'Higher-Order Prompt template';
-
-      // Extract variables from template
-      const variables = [...new Set(
-        (content.match(/\{\{(\w+)\}\}/g) || [])
-          .map(m => m.replace(/\{\{|\}\}/g, ''))
-          .filter(v => !['if', 'each', 'this', 'else', 'pascalCase', 'camelCase', 'snakeCase', 'titleCase', 'pluralize'].includes(v))
-      )];
-
-      hops.push({
-        id: relPath.replace(/\\/g, '/').replace(/\.(md|hbs)$/, ''),
-        path: fullPath,
-        relativePath: relPath.replace(/\\/g, '/'),
-        description,
-        variables,
-        category: relPath.split(/[\\/]/)[0]
-      });
-    }
-  }
-}

package/src/lib/monitor/agent-resolver.js

@@ -1,144 +0,0 @@
-/**
- * Agent Resolver — Resolves active agents for a given phase
- *
- * Reads .morph/framework/agents.json (installed copy) or falls back to
- * framework/agents.json (source). Filters agents by phase and VSA config.
- */
-
-import { readFileSync, existsSync } from 'fs';
-import { join } from 'path';
-
-const AGENTS_PATHS = [
-  '.morph/framework/agents.json',
-  'framework/agents.json',
-];
-
-/**
- * Load agents.json from the project or framework source.
- *
- * @param {string} [cwd]
- * @returns {Object|null}
- */
-export function loadAgentsJson(cwd = process.cwd()) {
-  for (const rel of AGENTS_PATHS) {
-    const full = join(cwd, rel);
-    if (existsSync(full)) {
-      try {
-        return JSON.parse(readFileSync(full, 'utf-8'));
-      } catch {
-        // Try next path
-      }
-    }
-  }
-  return null;
-}
-
-/**
- * Determine which agents are active for the given phase.
- *
- * Rules:
- * - always_active: true → always included
- * - Agents with phase-scoped keywords matching the current phase
- * - VSA architecture: include vsa-architect, exclude domain-architect in phase-setup
- * - Tier-4 validators are always included in implement phase
- *
- * @param {string} [cwd]
- * @param {string} [phase]
- * @returns {{ tier1: Agent[], tier2: Agent[], tier3: Agent[], tier4: Agent[] }}
- */
-export function getActiveAgents(cwd = process.cwd(), phase = '') {
-  const data = loadAgentsJson(cwd);
-  if (!data?.agents) {
-    return { tier1: [], tier2: [], tier3: [], tier4: [] };
-  }
-
-  // Detect VSA config
-  let isVsa = false;
-  try {
-    const configPath = join(cwd, '.morph/config/config.json');
-    if (existsSync(configPath)) {
-      const cfg = JSON.parse(readFileSync(configPath, 'utf-8'));
-      isVsa = cfg?.config?.architecture?.style === 'vertical-slice';
-    }
-  } catch {
-    // Non-blocking
-  }
-
-  // Phase → active domains heuristic
-  const PHASE_DOMAINS = {
-    proposal: ['architecture', 'developer-experience', 'ai-orchestration'],
-    setup: ['architecture', 'developer-experience', 'ai-orchestration'],
-    design: ['architecture', 'dotnet', 'frontend', 'ai-orchestration'],
-    uiux: ['frontend', 'ui', 'architecture'],
-    clarify: ['architecture', 'developer-experience'],
-    tasks: ['architecture', 'dotnet', 'frontend', 'testing'],
-    implement: ['dotnet', 'frontend', 'testing', 'devops', 'blazor'],
-    sync: ['architecture', 'developer-experience'],
-  };
-
-  const activeDomains = new Set(PHASE_DOMAINS[phase] || Object.values(PHASE_DOMAINS).flat());
-
-  const result = { tier1: [], tier2: [], tier3: [], tier4: [] };
-
-  for (const [name, agent] of Object.entries(data.agents)) {
-    if (name.startsWith('_comment')) continue;
-
-    const tier = agent.tier;
-    if (!tier || tier < 1 || tier > 4) continue;
-
-    const tierKey = `tier${tier}`;
-
-    // Always-active agents
-    if (agent.always_active === true) {
-      // VSA: swap domain-architect for vsa-architect
-      if (name === 'domain-architect' && isVsa) continue;
-      result[tierKey].push({ name, ...agent });
-      continue;
-    }
-
-    // VSA architect: only active when VSA config is set
-    if (name === 'vsa-architect') {
-      if (isVsa && (phase === 'setup' || phase === 'design')) {
-        result[tierKey].push({ name, ...agent });
-      }
-      continue;
-    }
-
-    // Tier-4 validators: active in implement phase
-    if (tier === 4) {
-      if (phase === 'implement' || phase === 'sync') {
-        result[tierKey].push({ name, ...agent });
-      }
-      continue;
-    }
-
-    // Domain-based activation
-    const agentDomains = agent.domains || [];
-    const isActive = agentDomains.some(d => activeDomains.has(d));
-    if (isActive) {
-      result[tierKey].push({ name, ...agent });
-    }
-  }
-
-  return result;
-}
-
-/**
- * Get icon for an agent based on its teammate config or tier.
- *
- * @param {Object} agent
- * @returns {string}
- */
-export function getAgentIcon(agent) {
-  return agent.teammate?.icon || '';
-}
-
-/**
- * Count total active agents across all tiers.
- *
- * @param {{ tier1: any[], tier2: any[], tier3: any[], tier4: any[] }} agentsByTier
- * @returns {number}
- */
-export function countActiveAgents(agentsByTier) {
-  return Object.values(agentsByTier).flat().length;
-}

package/src/lib/monitor/renderer.js

@@ -1,230 +0,0 @@
-/**
- * Monitor Renderer — TUI rendering utilities for `morph-spec monitor`
- *
- * Uses chalk (already a project dependency) + native box-drawing characters.
- * No additional dependencies required.
- */
-
-import chalk from 'chalk';
-
-// Box-drawing characters
-const BOX = {
-  tl: '┌', tr: '┐', bl: '└', br: '┘',
-  h: '─', v: '│',
-};
-
-const TIER_ICONS = {
-  1: '🎯',
-  2: '⚙️ ',
-  3: '🔧',
-  4: '✅',
-};
-
-const EVENT_COLORS = {
-  SessionStart: 'cyan',
-  UserPromptSubmit: 'yellow',
-  PreToolUse: 'magenta',
-  PostToolUse: 'blue',
-  PostToolUseFailure: 'red',
-  Stop: 'gray',
-  PreCompact: 'gray',
-  Notification: 'white',
-};
-
-/**
- * Render a bordered box with a title and lines of content.
- *
- * @param {string[]} lines   - Content lines
- * @param {string}   color   - chalk color name ('green'|'blue'|'yellow'|'magenta'|'cyan'|'red'|'white')
- * @param {string}   [title] - Optional title shown in top border
- * @param {number}   [width] - Box width (default: 70)
- * @returns {string}
- */
-export function renderBox(lines, color, title = '', width = 70) {
-  const paint = chalk[color] || chalk.white;
-  const innerWidth = width - 2;
-
-  // Top border with optional title
-  let topBorder;
-  if (title) {
-    const titleText = ` ${title} `;
-    const remaining = innerWidth - titleText.length;
-    const left = Math.max(0, Math.floor(remaining / 2));
-    const right = Math.max(0, remaining - left);
-    topBorder = paint(BOX.tl + BOX.h.repeat(left) + titleText + BOX.h.repeat(right) + BOX.tr);
-  } else {
-    topBorder = paint(BOX.tl + BOX.h.repeat(innerWidth) + BOX.tr);
-  }
-
-  const bottomBorder = paint(BOX.bl + BOX.h.repeat(innerWidth) + BOX.br);
-
-  const contentLines = lines.map(line => {
-    const truncated = line.length > innerWidth - 2
-      ? line.slice(0, innerWidth - 5) + '...'
-      : line;
-    const padded = truncated.padEnd(innerWidth - 2);
-    return paint(BOX.v) + '  ' + padded + paint(BOX.v);
-  });
-
-  return [topBorder, ...contentLines, bottomBorder].join('\n');
-}
-
-/**
- * Render the chronological hook event feed.
- *
- * @param {Array<{name: string, event: string, result: string, ts: string}>} hooks
- * @param {number} [maxItems] - Max events to show (most recent first)
- * @returns {string}
- */
-export function renderFeed(hooks, maxItems = 12) {
-  if (!hooks || hooks.length === 0) {
-    return renderBox(['  No hook events yet this session.'], 'blue', '🪝 HOOK EVENTS');
-  }
-
-  const recent = [...hooks].reverse().slice(0, maxItems);
-  const lines = recent.map(h => {
-    const color = EVENT_COLORS[h.event] || 'white';
-    const eventLabel = chalk[color] ? chalk[color](h.event) : h.event;
-    return `${h.ts}  ${chalk.bold(h.name)}  ${eventLabel}  → ${h.result}`;
-  });
-
-  return renderBox(lines, 'blue', '🪝 HOOK EVENTS');
-}
-
-/**
- * Render the agents view, grouped by tier.
- *
- * @param {Object} agentsByTier - { tier1: [...], tier2: [...], tier3: [...], tier4: [...] }
- * @param {string} phase
- * @returns {string}
- */
-export function renderAgents(agentsByTier, phase) {
-  const lines = [`Phase: ${chalk.bold(phase || 'unknown')}`];
-  lines.push('');
-
-  for (const [tierKey, agents] of Object.entries(agentsByTier)) {
-    const tierNum = parseInt(tierKey.replace('tier', ''));
-    const icon = TIER_ICONS[tierNum] || '  ';
-    if (!agents || agents.length === 0) continue;
-    const names = agents.map(a => a.name).join('  ·  ');
-    lines.push(`T${tierNum} ${icon}  ${names}`);
-  }
-
-  if (lines.length <= 2) {
-    lines.push('  No active agents for this phase.');
-  }
-
-  const total = Object.values(agentsByTier).flat().length;
-  return renderBox(lines, 'magenta', `🤖 AGENTS ATIVOS (${total} de 39)`);
-}
-
-/**
- * Render the skills view.
- *
- * @param {Array<{name: string, ts: string}>} skills - Skills invoked this session
- * @param {string[]} [available] - Available skill names
- * @returns {string}
- */
-export function renderSkills(skills, available = []) {
-  const lines = [];
-
-  if (skills && skills.length > 0) {
-    lines.push('Invocadas nesta sessão:');
-    for (const s of [...skills].reverse()) {
-      lines.push(`  ${s.ts}  🎯 ${s.name}`);
-    }
-  } else {
-    lines.push('  Nenhuma skill invocada nesta sessão.');
-  }
-
-  if (available.length > 0) {
-    lines.push('');
-    lines.push(`Disponíveis: ${available.slice(0, 8).join(', ')}${available.length > 8 ? ` (+${available.length - 8})` : ''}`);
-  }
-
-  return renderBox(lines, 'yellow', '🎯 SKILLS');
-}
-
-/**
- * Render the rules view.
- *
- * @param {Array<{name: string, glob: string}>} rules
- * @returns {string}
- */
-export function renderRules(rules) {
-  if (!rules || rules.length === 0) {
-    return renderBox(['  No rules found.'], 'cyan', '📏 RULES ATIVAS');
-  }
-
-  const lines = rules.map(r => `  ${chalk.bold(r.name).padEnd(35)}  ${chalk.gray(r.glob || '*')}`);
-  return renderBox(lines, 'cyan', `📏 RULES ATIVAS (${rules.length})`);
-}
-
-/**
- * Render the overview (compact summary of all views).
- *
- * @param {Object} data - { feature, phase, agentsByTier, hooks, skills, rules }
- * @returns {string}
- */
-export function renderOverview(data) {
-  const { feature, phase, agentsByTier, hooks, skills, rules } = data;
-  const totalAgents = Object.values(agentsByTier || {}).flat().length;
-  const lines = [];
-
-  lines.push(`Feature: ${chalk.bold.green(feature || '(none)')}  |  Phase: ${chalk.bold(phase || 'unknown')}`);
-  lines.push('');
-  lines.push(`🤖 Agents ativos: ${totalAgents} de 39`);
-
-  // Tier breakdown
-  for (const [tierKey, agents] of Object.entries(agentsByTier || {})) {
-    if (!agents || agents.length === 0) continue;
-    const tierNum = parseInt(tierKey.replace('tier', ''));
-    lines.push(`   T${tierNum}: ${agents.map(a => a.name).join(', ')}`);
-  }
-
-  lines.push('');
-  lines.push(`🪝 Hooks disparados: ${hooks?.length || 0}`);
-  if (hooks && hooks.length > 0) {
-    const last = hooks[hooks.length - 1];
-    lines.push(`   Último: ${last.name} (${last.ts})`);
-  }
-
-  lines.push('');
-  lines.push(`🎯 Skills invocadas: ${skills?.length || 0}`);
-  lines.push(`📏 Rules ativas: ${rules?.length || 0}`);
-
-  return renderBox(lines, 'green', '● MORPH-SPEC OVERVIEW');
-}
-
-/**
- * Render the bottom status bar.
- *
- * @param {string} mode   - Current view mode
- * @param {string[]} modes - All available modes
- * @returns {string}
- */
-export function renderStatusBar(mode, modes) {
-  const modeList = modes.map(m =>
-    m === mode ? chalk.bold.white.bgBlue(` ${m} `) : chalk.gray(` ${m} `)
-  ).join('  ');
-
-  return '\n' + modeList + chalk.gray('   shift+tab: cycle  |  q: quit');
-}
-
-/**
- * Render the feature header (top of screen).
- *
- * @param {string} feature
- * @param {string} phase
- * @param {Object} tasks - { completed, total }
- * @returns {string}
- */
-export function renderHeader(feature, phase, tasks) {
-  const taskInfo = tasks && tasks.total > 0
-    ? ` [${phase} ${tasks.completed}/${tasks.total}]`
-    : ` [${phase}]`;
-  const title = feature
-    ? chalk.bold.green(`● Watching ${feature}${taskInfo}`)
-    : chalk.bold.yellow('● morph-spec monitor — no active feature');
-  return title + '\n';
-}

package/src/lib/orchestration/index.js

@@ -1,7 +0,0 @@
-/**
- * Team Orchestration
- *
- * Coordinates agent teams for complex features spanning multiple domains.
- */
-
-export * from './team-orchestrator.js';