5.1 KiB

Raw Blame History

Active work — cross-machine resume ledger

Snapshot: 2026-07-21. This file records volatile work that has not landed on main. Read it after docs/agent-handoff.md. Remove completed entries when their PR merges; do not let this become a second permanent backlog.

Repository authority

Canonical development URL: https://github.com/levineuwirth/pmacs.git. This ledger uses the normalized local alias githubsucks so its refs and recovery commands are identical on every machine. Remote names are otherwise machine-local: origin may name this canonical URL, a release mirror, or something else, and therefore has no authority by name alone.
Canonical base at this snapshot: githubsucks/main @ bb17ec9 (#123 merged atop #124, protocol v17).
On the transfer source, origin/main named a release mirror at d3fa632 and lagged badly. On the current destination, origin names the canonical URL. This difference is why all recovery begins by verifying URLs and normalizing githubsucks rather than trusting origin/main.
The shared desktop checkout contained unrelated uncommitted work. The branches below were prepared in isolated worktrees; never clean or overwrite the shared checkout to recover them.

Start on another machine by inspecting its remotes:

git remote -v
git remote get-url githubsucks

If the second command says the alias is absent, add it; if it prints a different URL, stop and resolve that collision rather than overwriting an unknown remote:

git remote add githubsucks https://github.com/levineuwirth/pmacs.git

Then recover current refs:

git fetch githubsucks --prune
git log -1 --oneline githubsucks/main
git worktree list
git status --short --branch

The first command must expose bb17ec9 or a newer intentional main. If it does not, stop and repair the remote/fetch configuration.

Active lane: Arc 4 stage 3 — statusline segments

Portable branch: githubsucks/statusline-segments
Feature head: c3d125ac96b7bf0a8eba60530f8a2adb083cd7a6
Pull request: #125, feat(statusline): composable modeline segments at protocol v18 — https://github.com/levineuwirth/pmacs/pull/125
State: Revision 3's Q#SL1-Q#SL11 and Acceptance 1-27 are implemented, committed, pushed, and awaiting review. The branch is not merged.
Scope delivered: strict composable per-window pmacs.statusline providers; borrow-released evaluation and per-context failure latches; legacy-preserving TUI composition; a pure built-in LSP provider; dynamic modeline-face inventory; protocol-v18 authoritative StatuslineSegments; snapshot/version symmetry; and atomic GPU validation, face resolution, shaping, clipping, and caching.
Full verification, sequential with no flaky rerun: cargo fmt --check; workspace/all-target Clippy with -D warnings; 1,610 default library tests (3 ignored); 1,784 CRDT library tests (3 ignored); 7 default and 8 CRDT statusline acceptance tests; 110 M4 acceptance tests (3 ignored, basedpyright filtered); 108 required GPU tests; one workspace invocation with 2,704 passing tests across 78 suites (19 ignored, basedpyright filtered); and git diff --check.
Recovery state at handoff: /home/jeans/Repos/active/pmacs-statusline is clean, its local branch and githubsucks/statusline-segments both point at the feature head above, and PR #125 targets canonical main.

Recovery worktree on a machine that does not already have the local branch:

git fetch githubsucks statusline-segments
git worktree add --track \
  -b statusline-segments \
  ../pmacs-statusline \
  githubsucks/statusline-segments
gh pr view 125 --repo levineuwirth/pmacs

Parked lane: kill-ring browser + persistence

Portable branch: githubsucks/kill-ring-browser
Parked framing head: 503c489
State: framing only, revision 2; no implementation and no PR.
Status: explicitly parked by the user on 2026-07-20.
Its original scout was based on 0efb5cd. The preserved framing marks this ground truth stale and requires a complete re-scout against the then-current githubsucks/main before implementation.
Compile-mode has merged since the original scout, so old “compile-mode in flight” keybinding/touch-set assumptions are not authoritative.

Recovery worktree, only when the user un-parks it:

git worktree add --track \
  -b kill-ring-browser \
  ../pmacs-kill-ring-browser \
  githubsucks/kill-ring-browser

Documentation lane

Portable branch: githubsucks/handoff-2026-07-20
Carries synchronized AGENTS.md / CLAUDE.md, this ledger, the durable handoff refresh, and the keybinding reference correction.
It changes no runtime code.
Review and merge this documentation branch separately; it must not be folded into PR #123 or either feature framing branch.

Update protocol

Whenever a listed lane changes materially:

update its public branch and head/state here;
record new verification and remove superseded caveats;
keep durable architecture in docs/agent-handoff.md, not here;
remove the lane after merge or abandonment;
verify every recovery command from a clean worktree before calling the transfer complete.

5.1 KiB Raw Blame History