opencode-review-helper 0.1.6 → 0.3.0

package/README.md

@@ -21,11 +21,27 @@ Restart opencode after setup to load the plugin. The plugin uses `@latest` so it
 
 ## Usage
 
-The plugin provides a `review-helper` agent that combines both tools. It:
+### Slash Command: `/review-order`
 
-1. Runs `review_order` to determine file review sequence
-2. Runs `impact_analysis` to find affected external code
-3. Formats the tool outputs into a combined report
+The quickest way to use this plugin:
+
+```
+/review-order
+```
+
+This runs the full workflow:
+1. Analyzes changed files and determines initial review order
+2. Finds external files impacted by the changes
+3. Merges everything into a single prioritized list
+
+Output is a unified table showing all files to review, with changed files first (prioritized by dependencies and impact) followed by external files that may need attention.
+
+### Agent: `review-helper`
+
+The plugin provides a `review-helper` agent that orchestrates two subagents:
+
+- `review-helper:review-order` - Determines optimal file review order
+- `review-helper:impact-explorer` - Finds external code impacted by changes
 
 The agent does NOT make up its own recommendations or analysis—it only presents what the tools return. It also does NOT automatically run tests or apply fixes.
 
@@ -77,10 +93,15 @@ The plugin also exposes two tools directly:
 
 Suggests optimal order to review changed files.
 
+Arguments:
+- `files` (optional): Specific files to analyze. If omitted, uses git diff.
+- `instructions` (optional): Custom ordering instructions
+- `impact_data` (optional): Impact analysis results to merge external files into the list
+
 Output:
 - Prioritized file list with rationale
 - Dependency graph showing import relationships
-- Scores based on: type priority, dependents count, complexity
+- Scores based on: type priority, dependents count, complexity, external impact
 
 ### `impact_analysis`
 

package/dist/agents/impact-explorer.d.ts

@@ -0,0 +1,13 @@
+export declare const IMPACT_EXPLORER_DESCRIPTION = "Subagent that analyzes external impact using the impact_analysis tool.";
+export declare const IMPACT_EXPLORER_PROMPT = "You run the impact_analysis tool and return its output.\n\n## Usage\nCall the impact_analysis tool. It will:\n- Find all git-changed files\n- Identify external files that import/use the changed code\n- Report direct consumers and transitive dependencies\n\n## Output\nReturn the tool output verbatim. Do not add commentary.\n\n## Structured Output for Orchestrator\nWhen the orchestrator needs structured data for merging, extract and return:\n\n```json\n{\n  \"direct\": [\n    { \"file\": \"path/to/consumer.ts\", \"line\": 15, \"type\": \"import\" }\n  ],\n  \"transitive\": [\n    { \"file\": \"path/to/indirect.ts\", \"line\": 42, \"type\": \"via path/to/consumer.ts\" }\n  ]\n}\n```";
+export declare const createImpactExplorerAgent: (model: string) => {
+    description: string;
+    mode: "subagent";
+    model: string;
+    color: string;
+    prompt: string;
+    tools: {
+        impact_analysis: boolean;
+    };
+};
+//# sourceMappingURL=impact-explorer.d.ts.map

package/dist/agents/impact-explorer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-explorer.d.ts","sourceRoot":"","sources":["../../src/agents/impact-explorer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,2BAA2B,2EAA2E,CAAC;AAEpH,eAAO,MAAM,sBAAsB,qrBAuB5B,CAAC;AAER,eAAO,MAAM,yBAAyB,GAAI,OAAO,MAAM;;;;;;;;;CASrD,CAAC"}

package/dist/agents/impact-explorer.js

@@ -0,0 +1,36 @@
+export const IMPACT_EXPLORER_DESCRIPTION = `Subagent that analyzes external impact using the impact_analysis tool.`;
+export const IMPACT_EXPLORER_PROMPT = `You run the impact_analysis tool and return its output.
+
+## Usage
+Call the impact_analysis tool. It will:
+- Find all git-changed files
+- Identify external files that import/use the changed code
+- Report direct consumers and transitive dependencies
+
+## Output
+Return the tool output verbatim. Do not add commentary.
+
+## Structured Output for Orchestrator
+When the orchestrator needs structured data for merging, extract and return:
+
+\`\`\`json
+{
+  "direct": [
+    { "file": "path/to/consumer.ts", "line": 15, "type": "import" }
+  ],
+  "transitive": [
+    { "file": "path/to/indirect.ts", "line": 42, "type": "via path/to/consumer.ts" }
+  ]
+}
+\`\`\``;
+export const createImpactExplorerAgent = (model) => ({
+    description: IMPACT_EXPLORER_DESCRIPTION,
+    mode: "subagent",
+    model,
+    color: "#00CED1",
+    prompt: IMPACT_EXPLORER_PROMPT,
+    tools: {
+        impact_analysis: true,
+    },
+});
+//# sourceMappingURL=impact-explorer.js.map

