@kyo-so/cli 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -7,6 +7,36 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-07-13
+
+### Added
+
+- Claude Code Marketplace Plugin distribution with a shared Kyoso Skill and
+  version-pinned local stdio MCP server.
+- Best-effort post-publish reminders when either Plugin CLI pin lags the
+  released CLI version.
+
+### Changed
+
+- Move the Codex Plugin MCP definition to
+  `plugins/kyoso/.codex-plugin/mcp.json` so it cannot be auto-discovered by
+  Claude Code as a Plugin-root `.mcp.json`.
+- Document opt-in per-tool approval settings for avoiding Kyoso rejections in
+  Codex Auto mode, including the risk of sending selected code and review
+  context to configured external model providers. The Plugin keeps approvals
+  disabled by default.
+- Update the default `@agentclientprotocol/claude-agent-acp` adapter from
+  `0.57.0` to `0.58.1` for resumed-session model preservation, cancelled-turn
+  usage reporting, and streamed-thinking robustness.
+- Update `@modelcontextprotocol/server` from `2.0.0-beta.2` to
+  `2.0.0-beta.3`, restoring legacy `CallToolResult` parsing tolerance and
+  incorporating transport and authentication validation fixes.
+
+### Fixed
+
+- Updated the pinned Codex ACP adapter to `1.1.2`, whose bundled Codex model
+  catalog advertises reasoning-effort options for `gpt-5.6` family models.
+
 ## [0.9.0] - 2026-07-11
 
 ### Added

package/README.ja.md

@@ -40,26 +40,17 @@ backend が 1 つだけ有効な場合は、2 role の ensemble の代わりに
 
 | モード             | 導入物                   |  MCP | 対象               |
 | ------------------ | ------------------------ | ---: | ------------------ |
-| Marketplace Plugin | Skill＋ローカルstdio MCP | あり | Codex              |
+| Marketplace Plugin | Skill＋ローカルstdio MCP | あり | Codex／Claude Code |
 | CLI＋Skill-only    | npm CLI＋Skill           | なし | Codex／Claude Code |
 | 手動setup          | 手動MCP登録＋Skill       | あり | Codex／Claude Code |
 
