labgate 0.5.30 → 0.5.32

package/README.md

@@ -94,6 +94,54 @@ labgate policy validate [file]                                   # validate poli
 labgate logs [-n 20]        # view recent audit events
 labgate logs --follow       # stream new audit events
 labgate init [--force]      # create/reset config
+labgate explore create --name <name> --repo <path> --eval "<command>"  # create Solution Explorer experiment
+labgate explore tick --experiment <id>                                  # run one autopilot tick (cron-friendly)
+labgate explore overview --experiment <id>                              # aggregated status/counts/best/latest
+labgate explore run --id <run-id>                                       # run metadata + artifact paths
+labgate explore gc --experiment <id>                                    # retention-based prune (dry-run by default)
+labgate explore compare --experiment <id> --run <run-id> --to best      # score+diff compare
+```
+
+### Solution Explorer (MVP backend)
+
+LabGate now includes an early **Solution Explorer** backend for reproducible
+variant search workflows:
+
+- Isolated experiment repo clones under `~/.labgate/explorer/repos/`
+- Git worktree-per-run execution
+- Deterministic eval contract parsing (`score` JSON on last stdout line)
+- Per-run artifacts (`eval.json`, logs, diff, summary)
+- Cron-safe autopilot tick lock
+
+Starter template:
+
+```bash
+templates/tsp-lab/
+```
+
+Example flow:
+
+```bash
+# Create experiment from a local repo
+labgate explore create \
+  --name "TSP baseline" \
+  --repo /path/to/tsp-lab \
+  --eval "python3 eval.py" \
+  --agent-mode stub \
+  --stub-patch stub-patches/enable_two_opt.patch
+
+# Trigger one run
+labgate explore tick --experiment <experiment-id>
+
+# Inspect tree and leaderboard
+labgate explore tree --experiment <experiment-id> --mode best_path
+labgate explore leaderboard --experiment <experiment-id> --top 5
+```
+
+Cron example (every 5 minutes):
+
+```bash
+*/5 * * * * /usr/bin/env labgate explore tick --experiment <experiment-id>
 ```
 
 ### Options