Skip to content

Latest commit

 

History

8 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

QUARTERMASTER

Cross-platform logistics tasking + fleet common operating picture. Cognis Digital LLC · US-only.

QUARTERMASTER is the sustainment brain over the unmanned logistics program. It takes resupply / CASEVAC / survey demand and assigns each request — in precedence order, URGENT first — to the best available air (DROPWING), ground (MULEWAY), or undersea (DEEPDRIFT) platform, tracks every mission to completion, and rolls the whole picture into one common operating picture a sustainment cell reads at a glance.

Tasking and logistics — not weapons. QUARTERMASTER matches supply/medevac/survey demand to platforms. No targeting, no strike, nothing offensive.

What it does

  • Demand model (request) — resupply (mass), CASEVAC (casualties), or survey (area), each with a medical-evacuation-style precedence (URGENT / PRIORITY / ROUTINE) and an optional deadline.
  • Fleet model (platform) — air/ground/undersea platforms with capabilities, capacity, base, speed, range, and status; factory constructors mirror the three flagships' real roles.
  • Assignment engine (assign) — precedence-ordered greedy matching scored by ETA, capacity fit, and an expendable-airframe-preservation penalty; range/capacity gating; clear reasons for anything left unassigned.
  • Mission tracking (track) — a lifecycle state machine (QUEUED→…→COMPLETE/FAILED) with enforced legal transitions and a live status board.
  • Common operating picture (cop) — fleet readiness by domain, demand profile, assignment coverage, unmet-urgent flags, and in-flight mission counts.

Quick start (CLI)

python -m quartermaster assign --scenario scenario.json

scenario.json:

{
  "platforms": [
    {"id":"DW-1","kind":"dropwing","base":[36.20,-115.10]},
    {"id":"MU-1","kind":"muleway","base":[36.19,-115.11]},
    {"id":"DD-1","kind":"deepdrift","base":[36.60,-121.90]}
  ],
  "requests": [
    {"id":"R1","type":"casevac","loc":[36.21,-115.08],"precedence":"URGENT","demand":2},
    {"id":"R2","type":"resupply","loc":[36.22,-115.07],"precedence":"PRIORITY","demand":20},
    {"id":"R3","type":"survey","loc":[36.61,-121.88],"demand":500000}
  ]
}

→ URGENT CASEVAC to the ground mule, priority resupply to the fastest air platform, survey to the UUV; exits non-zero if any URGENT request goes unmet.

Library

from quartermaster import (PlatformRegistry, dropwing, muleway, deepdrift, LatLon,
                           LogisticsRequest, RequestType, Precedence, Assigner)

reg = (PlatformRegistry().add(dropwing("DW-1", LatLon(36.20,-115.10)))
                         .add(muleway("MU-1", LatLon(36.19,-115.11))))
reqs = [LogisticsRequest("R1", RequestType.CASEVAC, LatLon(36.25,-115.02),
                         Precedence.URGENT, demand=2)]
print(Assigner(reg).assign(reqs).to_dict())

Tests

python -m pytest -q      # 882 tests

Part of the Cognis unmanned logistics program

Tasks the three flagships — DROPWING (air resupply), MULEWAY (ground resupply/CASEVAC), DEEPDRIFT (UUV survey) — over shared comms (edgemesh) and GPS-denied PNT (spoofwatch).

About

Cross-platform unmanned logistics tasking + fleet common operating picture (US). Tasking, not weapons.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages