Add plugin update and install reporting

README.md

@@ -8,9 +8,8 @@ The first implementation focuses on safe local workflows:
 - scan existing `Plugins/` and `Libs/` files
 - read checked-in registry and per-version lockfiles
 - generate a machine-readable install plan from local release assets
-- apply exactly that plan with backups and install state
+- apply exactly that plan and record install state
 - uninstall only files recorded in install state
-- back up `UserData` separately
 
 Default BSManager instance root:
 
@@ -20,18 +19,20 @@ Default BSManager instance root:
 
 Override with `--instances-root` or `PLUGIN_HELPER_INSTANCES_ROOT`.
 
-## Quick Start
+## Commands
+
+Run from the repo root with `PYTHONPATH=src` unless installed.
 
 ```sh
-python -m plugin_helper instances
-python -m plugin_helper scan --instance 1.40.8
-python -m plugin_helper plan --instance 1.40.8 --state-dir .state
+PYTHONPATH=src python -m plugin_helper instances
+PYTHONPATH=src python -m plugin_helper --state-dir .state installed --instance 1.40.8
+PYTHONPATH=src python -m plugin_helper updates --instance 1.40.8
+PYTHONPATH=src python -m plugin_helper scan --instance 1.40.8
+PYTHONPATH=src python -m plugin_helper --state-dir .state plan --instance 1.40.8
 ```
 
 Install assets are currently expected to already exist locally, usually under:
 
 ```text
-.state/instances/<instance>/downloads/
+.state/instances/<instance>/downloads/<plugin-id>/
 ```
-
-Future milestones will add GitHub release discovery and download.