stafford williams

asteroid-logistics: Freighter countdowns, log indicator, per-building stories

Thu, 05 Mar 2026 00:00:00 GMT

Freighter polish and a log indicator, then a tidy-up of the Storybook building stories.

Added

Per-spaceport freighter countdown timers
Freighter speed debug controls
Log count indicator in the top bar

Changed

Storybook building showcase split into per-building stories
Single selection atom for all entities
Type-safe branded building IDs
Log buffer cleared on reload

Fixed

Freighters skipping their departure countdown
Log clear race condition
Spaceport click area

asteroid-logistics: Game CLI, freighters and spaceports, ships modal, custom tweens

Sun, 01 Mar 2026 00:00:00 GMT

A CLI now lets me or an agent drive the running game from the terminal, and freighters started hauling cargo from new spaceports.

Added

Spaceports spawning freighters with a behaviour state machine
Find button pans to a ship from the ships modal
Ship scuttle command
Traversable CLI query methods
ShipOrbit tests
asteroids CLI controlling the running game over HTTP
Ships modal and icon-based top bar
Production progress bar in the building HUD
Selecting a mine reveals its resource regions

Changed

Custom tween engine replaces GSAP
CLI rewritten in TypeScript with Commander
CLI throws on silent no-ops
Building selection unified through BuildingManager
Auth errors and debug state saved
Ships persist across asteroid regeneration
Hotkeys blocked while typing in inputs
Save menu handles loading states

Fixed

Mine mask crash on load
Freighter HUD, landing, thrust and pathing bugs
localStorage quota overflow
PixiJS deprecation warnings
Ships orbiting a stale centre
Ramp-down animation killing landing thrust
Mine region artifact when regions were hidden
Menu close button hover shape

asteroid-logistics: Save persistence, Firebase cloud saves, ship jobs, meat production

Sun, 22 Feb 2026 00:00:00 GMT

Games now save locally and to the cloud, ships can take delivery jobs, and new production chains arrived.

Added

Ship delivery jobs hauling resources between asteroids
Firebase auth and cloud saves
Curl-able world dump endpoint
HUD load progress
Game persistence across browser sessions
Chem lab and bioreactor buildings
Culture vat and slab cutter meat production
Active recipe shown in the building HUD

Changed

UI migrated to MUI with the Exo 2 font
Ship build button moved into the factory HUD
Dump output includes resource buffers and ship jobs
Proportional resource allocation between competing buildings
Mines rejected where they'd pierce the asteroid edge

Fixed

Landing pad reservations and landed ships lost on reload
Buildings lost on cross-machine save and load
Thrust vanishing on return legs
Region labels misplaced on concave polygons
Ship selection on landing pads
Angled liftoff after reload
Incorrect mine resource percentages
Production and mine HUD regressions

asteroid-logistics: ShipManager split up, simpler managers

Tue, 10 Feb 2026 00:00:00 GMT

A complexity-reduction pass across the game's managers, chiefly breaking up ShipManager.

Changed

Ship landing, spawning and transitions extracted from ShipManager
Mouse, fog of war, building and asteroid managers simplified
Shared local-to-world coordinate transform

asteroid-logistics: Grouped Game facade, BuildingManager, phantom ship fix

Sun, 08 Feb 2026 00:00:00 GMT

The state architecture refactor wrapped up with a grouped Game facade, plus a couple of ship and habitat bug fixes.

Added

Dump world data debug button
ShipManager tests

Changed

Game slimmed to a thin grouped delegation layer
BuildingManager extracted from game operations
Game.ts facade with asteroid, building, ship and build mode groups
Migration planning docs removed, architecture doc updated
Simpler asteroid rendering and lifecycle management
Slower asteroid rotation

Fixed

Phantom ships from a reconcile race
Habitat basements piercing the asteroid boundary
FPS drop from rotation triggering re-renders

asteroid-logistics: State migration to atoms, ship animations module, slimmer entities

Wed, 14 Jan 2026 00:00:00 GMT

Mostly refactoring: game state now flows to the React UI as plain serialized snapshots through atoms rather than live game objects.

Changed

Ship animations moved to a dedicated module
Animated drill depth transitions
Ship routing, probes and production moved into the facade
Entities slimmed down, driven by the operations layer
Asteroid and ship state data types replace inventories
Buildings serialize state snapshots for the UI
HUD reads game state through atoms

asteroid-logistics: Production system, HUD split, GameOperations facade

Sun, 11 Jan 2026 00:00:00 GMT

Production buildings arrived, followed by a big architectural refactor that put a facade between the React UI and the game engine.

Added

