agestra 4.12.4 → 4.13.0

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "agestra",
       "source": "./",
       "description": "Orchestrate Ollama, Gemini, and Codex for multi-AI debates, code review, and cross-validation",
-      "version": "4.12.4",
+      "version": "4.13.0",
       "author": {
         "name": "mua-vtuber"
       },

package/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agestra",
-  "version": "4.12.4",
+  "version": "4.13.0",
   "description": "Claude Code plugin — orchestrate Ollama, Gemini, and Codex for multi-AI debates, code review, and cross-validation",
   "mcpServers": {
     "agestra": {

package/.gemini/commands/agestra/idea.toml

@@ -9,7 +9,7 @@ Use the shared workflow spec below as the source of truth and adapt it to the cu
 @{commands/idea.md}
 
 Gemini-specific rules:
-- Start with `environment_check` and `provider_list`.
+- Start with `setup_status`, then `environment_check` and `provider_list`.
 - Prefer Agestra MCP tools, workspace documents, and provider comparisons over one-shot brainstorming.
 - Translate Claude-specific wording into leader-host wording when Gemini is the active host.
 - Keep the final answer in the user's language.

package/.gemini/commands/agestra/qa.toml

@@ -0,0 +1,16 @@
+description = "Run the Agestra QA workflow for document-based verification and optional E2E."
+prompt = """
+You are executing the Agestra QA workflow inside Gemini CLI.
+
+User target:
+{{args}}
+
+Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
+@{commands/qa.md}
+
+Gemini-specific rules:
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- Prefer Agestra MCP tools and prompt assets over ad-hoc QA prompting.
+- If the workflow refers to Claude-specific wording, translate it to the current leader-host path rather than asking the user to switch hosts.
+- Keep the final answer in the user's language.
+"""

package/.gemini/commands/agestra/review.toml

@@ -9,7 +9,7 @@ Use the shared workflow spec below as the source of truth and adapt it to the cu
 @{commands/review.md}
 
 Gemini-specific rules:
-- Start with `environment_check` and `provider_list`.
+- Start with `setup_status`, then `environment_check` and `provider_list`.
 - Prefer Agestra MCP tools and prompt assets over ad-hoc review prompting.
 - If the workflow refers to Claude-specific wording, translate it to the current leader-host path rather than asking the user to switch hosts.
 - Keep the final answer in the user's language.

package/.gemini/commands/agestra/security.toml

@@ -0,0 +1,17 @@
+description = "Run the Agestra dedicated security audit workflow."
+prompt = """
+You are executing the Agestra security workflow inside Gemini CLI.
+
+User target:
+{{args}}
+
+Use the shared workflow spec below as the source of truth and adapt it to the current Gemini host session:
+@{commands/security.md}
+
+Gemini-specific rules:
+- Start with `setup_status`, then `environment_check` and `provider_list`.
+- Prefer Agestra MCP tools and prompt assets over ad-hoc security prompting.
+- If the workflow refers to Claude-specific wording, translate it to the current leader-host path rather than asking the user to switch hosts.
+- Do not run destructive exploit tests or ask the user to paste real secrets.
+- Keep the final answer in the user's language.
+"""

package/AGENTS.md

@@ -5,19 +5,27 @@ This repository includes a Codex-friendly host wrapper for Agestra.
 ## First Run
 
 1. Build the bundled MCP server if needed: `npm run bundle`
-2. Register Agestra with Codex once per machine: `npm run install:codex`
+2. Register Agestra with Codex and install generated custom agents: `npm run install:codex:assets`
 3. Open this repository in Codex. This `AGENTS.md` file is loaded automatically.
 
+Use `npm run install:codex` only when you intentionally want MCP registration without generated `.codex/agents/*.toml` assets.
+Low-level MCP calls do not silently write setup. High-level Agestra workflows must call `setup_status` first; if it reports `Setup required: yes`, run the interactive setup questions immediately, call `setup_apply` after the user chooses providers/locale, then resume the original workflow.
+Use `host_assets_status` to inspect generated host assets, and only call `host_assets_install` after the user agrees to install or refresh Codex custom agents.
+
 ## How to Work Here
 
 - Treat `commands/*.md` as the source of truth for Agestra workflows.
-- When the user asks for review, design, idea, or implementation help, start with `environment_check` and `provider_list`.
+- When the user asks for review, QA, security, design, idea, or implementation help, start with `setup_status`, `environment_check`, and `provider_list`. If `setup_status` reports `Setup required: yes`, complete interactive setup first and then resume the original workflow.
 - Prefer Agestra MCP tools over ad-hoc multi-provider prompting.
 - If any legacy workflow text mentions "Claude only", interpret that as the current leader-host-only path when Claude is not the active host.
 
 ## Workflow Mapping
 
 - Review requests: follow `commands/review.md`
+- QA / verification requests: follow `commands/qa.md`
+- Security audit requests: follow `commands/security.md`
+- Review, QA, and security workflows write durable reports under `docs/reports/review/`, `docs/reports/qa/`, and `docs/reports/security/` unless the user asks for chat-only output.
+- Persistent E2E test creation/maintenance is internal: QA produces `E2E_TEST_WORK_REQUEST`, the leader asks the user, and approved work goes to `agestra-e2e-writer`.
 - Design and architecture requests: follow `commands/design.md`
 - Idea discovery requests: follow `commands/idea.md`
 - Implementation requests: follow `commands/implement.md`
@@ -27,10 +35,11 @@ This repository includes a Codex-friendly host wrapper for Agestra.
 - `environment_check` and `provider_list`: inspect host/provider state first
 - `agent_debate_structured` (with `agent_debate_approve`/`_continue`/`_reject`) and `agent_debate_review`: run approval-gated multi-provider review flows
 - `cli_worker_spawn`, `agent_changes_review`, `agent_changes_accept`, `agent_changes_reject`: use for autonomous Codex/Gemini worker tasks
+- `host_assets_status`, `host_assets_install`, `host_assets_uninstall`: inspect and explicitly manage generated host-native assets such as Codex custom agents
 - `qa_run`: run workspace build/test verification before reporting implementation completion
 
 ## Project Assets
 
-- `agents/`: canonical role prompts (`agestra-team-lead`, `agestra-reviewer`, etc.)
+- `agents/`: canonical role prompts (`agestra-team-lead`, `agestra-e2e-writer`, `agestra-reviewer`, etc.)
 - `skills/`: reusable workflow references
 - `GEMINI.md` and `.gemini/commands/`: Gemini-specific host assets; keep behavior aligned with them when updating shared workflows

package/GEMINI.md

@@ -13,6 +13,8 @@ This repository includes Gemini-native wrapper assets for Agestra.
 After setup, Gemini project commands are available:
 
 - `/agestra:review`
+- `/agestra:qa`
+- `/agestra:security`
 - `/agestra:design`
 - `/agestra:idea`
 - `/agestra:implement`
@@ -21,7 +23,7 @@ Each command delegates to the shared workflow specs in `commands/*.md`.
 
 ## Usage Rules
 
-- Start orchestration requests with `environment_check` and `provider_list`.
+- Start orchestration requests with `setup_status`, then `environment_check` and `provider_list`.
 - Prefer Agestra MCP tools instead of rebuilding workflows in free-form prompts.
 - Treat `commands/*.md` and `agents/*.md` as the canonical workflow and role assets.
 - If any legacy shared workflow text mentions "Claude only", translate that to the current leader-host-only path when Gemini is the active host.
@@ -32,3 +34,6 @@ Each command delegates to the shared workflow specs in `commands/*.md`.
 - `cli_worker_spawn`, `agent_changes_review`, `agent_changes_accept`, `agent_changes_reject`: autonomous worker lifecycle
 - `workspace_*`: document-backed review and aggregation flows
 - `qa_run`: workspace build/test verification before implementation completion
+
+Review, QA, and security workflows write durable reports under `docs/reports/review/`, `docs/reports/qa/`, and `docs/reports/security/` unless the user asks for chat-only output.
+Persistent E2E test creation/maintenance is internal: QA produces `E2E_TEST_WORK_REQUEST`, the leader asks the user, and approved work goes to `agestra-e2e-writer`. There is no standalone Gemini `/agestra:e2e` command yet.

package/README.ja.md

@@ -7,7 +7,7 @@
 
 [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
 
-Agestra は Ollama（ローカル）、Gemini CLI、Codex CLI を Claude Code にプラガブルなプロバイダーとして接続し、独立集約、合意形成ディベート、自律 CLI ワーカー、並列タスク配分、クロスバリデーション、品質ベースのプロバイダー選択を 25 個の MCP ツールで提供します。
+Agestra は Ollama（ローカル）、Gemini CLI、Codex CLI を Claude Code にプラガブルなプロバイダーとして接続し、独立集約、合意形成ディベート、自律 CLI ワーカー、並列タスク配分、クロスバリデーション、品質ベースのプロバイダー選択を 44 個の MCP ツールで提供します。
 
 ## クイックスタート
 
@@ -34,7 +34,7 @@ npm install -g agestra
 agestra-install codex --assets
 ```
 
-Codex ではリポジトリ直下の [AGENTS.md](AGENTS.md) と、登録済みの `agestra` MCP サーバーを一緒に使います。`--assets` は `.codex/agents/` に生成済み Codex custom agent もインストールし、Agestra host-asset manifest に記録します。MCP 登録だけでよい場合は `npm run install:codex` または `agestra-install codex` を使ってください。
+Codex ではリポジトリ直下の [AGENTS.md](AGENTS.md) と、登録済みの `agestra` MCP サーバーを一緒に使います。生成済み Codex custom agent には `--assets` が必要で、`.codex/agents/` にインストールして Agestra host-asset manifest に記録します。custom agent なしで MCP 登録だけでよい場合は `npm run install:codex` または `agestra-install codex` を使ってください。
 
 ### Gemini CLI
 
@@ -141,7 +141,7 @@ Turborepo モノレポで、8 パッケージ構成です:
 | `@agestra/provider-codex` | OpenAI Codex CLI アダプター |
 | `@agestra/agents` | 合意検出付きディベートエンジン、ターン品質評価、タスク配分、クロスバリデーション、タスクチェーン、自動 QA、ファイル変更追跡、セッション管理 |
 | `@agestra/workspace` | レビュー、分析メモ、統合レポート向けのワークスペース文書マネージャー |
-| `@agestra/mcp-server` | MCP プロトコル層、25 ツール、環境依存のツールフィルタリング、ディスパッチ |
+| `@agestra/mcp-server` | MCP プロトコル層、44 ツール、環境依存のツールフィルタリング、ディスパッチ |
 
 ### 設計原則
 
@@ -163,7 +163,7 @@ Turborepo モノレポで、8 パッケージ構成です:
 
 ---
 
-## ツール (25)
+## ツール (44)
 
 ### AI チャット (3)
 
@@ -173,7 +173,7 @@ Turborepo モノレポで、8 パッケージ構成です:
 | `ai_analyze_files` | ディスク上のファイルを読み込み、質問と一緒にプロバイダーへ送信 |
 | `ai_compare` | 同じプロンプトを複数プロバイダーに送り、応答を比較 |
 
-### エージェントオーケストレーション (0)
+### エージェントオーケストレーション (14)
 
 | ツール | 説明 |
 |--------|------|
@@ -226,6 +226,21 @@ Turborepo モノレポで、8 パッケージ構成です:
 | `provider_list` | 状態と機能付きでプロバイダー一覧を表示 |
 | `provider_health` | 1 つまたはすべてのプロバイダーのヘルスチェック |
 
+### セットアップ (2)
+
+| ツール | 説明 |
+|--------|------|
+| `setup_status` | 利用可能なプロバイダーと現在の設定状態を確認 |
+| `setup_apply` | 選択したプロバイダー、ロケール、選択ポリシーを `providers.config.json` に書き込む |
+
+### ホストアセット (3)
+
+| ツール | 説明 |
+|--------|------|
+| `host_assets_status` | Codex custom agents などの生成済みホストネイティブアセットを確認 |
+| `host_assets_install` | 管理対象のホストネイティブアセットを明示的にインストールまたは更新 |
+| `host_assets_uninstall` | Agestra が追跡する管理対象ホストネイティブアセットを削除 |
+
 ### Ollama (2)
 
 | ツール | 説明 |
@@ -353,7 +368,7 @@ agestra/
 │   ├── provider-codex/      # Codex CLI アダプター
 │   ├── agents/              # ディベートエンジン、ディスパッチ、クロスバリデーション
 │   ├── workspace/           # ワークスペース文書マネージャー
-│   └── mcp-server/          # MCP サーバー、25 ツール、環境依存フィルタリング、ディスパッチ
+│   └── mcp-server/          # MCP サーバー、44 ツール、環境依存フィルタリング、ディスパッチ
 ├── package.json             # ワークスペースルート
 └── turbo.json               # Turborepo パイプライン
 ```

package/README.ko.md

@@ -7,7 +7,7 @@
 
 [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
 
-Agestra는 Claude 호스트, Ollama(로컬), Gemini CLI, Codex CLI를 플러그형 공급자로 연결합니다. 독립 취합, 합의 토론, 자율 CLI 워커, 병렬 작업 분배, 교차 검증, 품질 기반 공급자 라우팅을 25개 MCP 도구로 제공합니다.
+Agestra는 Claude 호스트, Ollama(로컬), Gemini CLI, Codex CLI를 플러그형 공급자로 연결합니다. 독립 취합, 합의 토론, 자율 CLI 워커, 병렬 작업 분배, 교차 검증, 품질 기반 공급자 라우팅을 44개 MCP 도구로 제공합니다.
 
 ## 빠른 시작
 
@@ -42,7 +42,7 @@ agestra-install codex --assets
 npm run install:codex:global
 ```
 
-Codex는 저장소 루트의 [AGENTS.md](AGENTS.md)와 등록된 `agestra` MCP 서버를 함께 사용합니다. `--assets` 경로는 `.codex/agents/` 아래에 생성형 Codex custom agent도 설치하고 Agestra host-asset manifest에 기록합니다. MCP만 등록하려면 `npm run install:codex` 또는 `agestra-install codex`를 사용하세요.
+Codex는 저장소 루트의 [AGENTS.md](AGENTS.md)와 등록된 `agestra` MCP 서버를 함께 사용합니다. 생성형 Codex custom agent에는 `--assets` 경로가 필요하며, 이 경로가 `.codex/agents/` 아래에 agent를 설치하고 Agestra host-asset manifest에 기록합니다. custom agent 없이 MCP만 등록하려면 `npm run install:codex` 또는 `agestra-install codex`를 사용하세요.
 
 ### Gemini CLI
 
@@ -168,7 +168,7 @@ Turborepo 모노레포, 8개 패키지:
 | `@agestra/provider-codex` | OpenAI Codex CLI 어댑터 |
 | `@agestra/agents` | 합의 검출 토론 엔진, 턴 품질 평가기, 작업 분배기, 교차 검증기, 작업 체인, 자동 QA, 파일 변경 추적기, 세션 관리자 |
 | `@agestra/workspace` | 리뷰, 분석 메모, 통합 보고서를 위한 워크스페이스 문서 관리자 |
-| `@agestra/mcp-server` | MCP 프로토콜 레이어, 25개 도구, 환경별 도구 필터링, 디스패치 |
+| `@agestra/mcp-server` | MCP 프로토콜 레이어, 44개 도구, 환경별 도구 필터링, 디스패치 |
 
 ### 설계 원칙
 
@@ -190,7 +190,7 @@ Turborepo 모노레포, 8개 패키지:
 
 ---
 
-## 도구 (25개)
+## 도구 (44개)
 
 ### AI 채팅 (3개)
 
@@ -200,7 +200,7 @@ Turborepo 모노레포, 8개 패키지:
 | `ai_analyze_files` | 파일을 디스크에서 읽어 공급자에게 질문과 함께 전송 |
 | `ai_compare` | 같은 프롬프트를 여러 공급자에 보내 응답 비교 |
 
-### 에이전트 오케스트레이션 (0개)
+### 에이전트 오케스트레이션 (14개)
 
 | 도구 | 설명 |
 |------|------|
@@ -253,6 +253,21 @@ Turborepo 모노레포, 8개 패키지:
 | `provider_list` | 공급자 목록 (상태, 능력 포함) |
 | `provider_health` | 공급자 상태 체크 |
 
+### 설정 (2개)
+
+| 도구 | 설명 |
+|------|------|
+| `setup_status` | 사용 가능한 공급자와 현재 설정/구성 상태 확인 |
+| `setup_apply` | 선택한 공급자, 언어, 선택 정책을 `providers.config.json`에 기록 |
+
+### 호스트 자산 (3개)
+
+| 도구 | 설명 |
+|------|------|
+| `host_assets_status` | Codex custom agents 같은 생성된 호스트 네이티브 자산 상태 확인 |
+| `host_assets_install` | 관리되는 호스트 네이티브 자산을 명시적으로 설치 또는 갱신 |
+| `host_assets_uninstall` | Agestra가 추적하는 관리형 호스트 네이티브 자산 제거 |
+
 ### Ollama (2개)
 
 | 도구 | 설명 |
@@ -381,7 +396,7 @@ agestra/
 │   ├── provider-codex/      # Codex CLI 어댑터
 │   ├── agents/              # 토론 엔진, 분배기, 교차 검증기
 │   ├── workspace/           # 워크스페이스 문서 관리자
-│   └── mcp-server/          # MCP 서버, 25개 도구, 환경별 필터링, 디스패치
+│   └── mcp-server/          # MCP 서버, 44개 도구, 환경별 필터링, 디스패치
 ├── package.json             # 워크스페이스 루트
 └── turbo.json               # Turborepo 파이프라인
 ```

package/README.md

@@ -7,7 +7,7 @@
 
 [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
 
-Agestra connects the Claude host, Ollama (local), Gemini CLI, and Codex CLI as pluggable providers, enabling multi-agent orchestration with independent aggregation, consensus debates, autonomous CLI workers, parallel task dispatch, cross-validation, and quality-based provider routing — all through 25 MCP tools.
+Agestra connects the Claude host, Ollama (local), Gemini CLI, and Codex CLI as pluggable providers, enabling multi-agent orchestration with independent aggregation, consensus debates, autonomous CLI workers, parallel task dispatch, cross-validation, and quality-based provider routing — all through 44 MCP tools.
 
 ## Quick Start
 
@@ -42,7 +42,7 @@ If you want MCP-only registration of the global package while working from a rep
 npm run install:codex:global
 ```
 
-Codex uses the repository-level [AGENTS.md](AGENTS.md) instructions plus the registered `agestra` MCP server. The `--assets` path also installs generated Codex custom agents under `.codex/agents/` and tracks them in the Agestra host-asset manifest. For MCP-only registration, use `npm run install:codex` or `agestra-install codex`.
+Codex uses the repository-level [AGENTS.md](AGENTS.md) instructions plus the registered `agestra` MCP server. The `--assets` path is required for generated Codex custom agents; it installs them under `.codex/agents/` and tracks them in the Agestra host-asset manifest. For MCP-only registration without custom agents, use `npm run install:codex` or `agestra-install codex`.
 
 ### Gemini CLI
 
@@ -169,7 +169,7 @@ Turborepo monorepo with 8 packages:
 | `@agestra/provider-codex` | OpenAI Codex CLI adapter |
 | `@agestra/agents` | Debate engine with consensus detection, turn quality evaluator, task dispatcher, cross-validator, task chain, auto-QA, file change tracker, session manager |
 | `@agestra/workspace` | Workspace document manager for reviews, analysis notes, and aggregated reports |
-| `@agestra/mcp-server` | MCP protocol layer, 25 tools, environment-aware tool filtering, dispatch |
+| `@agestra/mcp-server` | MCP protocol layer, 44 tools, environment-aware tool filtering, dispatch |
 
 ### Design Principles
 
@@ -191,7 +191,7 @@ Turborepo monorepo with 8 packages:
 
 ---
 
-## Tools (25)
+## Tools (44)
 
 ### AI Chat (3)
 
@@ -201,7 +201,7 @@ Turborepo monorepo with 8 packages:
 | `ai_analyze_files` | Read files from disk and send contents with a question to a provider |
 | `ai_compare` | Send the same prompt to multiple providers, compare responses |
 
-### Agent Orchestration (0)
+### Agent Orchestration (14)
 
 | Tool | Description |
 |------|-------------|
@@ -254,6 +254,21 @@ Turborepo monorepo with 8 packages:
 | `provider_list` | List providers with status and capabilities |
 | `provider_health` | Health check one or all providers |
 
+### Setup (2)
+
+| Tool | Description |
+|------|-------------|
+| `setup_status` | Detect available providers and show the current setup/config state |
+| `setup_apply` | Write selected providers, locale, and selection policy to `providers.config.json` |
+
+### Host Assets (3)
+
+| Tool | Description |
+|------|-------------|
+| `host_assets_status` | Check generated host-native assets such as Codex custom agents |
+| `host_assets_install` | Explicitly install or refresh managed host-native assets |
+| `host_assets_uninstall` | Remove managed host-native assets tracked by Agestra |
+
 ### Ollama (2)
 
 | Tool | Description |
@@ -383,7 +398,7 @@ agestra/
 │   ├── provider-codex/      # Codex CLI adapter
 │   ├── agents/              # Debate engine, dispatcher, cross-validator
 │   ├── workspace/           # Workspace document manager
-│   └── mcp-server/          # MCP server, 25 tools, environment-aware filtering, dispatch
+│   └── mcp-server/          # MCP server, 44 tools, environment-aware filtering, dispatch
 ├── package.json             # Workspace root
 └── turbo.json               # Turborepo pipeline
 ```

package/README.zh.md

@@ -7,7 +7,7 @@
 
 [English](README.md) | [한국어](README.ko.md) | [日本語](README.ja.md) | [中文](README.zh.md)
 
-Agestra 将 Ollama（本地）、Gemini CLI 和 Codex CLI 作为可插拔提供方接入 Claude Code，通过 25 个 MCP 工具提供多 AI 编排、独立汇总、共识辩论、自主 CLI Worker、并行任务分发、交叉验证和基于质量的提供方路由。
+Agestra 将 Ollama（本地）、Gemini CLI 和 Codex CLI 作为可插拔提供方接入 Claude Code，通过 44 个 MCP 工具提供多 AI 编排、独立汇总、共识辩论、自主 CLI Worker、并行任务分发、交叉验证和基于质量的提供方路由。
 
 ## 快速开始
 
@@ -34,7 +34,7 @@ npm install -g agestra
 agestra-install codex --assets
 ```
 
-Codex 会结合仓库根目录下的 [AGENTS.md](AGENTS.md) 与已注册的 `agestra` MCP 服务一起工作。`--assets` 还会在 `.codex/agents/` 下安装生成的 Codex custom agent，并写入 Agestra host-asset manifest。只注册 MCP 时，请使用 `npm run install:codex` 或 `agestra-install codex`。
+Codex 会结合仓库根目录下的 [AGENTS.md](AGENTS.md) 与已注册的 `agestra` MCP 服务一起工作。生成 Codex custom agent 需要使用 `--assets` 路径，它会在 `.codex/agents/` 下安装 agent，并写入 Agestra host-asset manifest。不安装 custom agent、只注册 MCP 时，请使用 `npm run install:codex` 或 `agestra-install codex`。
 
 ### Gemini CLI
 
@@ -141,7 +141,7 @@ Gemini 会结合仓库根目录下的 [GEMINI.md](GEMINI.md) 与 [`.gemini/comma
 | `@agestra/provider-codex` | OpenAI Codex CLI 适配器 |
 | `@agestra/agents` | 带共识检测的辩论引擎、轮次质量评估、任务分发、交叉验证、任务链、自动 QA、文件变更跟踪、会话管理 |
 | `@agestra/workspace` | 用于评审、分析笔记和汇总报告的工作区文档管理器 |
-| `@agestra/mcp-server` | MCP 协议层，25 个工具，按环境过滤工具并动态分发 |
+| `@agestra/mcp-server` | MCP 协议层，44 个工具，按环境过滤工具并动态分发 |
 
 ### 设计原则
 
@@ -163,7 +163,7 @@ Gemini 会结合仓库根目录下的 [GEMINI.md](GEMINI.md) 与 [`.gemini/comma
 
 ---
 
-## 工具（25）
+## 工具（44）
 
 ### AI Chat（3）
 
@@ -173,7 +173,7 @@ Gemini 会结合仓库根目录下的 [GEMINI.md](GEMINI.md) 与 [`.gemini/comma
 | `ai_analyze_files` | 从磁盘读取文件并连同问题一起发送给提供方 |
 | `ai_compare` | 将同一提示发送给多个提供方并比较结果 |
 
-### Agent Orchestration（0）
+### Agent Orchestration（14）
 
 | 工具 | 说明 |
 |------|------|
@@ -226,6 +226,21 @@ Gemini 会结合仓库根目录下的 [GEMINI.md](GEMINI.md) 与 [`.gemini/comma
 | `provider_list` | 列出提供方及其状态和能力 |
 | `provider_health` | 对一个或全部提供方进行健康检查 |
 
+### Setup（2）
+
+| 工具 | 说明 |
+|------|------|
+| `setup_status` | 检测可用提供方并显示当前设置/配置状态 |
+| `setup_apply` | 将选择的提供方、语言和选择策略写入 `providers.config.json` |
+
+### Host Assets（3）
+
+| 工具 | 说明 |
+|------|------|
+| `host_assets_status` | 检查 Codex custom agents 等生成的宿主原生资产 |
+| `host_assets_install` | 显式安装或刷新受管宿主原生资产 |
+| `host_assets_uninstall` | 移除 Agestra 追踪的受管宿主原生资产 |
+
 ### Ollama（2）
 
 | 工具 | 说明 |
@@ -353,7 +368,7 @@ agestra/
 │   ├── provider-codex/      # Codex CLI 适配器
 │   ├── agents/              # 辩论引擎、分发器、交叉验证器
 │   ├── workspace/           # 工作区文档管理器
-│   └── mcp-server/          # MCP Server，25 个工具，按环境过滤并分发
+│   └── mcp-server/          # MCP Server，44 个工具，按环境过滤并分发
 ├── package.json             # 工作区根目录
 └── turbo.json               # Turborepo pipeline
 ```