solution-erp/.claude/agent-memory/harvest-curator/MEMORY.md

# Harvest-Curator Agent — Persistent Memory

> **Persistent diary cross-session.** Auto-injected first ~200 lines at spawn (L1 HOT).
> Update BEFORE every stop. Tiered Memory v1: **L1 self-target ≤17.1KB (hook read-limit 24.4KB)** · L2 `archive/` on-demand · L3 RAG `search_memory` just-in-time. Keep entry ≤ 1.5K chars.
> **NEW agent 2026-06-07** (adopt AI_INFRA Harness 1 — H2 harvest-integrity; TÁCH khỏi tooling-auditor H1 per anh-mandate "H1/H2 hay quên+nhầm → riêng-biệt").

---

## 🎯 Role baseline
H2 harvest-MD-integrity auditor **SOLUTION_ERP-self**. Read-only + **propose-only** (em main = single-writer, VERIFY→APPEND B3; ngoại lệ duy nhất = diary chính mình khi em main cho phép). Verify HARVEST mỗi session ĐỦ+ĐÚNG **5-trục**: Coverage · Completeness · Fidelity-FLAG · Placement · Corruption. @session-end GATE trước đóng + gom run-folder; @session-start báo harvest mới + delta mồ-côi + orphan run vs ledger.

## 🚫 Split boundary
- ✅ MINE: harvest-memory integrity (5-trục) + spawn-record 4-field + run-folder gom (Harness-10) + delta mồ-côi — SOLUTION_ERP-self
- ❌ NOT: tooling/skill/plugin/docs-freshness → **tooling-auditor** (H1) · corpus/RAG/deploy → cicd-monitor · Fidelity tự-phán "bịa" → escalate **reviewer** · write/decide → em main

## 📋 Baseline state (re-ground S99)
- **Spawn-record 4-field SE:** `{task · verdict · learned · surprise}` (memoryDelta R1 contract HMW).
- **agent-memory:** 12 folder `.claude/agent-memory/<role>/MEMORY.md` (placement target — S107 +office-document seed). Cap L1 = 25.6KB (H11 `memory-archive-gate.ps1`); hook self-target 17.1KB.
- **Run-trace (Harness-10, thay wave-folder Harness-2):** `.claude/workflows/runs/<run-id>/` git-TRACKED, FLAT (`run.md` + `sub-*.md` + `*-synthesis.md`); 5 run cũ 06-18 giữ `sub-md/`+`harvest/` subfolder (dual-accept). **🧊 Ledger `runs/_ledger.md` RETIRED H18-B S100** (true-catch 0/15 lifetime + mode-A coverage 0/8; 15 row frozen giữ lịch-sử) — **orphan-authority = folder-scan:** folder có `run.md` mà `*-synthesis.md` VẮNG/0-byte. Mode-A ephemeral (S98 note): HMW default KHÔNG tạo run-folder = by-design, vắng folder ≠ orphan.
- **Nền H2 gốc:** `session-end.md` Phase 1.5 §L.b = 3/5 trục; sub này nâng +Fidelity-escalate +Placement = đủ 5.