-#### Codex Marketplace Plugin
+迷ったらMarketplace Pluginを選んでください。2コマンドでSkillとMCP serverをまとめて導入できます。手順は下の[Codex](#codex)／[Claude Code](#claude-code)節を参照してください。
 
-```bash
-codex plugin marketplace add hokupod/kyoso
-codex plugin list --marketplace kyoso --available --json
-codex plugin add kyoso@kyoso
-codex plugin list --marketplace kyoso --json
-```
-
-Codex desktopのPlugins pageまたは`/plugins`からKyosoを選ぶこともできます。追加したMarketplaceが見えない場合はdesktop appをrefresh／restartしてください。削除は`codex plugin remove kyoso@kyoso`です。
+#### Marketplace Plugin
 
 PluginはSkillと公開済みのKyoso CLIの完全一致versionへpinしたMCP定義を同梱しますが、CLI本体は同梱しません。MCPの初回起動ではnpmへのnetwork accessが必要です。cache済みpackageでoffline起動できる場合はありますが、保証しません。manifestの`Read` capabilityは表示metadataであり、filesystem認可を追加するものではありません。
 
-PluginのSkillは同梱の`kyoso` MCP serverをdependencyとして宣言するため、Kyoso reviewの明示的な実行はCLI fallbackではなくMCPへ誘導されます。Codex Auto modeでは、Kyoso toolsがannotationsを宣言していないため、最初のMCP呼び出しでapprovalが必要になることがあります。以後も許可する場合は「Allow and don't ask me again」を選択してください。
-
-同梱Plugin MCPを無効化した場合は、Plugin Skillを利用不可として扱います。MCPを再有効化するか、Pluginを削除してCLI＋Skill-onlyへ移行してください。PluginはCLI fallback modeではありません。
+PluginのSkillは同梱の`kyoso` MCP serverをdependencyとして宣言するため、Kyoso reviewの明示的な実行はCLI fallbackではなくMCPへ誘導されます。同梱Plugin MCPを無効化した場合は、Plugin Skillを利用不可として扱います。MCPを再有効化するか、Pluginを削除してCLI＋Skill-onlyへ移行してください。PluginはCLI fallback modeではありません。
 
 #### CLI＋Skill-only
 
@@ -102,21 +93,32 @@ claude setup-token
 
 このコマンドで得た `CLAUDE_CODE_OAUTH_TOKEN` を設定するか、直接 API 課金を使う場合は `ANTHROPIC_API_KEY` を設定します。
 
-2. MCP を登録し、review skill をインストールします。
+2. Marketplace Plugin を導入します(推奨)。
+
+```text
+/plugin marketplace add hokupod/kyoso
+/plugin install kyoso@kyoso
+```
+
+Plugin は Kyoso review Skill と、公開済み CLI version に pin したローカル stdio MCP server を導入します。Plugin で導入した場合、`kyoso setup claude-code` は不要です。
+
+3. または、MCP を登録して review skill をインストールします。
 
 ```bash
 npx @kyo-so/cli setup claude-code --write
 bunx @kyo-so/cli setup claude-code --write
 ```
 
-3. セットアップを確認します。
+手動で MCP を登録する場合は、`examples/claude-code-mcp.json` を使用します。
+
+4. セットアップを確認します。
 
 ```bash
 npx @kyo-so/cli doctor
 bunx @kyo-so/cli doctor
 ```
 
-4. Claude Code からレビューを依頼します。
+5. Claude Code からレビューを依頼します。
 
 ```text
 Use Kyoso plan_review on this plan before implementation.
@@ -130,21 +132,56 @@ Use Kyoso plan_review on this plan before implementation.
 codex login
 ```
 
-2. MCP を登録し、review skill をインストールします。
+2. Marketplace Plugin を導入します(推奨)。
+
+```bash
+codex plugin marketplace add hokupod/kyoso
+codex plugin add kyoso@kyoso
+```
+
+Codex desktopのPlugins pageまたは`/plugins`からKyosoを選ぶこともできます。追加したMarketplaceが見えない場合はdesktop appをrefresh／restartしてください。確認は`codex plugin list --marketplace kyoso --json`、削除は`codex plugin remove kyoso@kyoso`です。Plugin で導入した場合、`kyoso setup codex` は不要です。
+
+Codex Auto modeでは、approvalが必要なKyoso toolの呼び出しが拒否されることがあります。個人設定で事前承認するには、次を`~/.codex/config.toml`（`CODEX_HOME`を設定している場合は`$CODEX_HOME/config.toml`）へ追加します。**Kyosoを信頼し、選択したコードとレビュー用contextが設定済みの外部model providerへ送信されることを許容できる場合だけ設定してください。** Pluginの既定値では有効にしていません。
+
+```toml
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.diff_review]
+approval_mode = "approve"
+
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.plan_review]
+approval_mode = "approve"
+
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.security_review]
+approval_mode = "approve"
+```
+
+Pluginではなく、MCP serverとして直接登録している場合（`kyoso setup codex --write` または手動設定）は、`plugins."kyoso@kyoso".` プレフィックスなしの `mcp_servers.kyoso` キーを使用します。
+
+```toml
+[mcp_servers.kyoso.tools.diff_review]
+approval_mode = "approve"
+
+[mcp_servers.kyoso.tools.plan_review]
+approval_mode = "approve"
+
+[mcp_servers.kyoso.tools.security_review]
+approval_mode = "approve"
+```
+
+3. または、MCP を登録して review skill をインストールします。
 
 ```bash
 npx @kyo-so/cli setup codex --write
 bunx @kyo-so/cli setup codex --write
 ```
 
-3. セットアップを確認します。
+4. セットアップを確認します。
 
 ```bash
 npx @kyo-so/cli doctor
 bunx @kyo-so/cli doctor
 ```
 
-4. Codex からレビューを依頼します。
+5. Codex からレビューを依頼します。
 
 ```text
 Use Kyoso diff_review on the current diff. I need a second opinion before merging.

package/README.md

@@ -38,26 +38,17 @@ No global install is required. Run Kyoso through `npx` or `bunx`.
 
 | Mode                | Installs                           | MCP | Clients             |
 | ------------------- | ---------------------------------- | --: | ------------------- |
-| Marketplace Plugin  | Skill plus local stdio MCP         | Yes | Codex               |
+| Marketplace Plugin  | Skill plus local stdio MCP         | Yes | Codex / Claude Code |
 | CLI plus Skill-only | npm CLI plus Skill                 |  No | Codex / Claude Code |
 | Manual setup        | Manual MCP registration plus Skill | Yes | Codex / Claude Code |
 
-#### Codex Marketplace Plugin
+When in doubt, pick the Marketplace Plugin: two commands install the Skill and the MCP server together. Follow the [Codex](#codex) or [Claude Code](#claude-code) steps below.
 
-```bash
-codex plugin marketplace add hokupod/kyoso
-codex plugin list --marketplace kyoso --available --json
-codex plugin add kyoso@kyoso
-codex plugin list --marketplace kyoso --json
-```
-
-You can also select Kyoso from the Codex desktop Plugins page or `/plugins`. Refresh or restart the desktop app if a newly added marketplace is not visible. Remove the Plugin with `codex plugin remove kyoso@kyoso`.
+#### Marketplace Plugin
 
 The Plugin bundles the Skill and an MCP definition pinned to an exact published Kyoso CLI version; it does not bundle the CLI itself. Its first MCP start needs network access to npm. A cached package may work offline, but offline startup is not guaranteed. The manifest's `Read` capability is display metadata, not additional filesystem authorization.
 
-The Plugin Skill declares the bundled `kyoso` MCP server as a dependency, so explicit Kyoso reviews are directed through MCP rather than a CLI fallback. In Codex Auto mode, the first MCP invocation can still require approval because Kyoso tools do not declare annotations; choose "Allow and don't ask me again" to retain that approval.
-
-If you disable the bundled Plugin MCP, treat the Plugin Skill as unavailable: re-enable it, or remove the Plugin and install CLI plus Skill-only instead. The Plugin is not a CLI-fallback mode.
+The Plugin Skill declares the bundled `kyoso` MCP server as a dependency, so explicit Kyoso reviews are directed through MCP rather than a CLI fallback. If you disable the bundled Plugin MCP, treat the Plugin Skill as unavailable: re-enable it, or remove the Plugin and install CLI plus Skill-only instead. The Plugin is not a CLI-fallback mode.
 
 #### CLI plus Skill-only
 
@@ -100,21 +91,32 @@ claude setup-token
 
 Set `CLAUDE_CODE_OAUTH_TOKEN` from that command, or set `ANTHROPIC_API_KEY` for direct API billing.
 
-2. Register MCP and install the review skill.
+2. Install the Marketplace Plugin (recommended).
+
+```text
+/plugin marketplace add hokupod/kyoso
+/plugin install kyoso@kyoso
+```
+
+The Plugin installs the Kyoso review Skill and a local stdio MCP server pinned to a released CLI version. When you install the Plugin, `kyoso setup claude-code` is not required.
+
+3. Alternatively, register MCP and install the review skill.
 
 ```bash
 npx @kyo-so/cli setup claude-code --write
 bunx @kyo-so/cli setup claude-code --write
 ```
 
-3. Verify the setup.
+For manual MCP registration, use `examples/claude-code-mcp.json`.
+
+4. Verify the setup.
 
 ```bash
 npx @kyo-so/cli doctor
 bunx @kyo-so/cli doctor
 ```
 
-4. Ask for a review from Claude Code.
+5. Ask for a review from Claude Code.
 
 ```text
 Use Kyoso plan_review on this plan before implementation.
@@ -128,21 +130,56 @@ Use Kyoso plan_review on this plan before implementation.
 codex login
 ```
 
-2. Register MCP and install the review skill.
+2. Install the Marketplace Plugin (recommended).
+
+```bash
+codex plugin marketplace add hokupod/kyoso
+codex plugin add kyoso@kyoso
+```
+
+You can also select Kyoso from the Codex desktop Plugins page or `/plugins`; refresh or restart the desktop app if a newly added marketplace is not visible. Check the installation with `codex plugin list --marketplace kyoso --json`, and remove the Plugin with `codex plugin remove kyoso@kyoso`. When you install the Plugin, `kyoso setup codex` is not required.
+
+Codex Auto mode may reject Kyoso tool calls that require approval. To pre-approve them for your account, add the following to `~/.codex/config.toml` (or `$CODEX_HOME/config.toml` when `CODEX_HOME` is set). **Only do this if you trust Kyoso and accept that selected code and review context may be sent to the configured external model providers.** The Plugin does not enable this by default.
+
+```toml
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.diff_review]
+approval_mode = "approve"
+
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.plan_review]
+approval_mode = "approve"
+
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.security_review]
+approval_mode = "approve"
+```
+
+When Kyoso is registered directly as an MCP server (`kyoso setup codex --write` or manual setup) instead of the Plugin, use the `mcp_servers.kyoso` keys without the `plugins."kyoso@kyoso".` prefix:
+
+```toml
+[mcp_servers.kyoso.tools.diff_review]
+approval_mode = "approve"
+
+[mcp_servers.kyoso.tools.plan_review]
+approval_mode = "approve"
+
+[mcp_servers.kyoso.tools.security_review]
+approval_mode = "approve"
+```
+
+3. Alternatively, register MCP and install the review skill.
 
 ```bash
 npx @kyo-so/cli setup codex --write
 bunx @kyo-so/cli setup codex --write
 ```
 
-3. Verify the setup.
+4. Verify the setup.
 
 ```bash
 npx @kyo-so/cli doctor
 bunx @kyo-so/cli doctor
 ```
 
-4. Ask for a review from Codex.
+5. Ask for a review from Codex.
 
 ```text
 Use Kyoso diff_review on the current diff. I need a second opinion before merging.

