This release adds 5 notable features for engineering teams evaluating rollout.
✓ No known CVEs patched in this version
Affected surfaces
Summary
AI summaryAdded SQLite-backed reports subsystem with UI, service CLI, agent identity, and workspace containment controls.
Full changelog
Added
- Reports subsystem with SQLite-backed indexing from
activity.log:- new runtime module
src/reports.py - retention and size-prune controls
- report status/overview/events/confirmations endpoints.
- new runtime module
- Reports UI with Dashboard and Log pages:
- totals, trends, top commands/paths, blocked-by-rule
- filterable/paginated event log
- auto-refresh and manual refresh controls.
- Guided setup and UI service lifecycle improvements:
- simplified interactive setup flow and aligned unattended flags (
--defaults,--yes,--gui,--no-gui) airg-serviceCLI for user-level service management (install,start,stop,restart,status,uninstall) on macOS (launchd) and Linux (systemd).
- simplified interactive setup flow and aligned unattended flags (
- Agent identity support via
AIRG_AGENT_IDwith safe fallback (Unknown) and propagation into runtime audit/reporting data. - Advanced
execute_commandworkspace containment control (execution.shell_workspace_containment) withoff,monitor, andenforcemodes. - Sample MCP-only Claude skill document (
docs/mcp-only.md) for deployments that require strict MCP-tool-only operation.
Changed
- Source layout refactor to
src/package structure while preserving CLI/tool behavior. - Runtime defaults and setup flow now consistently place policy/state artifacts in user runtime locations.
- UI build/discovery flow updated so prebuilt
ui_v3/distassets ship in repo/package for normal setup paths. - Reports and advanced policy controls expanded in the GUI, including improved filtering and reset behavior.
- Documentation restructured and updated for v1.2 behavior, known boundaries, and setup expectations.
Security
- Clarified and documented deployment requirement that AIRG enforces MCP-routed actions only; native agent tools (for example Bash/Glob/Read/Write/Edit) are outside AIRG policy control unless disabled by the operator.
- Hardened approval and runtime path handling through stricter path/env defaults and improved diagnostics in setup/doctor workflows.
Weekly OSS security release digest.
The CVE patches and breaking changes that affected production tools this week. One email, every Sunday.
No spam, unsubscribe anytime.
Share this release
About jimmyracheta/AI-Runtime-Guard
Runtime policy enforcement for AI agents - prevents accidental damage to your systems, unauthorized agent access and automates backup-before-write for any touched files.
Related context
Related tools
Beta — feedback welcome: [email protected]