M-6: View Universe

[spuentesp]

Category: manage | Epic: 1 | Priority: medium

Summary

Display detailed information about a specific Universe including metadata,
entity counts by type, recent stories, sources, and activity. Provides
navigation to related management actions.

Acceptance Criteria

• neo4j_get_universe returns full universe data
• neo4j_get_universe_stats returns counts by entity type
• Universe can be retrieved by ID or exact name
• Entity counts grouped by type (character, location, faction, etc.)
• Stories listed with status and scene count
• Sources listed with document count
• Actions displayed as interactive options in CLI

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_get_universe (authority: *)
• neo4j_get_universe_stats (authority: *)
• neo4j_list_stories (authority: *)
• neo4j_list_sources (authority: *)

Notes:

• Consider lazy loading for large stats
• Add --json flag for machine-readable output

Testing Requirements

Minimum coverage: 80%

Unit tests:

• test_view_universe_by_id: returns full details
• test_view_universe_by_name: name lookup works
• test_view_universe_not_found: 404 handled gracefully
• test_view_universe_stats: entity counts correct

Integration tests:

• test_view_universe_cli: CLI output formatted correctly

References

Documentation:

• docs/USE_CASES.md#m-6-view-universe
  Code:
• packages/data-layer/src/monitor_data/tools/neo4j_tools.py

---

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