@hybridlabor-api/aos 4.2.0 → 4.4.0

package/mcps/unreal_mcp/docs/native-automation-progress.md

@@ -1,431 +0,0 @@
-# Native Automation Completion Log
-
-This document tracks ongoing work to replace stubbed or registry-based fallbacks with full native editor implementations across the MCP Automation Bridge plugin.
-
-## Asset Workflow & Source Control
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `get_source_control_state` | Implemented (checkout status, user). | ✅ Done |
-| `analyze_graph` | Implemented (recursive dependencies analysis). | ✅ Done |
-| `import` / `export` | Native AssetTools implementation. | ✅ Done |
-
-## Sequence Handlers
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `sequence_create` | Uses native asset creation when WITH_EDITOR. | ✅ Done |
-| `sequence_open` | Opens the asset in an editor window. | ✅ Done |
-| `sequence_add_camera` | Spawns camera and adds to level sequence. | ✅ Done |
-| `sequence_play` / `sequence_pause` / `sequence_stop` | Native editor playback control. | ✅ Done |
-| `sequence_add_actor` / `sequence_add_actors` | Native binding creation (Possessables). | ✅ Done |
-| `sequence_add_spawnable_from_class` | Native spawnable creation and track binding. | ✅ Done |
-| `sequence_remove_actors` | Removes bindings and tracks. | ✅ Done |
-| `sequence_get_bindings` | Lists bindings from MovieScene. | ✅ Done |
-| `sequence_get_properties` | Returns frame rate + playback range. | ✅ Done |
-| `sequence_set_playback_speed` | Sets playback speed via Sequencer. | ✅ Done |
-| `sequence_cleanup` | Removes actors by prefix. | ✅ Done |
-
-## Graph Actions (Consolidated)
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `manage_blueprint` (graph) | Implemented (nodes, pins, properties). | Refine `Literal` node creation. |
-| `manage_blueprint` (add_component) | Implemented (UE 5.7+ SubobjectDataInterface support added). | ✅ Done |
-| `manage_effect` (graph) | Implemented (modules, removal, emitters, params). | ✅ Done |
-| `manage_asset` (material graph) | Implemented (nodes, removal, details, connections). | ✅ Done |
-| `manage_asset` (behavior tree) | Implemented (nodes, removal, connections, properties). | ✅ Done |
-
-## World Partition & Level Composition
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `manage_level_structure` / world partition handlers | Implemented (`enable_world_partition`, data-layer/world-partition support). | ✅ Done (UE 5.7+ support added) |
-
-## Input System
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `manage_networking` | Implemented (Input Actions, Mapping Contexts, Bindings). | ✅ Done |
-
-## System, Render & Pipeline
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `manage_asset` (render target / Nanite) | Implemented (`create_render_target`, `nanite_rebuild_mesh`). | ✅ Done |
-| `system_control` (lumen) | Implemented (`lumen_update_scene`). | ✅ Done |
-| `system_control` (pipeline) | Implemented (`run_ubt`). | ✅ Done (Streamed via Node) |
-| `system_control` (tests) | Implemented (`run_tests`). | ✅ Done (WebSocket/native event streaming verified) |
-| `system_control` (settings) | Implemented (`set_project_setting`). | ✅ Done |
-| `manage_blueprint` (events) | Implemented (`add_event` for Custom/Standard). | ✅ Done |
-
-## Observability
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `system_control` (logs) | Implemented (`subscribe` / `unsubscribe`). | ✅ Done (WebSocket/native real-time streaming verified) |
-| `system_control` (debug) | Implemented (`spawn_category`). | Add GGameplayDebugger integration. |
-| `system_control` (insights) | Implemented (`start_session`, trace capture/status/pause/resume/stop, snapshot write/send, `analyze_trace`). | ✅ Done |
-| `control_editor` (ui) | Implemented (`simulate_input`). | Add FSlateApplication integration. |
-
-## SCS (Simple Construction Script) Helpers
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `get_blueprint` | Requires editor build; returns serialized component tree. | ✅ Done |
-| `modify_scs` | Full editor implementation (add/remove/attach). | ✅ Done |
-| `add_scs_component` / `remove_scs_component` | Editor-only; fail fast when unavailable. | ✅ Done |
-
-## Security & Hardening
-
-| Feature | Status | Details |
-| --- | --- | --- |
-| **Path Sanitization** | ✅ Implemented | Enforces project-relative paths (`/Game`, `/Engine`, `/Script`) and rejects traversal (`..`) in `import`, `create_folder`, etc. |
-| **Symlink Resolution** | ✅ Implemented | `execute_python` file path validation resolves symlinks and re-validates against project directory to prevent escape attacks. |
-| **Code Size Limits** | ✅ Implemented | `execute_python` enforces 1 MB maximum on inline code payloads. |
-| **Capability Token Auth** | ✅ Implemented | Native MCP transport validates `X-MCP-Capability-Token` header when `bRequireCapabilityToken` is enabled. |
-| **Request Origin Tracking** | ✅ Implemented | `ERequestOrigin` enum routes HTTP vs WebSocket responses explicitly — no `TargetSocket==nullptr` inference. |
-| **Pointer Safety** | ✅ Verified | Robust `nullptr` checks and weak pointers in C++ handlers. |
-| **Concurrency** | ✅ Verified | Thread-safe queue and GameThread dispatching for all automation requests. |
-| **Tool Registry Thread Safety** | ✅ Implemented | `CacheMutex` protects `Tools`, `ToolsByName`, `CachedToolSchemas`, `bCacheValid`. `GetAllTools()` returns copy. |
-| **Infrastructure** | ✅ Verified | Live headless UE validation covers WebSocket log/test event streaming, native `/mcp` SSE notifications, custom handler aliases, and Unreal Insights trace capture/snapshot/analyze workflows. |
-
-## Blueprint Authoring (Recap)
-
-All `blueprint_*` authoring commands now require editor support and execute natively. Remaining polish:
-
-- Expand `blueprint_add_node` to cover additional K2 nodes safely.
-- Provide higher-level helpers once Sequencer bindings are in place (e.g., node creation shortcuts tied to bindings).
-- Registry fallbacks have been removed for `blueprint_set_default` and `blueprint_compile`; these actions now fail fast when the editor build is unavailable.
-- `ensure_exists` and `get_blueprint` now return `NOT_AVAILABLE` when the editor runtime is missing instead of consulting cached registry data.
-
-## Niagara & Effect Handlers
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `spawn_niagara` | Spawns Niagara actors. | Support attachment targets, optional lifespan, undo stack. |
-| `set_niagara_parameter` | Supports float/vector/color/bool/int params. | ✅ Done |
-| `create_niagara_ribbon` | Implemented (spawns actor, sets user params). | ✅ Done |
-| `manage_effect` (legacy actions) | Stubbed (`NOT_IMPLEMENTED`). | Define expected presets and implement spawn routines + cleanup. |
-| `create_dynamic_light` | Spawns lights, sets intensity/color; no undo/pulse logic. | Add transactions, pulse animation, optional mobility + cleanup helpers. |
-
-## UI Handlers
-
-| Action | Current State | Needed Work |
-| --- | --- | --- |
-| `create_hud` | Implemented (creates widget + adds to viewport). | ✅ Done |
-| `set_widget_text` | Implemented (finds widget + sets text). | ✅ Done |
-| `set_widget_image` | Implemented (loads texture + sets image). | ✅ Done |
-| `set_widget_visibility` | Implemented (finds widget + sets visibility). | ✅ Done |
-| `remove_widget_from_viewport` | Implemented (removes widget). | ✅ Done |
-
-## Editor Function Helpers
-
-- `execute_editor_function` routes many editor actions.
-- `CALL_SUBSYSTEM` added for generic subsystem access.
-- `ADD_WIDGET_TO_VIEWPORT` implemented.
-
-## Advanced Authoring Tools
-
-### Skeleton & Rigging (`animation_physics`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `get_skeleton_info`, `list_bones`, `list_sockets` | ✅ Done | Query operations |
-| `create_socket`, `configure_socket`, `create_virtual_bone` | ✅ Done | Native implementation |
-| `create_physics_asset`, `add_physics_body`, `configure_physics_body` | ✅ Done | Physics asset creation |
-| `add_physics_constraint`, `configure_constraint_limits` | ✅ Done | Constraint setup |
-| `bind_cloth_to_skeletal_mesh` | ✅ Done | Uses `UClothingAssetBase::BindToSkeletalMesh()` |
-| `create_morph_target`, `set_morph_target_deltas` | ✅ Done | Morph target authoring |
-
-### Material Authoring (`manage_asset`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_material`, `set_blend_mode`, `set_shading_model` | ✅ Done | Material creation |
-| `add_texture_sample`, `add_scalar_parameter`, `add_vector_parameter` | ✅ Done | Expression nodes |
-| `add_math_node`, `add_fresnel`, `add_noise`, `add_voronoi` | ✅ Done | Math & procedural |
-| `connect_nodes`, `disconnect_nodes` | ✅ Done | Graph connections |
-| `create_material_instance`, `set_*_parameter_value` | ✅ Done | Material instances |
-| `add_landscape_layer` | ✅ Done | Uses `ULandscapeLayerInfoObject` |
-| `configure_layer_blend` | ✅ Guidance | Layer blending via material expressions |
-
-### Texture (`manage_asset`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_noise_texture`, `create_gradient_texture`, `create_pattern_texture` | ✅ Done | Procedural generation |
-| `create_normal_from_height` | ✅ Done | Height-to-normal conversion |
-| `set_compression_settings`, `set_texture_group`, `configure_virtual_texture` | ✅ Done | Texture settings |
-| `get_texture_info` | ✅ Done | Texture properties |
-| `create_ao_from_mesh` | ✅ Done | GPU ray tracing for real AO baking |
-| `adjust_curves`, `channel_extract` | ✅ Done | LUT-based curve adjustment, channel extraction |
-| Texture processing (blur, resize, levels) | ✅ Done | Implemented via FImageUtils and platform texture ops |
-
-### Animation Authoring (`animation_physics`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_animation_sequence`, `add_bone_track`, `set_bone_key` | ✅ Done | Keyframe animation |
-| `create_montage`, `add_montage_section`, `add_montage_slot` | ✅ Done | Montage authoring |
-| `create_blend_space_1d`, `create_blend_space_2d`, `add_blend_sample` | ✅ Done | Blend spaces |
-| `create_anim_blueprint`, `add_state_machine`, `add_state`, `add_transition` | ✅ Done | AnimBP state machines |
-| `create_control_rig` | ✅ Done | Uses `UControlRigBlueprintFactory` |
-| `create_ik_rig` | ✅ Done | Uses `UIKRigDefinitionFactory` |
-| `create_ik_retargeter` | ✅ Done | Uses `UIKRetargetFactory` |
-
-### Audio Authoring (`manage_audio`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_sound_cue`, `add_cue_node`, `connect_cue_nodes` | ✅ Done | Sound Cue graph |
-| `create_metasound`, `add_metasound_node` | ✅ Done | MetaSound authoring |
-| `create_sound_class`, `create_sound_mix` | ✅ Done | Audio classes & mixes |
-| `create_attenuation_settings`, `configure_spatialization` | ✅ Done | 3D audio settings |
-| `create_dialogue_voice`, `create_dialogue_wave` | ✅ Done | Dialogue system |
-
-### Niagara Authoring (`manage_effect`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_niagara_system`, `create_niagara_emitter` | ✅ Done | System/emitter creation |
-| `add_spawn_rate_module`, `add_initialize_particle_module` | ✅ Done | Spawn modules |
-| `add_force_module`, `add_velocity_module` | ✅ Done | Physics modules |
-| `add_sprite_renderer_module`, `add_mesh_renderer_module` | ✅ Done | Renderers |
-| `add_user_parameter`, `bind_parameter_to_source` | ✅ Done | Parameter binding |
-| `enable_gpu_simulation`, `add_simulation_stage` | ✅ Done | GPU simulation |
-
-### Gameplay Ability System (`manage_gas`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `add_ability_system_component`, `create_attribute_set` | ✅ Done | GAS setup |
-| `create_gameplay_ability`, `set_ability_costs`, `set_ability_cooldown` | ✅ Done | Ability authoring |
-| `create_gameplay_effect`, `add_effect_modifier` | ✅ Done | Effect creation |
-| `create_gameplay_cue_notify`, `set_cue_effects` | ✅ Done | Gameplay cues |
-
-### Character System (`manage_character`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_character_blueprint`, `configure_capsule_component` | ✅ Done | Character creation |
-| `configure_movement_speeds`, `configure_jump`, `configure_rotation` | ✅ Done | Movement setup |
-| `setup_mantling`, `setup_vaulting`, `setup_climbing` | ✅ Done | Advanced movement |
-| `setup_footstep_system`, `map_surface_to_sound` | ✅ Done | Footstep system |
-
-### Combat System (`manage_combat`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_weapon_blueprint`, `set_weapon_stats` | ✅ Done | Weapon creation |
-| `configure_hitscan`, `configure_projectile` | ✅ Done | Firing modes |
-| `create_projectile_blueprint`, `configure_projectile_homing` | ✅ Done | Projectiles |
-| `create_damage_type`, `setup_hitbox_component` | ✅ Done | Damage system |
-| `configure_combo_system`, `create_hit_pause` | ✅ Done | Melee combat |
-
-### AI System (`manage_ai`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_ai_controller`, `assign_behavior_tree` | ✅ Done | AI controller |
-| `create_blackboard_asset`, `add_blackboard_key` | ✅ Done | Blackboard |
-| `create_eqs_query`, `add_eqs_generator`, `add_eqs_test` | ✅ Done | EQS queries |
-| `add_ai_perception_component`, `configure_sight_config` | ✅ Done | Perception |
-| `create_state_tree`, `add_state_tree_state` | ✅ Done | State Trees (UE5.3+) |
-| `create_smart_object_definition`, `add_smart_object_slot` | ✅ Done | Smart Objects |
-
-### Inventory System (`manage_inventory`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_item_data_asset`, `set_item_properties` | ✅ Done | Item data |
-| `create_inventory_component`, `configure_inventory_slots` | ✅ Done | Inventory component |
-| `create_equipment_component`, `define_equipment_slots` | ✅ Done | Equipment |
-| `create_loot_table`, `add_loot_entry` | ✅ Done | Loot system |
-| `create_crafting_recipe`, `create_crafting_station` | ✅ Done | Crafting |
-
-### Interaction System (`manage_interaction`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_interaction_component`, `configure_interaction_trace` | ✅ Done | Interaction setup |
-| `create_door_actor`, `create_switch_actor`, `create_chest_actor` | ✅ Done | Interactables |
-| `setup_destructible_mesh`, `configure_destruction_effects` | ✅ Done | Destructibles |
-| `create_trigger_actor`, `configure_trigger_events` | ✅ Done | Triggers |
-
-### Widget Authoring (`manage_blueprint`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_widget_blueprint`, `set_widget_parent_class` | ✅ Done | Widget creation |
-| `add_canvas_panel`, `add_horizontal_box`, `add_vertical_box` | ✅ Done | Layout containers |
-| `add_grid_panel`, `add_uniform_grid`, `add_wrap_box`, `add_scroll_box` | ✅ Done | Advanced layouts |
-| `add_size_box`, `add_scale_box`, `add_border` | ✅ Done | Sizing containers |
-| `add_text_block`, `add_rich_text_block`, `add_image`, `add_button` | ✅ Done | Common widgets |
-| `add_check_box`, `add_slider`, `add_progress_bar`, `add_text_input` | ✅ Done | Input widgets |
-| `add_combo_box`, `add_spin_box`, `add_list_view`, `add_tree_view` | ✅ Done | Advanced widgets |
-| `set_anchor`, `set_alignment`, `set_position`, `set_size` | ✅ Done | Layout properties |
-| `set_padding`, `set_z_order`, `set_render_transform`, `set_visibility` | ✅ Done | Visual properties |
-| `set_style`, `set_clipping` | ✅ Done | Styling |
-| Property bindings (`bind_text`, `bind_visibility`, etc.) | ✅ Guidance | Requires Blueprint graph |
-| Widget animations | ✅ Guidance | Requires Sequencer/UMG integration |
-| UI templates (main_menu, HUD, etc.) | ✅ Guidance | Composite widgets |
-| `preview_widget` | ✅ Done | Triggers recompile |
-
-### Networking (`manage_networking`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `set_property_replicated`, `set_replication_condition` | ✅ Done | Property replication |
-| `configure_net_update_frequency`, `configure_net_priority` | ✅ Done | Net settings |
-| `create_rpc_function`, `configure_rpc_validation` | ✅ Done | RPC creation |
-| `set_owner`, `set_autonomous_proxy` | ✅ Done | Authority |
-| `configure_client_prediction`, `configure_server_correction` | ✅ Done | Network prediction |
-| `configure_replicated_movement` | ✅ Done | Movement replication |
-
-### Audio Authoring (`manage_audio`)
-
-`manage_audio` exposes 50 actions. Regular playback/runtime actions route through `HandleAudioAction`; the 30 graph and asset-authoring actions route through the internal native `manage_audio_authoring` bridge action.
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_sound_cue`, `create_metasound` | ✅ Done | Audio asset creation |
-| `create_sound_class`, `create_sound_mix` | ✅ Done | Sound classes/mixes |
-| `create_attenuation_settings` | ✅ Done | Attenuation |
-| `create_dialogue_voice`, `create_dialogue_wave` | ✅ Done | Dialogue system |
-| `add_cue_node`, `connect_cue_nodes` | ✅ Done | Sound cue graphs |
-| `add_metasound_node`, `connect_metasound_nodes`, `add_metasound_input`, `add_metasound_output`, `set_metasound_default` | ✅ Done | MetaSound graphs |
-| `set_class_properties`, `set_class_parent`, `add_mix_modifier`, `configure_mix_eq` | ✅ Done | Sound class and mix authoring |
-| `configure_distance_attenuation`, `configure_spatialization`, `configure_occlusion`, `configure_reverb_send` | ✅ Done | Attenuation authoring |
-| `create_reverb_effect`, `create_source_effect_chain`, `add_source_effect`, `create_submix_effect`, `get_audio_info` | ✅ Done | Effects and info |
-
-### Game Framework (`manage_networking`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_game_mode`, `create_game_state` | ✅ Done | Core game classes |
-| `create_player_controller`, `create_player_state` | ✅ Done | Player classes |
-| `create_game_instance`, `create_hud_class` | ✅ Done | Instance & HUD |
-| `set_default_pawn_class`, `set_player_controller_class` | ✅ Done | Class configuration |
-| `set_game_state_class`, `set_player_state_class` | ✅ Done | State configuration |
-| `configure_game_rules` | ✅ Done | Game rules setup |
-| `setup_match_states`, `configure_round_system` | ✅ Done | Match flow |
-| `configure_team_system`, `configure_scoring_system` | ✅ Done | Teams & scoring |
-| `configure_spawn_system`, `configure_player_start` | ✅ Done | Spawn configuration |
-| `set_respawn_rules`, `configure_spectating` | ✅ Done | Player management |
-| `get_game_framework_info` | ✅ Done | Query game mode info |
-
-### Sessions & Local Multiplayer (`manage_networking`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `configure_local_session_settings` | ✅ Done | Max players, session name |
-| `configure_session_interface` | ✅ Done | Online subsystem interface |
-| `configure_split_screen` | ✅ Done | Enable/disable split-screen |
-| `set_split_screen_type` | ✅ Done | Horizontal, vertical, quadrant |
-| `add_local_player` | ✅ Done | Add local player |
-| `remove_local_player` | ✅ Done | Remove local player |
-| `configure_lan_play` | ✅ Done | LAN broadcast settings |
-| `host_lan_server` | ✅ Done | Host LAN server |
-| `join_lan_server` | ✅ Done | Join by IP/port |
-| `enable_voice_chat` | ✅ Done | Enable/disable voice |
-| `configure_voice_settings` | ✅ Done | Voice input/output settings |
-| `set_voice_channel` | ✅ Done | Player voice channel |
-| `mute_player` | ✅ Done | Mute/unmute player |
-| `set_voice_attenuation` | ✅ Done | 3D voice attenuation |
-| `configure_push_to_talk` | ✅ Done | PTT settings |
-| `get_sessions_info` | ✅ Done | Query session info |
-
-### Level Structure (`manage_level_structure`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_level`, `create_sublevel` | ✅ Done | Level asset creation |
-| `configure_level_streaming` | ✅ Done | Streaming method configuration |
-| `set_streaming_distance` | ✅ Done | Creates ALevelStreamingVolume and associates with ULevelStreaming; configures StreamingUsage |
-| `configure_level_bounds` | ✅ Done | Bounds for streaming/culling |
-| `enable_world_partition` | ✅ Done | Reports WP status; returns error if cannot enable (requires editor UI) |
-| `configure_grid_size` | ✅ Done | Uses reflection to modify FSpatialHashRuntimeGrid array (CellSize, LoadingRange, Priority) |
-| `create_data_layer` | ✅ Done | Creates UDataLayerAsset + UDataLayerInstance via UDataLayerEditorSubsystem |
-| `assign_actor_to_data_layer` | ✅ Done | Uses UDataLayerEditorSubsystem::AddActorToDataLayer() |
-| `configure_hlod_layer` | ✅ Done | Creates UHLODLayer asset with layer type, cell size, loading distance |
-| `create_minimap_volume` | ✅ Done | Spawns AWorldPartitionMiniMapVolume (requires World Partition) |
-| `open_level_blueprint` | ✅ Done | Open Level BP in editor |
-| `add_level_blueprint_node` | ✅ Done | Add node to Level BP |
-| `connect_level_blueprint_nodes` | ✅ Done | Connect BP node pins |
-| `create_level_instance` | ✅ Done | ALevelInstance creation |
-| `create_packed_level_actor` | ✅ Done | APackedLevelActor creation |
-| `get_level_structure_info` | ✅ Done | Query level structure info |
-
-### Volumes & Zones (`manage_level_structure`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| `create_trigger_volume`, `create_trigger_box`, `create_trigger_sphere`, `create_trigger_capsule` | ✅ Done | Trigger volumes |
-| `create_blocking_volume`, `create_kill_z_volume` | ✅ Done | Gameplay volumes |
-| `create_pain_causing_volume`, `create_physics_volume` | ✅ Done | Physics/damage volumes |
-| `create_audio_volume`, `create_reverb_volume` | ✅ Done | Audio volumes |
-| `create_cull_distance_volume`, `create_precomputed_visibility_volume` | ✅ Done | Rendering volumes |
-| `create_lightmass_importance_volume` | ✅ Done | Lighting volumes |
-| `create_nav_mesh_bounds_volume`, `create_nav_modifier_volume` | ✅ Done | Navigation volumes |
-| `create_camera_blocking_volume` | ✅ Done | Camera volumes |
-| `set_volume_extent`, `set_volume_properties`, `get_volumes_info` | ✅ Done | Configuration & utility |
-
-### Navigation System (`manage_ai`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| **NavMesh Configuration** | | |
-| `configure_nav_mesh_settings` | ✅ Done | Sets TileSizeUU, MinRegionArea, NavMeshResolutionParams (UE 5.7+) |
-| `set_nav_agent_properties` | ✅ Done | Sets AgentRadius, AgentHeight, AgentMaxSlope, AgentMaxStepHeight |
-| `rebuild_navigation` | ✅ Done | Calls `NavSys->Build()` |
-| **Nav Modifiers** | | |
-| `create_nav_modifier_component` | ✅ Done | Creates UNavModifierComponent via SCS |
-| `set_nav_area_class` | ✅ Done | Sets area class on modifier component |
-| `configure_nav_area_cost` | ✅ Done | Configures DefaultCost on area CDO |
-| **Nav Links** | | |
-| `create_nav_link_proxy` | ✅ Done | Spawns ANavLinkProxy with PointLinks |
-| `configure_nav_link` | ✅ Done | Updates link start/end points, direction, snap radius |
-| `set_nav_link_type` | ✅ Done | Toggles bSmartLinkIsRelevant |
-| `create_smart_link` | ✅ Done | Spawns NavLinkProxy with smart link enabled |
-| `configure_smart_link_behavior` | ✅ Done | Configures UNavLinkCustomComponent (area classes, broadcast, obstacles) |
-| **Utility** | | |
-| `get_navigation_info` | ✅ Done | Returns NavMesh stats, agent properties, link/volume counts |
-
-### Spline System (`build_environment`)
-
-| Action | Status | Notes |
-|--------|--------|-------|
-| **Spline Creation** | | |
-| `create_spline_actor` | ✅ Done | Creates ASplineActor with USplineComponent |
-| `add_spline_point` | ✅ Done | Adds point at index with position/tangent |
-| `remove_spline_point` | ✅ Done | Removes point at specified index |
-| `set_spline_point_position` | ✅ Done | Sets point location in world/local space |
-| `set_spline_point_tangents` | ✅ Done | Sets arrive/leave tangents |
-| `set_spline_point_rotation` | ✅ Done | Sets point rotation |
-| `set_spline_point_scale` | ✅ Done | Sets point scale |
-| `set_spline_type` | ✅ Done | Sets type (linear, curve, constant, clamped_curve) |
-| **Spline Mesh** | | |
-| `create_spline_mesh_component` | ✅ Done | Creates USplineMeshComponent on actor |
-| `set_spline_mesh_asset` | ✅ Done | Sets static mesh asset on spline mesh |
-| `configure_spline_mesh_axis` | ✅ Done | Sets forward axis (X, Y, Z) |
-| `set_spline_mesh_material` | ✅ Done | Sets material on spline mesh |
-| **Mesh Scattering** | | |
-| `scatter_meshes_along_spline` | ✅ Done | Spawns mesh instances along spline |
-| `configure_mesh_spacing` | ✅ Done | Sets spacing mode (distance, count) |
-| `configure_mesh_randomization` | ✅ Done | Sets random offset, rotation, scale |
-| **Quick Templates** | | |
-| `create_road_spline` | ✅ Done | Creates road with configurable width, lanes |
-| `create_river_spline` | ✅ Done | Creates river with water material |
-| `create_fence_spline` | ✅ Done | Creates fence with posts and rails |
-| `create_wall_spline` | ✅ Done | Creates wall with height and thickness |
-| `create_cable_spline` | ✅ Done | Creates hanging cable with sag |
-| `create_pipe_spline` | ✅ Done | Creates pipe with radius and segments |
-| **Utility** | | |
-| `get_splines_info` | ✅ Done | Returns spline info (points, length, closed) |
-
-## Next Steps
-
-1. Expand profiling/validation coverage beyond the completed Insights trace workflow and existing `validate_assets` coverage.
-2. Continue cinematic/media expansion now that the rendering surface is complete.
-3. Infrastructure, multiplayer/session, world-building, PCG, and advanced lighting/rendering surfaces are complete. ✅ Done

package/mcps/unreal_mcp/docs/testing-guide.md

@@ -1,149 +0,0 @@
-# Testing Guide
-
-## Overview
-
-This project uses consolidated integration test suites covering the 23 canonical MCP tools:
-- **Canonical Integration Suite** (`tests/integration.mjs`) for cross-tool workflows
-- **Per-Tool MCP Suites** (`tests/mcp-tools/**/*.test.mjs`) for every exposed parent tool
-
-Plus Vitest for unit tests and a CI smoke test for mock-mode validation.
-
-## Test Commands
-
-| Command | Description | Requires UE? |
-|---------|-------------|--------------|
-| `npm test` | Run canonical integration suite | Yes |
-| `node tests/mcp-tools/<category>/<tool>.test.mjs` | Run one per-tool MCP suite | Yes |
-| `npm run test:all` | Run canonical integration entrypoint | Yes |
-| `npm run test:unit` | Run Vitest unit tests | No |
-| `npm run test:smoke` | CI smoke test (mock mode) | No |
-
-## Integration Tests
-
-### Running
-
-```bash
-# Ensure Unreal Engine is running with MCP Automation Bridge plugin enabled
-npm test
-node tests/mcp-tools/core/manage-asset.test.mjs
-for f in tests/mcp-tools/{core,gameplay,utility,world}/*.test.mjs; do node "$f"; done
-```
-
-### Canonical Integration Suite (`tests/integration.mjs`)
-
-Covers cross-tool workflows across the 23 canonical MCP tools:
-- Infrastructure & Discovery
-- Asset & Material Lifecycle
-- Actor Control & Introspection
-- Blueprint Authoring
-- Environment & Visuals
-- AI & Input
-- Cinematics & Audio
-- Operations & Performance
-
-### Per-Tool MCP Suites (`tests/mcp-tools/**/*.test.mjs`)
-
-Covers every exposed parent tool with domain-specific setup and teardown:
-- Core: `manage_tools`, `manage_asset`, `manage_blueprint`, `control_actor`, `control_editor`, `manage_level`, `inspect`, `system_control`
-- World: `build_environment`, `manage_level_structure`, `manage_geometry`, `manage_pcg`
-- Gameplay: `animation_physics`, `manage_effect`, `manage_ai`, `manage_gas`, `manage_character`, `manage_combat`, `manage_inventory`, `manage_interaction`
-- Utility: `manage_audio`, `manage_sequence`, `manage_networking`
-
-### Test Structure
-
-```
-tests/
-├── integration.mjs          # Canonical integration suite
-├── mcp-tools/               # Per-tool canonical MCP suites
-├── test-runner.mjs          # Shared test harness
-└── reports/                 # JSON test results (gitignored)
-```
-
-### Adding New Tests
-
-Edit `tests/integration.mjs` and add a test case to the `testCases` array:
-
-```javascript
-{
-  scenario: 'Your test description',
-  toolName: 'manage_asset',
-  arguments: { action: 'list', path: '/Game/MyFolder' },
-  expected: 'success'
-}
-```
-
-The `expected` field supports flexible matching:
-- `'success'` — response must have `success: true`
-- `'success|not found'` — either success OR "not found" in response
-- `'error'` — expects failure
-
-### Test Output
-
-Console shows pass/fail status with timing:
-```
-[PASSED] Asset: create test folder (234.5 ms)
-[PASSED] Actor: spawn StaticMeshActor (456.7 ms)
-[FAILED] Level: get summary (123.4 ms) => {"success":false,"error":"..."}
-```
-
-JSON reports are saved to `tests/reports/` with timestamps.
-
-## Unit Tests
-
-```bash
-npm run test:unit        # Run once
-npm run test:unit:watch  # Watch mode
-npm run test:unit:coverage  # With coverage
-```
-
-Unit tests use Vitest and don't require Unreal Engine. They cover:
-- Utility functions (`normalize.ts`, `validation.ts`, `safe-json.ts`)
-- Pure TypeScript logic
-
-## CI Smoke Test
-
-```bash
-MOCK_UNREAL_CONNECTION=true npm run test:smoke
-```
-
-Runs in GitHub Actions on every push/PR. Uses mock mode to validate server startup and basic tool registration without an actual Unreal connection.
-
-## Prerequisites
-
-### Unreal Engine Setup
-1. **Unreal Engine 5.0–5.8 Preview** must be running
-2. **MCP Automation Bridge plugin** enabled and listening on port 8091
-
-### Environment Variables (optional)
-```bash
-MCP_AUTOMATION_HOST=127.0.0.1  # Default
-MCP_AUTOMATION_PORT=8091       # Default
-MCP_CONNECTION_TIMEOUT_MS=5000 # Connection and handshake timeout
-```
-
-## Troubleshooting
-
-### All Tests Fail with ECONNREFUSED
-- Unreal Engine is not running, or
-- MCP Automation Bridge plugin is not enabled, or
-- Port 8091 is blocked
-
-### Specific Tests Fail
-- Check Unreal Output Log for errors
-- Verify the asset/actor/level referenced in the test exists
-- Some tests create temporary assets in `/Game/IntegrationTest` (cleaned up at end)
-
-### Test Times Out
-- Default timeout is 30 seconds per test
-- Complex operations (lighting builds, large imports) may need longer
-- Check if Unreal is frozen or unresponsive
-
-## Exit Codes
-
-- `0` — All tests passed
-- `1` — One or more tests failed
-
-Use in CI/CD:
-```bash
-npm test && echo "All tests passed"
-```

