npm - @chorus-aidlc/chorus - Versions diffs - 0.21.0 → 0.21.1 - Mend

@chorus-aidlc/chorus 0.21.0 → 0.21.1

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 (289) hide show

package/.next/standalone/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@chorus-aidlc/chorus",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "description": "The Agent Harness for AI-Human Collaboration — session lifecycle, task state, sub-agent orchestration, observability, and failure recovery",
   "homepage": "https://github.com/Chorus-AIDLC/Chorus",
   "repository": {

package/.next/standalone/public/chorus-plugin/.claude-plugin/plugin.json CHANGED Viewed

@@ -1,7 +1,7 @@
 {
   "name": "chorus",
   "description": "Chorus AI-DLC collaboration platform plugin for Claude Code. Automates session lifecycle, provides MCP tools for PM/Developer/Admin workflows, and enables multi-agent team observability.",
-  "version": "0.21.0",
+  "version": "0.21.1",
   "author": {
     "name": "Chorus-AIDLC"
   },

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

@@ -292,7 +292,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.21.0"}}}
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"chorus-hook","version":"0.21.1"}}}
 JSONEOF
 )

package/.next/standalone/public/chorus-plugin/skills/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.21.0"
+  version: "0.21.1"
   category: project-management
   mcp_server: chorus
 ---

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

@@ -4,7 +4,7 @@ description: Chorus AI Agent collaboration platform — overview, common tools,
 license: AGPL-3.0
 metadata:
   author: chorus
-  version: "0.21.0"
+  version: "0.21.1"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/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.21.0"
+  version: "0.21.1"
   category: project-management
   mcp_server: chorus
 ---

package/.next/standalone/public/chorus-plugin/skills/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.21.0"
+  version: "0.21.1"
   category: project-management
   mcp_server: chorus
 ---

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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"
+  version: "0.21.1"
   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.21.0"}}}
+{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"chorus-hook","version":"0.21.1"}}}
 JSONEOF
 )

package/README.md CHANGED Viewed

