opencode-magi 0.1.0

package/dist/prompts/output.js

@@ -0,0 +1,260 @@
+function extractJson(text) {
+    const trimmed = text.trim();
+    try {
+        return JSON.parse(trimmed);
+    }
+    catch {
+        let depth = 0;
+        let escaped = false;
+        let inString = false;
+        let start = -1;
+        const candidates = [];
+        for (let index = 0; index < trimmed.length; index += 1) {
+            const char = trimmed[index];
+            if (escaped) {
+                escaped = false;
+                continue;
+            }
+            if (char === "\\" && inString) {
+                escaped = true;
+                continue;
+            }
+            if (char === '"') {
+                inString = !inString;
+                continue;
+            }
+            if (inString)
+                continue;
+            if (char === "{") {
+                if (depth === 0)
+                    start = index;
+                depth += 1;
+                continue;
+            }
+            if (char !== "}" || depth === 0)
+                continue;
+            depth -= 1;
+            if (depth === 0 && start !== -1) {
+                candidates.push(trimmed.slice(start, index + 1));
+                start = -1;
+            }
+        }
+        for (const candidate of candidates.reverse()) {
+            try {
+                return JSON.parse(candidate);
+            }
+            catch {
+                // Keep scanning older JSON-looking blocks; prompts may include examples.
+            }
+        }
+        throw new Error("output does not contain a valid JSON object");
+    }
+}
+function isVerdict(value) {
+    return value === "MERGE" || value === "CHANGES_REQUESTED" || value === "CLOSE";
+}
+function isEditResponseAction(value) {
+    return value === "FIXED" || value === "DISAGREE" || value === "ASK";
+}
+function requireArray(value, path) {
+    if (!Array.isArray(value))
+        throw new Error(`${path} must be an array`);
+    return value;
+}
+function requireString(value, path) {
+    if (typeof value !== "string" || !value)
+        throw new Error(`${path} must be a non-empty string`);
+    return value;
+}
+function requireNumber(value, path) {
+    if (typeof value !== "number" || !Number.isInteger(value))
+        throw new Error(`${path} must be an integer`);
+    return value;
+}
+export function parseReviewOutput(text) {
+    const data = extractJson(text);
+    if (!data || typeof data !== "object")
+        throw new Error("review output must be an object");
+    if (!isVerdict(data.verdict))
+        throw new Error("verdict must be MERGE, CHANGES_REQUESTED, or CLOSE");
+    const findings = requireArray(data.findings, "findings").map((finding, index) => {
+        const item = finding;
+        return {
+            fix: requireString(item.fix, `findings[${index}].fix`),
+            issue: requireString(item.issue, `findings[${index}].issue`),
+            line: requireNumber(item.line, `findings[${index}].line`),
+            path: requireString(item.path, `findings[${index}].path`),
+            perspective: item.perspective == null
+                ? undefined
+                : requireString(item.perspective, `findings[${index}].perspective`),
+            startLine: item.startLine == null
+                ? undefined
+                : requireNumber(item.startLine, `findings[${index}].startLine`),
+        };
+    });
+    if (data.verdict === "MERGE" && findings.length)
+        throw new Error("MERGE requires no findings");
+    if (data.verdict === "CHANGES_REQUESTED" && !findings.length)
+        throw new Error("CHANGES_REQUESTED requires findings");
+    if (data.verdict === "CLOSE" && findings.length)
+        throw new Error("CLOSE requires no findings");
+    const reason = typeof data.reason === "string" && data.reason.trim()
+        ? data.reason
+        : undefined;
+    if (data.verdict === "CLOSE" && !reason)
+        throw new Error("CLOSE requires reason");
+    return {
+        findings,
+        reason,
+        verdict: data.verdict,
+    };
+}
+export function parseRereviewOutput(text) {
+    const data = extractJson(text);
+    if (!isVerdict(data.verdict))
+        throw new Error("rereview verdict must be MERGE, CHANGES_REQUESTED, or CLOSE");
+    const resolve = requireArray(data.resolve, "resolve").map((item, index) => {
+        const value = item;
+        return {
+            commentId: requireNumber(value.commentId, `resolve[${index}].commentId`),
+            threadId: requireString(value.threadId, `resolve[${index}].threadId`),
+        };
+    });
+    const followUps = requireArray(data.followUps, "followUps").map((item, index) => {
+        const value = item;
+        return {
+            body: requireString(value.body, `followUps[${index}].body`),
+            commentId: requireNumber(value.commentId, `followUps[${index}].commentId`),
+        };
+    });
+    const newFindings = requireArray(data.newFindings, "newFindings").map((item, index) => {
+        const value = item;
+        return {
+            body: requireString(value.body, `newFindings[${index}].body`),
+            line: requireNumber(value.line, `newFindings[${index}].line`),
+            path: requireString(value.path, `newFindings[${index}].path`),
+            startLine: value.startLine == null
+                ? undefined
+                : requireNumber(value.startLine, `newFindings[${index}].startLine`),
+        };
+    });
+    if (data.verdict === "MERGE" && (followUps.length || newFindings.length)) {
+        throw new Error("MERGE requires no followUps or newFindings");
+    }
+    if (data.verdict === "CLOSE" && (followUps.length || newFindings.length)) {
+        throw new Error("CLOSE requires no followUps or newFindings");
+    }
+    if (data.verdict === "CLOSE" && !data.reason) {
+        throw new Error("CLOSE requires reason");
+    }
+    if (data.verdict === "CHANGES_REQUESTED" &&
+        !followUps.length &&
+        !newFindings.length) {
+        throw new Error("CHANGES_REQUESTED requires followUps or newFindings");
+    }
+    return {
+        followUps,
+        newFindings,
+        reason: data.reason == null ? undefined : requireString(data.reason, "reason"),
+        resolve,
+        verdict: data.verdict,
+    };
+}
+export function parseFindingValidationOutput(text) {
+    const data = extractJson(text);
+    if (!data || typeof data !== "object")
+        throw new Error("finding validation output must be an object");
+    return {
+        votes: requireArray(data.votes, "votes").map((item, index) => {
+            const value = item;
+            const vote = requireString(value.vote, `votes[${index}].vote`);
+            if (vote !== "AGREE" && vote !== "DISAGREE")
+                throw new Error(`votes[${index}].vote must be AGREE or DISAGREE`);
+            return {
+                findingIndex: requireNumber(value.findingIndex, `votes[${index}].findingIndex`),
+                reason: value.reason == null
+                    ? undefined
+                    : requireString(value.reason, `votes[${index}].reason`),
+                reviewer: requireString(value.reviewer, `votes[${index}].reviewer`),
+                vote,
+            };
+        }),
+    };
+}
+export function parseCloseReconsiderationOutput(text) {
+    const output = parseReviewOutput(text);
+    if (output.verdict === "CLOSE")
+        throw new Error("close reconsideration must be MERGE or CHANGES_REQUESTED");
+    return output;
+}
+export function parseRereviewCloseReconsiderationOutput(text) {
+    const output = parseRereviewOutput(text);
+    if (output.verdict === "CLOSE")
+        throw new Error("rereview close reconsideration must be MERGE or CHANGES_REQUESTED");
+    return output;
+}
+export function parseCiClassificationOutput(text) {
+    const data = extractJson(text);
+    if (!data || typeof data !== "object")
+        throw new Error("CI classification output must be an object");
+    return {
+        checks: requireArray(data.checks, "checks").map((item, index) => {
+            const value = item;
+            const classification = requireString(value.classification, `checks[${index}].classification`);
+            if (classification !== "SCOPE_IN" && classification !== "SCOPE_OUT") {
+                throw new Error(`checks[${index}].classification must be SCOPE_IN or SCOPE_OUT`);
+            }
+            return {
+                classification,
+                name: requireString(value.name, `checks[${index}].name`),
+                reason: requireString(value.reason, `checks[${index}].reason`),
+            };
+        }),
+    };
+}
+export function parseEditOutput(text) {
+    const data = extractJson(text);
+    if (!data || typeof data !== "object")
+        throw new Error("edit output must be an object");
+    if (data.mode !== "EDITED" && data.mode !== "REPLIED")
+        throw new Error("mode must be EDITED or REPLIED");
+    const filesTouched = requireArray(data.filesTouched, "filesTouched").map((file, index) => requireString(file, `filesTouched[${index}]`));
+    const responses = requireArray(data.responses, "responses").map((item, index) => {
+        const value = item;
+        if (!isEditResponseAction(value.action)) {
+            throw new Error(`responses[${index}].action must be FIXED, DISAGREE, or ASK`);
+        }
+        return {
+            action: value.action,
+            body: requireString(value.body, `responses[${index}].body`),
+            commentId: requireNumber(value.commentId, `responses[${index}].commentId`),
+        };
+    });
+    if (!responses.length)
+        throw new Error("responses must not be empty");
+    if (data.mode === "EDITED") {
+        if (!filesTouched.length)
+            throw new Error("EDITED requires filesTouched");
+        return {
+            commitMessage: requireString(data.commitMessage, "commitMessage"),
+            commitSha: requireString(data.commitSha, "commitSha"),
+            filesTouched,
+            mode: data.mode,
+            responses,
+        };
+    }
+    if (data.commitMessage != null)
+        throw new Error("REPLIED must omit commitMessage");
+    if (data.commitSha != null)
+        throw new Error("REPLIED must omit commitSha");
+    if (filesTouched.length)
+        throw new Error("REPLIED requires empty filesTouched");
+    if (responses.some((response) => response.action === "FIXED")) {
+        throw new Error("REPLIED cannot include FIXED responses");
+    }
+    return {
+        filesTouched,
+        mode: data.mode,
+        responses,
+    };
+}