package/mcps/unreal_mcp/plugins/McpAutomationBridge/Source/McpAutomationBridge/Private/Domains/Test/McpAutomationBridge_TestHandlers.cpp

@@ -1,74 +0,0 @@
-// =============================================================================
-// McpAutomationBridge_TestHandlers.cpp
-// =============================================================================
-// MCP Automation Bridge - Test Automation Handlers
-//
-// UE Version Support: 5.0, 5.1, 5.2, 5.3, 5.4, 5.5, 5.6, 5.7
-//
-// Handler Summary:
-// -----------------------------------------------------------------------------
-// Action: manage_tests
-//   - run_tests: Execute automation tests by filter via editor automation command
-//
-// Dependencies:
-//   - Core: McpAutomationBridgeSubsystem
-//
-// Notes:
-//   - Tests run asynchronously; results appear in logs/automation_event streams
-// =============================================================================
-
-#include "Core/Compatibility/McpVersionCompatibility.h"  // MUST be first - UE version compatibility macros
-
-// -----------------------------------------------------------------------------
-// Core Includes
-// -----------------------------------------------------------------------------
-#include "McpAutomationBridgeSubsystem.h"
-#include "Domains/SystemControl/McpAutomationBridge_SystemControlHandlersPrivate.h"
-#include "Foundation/BridgeHelpers/Responses/McpAutomationBridgeHelpersJsonFields.h" // UE5.8: explicit include (unity regroup no longer pulls GetJsonStringField transitively)
-
-// -----------------------------------------------------------------------------
-// Engine Includes
-// -----------------------------------------------------------------------------
-#include "Dom/JsonObject.h"
-
-// =============================================================================
-// Handler Implementation
-// =============================================================================
-
-bool UMcpAutomationBridgeSubsystem::HandleTestAction(
-    const FString& RequestId,
-    const FString& Action,
-    const TSharedPtr<FJsonObject>& Payload,
-    TSharedPtr<FMcpBridgeWebSocket> RequestingSocket)
-{
-    // Validate action
-    if (Action != TEXT("manage_tests"))
-    {
-        return false;
-    }
-
-    // Validate payload
-    if (!Payload.IsValid())
-    {
-        SendAutomationError(RequestingSocket, RequestId,
-            TEXT("Missing payload."), TEXT("INVALID_PAYLOAD"));
-        return true;
-    }
-
-    // Extract subaction
-    const FString SubAction = GetJsonStringField(Payload, TEXT("subAction"));
-
-    // -------------------------------------------------------------------------
-    // run_tests: Execute automation tests by filter
-    // -------------------------------------------------------------------------
-    if (SubAction == TEXT("run_tests"))
-    {
-        return McpSystemControlHandlers::HandleRunTests(
-            this, RequestId, Payload, RequestingSocket);
-    }
-
-    // Unknown subaction
-    SendAutomationError(RequestingSocket, RequestId,
-        TEXT("Unknown subAction."), TEXT("INVALID_SUBACTION"));
-    return true;
-}