Beagle SCM

DIS-071: the track-URI model — a worktree tracks the URI it last get from, not a bare branch string (umbrella)

worktree (AUTHORITATIVE; it replaced the deleted trees.mkd, of which only img/trees.jpg survives) gives a worktree exactly two parameters — the URI it tracks and its base commit — and RULED 2026-07-15 (gritzko) pins the four laws: (1) you track the URI (branch, remote or worktree) you last get from; (2) bare get and bare post imply that URI; (3) every get/post record carries the base hash in its fragment; (4) a submodule tracks the parent's pin, addressed by the child worktree's local URI //WT/path/to/sub. be/ JS models track as a bare branch STRING: every get record strips the authority (get.js:185,242,520), refOf adopts a branch from LOCAL rows only (wtlog.js:52-55), and tip() walks back PAST a remote row to keep the last local branch (wtlog.js:116-127) — a remote or worktree source is unrepresentable and survives only in row 0's store anchor. The wiki codifies the same narrowing (Worktree:7,12, POST:48). This umbrella carries the ONE row grammar //WT/path?branch#base — wt, sub and remote recorded identically; the children carry the concrete defects.

Input

Context

Track is a branch string at every layer — records, readers and wiki alike; the URI never reaches the wtlog.

• RULED 2026-07-15 (row shape): every get/post record IS the full context URI //WT/path/to/sub?branch#base; row 0 stays the store anchor.
• RULED 2026-07-15 (detach): a bare post does NOT detach a branch-tracking wt — track stays, base moves, the wt reads "ahead" (worktree:29-33).
• RULED 2026-07-15 (detach, cont.): only pin/hash tracking detaches on its own commit — a pin has nothing to advance.
• RULED 2026-07-15 (nesting): //WT is flat — the worktree owning the tree plus the whole path (//ABC-123/lib/abc/dog), never a per-mount worktree name.
• Every get record drops the authority — URI.make(undefined, undefined, undefined, branch, tip) at get.js:185, 233, 242, 482, 494, 504, 520.
• wtlog.attachedBranch returns {branch, detached, rawQuery, sha} — no host slot (wtlog.js:141-156); refOf's local gate refuses a remote row's branch (wtlog.js:52-55).
• Remote-tracking lives in the refs ULOG instead (//host?br#sha, store.js:462-478 eachRemote) with nothing tying a worktree to it.
• DIS-061 is STALE-superseded here: its trees.mkd authority is deleted, its pin-reflection ruling dies with the pin-branches; live defects refiled as DIS-072/DIS-074/DIS-076.

Goals

One grammar, one reader, one implied target — the whole track/base system, per worktree.

• ONE row grammar for every source: //WT/path?branch#base — a wt, a sub and a remote parse and record identically.
• track = the URI of the recentmost get record, authority included; base = the fragment of the recentmost get/post record.
• Bare get/post resolve their target from that track URI — not from a branch string, not from the trunk (DIS-073, DIS-074).
• Commit and branch-advance stay SPLIT (carried from the stale DIS-061): post 'msg' moves the worktree only (DIS-076).
• Wiki sweep: Worktree:7,12, POST:5,48, GET:37-40 and URI gain the track-URI model; the 11 files citing the deleted trees.mkd are re-pointed at worktree.

Constraints

Read-compat is forever and the codecs own the parsing; the children land independently.

• Old rows must keep parsing untouched: ?br#sha, the legacy ?br&sha &-chain, and the absolute ?/proj/br shape — no on-disk wtlog rewrite, ever.
• URI/branch codecs only (/meta/abc, memory law): no indexOf/slice surgery at call sites; track parsing routes through uri.js + branch.js.
• Large behavioral change: inventory the be/test/ legs assuming a branch-only track; amend only with explicit permission (/meta/work).
• Repro-first per the norms; this ticket owns the model + the wiki sweep, the children own the code.

WIP

Design decisions

• The four laws are RULED (2026-07-15); the row grammar is settled, the reader shape is not.

TODOs

• repro: get //OTHER?br#sha, then bare get — track must be //OTHER, not the last local branch
• wtlog: ONE track reader returning the whole URI (authority+query+fragment); attachedBranch folds into it
• get: stop stripping the authority at all seven record sites
• wtlog: drop refOf's local branch gate + tip()'s remote walk-back
• wiki sweep (Worktree, POST, GET, URI) + trees.mkd cite purge (11 files under todo/)
• test inventory: legs pinning a branch-only track; request the user for amendments
• children: DIS-072 subs, DIS-073 bare get, DIS-074 bare post, DIS-075 detach shape, DIS-076 commit/advance split

Blockers and bummers

• (none — the four rulings of 2026-07-15 make it actionable)

Outcome

• FILED 2026-07-15 (track/base audit of be/ against worktree); nothing landed yet.