package/dist/agents/impact-explorer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-explorer.js","sourceRoot":"","sources":["../../src/agents/impact-explorer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,2BAA2B,GAAG,wEAAwE,CAAC;AAEpH,MAAM,CAAC,MAAM,sBAAsB,GAAG;;;;;;;;;;;;;;;;;;;;;;;OAuB/B,CAAC;AAER,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC;IAC3D,WAAW,EAAE,2BAA2B;IACxC,IAAI,EAAE,UAAmB;IACzB,KAAK;IACL,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,sBAAsB;IAC9B,KAAK,EAAE;QACL,eAAe,EAAE,IAAI;KACtB;CACF,CAAC,CAAC"}

package/dist/agents/index.d.ts

@@ -0,0 +1,4 @@
+export { reviewHelperAgent } from "./review-helper.js";
+export { createReviewOrderAgent } from "./review-order.js";
+export { createImpactExplorerAgent } from "./impact-explorer.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/agents/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/agents/index.js

@@ -0,0 +1,4 @@
+export { reviewHelperAgent } from "./review-helper.js";
+export { createReviewOrderAgent } from "./review-order.js";
+export { createImpactExplorerAgent } from "./impact-explorer.js";
+//# sourceMappingURL=index.js.map

package/dist/agents/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/agents/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/agents/review-helper.d.ts

@@ -0,0 +1,12 @@
+export declare const REVIEW_HELPER_DESCRIPTION = "Comprehensive code reviewer for AI-generated changes. Analyzes:\n- Optimal review order based on file dependencies\n- Impact on code outside the changeset (transitive)\n\nDoes NOT automatically run tests or fix code. For debugging help, explicitly ask.\n\nExamples:\n<example>\nContext: User completed AI-assisted implementation\nuser: \"Review the changes Claude just made\"\nassistant: \"I'll analyze the changes for review order and impact.\"\n</example>\n\n<example>\nContext: Large PR review\nuser: \"What should I look at first in this PR?\"\nassistant: \"I'll determine the optimal review order based on dependencies.\"\n</example>\n\n<example>\nContext: Concern about breaking changes\nuser: \"What else might this break?\"\nassistant: \"I'll analyze transitive impact on code outside these changes.\"\n</example>";
+export declare const REVIEW_HELPER_PROMPT = "You are a code review orchestrator that coordinates subagents to produce a unified review order.\n\n## Workflow\n\nWhen invoked (especially via /review-order), execute this sequence:\n\n### Step 1: Get Initial Review Order\nSpawn the `review-helper:review-order` subagent:\n- It runs the review_order tool on changed files\n- Returns a prioritized file list\n\n### Step 2: Get Impact Analysis\nSpawn the `review-helper:impact-explorer` subagent:\n- It runs the impact_analysis tool\n- Returns external files that depend on the changed code\n\n### Step 3: Get Final Merged Order\nSpawn `review-helper:review-order` again, passing the impact data:\n- Provide the impact analysis results as impact_data argument\n- It merges external files into the list\n- It boosts priority for files with high external impact\n- Returns the final unified review order\n\n### Step 4: Present Results\nOutput ONLY the final merged review order table. Do not add commentary.\n\n## Output Format\n\nPresent a single table:\n\n| # | File | Reason | Score |\n|---|------|--------|-------|\n| 1 | `path/to/file.ts` | Foundation file; 3 external consumers | 85 |\n| 2 | `path/to/other.ts` | Type priority: 7 | 70 |\n| 3 | `external/consumer.ts` *(external)* | External: imports changed code | 25 |\n\nThat's it. One unified table with all files to review.";
+export declare const reviewHelperAgent: {
+    description: string;
+    mode: "primary";
+    color: string;
+    prompt: string;
+    tools: {
+        task: boolean;
+    };
+};
+//# sourceMappingURL=review-helper.d.ts.map