@@ -80,7 +80,7 @@ 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.
+`--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. Stable Pi >=0.99.0 <2.0.0 uses native MCP and targets Chorus only; Pi 0.84.4–0.98.x retains the verified `pi-mcp-adapter@5.0.0` pin. Unknown versions do not trigger adapter changes or an MCP-complete claim; unsupported hosts run no package commands. Updates are targeted, never all-extension; missing capability or incompatible constraints report incomplete work. User pins/ranges are preserved (the verified adapter pin is intentional, not an incomplete latest refresh). Existing native-host adapters and `-builtin:mcp` filters produce scope-specific manual-migration warnings, never automatic removal. See [Pi setup](docs/CONNECT_PI.md).
 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.

package/README.zh.md CHANGED Viewed

@@ -71,7 +71,7 @@ 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 标签会保留并报告未完成；需移除这些约束后才能更新到最新。
+`--plugins` 读取 `~/.chorus/daemon.json`，兼容旧版单 Agent 配置。明确指定 Claude Code、Codex、Kiro、Pi 类型的记录都会处理，不受唤醒开关影响；按每条记录的 home、配置目录和 PATH 定位宿主，共享目标只更新一次。仅刷新 Chorus 及必需的集成依赖，保留已有凭证和无关设置，不安装宿主 CLI。Kiro 模板来自记录配置的 Chorus 实例（以该实例提供的版本为准，可能落后于 npm），共享目录对应不同实例时报告冲突。稳定版 Pi >=0.99.0 <2.0.0 使用原生 MCP，仅定向更新 Chorus；Pi 0.84.4–0.98.x 保留已验证的 `pi-mcp-adapter@5.0.0` 策略固定版本。未知版本不操作 adapter、不宣称 MCP 已完成；不支持的宿主不执行包命令。只做定向更新，绝不更新全部扩展；缺少能力或约束不兼容时报告未完成。保留用户 pins/ranges（验证过的 adapter 固定版本是预期策略，不算刷新未完成）。原生宿主已有 adapter 或 `-builtin:mcp` 时仅按作用域提示手动迁移，不自动卸载或改设置。详见 [Pi 接入](docs/CONNECT_PI.md)。
 命令非交互执行并逐项汇总。退出码 **0** 表示请求全部完成（配置不存在或为空也算成功）；**1** 表示失败或未全部完成，包括 offline、未知或缺少类型的记录、宿主缺失及不支持定向更新。单个插件失败不影响后续目标，已完成的变更不回滚。更新后请开启新的 Agent 会话，并在方便时重启 daemon；命令本身不会重启进程或中断现有会话。

package/cli/init/contracts.mjs CHANGED Viewed

@@ -100,6 +100,8 @@ export const FAILURE_ACTIONS = Object.freeze([OUTCOME_ACTIONS.FAILED]);
  * @property {string} [agentId]     Present for per-agent outcomes.
  * @property {("installed"|"repaired"|"skipped"|"seeded"|"failed"|"unsupported")} action
  * @property {string} detail        One-line human explanation for the summary.
+ * @property {boolean} [codexEnvWritten] Codex credentials persisted in this invocation.
+ * @property {boolean} [codexMcpWritten] Codex native MCP configuration write succeeded.
  */
 /**
@@ -114,6 +116,7 @@ export const FAILURE_ACTIONS = Object.freeze([OUTCOME_ACTIONS.FAILED]);
  * @property {(path: string) => (string|null)} backup  Copy a file to <path>.chorus-bak
  *   once before overwrite; returns the backup path or null if the source is absent.
  * @property {NodeJS.ProcessEnv} env
+ * @property {StepOutcome[]} priorOutcomes Completed outcomes from this invocation.
  */
 /** True when an outcome represents a failure (drives the process exit code). */

package/cli/init/install-methods.mjs CHANGED Viewed

@@ -22,6 +22,8 @@ import { OUTCOME_ACTIONS } from "./contracts.mjs";
 import { CHORUS_PLUGIN_ID, CHORUS_MARKETPLACE_NAME, CHORUS_MARKETPLACE_SOURCE } from "./chorus-plugin-consts.mjs";
 import { writeCodexMcpServer } from "./codex-mcp-config.mjs";
 import { resolveCredentials } from "../credentials.mjs";
+import { PI_LEGACY_ADAPTER_SPEC } from "./pi-compatibility.mjs";
+import { PI_CHORUS_SPEC, readPiPackageState, probePiBackend, inspectPiSettings, managePiPackages } from "./pi-mcp-backend.mjs";
 const STEP_ID = "plugin-install";
 const { INSTALLED, REPAIRED, SKIPPED, FAILED, UNSUPPORTED } = OUTCOME_ACTIONS;
@@ -146,6 +148,8 @@ export function installCodex(ctx) {
   // Ensure the native-MCP block is present + normalized to the keyless bearer_token_env_var
   // form. Idempotent; runs on both fresh install and re-run. Never writes a secret. A missing
   // URL is a non-fatal skip (the plugin surface is still installed). Returns a note suffix.
+  let codexMcpWritten = false;
+  const codexOut = (action, detail) => ({ ...out("codex", action, detail), codexMcpWritten });
   const ensureMcp = () => {
     if (ctx.flags?.pluginOnly) return ""; // Upgrade preserves existing connection settings.
     if (!chorusUrl) {
@@ -153,9 +157,10 @@ export function installCodex(ctx) {
     }
     try {
       writeMcp({ configPath, url: chorusUrl });
+      codexMcpWritten = true;
       return ' and wrote [mcp_servers.chorus] (bearer_token_env_var="CHORUS_API_KEY")';
-    } catch (err) {
-      return ` (WARNING: could not write [mcp_servers.chorus]: ${errText({ error: err?.message ?? String(err) })})`;
+    } catch {
+      return " (WARNING: could not write [mcp_servers.chorus]; check config.toml permissions and retry)";
     }
   };
@@ -170,13 +175,12 @@ export function installCodex(ctx) {
       if (!ru.ok) return out("codex", FAILED, `codex plugin marketplace upgrade failed: ${errText(ru)}`);
       const rp = run("codex", ["plugin", "add", CHORUS_PLUGIN_ID, "--json"], { env });
       if (!rp.ok) return out("codex", FAILED, `codex plugin add failed: ${errText(rp)}`);
-      return out(
-        "codex",
+      return codexOut(
         REPAIRED,
         `refreshed ${CHORUS_MARKETPLACE_NAME} and reinstalled ${CHORUS_PLUGIN_ID}${ensureMcp()}`,
       );
     }
-    return out("codex", SKIPPED, `already installed (config.toml)${ensureMcp()}`);
+    return codexOut(SKIPPED, `already installed (config.toml)${ensureMcp()}`);
   }
   ctx.backup?.(configPath); // back up before the CLI edits it
@@ -186,8 +190,7 @@ export function installCodex(ctx) {
   }
   const r2 = run("codex", ["plugin", "add", CHORUS_PLUGIN_ID, "--json"], { env });
   if (!r2.ok) return out("codex", FAILED, `codex plugin add failed: ${errText(r2)}`);
-  return out(
-    "codex",
+  return codexOut(
     state.marketplaceRegistered ? REPAIRED : INSTALLED,
     `installed ${CHORUS_PLUGIN_ID} via codex plugin CLI${ensureMcp()}`,
   );
@@ -469,118 +472,26 @@ export function installOpenclaw(ctx) {
     : out("openclaw", INSTALLED, `installed ${OPENCLAW_NPM_SPEC} and enabled ${OPENCLAW_PLUGIN_ID}`);
 }
-// ---------------------------------------------------------------------------
-// Pi — VERIFIED against docs/CONNECT_PI.md + packages/chorus-pi/README.md
-// (chorus-pi ships to npm as @chorus-aidlc/chorus-pi):
-//   `pi install npm:pi-mcp-adapter`            (the MCP adapter — exposes chorus_* tools)
-//   `pi install npm:@chorus-aidlc/chorus-pi`   (the Chorus skills/agents/extension)
-// pi installs extensions straight from an npm source (the `npm:` prefix on the
-// spec, like OpenClaw). There is NO marketplace step and NO separate enable
-// step (unlike claude / codex / openclaw). pi has no permission system and loads
-// TypeScript via jiti, so the package publishes source as-is — nothing to build.
-//
-// TWO packages: pi reaches the Chorus MCP tools ONLY through `pi-mcp-adapter` (which reads
-// the mcp.json `chorus agents add` writes — see credential-seed's pi branch + pi-mcp-config.mjs);
-// chorus.ts does NOT register tools itself. So we install the adapter FIRST (the tool surface),
-// then chorus-pi (the skills / reviewer agents / session extension). Both are idempotent.
-//
-// Graceful degradation: if the `pi` binary is absent we surface the exact manual
-// commands as UNSUPPORTED guidance (never a hard FAILED — UNSUPPORTED is not a
-// FAILURE_ACTION, so `chorus init` does not abort) and run ZERO commands. This
-// follows the "no guessed command / no crash" rule the other adapters share.
-//
-// VERIFIED-gap: `@chorus-aidlc/chorus-pi` is published at the next coordinated
-// release (A2), so the npm-install path could not be exercised end-to-end on this
-// build host. The command shapes + graceful fallback are implemented; the spec's
-// `pi install npm:<pkg>` form is the documented, reviewed command (pi-mcp-adapter is
-// published — verified 2.32.1).
-// ---------------------------------------------------------------------------
-const PI_ADAPTER_SPEC = "npm:pi-mcp-adapter";
-const PI_NPM_SPEC = "npm:@chorus-aidlc/chorus-pi";
-/**
- * Read pi's install state. `pi install` records each package's source in the
- * agent settings file (`<PI_CODING_AGENT_DIR|~/.pi/agent>/settings.json`) under a
- * `packages[]` array — entries are either a string source (`npm:@scope/pkg`) or an
- * object carrying that source plus filtering. We substring-match the stringified
- * entry so detection is robust to either shape. This is the file-read probe the pi
- * adapter previously lacked (its descriptor had no `readState`, so the runtime
- * defaulted `pluginInstalled:false` and every re-run reported a fresh INSTALL
- * instead of the SKIPPED/upgrade messaging the other adapters give).
- */
-export function readPiInstallState({ env = process.env, readJson = readJsonSafe } = {}) {
-  const home = env.HOME || homedir();
-  const agentDir = nonEmpty(env.PI_CODING_AGENT_DIR) || join(home, ".pi", "agent");
-  const settings = readJson(join(agentDir, "settings.json"));
-  const pkgs = Array.isArray(settings?.packages) ? settings.packages : [];
-  const hasPkg = (needle) =>
-    pkgs.some((p) => (typeof p === "string" ? p : JSON.stringify(p)).includes(needle));
-  const adapterInstalled = hasPkg("pi-mcp-adapter");
-  const pluginInstalled = hasPkg("@chorus-aidlc/chorus-pi");
-  return {
-    marketplaceRegistered: false, // pi has no marketplace concept
-    pluginInstalled: pluginInstalled && adapterInstalled,
-    chorusPiInstalled: pluginInstalled,
-    adapterInstalled,
-  };
+export function readPiInstallState(options = {}) {
+  return readPiPackageState(options);
 }
 export function installPi(ctx) {
   const run = ctx.run ?? runCommand;
   const env = ctx.env ?? process.env;
-  // `pi` must be on PATH to run the install. Probe via PATH (NOT `run`) so an
-  // absent pi surfaces the manual commands and executes NOTHING — and, because
-  // UNSUPPORTED is not a FAILURE_ACTION, never aborts `chorus init`. Injectable
-  // for unit tests (mirrors installDsh's pnpm precheck).
-  const hasBinary = ctx.binaryOnPath ?? binaryOnPath;
-  if (!hasBinary(["pi"], { env })) {
-    return out(
-      "pi",
-      UNSUPPORTED,
-      `pi CLI not found on PATH — install the Chorus extension manually once pi is available: ` +
-        `\`pi install ${PI_ADAPTER_SPEC} && pi install ${PI_NPM_SPEC}\``,
-    );
+  if (!(ctx.binaryOnPath ?? binaryOnPath)(["pi"], { env })) {
+    return out("pi", UNSUPPORTED, "pi CLI not found on PATH — once available, check pi --version. " +
+      `On supported native Pi install only: pi install ${PI_CHORUS_SPEC} --no-approve. ` +
+      `On supported legacy Pi first install: pi install ${PI_LEGACY_ADAPTER_SPEC} --no-approve. ` +
+      "Unknown/unsupported versions require manual compatibility confirmation; MCP setup is incomplete.");
   }
