rgctl

rgctl v0.4.9

Major simplification release: CLI-first workflow (in-repo .rgctl/ artifacts), Konveyor Kantra migration rules built in, and daemon + MCP removed. Download rgctl from the assets below and verify with rgctl --version.

rgctl --version
rgctl install --skill --force   # refresh agent playbook after upgrade

Highlights

Konveyor Kantra migration rules (`--with-kantra`)

Native Kantra rule evaluation against the indexed graph and source cache — no Kantra CLI, LSP, or containers.

Capability	Detail
Embedded catalog	Release binaries ship Konveyor `stable/java` (~2.6k rules) as compiled `RBKC` blob (`rgctl-kantra`)
CLI	`discover --with-kantra`, `--kantra-target`, `--kantra-rules`, `--kantra-catalog`, `--kantra-index-only`
Artifacts	`.rgctl/kantra_findings.json` (violations + skipped rules)
Graph	`KantraRule` / `KantraRuleset` nodes; `VIOLATES` edges to matched code nodes after full eval
GQL	Filter by r.`konveyor.io/target`; traverse `VIOLATES` to code nodes
Dashboard	Migration Rules tab — category + Konveyor target filters, syntax-highlighted violation snippets (`kantra_index.json` + per-file shards)

rgctl discover . -l java -e target --with-kantra
rgctl discover . --with-kantra --kantra-target quarkus
rgctl -f json gql "MATCH (r:KantraRule)-[:VIOLATES]->(n) RETURN r, n LIMIT 10"

Does not require --with-cfg. Source builds need the rulesets submodule — see crates/rgctl-kantra/README.md.

CLI-first artifacts (daemon removed)

Background daemon mode and all daemon routing are removed. Every command runs in-process; artifacts live at {repo}/.rgctl/.

Removed	Replacement
`rgctl daemon start\|stop\|status\|list`	N/A — no background process
`--no-daemon`, `--daemon-home`, `--fail-if-no-daemon`	Default is always in-repo artifacts
`serve --daemon`, `serve --mode mcp`	`rgctl serve` (foreground HTTP + dashboard on one repo)
MCP tools (`rgctl_status`, `rgctl_query`, …)	`rgctl -f json <command>` subprocesses (AGENTS.md)
`~/.rgctl/cache/{name}/.rgctl/` daemon cache	`rgctl migrate-cache` copies legacy cache into the repo

Agent workflow: discover once → spawn rgctl -f json gql|blast-radius|… (or long-lived rgctl serve for HTTP). Re-run rgctl install --skill --force for updated skill + AGENTS.md.

`discover` repo root fix

rgctl -r PATH discover . no longer ignores -r — the explicit repo root wins when both are given.

Markdown context graph guide

New step-by-step guide: Markdown Context Graph — index docs with discover -l markdown, GQL on headings, Obsidian export, kubernetes/website walkthrough (PR #66).

Documentation and demos

User guide, installation, HTTP API, agent skill, and integration-test docs updated for CLI-first workflow
MCP Server guide removed (docs/guides/mcp-server.md)
CLI and dashboard VHS demos re-recorded with --with-kantra and Migration Rules tab segment
Website docs hub and demo pages aligned

Dashboard / WASM fix

Restored scripts/build-dashboard.sh and rgctl_wasm_* asset naming; bundle test ensures worker ↔ WASM filenames stay in sync (fixes dashboard WASM 404).

Breaking changes (upgrade from v0.4.8)

Daemon and MCP removed — see migration above; run rgctl migrate-cache if you still have ~/.rgctl/cache/.
Artifacts in repo — add .rgctl/ to .gitignore; expect {repo}/.rgctl/ after discover.
MCP configs obsolete — remove .cursor/mcp.json / Claude MCP entries for serve --mode mcp; use CLI subprocesses or HTTP serve.
Refresh agent skill — rgctl install --skill --force.

Unchanged: semantic index --embedder code-daemon (ONNX embedder name — not related to removed daemon mode).

Performance

Linux kernel cold discover gate (example/linux, default discover, release build) passes at 145 s wall on reference M3 Pro hardware (baseline unchanged).

Install

Platform	Asset
Linux x86_64	`rgctl-0.4.9-x86_64-unknown-linux-gnu.tar.gz`
macOS Apple Silicon	`rgctl-0.4.9-aarch64-apple-darwin.tar.gz`
macOS Intel	`rgctl-0.4.9-x86_64-apple-darwin.tar.gz`
Windows x86_64	`rgctl-0.4.9-x86_64-pc-windows-msvc.zip`

Verify: shasum -a 256 -c SHA256SUMS.txt

Docs

User Guide — Kantra, discover, full CLI
Kantra crate README — embedded catalog, submodule
Dashboard — Migration Rules
AGENTS.md · Install

Merged PRs

#72 — Kantra migration rules, daemon/MCP removal, dashboard WASM fix
#66 — Markdown context graph guide

Compare

v0.4.8...v0.4.9