specrails-core 4.0.5 → 4.0.7

package/README.md

@@ -5,7 +5,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 [![npm downloads](https://img.shields.io/npm/dw/specrails-core.svg)](https://www.npmjs.com/package/specrails-core)
 [![Claude Code](https://img.shields.io/badge/Built%20for-Claude%20Code-blueviolet)](https://docs.anthropic.com/en/docs/claude-code)
-[![Codex](https://img.shields.io/badge/Built%20for-OpenAI%20Codex-412991)](https://github.com/openai/codex)
+[![Codex — Coming Soon](https://img.shields.io/badge/OpenAI%20Codex-Coming%20Soon%20(in%20lab)-lightgrey)](https://github.com/openai/codex)
 
 **Your agentic development team. From idea to production code.**
 
@@ -16,7 +16,9 @@ npx specrails-core@latest init   # install into the current repo
 /specrails:enrich                # optional: deep codebase analysis
 ```
 
-> **Requirements:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code) or [Codex CLI](https://github.com/openai/codex) (one of them), git, Node 18+.
+> **Requirements:** [Claude Code](https://docs.anthropic.com/en/docs/claude-code), git, Node 18+.
+>
+> **🧪 Codex (OpenAI) support — Coming Soon:** We are testing Codex integration in our lab. Installation is disabled for now, but the feature will be available shortly. Follow the repo for updates.
 
 ---
 
@@ -217,7 +219,8 @@ Each persona scores features 0–5. Features are ranked by score / effort ratio.
 
 | Tool | Required | Purpose |
 |------|----------|---------|
-| **Claude Code** or **Codex CLI** | Yes (one of them) | AI agent runtime |
+| **Claude Code** | Yes | AI agent runtime |
+| **Codex CLI** _(coming soon — in lab)_ | 🧪 Not yet | OpenAI Codex support is being tested in our lab and will be available shortly. |
 | **git** | Yes | Repository detection |
 | **Node 18+** | Yes | Needed for `npx specrails-core@latest init` |
 | **GitHub CLI** (`gh`) | Optional | Backlog sync to GitHub Issues, PR creation. Not needed with local tickets. |
@@ -268,10 +271,10 @@ Not simultaneously for the same project — backlog commands use one active prov
 A full `/specrails:implement` cycle for one feature typically costs a few dollars in Claude API usage. The sr-product-manager uses Opus; all other agents use Sonnet or Haiku.
 
 **Does it work with private repos?**
-Yes. Everything runs locally through Claude Code (or Codex). No external services beyond the model API.
+Yes. Everything runs locally through Claude Code. No external services beyond the model API.
 
 **How do I use specrails with Codex?**
-Same install path: `npx specrails-core@latest init --root-dir .`. The TUI detects Codex and adjusts the agent configuration. See [docs/user-docs/getting-started-codex.md](./docs/user-docs/getting-started-codex.md).
+🧪 **Coming Soon — in lab.** OpenAI Codex support is currently being tested in our lab and will be available shortly. The install path will remain the same (`npx specrails-core@latest init --root-dir .`) — the installer will detect Codex and adjust the agent configuration automatically. See [docs/user-docs/getting-started-codex.md](./docs/user-docs/getting-started-codex.md) for the preview documentation.
 
 ---
 

package/VERSION

@@ -1 +1 @@
-3.3.0
+4.0.5

package/bin/tui-installer.mjs

@@ -185,9 +185,20 @@ async function run() {
   const specrailsDir = resolve(rootDir, '.specrails');
 
   // Auto-yes: write defaults and exit (no TUI needed)
+  //
+  // Codex (OpenAI) support is currently being tested in our lab ("Coming Soon").
+  // If only Codex is detected, bail out instead of silently picking it — Claude
+  // Code is the only runtime we can install for today.
   if (autoYes) {
     const { hasClaude, hasCodex } = detectProvider();
-    const provider = hasCodex && !hasClaude ? 'codex' : 'claude';
+    if (!hasClaude && hasCodex) {
+      console.error('');
+      console.error('  ⚠  Only Codex detected — Codex (OpenAI) support is coming soon (in lab).');
+      console.error('     Please install Claude Code to continue: https://claude.ai/download');
+      console.error('');
+      process.exit(1);
+    }
+    const provider = 'claude';
     writeDefaultConfig(specrailsDir, provider);
     console.log(`  ✓ Default config written to .specrails/install-config.yaml`);
     console.log(`  ✓ Provider: ${provider}, Tier: full, Agents: ${DEFAULT_SELECTED.size}/${ALL_AGENT_IDS.length}, Preset: balanced\n`);
@@ -217,6 +228,10 @@ async function run() {
   console.log(banner.join('\n'));
 
   // ── Step 1: Provider ────────────────────────────────────────────────────────
+  //
+  // Codex (OpenAI) is still being tested in our lab ("Coming Soon"). Until the
+  // feature ships, the TUI exposes only Claude Code as a runtime — Codex shows
+  // as a disabled "Coming Soon" option so users can see it's on the roadmap.
 
   const { hasClaude, hasCodex } = detectProvider();
   let provider;
@@ -226,12 +241,16 @@ async function run() {
       message: 'Which AI provider will you use?',
       choices: [
         { value: 'claude', name: 'Claude Code (recommended)' },
-        { value: 'codex',  name: 'Codex' },
+        { value: 'codex',  name: 'Codex — Coming Soon (in lab)', disabled: '🧪 coming soon' },
       ],
     });
   } else if (hasCodex) {
-    provider = 'codex';
-    console.log('  → Provider: codex (auto-detected)\n');
+    exitFullscreen();
+    console.error('');
+    console.error('  ⚠  Only Codex detected — Codex (OpenAI) support is coming soon (in lab).');
+    console.error('     Please install Claude Code to continue: https://claude.ai/download');
+    console.error('');
+    process.exit(1);
   } else {
     provider = 'claude';
     if (hasClaude) {

package/docs/deployment.md

@@ -1,5 +1,7 @@
 # Deployment
 
+> **🧪 Codex (OpenAI) Support — Coming Soon (in Lab).** Any Codex-specific option or step below describes the planned behaviour. Codex installation is currently disabled; the installer will guide you to Claude Code instead.
+
 SpecRails runs locally — no cloud infrastructure required. Choose the setup that fits your workflow.
 
 ## Options at a glance

package/docs/getting-started.md

@@ -15,6 +15,8 @@ You need:
 - **Git** — your project must be a git repository
 - **[Claude Code](https://claude.ai/claude-code)** — Anthropic's CLI tool
 
+> **🧪 Codex (OpenAI) Support — Coming Soon (in Lab).** OpenAI Codex integration is currently being tested in our lab. The installer will only install with Claude Code for now — Codex support will ship shortly.
+
 Optional (recommended):
 
 - **[GitHub CLI](https://cli.github.com/)** (`gh`) — for automatic PR creation and issue tracking

package/docs/installation.md

@@ -2,15 +2,19 @@
 
 This guide covers the complete installation process in detail. For the quick version, see [Getting Started](getting-started.md).
 
+> ## 🧪 Codex (OpenAI) Support — Coming Soon (in Lab)
+>
+> OpenAI Codex integration is currently being **tested in our lab** and **cannot be installed yet**. The installer will refuse any attempt to install with `--provider codex` and will guide you to use Claude Code instead. Codex-specific sections below describe the **planned behaviour** and will be activated when the feature ships.
+
 ## Installation methods
 
-SpecRails supports three distribution channels:
+SpecRails supports two distribution channels today, with a third coming soon:
 
 | Method | Command | Best for |
 |--------|---------|----------|
 | **Claude Code plugin** (recommended) | `claude plugin install sr` | Most projects — no Node.js required, auto-updates |
-| **Claude Code scaffold** | `npx specrails-core@latest init` | Full offline control, Codex users, custom agent edits |
-| **Codex project** | `npx specrails-core@latest init` | OpenAI Codex CLI users |
+| **Claude Code scaffold** | `npx specrails-core@latest init` | Full offline control, custom agent edits |
+| **Codex project** 🧪 _Coming Soon (in lab)_ | `npx specrails-core@latest init` | OpenAI Codex CLI users (not yet available) |
 
 ---
 

package/docs/plugin-architecture.md

@@ -74,17 +74,19 @@ The scaffold copies the full agent+command set into `.claude/` — you own and v
 
 **Best for:** Teams that want to version the agent prompts themselves, or projects that need full offline control.
 
-### 3. Codex project
+### 3. Codex project 🧪 _Coming Soon (in Lab)_
+
+> **Codex installation is not yet available.** OpenAI Codex integration is being tested in our lab and will ship shortly. The block below describes the **planned behaviour** for when the feature is released.
 
 ```bash
-npx specrails-core@latest init --root-dir .   # same as scaffold
+npx specrails-core@latest init --root-dir .   # same as scaffold (Codex path — not yet available)
 codex                                          # open Codex
 /specrails:enrich                             # configure
 ```
 
-Codex does not support the Claude Code plugin system. Use the scaffold method.
+Codex does not support the Claude Code plugin system. When Codex support ships, use the scaffold method.
 
-**Best for:** OpenAI Codex CLI users.
+**Best for (when available):** OpenAI Codex CLI users.
 
 ## The `/specrails:enrich` wizard
 

package/docs/user-docs/cli-reference.md

@@ -1,6 +1,8 @@
 # CLI Reference
 
-SpecRails commands are implemented as Skills (`SKILL.md` format) and run in both Claude Code and Codex. The command syntax is identical on both platforms.
+> **🧪 Codex (OpenAI) Support — Coming Soon (in Lab).** Codex-specific sections below describe the planned behaviour. Codex installation is currently disabled — only Claude Code is available today.
+
+SpecRails commands are implemented as Skills (`SKILL.md` format) and are designed to run in both Claude Code and Codex. The command syntax is identical on both platforms. Today only the Claude Code runtime is available; Codex support is being tested in our lab and will ship shortly.
 
 **Platform support key used in this reference:**
 

package/docs/user-docs/codex-vs-claude-code.md

@@ -1,6 +1,10 @@
 # Codex vs Claude Code
 
-SpecRails supports both **OpenAI Codex** and **Anthropic Claude Code** as AI agent runtimes. This page explains the differences so you can choose the right setup for your team.
+> # 🧪 Codex Support — Coming Soon (in Lab)
+>
+> OpenAI Codex integration is currently being **tested in our lab** and is not available for installation. The installer only accepts Claude Code at this time. This document describes the planned behaviour and will be activated when the feature ships.
+
+SpecRails supports **Anthropic Claude Code** as an AI agent runtime, with **OpenAI Codex** support coming soon. This page explains the differences so you can choose the right setup for your team when Codex ships.
 
 ---
 

package/docs/user-docs/getting-started-codex.md

@@ -1,8 +1,12 @@
 # Getting Started with SpecRails + Codex
 
-This guide gets you running SpecRails using OpenAI Codex as your AI agent. If you are using Claude Code instead, see the [standard installation guide](installation.md).
+> # 🧪 Coming Soon — Currently in Lab
+>
+> **OpenAI Codex support is being tested in our lab and is not yet available for installation.** The installer will refuse to install Codex and will ask you to use Claude Code. This document describes the planned behaviour and will be activated when the feature ships.
+>
+> **Current status:** Preview / documentation only. For now, use [Claude Code](https://claude.ai/download) — see the [standard installation guide](installation.md).
 
-> **Beta**: Codex support is available in SpecRails 1.x as a beta feature. Core Skills work out of the box. See [Codex vs Claude Code](codex-vs-claude-code.md) for what is and is not supported.
+This guide gets you running SpecRails using OpenAI Codex as your AI agent. If you are using Claude Code instead, see the [standard installation guide](installation.md).
 
 ---
 

package/docs/user-docs/installation.md

@@ -2,7 +2,11 @@
 
 Install SpecRails into any git repository in two steps: install, then run `/specrails:enrich` inside your AI CLI.
 
-SpecRails supports both **Claude Code** and **OpenAI Codex**. The installer detects which CLI you have and configures accordingly. See [Codex vs Claude Code](codex-vs-claude-code.md) for a feature comparison.
+> ## 🧪 Codex (OpenAI) Support — Coming Soon (in Lab)
+>
+> OpenAI Codex integration is currently being **tested in our lab** and **cannot be installed yet**. The installer will refuse any attempt to install with `--provider codex` and will guide you to use Claude Code. Codex-specific sections below describe the **planned behaviour** for when the feature ships.
+
+SpecRails supports **Claude Code** today, with **OpenAI Codex** coming soon. The installer detects which CLI you have and configures accordingly. See [Codex vs Claude Code](codex-vs-claude-code.md) for a feature comparison of the upcoming Codex support.
 
 > **Looking for the comprehensive reference?** See [Installation & Setup](../installation.md) for full wizard phase details and advanced configuration.
 

package/docs/user-docs/quick-start.md

@@ -2,7 +2,7 @@
 
 Get SpecRails running in your project in under 10 minutes.
 
-> **Using OpenAI Codex?** See the [Codex getting started guide](getting-started-codex.md) — setup is slightly different.
+> **🧪 Using OpenAI Codex? — Coming Soon (in Lab).** Codex support is currently being tested in our lab and is not yet available for installation. The installer will refuse Codex installs and guide you to Claude Code. See the [Codex getting started guide](getting-started-codex.md) for a preview of the planned setup.
 
 ## Before you begin
 

package/install.sh

@@ -69,11 +69,18 @@ while [[ $# -gt 0 ]]; do
             ;;
         --provider)
             if [[ -z "${2:-}" ]]; then
-                echo "Error: --provider requires a value (claude or codex)." >&2
+                echo "Error: --provider requires a value (claude)." >&2
                 exit 1
             fi
-            if [[ "$2" != "claude" && "$2" != "codex" ]]; then
-                echo "Error: --provider value must be 'claude' or 'codex', got: $2" >&2
+            if [[ "$2" == "codex" ]]; then
+                echo "" >&2
+                echo "  ⚠  Codex (OpenAI) support: Coming Soon" >&2
+                echo "     Currently being tested in our lab. Please use --provider claude for now." >&2
+                echo "" >&2
+                exit 1
+            fi
+            if [[ "$2" != "claude" ]]; then
+                echo "Error: --provider value must be 'claude', got: $2" >&2
                 exit 1
             fi
             CLI_PROVIDER="$2"
@@ -108,7 +115,7 @@ while [[ $# -gt 0 ]]; do
             ;;
         *)
             echo "Unknown argument: $1" >&2
-            echo "Usage: install.sh [--root-dir <path>] [--yes|-y] [--provider <claude|codex>] [--from-config [<path>]] [--agent-teams] [--quick] [--hub-json]" >&2
+            echo "Usage: install.sh [--root-dir <path>] [--yes|-y] [--provider <claude>] [--from-config [<path>]] [--agent-teams] [--quick] [--hub-json]" >&2
             exit 1
             ;;
     esac
@@ -308,8 +315,12 @@ if [[ "$FROM_CONFIG" == true ]]; then
         if [[ -z "$_cfg_provider" ]]; then
             fail "Invalid config: missing required 'provider' field"
             _config_errors=$(( _config_errors + 1 ))
-        elif [[ "$_cfg_provider" != "claude" && "$_cfg_provider" != "codex" ]]; then
-            fail "Invalid config: unsupported provider '$_cfg_provider' (expected: claude or codex)"
+        elif [[ "$_cfg_provider" == "codex" ]]; then
+            fail "Codex (OpenAI) support is coming soon — currently being tested in our lab."
+            fail "Please edit install-config.yaml and set: provider: claude"
+            _config_errors=$(( _config_errors + 1 ))
+        elif [[ "$_cfg_provider" != "claude" ]]; then
+            fail "Invalid config: unsupported provider '$_cfg_provider' (expected: claude)"
             _config_errors=$(( _config_errors + 1 ))
         fi
         if [[ "$_cfg_has_agents" -eq 0 ]]; then
@@ -368,42 +379,26 @@ if [[ "$FROM_CONFIG" != true ]]; then
         # --provider flag was set explicitly — skip interactive detection
         ok "Provider: $CLI_PROVIDER (--provider flag)"
     elif [ "$HAS_CLAUDE" = true ] && [ "$HAS_CODEX" = true ]; then
-        echo ""
-        echo -e "  ${BOLD}Both Claude Code and Codex detected.${NC}"
-        if [ "$AUTO_YES" = true ]; then
-            CLI_PROVIDER="claude"
-            info "Auto-selected Claude Code (--yes flag active)"
-        else
-            echo ""
-            echo "    Which provider would you like to use?"
-            echo "      1) Claude Code (claude)  → output to .claude/"
-            echo "      2) Codex (codex)         → output to .codex/"
-            echo ""
-            read -p "    Select provider (1 or 2, default: 1): " PROVIDER_CHOICE || PROVIDER_CHOICE="1"
-            PROVIDER_CHOICE="${PROVIDER_CHOICE:-1}"
-            if [[ "$PROVIDER_CHOICE" == "2" ]]; then
-                CLI_PROVIDER="codex"
-            else
-                CLI_PROVIDER="claude"
-            fi
-        fi
+        CLI_PROVIDER="claude"
+        info "Claude Code and Codex both detected — Codex support coming soon (in lab), using Claude Code."
         ok "Provider: $CLI_PROVIDER"
     elif [ "$HAS_CLAUDE" = true ]; then
         CLI_PROVIDER="claude"
         CLAUDE_VERSION=$(claude --version 2>/dev/null || echo "unknown")
         ok "Claude Code CLI: $CLAUDE_VERSION"
     elif [ "$HAS_CODEX" = true ]; then
-        CLI_PROVIDER="codex"
-        CODEX_VERSION=$(codex --version 2>/dev/null || echo "unknown")
-        ok "Codex CLI: $CODEX_VERSION"
+        fail "Only Codex detected — Codex (OpenAI) support is coming soon (currently in our lab)."
+        echo ""
+        echo "    Please install Claude Code to continue: https://claude.ai/download"
+        exit 1
     elif [[ "$SKIP_PREREQS" == "1" ]]; then
         CLI_PROVIDER="claude"
         warn "No AI CLI found (skipped — SPECRAILS_SKIP_PREREQS=1)"
     else
-        fail "No AI CLI found (claude or codex)."
+        fail "No AI CLI found (claude)."
         echo ""
         echo "    Install Claude Code: https://claude.ai/download"
-        echo "    Install Codex:       https://github.com/openai/codex"
+        echo "    Codex (OpenAI) support: coming soon — currently in our lab."
         exit 1
     fi
 fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "specrails-core",
-  "version": "4.0.5",
+  "version": "4.0.7",
   "description": "AI agent workflow system for Claude Code — installs 12 specialized agents, orchestration commands, and persona-driven product discovery into any repository",
   "bin": {
     "specrails-core": "bin/specrails-core.js"

package/templates/commands/specrails/implement.md

@@ -555,6 +555,24 @@ For each entry in `DEVELOPER_ROUTING`, launch the assigned developer agent using
 
 Wait for all developers to complete.
 
+**Summary timing (multi-feature mode):** When running multiple background developer agents, individual `task_notification` completions MUST NOT trigger a final Phase 3b summary. As each agent completes, emit only a brief one-line acknowledgment:
+```
+[phase-3b] Developer for <feature> ✓ (<N> tool uses, <duration>)
+```
+Only after the LAST background agent sends its completion notification, emit the consolidated summary:
+```
+## Phase 3b Complete
+
+| Feature | Agent | Tool uses | Duration |
+|---------|-------|-----------|----------|
+| <feature-a> | sr-developer | 64 | 8m 02s |
+| <feature-b> | sr-developer | 50 | 7m 35s |
+
+All N developers complete. Proceeding to Phase 3c.
+```
+
+This prevents stale "still waiting" text from appearing as the terminal result when the job completes.
+
 **Pipeline state:** update `developer` → `done`. Also update `implemented_files` in the state file with the complete list of files created or modified by the developer agent(s). If developer failed: update `developer` → `failed` with error context `"<agent-id> failed: <exit code or error description>"`.
 
 ## Phase 3c: Write Tests