-  const state = safeState(ctx);
-  const bothInstalled = state.chorusPiInstalled && state.adapterInstalled;
-  // Already fully installed → recognize it (parity with codex/kiro's "already
-  // installed") and do NOTHING, unless the caller explicitly asked to update.
-  if (bothInstalled && !ctx.flags?.updateInstalled) {
-    return out(
-      "pi",
-      SKIPPED,
-      `already installed (${PI_ADAPTER_SPEC} + ${PI_NPM_SPEC} in pi settings) — re-run with --update-installed to upgrade`,
-    );
-  }
-  // Update requested on an existing install → use pi's OWN updater. `pi install`
-  // of an already-recorded package only re-writes the settings entry; it does NOT
-  // pull the newer published version, so it never clears pi's "Package updates
-  // available — Run pi update --extensions" nag. `pi update --extensions` (exactly
-  // what that nag tells the user to run) refreshes installed extensions — including
-  // chorus-pi + pi-mcp-adapter — to their latest published versions.
-  if (bothInstalled) {
-    const u = run("pi", ["update", "--extensions"], { env });
-    if (!u.ok) return out("pi", FAILED, `pi update --extensions failed: ${errText(u)}`);
-    return out("pi", REPAIRED, `updated installed pi extensions to latest via \`pi update --extensions\` (incl. ${PI_NPM_SPEC})`);
-  }
-  // Fresh or partial install → install what's needed (pi install is idempotent for
-  // any already-present one). The MCP adapter is the tool surface, so install it
-  // FIRST; then the chorus-pi package.
-  const ra = run("pi", ["install", PI_ADAPTER_SPEC], { env });
-  if (!ra.ok) return out("pi", FAILED, `pi install ${PI_ADAPTER_SPEC} failed: ${errText(ra)}`);
-  const r = run("pi", ["install", PI_NPM_SPEC], { env });
-  if (!r.ok) return out("pi", FAILED, `pi install failed: ${errText(r)}`);
-  // A partial pre-existing install we just completed → REPAIRED; a clean first
-  // install → INSTALLED (same distinction the other adapters draw).
-  return state.chorusPiInstalled || state.adapterInstalled
-    ? out("pi", REPAIRED, `reinstalled ${PI_ADAPTER_SPEC} + ${PI_NPM_SPEC} via pi install`)
-    : out("pi", INSTALLED, `installed ${PI_ADAPTER_SPEC} + ${PI_NPM_SPEC} via pi install`);
+  const backend = probePiBackend({ run, env, cwd: ctx.cwd });
+  const scopes = inspectPiSettings({ env, cwd: ctx.cwd, readJson: ctx.readJson });
+  const result = managePiPackages({ backend, scopes, run, env, cwd: ctx.cwd, update: !!ctx.flags?.updateInstalled });
+  const existing = scopes[0].chorus.length || scopes[0].adapters.length;
+  const action = result.failed ? FAILED : !result.complete ? UNSUPPORTED
+    : !result.changed ? SKIPPED : existing ? REPAIRED : INSTALLED;
+  return { ...out("pi", action, result.detail), complete: result.complete, backend, warnings: result.warnings };
 }
 // ---------------------------------------------------------------------------

package/cli/init/pi-compatibility.mjs ADDED Viewed

@@ -0,0 +1,5 @@
+export const PI_SUPPORTED_RANGE = ">=0.84.4 <2.0.0";
+export const PI_MIN_SUPPORTED_VERSION = [0, 84, 4];
+export const PI_MAX_SUPPORTED_MAJOR = 2;
+export const PI_NATIVE_MCP_MIN_VERSION = [0, 99, 0];
+export const PI_LEGACY_ADAPTER_SPEC = "npm:pi-mcp-adapter@5.0.0";