swarm repositories / source
aboutsummaryrefslogtreecommitdiff
path: root/README.md
diff options
context:
space:
mode:
authormain <main@swarm.moe>2026-03-21 19:19:49 -0400
committermain <main@swarm.moe>2026-03-21 19:19:49 -0400
commite15fd4966e21bd8d31dbf580ede8a309c994816d (patch)
tree691d38d549959a59c02b982dd96cab9542dc3d85 /README.md
parent3a523c3c8ac1bf9094dbe65a6f53b71085438c0c (diff)
downloadfidget_spinner-e15fd4966e21bd8d31dbf580ede8a309c994816d.zip
Sharpen frontier grounding and experiment comparatorsHEADmain
Diffstat (limited to 'README.md')
-rw-r--r--README.md27
1 files changed, 24 insertions, 3 deletions
diff --git a/README.md b/README.md
index 0277361..88224a6 100644
--- a/README.md
+++ b/README.md
@@ -124,10 +124,12 @@ cargo run -p fidget-spinner-cli -- frontier create \
Write the frontier brief:
```bash
-cargo run -p fidget-spinner-cli -- frontier update-brief \
+cargo run -p fidget-spinner-cli -- frontier update \
--project . \
--frontier native-mip \
- --situation "Root LP spend is understood; node-local LP churn is the active frontier."
+ --objective "Drive braid-rail LP cash-out" \
+ --situation "Root LP spend is understood; node-local LP churn is the active frontier." \
+ --scoreboard-metric nodes_solved
```
Record a hypothesis:
@@ -188,6 +190,12 @@ Inspect live metrics:
cargo run -p fidget-spinner-cli -- metric keys --project . --frontier native-mip --scope live
```
+Inspect scoreboard-grade metrics:
+
+```bash
+cargo run -p fidget-spinner-cli -- metric keys --project . --frontier native-mip --scope scoreboard
+```
+
```bash
cargo run -p fidget-spinner-cli -- metric best \
--project . \
@@ -196,6 +204,17 @@ cargo run -p fidget-spinner-cli -- metric best \
--key nodes_solved
```
+Find the nearest accepted, kept, rejected, and champion comparators for one slice:
+
+```bash
+cargo run -p fidget-spinner-cli -- experiment nearest \
+ --project . \
+ --frontier native-mip \
+ --metric nodes_solved \
+ --dimension instance=4x5-braid \
+ --dimension duration_s=20
+```
+
## MCP Surface
Serve the MCP host:
@@ -222,7 +241,7 @@ The main model-facing tools are:
- `frontier.list`
- `frontier.read`
- `frontier.open`
-- `frontier.brief.update`
+- `frontier.update`
- `frontier.history`
- `hypothesis.record`
- `hypothesis.list`
@@ -234,6 +253,7 @@ The main model-facing tools are:
- `experiment.read`
- `experiment.update`
- `experiment.close`
+- `experiment.nearest`
- `experiment.history`
- `artifact.record`
- `artifact.list`
@@ -250,6 +270,7 @@ The main model-facing tools are:
- frontier brief
- active tags
+- scoreboard metric keys
- live metric keys
- active hypotheses with deduped current state
- open experiments