opencode-magi 0.1.0 → 0.3.0

package/README.md

@@ -36,6 +36,8 @@ Add the plugin to `opencode.json`.
 }
 ```
 
+Restart OpenCode. Done.
+
 ### Configure
 
 Configure global defaults in `~/.config/opencode/magi.json` and project overrides in `<project>/.opencode/magi.json`.
@@ -58,9 +60,9 @@ Add the following content to the configuration file.
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/hirotomoyamada/opencode-magi/main/schema.json",
-  "agents": {
-    "reviewers": [
+  "$schema": "https://raw.githubusercontent.com/magi-ai/opencode-magi/main/schema.json",
+  "review": {
+    "agents": [
       {
         "account": "your-account-1",
         "model": "openai/gpt-5.5"
@@ -78,7 +80,7 @@ Add the following content to the configuration file.
 }
 ```
 
-`agents.reviewers[].account` is the GitHub account used to post reviews and approvals. Must be authenticated with `gh auth token --user <account>` and must be unique.
+`review.agents[].account` is the GitHub account used to post reviews and approvals. Must be authenticated with `gh auth token --user <account>` and must be unique.
 
 #### Set project config
 
@@ -94,13 +96,13 @@ Add the following content to the configuration file.
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/hirotomoyamada/opencode-magi/main/schema.json",
+  "$schema": "https://raw.githubusercontent.com/magi-ai/opencode-magi/main/schema.json",
   "github": {
     "owner": "your-owner",
     "repo": "your-repo"
   },
-  "agents": {
-    "reviewers": [
+  "review": {
+    "agents": [
       {
         "account": "your-account-1",
         "model": "openai/gpt-5.5"
@@ -113,7 +115,9 @@ Add the following content to the configuration file.
         "account": "your-account-3",
         "model": "opencode/kimi-k2-6"
       }
-    ],
+    ]
+  },
+  "merge": {
     "editor": {
       "account": "your-editor-account",
       "model": "openai/gpt-5.5",
@@ -122,11 +126,28 @@ Add the following content to the configuration file.
         "email": "your-email@example.com"
       }
     }
+  },
+  "triage": {
+    "account": "your-triage-account",
+    "agents": [
+      {
+        "id": "general",
+        "model": "openai/gpt-5.5"
+      },
+      {
+        "id": "maintenance",
+        "model": "anthropic/claude-opus-4-7"
+      },
+      {
+        "id": "product",
+        "model": "opencode/kimi-k2-6"
+      }
+    ]
   }
 }
 ```
 
-`agents.reviewers[].account` is the GitHub account used to post reviews and approvals. Must be authenticated with `gh auth token --user <account>` and must be unique.
+`review.agents[].account` is the GitHub account used to post reviews and approvals. Must be authenticated with `gh auth token --user <account>` and must be unique. `merge.editor.account` is used by `/magi:merge` to push fixes, close PRs, and merge PRs.
 
 #### Validate config
 
@@ -145,6 +166,8 @@ Run commands from OpenCode.
 /magi:review --dry-run 123
 /magi:merge 123
 /magi:merge --dry-run 123
+/magi:triage 47 48
+/magi:triage --dry-run 47
 /magi:clear
 ```
 
@@ -152,7 +175,7 @@ Run commands from OpenCode.
 
 - [Commands](docs/commands/index.md)
 - [Config](docs/config.md)
-- [Prompts](docs/prompts.md)
+- [Prompts](docs/prompts/index.md)
 
 ## Contributing
 

package/dist/commands.js

