# Port progress: M4 to M10 (one line per milestone; the pick-up note after a cut-off)

Rules from the user (2026-10-06): finish the port; function first, blockout looks, one scenario per acceptance row, no polish, no questions.
Workplace `D:\HADAL - The Descent\TheDescentUE`. After each milestone: build, tests, its scenarios; full scenario set after M5, M8, M10.
Patch scripts and the runner live in the session scratchpad (`run.sh -b -t <scenarios>`); nothing outside the project is needed to continue.

| Milestone | State | What is left for later |
|---|---|---|
| Fix list M1-M3 | closed, all six in (`fixes_m3.md`) | polish only |
| M4 Mine | DONE 2026-10-06: `m4_mine`, `m4_cargo_display`, `m4_tool`, `m4_meters`, `m4_basalt` PASS | crystals on the veins; laser head has no beam (logic only, T swaps it once `Descent.Upgrade Laser 1`); drill sparks, debris, stream, tool swivel; a swimmer taking a loose chunk with E |
| M5 Unload, box, refine | DONE 2026-10-06: tests `Descent.Cargo.PackerMath`, `.PipeRoute`, `Descent.Store.Ledger`; `m5_core_loop`, `m5_sell`, `m5_packer_full` PASS | hand intake hatch; bio pipe; boom swing animation; buffer shown through glass; storage-wall window; put-down has no overlap test |
| M6 Pilot the carrier | DONE 2026-10-06: `Descent.Helm.Dynamics`, `Descent.Routes.BlockedBeforeDig`, `ReachGoal_1`, `ReachGoal_3` PASS; `m6_helm_speed`, `m6_helm_mouse`, `m6_scrape`, `m6_walk_moving` PASS. `Descent.Routes.ReachGoal_2` failed here and was fixed on 2026-10-06 after M10 (the autopilot lines up over a well) | RMB free look; fog x0.3, cyan rim and the eight feed lights of the outside views; 22-ray proximity (6 rays now); lamp stutter and alarm below 30 % hull; helm sonar; `horror.ending` at the goal (M9) |
| M7 Build and craft | DONE 2026-10-06: tests `Descent.Build.Rules`, `Descent.Recipes.Costs`, `Descent.Arms.Ranks`; `m7_build`, `m7_arms`, `m7_craft`, `m7_inventory`, `m7_save` PASS | ghost is an opaque glowing box; hand tools have no use yet; sleep in a bunk; habitation furniture still fixed blockout; carousel angle not saved; no autosave on dock |
| M8 Survive | DONE 2026-10-06: `m8_hunger`, `m8_biomass`, `m8_no_fauna_inside`, `m8_tools` PASS; full scenario set after M8: 58 PASS, `ui_windows` failed (fabricator tab ids) and was fixed | jellies; flora; propulsor; sleep fade; fish are stretched cubes |
| M9 Sonar, map, dread, sound | DONE 2026-10-06: `m9_sonar`, `m9_leviathan`, `m9_beacon`, `m9_hallucination`, `m9_heartbeat`, `m9_audio`, `m9_ending` PASS | light flicker, screen glitch, Floor glow; honest voids red on sonar; ping shell; chart table map; the sound itself was never heard (all runs are `-nosound`) |
| M10 Interface complete | DONE 2026-10-06: `m10_ui_layout`, `m10_ui_windows`, `m10_bloom`, `m10_look`, `m10_perf` (4.15 ms average at 1920x1080 after a 5 s settle per place), `m10_full_run` PASS. Full chain: see below | low preset; look tuning; the first seconds after a long teleport run at 40-180 ms per frame (caches build); `m10_bloom` takes two of the four bloom shots |

**Full chain after M10 (2026-10-06): build PASS with 0 warnings; 78 of 78 automation tests PASS (route 2 autopilot fixed); 74 scenarios: 72 PASS,
`selftest_expect` and `selftest_timeout` fail on purpose. Nothing is open that breaks a mechanic. The port M4-M10 is complete; how to play is section 21
of `Docs/STATUS.md`.**

## Where things are (new since M3)
* M4: `Vehicles/TenderTool.cpp` (`UTenderFlightComponent::StepTool`, `AddToHold`), `Systems/DescentLooseOre.*` (pool of 160 chunks), commands
  `Descent.Tender.Drill|Suck|GiveOre`, `Descent.Upgrade <name> <level>`, `Debug/Scenarios_M4.cpp`. Keys in the Tender: LMB drill, RMB suction, T laser head.