package/dist/agents/review-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-helper.d.ts","sourceRoot":"","sources":["../../src/agents/review-helper.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,yBAAyB,0zBAuB3B,CAAC;AAEZ,eAAO,MAAM,oBAAoB,uzCAoCsB,CAAC;AAExD,eAAO,MAAM,iBAAiB;;;;;;;;CAQ7B,CAAC"}

package/dist/agents/review-helper.js

@@ -0,0 +1,71 @@
+export const REVIEW_HELPER_DESCRIPTION = `Comprehensive code reviewer for AI-generated changes. Analyzes:
+- Optimal review order based on file dependencies
+- Impact on code outside the changeset (transitive)
+
+Does NOT automatically run tests or fix code. For debugging help, explicitly ask.
+
+Examples:
+<example>
+Context: User completed AI-assisted implementation
+user: "Review the changes Claude just made"
+assistant: "I'll analyze the changes for review order and impact."
+</example>
+
+<example>
+Context: Large PR review
+user: "What should I look at first in this PR?"
+assistant: "I'll determine the optimal review order based on dependencies."
+</example>
+
+<example>
+Context: Concern about breaking changes
+user: "What else might this break?"
+assistant: "I'll analyze transitive impact on code outside these changes."
+</example>`;
+export const REVIEW_HELPER_PROMPT = `You are a code review orchestrator that coordinates subagents to produce a unified review order.
+
+## Workflow
+
+When invoked (especially via /review-order), execute this sequence:
+
+### Step 1: Get Initial Review Order
+Spawn the \`review-helper:review-order\` subagent:
+- It runs the review_order tool on changed files
+- Returns a prioritized file list
+
+### Step 2: Get Impact Analysis
+Spawn the \`review-helper:impact-explorer\` subagent:
+- It runs the impact_analysis tool
+- Returns external files that depend on the changed code
+
+### Step 3: Get Final Merged Order
+Spawn \`review-helper:review-order\` again, passing the impact data:
+- Provide the impact analysis results as impact_data argument
+- It merges external files into the list
+- It boosts priority for files with high external impact
+- Returns the final unified review order
+
+### Step 4: Present Results
+Output ONLY the final merged review order table. Do not add commentary.
+
+## Output Format
+
+Present a single table:
+
+| # | File | Reason | Score |
+|---|------|--------|-------|
+| 1 | \`path/to/file.ts\` | Foundation file; 3 external consumers | 85 |
+| 2 | \`path/to/other.ts\` | Type priority: 7 | 70 |
+| 3 | \`external/consumer.ts\` *(external)* | External: imports changed code | 25 |
+
+That's it. One unified table with all files to review.`;
+export const reviewHelperAgent = {
+    description: REVIEW_HELPER_DESCRIPTION,
+    mode: "primary",
+    color: "#FF6B6B",
+    prompt: REVIEW_HELPER_PROMPT,
+    tools: {
+        task: true,
+    },
+};
+//# sourceMappingURL=review-helper.js.map

package/dist/agents/review-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-helper.js","sourceRoot":"","sources":["../../src/agents/review-helper.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,yBAAyB,GAAG;;;;;;;;;;;;;;;;;;;;;;;WAuB9B,CAAC;AAEZ,MAAM,CAAC,MAAM,oBAAoB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;uDAoCmB,CAAC;AAExD,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,WAAW,EAAE,yBAAyB;IACtC,IAAI,EAAE,SAAkB;IACxB,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,oBAAoB;IAC5B,KAAK,EAAE;QACL,IAAI,EAAE,IAAI;KACX;CACF,CAAC"}

package/dist/agents/review-order.d.ts