Unit tests for habitats and mines
Production recipes with progress bars
Algae tank, block former and centrifuge buildings
Per-building and per-asteroid inventories
Destroy button with confirmation modal
Asteroid debug pane with state dump

Changed

GameOperations facade between React and the game engine
Game code moved under src/game/core/
Old E2E tests and callback bridge removed
Vitest config merged into Vite config
HUD split into asteroid, building, ship and level components
Zoom-independent region labels
Translucent mine mask in region view

Fixed

Mine hole left behind after destroying a mine

asteroid-logistics: Mines and Voronoi regions, probes, building selection, habitat controls

Fri, 26 Dec 2025 00:00:00 GMT

A busy holiday week adding mines, probes and drilling on top of Voronoi resource regions, with selectable, controllable buildings.

Added

Habitat build up, build down and demolish controls
Toggleable landing pads
Toggleable FPS counter
Pointer glow and ships debug panes
Probe factories that launch probes to expand fog of war
Mine drill depth controls with extracted resource percentages
Building selection with details in the HUD
Mine buildings that reveal resource regions beneath them

Changed

Circular asteroid field
Camera zoom-out limited to the revealed area
Shared button and menu styles
Shared selection behaviour across building types
Voronoi-based region generation
Borders hidden between same-resource regions

Fixed

Selection glow animation and click feedback
Asteroids disappearing on hover
Click targets across buildings and entities

asteroid-logistics: Resource regions, Playwright screenshot test, auto-zoom on start

Sun, 21 Dec 2025 00:00:00 GMT

Groundwork for mineral discovery: resource regions generated across asteroid surfaces, plus visual regression testing.

Added

Resource types with two region generators
Resource regions overlay and debug panel
Playwright asteroid screenshot test
Auto-zoom to the first asteroid on startup

Changed

.nvmrc pins the Node version
selectAsteroidByName moved to its own state module

Fixed

Build mode breaking after zoom-to-asteroid

asteroid-logistics: Building placement, ship factory

Tue, 09 Dec 2025 00:00:00 GMT

<h2 id="v0-13"><time datetime="2025-12-08">Dec 8</time> building placement <span>v0.13</span></h2>

Set up VS Code launch configuration for debugging.

Zoom now centers on the current selection or cursor position rather than the viewport center - much more intuitive. Fixed selection box strokes to render correctly at all zoom levels.

The big feature was the building placement system! You can now place structures on asteroids.

<h2 id="v0-14"><time datetime="2025-12-09">Dec 9</time> ship factory <span>v0.14</span></h2>

Added a README to the project. Set up the browser to open automatically on dev server launch.

Fixed ship visibility when fog is disabled and fixed fog resize when the window resizes. Added ship factory buildings with orbit exit debugging - buildings that produce new ships!

Improved the orbit system: buildings now show their exit points, ship orbits update when clearance changes, and the orbit entry calculation is shared for pad takeoff. Tuned thrust behavior - reduced thrust during liftoff rotation and added thrust ramp-down on orbit entry.

Fixed a janky issue with multi-ship transitions. Split WorldDebug into separate panels for better organization. The ship factory now has a proper build queue system, and ships reinitialize correctly when asteroids regenerate.

asteroid-logistics: Multi-selection, landing pads, fog of war and HUD

Sun, 07 Dec 2025 00:00:00 GMT

<h2 id="v0-6"><time datetime="2025-12-01">Dec 1</time> cleanup <span>v0.6</span></h2>

Cleanup day. Removed the refactor checks that were getting in the way, deleted old unused scripts, and reorganized the debug systems. Moved PathDebug into a dedicated path directory and WorldDebug into a world directory.

Cleaned up dependencies and quieted down the test output. Much tidier codebase now.

<h2 id="v0-7"><time datetime="2025-12-02">Dec 2</time> architecture improvements <span>v0.7</span></h2>

Added style linter rules to Biome for consistent code formatting. Refactored the pathfinding code into proper modules and renamed files to match their export names.

The big user-facing feature today was ship selection and click-to-navigate. You can now click a ship to select it, then click on another asteroid to send it there. Also made it so each asteroid spawns with its own ship.

<h2 id="v0-8"><time datetime="2025-12-03">Dec 3</time> MouseManager and multi-selection <span>v0.8</span></h2>

Created a MouseManager to centralize all mouse handling - selection, panning, zooming, and clicking are now in one place. Moved path interaction into it as well. Right-click on an asteroid now moves selected ships there.

Did a bunch of renaming for clarity: SavedPairsManager became SavedRoutes, GameViewport became GameManager. Replaced all hardcoded colors with the open-color palette for consistency.