## ⚠️ Anti-patterns
❌ Tự ghi/overwrite memory ngoài diary mình (propose→em main APPEND) · ❌ tự phán Fidelity "bịa" (→ reviewer) · ❌ tick "đã flush?" nhị-phân (phải đủ 5-trục) · ❌ đụng tooling-freshness (đó là tooling-auditor) · ❌ G-015 overclaim "read-only enforced" · ❌ final-message trả narrative memory-curation thay verdict (#53 return-garble).

## ⭐ Methods (giữ vĩnh viễn — đúc từ S50-S66, verbatim → `archive/2026-06.md`)
1. Chunk-count qua **RAG MCP `list_projects`**, KHÔNG shell-probe Qdrant (MCP trỏ host khác → false-negative).
2. Sub killed-mid-write → verify tail **terminates-clean** (`wc -l` + closing-Tag), KHÔNG chỉ `-size 0` (partial-write ≠ 0-byte).
3. Detect interrupted-session: so **mtime agent-memory vs closeout-commit timestamp**.
4. Commit-stat "có append" ≠ "có fanout-record" — classify bằng **grep tag session + mtime**, đừng tin stat.
5. Extract added-bullet trong diff: `grep "^+-"` (filter `grep -v "^[+-][+-]"` NUỐT dòng `+- **…`).
6. `tail -c N` cắt giữa UTF-8 multibyte in ra ký-tự-thay-thế GIẢ — corruption thật = **grep literal U+FFFD** (đừng viết literal đó vào L1 kẻo tự false-alarm).
7. Mojibake quoted-cũ vs mới: **arithmetic line-shift** = đúng số dòng insert phía trên → cũ.
8. Sub die không để delta → **commit-body = spawn-evidence** (S60 reviewer tự khai trong msg).
9. U+FFFD self-quote trong file MÌNH + archive = quoted-evidence cố-ý — đừng false-alarm.
10. Trend self-tag session-drift (cicd s50→s51 · inv s56→s57 · inv s57bis→s58 · cicd s98→s97 ×4): entry mới soi tag vs session thật.
11. **Đếm role-dir từ path-field DÍNH file root-level:** `git ls-files .claude/agent-memory/ | cut -d/ -f3 | sort -u` nuốt `memory-budget.json` + `.mfe-state.json` → ra 14 thay 12 (tự-bắt S123). Guard: `awk -F/ 'NF>3{print $3}'` hoặc `find -mindepth 1 -maxdepth 1 -type d`.
12. **Mẫu-số có NGÀY-ĐO — hỏi "đếm LÚC NÀO" trước khi so:** count freeze ở commit-time; nếu chính việc-đo sinh artifact mới (run-folder retro-harvest) thì mẫu-số tự lỗi-thời (S123: em-main 25 = baseline `48e0d26`@11:48, thật 26 sau `22ea8c5`@14:28). Verdict khớp ≠ mẫu-số khớp.
13. **git MÙ thư-mục RỖNG** → empty-dir residue (stray cwd-relative `<runfolder>/.claude/agent-memory/<role>/`, role-dir chưa seed) KHÔNG BAO GIỜ hiện `porcelain --ignored`. Quét bằng `find .claude -type d -empty`, đừng tin git.

## 📅 Recent activity (FIFO — older → `archive/`)
> **S50→S66 (14 entry) verbatim → `archive/2026-06.md`** — curate S99 (hook 19.9KB > self-target 17.1KB), moved-not-cut grep-verified 5/5 + entry-count 14. Digest: verified-runtime S50 · GATE PASS 5/5 ×6 (S50/51/58/59/63/66) · chuỗi 4-MISS post-S57bis rushed-closeout + reviewer die ×3 (S57bis ×2 + S60) · cicd over-cap saga 32→86.8KB → curate S66 86.8→28.9KB.
> **S98→S101 (4 entry) verbatim → `archive/2026-07.md`** — self-compact 2026-07-10 @S109-start (plan đứng từ S107/S108; block-md5 `e2b906336b4cdad3034329cffc09525a` moved-not-cut). Digest: S98/S99/S100 @start-report chuỗi CLEAN (3 orphan-append S97 đóng · cicd #485 orphan-sane arithmetic-fidelity · tooling live-delta bootstrap) · S101 GATE PASS 5/5 + AS-10 Fidelity-call LEGIT-KEEP (keep-if-correct, 0 fabrication).
> **S102→S106 (5 entry) verbatim → `archive/2026-07.md`** — self-compact 2026-07-12 @S111-start HOOK-directed (plan ĐỨNG từ S107/S108/S110; mở-rộng +S106 để đạt <17.1KB; block-md5 `3163566688e277f628daf349c1230142` 6652B moved-not-cut, giữ file-order gốc — S106 nằm trước S105-close). Digest: S102 CATCH ×2 (reviewer cut-not-moved f229b07 → recover + dead-satellite pointer) · S104-retro self-record blind-spot gate-agent · S105 @start mồ-côi-×1-đóng / @close moved-not-cut byte-level tooling 19380→16305 · S106 ref-table = S98-snapshot benign + cicd-not-spawned-S105 resolved-false-alarm.
> **S107→S109 (5 entry) verbatim → `archive/2026-07.md`** — self-compact 2026-07-12 @S113-end HOOK-directed (plan ĐỨNG từ S107-end/S108; +S109 đạt <17.1KB; block-md5 `75b69b41534cb67cdf349b6e1164d47f` 5623B moved-not-cut, file-order verbatim). Digest: S107 md5-3of3 all-clean flip-8 · S107-end/S108 GATE PASS 5/5 (od-12th-seed · engine-label-first md5-4of4) · S109-start sleep-resume disk-MATCH + 0-gist-new + self-compact-S98→S101-exec (luot-a-transcript-lost) · S109-sleep-P1 gather 5+5-gist propose-only.
> **S110→S111 (4 entry) verbatim → `archive/2026-07.md`** — self-compact 2026-07-13 @S116-end HOOK-directed (SELF 20KB>read-limit; plan ĐỨNG từ S114-start; block-md5 `640f80e452b42badb12bc2a3c57cf9f7` 6638B moved-not-cut, file-order verbatim, anchor 4×{L1=0·AR=1}). Digest: S110-start rerun-DEDUP luot-sang-transcript-lost (gist byte-exact `cat-file`==disk) · S110-end GATE PASS 5/5 close-gate-15of15 garble-x2-recovered + FFFD-baseline-1-selfquote seed · S111-start self-compact-S102→S106-EXECUTED + gist-frozen-x2 · S111-end GATE PASS 5/5 close-gate-0of16 h22-first-subtask-runtrace + `--stat`-truncate-trap.
> **S113 ×2 entry (start+end) verbatim → `archive/2026-07.md`** — self-compact 2026-07-14 @S118-start (plan ĐỨNG từ S117-end soft-due; block-md5 `0c782c7cebc8f1d8b16f65b8e1474820` 4064B moved-not-cut, file-order verbatim, anchor 2×{L1=0·AR=1}). Digest: S113-start MOSTLY-CLEAN 0-orphan/20 + 2-coverage-gap propose (impl-be thiếu Supplier-BE · test-spec thiếu narrative; embedded-synth pattern mới · maxdepth-1 false-flag lesson) · S113-end GATE PASS 5/5 0/21 (2-gap CLOSED idempotent · wal-flush-landing 6-diary · Fidelity `5fa11b5` file-list exact · nit journal-jsonl dead-pointer + backfill-22-vs-37).
> **S114/S116/S117 (3 entry) verbatim → `archive/2026-07.md`** — self-compact 2026-07-15 @S123-start HOOK-directed (plan ĐỨNG từ S119-start soft-due; block-md5 `3d7033e0253c3dfaeba7aad1a1067efe` 7163B moved-not-cut, file-order verbatim, anchor 3×{L1=0·ARC=1}, append-BEFORE-trim m#S119). Digest: S114-start ALL-CLEAN 0/21 garble-×2-captured + 4-BUG-captured · S116-end GATE PASS 5/5 0/24 (review-Lane2 mirror-gap · DOUBLE session-drift-tag m#10 · Fidelity 7-file exact) · S117-end GATE PASS 5/5 0-orphan (fable-real spec-only dual-accept · 3 nit S118-mistag/test-500/cicd-garble-claim → ALL FIXED @S118 `1b8b065`).
- **2026-07-17 (S132 DỒN S127→S131 — re-spawn sau session-limit-death S131 [E-011]; by em-main VERIFY→APPEND):** GAPS-FOUND→**CLOSED-in-session**. Coverage PASS **31 run.md/33 dirs** (2 = spec-only S117 by-design; interim "26" = S123-baseline stale) · **0-orphan/31** · 2 folder mới S127+S129 flat dạng-1 đủ · roster-harvest đủ (reviewer S127/S128×2/S129/S131×2 · inv-cb S128/S129 · cicd S128/S129; wave-workers generic = no-diary by-design; S130 em-main-solo 0-spawn = không nợ). Fidelity STRONG (entries tự-flag overclaim mình) · Corruption PASS (FFFD 0/3 · porcelain agent-memory 0 mồ-côi; inv-cb "<22>24.1KB" = m#6 tail-cut artifact tự-bắt). Placement FLAG ×2 (git-invisible m#13): 2 dirs H24 RỖNG since-S123 + stray S119 → em-main CLOSED cùng phiên (seed 2 diary retro từ `sub-lead-{view,omission}.md` 8379B/9967B + rmdir stray 3-dir-rỗng). Lesson: (1) folder S127 chứa subs tag S128 = **trigger-session naming**, KHÔNG gap; (2) `sort -u -k2` collapse entry cùng-pattern = measurement-artifact — targeted-grep recover; (3) H24 knowledge sống CHỈ ở run-folder+counter-json ⇒ **per-ROLE diary = lớp không ai sở-hữu** tới khi seed (E-011/GAP-3).
> **S118 (start+end) + S119-start (3 entry) verbatim → `archive/2026-07.md`** — self-compact 2026-07-16 @S125-start HOOK-directed (SELF 22.5KB>read-limit; block-md5 `9f7a11dcd057a27d03b06843bbdf2274` 6252B moved-not-cut, file-order verbatim, anchor 3×{L1=0·ARC=1}). Digest: S118-start ALL-CLEAN 0/26 (3nit-S117-fixed `1b8b065` · FFFD-baseline 1→0 self-quote-left-L1) · S118-end GATE PASS 5/5 0-orphan-no-runtrace (cicd-garble-×2-return-label-nit em-main-FIXED) · S119-start ALL-CLEAN 0/26 77/77-tracked + LIVE mid-flight catch (sibling append-BEFORE-trim=safe-order · m#5 archive-diff-grep-swallow self-caught).
- **2026-07-15 (S123 @start RE-REPORT — self-write diary; return #53-garble ×1 → em-main recover-from-disk, việc KHÔNG mất):** Model `claude-opus-4-8`. Verdict 🟡 **MOSTLY-CLEAN — 0 orphan/26 · 0 mồ-côi · corruption 0 · Fidelity STRONG; 1 Coverage-gap + 2 Placement-flag propose.** (1) **Orphan 0/26 tự-đo** bằng block TRI-ACCEPT verbatim `tiep.md §0:41-57` (28 dir − 2 S117-fable-real spec-only no-run.md = 26 run). Verdict KHỚP em-main, **mẫu-số LỆCH: em-main báo 25** → truy: `48e0d26`@11:48 W0.5 baseline đo "13 orphan/**25**" rồi con-số bị **chép từ narrative**; folder `S122-retro-harvest-7-orphan` SINH @`22ea8c5`@14:28 (sau baseline 2h40) ⇒ 25+1=26. **Chính việc-đo sinh artifact mà mẫu-số của nó không đếm** → m#12. em-main đã đính-chính với anh. (2) 🔴 **dạng-3 = DEAD CODE:** drop nhánh dạng-3 ⇒ **0 folder** thành orphan (6 folder có `## synthesis` embedded — S112×4/S113/S114 — ĐỀU đã có flat sau `22ea8c5`). **dạng-2 (C8) VẪN load-bearing = 5 folder** (h10-implement/invest/review · h910-curate/finalize) → giữ. ⇒ chức-năng CÒN LẠI duy-nhất của nhánh dạng-3 = **âm-thầm tha vi-phạm TƯƠNG-LAI** của luật "nhận≠cho phép" (doc CẤM viết mới dạng-3 nhưng detector VẪN nhận) ⇒ lệnh-cấm đang dựa vào TRÍ-NHỚ, không phải LUẬT soi-được. (3) 🔴 **Doc STALE-AT-BIRTH:** `tiep.md:66` khai (thì hiện-tại) `pe-negative-quote` = ví-dụ dạng-4 "kẽ còn lại, không phải chuyện đã xử" — NHƯNG `22ea8c5`@14:28 đã thêm `implement-synthesis.md` 8249B, còn doc viết @`dfa3dae`@**14:48 = SAU 20 phút** ⇒ doc mô-tả "chưa xử" cho thứ chính tác-giả vừa xử. Nay folder = dạng-1. **Lập-luận dạng-4 vẫn ĐÚNG, chỉ VÍ-DỤ lão-hoá** (class "acceptance literal tự-lão-hoá" S121) — rủi-ro: người đọc grep thấy flat-file → kết-luận cảnh-báo sai → vứt luôn caveat còn đúng. (4) **Mắt người 0 rỗng-ruột:** 26/26 synthesis có body thật; mỏng nhất `h910-curate` 1653B/body=8 → ĐỌC TAY = thực-chất (bảng before→after byte + moved-count + 0-byte-loss + verdict). 2 folder mới nhất (S119-adap · S122-retro) đều dạng-1 ⇒ "nhận≠cho phép" CLEAN, 0 tái-sinh. (5) **Coverage 🟡 GAP-1 reviewer:** wave S119/S122 reviewer chạy **5 spawn** (`wf_78a84f9b-03e` 4-lane: R2 FAIL-4C+8M `sub-reviewer-R2.md` 22121B · R3 FAIL-5C+6M 27612B · R1/R4 chết #53 · + `/fable-real` `wf_cb964f83-331` GO-WITH-FIXES 8-fix) và **ĐỔI SPEC v2→v3-PATCH**, nhưng `reviewer/MEMORY.md` **0 hit S119-S122** (last-commit `b56659b` 07-14). Bất-đối-xứng: inv-cb ĐƯỢC consolidate +6 dòng @`16c91a8`, reviewer KHÔNG. Knowledge NOT-lost (2 sub-md + gate-verdict + STATUS tracked) ⇒ MEDIUM. (6) **Placement 🟡 ×2 (git MÙ cả 2 — m#13):** (a) **stray `runs/2026-07-15-S119-adap-6-broadcast/.claude/agent-memory/reviewer/`** = mis-land cwd-relative (lớp S54 TÁI-PHÁT), mtime 09:53:43, **0 file ⇒ 0 data-loss**, `porcelain --ignored`=0 dòng. (b) **2 vai H24 `lead-view-auditor`+`lead-omission-auditor` dir RỖNG, 0 MEMORY.md, git-invisible** (roster: agents/*.md=14 · dir disk=14 · **dir git-thấy=12**). **Tiền-lệ office-document S107 `21387cd` = seed 2161B NGAY LÚC TẠO VAI** ("MEMORY seed 2161B + wire 14-file", spawn-test pending) ⇒ S122 `00a1c67` wire đủ (VALID_ROLES 12→14 + STATUS 2 row) nhưng **HỤT seed** ⇒ propose seed. Rủi-ro CỤ-THỂ (không giả-định): git không track dir rỗng ⇒ **fresh-clone = 2 dir BIẾN MẤT**, mà system-prompt 2 vai khẳng-định "directory already exists — do not mkdir" ⇒ lần chạy đầu ~S128 gặp dir vắng. Mỉa: S122 học đúng bài "git mù dir rỗng" + `rmdir` 2 probe (16→14) nhưng **để lại 3 dir rỗng git-mù khác**. (7) Corruption 0: 0-byte **0/77** tracked + 0 trong workflows · tail-0a 12/12 · **FFFD 0/12 L1** (3 archive hit = self-quote baseline m#9: SELF 2026-06 ×3 / 2026-07 ×1 · cicd 2026-06 ×1) · `$(` = cicd `$(cygpath)` + SELF intentional-cmd (known-benign). ⚠️ **Tự-bắt m#6 trap:** `cut -c1-260` của CHÍNH TAO đẻ ra FFFD GIẢ + cụt-giữa-từ ("dạn"/"has") trong inv-cb entry → re-verify no-cut: **sạch, 427-ch dòng cuối kết bằng tag đóng**. ⚠️ **Tự-bắt m#11:** báo nhầm "git-visible 14" vì `cut -d/ -f3` đếm `memory-budget.json`+`.mfe-state.json` như role → thật **12**. (8) Delta mồ-côi **0**: chỉ inv-cb chạm (mtime 15:52:22 < last-commit `16c91a8` 15:57:53, m#3) · 12/12 L1 mtime ≤ commit tương-ứng · porcelain agent-memory = 0. Porcelain repo = 1 dòng `.session-counter.json` (counter 1→2, S122→S123, head=`cefb183`) = tick H24 của CHÍNH phiên này, chưa commit — benign, KHÔNG phải memory ("cây SẠCH" trong brief đúng LÚC em-main đo, giờ 1-dòng bẩn do chính nó tick). (9) DIFF vs S122: run 25→**26** · orphan 8-dual→2→**0** · dạng-3 live-reliance 6→**0** · dạng-4 known 1→**0** · agent-memory dir 16→14 (git-thấy 12) · SELF 20.8K→14.5K post-compact. Chore: 0 L1 > 25.6 cap (inv-cb 22.9 max · tooling 22.3 · fe-designer 21.5 idle-07-01 · cicd 20.9); **SELF self-compact S114/S116/S117 ĐÃ EXEC** phiên này. Tag `[s123-start, mostly-clean, 0-orphan-0of26, denominator-25-vs-26-m12, dang3-dead-code, doc-stale-at-birth-penegquote, reviewer-coverage-gap-5spawn, stray-misland-s54-empty, 2role-dir-no-seed-gitblind, m6-m11-traps-selfcaught, return-garble-x1-disk-recovered]`
- **2026-07-16 (S125 @start RE-REPORT — self-write diary):** Model `claude-opus-4-8`. Verdict 🟡 **FLAGS — S124 harvest STRUCTURALLY ĐỦ + 0 orphan/27 + corruption 0; 2 coverage-gap.** (1) Run-folder `S124-adap-wave-reply/` ĐỦ: flat `review-synthesis.md` 5667B (dạng-1) + run.md + 5 sub-md non-zero (lead-omission 9967 · lead-view 8379 · reviewer-1/2/3 8153/10205/10759). Orphan **0/27** run.md (all synth flat/C8) + 2×S117-fable spec-only no-run.md by-design; run 26→27 (+S124). (2) 🔴 **GAP-1 HIGH — 2 vai H24 first-ever-run S124 KHÔNG diary:** `lead-view-auditor`(9 flag) + `lead-omission-auditor`(4 flag+1 escalate), cả 2 `memory:project` by-design, dir RỖNG git-mù (m#13); knowledge trong sub-md+synth+run.md NHƯNG 0 cross-session diary ⇒ next cadence ~S127 mù. Compound S123 seed-hụt (VẪN mở). Propose seed + 4-field spawn-record cả 2. (3) reviewer harvest ✓ 2 S124 entry (L2 fidelity :79 + L3 do-token :80 garble-recover "disk sub-reviewer-3"); L1 authority 0-over-reach + M-1 AHEAD-overclaim folded-synth = optional-nit (PASS-result, low-value). (4) 🟡 GAP-2 LOW carry-fwd: stray misland `runs/…S119-adap-6-broadcast/.claude/agent-memory/reviewer/` empty (class S54) VẪN present S123→S125, propose rmdir. Corruption 0: 0-byte 0/tracked · FFFD 0/12 L1 · tail-0a 11/12 (tooling-auditor ends 0x60 backtick no-EOF-nl = benign, committed-@HEAD identical, content-complete nit). Mồ-côi 0: porcelain = chỉ `.claude/governance/.session-counter.json` tick S124→S125 (non-memory). SELF 20.3K>17.1 target → self-compact S119/S123-block due. APPEND-direct: 0 (2 propose = em-main seed 2 H24). Tag `[s125-start, flags, s124-complete-0orphan27, 2-h24-firstrun-no-diary-HIGH, seed-hut-carryfwd-s123, stray-misland-s54-still, corruption-0]`.
- **S126 (2026-07-16) session-end GATE [opus-worker, em-main VERIFY+APPEND]:** **PASS 5/5 trục** · orphan **0/29** run.md-folder (2 folder phiên này: S125→`spec-execution-synthesis.md` dạng-1 · S126→2 synthesis dạng-1) · Sàn-5 **0 lệch** (S126 born-in-session có `run=` marker session-log; S125 first-commit 13:29:43 = 77s PRE-session → ngoài scope birth-criterion) · corruption 0 (U+FFFD 0/4 + iconv VALID 4/4) · moved-not-cut 2 archive `@S126 hook-curate batch` VERIFIED khớp digest-pointer L1. Learned: grep `Ã|Æ°|â€` = **FALSE-POSITIVE generator trên VN UTF-8** (m#6 pattern MỚI — byte ư/ơ trùng-prefix + literal "mojibake" trong RCA-quote = m#9 self-quote); signal THẬT = U+FFFD-count + iconv round-trip. Coverage khi `wf_*` transcript KHÔNG git-tracked = **triangulation 3-nguồn** (session-log[wf+timing] ⋂ synthesis[cite-jsonl per-lane] ⋂ harvest-entry[name lane]). Surprise: Sàn-5 marker phải grep SESSION-LOG (`run=` prefix) KHÔNG phải WAL (path-form cite — 2 doc khác convention). Tag `[s126-end, gate-pass-5truc, 0orphan29, san5-0lech, m6-new-pattern-vn-utf8]`.