Skip to content

[skip-cr] session-peers: add private local repository ledgers - #189

Merged
vtmocanu merged 2 commits into
mainfrom
feat/session-peers-ledger
Nov 19, 2026
Merged

vtmocanu merged 2 commits into
mainfrom
feat/session-peers-ledger

Conversation

@vtmocanu

Copy link
Copy Markdown
Owner

Adds private handover ledgers shared by a repository's worktrees. The skill derives the location from the canonical Git common directory, with an anchor check that refuses key collisions and explicit relocation for moved repositories.

Each ledger is a local Git repository with private permissions, isolated configuration, disabled hooks/signing/transports and refusal of configured remotes. Mutations serialize under a bounded lock, read committed state, preserve interrupted work, and check ownership again before editing. Expired leases grant no takeover rights. Import preserves original documents and provenance in one commit; done items remain searchable.

Discovery runs through the skill and compact, bounded human buddy/handover reminders. Existing JSON output stays unchanged. No hooks or consumer-repository configuration are added. Repository-specific private rules and the existing handover notes are not included in this PR.

Validation:

  • 19 ledger tests pass, including worktree/bare/symlink identity, collisions, real CLI relocation, concurrent writers, stale owners, commit ambiguity, imports, Git isolation, permissions, and a 79-item batch-read case.
  • 115 tests pass on the frozen head: the ledger, buddy and handover tests plus the source-digest test class (44.6 seconds locally).
  • Mutation checks catch removed anchor, ownership, clean-tree and remote guards; restored guards pass.
  • Skill validation: 24/24 pass. Agnix: zero errors; both Claude and Codex SKILL.md checks have zero warnings. Directory lint retains seven advisory path warnings, including the deliberately documented XDG fallback.
  • Git diff checks and the commit secret scan pass.

The broader 2,016-test sweep had 2,015 passes and one source-digest failure: runtime files were edited after that process imported them. The frozen-head rerun covers that digest class and every directly affected test. A clean full exact-head sweep is left to PR CI; that earlier run is not reported as a full pass.

The ledger-only suite takes about 10 seconds locally. Before/after CI critical-path timing is unmeasured; no CI jobs or timers were added. The reminder timeout test uses a mocked timeout, not a real wait.

VERSION advances to 0.50.0. The documentation also fixes pre-existing wrapped-placeholder lint errors without changing their wording.

@vtmocanu
vtmocanu merged commit 33f5da2 into main Nov 19, 2026
10 checks passed
@vtmocanu
vtmocanu deleted the feat/session-peers-ledger branch November 19, 2026 09:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant