@shipload/sdk 1.0.0-next.6 → 1.0.0-next.60

package/src/nft/description.ts

@@ -1,9 +1,11 @@
 import {
     getModuleCapabilityType,
+    MODULE_BUILDER,
     MODULE_CRAFTER,
     MODULE_ENGINE,
     MODULE_GATHERER,
     MODULE_GENERATOR,
+    MODULE_BATTERY,
     MODULE_HAULER,
     MODULE_LOADER,
     MODULE_STORAGE,
@@ -12,69 +14,196 @@ import {
 import {
     ITEM_CONTAINER_T1_PACKED,
     ITEM_CONTAINER_T2_PACKED,
+    ITEM_CONSTRUCTION_DOCK_T1_PACKED,
+    ITEM_BUILDER_T1,
+    ITEM_BUILDER_T2,
     ITEM_CRAFTER_T1,
+    ITEM_CRAFTER_T2,
     ITEM_ENGINE_T1,
+    ITEM_ENGINE_T2,
+    ITEM_EXTRACTOR_T1_PACKED,
+    ITEM_FACTORY_T1_PACKED,
     ITEM_GATHERER_T1,
+    ITEM_GATHERER_T2,
     ITEM_GENERATOR_T1,
+    ITEM_GENERATOR_T2,
     ITEM_HAULER_T1,
+    ITEM_HAULER_T2,
+    ITEM_BATTERY_T1,
+    ITEM_LAUNCHER_T1,
     ITEM_LOADER_T1,
+    ITEM_LOADER_T2,
+    ITEM_PROSPECTOR_T1A_PACKED,
+    ITEM_PROSPECTOR_T2A_PACKED,
+    ITEM_PROSPECTOR_T2B_PACKED,
+    ITEM_ROUSTABOUT_T1A_PACKED,
     ITEM_SHIP_T1_PACKED,
+    ITEM_SMITH_T1A_PACKED,
     ITEM_STORAGE_T1,
+    ITEM_TENDER_T1A_PACKED,
+    ITEM_TUG_T1A_PACKED,
+    ITEM_PORTER_T1A_PACKED,
+    ITEM_WRIGHT_T1A_PACKED,
+    ITEM_DREDGER_T2A_PACKED,
     ITEM_WAREHOUSE_T1_PACKED,
     ITEM_WARP_T1,
+    ITEM_WARP_T2,
 } from '../data/item-ids'
 import {decodeStat} from '../derivation/crafting'
-import {gathererDepthForTier} from '../entities/ship-deploy'
+import {
+    gathererDepthForTier,
+    computeGathererYield,
+    moduleTierPct,
+    ENGINE_THRUST_TIER_PCT,
+    GENERATOR_CAPACITY_TIER_PCT,
+    GENERATOR_RECHARGE_TIER_PCT,
+    CRAFTER_SPEED_TIER_PCT,
+    BUILDER_SPEED_TIER_PCT,
+    WARP_RANGE_TIER_PCT,
+    LOADER_THRUST_TIER_PCT,
+} from '../derivation/capabilities'
 import {getItem} from '../data/catalog'
+import {ENTITY_SHIP, getPackedEntityType} from '../data/kind-registry'
+import {getBaseHullmassFor} from '../derivation/capabilities'
+import {computeEffectiveModuleStat} from '../derivation/stat-scaling'
 
 function idiv(a: number, b: number): number {
     return Math.floor(a / b)
 }
 
-export function computeBaseHullmass(stats: bigint): number {
+export function toWholeEnergy(milli: number): number {
+    return idiv(milli + 500, 1000)
+}
+
+function isShipHull(itemId: number): boolean {
+    return getPackedEntityType(itemId)?.equals(ENTITY_SHIP) ?? false
+}
+
+function sumPackedShipChannels(stats: bigint): number {
+    let sum = 0
+    for (let slot = 0; slot < 5; slot++) sum += decodeStat(stats, slot)
+    return sum
+}
+
+export function computeBaseHullmass(itemId: number, stats: bigint): number {
+    if (isShipHull(itemId)) {
+        return Math.floor(
+            (getBaseHullmassFor(itemId) * (10_000 - sumPackedShipChannels(stats))) / 10_000
+        )
+    }
     const density = decodeStat(stats, 1)
-    return 25000 + 75 * density
+    return Math.floor((getBaseHullmassFor(itemId) * (2000 - density)) / 2000)
 }
 
 export function computeBaseCapacityShip(stats: bigint): number {
-    const s = decodeStat(stats, 0) + decodeStat(stats, 2) + decodeStat(stats, 3)
-    return Math.floor(1_000_000 * 10 ** (s / 2997))
+    return Math.floor(5_000_000 * 6 ** (sumPackedShipChannels(stats) / 4995))
+}
+
+export function computeBaseCapacityContainer(stats: bigint): number {
+    const s = decodeStat(stats, 0) + decodeStat(stats, 2)
+    return Math.floor(22_000_000 * 6 ** (s / 1998))
 }
 
 export function computeBaseCapacityWarehouse(stats: bigint): number {
-    const s = decodeStat(stats, 0) + decodeStat(stats, 2) + decodeStat(stats, 3)
-    return Math.floor(20_000_000 * 10 ** (s / 2997))
+    const s = decodeStat(stats, 0) + decodeStat(stats, 2)
+    return Math.floor(100_000_000 * 6 ** (s / 1998))
 }
 
-export const computeEngineThrust = (vol: number): number => 400 + idiv(vol * 3, 4)
-export const computeEngineDrain = (thm: number): number => Math.max(30, 50 - idiv(thm, 70))
-export const computeGeneratorCap = (com: number): number => 300 + idiv(com, 6)
-export const computeGeneratorRech = (fin: number): number => 1 + idiv(fin * 3, 1000)
-export const computeGathererYield = (str: number): number => 200 + str
+export const computeEngineThrust = (vol: number, tier: number): number =>
+    idiv((400 + idiv(vol * 3, 4)) * moduleTierPct(ENGINE_THRUST_TIER_PCT, tier), 100)
+export const computeEngineDrain = (thm: number): number => 2 * Math.max(30, 50 - idiv(thm, 70))
+export const ENGINE_DRAIN_BASE = 156
+export const ENGINE_DRAIN_REF_THRUST = 775
+export const ENGINE_DRAIN_REF_THM = 500
+
+export const computeTravelDrain = (totalThrust: number, avgThm: number): number => {
+    if (totalThrust <= 0) return 0
+    const thermalFactor = computeEngineDrain(avgThm) / computeEngineDrain(ENGINE_DRAIN_REF_THM)
+    const thrustFactor = Math.sqrt(ENGINE_DRAIN_REF_THRUST / totalThrust)
+    return Math.floor(ENGINE_DRAIN_BASE * 1000 * thermalFactor * thrustFactor)
+}
+export const computeGeneratorCap = (com: number, tier: number): number =>
+    idiv((1_300_000 + com * 500) * moduleTierPct(GENERATOR_CAPACITY_TIER_PCT, tier), 100)
+export const computeGeneratorRech = (fin: number, tier: number): number =>
+    idiv((2000 + fin * 6) * moduleTierPct(GENERATOR_RECHARGE_TIER_PCT, tier), 100)
 export const computeGathererDrain = (con: number): number =>
-    Math.max(250, 1250 - idiv(con * 25, 20))
+    2 * Math.max(250_000, 1_250_000 - con * 1250)
 export const computeGathererDepth = (tol: number, tier: number): number =>
     gathererDepthForTier(tol, tier)
-export const computeGathererSpeed = (ref: number): number => 100 + idiv(ref * 4, 5)
 export const computeLoaderMass = (ins: number): number => Math.max(200, 2000 - ins * 2)
-export const computeLoaderThrust = (pla: number): number => 1 + idiv(pla, 500)
-export const computeCrafterSpeed = (rea: number): number => 100 + idiv(rea * 4, 5)
-export const computeCrafterDrain = (fin: number): number => Math.max(5, 30 - idiv(fin, 33))
-export const computeHaulerCapacity = (fin: number): number => Math.max(1, 1 + idiv(fin, 400))
+export const computeLoaderThrust = (pla: number, tier: number): number =>
+    idiv((1 + idiv(pla * pla, 10000)) * moduleTierPct(LOADER_THRUST_TIER_PCT, tier), 100)
+export const computeCrafterSpeed = (rea: number, tier: number): number =>
+    idiv((100 + idiv(rea * 4, 5)) * moduleTierPct(CRAFTER_SPEED_TIER_PCT, tier), 100)
+export const computeCrafterDrain = (fin: number): number =>
+    Math.max(5000, 30000 - idiv(fin * 1000, 33))
+export const computeBuilderSpeed = (resonance: number, tier: number): number =>
+    idiv((100 + idiv(resonance * 4, 5)) * moduleTierPct(BUILDER_SPEED_TIER_PCT, tier), 100)
+export const computeBuilderDrain = (fineness: number): number =>
+    Math.max(5000, 30000 - idiv(fineness * 1000, 33))
+export const computeHaulerCapacity = (fin: number, tier: number): number =>
+    Math.max(tier, tier + idiv(fin, 400))
 export const computeHaulerEfficiency = (con: number): number => 2000 + con * 6
-export const computeHaulerDrain = (com: number): number => Math.max(3, 15 - idiv(com, 80))
-export const computeWarpRange = (stat: number): number => 100 + stat * 3
+export const supportDrainTierPercent = (tier: number): number => {
+    const clampedTier = Math.min(10, Math.max(1, Math.trunc(tier)))
+    return Math.max(50, 110 - clampedTier * 10)
+}
+const computeT1LogisticsDrain = (stat: number): number =>
+    Math.max(3000, 15000 - Math.min(12000, idiv(stat * 1000, 80)))
+export const computeHaulerDrain = (conductivity: number, tier: number): number =>
+    idiv(computeT1LogisticsDrain(conductivity) * supportDrainTierPercent(tier), 100)
+export const computeCargoBayDrain = (cohesion: number, tier: number): number =>
+    idiv(computeT1LogisticsDrain(cohesion) * 3 * supportDrainTierPercent(tier), 400)
+export const computeWarpRange = (stat: number, tier: number): number =>
+    idiv((100 + stat * 3) * moduleTierPct(WARP_RANGE_TIER_PCT, tier), 100)
+export const computeCargoBayCapacity = (
+    strength: number,
+    density: number,
+    hardness: number
+): number => 10_000_000 + idiv((strength + density + hardness) * 50_000_000, 2997)
+export const computeBatteryBankCapacity = (
+    volatility: number,
+    thermal: number,
+    plasticity: number,
+    insulation: number
+): number => 2_500_000 + idiv((volatility + thermal + plasticity + insulation) * 7_500_000, 3996)
 
 export function entityDisplayName(itemId: number): string {
     switch (itemId) {
         case ITEM_SHIP_T1_PACKED:
             return 'Ship'
+        case ITEM_ROUSTABOUT_T1A_PACKED:
+            return 'Roustabout'
+        case ITEM_PROSPECTOR_T1A_PACKED:
+            return 'Prospector'
+        case ITEM_TENDER_T1A_PACKED:
+            return 'Tender'
+        case ITEM_TUG_T1A_PACKED:
+            return 'Tug'
+        case ITEM_PORTER_T1A_PACKED:
+            return 'Porter'
+        case ITEM_WRIGHT_T1A_PACKED:
+            return 'Wright'
+        case ITEM_SMITH_T1A_PACKED:
+            return 'Smith'
         case ITEM_WAREHOUSE_T1_PACKED:
             return 'Warehouse'
+        case ITEM_EXTRACTOR_T1_PACKED:
+            return 'Mining Rig'
+        case ITEM_FACTORY_T1_PACKED:
+            return 'Factory'
+        case ITEM_CONSTRUCTION_DOCK_T1_PACKED:
+            return 'Construction Dock'
         case ITEM_CONTAINER_T1_PACKED:
             return 'Container'
         case ITEM_CONTAINER_T2_PACKED:
             return 'Container'
+        case ITEM_PROSPECTOR_T2A_PACKED:
+            return 'Prospector'
+        case ITEM_PROSPECTOR_T2B_PACKED:
+            return 'Prospector'
+        case ITEM_DREDGER_T2A_PACKED:
+            return 'Dredger'
         default:
             return 'Entity'
     }
@@ -83,21 +212,35 @@ export function entityDisplayName(itemId: number): string {
 export function moduleDisplayName(itemId: number): string {
     switch (itemId) {
         case ITEM_ENGINE_T1:
+        case ITEM_ENGINE_T2:
             return 'Engine'
         case ITEM_GENERATOR_T1:
-            return 'Generator'
+        case ITEM_GENERATOR_T2:
+            return 'Power Core'
         case ITEM_GATHERER_T1:
-            return 'Gatherer'
+        case ITEM_GATHERER_T2:
+            return 'Limpet Bay'
         case ITEM_LOADER_T1:
-            return 'Loader'
+        case ITEM_LOADER_T2:
+            return 'Shuttle Bay'
         case ITEM_CRAFTER_T1:
-            return 'Crafter'
+        case ITEM_CRAFTER_T2:
+            return 'Fabricator'
+        case ITEM_BUILDER_T1:
+        case ITEM_BUILDER_T2:
+            return 'Assembly Arm'
         case ITEM_STORAGE_T1:
-            return 'Storage'
+            return 'Cargo Hold'
         case ITEM_HAULER_T1:
-            return 'Hauler'
+        case ITEM_HAULER_T2:
+            return 'Tractor Beam'
         case ITEM_WARP_T1:
-            return 'Warp'
+        case ITEM_WARP_T2:
+            return 'Warp Drive'
+        case ITEM_BATTERY_T1:
+            return 'Battery Bank'
+        case ITEM_LAUNCHER_T1:
+            return 'Drive Coil'
         default:
             return 'Module'
     }
@@ -115,60 +258,82 @@ export function formatModuleLine(slot: number, itemId: number, stats: bigint): s
 
     switch (subtype) {
         case MODULE_ENGINE: {
-            const vol = decodeStat(stats, 0)
-            const thm = decodeStat(stats, 1)
-            out += `  Thrust ${computeEngineThrust(vol)}  Drain ${computeEngineDrain(thm)}`
+            const vol = computeEffectiveModuleStat(decodeStat(stats, 0))
+            const thm = computeEffectiveModuleStat(decodeStat(stats, 1))
+            const tier = getItem(itemId).tier
+            out += `  Thrust ${computeEngineThrust(vol, tier)}  Drain ${computeEngineDrain(thm)}`
             break
         }
         case MODULE_GENERATOR: {
-            const res = decodeStat(stats, 0)
-            const ref = decodeStat(stats, 1)
-            out += `  Capacity ${computeGeneratorCap(res)}  Recharge ${computeGeneratorRech(ref)}`
+            const res = computeEffectiveModuleStat(decodeStat(stats, 0))
+            const ref = computeEffectiveModuleStat(decodeStat(stats, 1))
+            const tier = getItem(itemId).tier
+            out += `  Capacity ${toWholeEnergy(computeGeneratorCap(res, tier))}  Recharge ${toWholeEnergy(
+                computeGeneratorRech(ref, tier)
+            )}`
             break
         }
         case MODULE_GATHERER: {
             const str = decodeStat(stats, 0)
             const tol = decodeStat(stats, 1)
-            const con = decodeStat(stats, 3)
-            const ref = decodeStat(stats, 4)
+            const con = decodeStat(stats, 2)
             const tier = getItem(itemId).tier
-            out += `  Yield ${computeGathererYield(str)}  Depth ${computeGathererDepth(
+            out += `  Yield ${computeGathererYield(str, tier)}  Depth ${computeGathererDepth(
                 tol,
                 tier
-            )}  Speed ${computeGathererSpeed(ref)}  Drain ${computeGathererDrain(con)}`
+            )}  Drain ${toWholeEnergy(computeGathererDrain(con))}`
             break
         }
         case MODULE_LOADER: {
             const fin = decodeStat(stats, 0)
             const pla = decodeStat(stats, 1)
-            out += `  Mass ${computeLoaderMass(fin)}  Thrust ${computeLoaderThrust(pla)}`
+            const tier = getItem(itemId).tier
+            out += `  Mass ${computeLoaderMass(fin)}  Thrust ${computeLoaderThrust(pla, tier)}`
             break
         }
         case MODULE_CRAFTER: {
             const rea = decodeStat(stats, 0)
-            const com = decodeStat(stats, 1)
-            out += `  Speed ${computeCrafterSpeed(rea)}  Drain ${computeCrafterDrain(com)}`
+            const con = decodeStat(stats, 1)
+            const tier = getItem(itemId).tier
+            out += `  Speed ${computeCrafterSpeed(rea, tier)}  Drain ${toWholeEnergy(computeCrafterDrain(con))}`
+            break
+        }
+        case MODULE_BUILDER: {
+            const res = decodeStat(stats, 0)
+            const fin = decodeStat(stats, 1)
+            const tier = getItem(itemId).tier
+            out += `  Speed ${computeBuilderSpeed(res, tier)}  Drain ${toWholeEnergy(computeBuilderDrain(fin))}`
             break
         }
         case MODULE_STORAGE: {
             const str = decodeStat(stats, 0)
-            const fin = decodeStat(stats, 2)
-            const sat = decodeStat(stats, 3)
-            const sum = str + fin + sat
-            const pct = 10 + idiv(sum * 10, 2997)
-            out += `  +${pct}% capacity`
+            const den = decodeStat(stats, 1)
+            const hrd = decodeStat(stats, 2)
+            const coh = decodeStat(stats, 3)
+            const tier = getItem(itemId).tier
+            out += `  Cargo Capacity ${computeCargoBayCapacity(str, den, hrd)}  Drain ${toWholeEnergy(computeCargoBayDrain(coh, tier))}`
             break
         }
         case MODULE_HAULER: {
-            const fin = decodeStat(stats, 0)
-            const con = decodeStat(stats, 1)
-            const com = decodeStat(stats, 2)
-            out += `  Capacity ${computeHaulerCapacity(fin)}  Efficiency ${computeHaulerEfficiency(con)}  Drain ${computeHaulerDrain(com)}`
+            const res = decodeStat(stats, 0)
+            const pla = decodeStat(stats, 1)
+            const con = decodeStat(stats, 2)
+            const tier = getItem(itemId).tier
+            out += `  Capacity ${computeHaulerCapacity(res, tier)}  Efficiency ${computeHaulerEfficiency(pla)}  Drain ${toWholeEnergy(computeHaulerDrain(con, tier))}`
             break
         }
         case MODULE_WARP: {
             const stat = decodeStat(stats, 0)
-            out += `  Range ${computeWarpRange(stat)}`
+            const tier = getItem(itemId).tier
+            out += `  Range ${computeWarpRange(stat, tier)}`
+            break
+        }
+        case MODULE_BATTERY: {
+            const vol = decodeStat(stats, 0)
+            const thm = decodeStat(stats, 1)
+            const pla = decodeStat(stats, 2)
+            const ins = decodeStat(stats, 3)
+            out += `  Energy Capacity ${toWholeEnergy(computeBatteryBankCapacity(vol, thm, pla, ins))}`
             break
         }
     }
@@ -181,12 +346,20 @@ export function buildEntityDescription(
     moduleItems: number[],
     moduleStats: bigint[]
 ): string {
-    const hullMass = computeBaseHullmass(hullStats)
+    const hullMass = computeBaseHullmass(itemId, hullStats)
     let baseCapacity = 0
-    if (itemId === ITEM_SHIP_T1_PACKED) {
+    if (isShipHull(itemId)) {
         baseCapacity = computeBaseCapacityShip(hullStats)
     } else if (itemId === ITEM_WAREHOUSE_T1_PACKED) {
         baseCapacity = computeBaseCapacityWarehouse(hullStats)
+    } else if (
+        itemId === ITEM_EXTRACTOR_T1_PACKED ||
+        itemId === ITEM_FACTORY_T1_PACKED ||
+        itemId === ITEM_CONSTRUCTION_DOCK_T1_PACKED ||
+        itemId === ITEM_CONTAINER_T1_PACKED ||
+        itemId === ITEM_CONTAINER_T2_PACKED
+    ) {
+        baseCapacity = computeBaseCapacityContainer(hullStats)
     }
 
     let out = entityDisplayName(itemId)

package/src/nft/index.ts

@@ -1,2 +1,5 @@
 export * from './deserializers'
 export * from './description'
+export * from './atomicdata'
+export * from './atomicassets'
+export * from './buildImmutableData'

package/src/planner/index.ts

@@ -0,0 +1,242 @@
+import type {GathererStats} from '../types/capabilities'
+import type {ServerContract} from '../contracts'
+import {calc_gather_duration, calc_gather_energy} from '../capabilities/gathering'
+import {calc_rechargetime} from '../travel/travel'
+import {projectRemainingAt, type Projectable} from '../scheduling/projection'
+
+export interface LanePlanEntry {
+    slot: number
+    quantity: number
+}
+
+export type PlanTarget = {quantity: number} | 'max'
+
+export interface GatherPlanEntity extends Projectable {
+    gatherer_lanes: ServerContract.Types.gatherer_lane[]
+    loader_lanes: ServerContract.Types.loader_lane[]
+}
+
+export interface GatherLimpet {
+    slot: number
+    quantity: number
+    durationSeconds: number
+}
+
+export interface GatherCycle {
+    rechargeBefore: boolean
+    rechargeSeconds: number
+    limpets: GatherLimpet[]
+    gatherSeconds: number
+    batchOre: number
+}
+
+export type FillCap = 'reserve' | 'hold' | 'requested'
+
+export interface GatherPlan {
+    cycles: GatherCycle[]
+    cycleCount: number
+    totalOre: number
+    totalSeconds: number
+    cap: FillCap
+    reachingCount: number
+    totalLimpets: number
+    warnings: string[]
+}
+
+export interface BuildGatherPlanOpts {
+    richness: number
+    itemMass: number
+    holdRoom: number
+    reserveRemaining: number
+    now: Date
+}
+
+const MAX_CYCLES = 10_000
+
+const MAX_TRANSFER_QTY = 10000
+
+export function allocateProportional(
+    lanes: {slot: number; weight: number}[],
+    total: number
+): LanePlanEntry[] {
+    if (lanes.length === 0) return []
+    const weightSum = lanes.reduce((s, l) => s + l.weight, 0)
+    if (weightSum === 0) return []
+
+    const entries: LanePlanEntry[] = lanes.map((l) => ({
+        slot: l.slot,
+        quantity: Math.floor((total * l.weight) / weightSum),
+    }))
+
+    let remainder = total - entries.reduce((s, e) => s + e.quantity, 0)
+    for (let i = 0; remainder > 0; i = (i + 1) % entries.length) {
+        entries[i].quantity++
+        remainder--
+    }
+
+    return entries
+}
+
+function laneStats(lane: ServerContract.Types.gatherer_lane): GathererStats {
+    return lane as unknown as GathererStats
+}
+
+export function gatherEnergyCost(
+    lane: ServerContract.Types.gatherer_lane,
+    quantity: number,
+    stratum: number,
+    itemMass: number,
+    richness: number
+): number {
+    if (quantity <= 0) return 0
+    const dur = Number(calc_gather_duration(laneStats(lane), itemMass, quantity, stratum, richness))
+    return Number(calc_gather_energy(laneStats(lane), dur))
+}
+
+export function splitCost(
+    reaching: ServerContract.Types.gatherer_lane[],
+    quantity: number,
+    stratum: number,
+    itemMass: number,
+    richness: number
+): number {
+    if (quantity <= 0) return 0
+    const weights = reaching.map((l) => ({
+        slot: l.slot_index.toNumber(),
+        weight: l.yield.toNumber(),
+    }))
+    const split = allocateProportional(weights, quantity)
+    return split.reduce((sum, e) => {
+        const lane = reaching.find((l) => l.slot_index.toNumber() === e.slot)!
+        return sum + gatherEnergyCost(lane, e.quantity, stratum, itemMass, richness)
+    }, 0)
+}
+
+// Binary search is exact because splitCost is monotonic non-decreasing in Q.
+export function maxQtyForCharge(
+    reaching: ServerContract.Types.gatherer_lane[],
+    hi: number,
+    capacity: number,
+    stratum: number,
+    itemMass: number,
+    richness: number
+): number {
+    if (hi <= 0) return 0
+    if (splitCost(reaching, hi, stratum, itemMass, richness) <= capacity) return hi
+    let lo = 0
+    let high = hi
+    while (lo < high) {
+        const mid = Math.ceil((lo + high) / 2)
+        if (splitCost(reaching, mid, stratum, itemMass, richness) <= capacity) lo = mid
+        else high = mid - 1
+    }
+    return lo
+}
+
+export function buildGatherPlan(
+    entity: GatherPlanEntity,
+    stratum: number,
+    target: PlanTarget,
+    opts: BuildGatherPlanOpts
+): GatherPlan {
+    const {richness, itemMass, holdRoom, reserveRemaining, now} = opts
+    const warnings: string[] = []
+
+    const reaching = entity.gatherer_lanes.filter((l) => l.depth.toNumber() >= stratum)
+    if (reaching.length === 0) throw new Error('no gatherer reaches this stratum')
+    if (!entity.generator) throw new Error('entity has no generator')
+
+    const blocked = entity.gatherer_lanes.length - reaching.length
+    if (blocked > 0) {
+        warnings.push(
+            `${blocked} of ${entity.gatherer_lanes.length} limpets can't reach this depth`
+        )
+    }
+
+    const capacity = entity.generator.capacity.toNumber()
+    const rechargeRate = entity.generator.recharge.toNumber()
+    let energy = Number(projectRemainingAt(entity, now).energy)
+
+    const requested = target === 'max' ? Infinity : target.quantity
+    let fillTarget = requested
+    let cap: FillCap = 'requested'
+    if (holdRoom < fillTarget) {
+        fillTarget = holdRoom
+        cap = 'hold'
+    }
+    if (reserveRemaining < fillTarget) {
+        fillTarget = reserveRemaining
+        cap = 'reserve'
+    }
+    fillTarget = Math.max(0, Math.floor(fillTarget))
+
+    const cycles: GatherCycle[] = []
+    let remaining = fillTarget
+    let guard = 0
+    while (remaining > 0 && guard++ < MAX_CYCLES) {
+        const batch = maxQtyForCharge(reaching, remaining, capacity, stratum, itemMass, richness)
+        if (batch <= 0) {
+            warnings.push('a single gather cannot fit within one full charge')
+            break
+        }
+
+        const costFull = splitCost(reaching, batch, stratum, itemMass, richness)
+        const rechargeBefore = energy < costFull
+        const rechargeSeconds = rechargeBefore
+            ? Number(calc_rechargetime(capacity, energy, rechargeRate))
+            : 0
+        if (rechargeBefore) energy = capacity
+
+        const weights = reaching.map((l) => ({
+            slot: l.slot_index.toNumber(),
+            weight: l.yield.toNumber(),
+        }))
+        const split = allocateProportional(weights, batch).filter((e) => e.quantity > 0)
+        const limpets: GatherLimpet[] = split.map((e) => {
+            const lane = reaching.find((l) => l.slot_index.toNumber() === e.slot)!
+            const dur = Number(
+                calc_gather_duration(laneStats(lane), itemMass, e.quantity, stratum, richness)
+            )
+            return {slot: e.slot, quantity: e.quantity, durationSeconds: dur}
+        })
+        const actualCost = limpets.reduce((sum, l) => {
+            const lane = reaching.find((r) => r.slot_index.toNumber() === l.slot)!
+            return sum + Number(calc_gather_energy(laneStats(lane), l.durationSeconds))
+        }, 0)
+        energy = Math.max(0, energy - actualCost)
+
+        const gatherSeconds = limpets.reduce((m, l) => Math.max(m, l.durationSeconds), 0)
+        cycles.push({rechargeBefore, rechargeSeconds, limpets, gatherSeconds, batchOre: batch})
+        remaining -= batch
+    }
+
+    const totalOre = cycles.reduce((s, c) => s + c.batchOre, 0)
+    const totalSeconds = cycles.reduce((s, c) => s + c.rechargeSeconds + c.gatherSeconds, 0)
+    return {
+        cycles,
+        cycleCount: cycles.length,
+        totalOre,
+        totalSeconds,
+        cap,
+        reachingCount: reaching.length,
+        totalLimpets: entity.gatherer_lanes.length,
+        warnings,
+    }
+}
+
+export function planParallelTransfer(
+    entity: GatherPlanEntity,
+    target: PlanTarget
+): LanePlanEntry[] {
+    const lanes = entity.loader_lanes.filter((l) => l.thrust.toNumber() > 0)
+    if (lanes.length === 0) return []
+
+    const requestedQty = target === 'max' ? MAX_TRANSFER_QTY : target.quantity
+
+    const laneWeights = lanes.map((l) => ({
+        slot: l.slot_index.toNumber(),
+        weight: l.thrust.toNumber(),
+    }))
+
+    return allocateProportional(laneWeights, requestedQty).filter((e) => e.quantity > 0)
+}