# Session Summary

## Project State

This repository now contains a playable Three.js/Vite autonomous space-sim prototype that has moved away from a player-command RTS testbed and toward a game-master / observer simulation.

The codebase is still TypeScript + Three.js on Vite, with authored catalogs under `src/game/data/`, but the runtime now centers on:

- procedural universe generation
- autonomous faction behavior
- direct per-ship faction control
- economic production loops
- pirate harassment
- strategic system control
- observer-oriented HUD and camera controls

## Current Prototype

The current build includes:

- a generated universe with a few dozen systems
- 4 empire factions inspired by EVE-style sovereign powers
- multiple pirate factions that raid empire space
- rich central systems that factions contest for control
- faction-owned stations, ships, inventories, and combat stats
- autonomous shipbuilding and limited outpost growth
- observer controls for camera orbit, pan, focus, and inspection

## Major Gameplay / Sim Systems

### Universe Generation

- Startup no longer uses the fixed two-system authored sandbox.
- `src/game/world/universeGenerator.ts` now generates:
  - empire capitals
  - empire mining systems
  - pirate base systems
  - central high-value systems
  - frontier filler systems
- The generated scenario also assigns:
  - faction definitions
  - initial faction-owned stations
  - initial ship formations
  - central system IDs

### Factions

- Runtime faction state now exists in `src/game/types.ts`.
- Factions track:
  - credits
  - ore mined
  - goods produced
  - ships built
  - stations built
  - ships lost
  - enemy ships destroyed
  - raids completed
  - stolen cargo
  - owned systems
- Empire factions and pirate factions are distinct runtime kinds.

### High-Level AI / Delegation

- Faction AI now acts at a strategic level and issues direct orders to ships.
- Empire AI chooses high-level goals such as:
  - secure home and mining space
  - contest central systems
  - send miners to resource systems
  - send military ships to rally and patrol targets
- Pirate AI chooses raid targets and moves military ships into hostile space.
- The fleet / wing layer has been removed from both simulation and UI.

### Economy / Production

- Mining, refining, and fabrication still run through recipe-driven station logic.
- Faction-owned inventories are effectively pooled across faction stations for recipe consumption.
- Factions can build new ships when enough goods exist.
- Empires can build limited defense outposts in central systems they control.

### Combat / Control

- Ships and relevant stations now have combat stats:
  - health
  - damage
  - range
  - cooldown
- Combat is lightweight and proximity-based.
- Central systems track control progress and controlling faction.
- Pirate ships can steal cargo from vulnerable civilian ships.

## Starting State

- Empires now start very small for easier debugging and growth observation.
- Each empire currently starts with:
  - 1 miner
  - 1 manufactory
  - 1 refinery
- Each pirate faction currently starts with:
  - 1 frigate
  - 1 trade hub
- This is a bootstrap-oriented setup: factions mine first, then try to grow from minimal infrastructure.

## UI / UX State

### Observer HUD

- The old summary panel is gone.
- The old bottom RTS command bar has been removed.
- The bottom HUD is now a selection dock that shows:
  - selection title
  - status line
  - horizontally scrolling cards for selected entities
  - fallback observer details when nothing specific is selected
- A dedicated `Debug` window now contains the `New Universe` button.

### Selection / Inspection

- Selection is no longer limited to ships and stations.
- It is now possible to select:
  - systems
  - planets
  - ships
  - stations
- Double-click centers / focuses the clicked target.
- Multiple ship selections render as horizontal cards in the bottom dock.

### Windows

- Generic draggable / resizable app windows still exist.
- Main windows currently in use:
  - `Ships`
  - `Debug`
- The `Ships` window:
  - lists ships grouped by faction
  - selects a ship on click
  - focuses a ship on double click
  - focuses a faction home system when clicking that faction header

### Strategic Rendering

- Strategic overlay and minimap infrastructure still exist.
- The minimap canvas is still created for renderer use, but it is no longer shown in the visible HUD.
- Fleet link overlays and fleet counters were removed along with the fleet system.

## Controls

- `Left Click`: inspect / select systems, planets, ships, or stations
- `Shift + Left Click`: add ships to multi-selection
- `Ctrl/Cmd + Left Click`: toggle ships in multi-selection
- `Left Drag`: marquee-select multiple visible ships
- `Double Click`: center / focus the clicked target
- `Middle Drag`: orbit camera
- `Shift + Middle Drag`: pan camera
- `Mouse Wheel` or `-` / `=`: zoom
- `W A S D`: pan camera using the same motion as `Shift + Middle Drag`
- `Q / E`: rotate camera
- `F`: focus current selection
- `G`: toggle ships window
- `Tab`: jump camera between systems

## Technical Notes

- Main runtime remains concentrated in `src/game/GameApp.ts`
- World construction and entity instancing:
  - `src/game/world/worldFactory.ts`
- Procedural universe generation:
  - `src/game/world/universeGenerator.ts`
- Selection state:
  - `src/game/state/selectionManager.ts`
- HUD / presentation:
  - `src/game/ui/hud.ts`
  - `src/game/ui/presenters.ts`
  - `src/game/ui/strategicRenderer.ts`
- Production build is currently passing with `npm run build`

## Known Limitations / Caveats

- `GameApp.ts` is still carrying too much simulation responsibility.
- Faction AI is improved, but still fairly heuristic and not yet a deep planning system.
- Combat is lightweight and does not yet model formations, threat evaluation, or target priorities in a sophisticated way.
- Economic logistics are still abstracted heavily.
- Ship construction is recipe-gated but still simplified.
- Stations consume pooled faction stock rather than explicit transport delivery chains.
- Bootstrap progression is still constrained by the current station recipe / stock model.
- The ships window is useful for inspection, but the overall UI is still only partially refit for observer mode.
- There is still no persistence layer for window layouts, saves, or generated universe seeds.

## Suggested Next Steps

- Extract faction strategy into a dedicated AI / planning module
- Separate economic simulation from UI and rendering concerns
- Improve transport logistics so goods physically move through faction supply chains
- Add explicit shipyard construction queues and faction production priorities
- Rework bootstrap progression so factions can genuinely grow from near-zero infrastructure
- Add system-level threat, ownership, and economy views for game-master inspection
- Add save/load support for generated universes and long-running simulations