Initial PuGa toolkit: data layer, econ, depth-aware scan, state sync, plan push

- puga/: cached FIO + PRUNplanner clients, market view with order-book walk,
  econ formulas ported from PRUNplanner (tested against its suite and live FIO),
  saturation model v1 (reviewed by Opus)
- tools/: scan (depth-aware), price, book, chain, state sync, plan_push
  (dry run default, [PuGa]-prefixed plans only), legacy prun_scan/prun_cxarb
- docs/: mechanics (PRUNplanner is source of truth), roadmap, decisions,
  saturation design, archived handoff
- secrets stay in .env (gitignored); ref/ holds PRUNplanner source (ignored)

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

state/company.yaml

@@ -0,0 +1,50 @@
+as_of: 2026-09-18 20:52Z
+company: {name: greenish-blue Industries, ticker: GBI, user: dodox, faction: ANTARES, home_cx: AI1, currency: AIC}
+licence: FREE
+permits: {used: 1, total: 3}
+bases:
+- name: Deimos
+  planet: ZV-759c
+  cogc: METALLURGY
+  area: {used: 200, total: 500}
+  buildings: {SME: 5, EXT: 2, HB1: 4, CM: 1}
+  workforce:
+    pioneers: {required: 370, capacity: 400}
+  notes: flux recipe 6 ALO+FLX+C+O -> 4 AL (base 14h24m, divide by efficiency); buys ~29 ALO/day; refresh from live FIO/PROD
+  avg_condition: 0.9994
+  production:
+  - {type: extractor, count: 2, efficiency: 0.9993, queued_orders: 7}
+  - {type: smelter, count: 5, efficiency: 1.3361, queued_orders: 10}
+ships:
+- {name: null, reg: AVI-07JFC, mass: 1066.5760498046875, in_flight: true}
+- {name: null, reg: AVI-07JFB, mass: 827.7999877929688, in_flight: false}
+cash: {ICA: 5000.0, AIC: 21950.099609375, CIS: 5000.0, NCC: 5000.0}
+storage:
+- type: STORE
+  name: null
+  weight: 167/1500t
+  items: {OVE: 137, SF: 306, C: 25, O: 25, DW: 113, FLX: 25, FF: 200, PWO: 27, COF: 14, RAT: 113, ALO: 5}
+- type: SHIP_STORE
+  name: AVI-07JFC
+  weight: 154/500t
+  items: {AL: 32, FE: 4}
+- type: STL_FUEL_STORE
+  name: AVI-07JFB
+  weight: 0/90t
+  items: {SF: 0}
+- type: STL_FUEL_STORE
+  name: AVI-07JFC
+  weight: 72/90t
+  items: {SF: 1198}
+- type: FTL_FUEL_STORE
+  name: AVI-07JFC
+  weight: 13/15t
+  items: {FF: 264}
+- type: FTL_FUEL_STORE
+  name: AVI-07JFB
+  weight: 0/15t
+  items: {FF: 0}
+- type: SHIP_STORE
+  name: AVI-07JFB
+  weight: 0/500t
+  items: {}