README keeps the one-paragraph pitch and name origin, adds example
questions and a quick start. The tool index, usage examples, .env table
and layout move to docs/usage.md (now also lists sell tiers, parkcash,
undervalued, ships, lmscan). CLAUDE.md layout line points at it.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
sell, chain --consumers, planet, route, whatif, buy, runway and
network existed in the codebase but were never added to the README -
anyone reading it would have missed most of what the toolkit does.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
AIC is this player's own home currency, not universal across the
game's regions - keep the README's phrasing currency-agnostic.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Swap the generic example questions for ones that show what actually
happened this session - simulating a proposed plan before spending on
it, and scanning up 25%/day marginal ROIs that were sitting unbuilt.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
Slogan now frames PuGa as a harness that gets sharper through use, not
just a static set of tools - matches how route/whatif/chain-consumers/
planet.py actually got built this session (noticing repeated ad-hoc
work and promoting it into a tool). Codifies that loop as a standing
instruction so it keeps happening without being asked each time.
Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
- 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>
- 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>
dodoxandClaude Fable 5.1