Text column edges

Feature plan: Step 1 · Step 2 · Step 3 · Step 4

Debug mode: enabled (debug log)

Effort study: railspike-effort / v3/guestbook; host ledger. Standing P2 enrollment.

Extended estimates: enabled

Status: Step 4 Stages 1–4 complete on branch guestbook; Stage 5 (release) pending maintainer. Planning commit 42e32181.

Cycle estimate: 0.60

Step 4: Implementation Summary — Guestbook

Step 4 Entry

2026-11-14: Step 3 projection 0.60 reaffirmed before implementation; scope v2, revision b0b706d3, R1 not re-verified, Claude single exposed rater. Stage originals copied from Step 3: S1 0.15, S2 0.12, S3 0.18, S4 0.08, S5 0.05.

Stage 1 - Book page lists entries

Original estimate: 0.15 Retrospective: 0.15

  • Changes:

    • FORUM_GUESTBOOK_ENABLED in FeatureFlagRegistry.php (Experience group, default on) and the two flag lists in FeatureFlagEvaluatorTest.php.

    • guestbookThread in each site profile entry of SiteProfileRegistry.php (null for zenmemes until the thread exists), guestbookThread() and its validation.

    • GuestbookPageController.php and templates/pages/guestbook.php; the /guestbook/ route and application-route entry in Application.php.

    • tests/GuestbookPageTest.php, registered in tests/run.php.

  • Verification:

    • ./v3 test --smoke GuestbookPageTest FeatureFlagEvaluatorTest: 449 passed (the guestbook class was not registered on that run); ./v3 test GuestbookPageTest: 3 passed after registering it. Full suite not run.

    • Covered: oldest-first order, page stability after a new entry, nested replies left out, any page of a spread shows that spread, retraction, empty book, missing thread, out-of-range and malformed pages, flag off, no thread configured.

  • Notes:

    • Deviation: a URL page addresses a two-page spread by its left page (?page=1 shows pages 1 and 2); no page means the newest spread. PageNavigation::numbered treats no page as page 1, so the controller builds its own links and reuses only pageNumber().

    • Deviation: the flag defaults on; the page stays off until a site profile names a guestbook thread. Release then needs only the profile entry.

    • Three entries per page. Each entry carries entry_reply_count (all replies under it) for Stage 4.

  • Estimate details: original scope as planned; no revision.

— Claude · 2026-11-14 UTC · Model: claude-opus-5-5

Stage 2 - Sign the book

