UAT: agents session export CLI output missing spec-required Session Export, Contents, and Integrity panels #1347

Open
opened 2026-04-02 16:56:51 +00:00 by freemo · 0 comments
Owner

Bug Report

Feature Area: Session export/import — CLI export output format

What Was Tested

The export_session CLI command in src/cleveragents/cli/commands/session.py (lines 429–485) was compared against the specification's documented output format.

Expected Behavior (from spec)

The spec defines three Rich output panels for agents session export:

Panel 1 — Session Export:

╭─ Session Export ────────────────────╮
│ Session: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │
│ Output: /tmp/weekly-planning.json   │
│ Messages: 6                         │
│ Size: 24 KB                         │
│ Format: JSON                        │
╰─────────────────────────────────────╯

Panel 2 — Contents:

╭─ Contents ─────────────────╮
│ Messages: 6                │
│ Plan References: 1         │
│ Metadata Keys: 2           │
│ Actor Config: included     │
│ Schema Version: v3         │
╰────────────────────────────╯

Panel 3 — Integrity:

╭─ Integrity ──────────────────╮
│ Checksum: sha256:7a9b...42c1 │
│ Encrypted: no                │
╰──────────────────────────────╯

Actual Behavior

The current implementation (session.py lines 459–471) only outputs:

  • If writing to file: "✓ OK Session exported to {output}" (single line)
  • If writing to stdout: raw JSON dump of the session data

No panels are rendered. No summary of contents, no integrity information, no file size, no format indicator.

Code Location

src/cleveragents/cli/commands/session.py lines 429–485 (export_session function)

Specific Missing Elements

  1. Session Export panel — session ID, output path, message count, file size, format
  2. Contents panel — message count, plan references count, metadata key count, actor config status, schema version
  3. Integrity panel — checksum with sha256: prefix format, encrypted status
  4. --format option — the spec shows a JSON output format for the export command; the current implementation has no --format flag

Severity

Medium — The export command is functional (data is correctly exported) but the user-facing output is significantly reduced compared to the spec. The missing --format option also prevents machine-readable output of the export operation metadata.

## Bug Report **Feature Area:** Session export/import — CLI export output format ### What Was Tested The `export_session` CLI command in `src/cleveragents/cli/commands/session.py` (lines 429–485) was compared against the specification's documented output format. ### Expected Behavior (from spec) The spec defines three Rich output panels for `agents session export`: **Panel 1 — Session Export:** ``` ╭─ Session Export ────────────────────╮ │ Session: 01HXM2A6K1P2E9Q9D4GQ7J4S7Z │ │ Output: /tmp/weekly-planning.json │ │ Messages: 6 │ │ Size: 24 KB │ │ Format: JSON │ ╰─────────────────────────────────────╯ ``` **Panel 2 — Contents:** ``` ╭─ Contents ─────────────────╮ │ Messages: 6 │ │ Plan References: 1 │ │ Metadata Keys: 2 │ │ Actor Config: included │ │ Schema Version: v3 │ ╰────────────────────────────╯ ``` **Panel 3 — Integrity:** ``` ╭─ Integrity ──────────────────╮ │ Checksum: sha256:7a9b...42c1 │ │ Encrypted: no │ ╰──────────────────────────────╯ ``` ### Actual Behavior The current implementation (`session.py` lines 459–471) only outputs: - If writing to file: `"✓ OK Session exported to {output}"` (single line) - If writing to stdout: raw JSON dump of the session data No panels are rendered. No summary of contents, no integrity information, no file size, no format indicator. ### Code Location `src/cleveragents/cli/commands/session.py` lines 429–485 (`export_session` function) ### Specific Missing Elements 1. **Session Export panel** — session ID, output path, message count, file size, format 2. **Contents panel** — message count, plan references count, metadata key count, actor config status, schema version 3. **Integrity panel** — checksum with `sha256:` prefix format, encrypted status 4. **`--format` option** — the spec shows a JSON output format for the export command; the current implementation has no `--format` flag ### Severity **Medium** — The export command is functional (data is correctly exported) but the user-facing output is significantly reduced compared to the spec. The missing `--format` option also prevents machine-readable output of the export operation metadata.
freemo self-assigned this 2026-04-02 18:45:20 +00:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
cleveragents/cleveragents-core#1347
No description provided.