solution-erp/.claude/commands/sleep-recovery-memory-l2.md

description, argument-hint

description	argument-hint
Nén verbatim L2 cũ (agent-memory archive/<period>.md) thành gist ADDITIVE (.gist.md file MỚI, KHÔNG đè). CHỈ P1 gist-compress — KHÔNG build index. SCOPE = repo SOLUTION_ERP-only.	<agent | all> (vd — implementer-backend · reviewer · all)

/sleep-recovery-memory-l2 — Giấc ngủ L2 (sleep-compress, P1-only) · SE

Trigger nén L2 dark-matter. CHỈ xử lý .claude/agent-memory/<name>/archive/<period>.md (verbatim cũ) → sinh <period>.gist.md (FILE MỚI, additive). KHÔNG đụng L1 (MEMORY.md) · KHÔNG đụng RAG/L3 · KHÔNG build _INDEX.md (đó = P2 archival-event, không nằm trong command này). 🔴 Scope: CHỈ repo SOLUTION_ERP (self=se). KHÔNG đụng repo khác / corpus federated. 🔴 Phân-vai (Cách-B): lead = em-main single-writer (B3) · harvest-curator PROPOSE-ONLY (charter cấm-ghi → substring:"KHÔNG ghi/sửa BẤT KỲ file") · reviewer gate Fidelity (lead KHÔNG tự chấm, G-001).