@@ -0,0 +1,13 @@
+export declare const REVIEW_ORDER_DESCRIPTION = "Subagent that determines optimal file review order using the review_order tool.";
+export declare const REVIEW_ORDER_PROMPT = "You run the review_order tool and return its output.\n\n## Basic Usage\nCall the review_order tool with no arguments to analyze git diff.\n\n## With Impact Data\nIf you receive impact_data in your prompt, pass it to the review_order tool:\n\n```\nreview_order({ impact_data: { direct: [...], transitive: [...] } })\n```\n\nThe tool will:\n- Merge external impacted files into the review list\n- Boost priority for files with many external consumers\n- Mark external files appropriately\n\n## Output\nReturn the tool output verbatim. Do not add commentary.";
+export declare const createReviewOrderAgent: (model: string) => {
+    description: string;
+    mode: "subagent";
+    model: string;
+    color: string;
+    prompt: string;
+    tools: {
+        review_order: boolean;
+    };
+};
+//# sourceMappingURL=review-order.d.ts.map

package/dist/agents/review-order.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-order.d.ts","sourceRoot":"","sources":["../../src/agents/review-order.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,oFAAoF,CAAC;AAE1H,eAAO,MAAM,mBAAmB,gjBAkBwB,CAAC;AAEzD,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM;;;;;;;;;CASlD,CAAC"}

package/dist/agents/review-order.js

@@ -0,0 +1,31 @@
+export const REVIEW_ORDER_DESCRIPTION = `Subagent that determines optimal file review order using the review_order tool.`;
+export const REVIEW_ORDER_PROMPT = `You run the review_order tool and return its output.
+
+## Basic Usage
+Call the review_order tool with no arguments to analyze git diff.
+
+## With Impact Data
+If you receive impact_data in your prompt, pass it to the review_order tool:
+
+\`\`\`
+review_order({ impact_data: { direct: [...], transitive: [...] } })
+\`\`\`
+
+The tool will:
+- Merge external impacted files into the review list
+- Boost priority for files with many external consumers
+- Mark external files appropriately
+
+## Output
+Return the tool output verbatim. Do not add commentary.`;
+export const createReviewOrderAgent = (model) => ({
+    description: REVIEW_ORDER_DESCRIPTION,
+    mode: "subagent",
+    model,
+    color: "#4ECDC4",
+    prompt: REVIEW_ORDER_PROMPT,
+    tools: {
+        review_order: true,
+    },
+});
+//# sourceMappingURL=review-order.js.map

package/dist/agents/review-order.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"review-order.js","sourceRoot":"","sources":["../../src/agents/review-order.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,iFAAiF,CAAC;AAE1H,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;wDAkBqB,CAAC;AAEzD,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,KAAa,EAAE,EAAE,CAAC,CAAC;IACxD,WAAW,EAAE,wBAAwB;IACrC,IAAI,EAAE,UAAmB;IACzB,KAAK;IACL,KAAK,EAAE,SAAS;IAChB,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE;QACL,YAAY,EAAE,IAAI;KACnB;CACF,CAAC,CAAC"}

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAIlD,eAAO,MAAM,kBAAkB,EAAE,MAOhC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAUlD,eAAO,MAAM,kBAAkB,EAAE,MA4BhC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/index.js

@@ -1,11 +1,31 @@
 import { reviewOrderTool } from "./tools/review-order.js";
 import { impactAnalysisTool } from "./tools/impact-analysis.js";
