solution-erp/docs/HANDOFF.md

HANDOFF — Brief 5 phút cho session tiếp theo

Tiering rule (S40): giữ 2-3 session gần nhất. Cũ hơn → docs/changelog/sessions/. Full brief history pre-S40 → docs/_archive/HANDOFF-preS40-fullhistory.md.

Last updated: 2026-05-29 (Session 41 — RAG corpus cleanup w/ AI_INFRA: exclude **/-fix + re-bootstrap 3080→2406 + 5/5 store_memory preserved)

---

S41 (2026-05-29) — RAG corpus cleanup (w/ AI_INFRA)

3 commit 282cbd0 + e8cbbe5 + (this STATUS/HANDOFF) — all docs/infra → CI skip. KHÔNG product code/schema.

Done:

• ✅ Exclude fix .claude/rag.json root-anchored → **/-anchored (gotcha #10: node_modules/**+docs/_archive/** không match nested path → 237 node_modules + 22 _archive junk chunks ẩn trong corpus). AI_INFRA cũng fix find_files dir-aware host-side (eb9634e).
• ✅ store_memory reconcile 5/5 trước re-bootstrap (anti-data-loss). Unified at-risk rule: content phải reproducible từ file {exists ∧ matches corpus glob ∧ not excluded} — "file exists" CHƯA đủ (NAMGROUP mất 2 chunk vì .tsx ngoài glob). 3 broadcasts disk-twinned + 16a6b6db twin-safe + 0307141b S37-S40 catch-up promote-to-disk (anchor #s37-s40-catchup là virtual label, KHÔNG phải section thật trong STATUS.md đã tier).
• ✅ AI_INFRA re-bootstrap host-side --config: 3080→2406 (−674 junk). Verify Qdrant: node_modules=0 · _archive=0 · manual-marker=0 · user-memory 60 chunks/10 files (slug fix D--Dropbox-CONG-VIEC-SOLUTION→-SOLUTION-ERP) · catch-up 6 + audit-response 6.
• ✅ SE post-verify PASS in-session: list_projects=2406 live; promoted catch-up returns file-indexed (real heading, not (manual)) → twin-safety proven zero-loss.

⚠️ CLI restart (fresh) requested by AI_INFRA cho tag-persist (corpus đã serve live in-session).

⏳ Standing infra backlog (AI_INFRA, non-blocking): bootstrap glob→0 warn · auto_reindex hook fire · search_code corpus gap (src/.cs+fe/.tsx — v0 design call) · registry sync.

⚠️ Concurrency carry-over (vẫn nguyên — chưa đụng): M docs/governance/BROADCAST-OUT-...-2026-05-29.md (session SE thứ 2) + ?? .mcp.json untracked. Anh main quyết.

Next S42 (anh main pick) — FOCUS PRODUCT: (1) Phase 11 P11-A wire ApproveV2 + LevelOpinions 4 module · (2) Test gaps (Gap1 Holiday UNIQUE CRITICAL + Gap3 gotcha #44) · (3) Phase 9 Ops (SMTP + rotate creds + UAT) · (4) coord concurrency carry-over.

---

S40 (2026-05-29) — Init + consolidation + bulletin adoption + RAG recovery

10 commit d2f52ba..37536fd (all docs/infra → CI skip). KHÔNG product code/schema.

Done:

• ✅ Init audit 10-mục — 7-agent live, RAG re-rank PASS, 130 test confirm, state re-grounded từ code.
• ✅ Doc consolidation — STATUS 170KB→5.7KB + HANDOFF 224KB→3.4KB (393KB→9KB, full archive docs/_archive/ zero-loss). Count re-ground: endpoints 211, FE pages 65 (36+29), menu ~53, tables 84 đúng (DbSet 77 + Identity 7). CLAUDE.md root patch.
• ✅ Curate 4 agent MEMORY >25KB→<8.4KB (foundation preserved + git verbatim d2f52ba).
• ✅ AI_INFRA bulletin 2026-05-29 adopt 4/4: MỤC1 charter v2 ack · MỤC2 Tiered Memory Policy v1 (L1 HOT ~30KB / L2 archive / L3 RAG, bỏ hard 25KB) · MỤC3 /session-start + /session-end slash command LIVE · MỤC4 RAG v1.3 compliant + rag.json extra_corpus slug BUG FIX.
• ✅ Broadcast AI_INFRA (adoption + infra retrospective + 5 đề xuất) — file docs/governance/BROADCAST-OUT-* + RAG store_memory (rerank 0.91-0.96 cross-project discoverable).

⚙️ NEW slash command LIVE: /session-start + /session-end (.claude/commands/) — dùng thay paste prompt thủ công.

⚠️ RAG MCP outage S40: máy treo full ổ C → MCP rớt nhiều lần. Recovery: quit hẳn + relaunch FRESH + approve trust .mcp.json (KHÔNG resume — cached config). server.py/env/key/Qdrant verified healthy (lỗi thuần Claude Code client). Memory [[rag-mcp-recovery-and-concurrency]].

⚠️⚠️ CONCURRENCY CHƯA giải quyết: session SE thứ 2 chạy song song S40 → append "BROADCAST 2" vào docs/governance/BROADCAST-OUT-SOLUTION-ERP-2026-05-29.md (UNCOMMITTED, M trong git) + .mcp.json untracked. Anh main quyết: commit chung / để session kia tự / gộp dup. TRÁNH 2 session SE cùng sửa repo.

⏳ Standing items đã broadcast cho AI_INFRA (infra op): re-index SE (path fix → 27 memory entries + S38-S40 content) · registry sync · verify auto_reindex hook (last_indexed lag) · search_code corpus gap (chỉ index .md, thiếu src/.cs + fe/.tsx) · chunk 512 trial 2026-06-16.

Next S41 (anh main pick) — FOCUS PRODUCT:

1. Phase 11 P11-A — wire ApproveV2 + LevelOpinions 4 module (full 5-agent end-to-end)
2. Test coverage gaps — 🟪 test-specialist Gap1 (Holiday UNIQUE CRITICAL) + Gap3 (gotcha #44 ~50 LOC)
3. Phase 9 Ops (anh main coordinate: SMTP + rotate creds + UAT)
4. (coord) Giải quyết concurrency: BROADCAST 2 uncommitted + .mcp.json untracked

---

S39 (2026-05-29) — ⚙️ INFRA: Opus 4.8 1M + Multi-agent 4→7 + budget +50%

Pure infra/governance, 1 commit fd0554a (docs CI skip). 7 agent: 🟦 investigator-codebase (internal SQL/EF/grep) + 🟦 investigator-api (external docs/CVE/lib) + 🟨 implementer-backend (.NET) + 🟧 implementer-frontend (FE 2 app) + 🟪 test-specialist (tests/) + 🟥 reviewer + 🟩 cicd-monitor. model: inherit (Opus 4.8 1M). 5 RAG MCP/agent. Skill re-distribute (README matrix). 2 gotcha NEW: #54 (529 Overload spawn fail → em main solo fallback) + #55 (truncation mid-exploration → brief ≤8K + pre-supply snippet). → detail docs/changelog/sessions/2026-05-29-S36-S39-phase10-complete-7agent.md

S38 (2026-05-28) — 🎊 PHASE 10 COMPLETE 11/11

Mig 39+40 + BE ~1100 LOC mega + FE 5 file × 2 app SHA256 IDENTICAL + 8 menu. Run #247 PASS 3m25s. G-O4 Đơn từ + G-O5 Đặt xe + G-O6 Ticket CNTT + G-P1 Chấm công + G-H3 Dashboard NS (SKELETON combo). Trade-off rõ commit: ApproveV2 advance level + LevelOpinions + LeaveBalance + CodeGen atomic + Vehicle/Driver catalog + auto-assign/SLA DEFER Phase 11. NEW prod: sidebar Văn phòng số 11 sub-menu + Nhân sự Dashboard + GPS check-in + ticket kanban. → same session log

---

Older S37→S6: per-session logs đầy đủ trong docs/changelog/sessions/ + docs/_archive/HANDOFF-preS40-fullhistory.md.