Function buildDirectoryTree

src/context/tree.ts:102–128

(
  rootDir: string,
  options: TreeOptions = {},
)

}

export async function buildDirectoryTree(
  rootDir: string,
  options: TreeOptions = {},
): Promise<string> {
  const ctx: TreeContext = {
    maxDepth: options.maxDepth ?? 3,
    maxEntries: options.maxEntries ?? 200,
    maxBytes: options.maxBytes ?? 4000,
    relevantFolders: inferRelevantFolders(options.userPromptHint),
    hasWeighting: false,
    entryCount: 0,
    byteCount: 0,
    truncated: false,
    lines: [path.basename(rootDir) + '/'],
  };
  ctx.hasWeighting = ctx.relevantFolders.size > 0;
  ctx.byteCount = ctx.lines[0]!.length;

  await walk(rootDir, 1, '', ctx);

  if (ctx.hasWeighting) {
    ctx.lines.push('');
    ctx.lines.push(`(tree weighted for query: kept ${[...ctx.relevantFolders].slice(0, 6).join('/')}; other folders summarised)`);
  }

  return ctx.lines.join('\n');
}

/** Whether a directory should be EXPANDED (deep walk) vs SUMMARISED (one-line count). */
function shouldExpandDir(name: string, ctx: TreeContext): boolean {