feat(aggregation): Implement tier-level aggregation strategy tied to Personas

src/aggregate.py

@@ -197,15 +197,20 @@ def _build_files_section_from_items(file_items: list[dict[str, Any]]) -> str:
   sections.append(f"### `{original}`\n\n```{lang}\n{content}\n```")
  return "\n\n---\n\n".join(sections)
 
-def build_markdown_from_items(file_items: list[dict[str, Any]], screenshot_base_dir: Path, screenshots: list[str], history: list[str], summary_only: bool = False) -> str:
+def build_markdown_from_items(file_items: list[dict[str, Any]], screenshot_base_dir: Path, screenshots: list[str], history: list[str], summary_only: bool = False, aggregation_strategy: str = "auto") -> str:
  """Build markdown from pre-read file items instead of re-reading from disk."""
  parts = []
  # STATIC PREFIX: Files and Screenshots must go first to maximize Cache Hits
  if file_items:
-  if summary_only:
+  if aggregation_strategy == "summarize":
    parts.append("## Files (Summary)\n\n" + summarize.build_summary_markdown(file_items))
-  else:
+  elif aggregation_strategy == "full":
    parts.append("## Files\n\n" + _build_files_section_from_items(file_items))
+  else: # auto
+   if summary_only:
+    parts.append("## Files (Summary)\n\n" + summarize.build_summary_markdown(file_items))
+   else:
+    parts.append("## Files\n\n" + _build_files_section_from_items(file_items))
  if screenshots:
   parts.append("## Screenshots\n\n" + build_screenshots_section(screenshot_base_dir, screenshots))
   # DYNAMIC SUFFIX: History changes every turn, must go last
@@ -213,9 +218,9 @@ def build_markdown_from_items(file_items: list[dict[str, Any]], screenshot_base_
   parts.append("## Discussion History\n\n" + build_discussion_section(history))
  return "\n\n---\n\n".join(parts)
 
-def build_markdown_no_history(file_items: list[dict[str, Any]], screenshot_base_dir: Path, screenshots: list[str], summary_only: bool = False) -> str:
+def build_markdown_no_history(file_items: list[dict[str, Any]], screenshot_base_dir: Path, screenshots: list[str], summary_only: bool = False, aggregation_strategy: str = "auto") -> str:
  """Build markdown with only files + screenshots (no history). Used for stable caching."""
- return build_markdown_from_items(file_items, screenshot_base_dir, screenshots, history=[], summary_only=summary_only)
+ return build_markdown_from_items(file_items, screenshot_base_dir, screenshots, history=[], summary_only=summary_only, aggregation_strategy=aggregation_strategy)
 
 def build_discussion_text(history: list[str]) -> str:
  """Build just the discussion history section text. Returns empty string if no history."""
@@ -319,7 +324,7 @@ def build_markdown(base_dir: Path, files: list[str | dict[str, Any]], screenshot
   parts.append("## Discussion History\n\n" + build_discussion_section(history))
  return "\n\n---\n\n".join(parts)
 
-def run(config: dict[str, Any]) -> tuple[str, Path, list[dict[str, Any]]]:
+def run(config: dict[str, Any], aggregation_strategy: str = "auto") -> tuple[str, Path, list[dict[str, Any]]]:
  namespace = config.get("project", {}).get("name")
  if not namespace:
   namespace = config.get("output", {}).get("namespace", "project")
@@ -336,7 +341,7 @@ def run(config: dict[str, Any]) -> tuple[str, Path, list[dict[str, Any]]]:
  file_items = build_file_items(base_dir, files)
  summary_only = config.get("project", {}).get("summary_only", False)
  markdown = build_markdown_from_items(file_items, screenshot_base_dir, screenshots, history,
-  summary_only=summary_only)
+  summary_only=summary_only, aggregation_strategy=aggregation_strategy)
  output_file.write_text(markdown, encoding="utf-8")
  return markdown, output_file, file_items