aiox-core 5.0.2 → 5.0.4

package/scripts/glue/compose-agent-prompt.cjs

@@ -1,362 +0,0 @@
-#!/usr/bin/env node
-/**
- * Compose Agent Prompt - Glue Script for Execute-Epic
- *
- * Deterministic prompt composition for autonomous agents.
- * Reads agent file + task file + context → outputs complete prompt to stdout.
- *
- * Usage:
- *   node compose-agent-prompt.cjs --agent dev --mission develop-story --context path/to/story.md
- *   node compose-agent-prompt.cjs --agent qa --mission gate --context path/to/story.md
- *   node compose-agent-prompt.cjs --agent po --mission validate-story --context story.md --context accumulated.md
- *   node compose-agent-prompt.cjs --agent dev --mission develop-story --context story.md --extra-instruction "Focus on tests"
- *
- * Options:
- *   --agent <id>             Agent ID (dev, qa, po, sm, architect, etc.)
- *   --mission <keyword>      Mission keyword from agent's Mission Router
- *   --context <path>         Context file (can be repeated for multiple files)
- *   --extra-instruction <s>  Additional instruction to append
- *   --verbose                Show debug info to stderr
- *   --list-missions          List available missions for the agent
- *
- * Output: Complete prompt ready for Task(subagent_type: "general-purpose", prompt: <output>)
- *
- * Architecture: Clockwork Stage 1 - Thin Glue Script
- */
-
-const fs = require('fs');
-const path = require('path');
-
-// Parse arguments (supports repeated --context)
-const args = process.argv.slice(2);
-const getArg = (name) => {
-  const idx = args.indexOf(`--${name}`);
-  return idx !== -1 && args[idx + 1] && !args[idx + 1].startsWith('--') ? args[idx + 1] : null;
-};
-const getAllArgs = (name) => {
-  const results = [];
-  for (let i = 0; i < args.length; i++) {
-    if (args[i] === `--${name}` && args[i + 1] && !args[i + 1].startsWith('--')) {
-      results.push(args[i + 1]);
-    }
-  }
-  return results;
-};
-const hasFlag = (name) => args.includes(`--${name}`);
-
-const agentId = getArg('agent');
-const mission = getArg('mission');
-const contextPaths = getAllArgs('context');
-const extraInstruction = getArg('extra-instruction');
-const verbose = hasFlag('verbose');
-const listMissions = hasFlag('list-missions');
-
-// Mission aliases (common shortcuts)
-const missionAliases = {
-  'review': 'gate',
-  'review-story': 'gate',
-  'expand': 'create-story',
-  'expand-story': 'create-story',
-  'draft': 'create-story',
-  'validate': 'validate-story',
-  'backlog': 'backlog-review',
-  'develop': 'develop-story',
-  'implement': 'develop-story'
-};
-
-const log = (msg) => verbose && console.error(`[glue] ${msg}`);
-
-if (!agentId) {
-  console.error('Usage: compose-agent-prompt.cjs --agent <id> --mission <keyword> [--context <path>...]');
-  console.error('       compose-agent-prompt.cjs --agent <id> --list-missions');
-  console.error('');
-  console.error('Examples:');
-  console.error('  compose-agent-prompt.cjs --agent dev --mission develop-story --context story.md');
-  console.error('  compose-agent-prompt.cjs --agent qa --mission gate --context story.md --context impl-log.md');
-  console.error('  compose-agent-prompt.cjs --agent po --list-missions');
-  process.exit(1);
-}
-
-// Paths
-const projectRoot = process.cwd();
-const aiosCoreTasks = path.join(projectRoot, '.aios-core', 'development', 'tasks');
-const aiosCoreAgents = path.join(projectRoot, '.aios-core', 'development', 'agents');
-
-// Agent file resolution (priority order)
-// 1. .claude/agents/aios-{id}.md (AIOS core)
-// 2. .claude/agents/{id}.md (standalone like db-sage)
-// 3. squads/{squad}/agents/{id}.md (squad agents - derive squad from agent id or use --squad)
-const squadId = getArg('squad');
-const agentPaths = [
-  path.join(projectRoot, '.claude', 'agents', `aios-${agentId}.md`),
-  path.join(projectRoot, '.claude', 'agents', `${agentId}.md`),
-];
-
-// Add squad paths if squad is specified or try common squads
-if (squadId) {
-  agentPaths.push(path.join(projectRoot, 'squads', squadId, 'agents', `${agentId}.md`));
-} else {
-  // Try common squad mappings
-  const squadMappings = {
-    'db-sage': 'db-sage',
-    'brad-frost': 'design',
-    'design-chief': 'design',
-    'cyber-chief': 'cybersecurity',
-    'copy-chief': 'copy',
-    'story-chief': 'storytelling',
-    'finops-chief': 'finops',
-    'hr-chief': 'hr',
-    'legal-chief': 'legal',
-    'data-chief': 'data',
-  };
-  const mappedSquad = squadMappings[agentId];
-  if (mappedSquad) {
-    agentPaths.push(path.join(projectRoot, 'squads', mappedSquad, 'agents', `${agentId}.md`));
-  }
-  // Also try .claude/commands/{Squad}/agents/ (synced from squads)
-  agentPaths.push(path.join(projectRoot, '.claude', 'commands', 'db-sage', 'agents', `${agentId}.md`));
-}
-
-// Find first existing agent file and track its source
-let agentFile = null;
-let agentSource = null; // 'aios-core', 'standalone', 'squad:{name}'
-for (const p of agentPaths) {
-  if (fs.existsSync(p)) {
-    agentFile = p;
-    // Determine source for task resolution
-    if (p.includes('.claude/agents/aios-')) {
-      agentSource = 'aios-core';
-    } else if (p.includes('.claude/agents/')) {
-      agentSource = 'standalone';
-    } else if (p.includes('squads/')) {
-      const match = p.match(/squads\/([^/]+)\//);
-      agentSource = match ? `squad:${match[1]}` : 'squad';
-    }
-    log(`Agent file found: ${p} (source: ${agentSource})`);
-    break;
-  }
-}
-
-if (!agentFile) {
-  console.error(`Agent file not found. Tried:`);
-  agentPaths.forEach(p => console.error(`  - ${p}`));
-  console.error(`\nHint: Use --squad <squad-name> to specify squad, or check agent ID.`);
-  process.exit(1);
-}
-const agentContent = fs.readFileSync(agentFile, 'utf8');
-
-// Parse Mission Router from agent file (format: "## 3. Mission Router" or "## Mission Router")
-const missionRouterMatch = agentContent.match(/## (?:\d+\. )?Mission Router[\s\S]*?(\|.*\|[\s\S]*?)(?=\n## |\n###|$)/);
-let taskFile = null;
-let extraResources = [];
-const availableMissions = [];
-
-if (missionRouterMatch) {
-  const tableContent = missionRouterMatch[1];
-  const rows = tableContent.split('\n').filter(r => r.includes('|') && !r.includes('---') && !r.includes('Mission Keyword'));
-
-  for (const row of rows) {
-    const cols = row.split('|').map(c => c.trim()).filter(Boolean);
-    if (cols.length >= 2) {
-      // Extract mission keyword (remove backticks, parenthetical notes like "(default)")
-      const rawKeyword = cols[0].replace(/`/g, '').trim();
-      // Handle multiple keywords like "create-story / draft"
-      const keywords = rawKeyword.split('/').map(k => k.replace(/\s*\([^)]*\)/g, '').trim());
-      const taskFileName = cols[1].replace(/`/g, '').trim();
-
-      // Collect for --list-missions
-      availableMissions.push({ keywords, taskFile: taskFileName, extras: cols[2] || '' });
-
-      // Skip if we're just listing missions
-      if (listMissions) continue;
-
-      // Resolve alias
-      const resolvedMission = missionAliases[mission?.toLowerCase()] || mission;
-
-      // Check if any keyword matches
-      for (const keyword of keywords) {
-        if (keyword.toLowerCase() === resolvedMission?.toLowerCase()) {
-          taskFile = taskFileName;
-          // Extract extra resources if present
-          if (cols[2]) {
-            const resourceMatches = cols[2].match(/`([^`]+\.md)`/g);
-            if (resourceMatches) {
-              extraResources = resourceMatches.map(r => r.replace(/`/g, ''));
-            }
-          }
-          break;
-        }
-      }
-      if (taskFile) break;
-    }
-  }
-}
-
-// Handle --list-missions
-if (listMissions) {
-  console.log(`\n## Available Missions for agent: ${agentId}\n`);
-  console.log('| Mission Keyword(s) | Task File | Extra Resources |');
-  console.log('|-------------------|-----------|-----------------|');
-  for (const m of availableMissions) {
-    console.log(`| ${m.keywords.join(' / ')} | ${m.taskFile} | ${m.extras || '—'} |`);
-  }
-  console.log('\n## Aliases (shortcuts)\n');
-  for (const [alias, target] of Object.entries(missionAliases)) {
-    console.log(`  ${alias} → ${target}`);
-  }
-  process.exit(0);
-}
-
-// Now require mission if not listing
-if (!mission) {
-  console.error('Error: --mission is required (or use --list-missions to see available missions)');
-  process.exit(1);
-}
-
-log(`Agent: ${agentId}, Mission: ${mission}, Resolved: ${missionAliases[mission?.toLowerCase()] || mission}`);
-log(`Task file: ${taskFile || 'not found'}`);
-log(`Extra resources: ${extraResources.join(', ') || 'none'}`);
-
-// Build the prompt
-const promptParts = [];
-
-// 1. Agent persona (from .aios-core/development/agents/ if exists, else from agent file)
-const fullAgentFile = path.join(aiosCoreAgents, `${agentId}.md`);
-if (fs.existsSync(fullAgentFile)) {
-  promptParts.push(`## Agent Persona\n\n${fs.readFileSync(fullAgentFile, 'utf8')}`);
-} else {
-  promptParts.push(`## Agent Instructions\n\n${agentContent}`);
-}
-
-// 2. Task workflow (if found in router) - check multiple paths
-if (taskFile) {
-  // Build task path candidates based on agent source
-  const taskPaths = [path.join(aiosCoreTasks, taskFile)];
-
-  // If agent is from a squad, also check squad tasks
-  if (agentSource && agentSource.startsWith('squad:')) {
-    const squadName = agentSource.split(':')[1];
-    taskPaths.unshift(path.join(projectRoot, 'squads', squadName, 'tasks', taskFile));
-  }
-
-  // For standalone agents, check if there's a matching squad
-  if (agentSource === 'standalone') {
-    const squadMappings = {
-      'db-sage': 'db-sage',
-      'brad-frost': 'design',
-      'design-chief': 'design',
-      'cyber-chief': 'cybersecurity',
-    };
-    const mappedSquad = squadMappings[agentId];
-    if (mappedSquad) {
-      taskPaths.unshift(path.join(projectRoot, 'squads', mappedSquad, 'tasks', taskFile));
-    }
-  }
-
-  // Find first existing task file
-  let foundTaskPath = null;
-  for (const tp of taskPaths) {
-    if (fs.existsSync(tp)) {
-      foundTaskPath = tp;
-      log(`Task file found: ${tp}`);
-      break;
-    }
-  }
-
-  if (foundTaskPath) {
-    promptParts.push(`## Task Workflow: ${mission}\n\n${fs.readFileSync(foundTaskPath, 'utf8')}`);
-  } else {
-    log(`Task file not found. Tried: ${taskPaths.join(', ')}`);
-    promptParts.push(`## Mission: ${mission}\n\nTask file not found: ${taskFile}. Execute mission based on agent expertise.`);
-  }
-} else {
-  promptParts.push(`## Mission: ${mission}\n\nNo router entry found. Execute mission based on agent expertise.`);
-}
-
-// 2.5. Extra resources (checklists, templates) - check multiple paths
-const aiosCoreChecklists = path.join(projectRoot, '.aios-core', 'development', 'checklists');
-const aiosCoreProductChecklists = path.join(projectRoot, '.aios-core', 'product', 'checklists');
-
-for (const resource of extraResources) {
-  // Build checklist path candidates based on agent source
-  const checklistPaths = [];
-
-  // If agent is from a squad, check squad checklists first
-  if (agentSource && agentSource.startsWith('squad:')) {
-    const squadName = agentSource.split(':')[1];
-    checklistPaths.push(path.join(projectRoot, 'squads', squadName, 'checklists', resource));
-  }
-
-  // For standalone agents with squad mappings
-  if (agentSource === 'standalone') {
-    const squadMappings = {
-      'db-sage': 'db-sage',
-      'brad-frost': 'design',
-      'design-chief': 'design',
-      'cyber-chief': 'cybersecurity',
-    };
-    const mappedSquad = squadMappings[agentId];
-    if (mappedSquad) {
-      checklistPaths.push(path.join(projectRoot, 'squads', mappedSquad, 'checklists', resource));
-    }
-  }
-
-  // Always fallback to AIOS core checklists
-  checklistPaths.push(path.join(aiosCoreChecklists, resource));
-  checklistPaths.push(path.join(aiosCoreProductChecklists, resource));
-
-  // Find first existing checklist
-  let foundChecklistPath = null;
-  for (const cp of checklistPaths) {
-    if (fs.existsSync(cp)) {
-      foundChecklistPath = cp;
-      log(`Checklist found: ${cp}`);
-      break;
-    }
-  }
-
-  if (foundChecklistPath) {
-    promptParts.push(`## Checklist: ${resource}\n\n${fs.readFileSync(foundChecklistPath, 'utf8')}`);
-  } else {
-    log(`Checklist not found: ${resource}`);
-  }
-}
-
-// 3. Context files (supports multiple)
-if (contextPaths.length > 0) {
-  const contextSections = [];
-  for (let i = 0; i < contextPaths.length; i++) {
-    const ctxPath = contextPaths[i];
-    const ctxLabel = contextPaths.length === 1 ? 'Context' : `Context ${i + 1}`;
-    if (fs.existsSync(ctxPath)) {
-      log(`Loading context: ${ctxPath}`);
-      contextSections.push(`### ${ctxLabel}: ${path.basename(ctxPath)}\n\nFile: ${ctxPath}\n\n${fs.readFileSync(ctxPath, 'utf8')}`);
-    } else {
-      contextSections.push(`### ${ctxLabel}\n\nFile not found: ${ctxPath}`);
-      log(`Warning: context file not found: ${ctxPath}`);
-    }
-  }
-  promptParts.push(`## Context\n\n${contextSections.join('\n\n---\n\n')}`);
-}
-
-// 4. Execution directive
-const extraInstructionBlock = extraInstruction ? `\n\n**Additional Instruction:** ${extraInstruction}` : '';
-promptParts.push(`## Execution Directive
-
-Execute the mission "${mission}" following the task workflow above.
-- Follow ALL steps in the task workflow exactly
-- Use Self-Critique checkpoints if defined in the workflow
-- Output artifacts as specified in the workflow
-- Mark success/failure clearly at the end${extraInstructionBlock}`);
-
-// Output complete prompt
-const output = promptParts.join('\n\n---\n\n');
-console.log(output);
-
-// Stats to stderr (always shown in verbose mode)
-if (verbose) {
-  const lineCount = output.split('\n').length;
-  const charCount = output.length;
-  console.error(`\n[glue] Prompt stats: ${lineCount} lines, ${charCount} chars`);
-  console.error(`[glue] Sections: ${promptParts.length} (persona, task${extraResources.length > 0 ? ', ' + extraResources.length + ' checklists' : ''}, ${contextPaths.length} contexts, directive)`);
-}