@cmflow/agents 3.4.0-beta.32 → 3.4.0-beta.33

package/README.md

@@ -62,6 +62,7 @@ npx -p @cmflow/agents cm-agents install --reinstall   # force reinstall of every
 Checks the workstation installation state and prints a pass / warn / fail report:
 
 - **Node.js version** ≥ 20 (via `process.version`)
+- **npm** can execute (`npm -v`)
 - **git**, **codex**, **claude** present in PATH
 - **python** present in PATH (optional — warn only)
 - Required environment variables
@@ -71,7 +72,17 @@ Checks the workstation installation state and prints a pass / warn / fail report
 - Claude MCPs configured
 - Repository cloned
 
-> `mise` and `node` are not checked for presence — they are prerequisites to run this CLI at all.
+> `cm-agents` itself requires Node.js to start. The `check` command also validates that `npm -v` can execute.
+
+### Repair Node.js on Windows
+
+If `cm-agents check` reports that `npm -v` cannot run because a manually installed Node.js binary has a bad signature, repair the user installation with:
+
+```powershell
+cm-agents node reinstall
+```
+
+This installs mise with winget when needed, installs Node.js 24 through mise, adds `%LOCALAPPDATA%\mise\shims` to the user PATH, and removes legacy `nodejs` entries from that PATH.
 
 ```bash
 npx -p @cmflow/agents cm-agents check
@@ -80,6 +91,7 @@ npx -p @cmflow/agents cm-agents check
 ### `cm-agents codex use openai [--model <model>]`
 
 Switches Codex back to the personal OpenAI account:
+
 - Removes `model_provider`, `model_catalog_json`, `model_providers`, `openai_base_url`
 - Lists available models via the OpenAI SDK (`openai.models.list()`) and shows an interactive select prompt
 - Falls back to `gpt-5.6-luna` if `OPENAI_API_KEY` is not set or the API is unreachable
@@ -92,6 +104,7 @@ cm-agents codex use openai --model gpt-5.6-luna     # skip selection
 ### `cm-agents codex use litellm`
 
 Switches Codex to the Club Med LiteLLM provider:
+
 - If `model_providers.litellm` is not yet configured, prompts for `LITELLM_API_KEY` and `base_url` (default: `https://litellm-aiplatform.ai.clubmed.com`)
 - Fetches the Club Med model catalog from the LiteLLM API → writes `~/.codex/clubmed-models.json`
 - Sets `model_provider = "litellm"`, `model_catalog_json`, and `model_providers.litellm`
@@ -178,7 +191,7 @@ cm-agents kibana serve staging
 ## Environment variables
 
 | Variable                         | Purpose                                          |
-|----------------------------------|--------------------------------------------------|
+| -------------------------------- | ------------------------------------------------ |
 | `LITELLM_API_KEY`                | LiteLLM key (AI portal — VPN required)           |
 | `ANTHROPIC_API_KEY`              | Anthropic key (same portal)                      |
 | `ANTHROPIC_BASE_URL`             | LiteLLM proxy base URL                           |
@@ -195,7 +208,7 @@ cm-agents kibana serve staging
 ### Codex (`~/.codex/config.toml`)
 
 | Name          | URL                                       |
-|---------------|-------------------------------------------|
+| ------------- | ----------------------------------------- |
 | `clubmed_api` | `https://portal.api.clubmed/mcp`          |
 | `cms_api`     | `https://cms.api.clubmed/mcp`             |
 | `atlassian`   | `https://mcp.atlassian.com/v1/mcp/authv2` |
@@ -203,7 +216,7 @@ cm-agents kibana serve staging
 ### Claude (user scope)
 
 | Name          | URL                                                    |
-|---------------|--------------------------------------------------------|
+| ------------- | ------------------------------------------------------ |
 | `clubmed_api` | `https://portal.api.clubmed/mcp`                       |
 | `cms_api`     | `https://cms.api.clubmed/mcp`                          |
 | `atlassian`   | Marketplace plugin `atlassian@claude-plugins-official` |
@@ -215,7 +228,6 @@ cm-agents kibana serve staging
 3. Install the ChatGPT app (Codex UI): <https://chatgpt.com/download>
 4. Install Claude Desktop: <https://claude.ai/download>
 
-
 ## License
 
 The MIT License (MIT)