[HT0710]

Why: sessions sharing one clone can edit the same file unaware; the built-in stale-read check misses a fresh re-read of another session's half-done work (roadmap v1.6 #1).

Changes:

• New mod ledger: records each Edit/Write/NotebookEdit per session in a shared $.store ledger, keyed by the resolved path; the first edit of a file another live session edited in the last 30 min is denied once and that session is messaged ($.session.send); the retry passes
• Undelivered message (other session gone) → no pause, entry taken over; entries pruned after 30 min and dropped at session end; a store failure never blocks an edit
• Trace rows ledger.pause, ledger.record, ledger.end, ledger.failed
• New install part ledger (Background group): parts.json, marketplace, settings.base.json, install.sh menus, install/trace tests
• Docs: plugin README, README, GUIDE (Git and safety, What runs on its own, parts list), CONFIGURATION

Impact:

• Full installs get the plugin on their next update; Custom installs can untick ledger
• A message to an idle session wakes it, costing one short turn there

Action required: live clone: run ./install.sh after merge so sessions load ledger.

Not covered: edits made through Bash (sed -i, >); two sessions writing the ledger at the same moment can lose one entry (shortcut: in register.ts); a session pauses on each file only once for its whole life; agent-team teammates count as separate sessions and pause each other (unverified).

Test plan:

• claude plugin test plugins/ledger (14 pass)
• tsc -p plugins/ledger --noEmit (exit 0)
• tests/*.test.sh, all 9 CI suites (0 failed)
• Live: two tmux sessions with --plugin-dir; A wrote notes.txt, B's Edit paused, A woke and replied, B re-read and retried (alpha/beta); store empty after both exited
• Spike: $.store reads fresh across sessions; $.session.send delivers, dead id → isDelivered:false
• Code review (opus): ready with fixes; all 6 fixed (pause kept on undelivered send, Write through a link re-keyed, resolved path in message, deny wording, README line, recipient test)

🤖 Generated with Claude Code