Add the puga command and plan pull; document the UI plan workflow

- pyproject.toml + puga/cli.py: `pip install -e .` installs a `puga <tool>` command, so no
  venv path is needed (replaces requirements.txt)
- tools/plan_push.py: `pull <uuid>` reads a plan (incl. UI edits) back into a YAML spec;
  recipe entries may carry an amount so switched-off recipes round trip; fixes a variable
  that overwrote the plan name in build_payload, with a regression test
- README: usage with the puga command, and a section on working on the same plans in the
  PRUNplanner UI and from Claude (write, edit in UI, read back)
- CLAUDE.md updated accordingly

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

puga.egg-info/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: puga
+Version: 0.1.0
+Summary: Tools and know-how for Claude to assist in Prosperous Universe
+Requires-Python: >=3.12
+Requires-Dist: pyyaml
+Provides-Extra: dev
+Requires-Dist: pytest; extra == "dev"

puga.egg-info/SOURCES.txt

@@ -0,0 +1,23 @@
+README.md
+pyproject.toml
+puga/__init__.py
+puga/cache.py
+puga/cli.py
+puga/config.py
+puga/econ.py
+puga/fio.py
+puga/market.py
+puga/prunplanner.py
+puga/saturation.py
+puga/simulate.py
+puga.egg-info/PKG-INFO
+puga.egg-info/SOURCES.txt
+puga.egg-info/dependency_links.txt
+puga.egg-info/entry_points.txt
+puga.egg-info/requires.txt
+puga.egg-info/top_level.txt
+tests/test_econ.py
+tests/test_market.py
+tests/test_plan_push.py
+tests/test_saturation.py
+tests/test_simulate.py

puga.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

puga.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+puga = puga.cli:main

puga.egg-info/requires.txt

@@ -0,0 +1,4 @@
+pyyaml
+
+[dev]
+pytest

puga.egg-info/top_level.txt

@@ -0,0 +1 @@
+puga