npm - @chorus-aidlc/chorus - Versions diffs - 0.19.1 → 0.20.0 - Mend

@chorus-aidlc/chorus 0.19.1 → 0.20.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (322) hide show

package/.next/standalone/public/chorus-plugin/skills/docs/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus documentation router — consult the live Chorus docs site t
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/idea/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus Idea workflow — claim ideas, run elaboration rounds, and p
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/openspec-aware/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: OpenSpec-mode authoring for Chorus PM workflows in Claude Code. The
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/orchestrate/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Multi-agent orchestration playbook — coordinate OTHER agents and
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/proposal/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus Proposal workflow — create proposals with document and tas
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/quick-dev/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Quick Task workflow — skip Idea→Proposal, create tasks directly
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/research/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Bounded factual research for Chorus Idea clarification, Proposal de
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/review/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus Review workflow — approve/reject proposals, verify tasks,
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/spec-lite/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Lightweight, Chorus-native local specs for Chorus PM workflows —
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/yolo/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Full-auto AI-DLC pipeline — from prompt to done. Automates the en
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-brainstorm/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Optional divergent-then-convergent dialogue for fuzzy ideas. Invoke
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-cli/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: How to install, configure, and use the `chorus` CLI — install it,
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-develop/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus Development workflow — claim tasks, report work, manage se
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-docs/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus documentation router — consult the live Chorus docs site t
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-idea/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus Idea workflow — claim ideas, run elaboration rounds, and p
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-openspec-aware/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: OpenSpec-mode authoring for Chorus PM workflows in Kiro CLI. The de
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-orchestrate/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Multi-agent orchestration playbook — coordinate OTHER agents and
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-proposal/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus Proposal workflow — create proposals with document and tas
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-quick-dev/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Quick Task workflow — skip Idea→Proposal, create tasks directly
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-research/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Bounded factual research for Chorus Idea clarification, Proposal de
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-review/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Chorus Review workflow — approve/reject proposals, verify tasks,
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-spec-lite/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Lightweight, Chorus-native local specs for Chorus PM workflows in K
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/.kiro/skills/chorus-yolo/SKILL.md CHANGED Viewed

@@ -4,7 +4,7 @@ description: Full-auto AI-DLC pipeline — from prompt to done. Automates the en
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.19.1"
+  version: "0.20.0"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/kiro-plugin/bin/chorus-api.sh CHANGED Viewed

@@ -283,7 +283,7 @@ cmd_mcp_tool() {
     # Step 1: Initialize MCP session
     local init_payload
     init_payload=$(cat <<JSONEOF
-{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"chorus-hook","version":"0.19.1"}}}
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"chorus-hook","version":"0.20.0"}}}
 JSONEOF
 )

package/README.ja.md CHANGED Viewed

@@ -38,6 +38,8 @@ Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Veri
 ## 最近の更新