@@ -7,6 +7,10 @@ export const MAGI_COMMANDS = {
         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"),
+    },
     "magi:review": {
         description: "Review pull requests with Magi",
         template: [`Call the \`magi_review\` tool.`, "PR: $ARGUMENTS"].join("\n"),

package/dist/config/output.js

@@ -1,16 +1,25 @@
 import { isAbsolute, join } from "node:path";
 const DEFAULT_OUTPUT_DIRS = {
+    issue: ".magi/runs/issue",
     pr: ".magi/runs/pr",
 };
 function resolvePath(directory, path) {
     return isAbsolute(path) ? path : join(directory, path);
 }
 export function outputBaseDir(directory, config, kind) {
-    return resolvePath(directory, config.output?.dirs?.[kind] ?? DEFAULT_OUTPUT_DIRS[kind]);
+    return resolvePath(directory, kind === "issue"
+        ? (config.triage?.output ?? DEFAULT_OUTPUT_DIRS[kind])
+        : (config.review?.output ?? DEFAULT_OUTPUT_DIRS[kind]));
 }
 export function outputBaseDirs(directory, config) {
-    return [outputBaseDir(directory, config, "pr")];
+    return [
+        outputBaseDir(directory, config, "pr"),
+        outputBaseDir(directory, config, "issue"),
+    ];
 }
 export function prRunOutputDir(input) {
     return join(outputBaseDir(input.directory, input.config, "pr"), String(input.pr), ...(input.runId ? [input.runId] : []));
 }
+export function issueRunOutputDir(input) {
+    return join(outputBaseDir(input.directory, input.config, "issue"), String(input.issue), ...(input.runId ? [input.runId] : []));
+}

package/dist/config/resolve.js

@@ -4,9 +4,32 @@ const ID_PATTERN = /^[A-Za-z0-9_-]+$/;
 const DEFAULT_COMMON_PERMISSION = commonPermission;
 const DEFAULT_REVIEWER_PERMISSION = DEFAULT_COMMON_PERMISSION;
 const DEFAULT_EDITOR_PERMISSION = mergePermissions(DEFAULT_COMMON_PERMISSION, editorPermission);
+const DEFAULT_TRIAGE_CATEGORIES = [
+    {
+        description: "Something is broken or behaves incorrectly.",
+        id: "bug",
+        labels: ["bug"],
+        types: ["Bug"],
+    },
+    {
+        description: "Maintenance, refactoring, chores, or planned work.",
+        id: "task",
+        labels: ["task"],
+        types: ["Task"],
+    },
+    {
+        description: "New or improved user-facing capability.",
+        id: "feature",
+        labels: ["enhancement"],
+        types: ["Feature"],
+    },
+];
 export function reviewerKey(reviewer, index) {
     return reviewer.id ?? `reviewer-${index + 1}`;
 }
+export function triageAgentKey(agent, index) {
+    return agent.id ?? `triage-${index + 1}`;
+}
 export function validateReviewerId(id) {
     return ID_PATTERN.test(id);
 }
@@ -44,27 +67,57 @@ export function mergePermissions(base, override) {
     return merged;
 }
 export function resolveReviewerPermission(agents, reviewer) {
-    return mergePermissions(mergePermissions(DEFAULT_REVIEWER_PERMISSION, agents.permissions), reviewer.permission);
+    return mergePermissions(mergePermissions(DEFAULT_REVIEWER_PERMISSION, agents.permissions), reviewer.permissions);
 }
 export function resolveEditorPermission(agents, editor) {
-    return mergePermissions(mergePermissions(DEFAULT_EDITOR_PERMISSION, agents.permissions), editor.permission);
+    return mergePermissions(mergePermissions(DEFAULT_EDITOR_PERMISSION, agents.permissions), editor.permissions);
+}
+export function resolveTriageAgentPermission(agents, agent) {
+    return mergePermissions(mergePermissions(DEFAULT_REVIEWER_PERMISSION, agents.permissions), agent.permissions);
+}
+export function resolveTriageCreatorPermission(agents, creator) {
+    return mergePermissions(mergePermissions(DEFAULT_EDITOR_PERMISSION, agents.permissions), creator.permissions);
 }
-export function resolveAgents(agents) {
+export function resolveAgents(config) {
+    const agents = config.agents ?? {};
+    const editor = config.merge?.editor;
+    const creator = config.triage?.creator;
     return {
-        editor: agents.editor
+        editor: editor
             ? {
-                ...agents.editor,
-                permission: resolveEditorPermission(agents, agents.editor),
+                ...editor,
+                permission: resolveEditorPermission(agents, editor),
             }
             : undefined,
-        reviewers: (agents.reviewers ?? []).map((reviewer, index) => ({
+        reviewers: (config.review?.agents ?? []).map((reviewer, index) => ({
             ...reviewer,
             key: reviewerKey(reviewer, index),
             index,
             permission: resolveReviewerPermission(agents, reviewer),
         })),
+        triage: (config.triage?.agents ?? []).map((agent, index) => ({
+            ...agent,
+            key: triageAgentKey(agent, index),
+            index,
+            permission: resolveTriageAgentPermission(agents, agent),
+        })),
+        triageCreator: creator
+            ? {
+                ...creator,
+                account: creator.account ?? config.triage?.account ?? "",
+                permission: resolveTriageCreatorPermission(agents, creator),
+            }
+            : undefined,
     };
 }
+function resolveTriageCategories(config) {
+    return (config.triage?.categories ?? DEFAULT_TRIAGE_CATEGORIES).map((category) => ({
+        description: category.description,
+        id: category.id ?? "",
+        labels: category.labels ?? [],
+        types: category.types ?? [],
+    }));
+}
 export function resolveRepository(config) {
     if (!config.github?.owner)
         throw new Error("github.owner is required");
@@ -72,20 +125,21 @@ export function resolveRepository(config) {
         throw new Error("github.repo is required");
     return {
         alias: config.github.repo,
-        agents: resolveAgents(config.agents),
+        agents: resolveAgents(config),
         automation: {
-            close: config.automation?.close ?? true,
-            merge: config.automation?.merge ?? true,
+            close: config.merge?.automation?.close ?? false,
+            merge: config.merge?.automation?.merge ?? true,
         },
         checks: {
-            exclude: config.checks?.exclude ?? [],
-            waitAfterEdit: config.checks?.waitAfterEdit ?? true,
-            waitBeforeReview: config.checks?.waitBeforeReview ?? true,
-            retryFailedJobs: config.checks?.retryFailedJobs ?? 3,
+            exclude: config.review?.checks?.exclude ?? [],
+            retryFailedJobs: config.review?.checks?.retryFailedJobs ?? 3,
+            wait: config.review?.checks?.wait ?? true,
+            waitAfterEdit: config.merge?.checks?.wait ?? true,
+            waitBeforeReview: config.review?.checks?.wait ?? true,
         },
         concurrency: {
-            runs: config.concurrency?.runs ?? 3,
-            reviewers: config.concurrency?.reviewers ?? 3,
+            runs: config.review?.concurrency?.runs ?? 3,
+            reviewers: config.review?.concurrency?.reviewers ?? 3,
         },
         github: {
             apiRetryAttempts: config.github.apiRetryAttempts ?? 3,
@@ -95,19 +149,63 @@ export function resolveRepository(config) {
         },
         language: config.language,
         merge: {
-            approvalPolicy: config.merge?.approvalPolicy ?? "majority",
-            method: config.merge?.method ?? "squash",
-            auto: config.merge?.auto ?? true,
-            deleteBranch: config.merge?.deleteBranch ?? true,
-            mergeQueue: config.merge?.mergeQueue ?? false,
+            approvalPolicy: config.review?.merge?.approvalPolicy ?? "majority",
+            method: config.review?.merge?.method ?? "squash",
+            auto: config.review?.merge?.auto ?? true,
+            deleteBranch: config.review?.merge?.deleteBranch ?? true,
+            queue: config.review?.merge?.queue ?? false,
+            mergeQueue: config.review?.merge?.queue ?? false,
             maxThreadResolutionCycles: config.merge?.maxThreadResolutionCycles ?? 5,
         },
-        prompts: config.prompts ?? {},
+        prompts: {
+            ciClassification: config.review?.prompts?.ciClassification,
+            ciClassificationAfterEdit: config.merge?.prompts?.ciClassification,
+            closeReconsideration: config.review?.prompts?.closeReconsideration,
+            edit: config.merge?.prompts?.edit,
+            editGuidelines: config.merge?.prompts?.editGuidelines,
+            findingValidation: config.review?.prompts?.findingValidation,
+            rereview: config.review?.prompts?.rereview,
+            review: config.review?.prompts?.review,
+            reviewGuidelines: config.review?.prompts?.reviewGuidelines,
+        },
+        reviewAutomation: {
+            close: config.review?.automation?.close ?? false,
+            merge: config.review?.automation?.merge ?? true,
+        },
         safety: {
-            allowAuthors: config.safety?.allowAuthors ?? [],
-            blockedPaths: config.safety?.blockedPaths ?? [],
-            maxChangedFiles: config.safety?.maxChangedFiles,
-            requiredLabels: config.safety?.requiredLabels ?? [],
+            allowAuthors: config.review?.safety?.allowAuthors ?? [],
+            blockedPaths: config.review?.safety?.blockedPaths ?? [],
+            maxChangedFiles: config.review?.safety?.maxChangedFiles,
+            requiredLabels: config.review?.safety?.requiredLabels ?? [],
+        },
+        triage: {
+            account: config.triage?.account,
+            automation: {
+                clear: config.triage?.automation?.clear ?? ["triage"],
+                close: config.triage?.automation?.close ?? false,
+                create: config.triage?.automation?.create ?? false,
+                merge: config.triage?.automation?.merge ?? false,
+                review: config.triage?.automation?.review ?? false,
+            },
+            categories: resolveTriageCategories(config),
+            concurrency: {
+                runs: config.triage?.concurrency?.runs ?? 3,
+            },
+            output: config.triage?.output,
+            prompts: config.triage?.prompts ?? {},
+            safety: {
+                allowAuthors: config.triage?.safety?.allowAuthors ?? [],
+                allowMentionActors: config.triage?.safety?.allowMentionActors ?? [],
+                allowMentionRoles: config.triage?.safety?.allowMentionRoles ?? [
+                    "AUTHOR",
+                    "OWNER",
+                    "MEMBER",
+                    "COLLABORATOR",
+                ],
+                blockedLabels: config.triage?.safety?.blockedLabels ?? [],
+                requiredLabels: config.triage?.safety?.requiredLabels ?? ["triage"],
+            },
+            worktree: config.triage?.worktree,
         },
     };
 }