Function formatContextAsMarkdown

src/context/formatter.ts:18–90

(context: TaskContext)

 * - Code blocks only for key symbols
 */
export function formatContextAsMarkdown(context: TaskContext): string {
  const lines: string[] = [];

  // Header with query
  lines.push('## Code Context\n');
  lines.push(`**Query:** ${context.query}\n`);

  // Entry points - compact format. Re-sort so generated files (.pb.go,
  // .pulsar.go, mocks, …) rank LAST — a flow query should lead with the
  // hand-written implementation, not protobuf scaffolding.
  const orderedEntries = [...context.entryPoints].sort((a, b) => {
    const aGen = isGeneratedFile(a.filePath) ? 1 : 0;
    const bGen = isGeneratedFile(b.filePath) ? 1 : 0;
    return aGen - bGen;
  });
  if (orderedEntries.length > 0) {
    lines.push('### Entry Points\n');
    for (const node of orderedEntries) {
      const location = node.startLine ? `:${node.startLine}` : '';
      lines.push(`- **${node.name}** (${node.kind}) - ${node.filePath}${location}`);
      if (node.signature) {
        lines.push(`  \`${node.signature}\``);
      }
    }
    lines.push('');
  }

  // Related symbols - compact list (skip verbose structure tree). Drop nodes
  // in generated source files (`.pb.go` / `.pulsar.go` / mocks / …) — agents
  // chasing a flow never want to land on protobuf scaffolding (cosmos-Q3 used
  // to list `gov.pulsar.go::GetExpeditedThreshold` and `1.pulsar.go::Get` in
  // Related Symbols, pure noise that displaced real-flow entries).
  const otherSymbols = Array.from(context.subgraph.nodes.values())
    .filter(n => !context.entryPoints.some(e => e.id === n.id))
    .filter(n => !isGeneratedFile(n.filePath))
    .slice(0, 10); // Limit to 10 related symbols

  if (otherSymbols.length > 0) {
    lines.push('### Related Symbols\n');
    const byFile = new Map<string, Node[]>();
    for (const node of otherSymbols) {
      const existing = byFile.get(node.filePath) || [];
      existing.push(node);
      byFile.set(node.filePath, existing);
    }

    for (const [file, nodes] of byFile) {
      const nodeList = nodes.map(n => `${n.name}:${n.startLine}`).join(', ');
      lines.push(`- ${file}: ${nodeList}`);
    }
    lines.push('');
  }

  // Code blocks - only for key entry points. Re-sort so non-generated blocks
  // show first (consistent with Entry Points reordering above).
  if (context.codeBlocks.length > 0) {
    const orderedBlocks = [...context.codeBlocks].sort((a, b) => {
      const aGen = isGeneratedFile(a.filePath) ? 1 : 0;