phase: 106_document_dates

Everything is verified green. Final report:

**Phase 106 — Document dates (final verification pass; all 10 tasks already complete)**

- Verified all phase artifacts: alembic `0020` (dev DB at `0020`), `doc_dates.py`, git `file_commit_dates`, importer `doc_dates_by_root`/`dates_updated`, both entry-point wirings, date APIs + tree `created_at`/`updated_at`, LLM surfaces (prompt block, `read` line 2, appended `ls` field), `apply_recency_boost` in `retrieve()`, UI columns/badge, admin editor, mock-LLM regex — all present and correct; no defects found, no fixes needed.
- `uv run pytest --cov=app --cov-report=term-missing` → **2299 passed, TOTAL 99%** (>90% ✓)
- `uv run pytest tests/e2e/test_document_dates.py -v --no-cov` → **6/6 passed** in isolation (DB up)
- 12 regression E2E suites (retrieval_quality, whole_document_context, agent_document_tools, ls_tree_drilldown, read_truncation_cap, kb_tree, kb_tree_nav, document_viewer, edit_summaries, import_documents, sync_button, hidden_folders_toggle, smoke) → **all green in isolation**
- `uv run ruff check .` → clean; `uv run pyright` → **0 errors, 0 warnings**

**Completion criteria:** 1) non-null `created_at` + 0020 upgrade/downgrade on dev DB ✓ (real-Alembic integration tests) 2) sync refresh/older/manual-persists/content-reset/no sources_meta bump ✓ 3) zip/tar mtime + future→today ✓ 4) LLM date surfaces + cross-check ✓ 5) UI Created/Updated/badge positions ✓ 6) admin editor set+revert round-trip ✓ 7) old-correct-beats-new-similar (defaults & boost-off) + near-tie + `BOR_RECENCY_BOOST=0` byte-identical ✓ 8) full gate ✓ 9) commit/phase-move — left to harness per instructions.

- **Notable:** recency default tuned 0.001 → **0.0007** (task 07 step 5 explicitly permits; measured margins recorded in `test_recency_boost.py` docstring).
- **Next pending phase:** none — `todo/` holds only this phase.

tests/e2e/test_tool_path_teaching.py

@@ -99,9 +99,12 @@ DOC2_TITLE = "Example Record File"
 DOC2_SP = f"{SEED_SOURCE}/{DOC2_PATH}"
 
 #: The FIRST catalog line (catalog order = (source, path) — DOC1 sorts
-#: first): the mock's LS-TEACH answer quotes exactly this line.
+#: first): the mock's LS-TEACH answer quotes exactly this line. Phase
+#: 106 (D5): the FILE line's appended `` | date: …`` field rides along
+#: (the fixture's fixed ``created_at`` UTC date part).
 FIRST_CATALOG_LINE = (
-    f"source: {SEED_SOURCE} | path: {DOC1_PATH} | title: {DOC1_TITLE}"
+    f"source: {SEED_SOURCE} | path: {DOC1_PATH} | title: {DOC1_TITLE} "
+    "| date: 2024-06-15"
 )
 
 #: The catalog-first document (catalog order = (source, path) —
@@ -126,7 +129,7 @@ DOC1_CONTENT = (
     "A cron job pushes reeselink.json to the aws route53 hosted zone "
     "every fifteen minutes; the diff is applied through the route53 api.\n"
 )
-assert "\n" not in DOC1_CONTENT[:80]  # the quote must stay one line
+assert "\n" not in DOC1_CONTENT[:63]  # the quote's content part stays one line
 
 #: The retrievable document (the grounded seed context, the cf.
 #: test_harness_aligned_tools.py pattern): the repeated record-file
@@ -205,8 +208,13 @@ for _other in (
 #: The mock's single-read answer (the read document reached the model
 #: and landed in the answer) — DOC1 is the first catalog line, so the
 #: flow reads ``Homelab/aws-route53.md`` and quotes its first 80 chars.
+#: Phase 106 (D5): the read result's ``date:`` SECOND line rides into
+#: the first-80-chars quote — the date line (the fixture's fixed
+#: ``created_at`` UTC date part, 17 chars; its trailing newline renders
+#: as a markdown soft break — no text between the date and the content)
+#: + the first 63 content chars (80 − 17).
 READ_ANSWER_PREFIX = f"Read {DOC1_SP}."
-READ_ANSWER_QUOTE = DOC1_CONTENT[:80]
+READ_ANSWER_QUOTE = "date: 2024-06-15" + DOC1_CONTENT[:63]
 
 
 def _seed_fixture(db: Session) -> None:
@@ -225,6 +233,8 @@ def _seed_fixture(db: Session) -> None:
     fallback — deterministic.
     """
     db.add(GitSource(url=SEED_SOURCE, kind="local"))
+    # Phase 106 (D5): explicit dates — byte-stable prompts/quotes (the
+    # ls file line and the mock's read quote carry the date).
     db.add(
         Document(
             source=SEED_SOURCE,
@@ -234,6 +244,7 @@ def _seed_fixture(db: Session) -> None:
             content=DOC1_CONTENT,
             content_hash=hashlib.sha256(DOC1_CONTENT.encode()).hexdigest(),
             indexed_at=datetime.now(UTC),
+            created_at=datetime(2024, 6, 15, tzinfo=UTC),
         )
     )
     doc2 = Document(
@@ -244,6 +255,7 @@ def _seed_fixture(db: Session) -> None:
         content=DOC2_CONTENT,
         content_hash=hashlib.sha256(DOC2_CONTENT.encode()).hexdigest(),
         indexed_at=datetime.now(UTC),
+        created_at=datetime(2024, 6, 15, tzinfo=UTC),
     )
     db.add(doc2)
     db.flush()