📌 NOTE — provenance: Command này port từ AI_INFRA /sleep-recovery-memory-l2 (D:/Dropbox/CONG_VIEC/AI_INFRA/.claude/commands/sleep-recovery-memory-l2.md) + design (AI_INFRA repo — KHÔNG có bản SE-local) D:/Dropbox/CONG_VIEC/AI_INFRA/docs/architecture/MEMORY-SLEEP-RECOVERY-L2-DESIGN-v3.md §4 + §10-P1. Bản gốc gate §J2 = AI_INFRA-only (no-sister); ở đây anh yêu-cầu port để parity → scope tailor thành SE-repo-only (KHÔNG đụng sister/corpus khác). KHUNG federated giữ nguyên (function-floor), CHỈ tailor form theo SE (roster · path · 4-field tiếng Việt · pointer-style · gotcha#).

Tham số: $ARGUMENTS — 1 agent (vd implementer-backend) HOẶC all. Trống → hỏi anh chọn, KHÔNG mặc-định all.

📋 BƯỚC 0 — Show command body (visibility, no wait)

Em main PHẢI echo TOÀN BỘ nội dung command body này (đầy đủ Phase 0-5 + tất cả guard rule) trong response đầu tiên ĐỂ ANH USER ĐỌC LẠI.

Quy trình (KHÔNG wait confirm):

1. Em echo full content command (raw markdown, KHÔNG tóm tắt, KHÔNG cắt)
2. Em proceed execute Phase 0 → 5 sequential ngay
3. Anh user điều chỉnh cuối nếu cần (KHÔNG mid-flow interrupt)

🎯 Mục đích (function-floor)

Nén verbatim L2 cũ thành gist súc-tích mà KHÔNG mất signal-quan-trọng:

• ADDITIVE (B3/§F1/G-009): gist = ghi ra file MỚI archive/<period>.gist.md. KHÔNG đè <period>.md (verbatim) → verbatim ở-lại-đĩa (git history giữ nguyên). Đây là cách giải B3-data-loss: nén KHÔNG phá nguồn.
• Kết quả: 1 verbatim file dài + 1 gist file ngắn cùng kỳ. Lookup sâu vẫn Read verbatim; đọc nhanh đọc gist.
• 🔴 KHÔNG ép L1 nhỏ hơn 30KB (design BỎ — rotation L1→L2 là function per-project; L1-cap-audit của SE đã sống ở /session-start §2.1.2 + memory-budget.json, KHÔNG phải việc của command này).

👥 SE roster — target hợp-lệ

all = 9 sub có-ký-ức của SE: investigator-codebase · investigator-api · implementer-backend · implementer-frontend · test-specialist · reviewer · cicd-monitor · frontend-designer · database-agent.

🟡 harvest-curator + tooling-auditor = INFORM-only monitor (KHÔNG vào all mặc-định). CHỈ xử-lý nếu chúng thật-sự có archive/<period>.md verbatim (Phase 0.2 phát-hiện) — gọi tay đích-danh tên. ℹ️ Thực-tế hiện-tại (đo S71, memory-budget.json): chỉ 4/9 sub có archive-content — cicd-monitor · implementer-backend · investigator-codebase · reviewer. 5 sub còn-lại archive rỗng/chưa-có → all tự skip (Phase 0.2 guard-rỗng). Con-số này = báo-cáo runtime, KHÔNG hardcode: luôn quét đĩa thật.

Trigger (2 đường)

Đường	Cơ chế
Tay	Anh gõ /sleep-recovery-memory-l2 <agent|all> bất kỳ lúc nào
Auto-check (INFORM-only)	/session-start + /session-end đọc last_sleep_at trong .claude/agent-memory/memory-budget.json → nếu today − last_sleep_at ≥ 7 (ngày) → gợi-ý chạy command (INFORM anh, KHÔNG tự-chạy autonomous). Anh consent → chạy.

🔴 State-file last_sleep_at có 1 home DUY NHẤT: .claude/agent-memory/memory-budget.json (root-key last_sleep_at, cạnh tiers/measured). KHÔNG ghi ở _INDEX.md / nơi khác. (SE đặt budget-file trong agent-memory/, KHÁC AI_INFRA gốc đặt .claude/memory-budget.json — đây là tailor path SE.) Field last_sleep_at đã thêm (null baseline, S72) vào budget-file SE — auto-check đã wired ở /session-start §2.1.2 + /session-end §L.b(c) (đọc field → INFORM gợi-ý nếu null/≥7d). Lần sleep đầu lead set = today (Phase 4.4). Lead = single-writer field này (B3).

Phase 0 — Prep (em main / lead)

1. Parse $ARGUMENTS → list agent target. all → 9 sub có-ký-ức SE (xem roster ở trên). Agent lạ (không có dir .claude/agent-memory/<name>/) → cảnh-báo + skip. harvest-curator/tooling-auditor chỉ chạy nếu gọi tay đích-danh và có archive thật.
2. Mỗi agent: liệt-kê archive/<period>.md (verbatim) đủ cũ (per-project aging, size-driven — KHÔNG federated-time). Guard-rỗng: agent KHÔNG có archive/ hoặc 0 file <period>.md → skip (0 token). Bỏ qua file nào ĐÃ có <period>.gist.md tương-ứng (tránh nén lại).
3. 🛡️ double-distill guard (đọc header TRƯỚC khi làm): nếu gist nguồn/đối-tượng đã chứa counter distill-gen: N với N ≥ 1 → đã là sản-phẩm distill → REFUSE pass-2 tự-động (skip, log lý-do). Chỉ nén nguồn verbatim gen-0 (file <period>.md chưa-từng-distill). (SE thực-tế: có gist đã ở distill-gen: 2 — investigator-codebase 2026-06 — guard PHẢI bắt; KHÔNG nén .gist.md, chỉ nén .md verbatim.)
4. Đọc .claude/agent-memory/memory-budget.json lấy last_sleep_at (xác-nhận đủ 7-ngày nếu đường auto). Field vắng → coi như "chưa từng sleep" (đường tay vẫn chạy bình-thường).

Phase 1 — GATHER + DEDUP (harvest-curator PROPOSE-ONLY)

harvest-curator charter cấm-ghi-file → output = proposal MD (text trả-về), KHÔNG Write.

Spawn harvest-curator đọc từng verbatim file target → đề-xuất bản nén nháp:

• Gom entry trùng/liên-quan (dedup spawn-record cùng-chủ-đề across nhiều ngày/session).
• Đánh importance-tag mỗi cụm: {cao · vừa · thấp} (khớp nhãn giá-trị-tái-dùng SE đang dùng trong gist hiện-có).
• Trả proposal (KHÔNG ghi đĩa). Lead nhận → Phase 2 distill + verify.

Phase 2 — DISTILL (method)

Lead distill proposal thành gist theo 4 bước:

1. 4-field giữ-khung (SE): mỗi entry gốc = spawn-record VIỆC · KẾT-LUẬN(+commit/file:line) · BÀI-HỌC · BẤT-NGỜ. Nén = rút-gọn câu-chữ, KHÔNG bỏ field. (Đây là form SE — tương-đương task · verdict · learned · surprise bản gốc.)
2. GỘP: cụm entry cùng-chủ-đề → 1 entry tổng-hợp (cite ngày/session gốc + pointer back-resolve vào verbatim).
3. reflection-synthesis: rút 3 tới 5 entry mỗi file (meta-insight cấp cao hơn liệt-kê thô), KHÔNG vượt 5.
4. importance-tag drop: drop thấp TRƯỚC khi cần cắt độ-dài. cao/vừa giữ. ratio nén = báo-cáo KHÔNG phải target (KHÔNG cắt để đạt con-số).

🔴 Pointer-style SE (khớp gist hiện-có): mỗi dòng kết bằng back-resolve → substring:"<unique>" grep-UNIQUE vào verbatim file đã-tên — git-SHA / Mig-name / Run#NNN / unique-phrase keyed (ngày bị collide). NO line-hint (additive append làm xê dòng).

🔴 Header gist file BẮT BUỘC có counter distill-gen: 1 (sản-phẩm distill thế-hệ-1 → chặn pass-2 sau này per Phase 0.3) + ghi rõ source-verbatim (tên file + #record) + pointer-style: substring. (Nếu hiếm-hoi distill từ gist gen-1 — chỉ khi anh ép tay đè guard — stamp distill-gen: 2.)

Phase 3 — GATE (coverage-diff DETERMINISTIC + Fidelity)

Gate = chốt-chặn mất-signal. 2 lớp.

(a) coverage-diff DETERMINISTIC (lead scan, rẻ, LUÔN chạy):

• Mọi {surprise · guard · file:line · root-cause · gotcha#} xuất-hiện trong verbatim PHẢI xuất-hiện (hoặc đánh N/A có-chủ-đích) trong gist. (SE thêm gotcha# so với 4-token gốc — khớp rule memory-budget.json l2_gist: "every surprise/guard/file:line/root-cause/gotcha# in verbatim must survive".)
• Cơ-chế: grep các loại token trên ↔ đối-chiếu gist (Grep tool). Thiếu bất-kỳ → FAIL → bổ vào gist TRƯỚC khi tiếp.
• ratio nén = báo-cáo (đo để biết), KHÔNG phải target/floor — KHÔNG ép gist nhỏ-đi để đạt ratio đẹp.

(b) Fidelity gate (reviewer escalate):

• harvest-curator Fidelity-FLAG → escalate reviewer chấm keep-vs-drop (entry nào nén/drop có đúng không, gist có bịa / lệch nghĩa không).
• Lead KHÔNG tự chấm Fidelity (G-001). reviewer PASS → ghi. FAIL → re-distill đúng sự-thật. (reviewer no-StructuredOutput / chết ×2 → self-gate-fallback bằng evidence-checklist hợp-lệ, ghi rõ trong report — feedback agent-kill-recovery.)

Phase 4 — WRITE (lead single-writer, B3)

1. Tool-ghi: Write (file mới) / Edit — 🔴 G-009: KHÔNG PowerShell Add-Content / bash here-string. UTF-8 no-BOM.
2. Ghi archive/<period>.gist.md (file MỚI). KHÔNG chạm <period>.md verbatim (additive).
3. G-009 post-scan (BẮT BUỘC sau ghi): Grep mojibake (§ · â† · ðŸ · KHÃ — seq cụ-thể, né bare-Ã) + dollar-expansion (/usr/bin/bash) trên file vừa ghi → phải sạch. Bẩn → de-corrupt qua Write tool.
4. Cập-nhật .claude/agent-memory/memory-budget.json field last_sleep_at = <today> (root-key; thêm mới nếu chưa có). B3 single-writer, Write/Edit. 🔴 KHÔNG hand-edit measured_bytes (chỉ script scripts/measure-agent-memory.ps1 được sửa số đo) — chỉ chạm last_sleep_at.

Phase 5 — REPORT + COMMIT

1. Report: mỗi agent xử-lý → {verbatim-file · gist-file MỚI · #entry trước→sau · ratio (báo-cáo) · importance-drop thấp=N · coverage-diff PASS/FAIL · Fidelity PASS/self-gate}.
2. Commit (anh OK): [CLAUDE] Memory: sleep-compress L2 <agent> — <period>.gist.md additive
   • Scope = Memory. 🔴 git add file cụ-thể (KHÔNG -A/. — secret-leak risk; feedback rag-mcp).
   • verbatim KHÔNG đổi → KHÔNG trong diff (chỉ .gist.md mới + memory-budget.json last_sleep_at).
   • 🔴 docs-only path → CI skip (paths-ignore, gotcha #41) — commit này 0s.

---

⚠️ Guards (đọc kỹ)

• 🔴 Additive-only: gist = file MỚI. TUYỆT-ĐỐI KHÔNG đè/sửa/xóa verbatim <period>.md (B3 · §F1 · G-009 data-loss).
• 🔴 CHỈ P1 gist-compress: command này KHÔNG build _INDEX.md (= P2 archival-event riêng, sub tự-ghi lúc rời L1→L2) · KHÔNG inject read-side · KHÔNG đụng L1/RAG/L3.
• 🔴 double-distill refuse: distill-gen ≥ 1 ở đối-tượng → skip (Phase 0.3). Gist mới luôn stamp distill-gen: 1. Chỉ nén verbatim <period>.md gen-0 (KHÔNG nén .gist.md).
• 🔴 coverage-diff = deterministic gate: surprise/guard/file:line/root-cause/gotcha# thiếu → FAIL, KHÔNG ship. ratio = metric KHÔNG target.
• 🔴 Phân-vai cứng (Cách-B): lead Write+commit (B3 single-writer) · harvest-curator PROPOSE-ONLY (charter cấm-ghi) · reviewer gate Fidelity (G-001 lead-không-tự-chấm).
• 🔴 KHÔNG ép L1 < 30KB (design BỎ — không phải scope command này; L1-cap-audit sống ở /session-start §2.1.2).
• 🔴 Scope SE-repo-only: CHỈ agent-memory .claude/agent-memory/** của SOLUTION_ERP. KHÔNG đụng repo/corpus khác (port-từ §J2-AI_INFRA, tailor parity — xem NOTE đầu file).
• 🔴 G-009 tool-ghi: Write/Edit only + post-scan mojibake/dollar-exp.
• 🔴 last_sleep_at single home: chỉ .claude/agent-memory/memory-budget.json root-key — KHÔNG nơi khác.