@evident-ai/cli 3.4.1-dev.fbf2340 → 3.5.1-dev.8b4b29a

package/README.md

@@ -98,6 +98,34 @@ Options:
   healthy when the runner starts it itself (default: `180`). On expiry the runner
   warns and comes online anyway rather than failing. Env:
   `EVIDENT_OPENCODE_START_TIMEOUT` (seconds).
+- `--opencode-version <v1|v2>` — Which OpenCode major version to launch: `v1` or
+  `v2` (default: `v1`). Env: `EVIDENT_OPENCODE_VERSION`. When selected, the CLI
+  starts or attaches to `opencode2` and authenticates its local requests with the
+  generated server credential when it starts the process. V1 remains the default.
+- `--litestream-config <path>` — Start `litestream replicate` for the OpenCode
+  session database with this config file. Use this for runner images that persist
+  the session database; the file is produced by `runner-synchroniser litestream-config`.
+  Omit it to disable replication.
+- `--opencode-pid-file <path>` — Record the image-owned OpenCode process ID here and
+  leave that process running at shutdown for the runner image's lifecycle hooks to stop.
+- `--litestream-pid-file <path>` — Record the image-owned Litestream process ID here and
+  leave that process running at shutdown for the runner image's lifecycle hooks to stop.
+- `--session-db-no-replicate-marker <path>` — Read this marker before starting
+   Litestream; session-DB restore writes it when this boot's database is not safe to
+   replicate.
+- `--restore-session-db` — Restore and verify the OpenCode session database before
+  starting OpenCode. Requires `--litestream-config` for the replica location and
+  `--session-db-no-replicate-marker` for give-up records. Omit it for a normal local
+  run.
+- `--restore-runner-credentials` — Restore the hosted runner secret and persisted
+   credential stores before starting OpenCode. Intended for runner images; omit it
+   for a normal local run.
+- `--opencode-config-overlay <path>` — Apply a runner-provided OpenCode config
+  before starting OpenCode. Relative paths are resolved from the working directory;
+  an existing `opencode.jsonc` is replaced before `opencode.json`.
+- `--credential-sync-marker <path>` — Own the interval credential sync and write
+  this marker once the shutdown flush has finished, so the runner image's lifecycle
+  hooks can wait on it.
 - `--claude-usage-reporting <mode>` — Whether to report the local Claude Code
   subscription's rate-limit usage to Evident, so it shows on the runner page:
   `auto` (default) reports it when a usable Claude Code login is found on this
@@ -188,10 +216,18 @@ targets the **production** Evident platform by default.
 - `EVIDENT_RESOURCE_USAGE_REPORTING` — Equivalent to
   `--no-resource-usage-reporting`; set it to `off` to disable. The flag wins
   if both are set.
+- `OPENCODE_LOG_LEVEL` — OpenCode log level when `evident run` starts an
+  image-owned process: `DEBUG`, `INFO`, `WARN`, or `ERROR` (default: `INFO`).
+  Invalid values fall back to `INFO`.
+  Under `--opencode-version v2`, the accepted set is
+  `all|trace|debug|info|warn|warning|error|fatal|none` and invalid values fall back to
+  `info`.
 - `EVIDENT_LOG_LEVEL` — Equivalent to `--log-level`; the flag wins if both are
   set, and `-v`/`--verbose` also outranks this env var.
 - `EVIDENT_OPENCODE_START_TIMEOUT` — Equivalent to `--opencode-start-timeout`
   (seconds); the flag wins if both are set.
+- `EVIDENT_OPENCODE_VERSION` — Equivalent to `--opencode-version`; the flag wins
+  if both are set. Defaults to `v1`.
 - `EVIDENT_SESSION_CLEANUP_MAX_AGE` — Equivalent to `--session-cleanup-max-age`;
   the flag wins if both are set.
 - `EVIDENT_SESSION_CLEANUP_MAX_COUNT` — Equivalent to
@@ -200,6 +236,9 @@ targets the **production** Evident platform by default.
   flag wins if both are set.
 - `EVIDENT_SESSION_CLEANUP_INTERVAL` — Equivalent to
   `--session-cleanup-interval`; the flag wins if both are set.
+- `EVIDENT_SESSION_DB_PROVENANCE_STATE` — Override the path where the CLI stores
+  session-database provenance state (default:
+  `~/.local/state/evident/session-db-provenance.json`).
 
 Authentication precedence for `run`: `EVIDENT_RUNNER_KEY`/`EVIDENT_AGENT_KEY`
 (tied; `EVIDENT_RUNNER_KEY` wins if both are set) → `EVIDENT_TOKEN` →