Version pinning
Run the CLI a workspace expects, not whichever launcher changed most recently.
Two independent pins
.context-circuit/VERSION records the template the workspace received. .context-circuit/CLI_VERSION records its expected executable version. Updating one product does not imply updating the other.
Resolve the executable
- Read the workspace's CLI pin.
- Locate the installer's version store from its report or shared launcher.
- Use the executable under the matching version, OS, and architecture.
- If missing, install that exact version and use the reported versioned command.
The shared launcher on PATH points at the last installed version. A mismatched CLI warns on stderr; resolve the correct executable rather than rewriting the workspace to silence it.
Upgrade deliberately
The installer verifies checksums and embedded version before switching the launcher. Old versions remain available. Installation never initializes or migrates workspace records. An older CLI may reject fields introduced after it, which is why the workspace pin matters.