caelum0x c51b5f90cf docs: fix broken --set flag in CLI README and clarify offline cargo fetch
crates/lawsynth-cli/README.md documented `lawsynth simulate ... --set x=1`,
but `--set` is not a real flag on any subcommand (the correct flag is
`--initial NAME=VALUE`). Running the exact documented command against the
real built binary fails with exit code 2 ("missing initial value for state
'x'") -- confirmed by actually building lawsynth-cli from main and running
the documented command verbatim. Fixed to the real, working flag and
verified the corrected command runs successfully end to end.

Also tightened the top-level README's offline-cargo note: a bare
`cargo fetch` on a fresh clone still fails under this repo's
`[net] offline = true` config (reproduced live) -- the actual fix is
`CARGO_NET_OFFLINE=false cargo fetch`, which is already correctly documented
on the live docs-site installation page; brought the GitHub README in line
with it so first-time cloners don't hit the same dead end.
2026-10-26 18:12:03 +03:00
..
2026-08-16 21:04:23 +03:00
2026-08-16 21:04:23 +03:00

lawsynth-cli

The command implementation shared by the lawsynth executable and integration tests. It imports numeric CSV files, runs discovery, writes world bundles, inspects bundles, and simulates continuous or discrete worlds.

Use

lawsynth discover observations.csv --time t --state x,y --output recovered.lsworld
lawsynth inspect recovered.lsworld
lawsynth simulate recovered.lsworld --start 0 --end 10 --step 0.01 --initial x=1 --initial y=1

Discovery flags expose derivative choice, feature families, sparse solver, bootstrap, and symbolic search bounds. The current serve command intentionally returns a typed “unavailable” error: no server is started by this crate. CSV input must be rectangular, numeric, and have a strictly increasing time column; use lawsynth-data directly for supported native Parquet subset input.