board-jsonl-rotation-fold

Answer

Root cause: the B2F rotation-battery re-execution leaves test-state.toml, b2f/*.md, and _index.md dirty after the light-audit tick, and nothing appends the corresponding audit event — so the board header's last_commit goes stale and the jsonl/db mirrors drift. The fix is a deterministic fold run after each tick, in exactly this order:

1. content commit — test-state.toml, b2f/*.md, _index.md → test(board): fold B2F rotation battery output
2. event append — append_board_event.py --set ticks_total=<n> --set ticks_idle=0 --set last_commit=<content-hash> (FAT-shape audit_tick row; header last_commit = content hash; ticks_idle always 0 because light-audit ticks never idle)
3. chore commit — board/board.jsonl + board/board.db → chore(board): append rotation audit tick

Implementation (/tmp/fold-fix/fold_rotation.py, the fix):

# 1) classify the dirty tree: content paths vs board paths
proc = git(repo, "status", "--porcelain", "--untracked-files=all")
for line in proc.stdout.splitlines():
    status, path = line[:2].strip(), line[3:]
    if status:
        if is_content(path): content.append(path)      # test-state.toml, b2f/, _index.md
        elif path.startswith("board/"): board.append(path)

# 2) content commit FIRST (its hash is the event's last_commit)
if content:
    git(repo, "add", "--", *content)
    git(repo, "commit", "-m", "test(board): fold B2F rotation battery output")
content_hash = git(repo, "rev-parse", "HEAD").stdout.strip()

# 3) FAT-shape audit event; header last_commit = content hash, ticks_idle = 0
cmd = [sys.executable, APPEND_BOARD_EVENT, "--board", board_jsonl_abs, "--db", board_db_abs,
       "--set", "event=audit_tick", "--set", "battery=B2F", "--set", "rotation=true",
       "--set", "ticks_total=%d" % ticks_total, "--set", "ticks_idle=0",
       "--set", "last_commit=%s" % content_hash]
subprocess.run(cmd, check=True)

# 4) chore(board) commit for jsonl + db mirror
git(repo, "add", "--", board_jsonl_rel, board_db_rel)
git(repo, "commit", "-m", "chore(board): append rotation audit tick")

Supporting append_board_event.py keeps jsonl and SQLite db in lock-step: line 1 of the jsonl is the header record (last_commit/ticks_total/ticks_idle), each later line is an event; the db mirror is rebuilt from the jsonl on every append so parity holds even after a torn fold. It also exposes --parity-check (exit 1 on jsonl-vs-db mismatch).