Plate № 45 · Editorial & presentation · records-lane model
A pattern from the gf.cx specimen book · session-notes-standard v0.0.3
The session-notes lane, standardised
"Every series of nits eventually creates a pattern." … "So once we resolve nits it becomes a pattern-standard."
The problem
Most surfaces grow a running lane of working notes — what happened, what's blocked, what's owed next. Left to each surface, that lane drifts three ways at once: it gets hand-edited into the HTML (so appending a note means touching markup and re-deploying); its per-note styling wanders (one page bolds the title, another doesn't; one wraps to two lines, another runs inline); and its section headers sprout a clickable # permalink that, on a phone, steals the first tap so opening a note takes two. A lane copied by hand onto ten surfaces is ten lanes to keep in sync — the opposite of a system.
The standard — v0.0.4
One shelf file, session-notes.js, renders the lane from a per-surface JSON. Drop a placeholder and a script; append notes by editing the JSON, never the HTML. The rules the nits settled into:
- JSON-driven, single source. A note is
{ date, tag, title, lede, bullets:[{ h, body, flag }] }, newest first, authored in light-markdown (**bold**,_em_,`code`,[label](url)links, andimages). The parser splits out`code`spans and is word-boundary-aware, sosnake_casepaths survive un-mangled. - Inline images, capped. A bullet or lede can carry
(same-origin/pathor http(s)); it renders as a lazy<img>capped at 360px, so a graphic — a rendered asset label, a small chart — sits inside a note without blowing to full column width (session-notes.js v0.2.9). - Each note a collapsed accordion. In accordion mode the lane opens expanded while every note renders folded to its header — skim the list, open only what you want. The disclosure marker is the shared left bird-beak ▸/▾.
- A two-line header, always. The mono date/tag line sits on top; the title drops to its own full-width line beneath it — every time, regardless of length, so the lane never renders half one-line and half two (session-notes.js v0.2.7).
- The title is normal weight, not bold. The mono date/tag line and the two-line layout already separate the title; the bold was noise (v0.2.8). Emphasis is reserved for a flagged bullet (
flag:true→ amber). - Every note deep-linkable, with the visible
#purged. The lane and each note carry a stableid, so…/#session-notesscrolls to it, opens it, and pulses it on arrival — while the visible#chip is hidden portfolio-wide. Visibility can be null and the anchor's use fully retained within URLs (section-anchors.js v0.6.0; v0.7.0 stops a script-opened panel rewriting the arriving URL). It also removes the phone double-tap: an invisible chip is no longer sitting in the summary catching the first tap. - An empty lane removes itself. Zero notes → the whole block is dropped, not shown as an empty framed strip. The lane appears only when it has signal.
Author it as
<!-- once, near the bottom -->
<div data-session-notes
data-src="/lto/session-notes.json"
data-accordion></div>
<script src="https://assets.gf.cx/session-notes/session-notes.js"
data-cfasync="false" defer></script>
<!-- the deep-link chip. The lane is .sn-notes[id] and each note is
.sn-note[id] — NOT the section[id] default; name them here or the
"#" anchor silently no-ops. A ledger.js page wires this itself. -->
<script src="https://assets.gf.cx/section-anchors/section-anchors.js"
data-select="section[id], .sn-notes[id], .sn-note[id]"
data-cfasync="false" defer></script>
Two gotchas the lane inherits from the page, not the shelf — both fail silently. (1) The surface needs a house h2 { font-family: var(--serif); font-weight: 400 } rule: the lane heading is an <h2>, so a page missing that rule renders "Session notes" in the browser-default bold sans, not the house serif. (2) section-anchors.js must name .sn-notes[id] in data-select — its section[id] default doesn't match the <details class="sn-notes"> lane, so the deep-link anchor never attaches. Both surfaced adding the lane to status.gf.cx/models, 2026-09-17: placeholder + script alone got a bold-sans heading and no anchor.
Append a note by editing /lto/session-notes.json — nothing in the HTML changes:
{ "notes": [
{ "date": "2026-09-11",
"tag": "idea · hardware · replacement",
"title": "Replacement path if the RMA stalls — read its power-on hours first",
"lede": "A pulled Quantum LTO-6H SAS drive runs ~$330 used.",
"bullets": [ { "h": "Verify", "body": "Demand the `sg_logs` hours report", "flag": true } ] }
] }
Where it applies
Reference implementation: vault.gf.cx/lto — the LTO-6 tier's notes lane, two-line non-bold notes, deep-linked at #session-notes with no visible chip. The same shelf drives the status.gf.cx storage pages, so every surface's notes lane reads identically. The lane is the running-journal companion to the ledger page model (plate № 42): the ledger folds a page's sections; this folds its notes, harmonised to the same bird-beak.
Reusable elements
assets.gf.cx/session-notes/session-notes.js— the whole lane: markup, the light-markdown parser, accordion mode, the two-line non-bold header, the lean empty-removal. Edit here, every surface follows.<div data-session-notes data-src="…" data-accordion>— the placeholder.data-collapsedfolds the lane closed-on-open;data-beakswaps the header marker for a chevron on chevron surfaces.assets.gf.cx/section-anchors/section-anchors.js— deep-links with zero visible chrome: the section keeps its id, arrival opens + pulses it, opening reflects its#viareplaceState, and the chip isdisplay:none. The general "visibility null, use retained" move.- Pairs with ledger.js — one expand/collapse-all control that includes the notes lane and its notes.
Reference
- Version
session-notes-standard v0.0.4— v0.0.1 codified 2026-09-11 from the vault.gf.cx/lto nit run (two-line header, normal-weight title, purge the visible#); v0.0.2, 2026-09-12, adds inlineimages (session-notes.js v0.2.9), first used for the LTO 2×1 asset-label render; v0.0.3, 2026-09-17, completes the authoring recipe — thesection-anchors.jsline plus the two silent gotchas (househ2rule,.sn-notes[id]indata-select), from wiring the lane onto status.gf.cx/models; v0.0.4, 2026-09-18, extends deep-linking from the lane to EVERY NOTE —session-notes.js v0.3.0slugs each note from its title (falling back to date+tag), so a note has a readable id like#session-notes-hmpo-confirmed-receipt-of-the-old-passport. Ids ship everywhere at once; the chip needs.sn-note[id]indata-select, whichledger.js v0.7.0now wires automatically. Paired fix:section-anchors.js v0.7.0only reflects an opened panel into the URL on a real click — script-opened panels (the async lane, expand-all) were overwriting the visitor's anchor.- Source
- Dan, 2026-09-11 — "every series of nits eventually creates a pattern"; "once we resolve nits it becomes a pattern-standard."
- In use / example
- vault.gf.cx/lto · the status.gf.cx storage pages.
- Reusable elements
session-notes.js·<div data-session-notes>placeholder ·section-anchors.js(chrome-less deep-links) · pairs withledger.js.- Build cost
- One placeholder
<div>+ one<script defer>; append notes by editing one JSON. The shelf caches portfolio-wide; a style or behaviour change propagates from the one file.