brain-of-reese/.agents/reports/03_story_chat_rag.a1.md at ad7585d4744525b6ec2676f827f1df44fa09a32f

Files

T

ducoterra dbf2af26c6 refactor(agents): migrate .agent/ planning tree to .agents/

Standardize on the .agents/ directory (shared with project skills):
phases/, user_stories/, reports/, screenshots/, validate.sh, and
phase-sessions/ + pipeline.log all move to .agents/ (git mv preserves
history; runtime artifacts move alongside).

Updates every reference in AGENTS.md, README.md, .gitignore, app
docstrings, and test story headers. Historical KB content in data/
and the runtime pipeline.log transcript are left untouched.

2026-09-05 10:57:07 -04:00

1.6 KiB

Raw Blame History

Phase 03 complete. Report:

Phase 03 — Story: Chat RAG Answer (happy path) — COMPLETE (396e4d4)

Implemented: app/rag/retriever.py (cosine top-k → parent-doc selection, dedupe, 20k-char cap w/ […truncated…]), app/rag/prompts.py (locked persona + HIGH/DEFLECT builders), LLMClient.chat_stream (+LLMError), POST /api/chat SSE (delta*→done, query_log row, PLAN §9 log line, error event mid-stream, 503 JSON if DB down), UI SSE reader w/ live streaming, source chips→/sources.html, role=alert error banner, always-recovers Send state.
Tests: unit (retriever/prompts/SSE/llm) + integration (real Postgres turn, log row, error/503 + mid-turn failure paths) + new Playwright story suite (grounded answer, query_log, raw SSE shape); smoke placeholder test replaced with the real never-stale contract.
uv run pytest --cov=app --cov-report=term-missing → 95 passed, TOTAL 98% (chat/llm/prompts/retriever 100%).
uv run pytest tests/e2e/test_chat_rag.py -v --no-cov (isolated) → 3 passed; test_smoke.py → 3 passed; test_import_documents.py (regression) → 3 passed.
uv run ruff check . → clean; uv run pyright → 0 errors.
Fixed defect (scaffold): .kb-banner display:flex overrode the hidden attribute → banner always visible; added [hidden]{display:none!important} + regression assertion. UI verified at 1280px/375px + XSS-escape proof.
Deviations: happy-path scope per phase file — LOW-threshold deflection/amber mode intentionally deferred to phase 04 (HIGH/DEFLECT builders + deflected plumbing ready).
Next pending: .agents/phases/todo/04_story_honest_deflection.md.

1.6 KiB Raw Blame History

1.6 KiB

Raw Blame History