Architecture: How to standardize type naming across the monorepo for the m...

Documentation for Sessions

🏗️ Architecture: How to standardize type naming across the monorepo for the m...

📋 Decision Context

Question:

How to standardize type naming across the monorepo for the module hierarchy?

Task: Session 32.2: Standardize type naming and remove inconsistencies across monorepo


🎯 Decision Made

Chosen:

Unified on 'platform-root' as the canonical type name with user-facing label 'Universe Core'. Removed duplicate ModuleType definitions, added 'platform-root' and 'page-module' to all type unions.

Options Considered:

  1. Keep 'universe-core' everywhere
  2. Use 'platform-root' with user-facing 'Universe Core'
  3. Create new unified type system

💭 Reasoning

Session 32.2: The codebase had multiple definitions of ModuleType and CosmicNodeType with inconsistencies. 'universe-core' was renamed to 'platform-root' for technical consistency while keeping 'Universe Core' as the user-facing label. All types now import from the canonical source in modules.types.ts. Deprecated unused interfaces (Planet, PlanetReference, PlanetTemplate) that duplicated existing types.


📁 Files Involved


🔗 Related


Auto-generated by MCP Smart Consolidation