vietreport-admin/solution-erp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

wal: pause

Browse Source
This commit is contained in:
pqhuy1987
2026-07-17 17:03:54 +07:00
parent a4ac81a771
commit 03634954e2
7 changed files with 70 additions and 30 deletions
Download Patch File Download Diff File Expand all files Collapse all files

13
.claude/governance/.session-counter.json
View File

@ -3,16 +3,16 @@
"_why_content_based_not_blind_increment": "Owner-decisions-15-07-2026 Q2, trap found by lane E: the Stop-hook .claude/hooks/wal-flush.ps1 auto-commits on EVERY turn-boundary. A blind counter++ would therefore tick many times per real session and the cadence would be meaningless. So a tick is CONTENT-ADDRESSED: it is keyed on the repo HEAD sha at tick time. Ticking twice on the same HEAD is a NO-OP, which is what makes running /session-start twice in a row safe (acceptance: 2x /session-start on the same HEAD => +1, not +2).",
"_why_this_path": "Deliberately .claude/governance/ and NOT .claude/agent-memory/. The hook covers exactly 3 paths (.claude/WAL.md, agent-memory/, workflows/runs/); .claude/governance/ is OUTSIDE all three, so this file is never swept into a 'wal:' commit as a side effect. Compare .claude/agent-memory/.mfe-state.json, which IS inside the hook's reach - a counter must not live there.",
"_contract": {
"tick": "tick(session, head): if head == last_ticked_head -> NO-OP (idempotent, same HEAD = same real session state). Else counter = counter + 1, last_ticked_session = session, last_ticked_head = head, last_ticked_at = date.",
"tick": "tick(session, head): if head == last_ticked_head OR session == last_ticked_session -> NO-OP (idempotent per HEAD AND per session-label). The Stop-hook wal-flush.ps1 moves HEAD mid-session (auto-commit every turn-boundary), so the head-clause alone would let a single real session tick more than once; the session-label clause pins ONE session-label to exactly +1, not +2. This closes the +2/cycle trap: a /pause commit changes HEAD, but the same session-label still NO-OPs. Else counter = counter + 1, last_ticked_session = session, last_ticked_head = head, last_ticked_at = date.",
"fail_loud_on_regress": "If an incoming counter is LOWER than the stored counter, or last_ticked_head names a commit not reachable from HEAD, DO NOT silently reset: report to owner. A counter that moves backwards means the state file was rolled back or hand-edited, and a silent reset would hide the cadence gap.",
"overdue": "OVERDUE(light) when (counter - last_audit.light_at_counter) >= h24_cadence.light_every. Same shape for deep_every. Skipping sessions does NOT lose the debt - the gap is measured from the counter, not from wall-clock, so a missed session surfaces as OVERDUE rather than vanishing.",
"jump": "jump_on_class_repeat (h24_cadence): if ONE flag class from lead_self_audit.flag_classes repeats N times, pull the next audit forward regardless of the counter.",
"writer": "Lead is single-writer. Wired at /session-start (W3 owns the ritual; W2 owns this file + its shape)."
},
"_seed_honesty": "Seeded UNTICKED on purpose. counter=0 and last_ticked_* = null mean 'no tick has ever happened', which is the truth at S121 - the ritual that performs the tick lands in W3. Seeding a fake first tick here would make the very first cadence reading a lie, and H24 exists to catch exactly that kind of invented number.",
"counter": 7,
"last_ticked_session": "S131",
"last_ticked_head": "882e0d783878b074be2fd944e9f5e4e4a1a7cd3d",
"counter": 9,
"last_ticked_session": "S135",
"last_ticked_head": "a4ac81a7718e7b8841aa2f35282dc7856dfadd69",
"last_ticked_at": "2026-07-17",
"last_audit": {
"light_at_counter": 3,
@ -28,6 +28,11 @@
"at": "2026-07-16",
"session": "S127",
"event": "ancestor-check FAIL-LOUD (dung contract): last_ticked_head f9fa77d6 la dangling commit - object ton tai (cat-file -t = commit) nhung 0 nhanh chua no. Root-cause: closeout S126 SQUASH cac wal:-commit (session-end squash->count->push) nen head luc tick bi squash khoi lich su. KHONG phai tamper: counter khong lui, file khong sua tay. Xu ly: tick tiep 5->6 CO VET (entry nay) + bao anh trong turn S127. KE THIET KE ghi nhan: moi phien dau-sau-closeout-squash se fail ancestor-check gia; candidate fix = chap nhan dangling-object-exists lam bang-chung yeu khi counter khong lui (cho anh/hub quyet, chua doi contract)."
},
{
"at": "2026-07-17",
"session": "S133",
"event": "ancestor-check FAIL-LOUD lan 2 (cung class S127, dung contract): last_ticked_head 882e0d7 (tick @S131) la dangling commit - object ton tai (cat-file -t = commit) nhung khong reachable tu HEAD. Root-cause: closeout S131-S132 SQUASH wal:-commit (squash->count->push) nen head luc tick bi squash khoi lich su. KHONG phai tamper: counter khong lui (7), file khong sua tay. Xu ly: tick tiep 7->8 CO VET (entry nay) + bao anh trong turn S133. Candidate fix VAN treo cho anh/hub quyet (chua doi contract): chap nhan dangling-object-exists lam bang-chung yeu khi counter khong lui."
}
]
}