+**[v0.20.0](https://chorus-ai.dev/blog/chorus-v0.20.0-release/)** — デーモンのバックエンドを Codex App Server、Claude Code の双方向 stream-json、Pi のネイティブ RPC に移行し、プロトコルを通じて中断と実行状態を扱うようになりました。新しい `chorus upgrade` は npm でグローバルインストールした CLI を更新し、`--plugins` を付けると設定済みの Claude Code、Codex、Kiro、Pi 連携も更新できます。
 **[v0.19.1](https://chorus-ai.dev/blog/chorus-v0.19.1-release/)** — 軽量 Research を追加し、Idea の要件整理や Proposal の設計時に重要な事実を確認できるようになりました。インライン引用で根拠となる資料を示せるほか、開発開始前なら Tracker から追加調査を依頼できます。
 **[v0.19.0](https://chorus-ai.dev/blog/chorus-v0.19.0-release/)** — Cloudflare を参考にレビューの範囲を明確化し、問題の根拠を省略せず、固定 ID で再レビュー時も追跡。タスクレビューでは受け入れ基準に加え、コード品質も標準で確認します。
@@ -57,7 +59,7 @@ Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Veri
 2 つのコマンドだけです — データベースも Docker も設定ファイルも不要です。
 ```bash
-npm install -g @chorus-aidlc/chorus@0.19.1
+npm install -g @chorus-aidlc/chorus@0.20.0
 chorus
 ```

package/README.ko.md CHANGED Viewed

@@ -38,6 +38,8 @@ Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Veri
 ## 최근 업데이트
+**[v0.20.0](https://chorus-ai.dev/blog/chorus-v0.20.0-release/)** — 데몬 백엔드를 Codex App Server, Claude Code 양방향 stream-json, Pi 네이티브 RPC로 전환해 프로토콜로 중단과 실행 상태를 처리합니다. 새 `chorus upgrade` 명령은 npm으로 전역 설치한 CLI를 업데이트하며, `--plugins`를 추가하면 설정된 Claude Code, Codex, Kiro, Pi 연동도 갱신합니다.
 **[v0.19.1](https://chorus-ai.dev/blog/chorus-v0.19.1-release/)** — 가벼운 Research로 Idea 구체화와 Proposal 설계 단계에서 핵심 사실을 확인할 수 있습니다. 인라인 근거 인용으로 주장과 출처를 연결하고, 개발 시작 전에는 Tracker에서 추가 조사를 요청할 수 있습니다.
 **[v0.19.0](https://chorus-ai.dev/blog/chorus-v0.19.0-release/)** — Cloudflare를 참고해 리뷰 범위를 명확히 하고, 문제의 근거를 온전히 남기며, 고정 ID로 재검토까지 추적합니다. 태스크 리뷰는 인수 기준 외의 코드 품질도 기본으로 검사합니다.
@@ -57,7 +59,7 @@ Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Veri
 두 개의 명령이면 됩니다. 데이터베이스도, Docker도, 설정 파일도 필요 없습니다.
 ```bash
-npm install -g @chorus-aidlc/chorus@0.19.1
+npm install -g @chorus-aidlc/chorus@0.20.0
 chorus
 ```

package/README.md CHANGED Viewed

@@ -38,6 +38,8 @@ The labels under each stage are the **permissions** an actor needs there — gra
 ## What's New
+**[v0.20.0](https://chorus-ai.dev/blog/chorus-v0.20.0-release/)** — Daemon backends now use Codex App Server, bidirectional Claude Code stream-json, and native Pi RPC for protocol-based interruption and execution tracking. New `chorus upgrade` updates npm-global CLI installations; `--plugins` also refreshes configured Claude Code, Codex, Kiro, and Pi integrations.
 **[v0.19.1](https://chorus-ai.dev/blog/chorus-v0.19.1-release/)** — Lightweight Research checks factual gaps during Idea and Proposal preparation. Inline evidence citations put sources next to claims, and Tracker can request more research before development starts.
 **[v0.19.0](https://chorus-ai.dev/blog/chorus-v0.19.0-release/)** — Cloudflare-inspired reviewer rules: clearer scope, complete blocker evidence, and stable finding IDs across rounds. Task reviews now check code quality beyond acceptance criteria.
@@ -57,7 +59,7 @@ The labels under each stage are the **permissions** an actor needs there — gra
 Two commands. No database, no Docker, no config files.
 ```bash
-npm install -g @chorus-aidlc/chorus@0.19.1
+npm install -g @chorus-aidlc/chorus@0.20.0
 chorus
 ```
@@ -67,6 +69,21 @@ Chorus starts with an embedded PostgreSQL (PGlite), runs migrations, and opens a
 To turn your local machine into an agent runtime that picks up assigned tasks, run `chorus daemon` → **[Daemon operations](https://doc.chorus-ai.dev/guides/daemon-operations/)** · **[Remote control](https://doc.chorus-ai.dev/guides/remote-control/)**.
+### Upgrade the CLI and plugins
+```bash
+chorus upgrade             # CLI only; `chorus update` is an alias
+chorus upgrade --plugins   # Also refresh configured agents' Chorus plugins
+```
+Self-upgrade supports the active **npm global installation** on Linux, macOS and Windows. It checks npm's prefix, resolves the latest stable release, avoids downgrades and verifies the installed version. Source checkouts, links, npx and other package-manager installations must use their own update workflow. CLI discovery, installation or verification failure stops plugin work.
+`--plugins` reads `~/.chorus/daemon.json`, including legacy single-agent records. Explicit Claude Code, Codex, Kiro and Pi types are processed even with wake disabled. Each record's home, config directory and PATH are respected; shared destinations update once. Only Chorus and required integration packages are refreshed, with existing credentials and unrelated settings preserved. Host CLIs must already be installed. Kiro templates come from the record's configured Chorus instance (its served version, which may lag npm); conflicting instance URLs for one destination are reported. Pi probes for targeted updates of Chorus and `pi-mcp-adapter`; older hosts without that capability report incomplete work, including partial installs, without updating unrelated extensions. Pinned versions, ranges and non-latest tags are preserved and reported incomplete; remove those constraints to allow latest updates.
+The command is noninteractive and reports each target. Exit **0** means all requested work completed (missing/empty configuration is a successful no-op); exit **1** means failure or incomplete work, including offline/unknown/untyped records, missing hosts or unsupported targeted updates. Later targets still run after a plugin failure; completed changes are not rolled back. Start new agent sessions and restart the daemon when convenient to activate updates—the command does not restart processes or interrupt sessions.
+npm installation has no automatic deadline or forced kill; it shows sanitized progress until npm exits. Queries remain time-limited. Failures include sanitized causes and exit status; permission failures suggest a user-owned Node installation such as nvm. Existing config backups use one `.chorus-upgrade.bak` per file, replaced on the next upgrade.
 ---
 ## See It in Action

package/README.zh.md CHANGED Viewed

@@ -29,6 +29,8 @@ Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Veri
 ## 最近更新
+**[v0.20.0](https://chorus-ai.dev/zh/blog/chorus-v0.20.0-release/)**：daemon 后端改用 Codex App Server、Claude Code 双向 stream-json 和 Pi 原生 RPC，通过协议处理中断与执行状态。新增 `chorus upgrade`，支持 npm 全局安装的 CLI 自升级；加上 `--plugins` 可刷新已配置的 Claude Code、Codex、Kiro 和 Pi 集成。
 **[v0.19.1](https://chorus-ai.dev/zh/blog/chorus-v0.19.1-release/)**：新增轻量 Research，在 Idea 澄清和 Proposal 设计时查证关键事实；行内证据引用让结论直接关联来源。开发开始前，也可从 Tracker 发起补充调查。
 **[v0.19.0](https://chorus-ai.dev/zh/blog/chorus-v0.19.0-release/)**：借鉴 Cloudflare，明确 reviewer 职责、保留完整证据，用稳定 ID 逐轮追踪问题。任务审查默认检查验收标准之外的代码质量。
@@ -48,7 +50,7 @@ Idea ──> Proposal ──> [Document + Task DAG] ──> Execute ──> Veri
 两条命令即可，无需数据库、无需 Docker、无需配置文件。
 ```bash
-npm install -g @chorus-aidlc/chorus@0.19.1
+npm install -g @chorus-aidlc/chorus@0.20.0
 chorus
 ```
@@ -58,6 +60,21 @@ Chorus 会自动启动内嵌 PostgreSQL (PGlite)、执行数据库迁移，然
 想把本地机器变成领取任务的 agent 运行时，运行 `chorus daemon` → **[Daemon 运维](https://doc.chorus-ai.dev/zh/guides/daemon-operations/)** · **[远程控制](https://doc.chorus-ai.dev/zh/guides/remote-control/)**。
+### 升级 CLI 和插件
+```bash
+chorus upgrade             # 仅升级 CLI；chorus update 为同义命令
+chorus upgrade --plugins   # 同时刷新已配置 Agent 的 Chorus 插件
+```
+自升级支持 Linux、macOS 和 Windows 上当前使用的 **npm 全局安装**：检查 npm prefix、查询最新稳定版本、避免降级，并在安装后验证版本。源码目录、链接、npx 和其他包管理器安装请使用各自的更新方式。CLI 检查、安装或版本验证失败后，不会继续更新插件。
+`--plugins` 读取 `~/.chorus/daemon.json`，兼容旧版单 Agent 配置。明确指定 Claude Code、Codex、Kiro、Pi 类型的记录都会处理，不受唤醒开关影响；按每条记录的 home、配置目录和 PATH 定位宿主，共享目标只更新一次。仅刷新 Chorus 及必需的集成依赖，保留已有凭证和无关设置，不安装宿主 CLI。Kiro 模板来自记录配置的 Chorus 实例（以该实例提供的版本为准，可能落后于 npm），共享目录对应不同实例时报告冲突。Pi 会探测是否支持定向更新 Chorus 和 `pi-mcp-adapter`；旧宿主不支持时报告未完成，部分安装也不会误报全部刷新，更不会更新其他扩展。固定版本、版本范围及非 latest 标签会保留并报告未完成；需移除这些约束后才能更新到最新。
+命令非交互执行并逐项汇总。退出码 **0** 表示请求全部完成（配置不存在或为空也算成功）；**1** 表示失败或未全部完成，包括 offline、未知或缺少类型的记录、宿主缺失及不支持定向更新。单个插件失败不影响后续目标，已完成的变更不回滚。更新后请开启新的 Agent 会话，并在方便时重启 daemon；命令本身不会重启进程或中断现有会话。
+npm 安装过程不设置自动超时或强制终止，会持续显示脱敏进度直到退出；查询仍保留超时。失败会显示脱敏原因和退出状态，权限问题会提示使用 nvm 等用户级 Node 安装。配置备份使用固定的 `.chorus-upgrade.bak` 文件，下次升级时替换，避免堆积。
 ---
 ## 界面预览

package/chorus.mjs CHANGED Viewed

@@ -24,7 +24,7 @@ const __dirname = dirname(fileURLToPath(import.meta.url));
 // client commands that connect OUT to a remote Chorus server. Their modules are
 // lazy-imported so the server-launch path pays no startup cost.
-const SUBCOMMANDS = new Set(["daemon", "login", "mcp", "agents"]);
+const SUBCOMMANDS = new Set(["daemon", "login", "mcp", "agents", "upgrade", "update"]);
 // Client-subcommand arg parsing + help text live in cli/client-args.mjs so they
 // are pure and unit-testable (this entry module runs side effects at import).
@@ -54,6 +54,10 @@ function pkgVersion() {
 }
 async function runSubcommand(name, rest) {
+  if (name === "upgrade" || name === "update") {
+    const { runUpgrade } = await import("./cli/upgrade.mjs");
+    return runUpgrade(rest);
+  }
   // `agents` and `mcp` own their arg parsing + help (they handle `--help`
   // themselves), so they are dispatched before the shared client-flag/help
   // block below. (`chorus init` was renamed to `chorus agents add` — the bare
@@ -171,6 +175,8 @@ Chorus v${pkg.version} — AI Agent & Human collaboration platform
 USAGE
   chorus [options]                 Start the Chorus server (default)
+  chorus upgrade [--plugins]      Upgrade npm-global CLI; optionally refresh configured plugins
+  chorus update [--plugins]       Alias for upgrade (see 'chorus upgrade --help')
   chorus agents [list|add|remove]  Manage this machine's configured agents:
                                    list (default), add (detect + install plugin + seed
                                    creds; formerly 'chorus init'), remove <name|uuid>

package/cli/agent-cli-config.mjs CHANGED Viewed

@@ -10,7 +10,7 @@ const PROTECTED = {
     short: "prcwv",
   },
   codex: {
-    long: "json experimental-json output-schema output-last-message color sandbox ask-for-approval full-auto approve-for-me not-so-yolo yolo dangerously-bypass-approvals-and-sandbox dangerously-bypass-hook-trust cd add-dir skip-git-repo-check ephemeral last all session resume fork profile remote remote-auth-token-env thread-source ignore-user-config ignore-rules",
+    long: "listen code-mode-host code-mode-host-url json experimental-json output-schema output-last-message color sandbox ask-for-approval full-auto approve-for-me not-so-yolo yolo dangerously-bypass-approvals-and-sandbox dangerously-bypass-hook-trust cd add-dir skip-git-repo-check ephemeral last all session resume fork profile remote remote-auth-token-env thread-source ignore-user-config ignore-rules",
     short: "soaCp",
   },
   kiro: {
@@ -180,7 +180,7 @@ export function validateAgentCliConfig(config = {}, type, label = "agent") {
     if (backend === "codex") {
       const c = codexConfigAt(args, i);
       if (c) {
-        if (!c.valid || /^(mcp_servers|sandbox[^.]*|approval_policy|approvals_reviewer|cwd|permissions|developer_instructions|model_instructions_file|experimental_instructions_file|base_instructions)(\.|$)/.test(c.key))
+        if (!c.valid || /^(listen|code_mode_host[^.]*|mcp_servers|sandbox[^.]*|approval_policy|approvals_reviewer|cwd|permissions|developer_instructions|model_instructions_file|experimental_instructions_file|base_instructions)(\.|$)/.test(c.key))
           invalid(label, `args[${i}]`, "has an invalid or managed Codex config key");
       }
     }
@@ -190,6 +190,32 @@ export function validateAgentCliConfig(config = {}, type, label = "agent") {
   return { args: [...args], env: { ...env } };
 }
+// Daemon-only translation. Foreground retains its literal argument planner.
+// App Server accepts global -c overrides, but not exec's model switch.
+export function codexAppServerArgs(args, label = "agent") {
+  const translated = [];
+  for (let i = 0; i < args.length;) {
+    const config = codexConfigAt(args, i);
+    if (config) {
+      translated.push(...args.slice(i, i + config.size));
+      i += config.size;
+      continue;
+    }
+    const option = optionAt("codex", args, i);
+    if (option?.flag === "--model" && !option.missing) {
+      const token = args[i];
+      const value = option.size === 2 ? args[i + 1]
+        : token.startsWith("--model=") ? token.slice(8)
+        : token.slice(2).replace(/^=/, "");
+      translated.push("-c", `model=${JSON.stringify(value)}`);
+      i += option.size;
+      continue;
+    }
+    invalid(label, `args[${i}]`, "is unsupported by Codex App Server; use model or permitted -c/--config settings, or explicit foreground passthrough");
+  }
+  return translated;
+}
 // Windows child environments are case-insensitive, unlike an ordinary JS object
 // (including injected test envs). Match Node's sorted-key selection if an inherited
 // object contains duplicates; overlayAgentEnv removes collisions for overrides.