package/dist/prompts/templates/ci-classification-after-edit.md

@@ -0,0 +1,16 @@
+Classify failed CI jobs after editor changes for pull request #{pr} in {owner}/{repo}.
+This is edit cycle {cycle}.
+
+The editor changed the PR from {previousHeadSha} to {headSha}.
+The PR worktree is {worktreePath}.
+Use this diff for context: git -C {jsonEncodedWorktreePath} diff {previousHeadSha}...{headSha}
+
+Decide whether each failure is caused by the PR/editor changes or is likely flaky, external, or infrastructure-related.
+Treat failures that appeared after the editor changes as SCOPE_IN unless there is strong evidence they are unrelated.
+If uncertain, choose SCOPE_IN.
+
+Failed checks with structured failure evidence:
+
+```json
+{failedChecks}
+```

package/dist/prompts/templates/ci-classification.md

@@ -0,0 +1,9 @@
+Classify failed CI jobs for pull request #{pr} in {owner}/{repo}.
+Decide whether each failure is caused by the PR changes or is likely flaky, external, or infrastructure-related.
+If uncertain, choose SCOPE_IN.
+
+Failed checks with structured failure evidence:
+
+```json
+{failedChecks}
+```

package/dist/prompts/templates/close-reconsideration.md

@@ -0,0 +1,6 @@
+You requested CLOSE for pull request #{pr} in {owner}/{repo}, but the other reviewers did not.
+Reconsider your decision and choose MERGE or CHANGES_REQUESTED instead.
+Use the existing review session context.
+Original close reason:
+{closeReason}
+Do not edit files or perform write operations.

package/dist/prompts/templates/edit.md

@@ -0,0 +1,9 @@
+Fix pull request #{pr} for {owner}/{repo}.
+The PR worktree is {worktreePath}.
+Act as the PR author and resolve every unresolved review thread listed below.
+{unresolvedThreads}
+For each thread, decide whether you agree with the reviewer.
+If you understand and agree with the requested change, edit the code, stage changes, commit, and reply with action FIXED.
+If the requested change is incorrect or unnecessary and you have a clear reason, do not edit for that thread; reply with action DISAGREE and explain why.
+If you cannot determine whether the request is correct or what change is expected, do not blindly edit; reply with action ASK and ask a concrete question.
+Do not make changes just because a reviewer requested them. Do not push.

package/dist/prompts/templates/finding-validation.md

@@ -0,0 +1,7 @@
+Validate review findings for pull request #{pr} in {owner}/{repo}.
+Use the existing review session context.
+Vote on whether each listed finding is a valid reason to request changes.
+Do not edit files or perform write operations.
+
+Findings to validate:
+{findings}

package/dist/prompts/templates/rereview-close-reconsideration.md

@@ -0,0 +1,6 @@
+You requested CLOSE while re-reviewing pull request #{pr} in {owner}/{repo}, but the other reviewers did not.
+Reconsider your decision and choose MERGE or CHANGES_REQUESTED instead.
+Use the existing re-review session context.
+Original close reason:
+{closeReason}
+Do not edit files or perform write operations.

package/dist/prompts/templates/rereview.md

