@agents-ensemble/cli 0.6.4 → 0.7.0

package/docs/settings.md

@@ -28,6 +28,14 @@ CLI > 環境変数 > project config > user config > コード default
 
 `profile.default` / `conductor.model` / `acp.defaultPreset` など。設計判断は [ADR 0020](https://github.com/otolab/agents-ensemble/blob/main/docs/adr/0020-ensemble-config-setting-resolution.md)。
 
+`conductor.backend` は、選択した profile の `conductor.backend` を project/user の deep merge 済み config より優先し、どちらも未指定なら `cursor` を使います。`cursor` は Cursor SDK 経路、`pi` は Pi Agent Core 経路を選びます。Pi は compiled conductor instructions を native system prompt に載せ、`~/.ensemble/pi` と `<repoRoot>/.ensemble/pi` の `settings.json` / `auth.json` / `models.json` / `extensions/` / `skills/` / `prompts/` / `themes/` を解決します。skills は system prompt へ追加し、prompts は `/name args` で展開します。themes は headless conductor のため読み込み・project 同名解決のみ行い、TUI 表示には使いません。root は `conductor.pi.agentDir` / `conductor.pi.projectDir` で上書きできます。`.ensemble/pi/SYSTEM.md` / `APPEND_SYSTEM.md` は無視します。`ensemble auth login` は Cursor SDK 向けで、Pi の認証には使いません。`settings.json` の headless 対応キーはモデル選択、認証 fallback、resource path に限られ、`defaultThinkingLevel` / `thinkingBudgets` / `packages` / `enableSkillCommands` など未対応キーは警告なしで無視します（詳細は [config.md](config.md#settingsjson-の-headless-対応範囲)）。resume では sidecar に保存した backend と起動時の解決結果が一致しない場合、次のエラーで conductor を起動せず失敗します。
+
+```text
+Session sidecar conductorBackend mismatch: pi !== cursor
+```
+
+旧 sidecar にこのフィールドがない場合は、従来どおり `cursor` として扱います。Pi の `conductorAgentId` は Pi の session id としても使われ、transcript は `<conductor-cwd>/.ensemble/pi/sessions/` の JSONL に保存されます。`--continue` / `--resume` ではその transcript を復元し、Issue context から compiled `systemPrompt` を毎回再コンパイルして native system prompt に再注入します。
+
 ### パターン B — Phase 1 横断（env なし）
 
 ```
@@ -53,7 +61,8 @@ config キーなし。CI・スクリプト・端末検出、または 1 回限
 | 種別 | 解決順 |
 |------|--------|
 | GitHub API | `GITHUB_TOKEN` > `GH_TOKEN` > （`allowGhAuthTokenFallback: true` 時のみ）`gh auth token` |
-| conductor | `CURSOR_API_KEY` > `~/.cursor/sdk/auth.json`（`ensemble auth login`） |
+| conductor (cursor) | `CURSOR_API_KEY` > `~/.cursor/sdk/auth.json`（`ensemble auth login`） |
+| conductor (pi) | Pi の `auth.json` / `settings.json`（`~/.ensemble/pi/` → `<repoRoot>/.ensemble/pi/`、`conductor.pi.*` で root 上書き） > provider 環境変数。`ensemble auth` は使わない |
 | worker ACP（preset 依存） | preset ごとに README / ADR 0019 参照 |
 
 ## 一覧 — Phase 1（config.yaml）
@@ -62,6 +71,9 @@ config キーなし。CI・スクリプト・端末検出、または 1 回限
 |------|-------------|----------|-----|----------------|------|
 | 既定 team profile | `profile.default` | `ENSEMBLE_DEFAULT_PROFILE` | `--profile` | 同梱 `implementer-and-reviewer` | A |
 | conductor モデル | `conductor.model` | `CONDUCTOR_MODEL_ID` | `--model` | `default` | A |
+| conductor backend | `conductor.backend` | — | — | `cursor` | profile > config > default |
+| Pi user resource root | `conductor.pi.agentDir` | — | — | `~/.ensemble/pi` | config |
+| Pi project resource root | `conductor.pi.projectDir` | — | — | `<repoRoot>/.ensemble/pi` | config |
 | worker ACP preset（profile 未指定 worker） | `acp.defaultPreset` | `ENSEMBLE_DEFAULT_ACP_CLI` | `--default-acp-cli` 等 | `cursor` | C |
 | Issue worktree | `session.worktree` | — | `--worktree` | `isolated` | B |
 | 自律ターン上限（TTY） | `session.maxTurns.tty` | — | `--max-turns` / `--no-max-turns` | `0`（無制限） | B |
@@ -101,7 +113,8 @@ TUI 設定は `loadEnsembleConfig` 結果を `createIssueSessionTuiHost` へ渡
 | 設定 | 環境変数 | config で制御できること |
 |------|----------|------------------------|
 | GitHub API token | `GITHUB_TOKEN` / `GH_TOKEN` | `github.auth.allowGhAuthTokenFallback` のみ |
-| conductor API key | `CURSOR_API_KEY` | —（`ensemble auth login` は別経路） |
+| conductor API key (cursor) | `CURSOR_API_KEY` | —（`ensemble auth login` は別経路） |
+| conductor API key (pi) | provider ごとの環境変数（Pi の env mapping） | Pi `auth.json` / `settings.json` にも設定可能 |
 
 ## 一覧 — 別ファイル
 
@@ -125,7 +138,7 @@ TUI 設定は `loadEnsembleConfig` 結果を `createIssueSessionTuiHost` へ渡
 | チーム / 個人の恒久既定（モデル、worktree、monitor） | `~/.ensemble/config.yaml` または project `.ensemble/config.yaml` |
 | CI で 1 ジョブだけ上書き | 環境変数（`CONDUCTOR_MODEL_ID` 等） |
 | 1 回限りの実行 | CLI フラグ（初回メッセージは `ensemble issue <ref> [message...]`） |
-| token | 環境変数 or `gh auth login` / `ensemble auth login`（config に書かない） |
+| token | Cursor: 環境変数 or `ensemble auth login`、Pi: Pi の `auth.json` / `settings.json`、GitHub: `gh auth login`（いずれも config に書かない） |
 | tmux 内で Issue リンクを短縮表示 | `~/.ensemble/config.yaml` に `tui.forceHyperlink: on`（または env `FORCE_HYPERLINK=1`） |
 | worker ごとの ACP / cwd | `profile.yaml` |
 | conductor の MCP | `mcp.json` |
@@ -144,7 +157,7 @@ TUI 設定は `loadEnsembleConfig` 結果を `createIssueSessionTuiHost` へ渡
 | `TERM` / `TERM_PROGRAM` / `CI` 等 | TTY / CI の実行環境を検出する値 |
 | `CURSOR_RIPGREP_PATH` | SDK 起動時に利用する内部ツールの明示指定 |
 
-`profile.default`、`conductor.model`、`acp.defaultPreset`、`session.*`、`github.monitor.*`、`tui.*` のように config キーがある設定は、上の env-only 表ではなく本書の設定一覧と [config.md](config.md) に記載しています。env は invocation 単位の上書きとして残る場合があります。
+`profile.default`、`conductor.model`、`conductor.backend`、`acp.defaultPreset`、`session.*`、`github.monitor.*`、`tui.*` のように config キーがある設定は、上の env-only 表ではなく本書の設定一覧と [config.md](config.md) に記載しています。env は invocation 単位の上書きとして残る場合があります。
 
 ## 既知のギャップ
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agents-ensemble/cli",
-  "version": "0.6.4",
+  "version": "0.7.0",
   "type": "module",
   "description": "ensemble CLI — Issue-based agent orchestration",
   "bin": {
@@ -17,7 +17,7 @@
     "react": "19.2.0",
     "react-ink-textarea": "npm:@otolab/react-ink-textarea@0.4.1-otolab.3",
     "string-width": "8.1.0",
-    "@agents-ensemble/core": "0.6.4"
+    "@agents-ensemble/core": "0.7.0"
   },
   "devDependencies": {
     "@types/js-yaml": "4.0.9",