+import { loadConfig } from "./config.js";
+import { reviewHelperAgent, createReviewOrderAgent, createImpactExplorerAgent, } from "./agents/index.js";
 export const ReviewHelperPlugin = async ({ project, client, $, directory }) => {
     return {
         tool: {
             review_order: reviewOrderTool,
             impact_analysis: impactAnalysisTool,
         },
+        config: async (openCodeConfig) => {
+            const pluginConfig = await loadConfig(directory);
+            const explorerModel = pluginConfig.models?.explorer ?? "google/gemini-3-flash";
+            openCodeConfig.agent = {
+                ...openCodeConfig.agent,
+                "review-helper": reviewHelperAgent,
+                "review-helper:review-order": createReviewOrderAgent(explorerModel),
+                "review-helper:impact-explorer": createImpactExplorerAgent(explorerModel),
+            };
+            openCodeConfig.command = {
+                ...openCodeConfig.command,
+                "review-order": {
+                    template: "Run the review-order workflow: get initial file order, analyze impact, then produce final prioritized review order with external impacted files merged in.",
+                    description: "Get optimal file review order with impact analysis",
+                    agent: "review-helper",
+                },
+            };
+        },
     };
 };
 export default ReviewHelperPlugin;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,CAAC,MAAM,kBAAkB,GAAW,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;IACpF,OAAO;QACL,IAAI,EAAE;YACJ,YAAY,EAAE,eAAe;YAC7B,eAAe,EAAE,kBAAkB;SACpC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EACL,iBAAiB,EACjB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,CAAC,MAAM,kBAAkB,GAAW,KAAK,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,EAAE,SAAS,EAAE,EAAE,EAAE;IACpF,OAAO;QACL,IAAI,EAAE;YACJ,YAAY,EAAE,eAAe;YAC7B,eAAe,EAAE,kBAAkB;SACpC;QAED,MAAM,EAAE,KAAK,EAAE,cAAc,EAAE,EAAE;YAC/B,MAAM,YAAY,GAAG,MAAM,UAAU,CAAC,SAAS,CAAC,CAAC;YACjD,MAAM,aAAa,GAAG,YAAY,CAAC,MAAM,EAAE,QAAQ,IAAI,uBAAuB,CAAC;YAE/E,cAAc,CAAC,KAAK,GAAG;gBACrB,GAAG,cAAc,CAAC,KAAK;gBACvB,eAAe,EAAE,iBAAiB;gBAClC,4BAA4B,EAAE,sBAAsB,CAAC,aAAa,CAAC;gBACnE,+BAA+B,EAAE,yBAAyB,CAAC,aAAa,CAAC;aAC1E,CAAC;YAEF,cAAc,CAAC,OAAO,GAAG;gBACvB,GAAG,cAAc,CAAC,OAAO;gBACzB,cAAc,EAAE;oBACd,QAAQ,EAAE,4JAA4J;oBACtK,WAAW,EAAE,oDAAoD;oBACjE,KAAK,EAAE,eAAe;iBACvB;aACF,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC,CAAC;AAEF,eAAe,kBAAkB,CAAC"}

