{
  "schema_version": 1,
  "id": "WEST-ONLINE-DECISION-RECORD-R05",
  "date": "2026-10-17",
  "status": "ARCHITECTURE BRIEF; proposed benchmark; no engine acceptance",
  "author": {"side": "MARLEY", "agent": "Codex", "seat": "west_streaming_architecture", "model": "gpt-6.1-sol-wm"},
  "observed_main_sha": "cc37e89eab671939f5f0ea61943f1545c67abe63",
  "authority": {
    "existing_connected_city_decision": "docs/current-decisions.md section 7, Legend 2026-10-15",
    "current_district_protocol": "production/protocols/district/R04/GUIDE.md",
    "current_spatial_workflow": "production/workflows/spatial-imagery/R01/GUIDE.md",
    "proposed_frame": "docs/southwest-prep/R03/foundation/WORLD_FRAME_PROPOSAL.json",
    "new_creator_instruction": "Use the supplied revised E/W production divider with all Crown Key and the southern island in West; focus production on West.",
    "new_instruction_scope": "Production organization and map coverage; no geographic move, metric rotation, server topology or final capacity approval."
  },
  "recommendation": {
    "project_count": 1,
    "world_direction": "One selected authoritative World Partition world with shared metric frame; actual integration map unselected here.",
    "first_milestone": "Connected West sample, followed by West-first production rollout.",
    "nw_sw_labels": "Neighborhood and production-region metadata retained.",
    "routine_nw_sw_level_travel": false,
    "first_benchmark_authority": "One dedicated-server process for the connected sample.",
    "final_server_process_count": null,
    "final_physical_host_count": null,
    "final_supported_concurrent_users": null,
    "persistent_city_hundreds_of_users": "Existing design target; not a demonstrated capacity.",
    "replication_system_selected_here": null,
    "reason": "A map production divider need not create a player-session or authority crossing. Capacity follows measured gameplay, replication and simulation load."
  },
  "separate_concepts": [
    {"concept": "production_region", "purpose": "Inventory, image coverage and ownership", "implies_server_boundary": false},
    {"concept": "unreal_project", "purpose": "Shared code, assets and build configuration", "implies_one_physical_machine": false},
    {"concept": "world_partition_cell", "purpose": "Spatial content loading", "implies_network_authority": false},
    {"concept": "game_server_authority", "purpose": "Owns live authoritative gameplay state", "implies_durable_storage": false},
    {"concept": "durable_state", "purpose": "Defined state survives specified failure/restart conditions", "provided_by_world_partition": false}
  ],
  "version_review": {
    "retrieved_at": "2026-10-17",
    "official_documentation_display_version": "Unreal Engine 5.8",
    "actual_project_engine_version": null,
    "actual_project_patch": null,
    "actual_project_net_driver": null,
    "actual_project_replication_system": null,
    "actual_server_streaming_mode": null,
    "actual_server_build_target": null,
    "iris_release_notes_status": "Production-ready for licensees in UE5.8 per E7.",
    "iris_documentation_conflict": "E8 introduction and Iris overview still show Experimental banners. Use version-specific release notes for milestone; verify installed build compatibility before migration.",
    "iris_replication_graph_relationship": "Alternative systems for a net driver; do not enable both as a combined optimization.",
    "multi_server_plugin_status": "Experimental per E4; not enabled, configured or selected by this work."
  },
  "local_engine_audit": {
    "scope": "Hydrated local repo snapshot only, not full Quik project or full repository.",
    "searched_patterns": ["*.uproject", "*Engine.ini", "*Game.ini", "*.Target.cs"],
    "matching_files_found": [],
    "result": "Source unavailable in this snapshot; actual configuration unverified.",
    "engine_launched": false,
    "configuration_changed": false,
    "network_load_tests_run": false,
    "server_provisioned": false
  },
  "test_plan": {
    "state": "not_tested",
    "connection_stages": [2, 16, 64, 128, 256],
    "stage_interpretation": "Proposed experiments only; stop when a budget fails. NPCs/server-only bots do not count as network clients.",
    "completed_load_stage_duration_minutes_proposed": 30,
    "first_sample_route": "Crown Key-West bridge, arrival, cafe/lobby, neighboring street and crossing A; southern-island vista.",
    "proposed_lab_budget": {
      "status": "PROPOSED; not release acceptance or final tick-rate selection",
      "server_tick_hz": 30,
      "server_frame_budget_ms": 33.333333,
      "server_frame_p95_max_ms": 26.666667,
      "server_frame_p99_max_ms": 33.333333,
      "p95_headroom_fraction": 0.2,
      "host_specification": null,
      "client_frame_budget": null,
      "bandwidth_budget": null,
      "replication_update_age_budget": null,
      "join_time_budget": null,
      "streaming_stall_budget": null,
      "pending_budget_reason": "Set against intended gameplay, supported client/host hardware and network profiles before a release pass."
    },
    "required_record_fields": ["project_commit", "packaged_build_id", "engine_version_patch", "host_cpu_ram_network", "client_hardware", "net_driver", "replication_system", "server_streaming_mode", "connected_clients", "replicated_actor_count", "ai_count", "vehicle_count", "latency_loss_profile", "test_duration", "server_frame_p95_p99", "replication_time", "bandwidth_per_client_total", "memory", "client_frame_percentiles", "streaming_stalls", "corrections", "trace_paths"],
    "matrix": [
      {"id": "WEST-NET-01", "state": "not_tested", "case": "Two-client shared-route smoke", "evidence": "Same session and authority across bridge/A, consistent actors/collision, no boundary travel or disconnect."},
      {"id": "WEST-NET-02", "state": "not_tested", "case": "Fast vehicle traversal and vista/lobby transitions", "evidence": "Client loading stalls, frame times, memory, collision and distant representation."},
      {"id": "WEST-NET-03", "state": "not_tested", "case": "Distributed connected population", "evidence": "16/64/128/256 staged actual connections, 30 minutes per completed stage, server/replication/network traces."},
      {"id": "WEST-NET-04", "state": "not_tested", "case": "Crowded cafe/arrival/event", "evidence": "Repeat completed stages with clustered users and explicit AI/traffic counts; compare relevance/update-age/corrections."},
      {"id": "WEST-NET-05", "state": "not_tested", "case": "Fixed-client AI and vehicle load comparison", "evidence": "No-ambient-AI baseline versus owner-recorded representative AI/traffic load; isolate simulation costs."},
      {"id": "WEST-NET-06", "state": "not_tested", "case": "Impaired network, join/disconnect/reconnect", "evidence": "Declared supported network profiles; correct state convergence, ownership and no duplicates during travel."},
      {"id": "WEST-NET-07", "state": "not_tested", "case": "Persistent-state restart/recovery", "evidence": "Declared inventory/door/vehicle state survives implemented save/restart path; no duplication or ownership loss."}
    ]
  },
  "decision_triggers": [
    {"observed": "Required crowded and distributed stages meet agreed budgets", "action": "Retain single-authority approach for that tested scope; do not extrapolate untested counts."},
    {"observed": "Client rendering, streaming or memory fails", "action": "Tune content, HLOD/loading and client budgets; this alone does not justify a server split."},
    {"observed": "Server AI, physics or replication fails", "action": "Profile and tune that cost; compare existing replication with one justified alternative on identical workload."},
    {"observed": "Agreed population cannot fit after measured optimization", "action": "Commission bounded instancing or multi-server experiment; demonstrate identity, combat/vehicles, cross-boundary interest, durable writes, reconnect and failure recovery before selecting topology."}
  ],
  "official_sources": [
    {"id": "E1", "title": "World Partition", "url": "https://dev.epicgames.com/documentation/unreal-engine/world-partition-in-unreal-engine", "retrieval_ref": "turn9view0"},
    {"id": "E2", "title": "Setting Up Dedicated Servers", "url": "https://dev.epicgames.com/documentation/unreal-engine/setting-up-dedicated-servers-in-unreal-engine", "retrieval_ref": "turn8view4"},
    {"id": "E3", "title": "EWorldPartitionServerStreamingMode", "url": "https://dev.epicgames.com/documentation/unreal-engine/API/Runtime/Engine/EWorldPartitionServerStreamingMo-?lang=en-US", "retrieval_ref": "turn11view4"},
    {"id": "E4", "title": "Multi-server Replication", "url": "https://dev.epicgames.com/documentation/unreal-engine/API/PluginIndex/MultiServerReplication?lang=en-US", "retrieval_ref": "turn11view0"},
    {"id": "E4b", "title": "UMultiServerNode", "url": "https://dev.epicgames.com/documentation/en-us/unreal-engine/API/Plugins/MultiServerReplication/UMultiServerNode", "retrieval_ref": "turn11view1"},
    {"id": "E5", "title": "Replication Graph", "url": "https://dev.epicgames.com/documentation/unreal-engine/replication-graph-in-unreal-engine", "retrieval_ref": "turn10view0"},
    {"id": "E6", "title": "Migrate to Iris", "url": "https://dev.epicgames.com/documentation/en-us/unreal-engine/migrate-to-iris-in-unreal-engine", "retrieval_ref": "turn11view2"},
    {"id": "E7", "title": "Unreal Engine 5.8 Release Notes", "url": "https://dev.epicgames.com/documentation/unreal-engine/unreal-engine-5-8-release-notes?lang=en-US", "retrieval_ref": "turn13search0"},
    {"id": "E8", "title": "Introduction to Iris", "url": "https://dev.epicgames.com/documentation/en-us/unreal-engine/introduction-to-iris-in-unreal-engine", "retrieval_ref": "turn11view3"}
  ],
  "publication": {"site_safe": true, "coordinator": "Parent SW session", "state": "Prepared locally for coordinator publication and append-only checkpoint; no branch/main/deployment claim."},
  "acceptance": {"new_metric_scale_accepted": false, "new_building_placement_accepted": false, "construction_released": false, "engine_integration_pass": false, "multiplayer_capacity_pass": false}
}
