Beagle SCM

JS-038 UMBRELLA: bin/get.js — be get as a pure-JS extension

Reproduce native be get as bin/get.js + bin/lib/*, pure JS over JABC (libdog+abc ONLY, no keeper/sniff/graf dog linked), output-equivalent to native across all remotes and change kinds. Validates the wire SDK and extends the JS-027 read-only store reader to the FETCH + write + checkout path.

Input

Context

• JS-027 proved the read side (be/wtlog/keeper/classify/dag/subs/ignore libs).

  be get adds the WIRE fetch, pack INGEST (keeper write side), and CHECKOUT (materialise the fetched tree → wt) + REFS/wtlog append.

• The git-wire conversation lives in keeper/ (unlinkable from JABC), so it is

  reimplemented in JS exactly as status.js reimplemented sniff.

Goals

• be get <remote> parity: same op-summary/banner AND same resulting wt state

  as native, for file://, ssh://(//host), be:// remotes.

• Change-kind parity: new / del / mod, for both files AND dirs.

Constraints

• libdog+abc ONLY; jabc link unchanged. Tests in test/js/get/, reusable

  helpers in test/js/lib/; oracle = native be get. Method: Issues.

WIP

Design decisions

• Native-leaf prereqs: JS-035 zip, JS-036 delta.encode, JS-037 pack ref.
• Children: JS-039 wire+pkt+transport (fetch convo), JS-040 ingest (keeper

  write side), JS-041 checkout + bin/get.js entry. Read libs reused as-is.

TODOs

• JS-039 wire fetch; JS-040 ingest; JS-041 checkout + get.js — DONE

  (main tree, uncommitted). Full-fetch (no haves) ships OFS-only verbatim, so JS-035..037 leaves are NOT on the get path (only push/thin need them).

• Parity matrix GREEN: test/js/get/{file,be,git} × {new,del,mod} ×

  {file,dir} — stdout (time-normalised) + wt content + be status all match native. ctest be-js-get-{file,be,git} 3/3 (be/git gated WITH_SSH).

• Exec-bit / symlink leaves in checkout (no io.chmod/symlink — JS-034 gap).
• ..be.idx wtlog sidecar not written (status works without it; excluded

  from the tree diff as store metadata).

Blockers

• None (the get path is green). JS-035/036 (leaves) land separately.

Outcome

• bin/get.js + bin/lib/{pkt,wire,ingest,checkout}.js reproduce be get

  output-equivalently for file:/be:/ssh-git × new/del/mod files+dirs. Key find (JS-040): native keeper needs the prebuilt <ron64>.keeper.idx (a sorted wh128 run: PACK-summary entry + per-object key=hashlet60|type, val=(off<<24)|(file_id<<4)|1) — a bare .keeper reads unk. Built it byte-identical via pack.scan + abc.book/merge. Tests in test/js/get.

• Uncommitted (human commit gate). ctest be-js-get-* 3/3.