UAT: `agents audit export` command is missing — spec requires JSON/CSV export of audit logs #5764

New issue

Open

opened 2026-04-09 09:14:30 +00:00 by HAL9000 · 3 comments

HAL9000 commented

2026-04-09 09:14:30 +00:00

Owner

Bug Report

Feature Area: Audit Logging — CLI Commands
Milestone: v3.5.0 (M6)
Severity: Critical — blocks milestone acceptance (compliance export is a core audit requirement)

What Was Tested

The agents audit CLI command group was inspected against the specification requirement for an agents audit export subcommand.

Expected Behavior (from spec)

The specification (docs/specification.md, docs/reference/audit_logging.md) defines three primary agents audit subcommands:

agents audit list — list entries with filters ✅ (implemented)
agents audit show <ID> — show single entry ✅ (implemented)
agents audit export — export audit logs to JSON or CSV format ❌ (MISSING)

The spec states:

agents audit export: Export audit logs to JSON or CSV format.

The docs/reference/audit_logging.md also references export capability for compliance archival:

"In server mode, audit logs can be exported for compliance archival using server administration commands."

Actual Behavior

The agents audit command group (src/cleveragents/cli/commands/audit.py) only implements:

list
show
prune
count

There is no export subcommand in the CLI or in AuditService. The AuditLogEntry.as_dict() method exists but is never used for export. There is no --output flag, no CSV serialization, and no JSON bulk export capability.

Code Location

src/cleveragents/cli/commands/audit.py — missing export command
src/cleveragents/application/services/audit_service.py — missing export() method

Steps to Reproduce

Run agents audit --help
Observe that export is not listed as a subcommand
Run agents audit export — command not found error

Impact

Without agents audit export, users cannot:

Export audit logs for compliance archival
Pipe audit data to external SIEM tools
Generate CSV reports for security reviews
Automate audit log archival in CI/CD pipelines

Automated by CleverAgents Bot
Supervisor: UAT Testing | Agent: uat-tester

## Bug Report **Feature Area**: Audit Logging — CLI Commands **Milestone**: v3.5.0 (M6) **Severity**: Critical — blocks milestone acceptance (compliance export is a core audit requirement) ### What Was Tested The `agents audit` CLI command group was inspected against the specification requirement for an `agents audit export` subcommand. ### Expected Behavior (from spec) The specification (`docs/specification.md`, `docs/reference/audit_logging.md`) defines three primary `agents audit` subcommands: - `agents audit list` — list entries with filters ✅ (implemented) - `agents audit show <ID>` — show single entry ✅ (implemented) - `agents audit export` — **export audit logs to JSON or CSV format** ❌ (MISSING) The spec states: > `agents audit export`: Export audit logs to JSON or CSV format. The `docs/reference/audit_logging.md` also references export capability for compliance archival: > "In server mode, audit logs can be exported for compliance archival using server administration commands." ### Actual Behavior The `agents audit` command group (`src/cleveragents/cli/commands/audit.py`) only implements: - `list` - `show` - `prune` - `count` There is **no `export` subcommand** in the CLI or in `AuditService`. The `AuditLogEntry.as_dict()` method exists but is never used for export. There is no `--output` flag, no CSV serialization, and no JSON bulk export capability. ### Code Location - `src/cleveragents/cli/commands/audit.py` — missing `export` command - `src/cleveragents/application/services/audit_service.py` — missing `export()` method ### Steps to Reproduce 1. Run `agents audit --help` 2. Observe that `export` is not listed as a subcommand 3. Run `agents audit export` — command not found error ### Impact Without `agents audit export`, users cannot: - Export audit logs for compliance archival - Pipe audit data to external SIEM tools - Generate CSV reports for security reviews - Automate audit log archival in CI/CD pipelines --- **Automated by CleverAgents Bot** Supervisor: UAT Testing | Agent: uat-tester

HAL9000 added the

Rows
Columns

UAT: agents audit export command is missing — spec requires JSON/CSV export of audit logs #5764