package/dist/tools/review-order.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"review-order.d.ts","sourceRoot":"","sources":["../../src/tools/review-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AA2HrE,eAAO,MAAM,eAAe,EAAE,cAmF5B,CAAC"}
+{"version":3,"file":"review-order.d.ts","sourceRoot":"","sources":["../../src/tools/review-order.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAiNrE,eAAO,MAAM,eAAe,EAAE,cAkI5B,CAAC"}

package/dist/tools/review-order.js

@@ -81,6 +81,62 @@ function generateReason(fileScore) {
     const topReasons = fileScore.reasons.slice(0, 2);
     return topReasons.join("; ");
 }
+function countExternalConsumers(impactData) {
+    const counts = new Map();
+    const allImpacts = [...(impactData.direct || []), ...(impactData.transitive || [])];
+    for (const impact of allImpacts) {
+        if (impact.type) {
+            const viaMatch = impact.type.match(/via (.+)/);
+            if (viaMatch) {
+                const viaFile = viaMatch[1];
+                counts.set(viaFile, (counts.get(viaFile) || 0) + 1);
+            }
+        }
+    }
+    return counts;
+}
+function boostScoresForExternalConsumers(scores, externalConsumerCount) {
+    const MAX_BOOST = 50;
+    const BOOST_PER_CONSUMER = 10;
+    for (const score of scores) {
+        const consumerCount = externalConsumerCount.get(score.file) || 0;
+        if (consumerCount > 0) {
+            const boost = Math.min(consumerCount * BOOST_PER_CONSUMER, MAX_BOOST);
+            score.score += boost;
+            score.reasons.push(`${consumerCount} external consumer(s)`);
+        }
+    }
+}
+function addExternalFilesToScores(impactData, changedFileSet, externalScores) {
+    const BASE_EXTERNAL_SCORE = 25;
+    const seenExternals = new Set();
+    const directFiles = impactData.direct || [];
+    for (const impact of directFiles) {
+        if (changedFileSet.has(impact.file) || seenExternals.has(impact.file))
+            continue;
+        seenExternals.add(impact.file);
+        const directImportCount = directFiles.filter((d) => d.file === impact.file).length;
+        const transitiveCount = (impactData.transitive || []).filter((t) => t.file === impact.file).length;
+        let score = BASE_EXTERNAL_SCORE;
+        const reasons = ["External: imports changed code"];
+        if (directImportCount > 1) {
+            score += directImportCount * 5;
+            reasons.push(`${directImportCount} direct imports`);
+        }
+        if (transitiveCount > 0) {
+            score += 10;
+            reasons.push("Also has transitive impact");
+        }
+        externalScores.push({
+            file: impact.file,
+            score,
+            reasons,
+            dependencies: [],
+            dependents: [],
+            isExternal: true,
+        });
+    }
+}
 export const reviewOrderTool = tool({
     description: "Analyze changed files and suggest optimal review order based on dependencies, file type priority, and complexity. Returns a prioritized list with rationale for reviewing each file.",
     args: {
@@ -92,6 +148,27 @@ export const reviewOrderTool = tool({
             .string()
             .optional()
             .describe("Additional ordering instructions (e.g., 'review migrations before models')"),
+        impact_data: tool.schema
+            .object({
+            direct: tool.schema
+                .array(tool.schema.object({
+                file: tool.schema.string(),
+                line: tool.schema.number().optional(),
+                type: tool.schema.string().optional(),
+            }))
+                .optional()
+                .describe("Direct consumers of changed files"),
+            transitive: tool.schema
+                .array(tool.schema.object({
+                file: tool.schema.string(),
+                line: tool.schema.number().optional(),
+                type: tool.schema.string().optional(),
+            }))
+                .optional()
+                .describe("Transitive consumers of changed files"),
+        })
+            .optional()
+            .describe("Impact analysis results to merge into review order. External files will be added to the list."),
     },
     async execute(args, ctx) {
         const cwd = process.cwd();
@@ -108,7 +185,7 @@ export const reviewOrderTool = tool({
         else {
             filesToAnalyze = await getChangedFiles(cwd);
         }
-        if (filesToAnalyze.length === 0) {
+        if (filesToAnalyze.length === 0 && !args.impact_data) {
             return JSON.stringify({
                 order: [],
                 dependency_graph: {},
@@ -117,8 +194,19 @@ export const reviewOrderTool = tool({
         }
         const dependencyGraph = await buildDependencyGraph(filesToAnalyze.map((f) => f.file), cwd);
         const scores = computeScores(filesToAnalyze, dependencyGraph, config.review_order.type_priority);
+        const impactData = args.impact_data;
+        const externalScores = [];
+        const changedFileSet = new Set(filesToAnalyze.map((f) => f.file));
+        if (impactData) {
+            const externalConsumerCount = countExternalConsumers(impactData);
+            boostScoresForExternalConsumers(scores, externalConsumerCount);
+            addExternalFilesToScores(impactData, changedFileSet, externalScores);
+            scores.sort((a, b) => b.score - a.score);
+            externalScores.sort((a, b) => b.score - a.score);
+        }
+        const allScores = [...scores, ...externalScores];
         const result = {
-            order: scores.map((s, i) => ({
+            order: allScores.map((s, i) => ({
                 rank: i + 1,
                 file: s.file,
                 reason: generateReason(s),
@@ -127,10 +215,15 @@ export const reviewOrderTool = tool({
             dependency_graph: Object.fromEntries(dependencyGraph),
         };
         let output = "## Review Order\n\n";
+        if (impactData) {
+            output += "_Includes external files impacted by changes_\n\n";
+        }
         output += "| # | File | Reason | Score |\n";
         output += "|---|------|--------|-------|\n";
-        for (const item of result.order) {
-            output += `| ${item.rank} | \`${item.file}\` | ${item.reason} | ${item.score} |\n`;
+        for (let i = 0; i < allScores.length; i++) {
+            const score = allScores[i];
+            const marker = score.isExternal ? " *(external)*" : "";
+            output += `| ${i + 1} | \`${score.file}\`${marker} | ${generateReason(score)} | ${score.score} |\n`;
         }
         if (Object.keys(result.dependency_graph).length > 0) {
             output += "\n## Dependency Graph\n\n";

package/dist/tools/review-order.js.map

@@ -1 +1 @@
-{"version":3,"file":"review-order.js","sourceRoot":"","sources":["../../src/tools/review-order.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"review-order.js","sourceRoot":"","sources":["../../src/tools/review-order.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-review-helper",
-  "version": "0.1.6",
+  "version": "0.3.0",
   "description": "OpenCode plugin for reviewing AI-generated code changes - suggests review order and analyzes impact",
   "type": "module",
   "main": "dist/index.js",
@@ -10,7 +10,6 @@
   },
   "files": [
     "dist",
-    "agents",
     "schema.json"
   ],
   "scripts": {

package/agents/impact-explorer.md

@@ -1,41 +0,0 @@
----
-name: review-helper:impact-explorer
-description: Sub-agent for transitive reference exploration. Called by impact_analysis tool for deep dependency crawling.
-mode: subagent
-model: google/gemini-3-flash
-color: cyan
-tools: [Read, Grep, Glob]
----
-
-You explore references to symbols transitively.
-
-## Input
-
-You receive:
-- `symbol`: Name to find references for
-- `source_file`: Where symbol is defined
-- `exclude_files`: Files already in changeset (skip these)
-- `depth`: Current depth level
-
-## Process
-
-1. Find all references to `symbol`:
-   - Search for import statements containing the symbol
-   - Search for direct usage of the symbol name
-2. Filter out files in `exclude_files`
-3. For each reference, note:
-   - File path
-   - Line number  
-   - Usage type (import, call, extends, etc.)
-
-## Output
-
-Return structured list:
-```
-References to `UserModel`:
-- src/api/auth.ts:15 (import)
-- src/api/orders.ts:42 (call)
-- src/services/email.ts:8 (import)
-```
-
-Be fast and focused. Find references, don't analyze the code deeply.

package/agents/review-helper.md

@@ -1,94 +0,0 @@
----
-name: review-helper
-description: |
-  Comprehensive code reviewer for AI-generated changes. Analyzes:
-  - Optimal review order based on file dependencies
-  - Impact on code outside the changeset (transitive)
-  
-  Does NOT automatically run tests or fix code. For debugging help, explicitly ask.
-  
-  Examples:
-  <example>
-  Context: User completed AI-assisted implementation
-  user: "Review the changes Claude just made"
-  assistant: "I'll analyze the changes for review order and impact."
-  </example>
-  
-  <example>
-  Context: Large PR review
-  user: "What should I look at first in this PR?"
-  assistant: "I'll determine the optimal review order based on dependencies."
-  </example>
-  
-  <example>
-  Context: Concern about breaking changes
-  user: "What else might this break?"
-  assistant: "I'll analyze transitive impact on code outside these changes."
-  </example>
-
-model: inherit
-color: red
-tools: [review_order, impact_analysis, Read, Grep, Glob, task]
----
-
-You are an expert code reviewer specialized in reviewing AI-generated code changes.
-
-## Your Role
-
-Help humans review large AI-generated changesets by:
-1. Suggesting optimal review order (dependencies first)
-2. Identifying code outside the changeset that could break
-
-You do NOT automatically run tests or apply fixes. If the user wants debugging help, they will ask explicitly.
-
-## Default Workflow
-
-When asked to review changes:
-
-### Step 1: Determine Review Order
-
-Use the `review_order` tool:
-- Analyzes changed files from git diff
-- Builds import dependency graph
-- Scores files by: type priority, centrality, complexity
-- Returns prioritized list with rationale
-
-### Step 2: Analyze Impact
-
-Use the `impact_analysis` tool:
-- Finds code outside changeset that uses changed exports
-- Identifies direct consumers and transitive dependencies
-- Flags files without test coverage
-- Reports potential breaking changes
-
-### Step 3: Present Findings
-
-Format and present the tool outputs clearly:
-
-```
-## Review Order
-| # | File | Reason |
-|---|------|--------|
-| 1 | migrations/... | Schema change - affects downstream |
-| 2 | src/models/... | Core model - 4 files depend on this |
-
-## Impact Analysis
-### Direct Consumers (not in changeset)
-- `src/api/auth.ts:42` imports `User` from `src/models/user.ts`
-
-### Transitive Impact  
-- `src/api/reports.ts` → via `src/api/orders.ts` → changed file
-
-### Test Coverage Gaps
-- `src/models/user.ts` has no corresponding test file
-```
-
-Do NOT add your own recommendations or analysis beyond what the tools return.
-
-## Key Principles
-
-- **Focus on integration boundaries** - where AI often misses issues
-- **Flag files with many dependents** as high-risk
-- **Note missing test coverage** for changed code
-- **Be concise** - prioritize actionable insights over exhaustive lists
-- **Don't run tests automatically** - only analyze, let user decide next steps