[refactor] [4/n] Rename profile → preset; version str→int; stages → stage_schemas (#1234)

Address PR #1234 review feedback.

Rename the profile registry to "preset" throughout:
- PipelineProfile → InferencePreset, ProfileStageSpec → PresetStageSpec
- fastvideo/api/profiles.py → presets.py; 13 pipeline profiles.py → presets.py
- Registry API, ConfigInfo.default_profile, PipelineSelection fields renamed

Simplify version: str → int; drop the _version_key helper (every
registered version is "1", plain int comparison suffices).

Rename InferencePreset.stages → stage_schemas to clarify it is
validation metadata; the real execution DAG lives in each pipeline's
create_pipeline_stages().

Misc review fixes:
- logger.exception → logger.warning in SamplingParam.update()
- Collapse double config lookup via get_preset_selection()
- Fix "image-to-prompt" typo on wan_fun_1_3b_inp
- Loosen test_total_profile_count (== 37 → >= 37)
- Revert CRLF whitespace churn in test_lingbot_similarity.py
- Remove unused _clear_registry

Author: SolitaryThinker

docs/design/inference_schema_parity_inventory.yaml

@@ -1,7 +1,7 @@
 status_definitions:
   kept: "Public field remains on a public adapter surface with the same meaning."
   moved: "Public field remains supported but normalizes into a different nested path."
-  profile_owned: "Public field remains supported only through a model/profile-specific surface."
+  preset_owned: "Public field remains supported only through a model/preset-specific surface."
   compatibility_only: "Legacy public field remains adapter-only during migration and is not part of the canonical typed schema."
   private_only: "Field should only be handled by private adapters and is not a public FastVideo compatibility promise."
   internal_only: "Field is runtime/config plumbing and should not be part of the new public typed inference API."
@@ -40,12 +40,12 @@ surfaces:
       init_weights_from_safetensors_2: generator.pipeline.components.transformer_2_weights
       override_pipeline_cls_name: generator.pipeline.components.override_pipeline_cls_name
       boundary_ratio: request.sampling.boundary_ratio
-    profile_owned:
-      ltx2_vae_tiling: generator.pipeline.profile_overrides.ltx2.vae_tiling
-      ltx2_vae_spatial_tile_size_in_pixels: generator.pipeline.profile_overrides.ltx2.vae.spatial_tile_size_in_pixels
-      ltx2_vae_spatial_tile_overlap_in_pixels: generator.pipeline.profile_overrides.ltx2.vae.spatial_tile_overlap_in_pixels
-      ltx2_vae_temporal_tile_size_in_frames: generator.pipeline.profile_overrides.ltx2.vae.temporal_tile_size_in_frames
-      ltx2_vae_temporal_tile_overlap_in_frames: generator.pipeline.profile_overrides.ltx2.vae.temporal_tile_overlap_in_frames
+    preset_owned:
+      ltx2_vae_tiling: generator.pipeline.preset_overrides.ltx2.vae_tiling
+      ltx2_vae_spatial_tile_size_in_pixels: generator.pipeline.preset_overrides.ltx2.vae.spatial_tile_size_in_pixels
+      ltx2_vae_spatial_tile_overlap_in_pixels: generator.pipeline.preset_overrides.ltx2.vae.spatial_tile_overlap_in_pixels
+      ltx2_vae_temporal_tile_size_in_frames: generator.pipeline.preset_overrides.ltx2.vae.temporal_tile_size_in_frames
+      ltx2_vae_temporal_tile_overlap_in_frames: generator.pipeline.preset_overrides.ltx2.vae.temporal_tile_overlap_in_frames
       ltx2_initial_latent_path: request.extensions.ltx2.initial_latent_path
     compatibility_only:
       mode: "Legacy multi-mode FastVideoArgs switch; typed inference config should not expose execution mode."
@@ -69,16 +69,16 @@ surfaces:
   pipeline_config_base:
     moved:
       pipeline_config_path: generator.pipeline.components.pipeline_config_path
-    profile_owned:
-      embedded_cfg_scale: generator.pipeline.profile_overrides.embedded_cfg_scale
-      flow_shift: generator.pipeline.profile_overrides.flow_shift
-      flow_shift_sr: generator.pipeline.profile_overrides.flow_shift_sr
-      is_causal: generator.pipeline.profile_overrides.is_causal
-      vae_tiling: generator.pipeline.profile_overrides.vae_tiling
-      vae_sp: generator.pipeline.profile_overrides.vae_sp
-      dmd_denoising_steps: generator.pipeline.profile_overrides.dmd_denoising_steps
-      ti2v_task: generator.pipeline.profile_overrides.ti2v_task
-      boundary_ratio: generator.pipeline.profile_overrides.boundary_ratio
+    preset_owned:
+      embedded_cfg_scale: generator.pipeline.preset_overrides.embedded_cfg_scale
+      flow_shift: generator.pipeline.preset_overrides.flow_shift
+      flow_shift_sr: generator.pipeline.preset_overrides.flow_shift_sr
+      is_causal: generator.pipeline.preset_overrides.is_causal
+      vae_tiling: generator.pipeline.preset_overrides.vae_tiling
+      vae_sp: generator.pipeline.preset_overrides.vae_sp
+      dmd_denoising_steps: generator.pipeline.preset_overrides.dmd_denoising_steps
+      ti2v_task: generator.pipeline.preset_overrides.ti2v_task
+      boundary_ratio: generator.pipeline.preset_overrides.boundary_ratio
     compatibility_only:
       model_path: "Redundant with generator.model_path."
       disable_autocast: "Duplicated by generator.engine.disable_autocast during migration."
@@ -97,7 +97,7 @@ surfaces:
       postprocess_text_funcs: "Internal text postprocessing hooks."
 
   pipeline_config_extensions:
-    profile_owned:
+    preset_owned:
       conditioning_strategy:
         sources:
           - fastvideo.configs.pipelines.cosmos.CosmosConfig
@@ -309,8 +309,8 @@ surfaces:
     compatibility_only:
       batch_size: "Gen3C inference-only tuning field pending typed batching design."
       gradient_checkpointing: "Gen3C inference-only compatibility field pending typed batching design."
-      guidance_scale: "Gen3C pipeline-level default pending profile/default-request cleanup."
-      num_inference_steps: "Gen3C pipeline-level default pending profile/default-request cleanup."
+      guidance_scale: "Gen3C pipeline-level default pending preset/default-request cleanup."
+      num_inference_steps: "Gen3C pipeline-level default pending preset/default-request cleanup."
     internal_only:
       audio_decoder_config: "Legacy internal component config object."
       audio_decoder_precision: "Precision override pending dedicated component precision design."
@@ -354,7 +354,7 @@ surfaces:
       return_frames: request.output.return_frames
       return_trajectory_latents: request.runtime.return_trajectory_latents
       return_trajectory_decoded: request.runtime.return_trajectory_decoded
-    profile_owned:
+    preset_owned:
       t_thresh: request.stage_overrides.refine.t_thresh
       spatial_refine_only: request.stage_overrides.refine.spatial_refine_only
       num_cond_frames: request.stage_overrides.refine.num_cond_frames

fastvideo/api/__init__.py

@@ -22,14 +22,14 @@
 )
 from fastvideo.api.errors import ConfigValidationError
 from fastvideo.api.overrides import apply_overrides, parse_cli_overrides
