M-3: List Multiverses

[spuentesp]

Category: manage | Epic: 1 | Priority: medium

Summary

Display all Multiverses under the Omniverse with summary information
including universe counts and system names. Supports filtering and
sorting for large collections.

Acceptance Criteria

• neo4j_list_multiverses returns all multiverses with counts
• Table displays id, name, system_name, universe_count
• Empty state shows 'No multiverses found' message
• Sorting works by name (default), system, count
• Pagination supported for large lists (--limit, --offset)
• Unit tests cover list, empty, and pagination

Dependencies

This use case depends on:

• DL-1
• M-1

Implementation

Layer: 3

Files to modify:

• packages/cli/src/monitor_cli/commands/manage/multiverse.py

NEO4J Operations:

• neo4j_list_multiverses (authority: *)

Notes:

• Consider caching counts for performance
• Universe count excludes retconned universes

Testing Requirements

Minimum coverage: 80%

Unit tests:

• test_list_multiverses_success: returns list with counts
• test_list_multiverses_empty: returns empty list gracefully
• test_list_multiverses_pagination: limit/offset work
• test_list_multiverses_sorting: sort options work

Integration tests:

• test_list_multiverses_cli: CLI output formatted correctly

References

Documentation:

• docs/USE_CASES.md#m-3-list-multiverses
  Code:
• packages/data-layer/src/monitor_data/tools/neo4j_tools.py

---

Generated from /home/sebas/monitor2/docs/use-cases/manage/M-3.yml