🐛 Bug - Renamed categories stop appearing in rules list and another just missing

[KostaMadorsky]

Requested by: @KostaMadorsky via YakShaver.ai 🦬
cc: @jakebayliss, @amankumarrr, @KostaMadorsky, @Marxoz, @PothieuG, @Freego1783

Hi Team!

  🟥  Watch the video (1 min 59 sec)

Pain

In Rules V3 (TinaCMS), renaming certain rule categories causes them to disappear from the rules list and navigation. Specifically, renaming the category "Rules for Better .NET Migrations" (URL renamed to ".NET 8 to .NET 10") results in the category no longer appearing under Software Development. Additionally, in Prod, the "Rules for Better Error Handling" category does not appear at all, despite existing and having the correct rule count. This indicates an issue with category renaming and/or category visibility consistency across environments.

Acceptance Criteria

1. Renaming a category does not cause it to disappear from the rules list or navigation.
2. The category "Rules for Better .NET Migrations" appears correctly under Software Development after being renamed.
3. The "Rules for Better Error Handling" category is visible in Prod as expected.
4. Category visibility and ordering are consistent between environments (e.g. Dev/Test and Prod).
5. Rule counts remain unchanged and accurate after category renaming.
6. No data loss occurs when updating category names or URLs.

Reproduce Steps

1. Go to Rules V3 (TinaCMS).
2. Navigate to Categories → Software Development.
3. Rename the category "Rules for Better .NET Migrations" (e.g. update URL/name to ".NET 8 to .NET 10").
4. Save the changes.
5. Return to the Software Development rules list.
6. Observe that the renamed category no longer appears.
7. Check Prod environment and navigate to Software Development.
8. Observe that the "Rules for Better Error Handling" category is missing despite existing rules.

Screenshot

Figure: Renamed rule category disappears from the rules list after URL change

[KostaMadorsky]

The change we are trying to get over: SSWConsulting/SSW.Rules.Content#11766

[KostaMadorsky]

We did try with and without manual changes to the .json files

[KostaMadorsky]

As we were comparing Prod and local, we also noticed that Error Handling category does not show up in prod under Software Engineering, but does show up locally. Weird.

[Aibono1225]

This issue only affects local development. We previously removed a local dev command that updates the category-to-rules mapping JSON in Rules (not Rules.Content), so the mapping didn’t reflect category renames locally. I added it back in this PR: #2380

Builds still regenerate the mapping. I deployed the content branch to staging (SSWConsulting/SSW.Rules.Content#11766) and the renamed category renders correctly there. 🙂

Figure: Staging Homepage