phase: 94_ls_tree_drilldown

All green. Verification complete.

**Phase 94 — `ls` drill-down tree: final verification pass (all 5 tasks were already complete; verified, nothing to fix)**

- Verified `ls` 3-level tree (`app/rag/agent.py`): `ls()` sources + summaries, `ls(source)`/`ls(source/folder)` drill-down, 50-line file cap + grep-pointer note, NOT-A-FOLDER teaching refusal
- Verified `folder_summaries` (migration 0017, model, `app/rag/folder_summaries.py` generator: `FOLDER_SUMMARY_MODE` marker, fail-soft per folder, ≥2-doc scope + prune) wired change-gated in both sync paths
- Verified 10-turn fixture battery verdict recorded in `TOOL_CALLING_TESTING.md` §9 (2026-09-11): turbo PASS 19/19 contract, 98.7 s (−12.5…−13.2 % vs baseline); lite PASS 18/18, 43.6 s (+7.7 %) — accuracy at/above baseline, gate met
- `uv run pytest --cov=app --cov-report=term-missing` → 1939 passed, 0 failed; TOTAL coverage **99 %** (folder_summaries.py 100 %)
- `uv run ruff check .` → clean; `uv run pyright` → 0 errors, 0 warnings
- E2E in isolation: `test_ls_tree_drilldown.py` 3 passed; `test_agent_document_tools` 4, `test_agent_unlimited_tools` 4, `test_harness_aligned_tools` 3, `test_search_tool` 3, `test_grep_regex_teaching` 2, `test_response_to_docs` 4 — all passed (read/grep contracts untouched)
- Dedicated folder-summary tests (fail-soft, prune, both sync paths, migration): 46 passed
- Completion criteria: all 6 met; working tree holds only phase-94 changes (commit left to harness per protocol)

**Next pending phase:** `95_read_truncation_cap`

tests/integration/test_import_docs_git.py

@@ -104,6 +104,21 @@ def _stub_bump(monkeypatch: pytest.MonkeyPatch) -> list[None]:
     return bumps
 
 
+def _stub_folder_summaries(monkeypatch: pytest.MonkeyPatch) -> list[dict]:
+    """Stub the phase-94 folder-summary regeneration (this file keeps
+    its no-real-DB / no-network style — the real generator would read
+    the global ``documents`` table and burn ``lite`` calls). Returns
+    the call record; the canned stats are the zero dict."""
+    calls: list[dict] = []
+
+    async def fake_generate(db: object, llm: object, *, skip: bool = False) -> dict[str, int]:
+        calls.append({"skip": skip})
+        return {"generated": 0, "failed": 0, "pruned": 0}
+
+    monkeypatch.setattr(import_docs, "generate_folder_summaries", fake_generate)
+    return calls
+
+
 # --- repo_name -------------------------------------------------------------
 
 
@@ -293,6 +308,7 @@ def test_main_rows_branch_passes_ignore_map_to_import(
     fake_import = FakeImportSources()
     monkeypatch.setattr(import_docs, "import_sources", fake_import)
     _stub_bump(monkeypatch)
+    _stub_folder_summaries(monkeypatch)
 
     rc = import_docs.main([])
 
@@ -329,6 +345,7 @@ def test_main_git_sources_clone_then_import(
     fake_import = FakeImportSources()
     monkeypatch.setattr(import_docs, "import_sources", fake_import)
     bumps = _stub_bump(monkeypatch)
+    _stub_folder_summaries(monkeypatch)
 
     rc = import_docs.main([])
 
@@ -371,6 +388,7 @@ def test_main_cli_source_still_imports_manual_dir(
     fake_import = FakeImportSources()
     monkeypatch.setattr(import_docs, "import_sources", fake_import)
     bumps = _stub_bump(monkeypatch)
+    _stub_folder_summaries(monkeypatch)
 
     rc = import_docs.main(["--source", str(manual)])