Add CLI and example output

README.md

@@ -29,6 +29,11 @@ Requires Python 3.10+.
 python .\physics_world.py
 ```
 
+## CLI Usage
+```powershell
+python .\physics_world.py --episodes 50 --steps 200 --g 9.81 --drag 0.12 --wind 0.4 --drag_power 2.0 --dt 0.1 --seed 123
+```
+
 ## How It Works
 1. Simulates a hidden world with gravity + drag + wind.
 2. Collects state transitions only (no equations given).
@@ -49,6 +54,14 @@ wind_est = 0.4
 g_est = 9.81
 ```
 
+## Example Output
+```text
+{'g_true': 9.81, 'drag_true': 0.12, 'wind_true': 0.4, 'drag_power_true': 2.0,
+ 'model_ax': {'vx_abs_vx': -0.12, '1': -2.209},
+ 'model_ay': {'vy_abs_vy': -0.12, '1': -13.034},
+ 'wind_est': 0.4, 'g_est': 9.81, 'samples': 634}
+```
+
 ## Install
 No external dependencies beyond standard library.
 

physics_world.py

@@ -309,6 +309,31 @@ def run_stress_test(
     }
 
 
+def _parse_args():
+    import argparse
+
+    p = argparse.ArgumentParser(description="Staticplay CurioDynamics runner")
+    p.add_argument("--episodes", type=int, default=50)
+    p.add_argument("--steps", type=int, default=200)
+    p.add_argument("--g", type=float, default=9.81)
+    p.add_argument("--drag", type=float, default=0.12)
+    p.add_argument("--wind", type=float, default=0.4)
+    p.add_argument("--drag_power", type=float, default=2.0)
+    p.add_argument("--dt", type=float, default=0.1)
+    p.add_argument("--seed", type=int, default=123)
+    return p.parse_args()
+
+
 if __name__ == "__main__":
-    result = run_stress_test()
+    args = _parse_args()
+    result = run_stress_test(
+        episodes=args.episodes,
+        steps=args.steps,
+        g=args.g,
+        drag=args.drag,
+        wind=args.wind,
+        drag_power=args.drag_power,
+        dt=args.dt,
+        seed=args.seed,
+    )
     print(result)