Captain bridge UX: berth, travel, intel, voyage

name: Captain Bridge UX overview: "Redesign the Calypso captain bridge around berth presence: see the network job intel everywhere, travel empty to a system, accept only while docked at the origin, watch voyage progress, and separate Spot freight from Charters—with Avalonia and --mode captain sharing one verb model." todos:

• id: economy-reposition

content: Add PlanReposition + empty depart path + unit test in novolis-economy status: completed

• id: berth-gate-manifest

content: TravelTo order, berth-gated accept, BerthManifest capacity merge status: completed

• id: spot-vs-charter

content: "Split CaptainJobBoard intel: Spot vs Charter candidates + intercept refresh" status: completed

• id: voyage-ui-cli

content: CaptainBridgeModel voyage strip; Avalonia tabs; captain CLI verbs + playtest status: completed

• id: docs-validate

content: Docs + ProjectRef build/playtest + verify-nuget-only status: completed isProject: false

Problem (today)

• Accept from anywhere: PlayerTrampAgent.LiftHaul never checks berth vs origin; Network / ~ 1-hop board makes remote accepts normal.
• No travel: map select is inspect-only; PlanShipment rejects empty cargo (LogisticsEngine.TryDepartItinerary → cargo-unavailable).
• Opaque voyage: only a one-line LastDecision; no leg/ETA/hold UI.
• One mushy board: commodity arb + standby flavor mixed; no charter vs spot split.
• “Multiple if room” impossible to read: single drain + no capacity/manifest.

Locked product rules

flowchart LR
  intel[Intel_see_all]
  travel[Travel_empty]
  berth[Docked_at_origin]
  accept[Accept_into_manifest]
  depart[Depart_haul]
  voyage[Voyage_visible]
  intel --> travel
  travel --> berth
  berth --> accept
  accept --> depart
  depart --> voyage
  voyage --> intel

1. See spot/charter postings network-wide (intel). They can vanish or shrink (other tramps / fills) while you steam.
2. Accept only when CurrentHub == job.Origin (docked at load port).
3. Travel empty (or ballast) to any hub you can route to — first-class verb, not a fake haul.
4. Voyage is always visible while underway (from → to, profile, phase, remaining capacity).
5. Spot vs Charter are separate panels/tabs (not one ListBox).
6. Manifest / room: while docked, commit multiple same-origin lots up to HullCargoCapacity (36); same SKU merges into one PlanShipment; different SKUs stage in firm inventory at berth and haul one SKU at a time.
7. Shells: Avalonia + --mode captain share the same bridge verbs and CaptainBridgeModel (CLI mirrors GUI).

UX shape (one composition)

Copy tone: CCA glass board — “plenty of opportunity; acceptance is a dock act.”

Domain changes (Sins + small Economy)

A. Empty travel — Economy

Add PlanReposition(FirmId, OriginHubId, DestinationHubId, VehicleClassId, TransitProfileCode) in `CommandsAndEvents.cs` and handle in logistics depart path (allow quantity == 0 for reposition only; no inventory take; still burns fuel/tolls/wear via existing underway). Tests in Economy.Unit for empty depart + refuse mid-busy.

Sins: PlayerOrderKind.TravelTo + PlayerTrampAgent enqueue reposition when idle and CanOperate.

B. Berth gate on accept

In LiftHaul / new CommitSpotLot: require Agents.Carrier.CurrentHub matches origin hub; else LastDecision = "not at load berth". Remove Network-accept and soft ~ remote accept. Intel may still list 1-hop/network; Accept is hard-gated.

C. Spot vs Charter models

• SpotCandidate — today’s spread math from `CaptainJobBoard` (rename/split): AtOrigin, DistanceHint, RemainingQty (live book).
• CharterCandidate — from OpportunitiesPool (standby) + optional seeded “short charter” rows (tutorial Industrial/Mining <8 ly) that open escrow on accept. Separate list; never mixed into Spot strings.

D. Manifest (multi if room)

New Sins-local BerthManifest:

• TryAdd(SpotCandidate) only at origin; reject if used + qty > 36 or origin mismatch.
• Same ProductId → merge qty.
• Depart(sku?) → one PostHubOrder+PlanShipment for chosen/merged SKU; leftover SKUs remain as inventory at berth for next haul.
• Capacity meter on voyage strip.

E. Interception

Each bridge refresh re-queries HubOrders; intel rows update Remaining/disappear. No reserved remote hold until berth accept. Optional flash: “Job gone — filled or lifted.”

F. Bridge model + UI + CLI

Rewrite `CaptainBridgeModel` with Voyage / SpotIntel / Charters / Manifest sections. `MainWindow`: tabs Spot | Charters | Manifest; Travel on map; Accept enabled only when AtOrigin; Depart on Manifest. `CaptainConsole`: travel <system>, spot, charters, accept N, manifest, depart, refuse; --playtest script: travel to load hub → accept → depart → assert underway → berth gate rejects remote accept.

G. Docs

Update `gameplay.md` / `cli-and-reports.md` / `commerce-stack.md`: dock acceptance, empty reposition, spot vs charter, interception.

Validation

dotnet build novolis-apps/src/SinsOfACapitalismTycoon -p:NovolisUseProjectReferences=true
dotnet test novolis-economy/tests/Novolis.Economy.Unit --filter PlanReposition
dotnet run --project novolis-apps/src/SinsOfACapitalismTycoon -p:NovolisUseProjectReferences=true -- --engine campaign --days 60d --seed 1001 --playtest
pwsh -File novolis-governance/scripts/verify-nuget-only.ps1

Playtest acceptance: remote accept fails; travel shows underway empty; at origin accept fills manifest; depart → visible voyage; spot/charter lists distinct; second lot respects room.

Out of scope

• Multi-SKU single PlanShipment / mid-tick fleet animation / Prize Court
• Publishing Economy packages to GPR in this pass (ProjectRef validation; publish via normal CI when merging Economy)