cat/012

Module: the import path is src.rest/cat/012

2026-10-17T16:38:12-06:00

The forge answers go-get for src.rest///... with the repo's https clone, so go install src.rest/cat/012/cmd/012@latest fetches from src.rest. Links to the GitHub repository stay as they are.

Nushell: read the error nu marks with an ASCII x

2026-10-17T16:31:21-06:00

When its output isn't a terminal, nu 0.116 draws the mark before the message as x rather than ×, so Message fell back to the header line, nu::shell::column_not_found, and lost what was wrong. The x counts only after nu's Error: header.

Lint: staticcheck 2026.2.2, which reads Go 1.27.2's export data

2026-10-17T16:28:10-06:00

2026.2.1 failed every package with "export data version 5 is greater than maximum supported version 4" under Go 1.27.2.

CI: make check runs on your machine for src.rest

2026-10-17T16:28:10-06:00

forge attest runs .forge/ci in a clean worktree of each commit and signs the result into refs/notes/ci; forge push sends it with the branch. Build deps (libghostty, stress data) live in ~/.cache/012/deps, outside the worktree, so runs don't rebuild them from source.

Site: build under a path when forge deploys it

2026-10-17T16:15:29-06:00

forge site deploy sets FORGE_SITE_URL and FORGE_SITE_BASE; without them the site still builds for the root of 012.dev.site. .forge/sites declares the docs site so it deploys to https://pages.src.rest/sites/cat/012/docs/.

Docs: make quick for iterating, make check once at the end

2026-09-30T22:11:40-06:00

Testing says what make quick covers and what make check runs at once and alone, that e2e sessions run in parallel and wait rather than sleep, and when a golden screen is captured. The speed gate's section names the timed tests beside it; CLAUDE.md asks for one make check, at the end.

Merge main

2026-09-30T22:10:56-06:00

Check: make quick, the checks of what changed

2026-09-30T22:10:49-06:00

make quick lints and tests the packages changed since the branch left main (or PKGS), runs the oracle when it changed, and the e2e tests and golden screens defined in changed e2e files, or all of e2e when the harness changed or with E2E=1.

Site: the hero leads with the first-steps recording

2026-09-30T22:10:49-06:00

Check: lint, tests, oracle and e2e at once, then timed tests alone

2026-09-30T22:10:48-06:00

scripts/check.sh runs make lint, test, oracle and e2e together, each into a log printed whole with its time when it ends, then make speed on its own. The tests that time frames against fixed bounds (TestSharedEditWithinAFrame, TestStreamGridAtFrameSpeed, TestScrollsAtFrameSpeed) move from make test to make speed beside the speed gate, so none of them shares the CPU with the e2e sessions.

Lint: the checks run at once, vet once with the stress tag

2026-09-30T22:08:46-06:00

scripts/lint.sh starts gofmt, vet, staticcheck in each module, the shape limits, the tracked-file check, doclint and doccheck together and prints each one's findings whole when it ends. go vet -tags stress sees every file plain vet does, so make lint runs it alone and make check no longer vets twice. File sizes are read with one wc rather than one per file. Given directories, the Go checks look only at them.

E2E: sessions run in parallel, golden screens wait to match

2026-09-30T22:08:22-06:00

Every session is its own process, pty, temp directory, config home and fake services, so the tests and the golden screens' subtests call t.Parallel and run up to GOMAXPROCS at a time. TestScreens stays serial at the top, so TestStills reads the goldens it has just written under -update, and TestStressKeyLatency stays serial as it times keys. A screen is captured once it holds still and shows its golden, or after five seconds of not showing it: nu's highlighting can reach a busy screen after two captures matched, which parallel runs exposed.

Site: a sidebar per section; the homepage drops its headline; A1 holds a short label

2026-09-30T22:08:18-06:00

The navbar picks a section and the sidebar lists that section's pages, so the two no longer show the same list. The hero's headline and the page title's tagline go (the logomark names 012; a hidden h1 keeps the outline), and the install line is the install script.

File fixtures: v0.8.0

2026-09-30T21:52:41-06:00

Docs: the recordings show charts as the sixel images 012 draws

2026-09-30T21:45:36-06:00

VHS's xterm.js has its image addon on, and its recordings include the images, so the notes saying they show only the text chart were wrong.

HTML export: pages and views embed JetBrains Mono

2026-09-30T21:45:16-06:00

The same font as the docs, their pictures and the site, in place of IBM Plex Mono: regular, semibold and italic, Latin subset, from @fontsource/jetbrains-mono 5.3.0. The binary grows by 16 KB.

Site: the navbar lists the docs' sections, and the landing page leads with what 012 is

2026-09-30T21:26:00-06:00

The navbar has Getting started, Sheets, Formulas, Files, Nushell, Agents and Terminal, and Reference as a menu of its pages, sized to fit down to the width Docusaurus collapses it at. The landing page's control panel lists the same sections, so the navbar leaves them to it there. The hero heading says what 012 is rather than repeating the name the logomark shows, the title's cursor is gone so the control panel's is the only one, and A1 at rest holds a link to the guides.

