tao-context-mode

The build/expand pattern: callers consume the compact CodebaseIndex (path + summary + symbols) as their working context, and only expand() files actually needed for the current task.

When to trigger

• TAO session starts and the planner needs codebase awareness without flooding the model context window.
• A new tao-loop iteration is about to start and the autoresearch lens flags rising tokens/turn.
• An agent is asked "where does X live?" and needs a low-cost lookup before reading.

Public API

from app.server.tao_context_mode import build_index, expand, stats

index = build_index(Path("/repo"))
content = expand(index, "app/server/main.py")
print(stats(index))   # files_indexed, bytes_indexed, expansions, hit_rate