Add simulator replica, persistence, planet scan, README; split empire state out of the repo

- tools/simulate.py + puga/simulate.py: replica of PRUNplanner's simulator (flows and
  efficiency verified against screenshots), reports real new capex (planned minus built)
- tools/scan.py: staffing variants, freight, HQ/experts, --planet mode, demolish-later,
  --min-n as a pure market-size filter, --json output
- tools/history.py, tools/persistence.py: margin history and short-horizon payback checks
- tools/plan_push.py: guarded delete; tools/state.py: syncs to empire/
- README with features and setup; CLAUDE.md made generic
- Own-empire material (profile, state, plans, notes) moved to gitignored empire/;
  generic examples in plans/examples and state/company.example.yaml

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>

plans/examples/base_plus_hwp.yaml

@@ -1,10 +1,10 @@
-# Deimos as it stands (FIO 2026-09-18) plus the BHP thesis: 1 HWP (STL variant) and 1 HB2 for its 40 settlers.
+# A base as it stands plus the BHP thesis: 1 HWP (STL variant) and 1 HB2 for its 40 settlers.
 # Technicians left unstaffed (no HB3): workforce factor 40/50 = 0.8.
-name: "[PuGa] Deimos BHP (HWP + HB2)"
+name: "[PuGa] Example: base + HWP"
 planet: ZV-759c
 permits: 1
 cogc: METALLURGY
-hq: false
+hq: true
 experts: {METALLURGY: 2}
 infrastructure: {HB1: 4, HB2: 1}
 buildings:

plans/examples/hwp_buildout.yaml

@@ -0,0 +1,11 @@
+# The buildout only: 1 HWP (BHP from AL + STL + HE) and the 1 HB2 for its 40 settlers.
+# Technicians (10) left unstaffed: workforce factor 40/50 = 0.8. No pioneer housing, no EXT/SME (existing base, sunk).
+name: "[PuGa] Example: HWP buildout"
+planet: ZV-759c
+permits: 1
+cogc: METALLURGY
+hq: true
+experts: {METALLURGY: 2}
+infrastructure: {HB2: 1}
+buildings:
+  - {building: HWP, amount: 1, recipes: ["AL,STL,HE=>BHP"]}

plans/examples/hwp_only.yaml

@@ -0,0 +1,10 @@
+# Matches a simulator screenshot: EXT/SME removed from the plan, 4 HB1 still listed, HWP + HB2.
+name: "[PuGa] Example: HWP only"
+planet: ZV-759c
+permits: 1
+cogc: METALLURGY
+hq: true
+experts: {METALLURGY: 2}
+infrastructure: {HB1: 4, HB2: 1}
+buildings:
+  - {building: HWP, amount: 1, recipes: ["AL,STL,HE=>BHP"]}