docs(plan): paused 2026-10-31; the two checkpointed worktrees and how to resume
check / check (push) Waiting to run
portable-macos / portable (macos-latest) (push) Waiting to run
portable-windows / portable (windows-latest) (push) Waiting to run
two-user / two-user (push) Waiting to run

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01HS8WZziDnyxunC23MUxrLp
This commit is contained in:
swaitsandClaude Fable 5.1 committed 2026-10-30 20:10:33 -06:00
1 parent c7cadef239
commit 812d6f203e
2 files changed
+36 -1

No files matched your search

+1 -1
View File
@@ -18,7 +18,7 @@ You are the engineering manager (EM) of a team implementing the remaining work o
- `main` is `bfd453b6`. Landed since the hand-off: U0a, U0b, U0c, P7, P9a, P13 steps 1-3, P4b S4.1, S4.2, S4.3 (2026-10-26 to 2026-10-27), then S4.4, S5, S6, S7 and P6 (2026-10-29, merged from the paused branches by the planning session). Live on the owner's books: P0 to P3, Projects, P4b S1 (`document_standing`); everything behind `documents_v2` waits for the owner's upgrade (Q-5).
- Nothing is built and unmerged. Branch `ci-fixes` (`76285434`, a fuzz target's renamed path and a regression test) is the one branch left to merge.
- Landed 2026-10-29 by this session's subagents in three waves: U0d, U0e, S4.5, P4, P5, P8, P10 (the runbook), P11a steps 0-4 plus the unsigned macOS bundle job, P11b, P13 steps 4-6 (the spec lives at `git.swaits.com/swaits/bookspec`). Building: P11c (branch `P11c`, proven by the portable CI jobs). Left: P11a steps 5-7 (signing deferred, D-64), P12, the owner's re-audit.
- Landed 2026-10-29 to 2026-10-31 by this session's subagents in four waves: U0d, U0e, S4.5, P4, P5, P8, P10 (the runbook), P11a steps 0-4 plus the unsigned macOS bundle job, P11b, P11c (the Windows port; `main` gates on Linux, macOS and Windows), P13 steps 4-6 (the spec lives at `git.swaits.com/swaits/bookspec`). **Paused 2026-10-31** with two checkpointed worktrees, `../wb-P12` (P12 step 1) and `../wb-P11a` (the in-app update accept, the Windows installer job, translocation): see `plan/STATUS.md` "Paused" for what each holds and how to resume. Left after them: P12 step 2 (the run), P11a steps 5 and 7 (signing deferred, D-64), the owner's re-audit and trials.
- The plan's section 8 was rewritten on 2026-10-26 for this hand-off and revised on 2026-10-28 (section 0, "What changed on 2026-10-28"; `plan/2026-10-28_DRIFT_REPORT.md`). Sections 1 to 7 are the older design and carry strike-throughs (`~~text~~ → D-n`) and "As built" notes where the build or a decision departed; where section 8 and an earlier section disagree, section 8 is right.
- Mutation testing is paused until unit P12 (decision D-33). Workers never run `cargo mutants`; each unit writes a "For P12" paragraph in `docs/testing.md` instead (recipe R-G).
- The owner's live books are never touched by anyone on this team. The only books a worker uses are test fixtures and throwaway books made by `wanderbooks setup` in a scratch root. A unit's new writes are refused on the owner's books until the owner's format upgrade; merging never waits for that.
+35
View File
@@ -1,5 +1,40 @@
# STATUS — 2026-10-28: nine units landed, five built on paused branches; P11a starts
## Paused (2026-10-31, 03:00 UTC): the owner paused the workstream
**Where things stand.** `main` is `c7cadef2` (code `a413e394`, the
P11c merge); the Linux gate and macOS were green on `7809ff81`, the
commit before the P11c merge, and P11c's branch was green on all three
platforms at the same content. The three workflows gate every push
(`check`, `portable-macos`, `portable-windows`).
**Two worktrees hold unfinished work, checkpointed, not for merge as
is** (each has a `wip: pause checkpoint` commit on top of real ones):
- `../wb-P12`, branch `P12`: P12 step 1. Done and committed: the
mutation recipes (`1343bb14`), the per-crate checklists in
`docs/testing.md` (`573e3d4f`). In the checkpoint (`ffc34e3c`): the
two fuzz targets and the op-sequence extension, unfinished and
unchecked.
- `../wb-P11a`, branch `P11a`: the in-app accept of a staged update,
the viewer's notice and "Check for updates", the Windows installer
job, the translocation refusal; all in the checkpoint (`d307fc90`),
compiling, tests not yet run.
**To resume:** for each worktree, read the checkpoint diff, finish the
step with the D-60 checks (compile, fmt, clippy on the touched crates,
the unit's own tests), rebase on `main`, merge; the P11a branch is
pushed for a CI run before merging (the Windows installer job can only
be seen there). Then P12 step 2 (the run: mutation testing crate by
crate, locally per D-59; fuzzing for the owner's hours; property
maxima; `just prove-all`), scheduled on the owner's machine, detached.
**The owner's own items:** run the `release` workflow once from
GitHub's Actions page (the owner's token cannot dispatch it); walk the
app on a Mac and on a Windows machine (P11a's and P11c's last
Done-when); replace `deploy/packaging/icons/512x512.png`; the re-audit
per `docs/runbooks/re-audit.md`; signing when a public release is near
(D-64).
## Now (2026-10-29, night): waves 1 to 3 landed; P11c and P12 left
**Landed today**, each merged with a compile and the unit's own tests