Improve clarity around upgrading spaces and their contents

[RecentRunner]

Describe the problem

I’m new to Cinny and still learning how Matrix handles spaces, rooms, and room upgrades.

I only really started seriously looking at switching to Matrix after Cinny added voice calls. While trying things out, I upgraded an old space the wrong way, and it made me realise how hard it is to understand the right way to handle a space and everything inside it.

From a new user’s point of view, spaces feel like containers. A space can include rooms and other spaces, so it feels natural to expect Cinny to make it easier to understand how upgrades should be handled for everything inside it.

Right now, it is not very clear what should be upgraded first, what gets replaced, or how everything is supposed to stay organised afterward.

Describe the solution you'd like

I’d like Cinny to make this easier to understand with a clearer and more guided upgrade flow for spaces.

What I have in mind is something that helps the user see the rooms and subspaces inside a space, understand what will happen during upgrades, and work through that structure in a sensible order.

Even a simple step by step UI would help a lot. Something that makes it clearer what is old, what is new, and how the upgraded rooms or spaces relate to each other afterward.

Matrix room upgrades seem to happen one room at a time, which is already a bit hard to follow as a new user. It seems even more confusing with spaces, because the space can still end up linking to the old room after the upgrade. A workflow that warns about that would be helpful.

Alternatives considered

The only real alternative I found was trying to do it manually and piecing it together from my own understanding of how Matrix works.

That might be fine for experienced users, but it is pretty confusing as a newcomer.

Additional context

This also seems related to #1472 since it describes replaced rooms still showing up separately and becoming especially confusing when spaces are involved.

There also seems to be Matrix work in this area already, for example MSC4168, which looks to be about keeping space links up to date during room upgrades. That feels relevant here, since part of the confusion is making sure spaces do not keep pointing to old rooms after an upgrade.

If I am thinking about this the wrong way, or if this would make more sense in a different repo, please let me know where it would be better to raise it.