ModelingEvolution.RocketWelder.StationManagement

rw2 as one piece of a station environment (epic-107, docs/epics/epic-107-station-twin/). Built on ModelingEvolution.StationManagement — the foundation that knows containers, networks and waits, and no domain nouns.

This package is a client of rw2: of its container image and of its published REST language. It references no rw2 application project, and no vendor or simulator package.

await using var host = await StationHost.Start("pamet-01");          // one station = one network, fixed IPs
var store = await host.EventStore("rw2-store", reachableFromHost: true);
var rw    = await host.RocketWelder("2.21.34", store, simulatorTrack: true, sinkPorts: [17002]);
//          ↑ always a container; add build: "../rocket-welder2/bin/Debug" to mount the branch under test over /app

var fr20 = await rw.Devices.Ensure(real.Robot("FR20").SimulatedBy(Simulator.Robot, sim));
await rw.Devices.Ensure(real.Track("7th Axis").SimulatedBy(Simulator.Track, sim)
                                              .Keeping(x => x.Travel, x => x.Speed, x => x.Tolerance));
await rw.Cameras.Ensure(real.Camera("41943012").SimulatedBy(Mjpeg.Camera, sim.Preview,
                            pipeline: "pipelines/sim-camera.gpipe", sinkPort: 17002, boundTo: fr20));

var run = await rw.Programs.Run("AxisThenArm");
await run.ShouldFinishWithin(2.Minutes());

Console.WriteLine(host.Differences.Render());

Why Development, when the point is to run what the customer runs

seed-handeye — rw2's only endpoint that binds a camera's intrinsics and mount — is served only when rw2 runs in the Development environment (CamerasEndpoints.cs:98 returns 404 otherwise, RW-3). A twin that could not carry the station's calibration would not be a twin, so the host always sets it, and this is the one place a twin knowingly differs from a customer's cell. It is also the switch that changed the linear-track default on 2026-09-17, which is why simulatorTrack: is an explicit parameter rather than an inherited default.

How it matches the station

Real() · EmulatedBy(endpoint) · SimulatedBy(deviceType, endpoint) · .Keeping(x => …) produce both the rw2 registration and a Match, so a twin always says how alike it is:

FR20      simulated  Simulator                not: the Fairino driver
7th Axis  simulated  SimulatorTrack           not: the FairinoTrack driver, travel, speed, tolerance (rw2 refused: 400 …)
Megmeet   simulated  SimulatorWeldingMachine  not: the MegmeetWeldingMachine_ArtsenPlusPro driver
Plasma    simulated  SimulatorWeldingMachine  not: the FairinoDoWeldingMachine driver
41943012  simulated  MjpegCamera              calibration kept · not: the Camera driver

.Keeping(x => x.Travel, …) is not decoration. rw2's SimulatorTrack driver clamps every commanded position client-side into its own TravelMinMm/TravelMaxMm (SimulatorTrackConfig.cs:31-34 and Clamp at :83), whose defaults are ±1000 mm. A Pamet script that sets the rail's travel on the simulator but not on the rw2 device cannot command a 5000 mm move at all — it is silently clamped. Set the same travel on both.

Two values are demoted rather than claimed:

• The travel, speed, tolerance (rw2 refused: …) line is RW-1: POST /api/peripheral-devices validates against the registered property types rather than the device type's own schema, so SimulatorTrack's declared TravelMinMm, MaxSpeedMmPerSecond and ToleranceMm are answered with 400. The device is registered without them and the twin says so. When RW-1 lands, those three move to kept with no change to a station script.

Only rw2's OWN device types live here (Simulator, SimulatorTrack, SimulatorWeldingMachine, SimulatorDistanceSensor, MjpegCamera). A vendor's device type is a string in the station's description — this package never references a vendor package.

Test

dotnet build src/StationManagement.sln
dotnet test  src/StationManagement.sln --filter "Category!=Docker"   # pure logic
dotnet test  src/StationManagement.sln --filter "Category=Docker"    # a real station

This package has its own solution, src/StationManagement.sln, and is deliberately NOT in src/RocketWelder.sln: rw2's CI and its docker build must never restore from the internal feed over a package rw2 does not ship.

The Docker suite brings a whole twin up on a developer machine — it needs the rw2 image (20 GB) and modelingevolution/simulator:local, so it never runs in CI.

Authoring a program headlessly

rw2 owns program authoring; this package does not wrap it. The recipe the station tests need, through rw.Api.Programs (the SDK's block API) — src/ModelingEvolution.RocketWelder.StationManagement.Tests/StationComesUpTests.cs runs exactly this:

var repo = await rw.Programs.EnsureRepository("EngPkg");
var id   = await rw.Programs.EnsureProgram(repo, "ArmMove");

// A Point block is REFUSED (422) unless the pose was taught first — rw2 will not bake (0,0,0).
var point = await rw.Api.Programs.CapturePointAsync(id, new CapturePointRequest("A"));

var etag     = (await rw.Api.Programs.GetTreeAsync(id)).Etag;      // every edit carries the tree's etag
var declared = await rw.Api.Programs.AddBlockAsync(id,
    new AddBlockRequest("Point", new JsonObject { ["name"] = point.Name }, BlockAnchor.Tail), etag);
await rw.Api.Programs.AddBlockAsync(id,
    new AddBlockRequest("Move", new JsonObject { ["target"] = point.Name, ["travel"] = "20%" }, BlockAnchor.Tail),
    declared.Etag);

await rw.Programs.Compile(repo);
var run = await rw.Programs.Run("ArmMove");
await run.ShouldFinishWithin(2.Minutes());

Worth knowing before writing station tests:

• Capture, then declare — one point at a time. Saving the tree prunes taught points that no block declares.
• /capture reads the live cell, and refuses (400) if anything moved, is not Standstill, is faulted, unhomed or slow to answer. It also records every registered axis in the point, and at run time a move is refused unless each axis is still at its taught value — so capture with the track where the run will have it.
• The external axis cannot be authored over REST. rw2 has the block (AxisMoveBlock, role linearTrack, axis carriage, target in mm) and its runtime executes it, but POST /api/programs/{id}/blocks deliberately does not mint it (ProgramEditingEndpoints.cs:483-509 — "AxisMove is read-only"), and a Custom block cannot stand in because the motion package is referenced only when an AxisMoveBlock is present. Authorable today: Point, Move, MovePtp, Corner, Spline, Circular, Adapt, ArcOn, ArcOff, ArcParallel, WaitArcStable, WaitMotionRelease, Delay, Pause, SetWelderParams, SetEmptyReference, Custom.
• Blocks bind devices by INTERFACE, never by name — the generated program resolves IRobot / ILinearTrack, so a device registered only under a name is unreachable.
• A non-dry run of a program with an enabled Pause is refused (400): nobody is at a run screen to resume it.

Which rw2 it works against

Minimum: rw2 2.21.18. That is the first release carrying the headless POST /api/repositories/{repoId}/programs this package creates its own programs with (git tag --contains 3a2d6395). It also needs PATCH /api/pipeline/{id}/autostart, POST /api/pipeline/import, and — for Cameras.Ensure to bind a calibration — POST /api/cameras/calibration/seed-handeye, which rw2 serves only in the Development environment (the host sets ASPNETCORE_ENVIRONMENT=Development for exactly that reason).

Proven against 2.21.34, the version the integration suite runs. Anything between 2.21.18 and that is untested.

Published

Internal feed only (nuget.modelingevolution.com) — never nuget.org.

The package carries its own version, not rw2's image version: its surface moves when rw2's REST language moves, which is much rarer than an image build. What ties it to rw2 is the minimum version stated above.