package/README.zh-CN.md

@@ -40,26 +40,17 @@ Kyoso 不会应用代码更改。
 
 | 模式               | 安装内容             | MCP | 客户端             |
 | ------------------ | -------------------- | --: | ------------------ |
-| Marketplace Plugin | Skill＋本地stdio MCP |  有 | Codex              |
+| Marketplace Plugin | Skill＋本地stdio MCP |  有 | Codex／Claude Code |
 | CLI＋Skill-only    | npm CLI＋Skill       |  无 | Codex／Claude Code |
 | 手动setup          | 手动MCP注册＋Skill   |  有 | Codex／Claude Code |
 
-#### Codex Marketplace Plugin
+拿不准时请选择Marketplace Plugin：两条命令即可同时安装Skill和MCP server。步骤见下方的[Codex](#codex)／[Claude Code](#claude-code)小节。
 
-```bash
-codex plugin marketplace add hokupod/kyoso
-codex plugin list --marketplace kyoso --available --json
-codex plugin add kyoso@kyoso
-codex plugin list --marketplace kyoso --json
-```
-
-也可以在Codex desktop的Plugins page或`/plugins`中选择Kyoso。若新添加的Marketplace未显示，请refresh／restart desktop app。使用`codex plugin remove kyoso@kyoso`删除Plugin。
+#### Marketplace Plugin
 
 Plugin包含Skill和pin到已发布Kyoso CLI精确版本的MCP定义，但不包含CLI本体。MCP首次启动需要访问npm网络。已缓存的package可能可以offline启动，但不作保证。manifest中的`Read` capability仅是显示metadata，不会授予额外filesystem权限。
 
-Plugin中的Skill将内置的`kyoso` MCP server声明为dependency，因此显式Kyoso review会通过MCP而不是CLI fallback。在Codex Auto mode中，Kyoso tools未声明annotations，首次MCP调用仍可能需要approval；选择“Allow and don't ask me again”即可保留该许可。
-
-如果禁用内置Plugin MCP，应将Plugin Skill视为不可用：重新启用MCP，或移除Plugin并改用CLI＋Skill-only。Plugin不是CLI fallback mode。
+Plugin中的Skill将内置的`kyoso` MCP server声明为dependency，因此显式Kyoso review会通过MCP而不是CLI fallback。如果禁用内置Plugin MCP，应将Plugin Skill视为不可用：重新启用MCP，或移除Plugin并改用CLI＋Skill-only。Plugin不是CLI fallback mode。
 
 #### CLI＋Skill-only
 
@@ -102,21 +93,32 @@ claude setup-token
 
 设置该命令得到的 `CLAUDE_CODE_OAUTH_TOKEN`，或设置 `ANTHROPIC_API_KEY` 以使用 direct API billing。
 
-2. 注册 MCP 并安装 review skill。
+2. 安装 Marketplace Plugin(推荐)。
+
+```text
+/plugin marketplace add hokupod/kyoso
+/plugin install kyoso@kyoso
+```
+
+Plugin 会安装 Kyoso review Skill 和 pin 到已发布 CLI version 的本地 stdio MCP server。通过 Plugin 安装时，无需运行 `kyoso setup claude-code`。
+
+3. 或者，注册 MCP 并安装 review skill。
 
 ```bash
 npx @kyo-so/cli setup claude-code --write
 bunx @kyo-so/cli setup claude-code --write
 ```
 
-3. 验证 setup。
+需要手动注册 MCP 时，请使用 `examples/claude-code-mcp.json`。
+
+4. 验证 setup。
 
 ```bash
 npx @kyo-so/cli doctor
 bunx @kyo-so/cli doctor
 ```
 
-4. 从 Claude Code 请求 review。
+5. 从 Claude Code 请求 review。
 
 ```text
 Use Kyoso plan_review on this plan before implementation.
@@ -130,21 +132,56 @@ Use Kyoso plan_review on this plan before implementation.
 codex login
 ```
 
-2. 注册 MCP 并安装 review skill。
+2. 安装 Marketplace Plugin(推荐)。
+
+```bash
+codex plugin marketplace add hokupod/kyoso
+codex plugin add kyoso@kyoso
+```
+
+也可以在Codex desktop的Plugins page或`/plugins`中选择Kyoso。若新添加的Marketplace未显示，请refresh／restart desktop app。使用`codex plugin list --marketplace kyoso --json`确认安装，使用`codex plugin remove kyoso@kyoso`删除Plugin。通过 Plugin 安装时，无需运行 `kyoso setup codex`。
+
+在Codex Auto mode中，需要approval的Kyoso tool调用可能会被拒绝。若要仅为个人账户预先批准，请将以下设置添加到`~/.codex/config.toml`（若已设置`CODEX_HOME`，则为`$CODEX_HOME/config.toml`）。**只有在你信任Kyoso，并接受所选代码与review context可能发送给已配置的外部model provider时，才应启用此设置。** Plugin默认不会启用它。
+
+```toml
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.diff_review]
+approval_mode = "approve"
+
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.plan_review]
+approval_mode = "approve"
+
+[plugins."kyoso@kyoso".mcp_servers.kyoso.tools.security_review]
+approval_mode = "approve"
+```
+
+如果Kyoso不是通过Plugin、而是直接注册为MCP server（`kyoso setup codex --write` 或手动设置），请使用不带 `plugins."kyoso@kyoso".` 前缀的 `mcp_servers.kyoso` 键：
+
+```toml
+[mcp_servers.kyoso.tools.diff_review]
+approval_mode = "approve"
+
+[mcp_servers.kyoso.tools.plan_review]
+approval_mode = "approve"
+
+[mcp_servers.kyoso.tools.security_review]
+approval_mode = "approve"
+```
+
+3. 或者，注册 MCP 并安装 review skill。
 
 ```bash
 npx @kyo-so/cli setup codex --write
 bunx @kyo-so/cli setup codex --write
 ```
 
-3. 验证 setup。
+4. 验证 setup。
 
 ```bash
 npx @kyo-so/cli doctor
 bunx @kyo-so/cli doctor
 ```
 
-4. 从 Codex 请求 review。
+5. 从 Codex 请求 review。
 
 ```text
 Use Kyoso diff_review on the current diff. I need a second opinion before merging.