-from fastvideo.api.profiles import (
-    PipelineProfile,
-    ProfileStageSpec,
-    get_all_profile_names,
-    get_profile,
-    get_profiles_for_family,
-    register_profile,
-    validate_profile_selection,
+from fastvideo.api.presets import (
+    InferencePreset,
+    PresetStageSpec,
+    get_all_preset_names,
+    get_preset,
+    get_presets_for_family,
+    register_preset,
+    validate_preset_selection,
     validate_stage_names,
     validate_stage_overrides,
 )
@@ -67,21 +67,21 @@
     "SamplingParam",
     "ServeConfig",
     "ServerConfig",
-    "PipelineProfile",
-    "ProfileStageSpec",
+    "InferencePreset",
+    "PresetStageSpec",
     "apply_overrides",
     "config_to_dict",
     "load_config",
     "load_raw_config",
     "load_run_config",
     "load_serve_config",
     "parse_cli_overrides",
-    "get_all_profile_names",
-    "get_profile",
-    "get_profiles_for_family",
+    "get_all_preset_names",
+    "get_preset",
+    "get_presets_for_family",
     "parse_config",
-    "register_profile",
-    "validate_profile_selection",
+    "register_preset",
+    "validate_preset_selection",
     "validate_stage_names",
     "validate_stage_overrides",
 ]

fastvideo/api/compat.py

@@ -157,10 +157,10 @@ def legacy_from_pretrained_to_config(
 def generator_config_to_fastvideo_args(config: GeneratorConfig | Mapping[str, Any], ) -> FastVideoArgs:
     normalized = normalize_generator_config(config)
     unsupported = []
-    if normalized.pipeline.profile is not None:
-        unsupported.append("pipeline.profile")
-    if normalized.pipeline.profile_version is not None:
-        unsupported.append("pipeline.profile_version")
+    if normalized.pipeline.preset is not None:
+        unsupported.append("pipeline.preset")
+    if normalized.pipeline.preset_version is not None:
+        unsupported.append("pipeline.preset_version")
     if normalized.pipeline.components.config_root is not None:
         unsupported.append("pipeline.components.config_root")
     if normalized.pipeline.components.vae_weights is not None:
@@ -220,7 +220,7 @@ def generator_config_to_fastvideo_args(config: GeneratorConfig | Mapping[str, An
     if components.transformer_2_weights is not None:
         kwargs["init_weights_from_safetensors_2"] = components.transformer_2_weights
 
-    kwargs.update(deepcopy(normalized.pipeline.profile_overrides))
+    kwargs.update(deepcopy(normalized.pipeline.preset_overrides))
     kwargs.update(deepcopy(normalized.pipeline.experimental))
     return FastVideoArgs.from_kwargs(**kwargs)