rgBuilder v0.4.6

rgBuilder v0.4.6

This release lands the refactor branch: faster CFG and semantic indexing, a first-class agent skill installer, dashboard export work, and a new set of step-by-step guides on the website (CoolStore walkthroughs for every major CLI feature).

Guides on the website

Start here — practical how-tos with a shared CoolStore (konveyor-ecosystem/coolstore) example:

https://shaaf.dev/rgBuilder/docs/guides/

Guide	Command
Discovering and Indexing	discover
Graph Query Language	gql
Blast Radius Analysis	blast-radius
Semantic Search	semantic
Graph Metrics	metrics
Community Detection	communities
Program Slicing	slice
Hybrid CPG	cpg
Inspecting CFG, PDG, and Dominance	inspect
Exporting Graphs	export
CI Policy Checks	check
HTTP Server and Dashboard	serve
Migration Planning	discover --export-migration-hints
Agent Skill	install --skill

Also: User Guide · JSON API · Docs hub

Highlights

Agent skill installer

rg-build install --skill copies the bundled skills/rgbuilder/ tree (embedded in the binary at compile time) into the target repo:

• <repo>/.claude/skills/rgbuilder/
• <repo>/.cursor/skills/rgbuilder/

Default --host all; --host claude or --host cursor to limit. Identical files are left unchanged; differing files require --force. -f json reports each write (created / unchanged / overwritten / skipped_exists).

rg-build install --skill
rg-build -r /path/to/repo -f json install --skill

No git checkout of rgBuilder is required — a GitHub Release binary is enough.

Semantic search: vocab by default, parallel index

• rg-build semantic index uses the compiled vocab embedder unless you pass --embedder code-daemon or --embedder hash.
• Index build is parallel on CPU/I/O-bound stages (batched embed, body reads, ONNX session.run with batch 32 and fallback). The on-disk index is still one bincode write at the end.
• Distill / Hamming fusion path is aligned with the vocab matrix (v2).

Faster --with-cfg discover

• One parse per file: CFG work is grouped by source file. Each Rayon task parses that file once, then builds every function’s CFG from the same tree. Cache hits still skip parse.
• Faster dominators: reverse postorder + dense Cooper–Harvey–Kennedy Vec<u32> idoms. Public DominatorTree maps stay HashMap<BlockId, …>.
• No CFG/PDG deep clone into the archive: FunctionAnalysis / CfgPdgRecord share Arc<ControlFlowGraph> and Arc<ProgramDependenceGraph>. Wire format is unchanged (serde rc).

Linux kernel cold discover (default flags, no CFG) remains inside the 170s +10% gate on the maintainer machine (~146s wall, ~2.66M nodes).

Dashboard export

Streaming/export helpers for analysis, blast, dataflow, function metrics, taint, and source catalog — less overhead when building the optional dashboard bundle.

Contributor checklist

docs/contributor-checklist.md — language, feature, and CI-gate hub (fixes #62, PR #64).

CLI

Change	Detail
install --skill	New subcommand; --host all|claude|cursor; --force
-f json install	schema_version 1 — see JSON API § install
semantic index	Default embedder vocab

Docs and site

• New docs/guides/ tree (14 guides) mirrored on the site at /docs/guides/.
• Guides use CoolStore from konveyor-ecosystem/coolstore.
• User Guide §1 documents install --skill; JSON API documents the payload.

Merged PRs

• #65: Refactor — CFG/semantic performance, skills installer, guides, dashboard export.
• #64: Contributor checklist hub (@savitharaghunathan).

Commit range

Compare: v0.4.5...v0.4.6

Notable commits:

• f706150 Default semantic index embedder is vocab (opt in to code-daemon / hash).
• ac9826e Vocab matrix / code-daemon distill path.
• ba4a6e9 Parallel semantic index build (embed, bodies, batched ONNX).
• 4014bd0 CFG: one parse per file, faster dominators, Arc-shared CFG/PDG.
• be94837 Dashboard export optimization.
• 18b7bf2 rg-build install --skill.
• f51b7b8 / 72c52c8 Feature guides + agent skill guide.
• 2b0e988 Contributor checklist (fixes #62).

Thanks

Thanks to @savitharaghunathan for the contributor checklist.

Install

Download platform archives from this GitHub Release, put rg-build on your PATH, then:

rg-build --version
rg-build install --skill

See Install and User Guide §1.

What's Changed

• Add contributor checklist hub by @savitharaghunathan in #64
• Refactor by @sshaaf in #65

Full Changelog: v0.4.5...v0.4.6