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>

tests/test_econ.py

@@ -45,7 +45,7 @@ def test_hwp_without_technicians_under_metallurgy_cogc():
     assert el["WORKFORCE"] == pytest.approx(0.8) and total == pytest.approx(1.0)
 
 
-def test_extraction_matches_live_deimos():
+def test_extraction_matches_live_planet():
     """Planet data ZV-759c: ALO factor 0.4 (MINERAL), O 0.3 (GASEOUS), H2O 0.2 (LIQUID). APEX/PRUNplanner chips: 28 ALO, 18 O, 14 H2O per day.
     Live FIO EXT order: 14 ALO per 12.008 h = 28/day."""
     assert econ.daily_extraction(0.4, "MINERAL") == pytest.approx(28.0)
@@ -75,7 +75,7 @@ def test_hab_optimizer_matches_prunplanner():
 
 
 def test_matches_live_fio_smelter_efficiency():
-    """Deimos SME, FIO /production 2026-09-18: Efficiency 1.3360869884. All pioneers, both luxuries met, Metallurgy COGC,
+    """A live smelter, FIO /production 2026-09-18: Efficiency 1.3360869884. All pioneers, both luxuries met, Metallurgy COGC,
     2 metallurgy experts, condition 0.9993602633."""
     tier = dict(pioneer=econ.tier_efficiency(400, 370, True, True))
     total, el = econ.building_efficiency(dict(pioneers=50), tier, expertise="METALLURGY", cogc="METALLURGY",