claude-flow-novice 2.6.0 → 2.9.0

package/dist/cli/agent-definition-parser.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/agent-definition-parser.ts"],"sourcesContent":["/**\r\n * Agent Definition Parser\r\n *\r\n * Parses agent definition files (.md) with YAML frontmatter and markdown content.\r\n * Supports agent definitions in .claude/agents/ directory structure.\r\n */\r\n\r\nimport fs from 'fs/promises';\r\nimport path from 'path';\r\nimport { glob } from 'glob';\r\n\r\nexport interface AgentDefinition {\r\n  // YAML frontmatter fields\r\n  name: string;\r\n  description: string;\r\n  tools: string[];\r\n  model: 'haiku' | 'sonnet' | 'opus';\r\n  type?: string;\r\n  color?: string;\r\n  acl_level?: number;\r\n  capabilities?: string[];\r\n  validation_hooks?: string[];\r\n  lifecycle?: {\r\n    pre_task?: string;\r\n    post_task?: string;\r\n  };\r\n\r\n  // Parsed markdown content\r\n  content: string;\r\n\r\n  // File metadata\r\n  filePath: string;\r\n  category?: string; // e.g., 'core-agents', 'specialized', 'custom'\r\n}\r\n\r\n/**\r\n * Parse YAML frontmatter from markdown content\r\n */\r\nfunction parseFrontmatter(content: string): { frontmatter: Record<string, any>; body: string } {\r\n  const frontmatterRegex = /^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/;\r\n  const match = content.match(frontmatterRegex);\r\n\r\n  if (!match) {\r\n    return { frontmatter: {}, body: content };\r\n  }\r\n\r\n  const [, yamlContent, body] = match;\r\n\r\n  // Simple YAML parser (handles basic key-value pairs, arrays, and objects)\r\n  const frontmatter: Record<string, any> = {};\r\n  const lines = yamlContent.split('\\n');\r\n  let currentKey = '';\r\n  let currentArray: string[] = [];\r\n  let isInArray = false;\r\n  let isInObject = false;\r\n  let currentObject: Record<string, string> = {};\r\n  let objectKey = '';\r\n\r\n  for (const line of lines) {\r\n    const trimmed = line.trim();\r\n    if (!trimmed || trimmed.startsWith('#')) continue;\r\n\r\n    // Array item\r\n    if (trimmed.startsWith('- ')) {\r\n      if (!isInArray) {\r\n        isInArray = true;\r\n        currentArray = [];\r\n      }\r\n      currentArray.push(trimmed.substring(2).trim());\r\n      continue;\r\n    }\r\n\r\n    // End of array\r\n    if (isInArray && !trimmed.startsWith('- ')) {\r\n      frontmatter[currentKey] = currentArray;\r\n      isInArray = false;\r\n      currentArray = [];\r\n    }\r\n\r\n    // Object field (indented key-value)\r\n    if (trimmed.match(/^\\s+\\w+:/) && isInObject) {\r\n      const [objKey, ...objValueParts] = trimmed.split(':');\r\n      const objValue = objValueParts.join(':').trim().replace(/^[\"']|[\"']$/g, '');\r\n      currentObject[objKey.trim()] = objValue;\r\n      continue;\r\n    }\r\n\r\n    // Key-value pair\r\n    const colonIndex = trimmed.indexOf(':');\r\n    if (colonIndex !== -1) {\r\n      const key = trimmed.substring(0, colonIndex).trim();\r\n      const value = trimmed.substring(colonIndex + 1).trim();\r\n\r\n      // Check if this starts an object\r\n      if (value === '') {\r\n        isInObject = true;\r\n        currentObject = {};\r\n        objectKey = key;\r\n        continue;\r\n      }\r\n\r\n      // End previous object if any\r\n      if (isInObject && !trimmed.match(/^\\s+/)) {\r\n        frontmatter[objectKey] = currentObject;\r\n        isInObject = false;\r\n        currentObject = {};\r\n      }\r\n\r\n      currentKey = key;\r\n\r\n      // Multi-line string (starts with |)\r\n      if (value === '|') {\r\n        continue; // Will be handled by next lines\r\n      }\r\n\r\n      // Remove quotes\r\n      const cleanValue = value.replace(/^[\"']|[\"']$/g, '');\r\n      frontmatter[key] = cleanValue;\r\n    } else if (currentKey && trimmed && !isInArray && !isInObject) {\r\n      // Continuation of multi-line string\r\n      const existingValue = frontmatter[currentKey];\r\n      frontmatter[currentKey] = existingValue\r\n        ? `${existingValue}\\n${trimmed}`\r\n        : trimmed;\r\n    }\r\n  }\r\n\r\n  // Handle trailing array or object\r\n  if (isInArray) {\r\n    frontmatter[currentKey] = currentArray;\r\n  }\r\n  if (isInObject) {\r\n    frontmatter[objectKey] = currentObject;\r\n  }\r\n\r\n  return { frontmatter, body: body.trim() };\r\n}\r\n\r\n/**\r\n * Find agent definition file by agent type/name\r\n */\r\nasync function findAgentFile(agentType: string, baseDir: string = '.claude/agents'): Promise<string | null> {\r\n  // Normalize agent type (handle both kebab-case and underscores)\r\n  const normalizedType = agentType.toLowerCase().replace(/_/g, '-');\r\n\r\n  // Search patterns (in order of priority)\r\n  const patterns = [\r\n    // Exact match in any subdirectory\r\n    `${baseDir}/**/${normalizedType}.md`,\r\n    // Match with different casing\r\n    `${baseDir}/**/*${normalizedType}*.md`,\r\n  ];\r\n\r\n  for (const pattern of patterns) {\r\n    const files = await glob(pattern, { nodir: true, absolute: true });\r\n    if (files.length > 0) {\r\n      // Prefer exact match over partial match\r\n      const exactMatch = files.find(f => {\r\n        const basename = path.basename(f, '.md').toLowerCase();\r\n        return basename === normalizedType;\r\n      });\r\n      return exactMatch || files[0];\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Parse agent definition from file\r\n */\r\nexport async function parseAgentDefinition(agentType: string): Promise<AgentDefinition> {\r\n  // Find agent file\r\n  const filePath = await findAgentFile(agentType);\r\n\r\n  if (!filePath) {\r\n    throw new Error(`Agent definition not found: ${agentType}`);\r\n  }\r\n\r\n  // Read file content\r\n  const content = await fs.readFile(filePath, 'utf-8');\r\n\r\n  // Parse frontmatter and body\r\n  const { frontmatter, body } = parseFrontmatter(content);\r\n\r\n  // Extract category from path\r\n  const relativePath = path.relative('.claude/agents', filePath);\r\n  const category = relativePath.includes('/')\r\n    ? relativePath.split('/')[0]\r\n    : undefined;\r\n\r\n  // Build agent definition\r\n  const definition: AgentDefinition = {\r\n    name: frontmatter.name || agentType,\r\n    description: frontmatter.description || '',\r\n    tools: Array.isArray(frontmatter.tools) ? frontmatter.tools : [],\r\n    model: frontmatter.model || 'haiku',\r\n    type: frontmatter.type,\r\n    color: frontmatter.color,\r\n    acl_level: frontmatter.acl_level ? parseInt(String(frontmatter.acl_level), 10) : undefined,\r\n    capabilities: frontmatter.capabilities,\r\n    validation_hooks: frontmatter.validation_hooks,\r\n    lifecycle: frontmatter.lifecycle,\r\n    content: body,\r\n    filePath,\r\n    category,\r\n  };\r\n\r\n  return definition;\r\n}\r\n\r\n/**\r\n * List all available agent definitions\r\n */\r\nexport async function listAgentDefinitions(baseDir: string = '.claude/agents'): Promise<string[]> {\r\n  const pattern = `${baseDir}/**/*.md`;\r\n  const files = await glob(pattern, { nodir: true });\r\n\r\n  return files.map(f => path.basename(f, '.md'));\r\n}\r\n\r\n/**\r\n * Check if agent definition includes CFN Loop protocol\r\n */\r\nexport function hasCFNLoopProtocol(definition: AgentDefinition): boolean {\r\n  const content = definition.content.toLowerCase();\r\n  return (\r\n    content.includes('cfn loop') &&\r\n    content.includes('redis completion protocol') ||\r\n    content.includes('invoke-waiting-mode.sh')\r\n  );\r\n}\r\n"],"names":["fs","path","glob","parseFrontmatter","content","frontmatterRegex","match","frontmatter","body","yamlContent","lines","split","currentKey","currentArray","isInArray","isInObject","currentObject","objectKey","line","trimmed","trim","startsWith","push","substring","objKey","objValueParts","objValue","join","replace","colonIndex","indexOf","key","value","cleanValue","existingValue","findAgentFile","agentType","baseDir","normalizedType","toLowerCase","patterns","pattern","files","nodir","absolute","length","exactMatch","find","f","basename","parseAgentDefinition","filePath","Error","readFile","relativePath","relative","category","includes","undefined","definition","name","description","tools","Array","isArray","model","type","color","acl_level","parseInt","String","capabilities","validation_hooks","lifecycle","listAgentDefinitions","map","hasCFNLoopProtocol"],"mappings":"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"}
+{"version":3,"sources":["../../src/cli/agent-definition-parser.ts"],"sourcesContent":["/**\r\n * Agent Definition Parser\r\n *\r\n * Parses agent definition files (.md) with YAML frontmatter and markdown content.\r\n * Supports agent definitions in .claude/agents/ directory structure.\r\n */\r\n\r\nimport fs from 'fs/promises';\r\nimport path from 'path';\r\nimport { glob } from 'glob';\r\n\r\nexport interface AgentDefinition {\r\n  // YAML frontmatter fields\r\n  name: string;\r\n  description: string;\r\n  tools: string[];\r\n  model: 'haiku' | 'sonnet' | 'opus';\r\n  type?: string;\r\n  color?: string;\r\n  acl_level?: number;\r\n  capabilities?: string[];\r\n  validation_hooks?: string[];\r\n  lifecycle?: {\r\n    pre_task?: string;\r\n    post_task?: string;\r\n  };\r\n\r\n  // Parsed markdown content\r\n  content: string;\r\n\r\n  // File metadata\r\n  filePath: string;\r\n  category?: string; // e.g., 'core-agents', 'specialized', 'custom'\r\n}\r\n\r\n/**\r\n * Parse YAML frontmatter from markdown content\r\n */\r\nfunction parseFrontmatter(content: string): { frontmatter: Record<string, any>; body: string } {\r\n  const frontmatterRegex = /^---\\n([\\s\\S]*?)\\n---\\n([\\s\\S]*)$/;\r\n  const match = content.match(frontmatterRegex);\r\n\r\n  if (!match) {\r\n    return { frontmatter: {}, body: content };\r\n  }\r\n\r\n  const [, yamlContent, body] = match;\r\n\r\n  // Simple YAML parser (handles basic key-value pairs, arrays, and objects)\r\n  const frontmatter: Record<string, any> = {};\r\n  const lines = yamlContent.split('\\n');\r\n  let currentKey = '';\r\n  let currentArray: string[] = [];\r\n  let isInArray = false;\r\n  let isInObject = false;\r\n  let currentObject: Record<string, string> = {};\r\n  let objectKey = '';\r\n\r\n  for (const line of lines) {\r\n    const trimmed = line.trim();\r\n    if (!trimmed || trimmed.startsWith('#')) continue;\r\n\r\n    // Array item\r\n    if (trimmed.startsWith('- ')) {\r\n      if (!isInArray) {\r\n        isInArray = true;\r\n        currentArray = [];\r\n      }\r\n      currentArray.push(trimmed.substring(2).trim());\r\n      continue;\r\n    }\r\n\r\n    // End of array\r\n    if (isInArray && !trimmed.startsWith('- ')) {\r\n      frontmatter[currentKey] = currentArray;\r\n      isInArray = false;\r\n      currentArray = [];\r\n    }\r\n\r\n    // Object field (indented key-value)\r\n    if (trimmed.match(/^\\s+\\w+:/) && isInObject) {\r\n      const [objKey, ...objValueParts] = trimmed.split(':');\r\n      const objValue = objValueParts.join(':').trim().replace(/^[\"']|[\"']$/g, '');\r\n      currentObject[objKey.trim()] = objValue;\r\n      continue;\r\n    }\r\n\r\n    // Key-value pair\r\n    const colonIndex = trimmed.indexOf(':');\r\n    if (colonIndex !== -1) {\r\n      const key = trimmed.substring(0, colonIndex).trim();\r\n      const value = trimmed.substring(colonIndex + 1).trim();\r\n\r\n      // Check if this starts an object\r\n      if (value === '') {\r\n        isInObject = true;\r\n        currentObject = {};\r\n        objectKey = key;\r\n        continue;\r\n      }\r\n\r\n      // End previous object if any\r\n      if (isInObject && !trimmed.match(/^\\s+/)) {\r\n        frontmatter[objectKey] = currentObject;\r\n        isInObject = false;\r\n        currentObject = {};\r\n      }\r\n\r\n      currentKey = key;\r\n\r\n      // Multi-line string (starts with |)\r\n      if (value === '|') {\r\n        continue; // Will be handled by next lines\r\n      }\r\n\r\n      // Inline array (e.g., [item1, item2, item3])\r\n      if (value.startsWith('[') && value.endsWith(']')) {\r\n        const arrayContent = value.substring(1, value.length - 1);\r\n        const items = arrayContent.split(',').map(item => item.trim());\r\n        frontmatter[key] = items;\r\n        continue;\r\n      }\r\n\r\n      // Remove quotes\r\n      const cleanValue = value.replace(/^[\"']|[\"']$/g, '');\r\n      frontmatter[key] = cleanValue;\r\n    } else if (currentKey && trimmed && !isInArray && !isInObject) {\r\n      // Continuation of multi-line string\r\n      const existingValue = frontmatter[currentKey];\r\n      frontmatter[currentKey] = existingValue\r\n        ? `${existingValue}\\n${trimmed}`\r\n        : trimmed;\r\n    }\r\n  }\r\n\r\n  // Handle trailing array or object\r\n  if (isInArray) {\r\n    frontmatter[currentKey] = currentArray;\r\n  }\r\n  if (isInObject) {\r\n    frontmatter[objectKey] = currentObject;\r\n  }\r\n\r\n  return { frontmatter, body: body.trim() };\r\n}\r\n\r\n/**\r\n * Find agent definition file by agent type/name\r\n */\r\nasync function findAgentFile(agentType: string, baseDir: string = '.claude/agents'): Promise<string | null> {\r\n  // Normalize agent type (handle both kebab-case and underscores)\r\n  const normalizedType = agentType.toLowerCase().replace(/_/g, '-');\r\n\r\n  // Search patterns (in order of priority)\r\n  const patterns = [\r\n    // Exact match in any subdirectory\r\n    `${baseDir}/**/${normalizedType}.md`,\r\n    // Match with different casing\r\n    `${baseDir}/**/*${normalizedType}*.md`,\r\n  ];\r\n\r\n  for (const pattern of patterns) {\r\n    const files = await glob(pattern, { nodir: true, absolute: true });\r\n    if (files.length > 0) {\r\n      // Prefer exact match over partial match\r\n      const exactMatch = files.find(f => {\r\n        const basename = path.basename(f, '.md').toLowerCase();\r\n        return basename === normalizedType;\r\n      });\r\n      return exactMatch || files[0];\r\n    }\r\n  }\r\n\r\n  return null;\r\n}\r\n\r\n/**\r\n * Parse agent definition from file\r\n */\r\nexport async function parseAgentDefinition(agentType: string): Promise<AgentDefinition> {\r\n  // Find agent file\r\n  const filePath = await findAgentFile(agentType);\r\n\r\n  if (!filePath) {\r\n    throw new Error(`Agent definition not found: ${agentType}`);\r\n  }\r\n\r\n  // Read file content\r\n  const content = await fs.readFile(filePath, 'utf-8');\r\n\r\n  // Parse frontmatter and body\r\n  const { frontmatter, body } = parseFrontmatter(content);\r\n\r\n  // Extract category from path\r\n  const relativePath = path.relative('.claude/agents', filePath);\r\n  const category = relativePath.includes('/')\r\n    ? relativePath.split('/')[0]\r\n    : undefined;\r\n\r\n  // Build agent definition\r\n  const definition: AgentDefinition = {\r\n    name: frontmatter.name || agentType,\r\n    description: frontmatter.description || '',\r\n    tools: Array.isArray(frontmatter.tools) ? frontmatter.tools : [],\r\n    model: frontmatter.model || 'haiku',\r\n    type: frontmatter.type,\r\n    color: frontmatter.color,\r\n    acl_level: frontmatter.acl_level ? parseInt(String(frontmatter.acl_level), 10) : undefined,\r\n    capabilities: frontmatter.capabilities,\r\n    validation_hooks: frontmatter.validation_hooks,\r\n    lifecycle: frontmatter.lifecycle,\r\n    content: body,\r\n    filePath,\r\n    category,\r\n  };\r\n\r\n  return definition;\r\n}\r\n\r\n/**\r\n * List all available agent definitions\r\n */\r\nexport async function listAgentDefinitions(baseDir: string = '.claude/agents'): Promise<string[]> {\r\n  const pattern = `${baseDir}/**/*.md`;\r\n  const files = await glob(pattern, { nodir: true });\r\n\r\n  return files.map(f => path.basename(f, '.md'));\r\n}\r\n\r\n/**\r\n * Check if agent definition includes CFN Loop protocol\r\n */\r\nexport function hasCFNLoopProtocol(definition: AgentDefinition): boolean {\r\n  const content = definition.content.toLowerCase();\r\n  return (\r\n    content.includes('cfn loop') &&\r\n    content.includes('redis completion protocol') ||\r\n    content.includes('invoke-waiting-mode.sh')\r\n  );\r\n}\r\n"],"names":["fs","path","glob","parseFrontmatter","content","frontmatterRegex","match","frontmatter","body","yamlContent","lines","split","currentKey","currentArray","isInArray","isInObject","currentObject","objectKey","line","trimmed","trim","startsWith","push","substring","objKey","objValueParts","objValue","join","replace","colonIndex","indexOf","key","value","endsWith","arrayContent","length","items","map","item","cleanValue","existingValue","findAgentFile","agentType","baseDir","normalizedType","toLowerCase","patterns","pattern","files","nodir","absolute","exactMatch","find","f","basename","parseAgentDefinition","filePath","Error","readFile","relativePath","relative","category","includes","undefined","definition","name","description","tools","Array","isArray","model","type","color","acl_level","parseInt","String","capabilities","validation_hooks","lifecycle","listAgentDefinitions","hasCFNLoopProtocol"],"mappings":"AAAA;;;;;CAKC,GAED,OAAOA,QAAQ,cAAc;AAC7B,OAAOC,UAAU,OAAO;AACxB,SAASC,IAAI,QAAQ,OAAO;AA0B5B;;CAEC,GACD,SAASC,iBAAiBC,OAAe;IACvC,MAAMC,mBAAmB;IACzB,MAAMC,QAAQF,QAAQE,KAAK,CAACD;IAE5B,IAAI,CAACC,OAAO;QACV,OAAO;YAAEC,aAAa,CAAC;YAAGC,MAAMJ;QAAQ;IAC1C;IAEA,MAAM,GAAGK,aAAaD,KAAK,GAAGF;IAE9B,0EAA0E;IAC1E,MAAMC,cAAmC,CAAC;IAC1C,MAAMG,QAAQD,YAAYE,KAAK,CAAC;IAChC,IAAIC,aAAa;IACjB,IAAIC,eAAyB,EAAE;IAC/B,IAAIC,YAAY;IAChB,IAAIC,aAAa;IACjB,IAAIC,gBAAwC,CAAC;IAC7C,IAAIC,YAAY;IAEhB,KAAK,MAAMC,QAAQR,MAAO;QACxB,MAAMS,UAAUD,KAAKE,IAAI;QACzB,IAAI,CAACD,WAAWA,QAAQE,UAAU,CAAC,MAAM;QAEzC,aAAa;QACb,IAAIF,QAAQE,UAAU,CAAC,OAAO;YAC5B,IAAI,CAACP,WAAW;gBACdA,YAAY;gBACZD,eAAe,EAAE;YACnB;YACAA,aAAaS,IAAI,CAACH,QAAQI,SAAS,CAAC,GAAGH,IAAI;YAC3C;QACF;QAEA,eAAe;QACf,IAAIN,aAAa,CAACK,QAAQE,UAAU,CAAC,OAAO;YAC1Cd,WAAW,CAACK,WAAW,GAAGC;YAC1BC,YAAY;YACZD,eAAe,EAAE;QACnB;QAEA,oCAAoC;QACpC,IAAIM,QAAQb,KAAK,CAAC,eAAeS,YAAY;YAC3C,MAAM,CAACS,QAAQ,GAAGC,cAAc,GAAGN,QAAQR,KAAK,CAAC;YACjD,MAAMe,WAAWD,cAAcE,IAAI,CAAC,KAAKP,IAAI,GAAGQ,OAAO,CAAC,gBAAgB;YACxEZ,aAAa,CAACQ,OAAOJ,IAAI,GAAG,GAAGM;YAC/B;QACF;QAEA,iBAAiB;QACjB,MAAMG,aAAaV,QAAQW,OAAO,CAAC;QACnC,IAAID,eAAe,CAAC,GAAG;YACrB,MAAME,MAAMZ,QAAQI,SAAS,CAAC,GAAGM,YAAYT,IAAI;YACjD,MAAMY,QAAQb,QAAQI,SAAS,CAACM,aAAa,GAAGT,IAAI;YAEpD,iCAAiC;YACjC,IAAIY,UAAU,IAAI;gBAChBjB,aAAa;gBACbC,gBAAgB,CAAC;gBACjBC,YAAYc;gBACZ;YACF;YAEA,6BAA6B;YAC7B,IAAIhB,cAAc,CAACI,QAAQb,KAAK,CAAC,SAAS;gBACxCC,WAAW,CAACU,UAAU,GAAGD;gBACzBD,aAAa;gBACbC,gBAAgB,CAAC;YACnB;YAEAJ,aAAamB;YAEb,oCAAoC;YACpC,IAAIC,UAAU,KAAK;gBACjB,UAAU,gCAAgC;YAC5C;YAEA,6CAA6C;YAC7C,IAAIA,MAAMX,UAAU,CAAC,QAAQW,MAAMC,QAAQ,CAAC,MAAM;gBAChD,MAAMC,eAAeF,MAAMT,SAAS,CAAC,GAAGS,MAAMG,MAAM,GAAG;gBACvD,MAAMC,QAAQF,aAAavB,KAAK,CAAC,KAAK0B,GAAG,CAACC,CAAAA,OAAQA,KAAKlB,IAAI;gBAC3Db,WAAW,CAACwB,IAAI,GAAGK;gBACnB;YACF;YAEA,gBAAgB;YAChB,MAAMG,aAAaP,MAAMJ,OAAO,CAAC,gBAAgB;YACjDrB,WAAW,CAACwB,IAAI,GAAGQ;QACrB,OAAO,IAAI3B,cAAcO,WAAW,CAACL,aAAa,CAACC,YAAY;YAC7D,oCAAoC;YACpC,MAAMyB,gBAAgBjC,WAAW,CAACK,WAAW;YAC7CL,WAAW,CAACK,WAAW,GAAG4B,gBACtB,GAAGA,cAAc,EAAE,EAAErB,SAAS,GAC9BA;QACN;IACF;IAEA,kCAAkC;IAClC,IAAIL,WAAW;QACbP,WAAW,CAACK,WAAW,GAAGC;IAC5B;IACA,IAAIE,YAAY;QACdR,WAAW,CAACU,UAAU,GAAGD;IAC3B;IAEA,OAAO;QAAET;QAAaC,MAAMA,KAAKY,IAAI;IAAG;AAC1C;AAEA;;CAEC,GACD,eAAeqB,cAAcC,SAAiB,EAAEC,UAAkB,gBAAgB;IAChF,gEAAgE;IAChE,MAAMC,iBAAiBF,UAAUG,WAAW,GAAGjB,OAAO,CAAC,MAAM;IAE7D,yCAAyC;IACzC,MAAMkB,WAAW;QACf,kCAAkC;QAClC,GAAGH,QAAQ,IAAI,EAAEC,eAAe,GAAG,CAAC;QACpC,8BAA8B;QAC9B,GAAGD,QAAQ,KAAK,EAAEC,eAAe,IAAI,CAAC;KACvC;IAED,KAAK,MAAMG,WAAWD,SAAU;QAC9B,MAAME,QAAQ,MAAM9C,KAAK6C,SAAS;YAAEE,OAAO;YAAMC,UAAU;QAAK;QAChE,IAAIF,MAAMb,MAAM,GAAG,GAAG;YACpB,wCAAwC;YACxC,MAAMgB,aAAaH,MAAMI,IAAI,CAACC,CAAAA;gBAC5B,MAAMC,WAAWrD,KAAKqD,QAAQ,CAACD,GAAG,OAAOR,WAAW;gBACpD,OAAOS,aAAaV;YACtB;YACA,OAAOO,cAAcH,KAAK,CAAC,EAAE;QAC/B;IACF;IAEA,OAAO;AACT;AAEA;;CAEC,GACD,OAAO,eAAeO,qBAAqBb,SAAiB;IAC1D,kBAAkB;IAClB,MAAMc,WAAW,MAAMf,cAAcC;IAErC,IAAI,CAACc,UAAU;QACb,MAAM,IAAIC,MAAM,CAAC,4BAA4B,EAAEf,WAAW;IAC5D;IAEA,oBAAoB;IACpB,MAAMtC,UAAU,MAAMJ,GAAG0D,QAAQ,CAACF,UAAU;IAE5C,6BAA6B;IAC7B,MAAM,EAAEjD,WAAW,EAAEC,IAAI,EAAE,GAAGL,iBAAiBC;IAE/C,6BAA6B;IAC7B,MAAMuD,eAAe1D,KAAK2D,QAAQ,CAAC,kBAAkBJ;IACrD,MAAMK,WAAWF,aAAaG,QAAQ,CAAC,OACnCH,aAAahD,KAAK,CAAC,IAAI,CAAC,EAAE,GAC1BoD;IAEJ,yBAAyB;IACzB,MAAMC,aAA8B;QAClCC,MAAM1D,YAAY0D,IAAI,IAAIvB;QAC1BwB,aAAa3D,YAAY2D,WAAW,IAAI;QACxCC,OAAOC,MAAMC,OAAO,CAAC9D,YAAY4D,KAAK,IAAI5D,YAAY4D,KAAK,GAAG,EAAE;QAChEG,OAAO/D,YAAY+D,KAAK,IAAI;QAC5BC,MAAMhE,YAAYgE,IAAI;QACtBC,OAAOjE,YAAYiE,KAAK;QACxBC,WAAWlE,YAAYkE,SAAS,GAAGC,SAASC,OAAOpE,YAAYkE,SAAS,GAAG,MAAMV;QACjFa,cAAcrE,YAAYqE,YAAY;QACtCC,kBAAkBtE,YAAYsE,gBAAgB;QAC9CC,WAAWvE,YAAYuE,SAAS;QAChC1E,SAASI;QACTgD;QACAK;IACF;IAEA,OAAOG;AACT;AAEA;;CAEC,GACD,OAAO,eAAee,qBAAqBpC,UAAkB,gBAAgB;IAC3E,MAAMI,UAAU,GAAGJ,QAAQ,QAAQ,CAAC;IACpC,MAAMK,QAAQ,MAAM9C,KAAK6C,SAAS;QAAEE,OAAO;IAAK;IAEhD,OAAOD,MAAMX,GAAG,CAACgB,CAAAA,IAAKpD,KAAKqD,QAAQ,CAACD,GAAG;AACzC;AAEA;;CAEC,GACD,OAAO,SAAS2B,mBAAmBhB,UAA2B;IAC5D,MAAM5D,UAAU4D,WAAW5D,OAAO,CAACyC,WAAW;IAC9C,OACEzC,QAAQ0D,QAAQ,CAAC,eACjB1D,QAAQ0D,QAAQ,CAAC,gCACjB1D,QAAQ0D,QAAQ,CAAC;AAErB"}

package/dist/cli/agent-executor.js

@@ -6,11 +6,79 @@
  * 2. Invoking the appropriate API
  * 3. Managing agent lifecycle and output
  */ import { spawn } from 'child_process';
+import { exec } from 'child_process';
+import { promisify } from 'util';
 import { getAgentId } from './agent-prompt-builder.js';
 import { buildCLIAgentSystemPrompt, loadContextFromEnv } from './cli-agent-context.js';
+import { loadMessages, storeMessage, getCurrentFork, formatMessagesForAPI } from './conversation-fork.js';
+import { convertToolNames } from './tool-definitions.js';
 import fs from 'fs/promises';
 import path from 'path';
 import os from 'os';
+const execAsync = promisify(exec);
+/**
+ * Extract confidence score from agent output
+ * Looks for patterns like:
+ * - "confidence: 0.85"
+ * - "Confidence: 0.90"
+ * - "confidence score: 0.95"
+ * - "self-confidence: 0.88"
+ */ function extractConfidence(output) {
+    if (!output) return 0.85;
+    // Try multiple patterns
+    const patterns = [
+        /confidence:\s*([0-9.]+)/i,
+        /confidence\s+score:\s*([0-9.]+)/i,
+        /self-confidence:\s*([0-9.]+)/i,
+        /my\s+confidence:\s*([0-9.]+)/i
+    ];
+    for (const pattern of patterns){
+        const match = output.match(pattern);
+        if (match && match[1]) {
+            const score = parseFloat(match[1]);
+            if (score >= 0 && score <= 1) {
+                return score;
+            }
+        }
+    }
+    // Default to 0.85 if not found
+    return 0.85;
+}
+/**
+ * Execute CFN Loop protocol after agent completes work
+ *
+ * Steps:
+ * 1. Signal completion to orchestrator
+ * 2. Report confidence score
+ * 3. Enter waiting mode (if iterations enabled)
+ */ async function executeCFNProtocol(taskId, agentId, output, iteration, enableIterations = false, maxIterations = 10) {
+    console.log(`\n[CFN Protocol] Starting for agent ${agentId}`);
+    console.log(`[CFN Protocol] Task ID: ${taskId}, Iteration: ${iteration}`);
+    try {
+        // Step 1: Signal completion
+        console.log('[CFN Protocol] Step 1: Signaling completion...');
+        await execAsync(`redis-cli lpush "swarm:${taskId}:${agentId}:done" "complete"`);
+        console.log('[CFN Protocol] ✓ Completion signaled');
+        // Step 2: Extract and report confidence
+        const confidence = extractConfidence(output);
+        console.log(`[CFN Protocol] Step 2: Reporting confidence (${confidence})...`);
+        const reportCmd = `./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \
+      --task-id "${taskId}" \
+      --agent-id "${agentId}" \
+      --confidence ${confidence} \
+      --iteration ${iteration}`;
+        await execAsync(reportCmd);
+        console.log('[CFN Protocol] ✓ Confidence reported');
+        // Step 3: Exit cleanly (BUG #18 FIX - removed waiting mode)
+        // Orchestrator will spawn appropriate specialist agent for next iteration
+        // This enables adaptive agent specialization based on feedback type
+        console.log('[CFN Protocol] Step 3: Exiting cleanly (iteration complete)');
+        console.log('[CFN Protocol] Protocol complete\n');
+    } catch (error) {
+        console.error('[CFN Protocol] Error:', error);
+        throw error;
+    }
+}
 /**
  * Check if custom routing (z.ai) is enabled
  */ async function isCustomRoutingEnabled() {
@@ -42,20 +110,86 @@ import os from 'os';
     console.log(`[agent-executor] Model: ${definition.model}`);
     console.log('');
     try {
-        // Build system prompt with natural language context (Phase 1 enhancement)
-        console.log('[agent-executor] Building system prompt with context...');
-        const contextOptions = loadContextFromEnv();
-        // Override agent type with definition name
-        contextOptions.agentType = definition.name;
-        // Override iteration/taskId if provided in context
-        if (context.taskId) contextOptions.taskId = context.taskId;
-        if (context.iteration) contextOptions.iteration = context.iteration;
-        const systemPrompt = await buildCLIAgentSystemPrompt(contextOptions);
-        console.log('[agent-executor] System prompt built successfully');
+        // Check for conversation fork (Sprint 4 enhancement)
+        const forkId = process.env.FORK_ID || await getCurrentFork(context.taskId || '', agentId);
+        const iteration = context.iteration || 1;
+        let systemPrompt;
+        let messages = [];
+        if (forkId && iteration > 1) {
+            // Continue from fork (iterations 2+)
+            console.log(`[agent-executor] Continuing from fork: ${forkId}`);
+            // Load fork messages
+            const forkMessages = await loadMessages(context.taskId || '', agentId, forkId);
+            console.log(`[agent-executor] Loaded ${forkMessages.length} messages from fork`);
+            // Extract system prompt from first message (it's always the system message)
+            // The fork messages are assistant/user pairs, we need to add system separately
+            systemPrompt = forkMessages[0]?.content || '';
+            // Format remaining messages for API
+            messages = formatMessagesForAPI(forkMessages.slice(1));
+            // Add new user message with feedback
+            messages.push({
+                role: 'user',
+                content: prompt
+            });
+            console.log(`[agent-executor] Fork continuation: ${messages.length} messages`);
+        } else {
+            // New conversation (iteration 1)
+            console.log('[agent-executor] Starting new conversation');
+            console.log('[agent-executor] Building system prompt with context...');
+            const contextOptions = loadContextFromEnv();
+            contextOptions.agentType = definition.name;
+            if (context.taskId) contextOptions.taskId = context.taskId;
+            if (context.iteration) contextOptions.iteration = context.iteration;
+            systemPrompt = await buildCLIAgentSystemPrompt(contextOptions);
+            console.log('[agent-executor] System prompt built successfully');
+            // Initial user message
+            messages = [
+                {
+                    role: 'user',
+                    content: prompt
+                }
+            ];
+        }
         console.log('');
         // Dynamic import to avoid bundling issues
         const { executeAgentAPI } = await import('./anthropic-client.js');
-        const result = await executeAgentAPI(definition.name, agentId, definition.model, prompt, systemPrompt);
+        // Convert agent tool names to Anthropic API format
+        const tools = definition.tools && definition.tools.length > 0 ? convertToolNames(definition.tools) : undefined;
+        const result = await executeAgentAPI(definition.name, agentId, definition.model, prompt, systemPrompt, messages.length > 1 ? messages : undefined, undefined, tools // Pass converted tools
+        );
+        // Store messages in conversation history (for future forking)
+        if (context.taskId) {
+            // Store user message
+            const userMessage = {
+                role: 'user',
+                content: prompt,
+                iteration,
+                timestamp: new Date().toISOString()
+            };
+            await storeMessage(context.taskId, agentId, userMessage);
+            // Store assistant response
+            if (result.output) {
+                const assistantMessage = {
+                    role: 'assistant',
+                    content: result.output,
+                    iteration,
+                    timestamp: new Date().toISOString()
+                };
+                await storeMessage(context.taskId, agentId, assistantMessage);
+            }
+            console.log(`[agent-executor] Stored messages for iteration ${iteration}`);
+            // Execute CFN Loop protocol (signal completion, report confidence, enter waiting mode)
+            // Iterations are enabled for CFN Loop tasks (indicated by presence of taskId)
+            try {
+                const maxIterations = 10; // Default max iterations
+                const enableIterations = true; // Enable iterations for all CFN Loop tasks
+                await executeCFNProtocol(context.taskId, agentId, result.output, iteration, enableIterations, maxIterations);
+            } catch (error) {
+                console.error('[agent-executor] CFN Protocol execution failed:', error);
+            // Don't fail the entire agent execution if CFN protocol fails
+            // This allows agents to complete even if Redis coordination has issues
+            }
+        }
         return {
             success: result.success,
             agentId,

package/dist/cli/agent-executor.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/agent-executor.ts"],"sourcesContent":["/**\r\n * Agent Executor\r\n *\r\n * Executes CLI-spawned agents by:\r\n * 1. Checking custom routing configuration (z.ai vs Anthropic)\r\n * 2. Invoking the appropriate API\r\n * 3. Managing agent lifecycle and output\r\n */\r\n\r\nimport { spawn } from 'child_process';\r\nimport { AgentDefinition } from './agent-definition-parser.js';\r\nimport { TaskContext, getAgentId } from './agent-prompt-builder.js';\r\nimport { buildCLIAgentSystemPrompt, loadContextFromEnv } from './cli-agent-context.js';\r\nimport fs from 'fs/promises';\r\nimport path from 'path';\r\nimport os from 'os';\r\n\r\nexport interface AgentExecutionResult {\r\n  success: boolean;\r\n  agentId: string;\r\n  output?: string;\r\n  error?: string;\r\n  exitCode: number;\r\n}\r\n\r\n/**\r\n * Check if custom routing (z.ai) is enabled\r\n */\r\nasync function isCustomRoutingEnabled(): Promise<boolean> {\r\n  // Check environment variable\r\n  if (process.env.CLAUDE_API_PROVIDER === 'zai') {\r\n    return true;\r\n  }\r\n\r\n  // Check config file (.claude/config/api-provider.json)\r\n  try {\r\n    const configPath = path.join('.claude', 'config', 'api-provider.json');\r\n    const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));\r\n    return config.provider === 'zai' || config.provider === 'z.ai';\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get API provider configuration\r\n */\r\nasync function getAPIProvider(): Promise<'anthropic' | 'zai'> {\r\n  const customEnabled = await isCustomRoutingEnabled();\r\n  return customEnabled ? 'zai' : 'anthropic';\r\n}\r\n\r\n/**\r\n * Execute agent using direct API calls\r\n */\r\nasync function executeViaAPI(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext\r\n): Promise<AgentExecutionResult> {\r\n  const agentId = getAgentId(definition, context);\r\n\r\n  console.log(`[agent-executor] Executing agent via API: ${definition.name}`);\r\n  console.log(`[agent-executor] Agent ID: ${agentId}`);\r\n  console.log(`[agent-executor] Model: ${definition.model}`);\r\n  console.log('');\r\n\r\n  try {\r\n    // Build system prompt with natural language context (Phase 1 enhancement)\r\n    console.log('[agent-executor] Building system prompt with context...');\r\n    const contextOptions = loadContextFromEnv();\r\n    // Override agent type with definition name\r\n    contextOptions.agentType = definition.name;\r\n    // Override iteration/taskId if provided in context\r\n    if (context.taskId) contextOptions.taskId = context.taskId;\r\n    if (context.iteration) contextOptions.iteration = context.iteration;\r\n\r\n    const systemPrompt = await buildCLIAgentSystemPrompt(contextOptions);\r\n    console.log('[agent-executor] System prompt built successfully');\r\n    console.log('');\r\n\r\n    // Dynamic import to avoid bundling issues\r\n    const { executeAgentAPI } = await import('./anthropic-client.js');\r\n\r\n    const result = await executeAgentAPI(\r\n      definition.name,\r\n      agentId,\r\n      definition.model,\r\n      prompt,\r\n      systemPrompt\r\n    );\r\n\r\n    return {\r\n      success: result.success,\r\n      agentId,\r\n      output: result.output,\r\n      error: result.error,\r\n      exitCode: result.success ? 0 : 1,\r\n    };\r\n  } catch (error) {\r\n    console.error('[agent-executor] API execution failed:', error);\r\n    return {\r\n      success: false,\r\n      agentId,\r\n      error: error instanceof Error ? error.message : String(error),\r\n      exitCode: 1,\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Execute agent using shell script (fallback/simulation)\r\n */\r\nasync function executeViaScript(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext\r\n): Promise<AgentExecutionResult> {\r\n  const agentId = getAgentId(definition, context);\r\n\r\n  // Write prompt to temporary file\r\n  const tmpDir = os.tmpdir();\r\n  const promptFile = path.join(tmpDir, `agent-${agentId}-${Date.now()}.md`);\r\n  await fs.writeFile(promptFile, prompt, 'utf-8');\r\n\r\n  console.log(`[agent-executor] Executing agent via script: ${definition.name}`);\r\n  console.log(`[agent-executor] Agent ID: ${agentId}`);\r\n  console.log(`[agent-executor] Model: ${definition.model}`);\r\n  console.log(`[agent-executor] Prompt file: ${promptFile}`);\r\n\r\n  return new Promise((resolve) => {\r\n    const scriptPath = path.join('.claude', 'skills', 'agent-execution', 'execute-agent.sh');\r\n\r\n    // Build environment variables\r\n    const env = {\r\n      ...process.env,\r\n      AGENT_TYPE: definition.name,\r\n      AGENT_ID: agentId,\r\n      AGENT_MODEL: definition.model,\r\n      AGENT_TOOLS: definition.tools.join(','),\r\n      TASK_ID: context.taskId || '',\r\n      ITERATION: String(context.iteration || 1),\r\n      MODE: context.mode || 'cli',\r\n      PROMPT_FILE: promptFile,\r\n    };\r\n\r\n    // Check if execute script exists\r\n    fs.access(scriptPath)\r\n      .then(() => {\r\n        // Use execution script\r\n        const proc = spawn('bash', [scriptPath], { env, stdio: 'inherit' });\r\n\r\n        proc.on('exit', (code) => {\r\n          resolve({\r\n            success: code === 0,\r\n            agentId,\r\n            exitCode: code || 0,\r\n          });\r\n        });\r\n\r\n        proc.on('error', (err) => {\r\n          resolve({\r\n            success: false,\r\n            agentId,\r\n            error: err.message,\r\n            exitCode: 1,\r\n          });\r\n        });\r\n      })\r\n      .catch(() => {\r\n        // Fallback: Print prompt\r\n        console.log('\\n=== Agent Prompt ===');\r\n        console.log(prompt.substring(0, 500) + '...');\r\n        console.log('\\n[agent-executor] Execution script not found');\r\n        console.log('[agent-executor] Using simulation mode\\n');\r\n\r\n        resolve({\r\n          success: true,\r\n          agentId,\r\n          output: prompt,\r\n          exitCode: 0,\r\n        });\r\n      });\r\n  });\r\n}\r\n\r\n/**\r\n * Main agent execution function\r\n */\r\nexport async function executeAgent(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext,\r\n  options: {\r\n    method?: 'auto' | 'api' | 'script';\r\n  } = {}\r\n): Promise<AgentExecutionResult> {\r\n  const method = options.method || 'auto';\r\n\r\n  // Auto-select execution method\r\n  if (method === 'auto') {\r\n    // Try API execution first, fallback to script if API key not available\r\n    try {\r\n      return await executeViaAPI(definition, prompt, context);\r\n    } catch (error) {\r\n      if (error instanceof Error && error.message.includes('API key not found')) {\r\n        console.log('[agent-executor] API key not found, using script fallback');\r\n        return executeViaScript(definition, prompt, context);\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  if (method === 'api') {\r\n    return executeViaAPI(definition, prompt, context);\r\n  }\r\n\r\n  return executeViaScript(definition, prompt, context);\r\n}\r\n\r\n/**\r\n * Write agent output to file for debugging\r\n */\r\nexport async function saveAgentOutput(\r\n  agentId: string,\r\n  output: string,\r\n  outputDir: string = '.claude/tmp/agent-output'\r\n): Promise<string> {\r\n  await fs.mkdir(outputDir, { recursive: true });\r\n\r\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\r\n  const filename = `${agentId}-${timestamp}.txt`;\r\n  const filepath = path.join(outputDir, filename);\r\n\r\n  await fs.writeFile(filepath, output, 'utf-8');\r\n\r\n  return filepath;\r\n}\r\n"],"names":["spawn","getAgentId","buildCLIAgentSystemPrompt","loadContextFromEnv","fs","path","os","isCustomRoutingEnabled","process","env","CLAUDE_API_PROVIDER","configPath","join","config","JSON","parse","readFile","provider","getAPIProvider","customEnabled","executeViaAPI","definition","prompt","context","agentId","console","log","name","model","contextOptions","agentType","taskId","iteration","systemPrompt","executeAgentAPI","result","success","output","error","exitCode","Error","message","String","executeViaScript","tmpDir","tmpdir","promptFile","Date","now","writeFile","Promise","resolve","scriptPath","AGENT_TYPE","AGENT_ID","AGENT_MODEL","AGENT_TOOLS","tools","TASK_ID","ITERATION","MODE","mode","PROMPT_FILE","access","then","proc","stdio","on","code","err","catch","substring","executeAgent","options","method","includes","saveAgentOutput","outputDir","mkdir","recursive","timestamp","toISOString","replace","filename","filepath"],"mappings":"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"}
+{"version":3,"sources":["../../src/cli/agent-executor.ts"],"sourcesContent":["/**\r\n * Agent Executor\r\n *\r\n * Executes CLI-spawned agents by:\r\n * 1. Checking custom routing configuration (z.ai vs Anthropic)\r\n * 2. Invoking the appropriate API\r\n * 3. Managing agent lifecycle and output\r\n */\r\n\r\nimport { spawn } from 'child_process';\r\nimport { exec } from 'child_process';\r\nimport { promisify } from 'util';\r\nimport { AgentDefinition } from './agent-definition-parser.js';\r\nimport { TaskContext, getAgentId } from './agent-prompt-builder.js';\r\nimport { buildCLIAgentSystemPrompt, loadContextFromEnv } from './cli-agent-context.js';\r\nimport {\r\n  loadMessages,\r\n  storeMessage,\r\n  getCurrentFork,\r\n  formatMessagesForAPI,\r\n  type Message\r\n} from './conversation-fork.js';\r\nimport { convertToolNames } from './tool-definitions.js';\r\nimport fs from 'fs/promises';\r\nimport path from 'path';\r\nimport os from 'os';\r\n\r\nconst execAsync = promisify(exec);\r\n\r\nexport interface AgentExecutionResult {\r\n  success: boolean;\r\n  agentId: string;\r\n  output?: string;\r\n  error?: string;\r\n  exitCode: number;\r\n}\r\n\r\n/**\r\n * Extract confidence score from agent output\r\n * Looks for patterns like:\r\n * - \"confidence: 0.85\"\r\n * - \"Confidence: 0.90\"\r\n * - \"confidence score: 0.95\"\r\n * - \"self-confidence: 0.88\"\r\n */\r\nfunction extractConfidence(output: string | undefined): number {\r\n  if (!output) return 0.85;\r\n\r\n  // Try multiple patterns\r\n  const patterns = [\r\n    /confidence:\\s*([0-9.]+)/i,\r\n    /confidence\\s+score:\\s*([0-9.]+)/i,\r\n    /self-confidence:\\s*([0-9.]+)/i,\r\n    /my\\s+confidence:\\s*([0-9.]+)/i,\r\n  ];\r\n\r\n  for (const pattern of patterns) {\r\n    const match = output.match(pattern);\r\n    if (match && match[1]) {\r\n      const score = parseFloat(match[1]);\r\n      if (score >= 0 && score <= 1) {\r\n        return score;\r\n      }\r\n    }\r\n  }\r\n\r\n  // Default to 0.85 if not found\r\n  return 0.85;\r\n}\r\n\r\n/**\r\n * Execute CFN Loop protocol after agent completes work\r\n *\r\n * Steps:\r\n * 1. Signal completion to orchestrator\r\n * 2. Report confidence score\r\n * 3. Enter waiting mode (if iterations enabled)\r\n */\r\nasync function executeCFNProtocol(\r\n  taskId: string,\r\n  agentId: string,\r\n  output: string | undefined,\r\n  iteration: number,\r\n  enableIterations: boolean = false,\r\n  maxIterations: number = 10\r\n): Promise<void> {\r\n  console.log(`\\n[CFN Protocol] Starting for agent ${agentId}`);\r\n  console.log(`[CFN Protocol] Task ID: ${taskId}, Iteration: ${iteration}`);\r\n\r\n  try {\r\n    // Step 1: Signal completion\r\n    console.log('[CFN Protocol] Step 1: Signaling completion...');\r\n    await execAsync(`redis-cli lpush \"swarm:${taskId}:${agentId}:done\" \"complete\"`);\r\n    console.log('[CFN Protocol] ✓ Completion signaled');\r\n\r\n    // Step 2: Extract and report confidence\r\n    const confidence = extractConfidence(output);\r\n    console.log(`[CFN Protocol] Step 2: Reporting confidence (${confidence})...`);\r\n\r\n    const reportCmd = `./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \\\r\n      --task-id \"${taskId}\" \\\r\n      --agent-id \"${agentId}\" \\\r\n      --confidence ${confidence} \\\r\n      --iteration ${iteration}`;\r\n\r\n    await execAsync(reportCmd);\r\n    console.log('[CFN Protocol] ✓ Confidence reported');\r\n\r\n    // Step 3: Exit cleanly (BUG #18 FIX - removed waiting mode)\r\n    // Orchestrator will spawn appropriate specialist agent for next iteration\r\n    // This enables adaptive agent specialization based on feedback type\r\n    console.log('[CFN Protocol] Step 3: Exiting cleanly (iteration complete)');\r\n    console.log('[CFN Protocol] Protocol complete\\n');\r\n  } catch (error) {\r\n    console.error('[CFN Protocol] Error:', error);\r\n    throw error;\r\n  }\r\n}\r\n\r\n/**\r\n * Check if custom routing (z.ai) is enabled\r\n */\r\nasync function isCustomRoutingEnabled(): Promise<boolean> {\r\n  // Check environment variable\r\n  if (process.env.CLAUDE_API_PROVIDER === 'zai') {\r\n    return true;\r\n  }\r\n\r\n  // Check config file (.claude/config/api-provider.json)\r\n  try {\r\n    const configPath = path.join('.claude', 'config', 'api-provider.json');\r\n    const config = JSON.parse(await fs.readFile(configPath, 'utf-8'));\r\n    return config.provider === 'zai' || config.provider === 'z.ai';\r\n  } catch {\r\n    return false;\r\n  }\r\n}\r\n\r\n/**\r\n * Get API provider configuration\r\n */\r\nasync function getAPIProvider(): Promise<'anthropic' | 'zai'> {\r\n  const customEnabled = await isCustomRoutingEnabled();\r\n  return customEnabled ? 'zai' : 'anthropic';\r\n}\r\n\r\n/**\r\n * Execute agent using direct API calls\r\n */\r\nasync function executeViaAPI(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext\r\n): Promise<AgentExecutionResult> {\r\n  const agentId = getAgentId(definition, context);\r\n\r\n  console.log(`[agent-executor] Executing agent via API: ${definition.name}`);\r\n  console.log(`[agent-executor] Agent ID: ${agentId}`);\r\n  console.log(`[agent-executor] Model: ${definition.model}`);\r\n  console.log('');\r\n\r\n  try {\r\n    // Check for conversation fork (Sprint 4 enhancement)\r\n    const forkId = process.env.FORK_ID || await getCurrentFork(context.taskId || '', agentId);\r\n    const iteration = context.iteration || 1;\r\n\r\n    let systemPrompt: string;\r\n    let messages: Array<{role: string, content: string}> = [];\r\n\r\n    if (forkId && iteration > 1) {\r\n      // Continue from fork (iterations 2+)\r\n      console.log(`[agent-executor] Continuing from fork: ${forkId}`);\r\n\r\n      // Load fork messages\r\n      const forkMessages = await loadMessages(context.taskId || '', agentId, forkId);\r\n      console.log(`[agent-executor] Loaded ${forkMessages.length} messages from fork`);\r\n\r\n      // Extract system prompt from first message (it's always the system message)\r\n      // The fork messages are assistant/user pairs, we need to add system separately\r\n      systemPrompt = forkMessages[0]?.content || '';\r\n\r\n      // Format remaining messages for API\r\n      messages = formatMessagesForAPI(forkMessages.slice(1));\r\n\r\n      // Add new user message with feedback\r\n      messages.push({\r\n        role: 'user',\r\n        content: prompt\r\n      });\r\n\r\n      console.log(`[agent-executor] Fork continuation: ${messages.length} messages`);\r\n    } else {\r\n      // New conversation (iteration 1)\r\n      console.log('[agent-executor] Starting new conversation');\r\n      console.log('[agent-executor] Building system prompt with context...');\r\n\r\n      const contextOptions = loadContextFromEnv();\r\n      contextOptions.agentType = definition.name;\r\n      if (context.taskId) contextOptions.taskId = context.taskId;\r\n      if (context.iteration) contextOptions.iteration = context.iteration;\r\n\r\n      systemPrompt = await buildCLIAgentSystemPrompt(contextOptions);\r\n      console.log('[agent-executor] System prompt built successfully');\r\n\r\n      // Initial user message\r\n      messages = [{\r\n        role: 'user',\r\n        content: prompt\r\n      }];\r\n    }\r\n\r\n    console.log('');\r\n\r\n    // Dynamic import to avoid bundling issues\r\n    const { executeAgentAPI } = await import('./anthropic-client.js');\r\n\r\n    // Convert agent tool names to Anthropic API format\r\n    const tools = definition.tools && definition.tools.length > 0\r\n      ? convertToolNames(definition.tools)\r\n      : undefined;\r\n\r\n    const result = await executeAgentAPI(\r\n      definition.name,\r\n      agentId,\r\n      definition.model,\r\n      prompt,\r\n      systemPrompt,\r\n      messages.length > 1 ? messages : undefined,\r\n      undefined, // maxTokens (use default)\r\n      tools  // Pass converted tools\r\n    );\r\n\r\n    // Store messages in conversation history (for future forking)\r\n    if (context.taskId) {\r\n      // Store user message\r\n      const userMessage: Message = {\r\n        role: 'user',\r\n        content: prompt,\r\n        iteration,\r\n        timestamp: new Date().toISOString()\r\n      };\r\n      await storeMessage(context.taskId, agentId, userMessage);\r\n\r\n      // Store assistant response\r\n      if (result.output) {\r\n        const assistantMessage: Message = {\r\n          role: 'assistant',\r\n          content: result.output,\r\n          iteration,\r\n          timestamp: new Date().toISOString()\r\n        };\r\n        await storeMessage(context.taskId, agentId, assistantMessage);\r\n      }\r\n\r\n      console.log(`[agent-executor] Stored messages for iteration ${iteration}`);\r\n\r\n      // Execute CFN Loop protocol (signal completion, report confidence, enter waiting mode)\r\n      // Iterations are enabled for CFN Loop tasks (indicated by presence of taskId)\r\n      try {\r\n        const maxIterations = 10; // Default max iterations\r\n        const enableIterations = true; // Enable iterations for all CFN Loop tasks\r\n\r\n        await executeCFNProtocol(\r\n          context.taskId,\r\n          agentId,\r\n          result.output,\r\n          iteration,\r\n          enableIterations,\r\n          maxIterations\r\n        );\r\n      } catch (error) {\r\n        console.error('[agent-executor] CFN Protocol execution failed:', error);\r\n        // Don't fail the entire agent execution if CFN protocol fails\r\n        // This allows agents to complete even if Redis coordination has issues\r\n      }\r\n    }\r\n\r\n    return {\r\n      success: result.success,\r\n      agentId,\r\n      output: result.output,\r\n      error: result.error,\r\n      exitCode: result.success ? 0 : 1,\r\n    };\r\n  } catch (error) {\r\n    console.error('[agent-executor] API execution failed:', error);\r\n    return {\r\n      success: false,\r\n      agentId,\r\n      error: error instanceof Error ? error.message : String(error),\r\n      exitCode: 1,\r\n    };\r\n  }\r\n}\r\n\r\n/**\r\n * Execute agent using shell script (fallback/simulation)\r\n */\r\nasync function executeViaScript(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext\r\n): Promise<AgentExecutionResult> {\r\n  const agentId = getAgentId(definition, context);\r\n\r\n  // Write prompt to temporary file\r\n  const tmpDir = os.tmpdir();\r\n  const promptFile = path.join(tmpDir, `agent-${agentId}-${Date.now()}.md`);\r\n  await fs.writeFile(promptFile, prompt, 'utf-8');\r\n\r\n  console.log(`[agent-executor] Executing agent via script: ${definition.name}`);\r\n  console.log(`[agent-executor] Agent ID: ${agentId}`);\r\n  console.log(`[agent-executor] Model: ${definition.model}`);\r\n  console.log(`[agent-executor] Prompt file: ${promptFile}`);\r\n\r\n  return new Promise((resolve) => {\r\n    const scriptPath = path.join('.claude', 'skills', 'agent-execution', 'execute-agent.sh');\r\n\r\n    // Build environment variables\r\n    const env = {\r\n      ...process.env,\r\n      AGENT_TYPE: definition.name,\r\n      AGENT_ID: agentId,\r\n      AGENT_MODEL: definition.model,\r\n      AGENT_TOOLS: definition.tools.join(','),\r\n      TASK_ID: context.taskId || '',\r\n      ITERATION: String(context.iteration || 1),\r\n      MODE: context.mode || 'cli',\r\n      PROMPT_FILE: promptFile,\r\n    };\r\n\r\n    // Check if execute script exists\r\n    fs.access(scriptPath)\r\n      .then(() => {\r\n        // Use execution script\r\n        const proc = spawn('bash', [scriptPath], { env, stdio: 'inherit' });\r\n\r\n        proc.on('exit', (code) => {\r\n          resolve({\r\n            success: code === 0,\r\n            agentId,\r\n            exitCode: code || 0,\r\n          });\r\n        });\r\n\r\n        proc.on('error', (err) => {\r\n          resolve({\r\n            success: false,\r\n            agentId,\r\n            error: err.message,\r\n            exitCode: 1,\r\n          });\r\n        });\r\n      })\r\n      .catch(() => {\r\n        // Fallback: Print prompt\r\n        console.log('\\n=== Agent Prompt ===');\r\n        console.log(prompt.substring(0, 500) + '...');\r\n        console.log('\\n[agent-executor] Execution script not found');\r\n        console.log('[agent-executor] Using simulation mode\\n');\r\n\r\n        resolve({\r\n          success: true,\r\n          agentId,\r\n          output: prompt,\r\n          exitCode: 0,\r\n        });\r\n      });\r\n  });\r\n}\r\n\r\n/**\r\n * Main agent execution function\r\n */\r\nexport async function executeAgent(\r\n  definition: AgentDefinition,\r\n  prompt: string,\r\n  context: TaskContext,\r\n  options: {\r\n    method?: 'auto' | 'api' | 'script';\r\n  } = {}\r\n): Promise<AgentExecutionResult> {\r\n  const method = options.method || 'auto';\r\n\r\n  // Auto-select execution method\r\n  if (method === 'auto') {\r\n    // Try API execution first, fallback to script if API key not available\r\n    try {\r\n      return await executeViaAPI(definition, prompt, context);\r\n    } catch (error) {\r\n      if (error instanceof Error && error.message.includes('API key not found')) {\r\n        console.log('[agent-executor] API key not found, using script fallback');\r\n        return executeViaScript(definition, prompt, context);\r\n      }\r\n      throw error;\r\n    }\r\n  }\r\n\r\n  if (method === 'api') {\r\n    return executeViaAPI(definition, prompt, context);\r\n  }\r\n\r\n  return executeViaScript(definition, prompt, context);\r\n}\r\n\r\n/**\r\n * Write agent output to file for debugging\r\n */\r\nexport async function saveAgentOutput(\r\n  agentId: string,\r\n  output: string,\r\n  outputDir: string = '.claude/tmp/agent-output'\r\n): Promise<string> {\r\n  await fs.mkdir(outputDir, { recursive: true });\r\n\r\n  const timestamp = new Date().toISOString().replace(/[:.]/g, '-');\r\n  const filename = `${agentId}-${timestamp}.txt`;\r\n  const filepath = path.join(outputDir, filename);\r\n\r\n  await fs.writeFile(filepath, output, 'utf-8');\r\n\r\n  return filepath;\r\n}\r\n"],"names":["spawn","exec","promisify","getAgentId","buildCLIAgentSystemPrompt","loadContextFromEnv","loadMessages","storeMessage","getCurrentFork","formatMessagesForAPI","convertToolNames","fs","path","os","execAsync","extractConfidence","output","patterns","pattern","match","score","parseFloat","executeCFNProtocol","taskId","agentId","iteration","enableIterations","maxIterations","console","log","confidence","reportCmd","error","isCustomRoutingEnabled","process","env","CLAUDE_API_PROVIDER","configPath","join","config","JSON","parse","readFile","provider","getAPIProvider","customEnabled","executeViaAPI","definition","prompt","context","name","model","forkId","FORK_ID","systemPrompt","messages","forkMessages","length","content","slice","push","role","contextOptions","agentType","executeAgentAPI","tools","undefined","result","userMessage","timestamp","Date","toISOString","assistantMessage","success","exitCode","Error","message","String","executeViaScript","tmpDir","tmpdir","promptFile","now","writeFile","Promise","resolve","scriptPath","AGENT_TYPE","AGENT_ID","AGENT_MODEL","AGENT_TOOLS","TASK_ID","ITERATION","MODE","mode","PROMPT_FILE","access","then","proc","stdio","on","code","err","catch","substring","executeAgent","options","method","includes","saveAgentOutput","outputDir","mkdir","recursive","replace","filename","filepath"],"mappings":"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"}

package/dist/cli/agent-prompt-builder.js

@@ -56,15 +56,91 @@ redis-cli lpush "swarm:${taskId}:\${AGENT_ID}:done" "complete"
 **IMPORTANT:** You MUST complete all 4 steps in order. The orchestrator is waiting for your completion signal.
 `;
 }
+/**
+ * Parse and enrich JSON context into natural language instructions
+ */ function enrichJSONContext(jsonObj) {
+    const sections = [];
+    // Extract task description
+    if (jsonObj.task) {
+        sections.push(`**Task:** ${jsonObj.task}`);
+    }
+    // Parse files - convert comma-separated string to bullet list
+    if (jsonObj.files) {
+        const fileList = typeof jsonObj.files === 'string' ? jsonObj.files.split(',').map((f)=>f.trim()).filter((f)=>f) : Array.isArray(jsonObj.files) ? jsonObj.files : [];
+        if (fileList.length > 0) {
+            sections.push('\n**Files to process:**');
+            fileList.forEach((file)=>sections.push(`- ${file}`));
+        }
+    }
+    // Add requirements/deliverables
+    if (jsonObj.requirements) {
+        const reqs = Array.isArray(jsonObj.requirements) ? jsonObj.requirements : [
+            jsonObj.requirements
+        ];
+        sections.push('\n**Requirements:**');
+        reqs.forEach((req, i)=>sections.push(`${i + 1}. ${req}`));
+    }
+    if (jsonObj.deliverables) {
+        const delivs = Array.isArray(jsonObj.deliverables) ? jsonObj.deliverables : [
+            jsonObj.deliverables
+        ];
+        sections.push('\n**Deliverables:**');
+        delivs.forEach((deliv)=>sections.push(`- ${deliv}`));
+    }
+    // Add batch information
+    if (jsonObj.batch) {
+        sections.push(`\n**Batch:** ${jsonObj.batch}`);
+    }
+    // Add directory context
+    if (jsonObj.directory) {
+        sections.push(`\n**Working Directory:** ${jsonObj.directory}`);
+    }
+    // Add acceptance criteria
+    if (jsonObj.acceptanceCriteria) {
+        const criteria = Array.isArray(jsonObj.acceptanceCriteria) ? jsonObj.acceptanceCriteria : [
+            jsonObj.acceptanceCriteria
+        ];
+        sections.push('\n**Acceptance Criteria:**');
+        criteria.forEach((criterion)=>sections.push(`- ${criterion}`));
+    }
+    // Add explicit instructions if present
+    if (jsonObj.instructions) {
+        sections.push('\n**Instructions:**');
+        const instrs = Array.isArray(jsonObj.instructions) ? jsonObj.instructions : [
+            jsonObj.instructions
+        ];
+        instrs.forEach((instr, i)=>sections.push(`${i + 1}. ${instr}`));
+    }
+    return sections.join('\n');
+}
 /**
  * Build task description from context
  */ function buildTaskDescription(agentType, context) {
     let desc = '';
     if (context.context) {
-        desc = context.context;
+        // Try to parse as JSON first
+        let contextStr = context.context.trim();
+        // Check if context looks like JSON
+        if (contextStr.startsWith('{') && contextStr.endsWith('}') || contextStr.startsWith('[') && contextStr.endsWith(']')) {
+            try {
+                const jsonObj = JSON.parse(contextStr);
+                desc = enrichJSONContext(jsonObj);
+                // Add instruction footer for structured tasks
+                if (jsonObj.files || jsonObj.deliverables) {
+                    desc += '\n\n**Process each item systematically and report confidence when complete.**';
+                }
+            } catch (e) {
+                // Not valid JSON, treat as plain text
+                desc = context.context;
+            }
+        } else {
+            // Plain text context
+            desc = context.context;
+        }
     } else {
         desc = `Execute task as ${agentType} agent`;
     }
+    // Add metadata fields
     if (context.taskId) {
         desc += `\n\n**Task ID:** ${context.taskId}`;
     }
@@ -170,7 +246,11 @@ ${env.join('\n')}
 }
 /**
  * Extract agent ID from context
+ * If agentId is explicitly provided in context, use it; otherwise generate from name + iteration
  */ export function getAgentId(definition, context) {
+    if (context.agentId) {
+        return context.agentId;
+    }
     return `${definition.name}-${context.iteration || 1}`;
 }
 /**

package/dist/cli/agent-prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/cli/agent-prompt-builder.ts"],"sourcesContent":["/**\r\n * Agent Prompt Builder\r\n *\r\n * Builds comprehensive prompts for CLI-spawned agents by combining:\r\n * - Agent definition (YAML + markdown)\r\n * - Task context (taskId, iteration, mode)\r\n * - CFN Loop protocol (if applicable)\r\n * - Iteration history (Sprint 3 - Phase 2)\r\n * - Environment variables\r\n */\r\n\r\nimport { AgentDefinition, hasCFNLoopProtocol } from './agent-definition-parser.js';\r\nimport { loadIterationHistory, formatIterationHistory } from './iteration-history.js';\r\n\r\nexport interface TaskContext {\r\n  taskId?: string;\r\n  iteration?: number;\r\n  context?: string;\r\n  mode?: string;\r\n  priority?: number;\r\n  parentTaskId?: string;\r\n}\r\n\r\n/**\r\n * Build CFN Loop protocol instructions\r\n */\r\nfunction buildCFNLoopProtocol(taskId: string, agentId: string): string {\r\n  return `\r\n## CFN Loop Redis Completion Protocol\r\n\r\nYou are participating in a CFN Loop workflow. Follow this protocol EXACTLY:\r\n\r\n### Step 1: Complete Work\r\nExecute your assigned task (implementation, review, testing, etc.)\r\n\r\n### Step 2: Signal Completion\r\n\\`\\`\\`bash\r\nredis-cli lpush \"swarm:${taskId}:\\${AGENT_ID}:done\" \"complete\"\r\n\\`\\`\\`\r\n\r\n### Step 3: Report Confidence Score\r\n\\`\\`\\`bash\r\n./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \\\\\r\n  --task-id \"${taskId}\" \\\\\r\n  --agent-id \"\\${AGENT_ID}\" \\\\\r\n  --confidence [0.0-1.0] \\\\\r\n  --iteration ${taskId.includes('iteration') ? 'CURRENT_ITERATION' : '1'}\r\n\\`\\`\\`\r\n\r\n### Step 4: Enter Waiting Mode (for potential iteration)\r\n\\`\\`\\`bash\r\n./.claude/skills/redis-coordination/invoke-waiting-mode.sh enter \\\\\r\n  --task-id \"${taskId}\" \\\\\r\n  --agent-id \"\\${AGENT_ID}\" \\\\\r\n  --context \"iteration-complete\"\r\n\\`\\`\\`\r\n\r\n**Critical Context Variables:**\r\n- TASK_ID: ${taskId}\r\n- AGENT_ID: ${agentId} (your unique identifier)\r\n- Confidence: Your self-assessment score (0.0-1.0)\r\n\r\n**Why This Matters:**\r\n- Zero-token blocking coordination (BLPOP waits without API calls)\r\n- Orchestrator collects confidence/consensus scores automatically\r\n- Supports autonomous iteration based on quality gates\r\n- Agent woken instantly (<100ms) if iteration needed\r\n\r\n**IMPORTANT:** You MUST complete all 4 steps in order. The orchestrator is waiting for your completion signal.\r\n`;\r\n}\r\n\r\n/**\r\n * Build task description from context\r\n */\r\nfunction buildTaskDescription(agentType: string, context: TaskContext): string {\r\n  let desc = '';\r\n\r\n  if (context.context) {\r\n    desc = context.context;\r\n  } else {\r\n    desc = `Execute task as ${agentType} agent`;\r\n  }\r\n\r\n  if (context.taskId) {\r\n    desc += `\\n\\n**Task ID:** ${context.taskId}`;\r\n  }\r\n\r\n  if (context.iteration) {\r\n    desc += `\\n**Iteration:** ${context.iteration}`;\r\n  }\r\n\r\n  if (context.mode) {\r\n    desc += `\\n**Mode:** ${context.mode}`;\r\n  }\r\n\r\n  if (context.priority) {\r\n    desc += `\\n**Priority:** ${context.priority}`;\r\n  }\r\n\r\n  if (context.parentTaskId) {\r\n    desc += `\\n**Parent Task:** ${context.parentTaskId}`;\r\n  }\r\n\r\n  return desc;\r\n}\r\n\r\n/**\r\n * Build environment context section\r\n */\r\nfunction buildEnvironmentContext(context: TaskContext): string {\r\n  const env: string[] = [];\r\n\r\n  if (context.taskId) env.push(`TASK_ID=${context.taskId}`);\r\n  if (context.iteration) env.push(`ITERATION=${context.iteration}`);\r\n  if (context.mode) env.push(`MODE=${context.mode}`);\r\n  if (context.priority) env.push(`PRIORITY=${context.priority}`);\r\n  if (context.parentTaskId) env.push(`PARENT_TASK_ID=${context.parentTaskId}`);\r\n\r\n  if (env.length === 0) return '';\r\n\r\n  return `\r\n## Environment Variables\r\n\r\n\\`\\`\\`bash\r\n${env.join('\\n')}\r\n\\`\\`\\`\r\n`;\r\n}\r\n\r\n/**\r\n * Build complete prompt for agent execution (async for iteration history)\r\n */\r\nexport async function buildAgentPrompt(\r\n  definition: AgentDefinition,\r\n  context: TaskContext\r\n): Promise<string> {\r\n  const agentId = `${definition.name}-${context.iteration || 1}`;\r\n\r\n  const sections: string[] = [];\r\n\r\n  // 1. Agent definition header\r\n  sections.push(`# Agent: ${definition.name}`);\r\n  sections.push('');\r\n  sections.push(definition.description);\r\n  sections.push('');\r\n\r\n  // 2. Task description\r\n  sections.push('## Task');\r\n  sections.push('');\r\n  sections.push(buildTaskDescription(definition.name, context));\r\n  sections.push('');\r\n\r\n  // 3. Iteration history (Sprint 3 - Phase 2)\r\n  // Load and format previous iterations if iteration > 1\r\n  if (context.taskId && context.iteration && context.iteration > 1) {\r\n    try {\r\n      const history = await loadIterationHistory(context.taskId, agentId, context.iteration);\r\n      const historyText = formatIterationHistory(history, context.iteration);\r\n      sections.push(historyText);\r\n      sections.push('');\r\n    } catch (err) {\r\n      console.warn(`[agent-prompt-builder] Failed to load iteration history:`, err);\r\n      // Continue without history\r\n    }\r\n  }\r\n\r\n  // 4. Agent definition content (from markdown file)\r\n  sections.push('## Agent Definition');\r\n  sections.push('');\r\n  sections.push(definition.content);\r\n  sections.push('');\r\n\r\n  // 5. CFN Loop protocol (if agent supports it AND task context includes taskId)\r\n  if (context.taskId && hasCFNLoopProtocol(definition)) {\r\n    sections.push(buildCFNLoopProtocol(context.taskId, agentId));\r\n    sections.push('');\r\n  }\r\n\r\n  // 6. Environment context\r\n  const envContext = buildEnvironmentContext(context);\r\n  if (envContext) {\r\n    sections.push(envContext);\r\n    sections.push('');\r\n  }\r\n\r\n  // 7. Execution instructions\r\n  sections.push('## Execution Instructions');\r\n  sections.push('');\r\n  sections.push('1. Read and understand the task requirements');\r\n  if (context.iteration && context.iteration > 1) {\r\n    sections.push('2. Review iteration history and feedback from validators');\r\n    sections.push('3. Address specific feedback points from previous iteration');\r\n    sections.push('4. Execute your core responsibilities as defined above');\r\n  } else {\r\n    sections.push('2. Execute your core responsibilities as defined above');\r\n    sections.push('3. Follow any protocol steps (CFN Loop, validation hooks, etc.)');\r\n  }\r\n  sections.push('4. Provide clear, concise output');\r\n  sections.push('5. Report confidence score if applicable');\r\n  sections.push('');\r\n\r\n  // 8. Tool reminder\r\n  if (definition.tools && definition.tools.length > 0) {\r\n    sections.push('## Available Tools');\r\n    sections.push('');\r\n    sections.push(`You have access to: ${definition.tools.join(', ')}`);\r\n    sections.push('');\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Extract agent ID from context\r\n */\r\nexport function getAgentId(definition: AgentDefinition, context: TaskContext): string {\r\n  return `${definition.name}-${context.iteration || 1}`;\r\n}\r\n\r\n/**\r\n * Build system prompt for agent (optional, for structured agent behavior)\r\n */\r\nexport function buildSystemPrompt(definition: AgentDefinition): string {\r\n  return `You are ${definition.name}, a specialized AI agent.\r\n\r\nType: ${definition.type || 'specialist'}\r\nModel: ${definition.model}\r\nTools: ${definition.tools.join(', ')}\r\n\r\nFollow your agent definition exactly and complete assigned tasks with high quality.`;\r\n}\r\n"],"names":["hasCFNLoopProtocol","loadIterationHistory","formatIterationHistory","buildCFNLoopProtocol","taskId","agentId","includes","buildTaskDescription","agentType","context","desc","iteration","mode","priority","parentTaskId","buildEnvironmentContext","env","push","length","join","buildAgentPrompt","definition","name","sections","description","history","historyText","err","console","warn","content","envContext","tools","getAgentId","buildSystemPrompt","type","model"],"mappings":"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"}
+{"version":3,"sources":["../../src/cli/agent-prompt-builder.ts"],"sourcesContent":["/**\r\n * Agent Prompt Builder\r\n *\r\n * Builds comprehensive prompts for CLI-spawned agents by combining:\r\n * - Agent definition (YAML + markdown)\r\n * - Task context (taskId, iteration, mode)\r\n * - CFN Loop protocol (if applicable)\r\n * - Iteration history (Sprint 3 - Phase 2)\r\n * - Environment variables\r\n */\r\n\r\nimport { AgentDefinition, hasCFNLoopProtocol } from './agent-definition-parser.js';\r\nimport { loadIterationHistory, formatIterationHistory } from './iteration-history.js';\r\n\r\nexport interface TaskContext {\r\n  taskId?: string;\r\n  iteration?: number;\r\n  context?: string;\r\n  mode?: string;\r\n  priority?: number;\r\n  parentTaskId?: string;\r\n  agentId?: string;\r\n}\r\n\r\n/**\r\n * Build CFN Loop protocol instructions\r\n */\r\nfunction buildCFNLoopProtocol(taskId: string, agentId: string): string {\r\n  return `\r\n## CFN Loop Redis Completion Protocol\r\n\r\nYou are participating in a CFN Loop workflow. Follow this protocol EXACTLY:\r\n\r\n### Step 1: Complete Work\r\nExecute your assigned task (implementation, review, testing, etc.)\r\n\r\n### Step 2: Signal Completion\r\n\\`\\`\\`bash\r\nredis-cli lpush \"swarm:${taskId}:\\${AGENT_ID}:done\" \"complete\"\r\n\\`\\`\\`\r\n\r\n### Step 3: Report Confidence Score\r\n\\`\\`\\`bash\r\n./.claude/skills/redis-coordination/invoke-waiting-mode.sh report \\\\\r\n  --task-id \"${taskId}\" \\\\\r\n  --agent-id \"\\${AGENT_ID}\" \\\\\r\n  --confidence [0.0-1.0] \\\\\r\n  --iteration ${taskId.includes('iteration') ? 'CURRENT_ITERATION' : '1'}\r\n\\`\\`\\`\r\n\r\n### Step 4: Enter Waiting Mode (for potential iteration)\r\n\\`\\`\\`bash\r\n./.claude/skills/redis-coordination/invoke-waiting-mode.sh enter \\\\\r\n  --task-id \"${taskId}\" \\\\\r\n  --agent-id \"\\${AGENT_ID}\" \\\\\r\n  --context \"iteration-complete\"\r\n\\`\\`\\`\r\n\r\n**Critical Context Variables:**\r\n- TASK_ID: ${taskId}\r\n- AGENT_ID: ${agentId} (your unique identifier)\r\n- Confidence: Your self-assessment score (0.0-1.0)\r\n\r\n**Why This Matters:**\r\n- Zero-token blocking coordination (BLPOP waits without API calls)\r\n- Orchestrator collects confidence/consensus scores automatically\r\n- Supports autonomous iteration based on quality gates\r\n- Agent woken instantly (<100ms) if iteration needed\r\n\r\n**IMPORTANT:** You MUST complete all 4 steps in order. The orchestrator is waiting for your completion signal.\r\n`;\r\n}\r\n\r\n/**\r\n * Parse and enrich JSON context into natural language instructions\r\n */\r\nfunction enrichJSONContext(jsonObj: any): string {\r\n  const sections: string[] = [];\r\n\r\n  // Extract task description\r\n  if (jsonObj.task) {\r\n    sections.push(`**Task:** ${jsonObj.task}`);\r\n  }\r\n\r\n  // Parse files - convert comma-separated string to bullet list\r\n  if (jsonObj.files) {\r\n    const fileList = typeof jsonObj.files === 'string'\r\n      ? jsonObj.files.split(',').map(f => f.trim()).filter(f => f)\r\n      : Array.isArray(jsonObj.files) ? jsonObj.files : [];\r\n\r\n    if (fileList.length > 0) {\r\n      sections.push('\\n**Files to process:**');\r\n      fileList.forEach(file => sections.push(`- ${file}`));\r\n    }\r\n  }\r\n\r\n  // Add requirements/deliverables\r\n  if (jsonObj.requirements) {\r\n    const reqs = Array.isArray(jsonObj.requirements) ? jsonObj.requirements : [jsonObj.requirements];\r\n    sections.push('\\n**Requirements:**');\r\n    reqs.forEach((req, i) => sections.push(`${i + 1}. ${req}`));\r\n  }\r\n\r\n  if (jsonObj.deliverables) {\r\n    const delivs = Array.isArray(jsonObj.deliverables) ? jsonObj.deliverables : [jsonObj.deliverables];\r\n    sections.push('\\n**Deliverables:**');\r\n    delivs.forEach(deliv => sections.push(`- ${deliv}`));\r\n  }\r\n\r\n  // Add batch information\r\n  if (jsonObj.batch) {\r\n    sections.push(`\\n**Batch:** ${jsonObj.batch}`);\r\n  }\r\n\r\n  // Add directory context\r\n  if (jsonObj.directory) {\r\n    sections.push(`\\n**Working Directory:** ${jsonObj.directory}`);\r\n  }\r\n\r\n  // Add acceptance criteria\r\n  if (jsonObj.acceptanceCriteria) {\r\n    const criteria = Array.isArray(jsonObj.acceptanceCriteria)\r\n      ? jsonObj.acceptanceCriteria\r\n      : [jsonObj.acceptanceCriteria];\r\n    sections.push('\\n**Acceptance Criteria:**');\r\n    criteria.forEach(criterion => sections.push(`- ${criterion}`));\r\n  }\r\n\r\n  // Add explicit instructions if present\r\n  if (jsonObj.instructions) {\r\n    sections.push('\\n**Instructions:**');\r\n    const instrs = Array.isArray(jsonObj.instructions) ? jsonObj.instructions : [jsonObj.instructions];\r\n    instrs.forEach((instr, i) => sections.push(`${i + 1}. ${instr}`));\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Build task description from context\r\n */\r\nfunction buildTaskDescription(agentType: string, context: TaskContext): string {\r\n  let desc = '';\r\n\r\n  if (context.context) {\r\n    // Try to parse as JSON first\r\n    let contextStr = context.context.trim();\r\n\r\n    // Check if context looks like JSON\r\n    if ((contextStr.startsWith('{') && contextStr.endsWith('}')) ||\r\n        (contextStr.startsWith('[') && contextStr.endsWith(']'))) {\r\n      try {\r\n        const jsonObj = JSON.parse(contextStr);\r\n        desc = enrichJSONContext(jsonObj);\r\n\r\n        // Add instruction footer for structured tasks\r\n        if (jsonObj.files || jsonObj.deliverables) {\r\n          desc += '\\n\\n**Process each item systematically and report confidence when complete.**';\r\n        }\r\n      } catch (e) {\r\n        // Not valid JSON, treat as plain text\r\n        desc = context.context;\r\n      }\r\n    } else {\r\n      // Plain text context\r\n      desc = context.context;\r\n    }\r\n  } else {\r\n    desc = `Execute task as ${agentType} agent`;\r\n  }\r\n\r\n  // Add metadata fields\r\n  if (context.taskId) {\r\n    desc += `\\n\\n**Task ID:** ${context.taskId}`;\r\n  }\r\n\r\n  if (context.iteration) {\r\n    desc += `\\n**Iteration:** ${context.iteration}`;\r\n  }\r\n\r\n  if (context.mode) {\r\n    desc += `\\n**Mode:** ${context.mode}`;\r\n  }\r\n\r\n  if (context.priority) {\r\n    desc += `\\n**Priority:** ${context.priority}`;\r\n  }\r\n\r\n  if (context.parentTaskId) {\r\n    desc += `\\n**Parent Task:** ${context.parentTaskId}`;\r\n  }\r\n\r\n  return desc;\r\n}\r\n\r\n/**\r\n * Build environment context section\r\n */\r\nfunction buildEnvironmentContext(context: TaskContext): string {\r\n  const env: string[] = [];\r\n\r\n  if (context.taskId) env.push(`TASK_ID=${context.taskId}`);\r\n  if (context.iteration) env.push(`ITERATION=${context.iteration}`);\r\n  if (context.mode) env.push(`MODE=${context.mode}`);\r\n  if (context.priority) env.push(`PRIORITY=${context.priority}`);\r\n  if (context.parentTaskId) env.push(`PARENT_TASK_ID=${context.parentTaskId}`);\r\n\r\n  if (env.length === 0) return '';\r\n\r\n  return `\r\n## Environment Variables\r\n\r\n\\`\\`\\`bash\r\n${env.join('\\n')}\r\n\\`\\`\\`\r\n`;\r\n}\r\n\r\n/**\r\n * Build complete prompt for agent execution (async for iteration history)\r\n */\r\nexport async function buildAgentPrompt(\r\n  definition: AgentDefinition,\r\n  context: TaskContext\r\n): Promise<string> {\r\n  const agentId = `${definition.name}-${context.iteration || 1}`;\r\n\r\n  const sections: string[] = [];\r\n\r\n  // 1. Agent definition header\r\n  sections.push(`# Agent: ${definition.name}`);\r\n  sections.push('');\r\n  sections.push(definition.description);\r\n  sections.push('');\r\n\r\n  // 2. Task description\r\n  sections.push('## Task');\r\n  sections.push('');\r\n  sections.push(buildTaskDescription(definition.name, context));\r\n  sections.push('');\r\n\r\n  // 3. Iteration history (Sprint 3 - Phase 2)\r\n  // Load and format previous iterations if iteration > 1\r\n  if (context.taskId && context.iteration && context.iteration > 1) {\r\n    try {\r\n      const history = await loadIterationHistory(context.taskId, agentId, context.iteration);\r\n      const historyText = formatIterationHistory(history, context.iteration);\r\n      sections.push(historyText);\r\n      sections.push('');\r\n    } catch (err) {\r\n      console.warn(`[agent-prompt-builder] Failed to load iteration history:`, err);\r\n      // Continue without history\r\n    }\r\n  }\r\n\r\n  // 4. Agent definition content (from markdown file)\r\n  sections.push('## Agent Definition');\r\n  sections.push('');\r\n  sections.push(definition.content);\r\n  sections.push('');\r\n\r\n  // 5. CFN Loop protocol (if agent supports it AND task context includes taskId)\r\n  if (context.taskId && hasCFNLoopProtocol(definition)) {\r\n    sections.push(buildCFNLoopProtocol(context.taskId, agentId));\r\n    sections.push('');\r\n  }\r\n\r\n  // 6. Environment context\r\n  const envContext = buildEnvironmentContext(context);\r\n  if (envContext) {\r\n    sections.push(envContext);\r\n    sections.push('');\r\n  }\r\n\r\n  // 7. Execution instructions\r\n  sections.push('## Execution Instructions');\r\n  sections.push('');\r\n  sections.push('1. Read and understand the task requirements');\r\n  if (context.iteration && context.iteration > 1) {\r\n    sections.push('2. Review iteration history and feedback from validators');\r\n    sections.push('3. Address specific feedback points from previous iteration');\r\n    sections.push('4. Execute your core responsibilities as defined above');\r\n  } else {\r\n    sections.push('2. Execute your core responsibilities as defined above');\r\n    sections.push('3. Follow any protocol steps (CFN Loop, validation hooks, etc.)');\r\n  }\r\n  sections.push('4. Provide clear, concise output');\r\n  sections.push('5. Report confidence score if applicable');\r\n  sections.push('');\r\n\r\n  // 8. Tool reminder\r\n  if (definition.tools && definition.tools.length > 0) {\r\n    sections.push('## Available Tools');\r\n    sections.push('');\r\n    sections.push(`You have access to: ${definition.tools.join(', ')}`);\r\n    sections.push('');\r\n  }\r\n\r\n  return sections.join('\\n');\r\n}\r\n\r\n/**\r\n * Extract agent ID from context\r\n * If agentId is explicitly provided in context, use it; otherwise generate from name + iteration\r\n */\r\nexport function getAgentId(definition: AgentDefinition, context: TaskContext): string {\r\n  if (context.agentId) {\r\n    return context.agentId;\r\n  }\r\n  return `${definition.name}-${context.iteration || 1}`;\r\n}\r\n\r\n/**\r\n * Build system prompt for agent (optional, for structured agent behavior)\r\n */\r\nexport function buildSystemPrompt(definition: AgentDefinition): string {\r\n  return `You are ${definition.name}, a specialized AI agent.\r\n\r\nType: ${definition.type || 'specialist'}\r\nModel: ${definition.model}\r\nTools: ${definition.tools.join(', ')}\r\n\r\nFollow your agent definition exactly and complete assigned tasks with high quality.`;\r\n}\r\n"],"names":["hasCFNLoopProtocol","loadIterationHistory","formatIterationHistory","buildCFNLoopProtocol","taskId","agentId","includes","enrichJSONContext","jsonObj","sections","task","push","files","fileList","split","map","f","trim","filter","Array","isArray","length","forEach","file","requirements","reqs","req","i","deliverables","delivs","deliv","batch","directory","acceptanceCriteria","criteria","criterion","instructions","instrs","instr","join","buildTaskDescription","agentType","context","desc","contextStr","startsWith","endsWith","JSON","parse","e","iteration","mode","priority","parentTaskId","buildEnvironmentContext","env","buildAgentPrompt","definition","name","description","history","historyText","err","console","warn","content","envContext","tools","getAgentId","buildSystemPrompt","type","model"],"mappings":"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"}

package/dist/cli/agent-spawn.js

@@ -36,6 +36,9 @@
         const key = optionArgs[i];
         const value = optionArgs[i + 1];
         switch(key){
+            case '--agent-id':
+                options.agentId = value;
+                break;
             case '--task-id':
                 options.taskId = value;
                 break;
@@ -67,8 +70,9 @@
  * This is a wrapper/alias for the existing claude-flow-novice agent spawning mechanism
  * Provides the cfn-spawn naming pattern while delegating to the working implementation
  */ async function spawnAgent(options) {
-    const { agentType, taskId, iteration, context, mode, priority, parentTaskId } = options;
+    const { agentType, agentId, taskId, iteration, context, mode, priority, parentTaskId } = options;
     console.log(`[cfn-spawn] Spawning agent: ${agentType}`);
+    if (agentId) console.log(`[cfn-spawn]   Agent ID: ${agentId}`);
     if (taskId) console.log(`[cfn-spawn]   Task ID: ${taskId}`);
     if (iteration) console.log(`[cfn-spawn]   Iteration: ${iteration}`);
     if (context) console.log(`[cfn-spawn]   Context: ${context}`);
@@ -80,6 +84,9 @@
         agentType
     ];
     // Add optional parameters
+    if (agentId) {
+        claudeArgs.push('--agent-id', agentId);
+    }
     if (taskId) {
         claudeArgs.push('--task-id', taskId);
     }
@@ -207,6 +214,7 @@ Usage:
   cfn-spawn <type> [options]        (agent is implied)
 
 Options:
+  --agent-id <id>        Explicit agent identifier (overrides auto-generation)
   --task-id <id>         Task identifier
   --iteration <n>        Iteration number
   --context <text>       Context description
@@ -218,6 +226,7 @@ Examples:
   cfn-spawn agent researcher --task-id task-123 --iteration 1
   cfn-spawn coder --task-id auth-impl --context "Implement JWT auth"
   cfn-spawn reviewer --task-id auth-impl --iteration 2 --mode cli
+  cfn-spawn tester --agent-id tester-1-1 --task-id test-phase --iteration 1
     `);
         return;
     }