ruflo 3.56.7 → 3.56.9

package/README.md

@@ -49,6 +49,10 @@ npx -y ruflo@latest mcp start
 
 MCP exposes Ruflo tools to your client. The console and mods above are Claude Code integrations; hook support depends on the client.
 
+<img src="docs/assets/readme/icons/terminal.svg" width="28" height="28" alt=""> **Prefer a plain terminal? Optional.** The console also runs on its own, with no Claude Code: `npx ruflo tui` (add `--plain` to print one frame for scripts). It shows Overview, Cost, Swarm, Events and Missions, plus an optional AI page. [Terminal UI guide](docs/USERGUIDE.md#terminal-ui-optional)
+
+<p align="center"><img src="docs/assets/ruflo-tui-compact.svg" width="640" alt="Looping recording of the optional ruflo terminal UI cycling through Overview, Cost, Swarm, Events and Missions in a sample project"></p>
+
 [Compare install paths](#quick-start) · [Open the console](#console-walkthrough) · [User guide](docs/USERGUIDE.md)
 
 <div align="center">
@@ -116,9 +120,11 @@ User → Ruflo (CLI/MCP) → Router → Swarm → Agents → Memory → LLM prov
 
 <p align="center"><img src="docs/assets/readme/console.svg" alt="Mission control: inspect agent work" width="100%"></p>
 
-<p align="center"><img src="docs/assets/ruflo-console-workflows.svg" width="952" height="964" alt="An animated recording of the ruflo console inside Claude Code: the boot (the neon sign and every area checked), then the Workflows page on a sample run: phases and agents with model, tokens and time; drilling from a run into one agent's activity, log and result; search; failure triage; cost; replay and compare; the control tab with a confirm card; and the mission autopilot panel"></p>
+<p align="center"><a href="https://raw.githubusercontent.com/ruvnet/ruflo/main/docs/assets/ruflo-console-theme-compact.svg"><img src="docs/assets/ruflo-console-theme-compact.svg" width="100%" alt="Ruflo Orbital theme: animated boot checks, block logo, menu icons, rotating globe, swarm routing, six color palettes and responsive Theme Studio"></a></p>
+
+[Open animated demo](https://raw.githubusercontent.com/ruvnet/ruflo/main/docs/assets/ruflo-console-theme-compact.svg) · [Theme Studio guide](plugins/ruflo-console/README.md) · [Workflow demo](docs/assets/ruflo-console-workflows.svg)
 
-<img src="docs/assets/readme/console-icon-workflows.svg" width="28" height="28" alt=""> **Your agent cockpit.** Track workflows, agents, models, tokens and cost beside Claude Code. The animation shows startup checks and a **sample workflow**, not a live session.
+<img src="docs/assets/readme/console-icon-workflows.svg" width="28" height="28" alt=""> **Your agent cockpit.** Track workflows, agents, models, tokens and cost beside Claude Code. The 38 second animation shows **Orbital and Theme Studio** through actual renderer frames, including boot checks, six palettes, customization, saved themes, JSON import and resizing. This compact 3.84 MB SVG retains all 456 frames. Native host and AI provider execution are not demonstrated.
 
 <img src="docs/assets/readme/console-icon-inspect.svg" width="28" height="28" alt=""> **Inspect any run.** Open agent logs and results, search, triage failures, replay and compare. Start with `npx ruflo init`, restart Claude Code, then `/ruflo`. [Full console tour](docs/assets/ruflo-console-walkthrough-wide.gif).
 
@@ -136,7 +142,7 @@ User → Ruflo (CLI/MCP) → Router → Swarm → Agents → Memory → LLM prov
 4. **Verify the result.** Check that Missions contains the goal and Overview records the action. Creating a mission does not mean the feature has been implemented.
 5. **Keep control.** **Take back control** pauses Claude's console tools. A later call should be refused until you restore control.
 
-**What the recording demonstrates:** a real Claude Haiku session with `write + auto`, mission creation, page navigation, a refused swarm stop, and control being taken back. The steps above use `ask` so you approve creation yourself. The separate workflow animation uses sample data; neither is evidence of completed swarm work or memory recall.
+**What the recording demonstrates:** a real Claude Haiku session with `write + auto`, mission creation, page navigation, a refused swarm stop, and control being taken back. The steps above use `ask` so you approve creation yourself. The linked workflow animation uses sample data, while the theme demo replays renderer frames. Neither is evidence of completed swarm work or memory recall.
 
 [Implementation and recorded test findings](v3/docs/adr/ADR-444-claude-controls-the-console.md) · [Reproduction script](plugins/ruflo-console/scripts/e2e-control.sh)
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ruflo",
-  "version": "3.56.7",
+  "version": "3.56.9",
   "description": "Ruflo - Enterprise AI agent orchestration platform. Deploy 60+ specialized agents in coordinated swarms with self-learning, fault-tolerant consensus, vector memory, and MCP integration",
   "main": "bin/ruflo.js",
   "type": "module",
@@ -40,7 +40,7 @@
     "package:rvf": "bash src/scripts/package-rvf.sh"
   },
   "dependencies": {
-    "@claude-flow/cli": "3.56.7"
+    "@claude-flow/cli": "3.56.9"
   },
   "optionalDependencies": {},
   "overrides": {

package/src/mcp-bridge/index.js

@@ -106,14 +106,18 @@ const TOOL_GROUPS = {
     source: "gemini-mcp",
   },
 
-  // --- OpenAI Codex ---
+  // --- OpenAI Codex (MCP server mode removed from current CLI; #3509) ---
   codex: {
-    enabled: process.env.MCP_GROUP_CODEX === "true",
-    description: "OpenAI Codex coding agent — code generation and execution (requires OPENAI_API_KEY)",
+    enabled: false,
+    description: "Unavailable: Codex CLI has no MCP server mode. Use Codex dual-mode workers instead.",
     source: "codex",
   },
 };
 
+if (process.env.MCP_GROUP_CODEX === "true") {
+  console.warn("[codex] Codex CLI has no MCP server mode; MCP_GROUP_CODEX is disabled. Use Codex dual-mode workers (codex exec) instead.");
+}
+
 // =============================================================================
 // STDIO MCP CLIENT — Connects to external MCP servers via child process
 // =============================================================================
@@ -257,7 +261,6 @@ const BACKEND_DEFS = [
   { name: "agentic-flow",   command: "npx", args: ["-y", "agentic-flow@alpha", "mcp", "start"], groups: ["agentic-flow"] },
   { name: "claude",         command: "claude", args: ["mcp", "serve"],                  groups: ["claude-code"] },
   { name: "gemini-mcp",     command: "npx", args: ["-y", "gemini-mcp-server"],          groups: ["gemini"] },
-  { name: "codex",          command: "npx", args: ["-y", "@openai/codex", "mcp-server"], groups: ["codex"] },
 ];
 
 const mcpBackends = new Map();
@@ -602,19 +605,7 @@ Requires: GOOGLE_API_KEY environment variable (already set for Gemini models).
 
     codex: `# Codex Group
 
-OpenAI Codex coding agent.
-
-Requires: OPENAI_API_KEY environment variable (already set for OpenAI models).
-
-## Capabilities
-- Code generation and execution
-- Code completion
-- Code explanation
-
-## When to Use
-- Code generation tasks
-- Quick code completions
-- Code explanation and documentation`,
+Unavailable: current Codex CLI has no MCP server mode (#3509). This group is disabled even if MCP_GROUP_CODEX=true, so it exposes no tools. Use the separate Codex dual-mode worker through codex exec. A future MCP adapter requires its own execution and security design.`,
   };
 
   if (topic === "tool" && toolName) {

package/src/ruvocal/docs/adr/ADR-034-OPTIONAL-MCP-BACKENDS.md

@@ -1,4 +1,4 @@
-# ADR-034: Optional MCP Backends — Claude Code, Gemini, Codex
+# ADR-034: Optional MCP Backends — Claude Code and Gemini
 
 **Status:** Accepted
 **Date:** 2026-03-05
@@ -16,7 +16,7 @@ These require their own API keys and have different resource profiles, so they s
 
 ## Decision
 
-Add three optional MCP backends that can be enabled via environment variables. Unlike ruvector/ruflo (enabled by default), these are **disabled by default** and require explicit API keys.
+Claude Code and Gemini remain optional MCP backends. Codex was originally listed here, but current Codex CLI has no MCP server mode. As of #3509, the bridge leaves that group disabled and warns when `MCP_GROUP_CODEX=true` is requested. Ruflo's separate Codex dual-mode workers use `codex exec`; a future MCP adapter needs a separate execution and security design.
 
 ### Backend Configuration
 
@@ -26,7 +26,7 @@ Add three optional MCP backends that can be enabled via environment variables. U
 | ruflo | `ENABLE_RUFLO` | None | `npx ruflo mcp start` | **enabled** |
 | Claude Code | `ENABLE_CLAUDE_CODE` | `ANTHROPIC_API_KEY` | `claude mcp serve` | disabled |
 | Gemini MCP | `ENABLE_GEMINI_MCP` | `GOOGLE_API_KEY` | `npx gemini-mcp-server` | disabled |
-| Codex | `ENABLE_CODEX` | `OPENAI_API_KEY` | `npx @openai/codex mcp serve` | disabled |
+| Codex | `MCP_GROUP_CODEX` | N/A | No supported MCP server mode | unavailable; opt-in warns |
 
 ### Architecture
 
@@ -37,7 +37,6 @@ ruvector__hooks_route      → ruvector MCP
 ruflo__agent_spawn         → ruflo MCP
 claude__Read               → Claude Code MCP
 gemini__chat               → Gemini MCP
-codex__execute             → Codex MCP
 ```
 
 ```
@@ -52,10 +51,10 @@ codex__execute             → Codex MCP
 │  └─────────────┘  └──────────────┘                   │
 │                                                       │
 │  Optional backends (API key required):                │
-│  ┌──────────────┐  ┌───────────┐  ┌───────────────┐ │
-│  │ Claude Code  │  │ Gemini    │  │ OpenAI Codex │ │
-│  │ (opt-in)     │  │ (opt-in)  │  │ (opt-in)     │ │
-│  └──────────────┘  └───────────┘  └───────────────┘ │
+│  ┌──────────────┐  ┌───────────┐                     │
+│  │ Claude Code  │  │ Gemini    │                     │
+│  │ (opt-in)     │  │ (opt-in)  │                     │
+│  └──────────────┘  └───────────┘                     │
 └───────────────────────────────────────────────────────┘
 ```
 
@@ -69,10 +68,10 @@ ANTHROPIC_API_KEY=sk-ant-...
 ENABLE_GEMINI_MCP=true
 GOOGLE_API_KEY=AIzaSy...   # already set for Gemini models
 
-ENABLE_CODEX=true
-OPENAI_API_KEY=sk-...      # already set for OpenAI models
 ```
 
+`MCP_GROUP_CODEX=true` is not an enablement path: it produces an explicit warning and does not start a Codex child process.
+
 ### Security Considerations
 
 1. **API keys stay server-side** — keys are only in the bridge container's env vars, never exposed to the browser
@@ -88,14 +87,13 @@ OPENAI_API_KEY=sk-...      # already set for OpenAI models
 | ruflo | ~50MB | Low | ~5s |
 | Claude Code | ~100MB | Medium | ~5s |
 | Gemini MCP | ~40MB | Low | ~4s |
-| Codex | ~80MB | Medium | ~5s |
 
-With all 5 backends enabled, the bridge container needs ~800MB memory.
+Resource estimates for the remaining backends require current deployment measurement.
 
 ## Consequences
 
 ### Positive
-- Users can access Claude, Gemini, and Codex capabilities directly from HF Chat UI
+- Users can access Claude and Gemini capabilities directly from HF Chat UI
 - Single `/mcp` endpoint — no client-side config changes
 - Opt-in model keeps default resource usage low
 - API keys shared with the chat proxy (no additional secrets needed for Gemini/OpenAI)

package/src/ruvocal/mcp-bridge/index.js

@@ -106,14 +106,18 @@ const TOOL_GROUPS = {
     source: "gemini-mcp",
   },
 
-  // --- OpenAI Codex ---
+  // --- OpenAI Codex (MCP server mode removed from current CLI; #3509) ---
   codex: {
-    enabled: process.env.MCP_GROUP_CODEX === "true",
-    description: "OpenAI Codex coding agent — code generation and execution (requires OPENAI_API_KEY)",
+    enabled: false,
+    description: "Unavailable: Codex CLI has no MCP server mode. Use Codex dual-mode workers instead.",
     source: "codex",
   },
 };
 
+if (process.env.MCP_GROUP_CODEX === "true") {
+  console.warn("[codex] Codex CLI has no MCP server mode; MCP_GROUP_CODEX is disabled. Use Codex dual-mode workers (codex exec) instead.");
+}
+
 // =============================================================================
 // STDIO MCP CLIENT — Connects to external MCP servers via child process
 // =============================================================================
@@ -262,7 +266,6 @@ const BACKEND_DEFS = [
   { name: "agentic-flow",   command: "npx", args: ["-y", "agentic-flow@alpha", "mcp", "start"], groups: ["agentic-flow"] },
   { name: "claude",         command: "claude", args: ["mcp", "serve"],                  groups: ["claude-code"] },
   { name: "gemini-mcp",     command: "npx", args: ["-y", "gemini-mcp-server"],          groups: ["gemini"] },
-  { name: "codex",          command: "npx", args: ["-y", "@openai/codex", "mcp-server"], groups: ["codex"] },
 ];
 
 const mcpBackends = new Map();
@@ -607,19 +610,7 @@ Requires: GOOGLE_API_KEY environment variable (already set for Gemini models).
 
     codex: `# Codex Group
 
-OpenAI Codex coding agent.
-
-Requires: OPENAI_API_KEY environment variable (already set for OpenAI models).
-
-## Capabilities
-- Code generation and execution
-- Code completion
-- Code explanation
-
-## When to Use
-- Code generation tasks
-- Quick code completions
-- Code explanation and documentation`,
+Unavailable: current Codex CLI has no MCP server mode (#3509). This group is disabled even if MCP_GROUP_CODEX=true, so it exposes no tools. Use the separate Codex dual-mode worker through codex exec. A future MCP adapter requires its own execution and security design.`,
   };
 
   if (topic === "tool" && toolName) {