Naval architecture and marine engineering in Zig.
North star: AF/Navy capture as sub/support/prime-on-narrow — shared doc in
SMC17/sovereign-experience
docs/NORTH_STAR.md. Yard is the naval (Navy) programme under that compass;
near product is evidence-bearing marine engineering tooling, not Maxsurf/NAPA
replacement.
72 primitive modules plus integrated design, fleet, competition, and viewer
packages in one repository. Consolidated 2026-07-07 from the individual
yard-*-zig repositories; each module keeps its own build.zig, source,
and test suite.
| module | scope |
|---|---|
| ais | AIS vessel-tracking decode |
| anchor | anchor holding power and ground-tackle sizing |
| auv | autonomous underwater vehicle dynamics |
| azipod | azimuth-thruster (azipod) propulsion |
| benchmark | standard-hull validation harness + tank extrapolation |
| bem | boundary-element-method ship hydrodynamics |
| bow | bow form and added resistance in waves |
| cargo | cargo stowage and loading computations |
| cathodic | cathodic corrosion protection |
| cavitation | propeller cavitation analysis |
| cii | IMO Carbon Intensity Indicator (CII) |
| collision | collision damage and risk analysis |
| combat | naval combat-system modeling |
| compose | multi-module naval workflows (spiral, DP, seakeeping) |
| coupled-motions | coupled 6-DOF ship motions |
| csr-buckling | CSR buckling assessment |
| csr-fatigue | CSR fatigue assessment |
| csr | IACS Common Structural Rules |
| deck | deck structural design |
| deicing | marine de-icing and winterization |
| drydock | dry-docking operations |
| dynpos | dynamic positioning (DP) capability |
| eedi | IMO Energy Efficiency Design Index (EEDI) |
| engine | marine engine performance |
| flettner | Flettner rotor-sail thrust |
| fmi | FMI co-simulation interface |
| fleet | generic multi-vessel design, preliminary scantlings, and hierarchical formation control |
| foilcraft | hydrofoil-craft dynamics |
| fossen-6dof | Fossen 6-DOF maneuvering model |
| fueltank | fuel-tank sloshing and management |
| grounding | grounding damage and residual stability |
| helideck | helideck design and loads |
| hess-smith-3d | Hess-Smith 3D panel method |
| historical-conflict | governed 1778-only aggregate conflict screening and replay |
| hydro | ship hydrostatics |
| icebreaker | icebreaking resistance |
| irf | radiation impulse-response functions |
| ittc78 | ITTC-1978 performance prediction |
| jacket | offshore jacket structure |
| keel | keel and appendage design |
| launch | ship-launch dynamics |
| load-line | load line and freeboard (ICLL) |
| maneuvering | ship maneuvering prediction |
| mass | mass and weight estimation |
| mooring | mooring-system analysis |
| naval-arch | naval-architecture core primitives |
| noise | underwater radiated-noise estimation |
| pipeline | subsea pipeline engineering |
| port-engineering | port civil engineering |
| port-logistics | port logistics and throughput |
| propulsion | propulsion-system modeling |
| rao-spectrum | response-amplitude-operator spectra |
| recycling | ship recycling — Hong Kong Convention 2009 + EU SRR |
| resistance | ITTC-57 friction line and resistance prediction |
| roro | RoRo / ferry vehicle-deck loading |
| routing | spherical-geodesy voyage routing |
| saildrone | unmanned wind-powered surface vehicle dynamics |
| savitsky | Savitsky planing-hull lift |
| seakeeping | wave spectra and seakeeping response |
| similarity | geometric/kinematic/dynamic scaling + ITTC-78 extrapolation |
| spiral | Evans 1959 design spiral orchestrator |
| shaft | marine shafting torsional vibration |
| shipyard-mgmt | shipyard production scheduling |
| sloshing | linear-potential-flow tank sloshing |
| springing | hull-girder springing vibration |
| stability | small-angle intact stability |
| stir | IMO Second-Generation Intact Stability (STIR) Level 1 |
| strength | IACS Unified Requirements hull-girder strength |
| strip-theory | frequency-domain strip-theory heave |
| submarine | pressure-hull collapse (von Mises) and hydrostatics |
| terminal | container-terminal berth allocation and service |
| towing-tank | towing-tank model-test data reduction |
| tug | escort-tug performance |
| vimstab | container-stack lateral load and stability |
| viz | deterministic SVG visualization (GZ, Pareto, hull profiles) |
| viz-vulkan | deterministic 3D fleet frames plus optional native Vulkan queue/readback path |
| windaero | ship wind-coefficient estimation |
See PLATFORM.md for the composition layer, dataset pipeline, eval harness, and extension architecture ("naval Excel").
| Surface | Ownership |
|---|---|
mission/ |
Single-vessel physics gates and deterministic voyage evaluation |
era/ |
Historical material, propulsion, dimension, tonnage, and treaty envelopes |
sailaero/ + econ/ |
Sail polars and voyage economics for historical missions |
sailmission/ |
Era-gated passages and the empirical Mercury fleet backend |
fleet/ |
Generic mixed-vessel compilation, scantling screens, and safe formation control |
trials/ |
GitHub-native PR submissions, CI re-execution, JSONL results, and frontier pages |
arena/ |
Fleet/agent competition protocol, replay chains, signed seasons, hard screening, RNG contract, and scorecard binding |
arena/web/ |
Dependency-free local ship builder, Pareto board, and mission evidence UI |
arena/hosted/ |
Pre-deployment signed-season Worker, isolated agent/evaluator Sandboxes, Queue/DO coordination, R2/D1 leaderboard |
historical-conflict/ |
Fail-closed 1778 policy, deterministic aggregate fleet outcomes, and Arena replay chains |
dynpos/ |
Versioned Zig telemetry protocol and NATS publisher for the OTP fleet coordinator |
The client builder is a preflight and artifact-authoring surface. The Mercury
reference result is regenerated by yard-mercury from the licensed CLIWOC
route ensemble, then bound to a replay head before Arena scores it.
zig build test-core # hydro + stability + compose + spiral + benchmark
zig build test-all # all 72 primitive-module suites
zig build test-frontier # Mercury + Arena + fleet + telemetry + viewer + governed 1778 conflict
zig build run-example # canonical box-barge intact stability
zig build run-spiral # Evans design spiral (Wigley)
zig build run-spiral-kcs # Evans spiral with KCS tank C_T ingest
zig build run-benchmark # 18-case hull validation harness
zig build run-sim-suite # DP + irregular waves + Pareto
zig build run-fleet-viewer # formation dynamics -> deterministic 3D fleet frame
zig build run-historical-conflict # governed 1778 aggregate screening scenario
python tools/portfolio_audit/audit.py --strict
(cd arena && scripts/verify.sh) # regenerate/score Mercury + verify replay/signatures
(cd arena/hosted && npm run check && npm run build) # hosted contracts + dry-run image/Worker build
python tools/dataset/generate.py --samples 100 --output tools/dataset/out/seed.jsonl| Layer | Path | Purpose |
|---|---|---|
| Primitives | 72 modules below | Narrow, tested kernels |
| Composition | compose/, examples/ |
Multi-module workflows |
| Intelligence | tools/oracle/, tools/dataset/, tools/eval/ |
SFT data + eval |
| Docs | docs/ |
Architecture + deep dives |
License: Apache-2.0 (unified across all modules).