@@ -0,0 +1,16 @@
+Re-review pull request #{pr} for {owner}/{repo}.
+The PR worktree is {worktreePath}.
+Validate whether your unresolved comments are fixed in the diff from {previousHeadSha} to {headSha} and in the review thread conversation.
+Use: git -C {jsonEncodedWorktreePath} diff {previousHeadSha}...{headSha}
+Your unresolved threads are provided as JSON below.
+{unresolvedThreads}
+
+If there is no new commit, still reconsider the thread when a user replied after your latest comment.
+If you agree with the user's explanation or the code is fixed, resolve the thread.
+If you do not agree, reply in the same thread with a followUp explaining why the issue still needs changes and keep CHANGES_REQUESTED.
+Do not duplicate an existing unresolved thread as a newFinding. Use newFindings only for separate new issues.
+
+{ciFailureContextBlock}
+Do not edit files or perform write operations.
+
+{previousReviewBlock}

package/dist/prompts/templates/review.md

@@ -0,0 +1,7 @@
+Review pull request #{pr} for {owner}/{repo}.
+The PR worktree is {worktreePath}.
+Review only the diff from {baseSha} to {headSha}.
+Use: git -C {jsonEncodedWorktreePath} diff {baseSha}...{headSha}
+Do not edit files or perform write operations.
+
+{ciFailureContextBlock}

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "opencode-magi",
+  "version": "0.1.0",
+  "description": "Multi-agent PR review and merge orchestration plugin for OpenCode.",
+  "license": "MIT",
+  "author": "Hirotomo Yamada <hirotomo.yamada@avap.co.jp>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hirotomoyamada/opencode-magi"
+  },
+  "bugs": {
+    "url": "https://github.com/hirotomoyamada/opencode-magi/issues"
+  },
+  "keywords": [
+    "opencode",
+    "plugin",
+    "github",
+    "pull-request",
+    "review"
+  ],
+  "engines": {
+    "node": ">=24.14"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "files": [
+    "dist",
+    "schema.json"
+  ],
+  "packageManager": "pnpm@10.33.0",
+  "scripts": {
+    "prebuild": "node scripts/copy-data.ts",
+    "build": "tsgo -p tsconfig.build.json",
+    "clean": "rimraf node_modules dist coverage",
+    "format:check": "oxfmt --check .",
+    "format:write": "oxfmt --write .",
+    "lint:check": "oxlint . --max-warnings=0",
+    "lint:fix": "oxlint . --max-warnings=0 --fix",
+    "prepare": "git rev-parse --is-inside-work-tree >/dev/null 2>&1 && lefthook install || true",
+    "quality": "pnpm format:check && pnpm lint:check && pnpm typecheck && pnpm test",
+    "test": "vitest run",
+    "typecheck": "tsgo --noEmit",
+    "release": "changeset publish",
+    "release:version": "changeset version"
+  },
+  "dependencies": {
+    "@opencode-ai/plugin": "latest",
+    "ajv": "^8.20.0",
+    "picomatch": "^4.0.4",
+    "valibot": "^1.4.0"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.7.0",
+    "@changesets/cli": "^2.30.0",
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@types/node": "^25.7.0",
+    "@types/picomatch": "^4.0.3",
+    "@typescript/native-preview": "7.0.0-dev.20260513.1",
+    "eslint-plugin-perfectionist": "^5.9.0",
+    "eslint-plugin-unused-imports": "^4.4.1",
+    "lefthook": "^2.1.6",
+    "oxfmt": "^0.49.0",
+    "oxlint": "^1.64.0",
+    "oxlint-tsgolint": "^0.22.1",
+    "rimraf": "^6.1.3",
+    "vitest": "^4.1.5"
+  }
+}

package/schema.json