Fixed several bugs: multi-ship movement on right-click, ship snap-back at end of path, and clamped zoom/pan to world bounds so you can't scroll into the void.

Refactored Asteroid into its own directory, extracted path animation and geometry helpers, and added jscpd for detecting duplicate code. Made ship pathfinding async with a cached graph for better performance.

<h2 id="v0-9"><time datetime="2025-12-04">Dec 4</time> selection fix <span>v0.9</span></h2>

Fixed ship click behavior - clicking a ship now properly deselects others instead of adding to the selection.

<h2 id="v0-10"><time datetime="2025-12-05">Dec 5</time> CI/CD and landing pads <span>v0.10</span></h2>

Cleaned up unused methods and tweaked member accessibility modifiers in the code. Set up Netlify for CI/CD deployment - the game is now live on the web!

The main feature was the ship landing pad system. Ships now have designated spots to land on asteroids, with proper entry point calculations for approach. This makes the docking feel much more intentional.

<h2 id="v0-11"><time datetime="2025-12-06">Dec 6</time> controls and visual polish <span>v0.11</span></h2>

Added full keyboard support - arrow keys and WASD for panning, Q/E for zooming.

Visual improvements were the star of the show today. Added a parallax starfield with subtle glow effects in the background - really sells the space vibe. Added hover glow for selectable items so it's clear what you can interact with.

Ships got a lot of love: they now rotate toward their target on liftoff, have thrust particle effects during flight, ramp down thrust when arriving at orbit, and the orbit-to-path transition is smoother. Also optimized the orbit path to landing pad routing.

Implemented fog of war! Used a smoke effect with soft noisy edges that looks great. Added a debug tool for revealing fog and an animation that reveals from the edges. The fog panel has a reset button for testing.

Added a HUD system using Jotai for state management. Asteroids now display their names, and selected ships show in the HUD. Fixed ship selection stroke rendering gaps and clamped keyboard zoom to stay within limits.

Did some deployment fixes - trailing slash redirects, renamed the page title, and switched to relative base paths for assets.

asteroid-logistics: Project genesis, stations, orbits and pathfinding

Sun, 30 Nov 2025 00:00:00 GMT

<h2 id="v0-1"><time datetime="2025-11-24">Nov 24</time> project genesis <span>v0.1</span></h2>

Today I kicked off the Asteroid Logistics project. Started with the basic scaffolding - got the initial project structure in place, added a viewport system for handling the game canvas, and integrated Tweakpane for debugging controls.

The main focus was getting asteroids rendering properly. I implemented the core asteroid entity with configurable radius and rotation. Added interactivity so you can click on them, and then expanded to support multiple asteroids in the world. Feels good to have something tangible on screen already!

Quick fix today - the zoom functionality was broken and needed some attention. Not glamorous work but necessary.

<h2 id="v0-3"><time datetime="2025-11-26">Nov 26</time> stations and orbits <span>v0.3</span></h2>

Big day! I added landing stations on asteroids and implemented an orbit system so objects can circle around asteroids. This is the foundation for how ships will approach and dock.

Also set up the verify script for code quality checks and added the first ship entity. Left things in a work-in-progress state with some rough edges to polish later.

<h2 id="v0-4"><time datetime="2025-11-29">Nov 29</time> pathfinding deep dive <span>v0.4</span></h2>

Massive session today. Fixed a blank screen bug that was preventing asteroids from generating on init, then dove deep into the pathfinding system.

Added debug visualization for paths which was essential for debugging. The path finding went through several iterations - fixed external tangent line calculations, corrected arc directions, improved the algorithm with proper tangent points. I extracted a dedicated tangentPathFinder module to keep things clean.

Also added persistence for debug pane values (finally!), set up a commit message validation script, and created slash commands for the dev workflow. Added test cases for the pathfinding edge cases I discovered.

Ships can now transition between asteroids which is a huge milestone!

<h2 id="v0-5"><time datetime="2025-11-30">Nov 30</time> arc tangent pathfinding <span>v0.5</span></h2>

Continued the pathfinding work. Implemented arcTangentPathFinder for smoother curved paths. Added persistence for path debug points and save/restore functionality for debug pairs.

The big improvements were internal tangents support, precomputing the tangent graph for performance, and making pathfinding async so it doesn't block the main thread.

Simplified the orbit system by replacing elliptical orbits with circular ones - less realistic but much easier to reason about for pathfinding. Removed the Dubins path approach in favor of the arc tangent system.

Added ship transitions between asteroids with GSAP easing for smooth animations. The transition now has a pre-tween to the path start, smooth orbit-to-path transitions, and ships can be interrupted mid-flight. Also added a station visibility toggle for debugging.