M-5: List Universes

[spuentesp]

Category: manage | Epic: 1 | Priority: medium

Summary

Display all Universes with summary information including story and entity
counts. Supports filtering by multiverse, genre, and sorting options.

Acceptance Criteria

• neo4j_list_universes returns all universes with counts
• Table displays name, genre, story_count, entity_count
• Filter by multiverse_id works correctly
• Filter by genre works correctly
• Retconned universes excluded by default
• Sorting works by name (default), genre, counts
• Pagination supported (--limit, --offset)
• Empty state shows appropriate message

Dependencies

This use case depends on:

• DL-1

Implementation

Layer: 3

Files to modify:

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

NEO4J Operations:

• neo4j_list_universes (authority: *)

Notes:

• Entity count may be expensive for large worlds - consider caching
• Show --include-retconned flag for admin access

Testing Requirements

Minimum coverage: 80%

Unit tests:

• test_list_universes_all: returns all non-retconned
• test_list_universes_by_multiverse: filter works
• test_list_universes_by_genre: filter works
• test_list_universes_pagination: limit/offset work
• test_list_universes_empty: empty list handled

Integration tests:

• test_list_universes_cli: CLI output formatted correctly

References

Documentation:

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

---

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