* M5: `Systems/DescentCargo.*` (`UDescentCargoSubsystem`: unload job, pipe pieces, packer, `ADescentOreBox`, carrying, `ADescentRefinery`, storage, selling,
  debt; state sections `cargo`, `store`, `econ`, `refineries`), `Core/Tuning/DescentTune_Cargo.h`, `Debug/DescentCommands_Cargo.cpp`
  (`Descent.Cargo.SpawnBox|Eject`, `Descent.Store.Give`, `Descent.Sell`), `Tests/CargoTests.cpp`, `Debug/Scenarios_M5.cpp`.
  Keys on foot: E on a box carries it, E at the refinery's hopper loads it, LMB or G puts it down; E at the packer, the terminal and the refinery (hands
  free) opens their windows.

* M6: `Vehicles/CarrierHelm.*` (`FCarrierHelmState` dynamics as plain data, `FCarrierAutopilot`), helm state, five views, dash and proximity in
  `Vehicles/DescentCarrier.*`, mode Helm in `Player/DescentPlayerModes.cpp`, commands `Descent.Carrier.Helm|Throttle|AimDelta|Ballast|Strafe|View|Teleport|
  SetHull|Autopilot`, `Tests/HelmTests.cpp`, `Debug/Scenarios_M6.cpp`. Keys at the helm: E take / leave, mouse aim, W S lever, A D thrusters, Space C ballast,
  V camera, X all stop.

* M7: `Systems/DescentBuild.*` (kits, rules, `ADescentPlaceable`, ghost), `Systems/DescentCraft.*` (recipes, inventory, hotbar, fabricator / PDA /
  storage windows), `Systems/DescentAutomation.*` (rack, arm), `Systems/DescentSave.*`, `Debug/DescentCommands_Build.cpp`, `Debug/DescentScenarioUtil.h`
  (shared scenario helpers), `Tests/BuildTests.cpp`, `Debug/Scenarios_M7.cpp`. Keys: B build menu, LMB place, RMB / Esc cancel, Q E wheel rotate, Alt free,
  hold E pick up, 1-9 hotbar.

* M8: `Systems/DescentBio.*` (reserve, jack-in, vat, bio pipe, sleep), `Life/DescentFauna.*`, `Player/DescentTools.*`, `Debug/Scenarios_M8.cpp`. Keys: E at a
  wall port feeds, E at the vat loads fauna, E while swimming takes a polyp, RMB in the Tender catches fish, LMB uses the hotbar item, E at a bed sleeps.
* M9: `Systems/DescentSonar.*` (sonar and survey map), `Systems/DescentHorror.*`, `Audio/DescentAudio.*`, `Debug/Scenarios_M9.cpp`. Keys: R sonar, M map.

## Choices taken (one line each)
* M4: the tool is part of `UTenderFlightComponent` (no separate component); the hold is `HoldOrder` on it.
* M4: `Descent.Upgrade` sets the same upgrade state on all three Tenders.
* M5: store, ledger, money and cargo are one subsystem (`UDescentCargoSubsystem`), not two.
* M5: `econ.debt` = 184,220 + the fees the vitals keep (900 / 4,800) - what was sold.
* M5: three decorative crates of the M2 cargo room stood in front of the packer's outfeed slots and were moved to the aft wall.
* M5: the refinery is a plain actor now; M7 makes it a placeable.
* M6: one camera component moved between the five views; the helm dash is the Tender's dash widget with the carrier's numbers in its title line.
* M6: at the helm the body is attached to the carrier (like a seat); leaving the helm is an all stop.
* M6: when nobody holds the helm and the hull is at rest the helm step does nothing (no cost for the other scenarios).
* M7: E on a placed object acts when the key is released; held 0.8 s it picks the object up (so a window never opens under a pick-up).
* M7: crafting takes the cost and gives the result at once; the 2 s build time only blocks the next build.
* M7: Load works inside the running world (and from the title card's CONTINUE); terrain chunks carved after the save are generated again.
* M7: "Cobalt" and "Ferrite" in a recipe cost are raw ore taken from the ore boxes; ingot, wafer and lattice come from storage.
* M8: one subsystem (`UDescentBioSubsystem`) holds the reserve, the jack-in, the vat, the bio pipe and sleep; there is no `UCarrierSystemsComponent`.
* M8: polyp clusters are made on the walls around every school home (the design lists four regions only), so the first canyon has some.
* M9: sonar points are drawn by the HUD (Slate), not by an instanced mesh with a depth-test-off material: no new material asset was needed.
* M9: sounds are synthesised in C++ at start instead of `gen_audio.py` + imported WAV assets: it works while the user's editor has the project open.
* M9: the eight dead-beacon logs are new texts (the v2 texts were not at hand); the leviathan's "near" pass starts 60 m to the side so it is in view at once.
* M10: the objective line of the HUD names the next step of the loop; the pause window lists every key.
* M10: `m10_perf` waits 5 s at each place before it measures: right after a teleport of hundreds of metres the render thread needs 40-180 ms a frame.
* M10: the ending also starts when the autopilot has finished a route below Z -1,200 (route 1 ends 62 m from the `goal` place).