Beagle SCM

BE-038: todo view verb — browse the ticket board from the pager

The /meta/todo board is a tree of StrictMark pages (todo/README.mkd → todo/TOPIC/README.mkd → todo/TOPIC/TOPIC-123.mkd) readable today only outside the pager. Wanted: a read-only todo verb so :todo lists open tickets, :todo GET scopes to one topic, :todo GET-022 renders one ticket — ticket titles, ticket ids and wiki links all click-targets. Per Nav the pager stays arg-blind; the verb routes its arg by SHAPE (bare / TOPIC / TOPIC-123), not by path resolution. Requested by gritzko 2026-07-09.

Input

Context

• Ticket pages live in the meta tree (TODO_ROOT ~/src/journal): board todo/README.mkd, topic todo/TOPIC/README.mkd, thin todo/TOPIC/TOPIC-123.mkd, fat todo/TOPIC/TOPIC-123/README.mkd (/meta/todo); titles are greppable one-liners (grep '^# ' todo/*/*.mkd).
• Hunk tokens already carry click-targets: URIs (U) and verb args spells (O) per Nav; the pager's follow/click resolver dispatches them (BRO-016).
• Nav.mkd once spec'd be.todo_root machinery that was never built (BRO-023); the hive ruling (BE-031) puts wt cells under <meta>/work/, so the meta root (and its todo/) is discoverable from any cell.
• Requested by gritzko 2026-07-09: ":todo — show list of open tickets; :todo URI — those in the topic; :todo URI-123 — one ticket; ticket titles in the list must be clickable; other tickets and wiki pages must be clickable too."

Goals

• :todo (pager) / be todo (CLI) renders the open-ticket board: topics with their one-liner ticket entries, each ticket title a click-target that opens todo TOPIC-123.
• todo TOPIC renders that topic's open-ticket list; todo TOPIC-123 renders the ticket page itself (thin or fat layout, fat = its README.mkd).
• Inside any rendered page, ticket ids ([A-Z]+-[0-9]+ shape) and page links (reflinks like [Nav], relative .mkd paths) become click-targets: ticket ids re-enter todo, wiki/meta pages open as file views.
• Arg shape picks the mode: bare → board, TOPIC → topic, TOPIC-123 → one ticket; a miss errors ONE uniform line (BE-003 spirit, e.g. todo: GET-999: TODONONE).
• Acceptance bar (gritzko 2026-07-09): iterate until tickets are shown NICELY in the pager.

Constraints

• Read-only view verb; no board mutation (open/close/edit stays an editor job for now).
• Todo root not hardcoded: discovered via the hive root (BE-031 <meta>/todo) or configured; tests drive a FIXTURE todo tree, never the live journal.
• Render via the existing hunk/token machinery — no new renderer; StrictMark fidelity may start minimal (headers, bullets, links).
• Repro-first (Issues): red tests against the fixture for board/topic/ticket, then green; suite stays at baseline otherwise.

WIP

Design decisions

• As built (wt work/BE-038): root discovery = be.todoRoot(), probe order $TODO_ROOT (test override) → current wt → launch wt → hive meta root, first dir owning todo/; nothing hardcoded.
• OPEN = curated (orchestrator ruling 2026-07-09, gritzko may override): a ticket is open iff a topic-README BULLET line starts with its key (^\s*-\s+\[?KEY\b); footer refdefs and mid-bullet mentions don't count; todo TOPIC-123 renders regardless; README-less topics fall back to all-files + a visible note.
• Wiki-link clicks (same ruling round): non-ticket .mkd targets splice a U cat <meta-root-relative-path> spell — works when the pager's context tree IS the meta root; cross-tree authority stays a punted ruling. Ticket-file targets splice todo <KEY>.
• Board/topic list rows and topic headers carry hidden U word spells (todo KEY / todo TOPIC); page bodies tokenize via the mkd grammar, key-shaped F/G tokens get the U spliced after.

TODOs

• Fixture todo tree + red tests: board list, topic list, thin ticket, fat-ticket README, TODONONE miss (test/todo/view/, red-first, suite baseline 162/2 known reds + be-js-todo-view green).
• todo verb module: arg shape routing (bare/TOPIC/TOPIC-123), page load, hunk emit (views/todo/todo.js).
• Round 2: open-only filter per the curation ruling (openSet/openTickets, fallback note row); wiki/meta .mkd reflinks clickable (refdefs/targetSpell, NAVESCAPE-confined resolve); fixture legs for both (hidden-closed, README-less topic, wiki U pair). Suite 163/161, same 2 pre-existing reds.
• Click-targets: list titles + topic headers → todo KEY/TOPIC spells; body ticket keys (F + reflink G) → todo KEY; non-ticket .mkd targets → cat <meta-root-rel>; TLV U pairs asserted.
• Pager smoke (orchestrator, pty-driven 2026-07-09): jab todo paints the open-only board, mouse-click on the ABC-005 row navigates to the rendered ticket page (todo ABC-005 in the address bar), q quits clean; :todo typed inside a jab ls view re-enters the board. CLI piped output sane for board/topic/page/miss.

Blockers and bummers

• The hive cell bootstrap (BE-031 layout) hit the BE-036-documented race verbatim; workaround (per-subtree gets, locator re-flip) completed it, BUT the finished cell reports the whole tree mis and be put refuses with PUTNONE — changes sit UNSTAGED in work/BE-038. Deserves its own ticket (GET-041/BE-036 kin, pending gritzko's say-so).
• Miss output stacks todo: X: TODONONE + the loop's JS exception: TODONONE trailer — the known BE-003 class, left alone.

Outcome

• (open — implemented + pager-smoked in wt work/BE-038, UNSTAGED/uncommitted: views/todo/todo.js + test/todo/view/{run.sh,check.js}; staging blocked by the cell's broken put/status; pending gritzko's review, the two rulings above, and land)