Original estimate: 0.12 Retrospective: 0.14

  • Changes:

    • templates/pages/guestbook.php: the newest spread's right page carries the shared reply form ("Leave a note for whoever reads this next", "Sign the book", parent = thread root, return_to = /guestbook/). Earlier spreads link to /guestbook/#sign.

    • GuestbookPageController.php: loads the signing and Outbox scripts the thread page uses.

    • ComposeAndAccountKeyController::resolveComposeReplyReturnTo: returns to /guestbook/ only for a reply to the active site's guestbook thread; any other thread still returns to itself.

    • tests/browser/guestbook.mjs and tests/Support/guestbook_browser_router.php (the fixture's root-001 thread as the guestbook).

  • Verification:

    • ./v3 test --smoke GuestbookPageTest ComposeAttemptReplayTest: 468 passed. Full suite not run.

    • New testSigningTheBookFromTheLastPageReturnsToIt: form fields, scripts, earlier-spread link, no-JS POST returns to the book, and return_to ignored for another thread.

    • node tests/browser/guestbook.mjs: passed. Signs with JavaScript at 390 px and without it at 1280 px; both land on /guestbook/?created_post_id=…, and both entries show in the thread.

  • Notes:

    • The client already honors return_to for replies (canonicalReplyUrl), so no script changed.

    • The book's form is not an inline thread composer, so the thread's optimistic reply insertion does not run there.

    • Retrospective slightly above the original: the browser fixture needed its own router to name a guestbook thread.

  • Estimate details: original scope as planned; no revision.

— Claude · 2026-11-14 UTC · Model: claude-opus-5-5

Stage 3 - Paper look

Original estimate: 0.18 Retrospective: 0.20

  • Changes:

    • public/assets/guestbook.css, loaded only on the book through TemplateRenderer.php with compose.css. Cream lined pages, a spine shadow, a dark cover edge, italic dates and page numbers, a handwriting-style signature.

    • The book sets the theme's color and font properties for everything inside it, and outranks the themes' :root link, field and button rules. It keeps the same paper in every theme.

    • Two facing pages when wide; the book widens past the 760 px reading column to fit them. One column on phones.

    • Page turns moved inside the book, as a footer row on the paper, and render only when there is somewhere to turn. "Latest page" shows only when it differs from "Later pages".

    • Long entries grow their page; images, tables and code stay inside the page width.

    • tests/browser/guestbook.mjs extended: five more entries (a 2,000-character note, a table), then 17 themes at 390 px and 1280 px with JavaScript, and Light without it.

  • Verification:

    • node tests/browser/guestbook.mjs: passed. In every case: paper and ink colors, no sideways scroll, facing pages only when wide, entries inside the book, both the newest and the first spread.

    • Screenshots at 390 px and 1280 px compared with the mockup: same structure and palette.

    • ./v3 test --smoke GuestbookPageTest: 453 passed; AssetFingerprintTest: passed. Full suite not run.

  • Notes:

    • Deviation: no web fonts. EB Garamond and Caveat would be new third-party assets, which need approval under CONTRIBUTING.md. The book uses local font stacks: Garamond, Palatino or Georgia for text; Segoe Print, Bradley Hand or Comic Sans for signatures. Machines without them fall back to serif or cursive.

    • On phones a spread shows both pages one above the other, so a phone shows up to six entries per screen of pages.

    • The shared composer keeps its ··· menu and Options row in the book.

  • Estimate details: original scope as planned; no revision.

— Claude · 2026-11-14 UTC · Model: claude-opus-5-5

Original estimate: 0.08 Retrospective: 0.08

  • Changes:

    • TemplateRenderer.php: every template gets siteGuestbookThreadId, the guestbook thread while the flag is on.

    • templates/pages/thread.php: "Open as a book" above the root card, on the guestbook thread only.

    • templates/pages/about.php: "Sign the guestbook" in the intro section.

    • templates/pages/guestbook.php: "Open as a thread" in the book's footer row (which now always shows); "n replies" under an entry links to that entry in the thread.

    • docs/concepts/guestbook.md: new concept page.

  • Verification:

    • New testBookThreadAndAboutLinkToEachOther: both links, the count of every reply under an entry, no count on an entry without replies, the thread still showing replies, no link on another thread, links gone with the flag off.

    • ./v3 test --smoke GuestbookPageTest AssetFingerprintTest: 456 passed. PostSignalsTemplateTest MediaEmbedBeaconTemplatesTest TemplateRendererMediaEmbedsScriptTest AppNavigationPlacementTest LocalAppSmokeTest: 192 passed. Full suite not run.

    • node tests/browser/guestbook.mjs: passed.

    • Static build: scripts/build_static_artifacts.php on the fixture with FORUM_STATIC_DETAIL_PAGES_ENABLED=true and root-001 as the guestbook; the baked threads/root-001.html carries "Open as a book".

  • Notes:

    • The thread page's link is baked into static files, so turning the flag on or naming the thread needs a rebuild before the link shows there. /guestbook/ itself is rendered per request, like /gallery/.

    • No navigation destination was added, so theme-nav-icons.css is unchanged.

  • Estimate details: original scope as planned; no revision.

— Claude · 2026-11-14 UTC · Model: claude-opus-5-5

Stage 5 - Release on zenmemes.com

Original estimate: 0.05 Retrospective: pending

  • Status: pending maintainer. Needs the PR merged and deployed, a "Guestbook" thread on zenmemes.com, its ID in the zenmemes profile's guestbookThread (one line, small PR), and a static rebuild for the thread page's link.

  • Verification: pending. Ilya signs on his phone and a wide screen; Claude signs once with Quill.

Final Review

  • Final diff review of 42e32181..HEAD: passed. Retracted entries and hidden posts stay out of the book; replies under a retracted entry stay in the thread; return_to can only reach the book from the guestbook thread; other site profiles have no guestbook.

  • Checks run: smoke set plus touched classes at each stage, tests/browser/guestbook.mjs, and a static build. Full suite not run.

  • Unverified: Stage 5's production check on Ilya's phone and wide screen; signing on production with Quill.

  • Commits: planning 42e32181, then one commit per completed stage (Stages 1–4). Stage 5 waits on deployment.

Cycle Closeout

  • Retrospective scope assessment: Stages 1–4 delivered as planned, with the deviations recorded per stage (spread addressing, flag default on, no web fonts). The cycle total so far reads as 0.60; Stage 5 is still pending.

  • Maintainer comfortable-fit judgment and study acceptance: pending.

— Claude · 2026-11-14 UTC · Model: claude-opus-5-5