setup

/setup

Self-healing setup. Goal: two user actions max: install plugin, type /setup. Default backend is local memory: no local model, no API key, no prompts.

Steps

Run in order. Stop and report at the first failure that needs human attention. Otherwise, push through automatically.

1. Health probe

for i in 1 2 3; do
  curl -fsS -m 3 http://127.0.0.1:7878/api/health && break
  sleep 1
done

• 200 OK: continue to version drift probe.
• Anything else: continue to bootstrap.

2. Version drift probe

Compare daemon version vs plugin manifest version:

PLUGIN_JSON="${CODEX_PLUGIN_ROOT:-plugin-codex}/.codex-plugin/plugin.json"
"${CODEX_PLUGIN_ROOT:-plugin-codex}/bin/version-drift.sh" --health-url http://127.0.0.1:7878/api/health --manifest "$PLUGIN_JSON"

It prints one line, daemon=<v> expected=<v> release=<v> result=<result>, comparing numerically per component with build metadata (+g<sha>) stripped. older means the daemon is older than the plugin.

• result=same: continue to doctor.
• If the probe cannot run because the runtime is down: continue to bootstrap.
• result=unknown with a healthy runtime (manifest unreadable or no version reported): continue to doctor; the next /setup will report the mismatch again if one exists.
• If mismatch, check the direction before repairing. result=newer: the daemon release is newer than the plugin release, so the plugin cache is stale, not the runtime. Skip the repair below (it would only reinstall the same-or-latest runtime and restart a healthy daemon) and go straight to the stop message in step 4 — update the plugin, restart, rerun.
• Only if the daemon release is older than the plugin release, repair the runtime (result=older):

PLUGIN_JSON="${CODEX_PLUGIN_ROOT:-plugin-codex}/.codex-plugin/plugin.json"
RELEASE_VER="$("${CODEX_PLUGIN_ROOT:-plugin-codex}/bin/version-drift.sh" --health-url http://127.0.0.1:7878/api/health --manifest "$PLUGIN_JSON" | sed -n 's/.* release=\([^ ]*\) .*/\1/p')"
curl -fsSL https://raw.githubusercontent.com/wenlan-app/wenlan/v${RELEASE_VER}/install.sh | bash
export PATH="$HOME/.wenlan/bin:$PATH"
wenlan setup --basic
wenlan background on