@@ -0,0 +1,200 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://opencode-magi.local/schema.json",
+  "type": "object",
+  "additionalProperties": false,
+  "properties": {
+    "$schema": { "type": "string" },
+    "agents": { "$ref": "#/$defs/agents" },
+    "automation": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "merge": { "type": "boolean", "default": true },
+        "close": { "type": "boolean", "default": true }
+      }
+    },
+    "clear": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "output": { "type": "boolean", "default": true },
+        "worktree": { "type": "boolean", "default": true },
+        "session": { "type": "boolean", "default": true },
+        "branch": { "type": "boolean", "default": true }
+      }
+    },
+    "checks": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "exclude": { "type": "array", "items": { "type": "string" } },
+        "waitAfterEdit": { "type": "boolean" },
+        "waitBeforeReview": { "type": "boolean" },
+        "retryFailedJobs": { "type": "integer", "minimum": 0, "default": 3 }
+      }
+    },
+    "concurrency": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "runs": { "type": "integer", "minimum": 1, "default": 3 },
+        "reviewers": { "type": "integer", "minimum": 1, "default": 3 }
+      }
+    },
+    "github": {
+      "type": "object",
+      "required": ["owner", "repo"],
+      "additionalProperties": false,
+      "properties": {
+        "host": { "type": "string", "default": "github.com" },
+        "apiRetryAttempts": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 3,
+          "description": "Number of retry attempts for GitHub CLI API calls that fail with rate limit errors."
+        },
+        "owner": { "type": "string", "minLength": 1 },
+        "repo": { "type": "string", "minLength": 1 }
+      }
+    },
+    "language": { "type": "string" },
+    "merge": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "approvalPolicy": {
+          "enum": ["majority", "unanimous"],
+          "default": "majority"
+        },
+        "method": { "enum": ["merge", "squash", "rebase"] },
+        "auto": { "type": "boolean" },
+        "deleteBranch": { "type": "boolean" },
+        "mergeQueue": { "type": "boolean", "default": false },
+        "maxThreadResolutionCycles": {
+          "type": "integer",
+          "minimum": 0,
+          "default": 5,
+          "description": "Maximum resolution attempts per unresolved review thread. Set 0 for unlimited attempts."
+        }
+      }
+    },
+    "output": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "dirs": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "pr": { "type": "string" }
+          }
+        },
+        "repairAttempts": { "type": "integer", "minimum": 0, "default": 3 }
+      }
+    },
+    "prompts": { "$ref": "#/$defs/prompts" },
+    "safety": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "allowAuthors": { "type": "array", "items": { "type": "string" } },
+        "blockedPaths": { "type": "array", "items": { "type": "string" } },
+        "maxChangedFiles": { "type": "integer", "minimum": 0 },
+        "requiredLabels": { "type": "array", "items": { "type": "string" } }
+      }
+    },
+    "worktree": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "dir": { "type": "string" }
+      }
+    }
+  },
+  "$defs": {
+    "reviewer": {
+      "type": "object",
+      "required": ["model", "account"],
+      "additionalProperties": false,
+      "properties": {
+        "id": { "type": "string", "pattern": "^[A-Za-z0-9_-]+$" },
+        "model": { "type": "string", "minLength": 1 },
+        "options": { "type": "object", "additionalProperties": true },
+        "account": { "type": "string", "minLength": 1 },
+        "permission": { "$ref": "#/$defs/permission" },
+        "persona": { "type": "string" }
+      }
+    },
+    "editor": {
+      "type": "object",
+      "required": ["model", "account", "author"],
+      "additionalProperties": false,
+      "properties": {
+        "model": { "type": "string", "minLength": 1 },
+        "options": { "type": "object", "additionalProperties": true },
+        "account": { "type": "string", "minLength": 1 },
+        "author": {
+          "type": "object",
+          "required": ["name", "email"],
+          "additionalProperties": false,
+          "properties": {
+            "name": { "type": "string", "minLength": 1 },
+            "email": { "type": "string", "minLength": 1 }
+          }
+        },
+        "permission": { "$ref": "#/$defs/permission" },
+        "persona": { "type": "string" }
+      }
+    },
+    "agents": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "permissions": { "$ref": "#/$defs/permission" },
+        "reviewers": {
+          "type": "array",
+          "minItems": 3,
+          "items": { "$ref": "#/$defs/reviewer" }
+        },
+        "editor": { "$ref": "#/$defs/editor" }
+      }
+    },
+    "permissionAction": { "enum": ["allow", "ask", "deny"] },
+    "permissionRule": {
+      "oneOf": [
+        { "$ref": "#/$defs/permissionAction" },
+        {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/permissionAction" }
+        }
+      ]
+    },
+    "permission": {
+      "oneOf": [
+        { "$ref": "#/$defs/permissionAction" },
+        {
+          "type": "object",
+          "additionalProperties": { "$ref": "#/$defs/permissionRule" }
+        }
+      ]
+    },
+    "prompts": {
+      "type": "object",
+      "additionalProperties": false,
+      "properties": {
+        "review": { "type": "string" },
+        "rereview": { "type": "string" },
+        "edit": { "type": "string" },
+        "editGuidelines": { "type": "string" },
+        "findingValidation": { "type": "string" },
+        "closeReconsideration": { "type": "string" },
+        "rereviewCloseReconsideration": { "type": "string" },
+        "ciClassification": { "type": "string" },
+        "ciClassificationAfterEdit": { "type": "string" },
+        "report": { "type": "string" },
+        "reviewGuidelines": { "type": "string" }
+      }
+    }
+  }
+}