Docs media: the recordings in JetBrains Mono and their pages' color schemes

2026-09-30T21:24:45-06:00

Rendered again with make demos. layout.gif and sources.gif are reduced to 32 colors to stay under 1 MB.

Pictures: one font, JetBrains Mono, and color families by page

2026-09-30T21:03:00-06:00

Every picture of 012 is set in JetBrains Mono, VHS's and Ghostty's default: the stills draw from the TTFs in e2e/testdata/fonts (Go Mono only for characters it lacks), make demos serves ttyd's page with them added so VHS needs nothing installed, and the site bundles @fontsource/jetbrains-mono, with the system's sans for body text. The pictures' colors are families of a dark and a light scheme, listed in site.md with the pages each covers: Catppuccin, Tokyo Night, Rosé Pine, GitHub, Gruvbox and Nord. Stills draw their golden's palette in their family's schemes with each cell held to 012's contrast minimums; tapes set their scheme and make demos runs 012 with that theme. TestPictureSchemes checks the schemes' contrast, and doccheck that each page's pictures are in its family.

Themes: a scheme named exactly wins over looser matches

2026-09-30T21:02:28-06:00

"tokyonight" found TokyoNight, the first case-insensitive match, where VHS's Set Theme takes the scheme of that exact name.

File fixtures: v0.7.0

2026-09-30T20:32:48-06:00

Notes: the hover box keeps clear of the status line, as the error box

2026-09-30T20:19:33-06:00

Both boxes are placed beside their cell by one helper, besideCell, which moves a box up rather than over the status line. A golden screen hovers a note on the last row shown.

Demos: the sources recording reads a grouped count, a date and a MEDIAN

2026-09-30T20:17:02-06:00

The tape's formulas on Sheet1 are a ROWS, an AVERAGEIFS, the last day and a MEDIAN of ten million amounts, typed quickly so the GIF stays under 1 MB.

Formats: inferring one allocates no closure per formula

2026-09-30T20:06:06-06:00

The speed gate's chain and running recalculations allocated a closure for each formula and each operand to infer their format; the sheet keeps its paged test once per recalculation and InferFormat recurses directly.

Docs: the sources' formulas picture shows a working MEDIAN, formats and F1

2026-09-30T20:04:50-06:00

The trips' fares are a DECIMAL(12,2), so the still shows sums with cents, counts grouped, the last day as a date, the median and 90th percentile answered, and a second still the explanation F1 opens over a STDEV past max-cells. Golden screens add the cut context line at 80 columns and the box in the high-contrast theme; an e2e test reads a cut explanation at 60 columns through F1. sources.md lists the order statistics and ranks that stream.

Sources: MEDIAN, PERCENTILE, QUARTILE, LARGE, SMALL and MODE stream

2026-09-30T19:53:02-06:00

An order statistic of one range of a linked source no longer holds the column: the job streams its numbers into the external merge sort a Parquet view's sort uses, made generic over its records, in runs of a million numbers spilled to temporary files, and reads them back in order once. RANK counts as it reads. Both work alike for Parquet and SQLite, where ORDER BY with OFFSET took 19 s on ten million rows. On ten million rows MEDIAN takes 1.7 s (Parquet) or 2.8 s (SQLite) in 50 MB, against 248 MB held; answers are kept as other questions'.

Functions: PERCENTILE, QUARTILE, their .INC and .EXC, MODE.SNGL and RANK.EQ

2026-09-30T19:43:43-06:00

MEDIAN, MODE, LARGE, SMALL and the new percentiles read their numbers once in ascending order through one interface (Sorted), held and sorted on a sheet, so a Book can hand them out sorted some other way. RANK counts above and below as it reads rather than holding the range. Excel's _xlfn. prefix is written for the dotted names.

Sources: results over a column keep its format; counts show grouped

2026-09-30T19:39:29-06:00

Formulas over a linked source infer their format from the column's type, as they do from a sheet's cells: SUM, AVERAGE, MIN, MAX and lookups show a DECIMAL's decimals, a date, a timestamp, a time or a duration. Counts over a source show as whole numbers with thousands separators. Parquet DECIMAL columns carry their scale's decimals and INTERVAL columns read as durations; SQLite's declared TIME, DECIMAL(p,s), NUMERIC(p,s) and MONEY map to formats.

Errors: an explanation too long for the context line says the rest on F1

2026-09-30T19:35:27-06:00

The context line cuts a long error explanation at the last sentence that fits, with an F1 chip; F1 shows it whole in a box beside the cell (or on a source's tab, why it can't be read). F1 elsewhere still opens the shortcuts. The max-cells message over a source leads with the remedy: raise max-cells to N, then what it is and what streams instead. A test holds every explanation at 80 columns to being whole or readable with F1.

Merge branch 'main' into worktree-agent-a44969b7ca50f8b04

2026-09-30T08:41:00-06:00

# Conflicts: # website/package-lock.json # website/package.json