rgctl v0.4.9

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)

1. Daemon and MCP removed — see migration above; run rgctl migrate-cache if you still have ~/.rgctl/cache/.
2. Artifacts in repo — add .rgctl/ to .gitignore; expect {repo}/.rgctl/ after discover.
3. MCP configs obsolete — remove .cursor/mcp.json / Claude MCP entries for serve --mode mcp; use CLI subprocesses or HTTP serve.
4. 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

What's Changed

• Add markdown context graph guide with kubernetes/website walkthrough by @savitharaghunathan in #66
• Kantra migration rules + remove daemon/MCP; fix dashboard WASM by @sshaaf in #72

Full Changelog: v0.4.8...v0.4.9