Function formatAllocation

scripts/agent-eval/parse-run.mjs:692–716

(s, indent = '  ')

/** The allocation block, as printed under a run and reused by aggregators. */
export function formatAllocation(s, indent = '  ') {
  const a = s.allocation;
  if (!a || !a.calls.length) return `${indent}Explore allocation: no codegraph_explore responses with source sections`;
  const pct = (f) => `${(f * 100).toFixed(1)}%`;
  const n = (x) => x.toLocaleString('en-US');
  const out = [
    `${indent}Explore allocation — share of returned bytes the answer used ` +
    `(${a.calls.length} call${a.calls.length === 1 ? '' : 's'}, ${a.filesReturned} file${a.filesReturned === 1 ? '' : 's'}):`,
    `${indent}  efficiency ${pct(a.efficiency).padStart(6)}  ${n(a.used)} of ${n(a.envelope)} chars` +
    `   (${a.filesUsed}/${a.filesReturned} files cited; path-cited alone ${pct(a.efficiencyPath)})`,
  ];
  if (!a.hasAnswer) out.push(`${indent}  !! no final answer text found — efficiency is not meaningful for this run`);
  for (const c of a.calls) {
    out.push(`${indent}  call ${c.call}: ${pct(c.efficiency).padStart(6)}  ${n(c.used)}/${n(c.envelope)} chars` +
      `  ${c.files.filter((f) => f.via).length}/${c.files.length} files`);
  }
  for (const f of a.files.slice(0, 12)) {
    const share = a.envelope ? f.chars / a.envelope : 0;
    const why = f.via === 'symbol' ? `symbol \`${f.symbol}\`` : f.via === 'path' ? 'path' : '—';
    out.push(`${indent}  ${f.via ? '*' : ' '} ${pct(share).padStart(6)} ${String(f.chars).padStart(6)}  ${f.path}  ${why}`);
  }
  if (a.files.length > 12) out.push(`${indent}    … ${a.files.length - 12} more files`);
  out.push(`${indent}  note: relative metric — attribution is by citation, so compare builds on the same question, not absolutes.`);
  return out.join('\n');
}

// ---------------------------------------------------------------------------
// Explore sufficiency (CG-8)