BRO-030: unified quad status reporter (track·base·patch·wt vs root)

Now: DONE

Input

Context

File status and divergence reporting is a per-verb zoo: status prints /wiki/Dirty nouns, PATCH prints applied/merged/mod/conflict (/wiki/PATCH §Reporting), GET/POST print their own rows, and ahead/behind is a separate post/miss listing. The unified model is specced in /wiki/Status: per path a quad of relations . X + ↑ — columns track/base/patch/wt, each vs root = LCA(track, base) — colored blue/green/yellow/orange; bold = staged, red = conflicted; commit ahead/behind uses the same relations one level up.

Goals

One reporter module renders quad rows; every verb report (status, get, post, patch) emits through it, and the old vocabularies retire everywhere at once.

status shows a quad for every non-.... path plus commit divergence in the same vocabulary.
get/post/patch reports are the transitions they produced — same table, same renderer.
Position is authoritative, color/style decorative: the | cat path stays fully readable uncolored.

Constraints

The spec is /wiki/Status; on any conflict the wiki wins.
This ticket is the REPORTING side only; the classifier input side is DIS-057 / /todo/STATUS/STATUS-013 ground.

WIP

Design decisions

Root = LCA(track, base); track/base/patch columns relate to ROOT.
RULED 2026-07-17: the wt column relates to BASE (the local-dirt axis) — a committed change is .v.., never .v.v; only uncommitted work lights the 4th char.
Chars . same, X removed, + created, ↑ advanced; columns blue/green/yellow/orange; bold staged, red conflicted.
Detached wt: track = the pinned hash, root = LCA as usual; no common ancestor = broken tree, refuse — never rendered.
Quad tok tags (2026-07-17, after the green-wt bug — I/J/O/K are diff-side BACKGROUNDS in the pager palette): the extension codes 26..31 ([ \ ] ^ _ <backtick>) = track/base/patch/wt glyph colors + staged-inverted + con-inverted.
Render (ruled through 4 iterations 2026-07-17): tty glyphs ● created / ∅ removed / ↑ advanced, and ✔ for a COMMIT row's o ("present in this line" — never the file ●); the GLYPH carries the column truecolor (blue/green/amber/orange RGB — 256-cube orange too muddy); staged wt INVERTS (color bg, RGB-white fg — basic 97 is theme-remappable), con inverts to red; plain stays the .xov canon; no bold, digit-counts idea DROPPED.

TODOs

the reporter module: shared/quad.js (ULOG columns, k-way merge, LCA root, commit quads) + view/quadrender.js + theme.QUAD_SGR; unit test test/quad/model.js green (in work/BRO-030)
collapse rule: patch column = newest-wins union over the absorbed theirs trees (later wtlog row shadows)
mov/rmv pairing: the dst row's path column spells src#dst (quadrender.fileRow)
degenerate roots: detached → track=pin; no-LCA → throw "broken tree"; track-less → track:=base
ASCII canon RULED 2026-07-17: plain = .xov, staged wt char UPPERCASE, conflict !; tty may use Unicode (✗ + ↑) + bold/red — model+renderer+model-test converted
wire the verbs behind --quad: status / patch / post / get all landed green, one e2e test each
QUAD IS THE DEFAULT (ruled 2026-07-17): all four sweeps landed — ~40 cases converted, every quad derivation matched observation; the sweeps caught /todo/PATCH/PATCH-014 and a stale-glyph behind/ahead miscount in status.js (fixed)
row deban (RULED: wiki/PATCH, bangs retired): patchRowUri writes ?<sha> (no !); 8 WHOLE goldens debanged; arg-side alignment split to PATCH-015
the default flip LANDED in all four verbs: gates dropped, legacy emission deleted (status ROW_ORDER/divergence/summary zoo, patch applied/merged banner, post legacy banner, get checkout rows + sub relay); status also landed the tok-span sink integration (per-char column tags Y/W/E + new I orange / J bold-orange / M red, U nav, put/del buttons)
full suite: 71/75 run.sh green + all units; the 4 reds are pre-existing (bro/color, bro/view, dag/remoteindex fail identically in a pristine clone; get/http is a parallel-port flake, green serial)
the detached-post report shows no .o.. commit row (track=pin) — keep a fallback confirmation row? needs a ruling (pinned in test/post/file golden meanwhile)
detached-wt post report has no commit row (track=pin) — legacy confirmation row gone; keep a fallback row? needs a ruling
point /wiki/Dirty at /wiki/Status once the flip lands

Blockers and bummers

The patch sweep exposed /todo/PATCH/PATCH-014: WHOLE-scope ?<sha>! rows were invisible to refOf/patchTheirs (blank patch column); read-side fix landed in the worktree, verified.

/todo/STATUS/STATUS-009 (status ignores the track-vs-base split) and /todo/STATUS/STATUS-012 (miss shown for an absorbed commit) sit on the classifier side and gate correct quads.

Migration leftovers found by the work/PATCH sweep 2026-07-17 (fixed there): patchcase.sh _jstatus still parsed 3-char nouns (emptied every status golden section), 8 goldens never regenerated, report-arms asserted retired words; plus two PATCH.mkd rulings applied late — conflict exits non-zero, patch stages nothing (no sub gitlink put bump).

Outcome

All work sits UNCOMMITTED in work/BRO-030 (per the no-VC-ops rule) awaiting inspection/merge: new shared/quad.js, view/quadrender.js, test/quad/model.js; modified shared/wtlog.js (PATCH-014 read fix), verbs/{get,patch,post}, views/status/status.js, view/theme.js, test/CMakeLists.txt (+quad/model), ~45 test files converted to the quad default.