aiox-core 5.0.0 → 5.0.2

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

@@ -0,0 +1,362 @@
+#!/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)`);
+}

package/.aiox-core/lib/build.json

@@ -1 +0,0 @@
-{"built": true}