Beagle, a source code management system that stores AST trees

Source: Hacker News

Beagle SCM

Beagle is a source code management system that stores AST trees, not binary blobs.
The general idea is a database for the code as a hub of all code‑related activities and storage for all the related data (tickets, CI results, etc.).

The backing store can be virtually any key‑value database (RocksDB as of now).
The data format AST BASON is CRDT‑ish.

Beagle is early‑stage and experimental. It hosts itself; the rest is not guaranteed. Use at your own risk.

Further reading

• Design rationale
• Branching and storage model
• BASON, cheap mergeable binary JSON

Examples of use

# Initial POST of a project. We specify repo, project path.
# Absence of http: or ssh: makes it local to the store in $HOME/.be
$ be post //replicated.live/@gritzko/librdx
...
OK   h    ast/tree-sitter/point.h
OK   h    ast/tree-sitter/parser.h
OK   c    ast/tree-sitter/query.c
OK   text ast/verilog/LICENSE
...million more lines...

# Inspect RocksDB inners just out of curiosity.
$ ls $HOME/.be/replicated.live/
# Inspect worktree/repo state
$ cat .be
//replicated.live/@gritzko/librdx
$ be
repo: replicated.live
project: /@gritzko/librdx
branches: *main
base files: 574, waypoints: 0

$ cd /some/other/dir
$ be get //replicated.live/@gritzko/librdx
...a million lines...
OK   h    rdx/test/YX.h
OK   h    rdx/test/ZE.h
OK   sh   rdx/test/http-test.sh
OK   sh   rdx/test/query-test.sh
OK   sh   scripts/ci-fast.sh
$ cd librdx
$ be
repo: replicated.live
project: /@gritzko/librdx
branches: *main
base files: 574, waypoints: 0