VFX Category Label Generation

README.md

@@ -414,12 +414,19 @@ For `head_visualeffects` autogen, producers can publish the group-to-row policy
 in `autogen.producers[].head_visualeffects`, and consumers can override or
 extend it in `autogen.consumers[].head_visualeffects`. The toolkit uses
 compatibility defaults for older configs and manifests, but YAML can own the
-group prefixes, model stem prefixes to strip, key/label formats, model column,
-and default row values. Individual groups can override the model column with
-`model_column` or write the discovered model stem to several columns with
-`model_columns`, which is useful for root-node visualeffects. Supported format
-tokens are `{dataset}`, `{group}`, `{prefix}`, `{stem}`, `{stem_upper}`, and
-`{model_stem}`.
+group token source, category source, delimiter, case policy, legacy group
+mapping, model stem prefixes to strip, key/label formats, model column, and
+default row values. `group_token_source: folder_name` uses the manifest folder
+group directly instead of a prefix mapping, and `category_from:
+immediate_parent` can expose the model's category folder in keys and labels.
+`legacy_groups` maps released manifest group names to current folder groups,
+and `legacy_key_format` preserves row IDs when migrating older generated lock
+keys. Individual groups can override the model column with `model_column` or
+write the discovered model stem to several columns with `model_columns`, which
+is useful for root-node visualeffects. Supported format tokens are `{dataset}`,
+`{group}`, `{group_raw}`, `{prefix}`, `{category}`, `{category_upper}`,
+`{category_segment}`, `{category_segment_upper}`, `{subgroup}`, `{stem}`,
+`{stem_upper}`, `{model_stem}`, and `{delimiter}`.
 
 For `parts_rows` generated assets, `parts_rows.acbonus` can normalize final
 ACBONUS values before module overrides are applied. The