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.
This commit is contained in:
2026-09-05 10:57:07 -04:00
parent 766702c750
commit dbf2af26c6
1118 changed files with 664 additions and 664 deletions
+11
View File
@@ -0,0 +1,11 @@
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`.