opencode-magi 0.9.0 → 0.11.0

package/README.ja.md

@@ -0,0 +1,254 @@
+<p align='center'>
+  <a href='./README.md'>English</a> | 日本語
+</p>
+
+# OpenCode Magi
+
+OpenCodeのマルチエージェントによるGitHubプルリクエストレビューとマージのオーケストレーション。
+
+## なぜ、Magiなのか？
+
+Magiは、三賢者に着想を得ています。独立した視点が集まり、共に意思決定する仕組みです。
+
+1つのAIモデルだけを盲目的に信頼するには、まだ十分ではありません。OpenCode Magiは、複数のモデルに同じプルリクエストを異なる視点から検査させ、過半数を必須にすることで信頼性を高めます。
+
+一つのAIの回答を最終判断として扱うことせず、多様な観点、明示的な意見の不一致、そして合意に裏付けられた最終判断によって、AIレビューを実際のチームに近づけることです。
+
+## 機能
+
+OpenCode Magiは、人間がGitHub上で行っているレビューサイクルを再現します。複数のレビュアーがプルリクエストを確認し、変更を要求し、修正を検証し、スレッドを解決し、準備ができたら承認します。
+
+- 3人以上のレビュアーによる、多数決制のマルチエージェントレビュー。
+- 変更リクエストを投稿する前に多数決を行い、過半数に承認された指摘だけをリクエストします。
+- デフォルトのシングルモードに加え、複数のGitHubアカウントを使用するマルチモードも用意しています。マルチモードでは、まるでチームでレビューを行っているかのように、各レビュアーが異なるGitHubアカウントでレビューを行うことができます。
+- 編集やスレッドの返信があるPRの再レビューに対応。修正済みのスレッドを解決し、修正に応じてレビュアーは承認し、まだ修正が必要な指摘は追加のコメントとして投稿します。
+- 任意のマージおよびクローズ自動化。エディターエージェントが作者の代わりに応答し、変更リクエストされた指摘を修正し、必要に応じてコミットをプッシュし、PRがマージ、またはクローズできるまでレビュアーとエディターのサイクルを繰り返します。
+- レビュアーやエディターごとに権限の割り振り、フェーズごとのプロンプト、ペルソナを設定できます。
+
+## クイックスタート
+
+### インストール
+
+`opencode.json`にプラグインを追加します。
+
+```json
+{
+  "$schema": "https://opencode.ai/config.json",
+  "plugin": ["opencode-magi"]
+}
+```
+
+OpenCodeを再起動します。これで完了です。
+
+### 設定
+
+グローバルのデフォルトは `~/.config/opencode/magi.json`に、プロジェクトごとの上書きは、`<project>/.opencode/magi.json`に設定します。
+
+Magiの設定ファイルは、OpenCodeではなくOpenCode Magiによってマージされます。プロジェクトの設定ファイルは、グローバルの設定ファイルをオーバーライドします。
+
+1. `~/.config/opencode/magi.json`
+2. `<project>/.opencode/magi.json`
+
+#### グローバル設定を作成する
+
+プロジェクト設定に値が存在する場合、グローバル設定値を設定する必要はありません。ただし、複数のプロジェクトで共通の値を適用したい場合は、グローバル設定が便利です。
+
+```bash
+mkdir -p ~/.config/opencode
+touch ~/.config/opencode/magi.json
+```
+
+設定ファイルに次の内容を追加します。
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/magi-ai/opencode-magi/main/schema.json",
+  "account": "your-account",
+  "agents": {
+    "refs": {
+      "account-1": {
+        "model": "openai/gpt-5.5"
+      },
+      "account-2": {
+        "model": "anthropic/claude-opus-4-7"
+      },
+      "account-3": {
+        "model": "opencode/kimi-k2-6"
+      }
+    }
+  },
+  "review": {
+    "reviewers": [
+      {
+        "ref": "account-1"
+      },
+      {
+        "ref": "account-2"
+      },
+      {
+        "ref": "account-3"
+      }
+    ]
+  }
+}
+```
+
+デフォルトでは、シングルモード（`mode: "single"`）です。複数のアカウントを使用するマルチモードにする場合は、`mode: "multi"`を設定し、各エージェントごとにアカウントを設定します。
+
+```json
+{
+  "mode": "multi",
+  "review": {
+    "reviewers": [
+      {
+        "id": "general",
+        "model": "openai/gpt-5.5",
+        "account": "account-1"
+      },
+      {
+        "id": "security",
+        "model": "anthropic/claude-opus-4-7",
+        "account": "account-2"
+      },
+      {
+        "id": "compat",
+        "model": "opencode/kimi-k2-6",
+        "account": "account-3"
+      }
+    ]
+  }
+}
+```
+
+#### プロジェクト設定を作成する
+
+Magiの設定ファイルは少なくとも1つ必要です。プロジェクト固有の設定には、プロジェクト設定を使用します。
+
+```bash
+cd <project>
+mkdir -p .opencode
+touch .opencode/magi.json
+```
+
+設定ファイルに次の内容を追加します。
+
+```json
+{
+  "$schema": "https://raw.githubusercontent.com/magi-ai/opencode-magi/main/schema.json",
+  "account": "your-account",
+  "github": {
+    "owner": "your-owner",
+    "repo": "your-repo"
+  },
+  "agents": {
+    "refs": {
+      "account-1": {
+        "model": "openai/gpt-5.5"
+      },
+      "account-2": {
+        "model": "anthropic/claude-opus-4-7"
+      },
+      "account-3": {
+        "model": "opencode/kimi-k2-6"
+      },
+      "account-4": {
+        "model": "openai/gpt-5.5",
+        "author": {
+          "name": "account-4",
+          "email": "your-email@example.com"
+        }
+      }
+    }
+  },
+  "review": {
+    "reviewers": [
+      {
+        "ref": "account-1"
+      },
+      {
+        "ref": "account-2"
+      },
+      {
+        "ref": "account-3"
+      }
+    ]
+  },
+  "merge": {
+    "editor": {
+      "ref": "account-4"
+    }
+  },
+  "triage": {
+    "voters": [
+      {
+        "ref": "account-1"
+      },
+      {
+        "ref": "account-2"
+      },
+      {
+        "ref": "account-3"
+      }
+    ]
+  }
+}
+```
+
+`agents.refs`のキーを`ref`に設定すると、そのエージェントの設定が展開されます。`ref`以外でフィールドを設定した場合は、そのエージェントの設定をオーバーライドします。
+
+`model`には、文字列（`provider/model`）、`id`と`variant`のオブジェクト、または配列を指定できます。配列は、先頭から順々に利用可能なモデルかどうかを検証し、利用可能なモデルが見つかったら、そのモデルを採用します。
+
+```json
+{
+  "model": {
+    "id": "openai/gpt-5.1",
+    "variant": "high"
+  }
+}
+```
+
+```json
+{
+  "model": [
+    {
+      "id": "anthropic/claude-opus-4-7",
+      "variant": "high"
+    },
+    {
+      "id": "openai/gpt-5.5",
+      "variant": "medium"
+    }
+  ]
+}
+```
+
+#### 設定を検証する
+
+グローバル設定またはプロジェクト設定を作成または更新した後、検証します。
+
+```txt
+/magi:validate
+```
+
+### コマンド
+
+OpenCodeからコマンドを実行します。
+
+```txt
+/magi:review 123 124
+/magi:review 123 --dry-run
+/magi:merge 123
+/magi:merge 123 --dry-run
+/magi:triage 47 48
+/magi:triage 47 --dry-run
+/magi:clear
+```
+
+## ドキュメント
+
+- [コマンド](docs/commands/index.ja.md)
+- [設定](docs/config.ja.md)
+
+## コントリビュート
+
+貢献してみませんか？素晴らしいです！貢献を支援するための [コントリビューションガイド](CONTRIBUTING.ja.md) を用意しています。

package/README.md

@@ -1,27 +1,29 @@
+<p align='center'>
+  English | <a href='./README.ja.md'>日本語</a>
+</p>
+
 # OpenCode Magi
 
 Multi-agent GitHub pull request review and merge orchestration for OpenCode.
 
 ## Why Magi?
 
-Magi is inspired by the three wise men: independent perspectives that reach a decision together.
+Magi is inspired by the three wise men: independent perspectives that gather and make decisions together.
 
-One AI model is still not enough to trust blindly. OpenCode Magi improves confidence by asking multiple models to inspect the same pull request from different perspectives, then requiring an odd-number majority before approving, requesting changes, or closing.
+One AI model is still not enough to trust blindly. OpenCode Magi improves confidence by asking multiple models to inspect the same pull request from different perspectives, then requiring a majority decision.
 
-The goal is not to treat a single AI answer as final, but to make AI review behave more like a real team: diverse viewpoints, explicit disagreement, and a final decision backed by consensus.
+Instead of treating one AI answer as the final judgment, the goal is to make AI review closer to a real team through diverse viewpoints, explicit disagreement, and final decisions backed by consensus.
 
 ## Features
 
-OpenCode Magi recreates the review cycle humans already run on GitHub: multiple reviewers inspect a pull request, request changes, verify fixes, resolve threads, and approve when the work is ready.
+OpenCode Magi recreates the review cycle humans already run on GitHub. Multiple reviewers inspect a pull request, request changes, verify fixes, resolve threads, and approve when the work is ready.
 
-- Multi-agent reviews with an odd-number majority of 3 or more reviewers.
-- Optional unanimous approval policy for merge automation when every reviewer must approve before a PR is merged.
-- Finding-level voting before posting change requests, so only findings accepted by reviewer majority are submitted.
-- Multi-account review mode where each reviewer posts through its configured GitHub account, plus single-account review mode where one GitHub account posts the consensus result for multiple logical reviewers.
-- Re-review support for edited PRs: fixed threads are resolved, satisfied reviewers approve, and remaining issues are posted as additional comments.
-- Optional merge and close automation where an editor agent responds on behalf of the author, fixes changes it agrees with, pushes commits when needed, and repeats the reviewer/editor cycle until the PR can be approved, queued, merged, or closed.
-- Per-agent OpenCode permissions for reviewer, CI classifier, and editor child sessions.
-- Prompt customization that adds repository-specific guidance without replacing the fixed output contracts.
+- Multi-agent reviews with majority voting by 3 or more reviewers.
+- Majority voting before posting change requests, so only findings accepted by the majority are requested.
+- Single mode by default, plus multi mode for using multiple GitHub accounts. In multi mode, each reviewer can review from a different GitHub account, as if a team were reviewing together.
+- Re-review support for PRs with edits or thread replies. Fixed threads are resolved, reviewers approve based on fixes, and findings that still need changes are posted as additional comments.
+- Optional merge and close automation. An editor agent responds on behalf of the author, fixes requested findings, pushes commits when needed, and repeats the reviewer/editor cycle until the PR can be merged or closed.
+- Configure permissions, phase-specific prompts, and personas for each reviewer and editor.
 
 ## Quick Start
 
@@ -42,7 +44,7 @@ Restart OpenCode. Done.
 
 Configure global defaults in `~/.config/opencode/magi.json` and project overrides in `<project>/.opencode/magi.json`.
 
-Magi config files are merged by OpenCode Magi, not by OpenCode. Priority, lowest to highest.
+Magi config files are merged by OpenCode Magi, not by OpenCode. The project config file overrides the global config file.
 
 1. `~/.config/opencode/magi.json`
 2. `<project>/.opencode/magi.json`
@@ -61,6 +63,7 @@ Add the following content to the configuration file.
 ```json
 {
   "$schema": "https://raw.githubusercontent.com/magi-ai/opencode-magi/main/schema.json",
+  "account": "your-account",
   "agents": {
     "refs": {
       "account-1": {
@@ -75,7 +78,6 @@ Add the following content to the configuration file.
     }
   },
   "review": {
-    "account": "your-account",
     "reviewers": [
       { "ref": "account-1" },
       { "ref": "account-2" },
@@ -85,14 +87,12 @@ Add the following content to the configuration file.
 }
 ```
 
-By default, `review.mode` is `"single"`. Magi uses one `review.account` to post reviewer-originated GitHub mutations while still running multiple logical reviewer agents and preserving majority voting, finding validation, and close reconsideration. The account must be authenticated with `gh auth token --user <account>`.
-
-For team setups that need separate GitHub review identities, set `review.mode: "multi"` and configure a unique account for each reviewer.
+By default, Magi uses single mode (`mode: "single"`). To use multi mode with multiple accounts, set `mode: "multi"` and configure an account for each reviewer.
 
 ```json
 {
+  "mode": "multi",
   "review": {
-    "mode": "multi",
     "reviewers": [
       { "id": "general", "model": "openai/gpt-5.5", "account": "account-1" },
       {
@@ -108,7 +108,7 @@ For team setups that need separate GitHub review identities, set `review.mode: "
 
 #### Set project config
 
-Global config is optional, but project config is required.
+At least one Magi config file is required. Use project config for project-specific settings.
 
 ```bash
 cd <project>
@@ -121,6 +121,7 @@ Add the following content to the configuration file.
 ```json
 {
   "$schema": "https://raw.githubusercontent.com/magi-ai/opencode-magi/main/schema.json",
+  "account": "your-account",
   "github": {
     "owner": "your-owner",
     "repo": "your-repo"
@@ -128,20 +129,16 @@ Add the following content to the configuration file.
   "agents": {
     "refs": {
       "account-1": {
-        "model": "openai/gpt-5.5",
-        "account": "account-1"
+        "model": "openai/gpt-5.5"
       },
       "account-2": {
-        "model": "anthropic/claude-opus-4-7",
-        "account": "account-2"
+        "model": "anthropic/claude-opus-4-7"
       },
       "account-3": {
-        "model": "opencode/kimi-k2-6",
-        "account": "account-3"
+        "model": "opencode/kimi-k2-6"
       },
       "account-4": {
         "model": "openai/gpt-5.5",
-        "account": "account-4",
         "author": {
           "name": "account-4",
           "email": "your-email@example.com"
@@ -169,20 +166,27 @@ Add the following content to the configuration file.
 }
 ```
 
-Entries with `ref` are expanded from `agents.refs`. Fields set alongside `ref` override fields from the preset.
+Set an `agents.refs` key as `ref` to expand that agent's configuration. Fields set outside `ref` override that agent's configuration.
 
-`model` can be a single `provider/model` string, a single object with `id` and `options`, or an ordered candidate array. Candidate arrays are resolved during validation against OpenCode's model catalog; the first available model is selected. Put provider-specific options on model objects, not on the agent role.
+`model` can be a string (`provider/model`), an object with `id` and `variant`, or an array. Arrays are checked in order to find an available model, and the first available model is selected.
 
 ```json
 {
   "model": {
     "id": "openai/gpt-5.1",
-    "options": { "reasoningEffort": "high" }
+    "variant": "high"
   }
 }
 ```
 
-After `refs` are expanded, `review.reviewers[].account` is the GitHub account used to post reviews and approvals in `multi` mode. Must be authenticated with `gh auth token --user <account>` and must be unique. In `single` mode, `review.account` is used for reviewer-originated review posts, approvals, change requests, close comments, reviewer replies, and reviewer thread resolutions. `merge.editor.account` is still used by `/magi:merge` to push fixes, close PRs, and merge PRs.
+```json
+{
+  "model": [
+    { "id": "anthropic/claude-opus-4-7", "variant": "high" },
+    { "id": "openai/gpt-5.5", "variant": "medium" }
+  ]
+}
+```
 
 #### Validate config
 
@@ -198,11 +202,11 @@ Run commands from OpenCode.
 
 ```txt
 /magi:review 123 124
-/magi:review --dry-run 123
+/magi:review 123 --dry-run
 /magi:merge 123
-/magi:merge --dry-run 123
+/magi:merge 123 --dry-run
 /magi:triage 47 48
-/magi:triage --dry-run 47
+/magi:triage 47 --dry-run
 /magi:clear
 ```
 
@@ -210,7 +214,6 @@ Run commands from OpenCode.
 
 - [Commands](docs/commands/index.md)
 - [Config](docs/config.md)
-- [Prompts](docs/prompts/index.md)
 
 ## Contributing
 

package/dist/commands.js

@@ -1,22 +1,24 @@
-export const MAGI_COMMANDS = {
+export const commands = {
     "magi:clear": {
-        description: "Clear inactive Magi runs, sessions, worktrees, and outputs",
+        description: [
+            "Clear inactive Magi runs, sessions, worktrees, and outputs",
+        ].join("\n"),
         template: "Call the `magi_clear` tool.",
     },
     "magi:merge": {
         description: "Review and merge pull requests with Magi",
-        template: [`Call the \`magi_merge\` tool.`, "PR: $ARGUMENTS"].join("\n"),
-    },
-    "magi:triage": {
-        description: "Triage GitHub issues with Magi",
-        template: [`Call the \`magi_triage\` tool.`, "Issue: $ARGUMENTS"].join("\n"),
+        template: ["Call the `magi_merge` tool.", "PR: $ARGUMENTS"].join("\n"),
     },
     "magi:review": {
         description: "Review pull requests with Magi",
-        template: [`Call the \`magi_review\` tool.`, "PR: $ARGUMENTS"].join("\n"),
+        template: ["Call the `magi_review` tool.", "PR: $ARGUMENTS"].join("\n"),
+    },
+    "magi:triage": {
+        description: "Triage issues with Magi",
+        template: ["Call the `magi_triage` tool.", "Issue: $ARGUMENTS"].join("\n"),
     },
     "magi:validate": {
         description: "Validate Magi config",
-        template: "Call the `magi_validate` tool.",
+        template: ["Call the `magi_validate` tool."].join("\n"),
     },
 };

package/dist/config/index.js

@@ -0,0 +1,2 @@
+export * from "./resolve";
+export * from "./validate";