@capybearista/opencode-adversarial-review 0.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/LICENSE ADDED
@@ -0,0 +1,373 @@
1
+ Mozilla Public License Version 2.0
2
+ ==================================
3
+
4
+ 1. Definitions
5
+ --------------
6
+
7
+ 1.1. "Contributor"
8
+ means each individual or legal entity that creates, contributes to
9
+ the creation of, or owns Covered Software.
10
+
11
+ 1.2. "Contributor Version"
12
+ means the combination of the Contributions of others (if any) used
13
+ by a Contributor and that particular Contributor's Contribution.
14
+
15
+ 1.3. "Contribution"
16
+ means Covered Software of a particular Contributor.
17
+
18
+ 1.4. "Covered Software"
19
+ means Source Code Form to which the initial Contributor has attached
20
+ the notice in Exhibit A, the Executable Form of such Source Code
21
+ Form, and Modifications of such Source Code Form, in each case
22
+ including portions thereof.
23
+
24
+ 1.5. "Incompatible With Secondary Licenses"
25
+ means
26
+
27
+ (a) that the initial Contributor has attached the notice described
28
+ in Exhibit B to the Covered Software; or
29
+
30
+ (b) that the Covered Software was made available under the terms of
31
+ version 1.1 or earlier of the License, but not also under the
32
+ terms of a Secondary License.
33
+
34
+ 1.6. "Executable Form"
35
+ means any form of the work other than Source Code Form.
36
+
37
+ 1.7. "Larger Work"
38
+ means a work that combines Covered Software with other material, in
39
+ a separate file or files, that is not Covered Software.
40
+
41
+ 1.8. "License"
42
+ means this document.
43
+
44
+ 1.9. "Licensable"
45
+ means having the right to grant, to the maximum extent possible,
46
+ whether at the time of the initial grant or subsequently, any and
47
+ all of the rights conveyed by this License.
48
+
49
+ 1.10. "Modifications"
50
+ means any of the following:
51
+
52
+ (a) any file in Source Code Form that results from an addition to,
53
+ deletion from, or modification of the contents of Covered
54
+ Software; or
55
+
56
+ (b) any new file in Source Code Form that contains any Covered
57
+ Software.
58
+
59
+ 1.11. "Patent Claims" of a Contributor
60
+ means any patent claim(s), including without limitation, method,
61
+ process, and apparatus claims, in any patent Licensable by such
62
+ Contributor that would be infringed, but for the grant of the
63
+ License, by the making, using, selling, offering for sale, having
64
+ made, import, or transfer of either its Contributions or its
65
+ Contributor Version.
66
+
67
+ 1.12. "Secondary License"
68
+ means either the GNU General Public License, Version 2.0, the GNU
69
+ Lesser General Public License, Version 2.1, the GNU Affero General
70
+ Public License, Version 3.0, or any later versions of those
71
+ licenses.
72
+
73
+ 1.13. "Source Code Form"
74
+ means the form of the work preferred for making modifications.
75
+
76
+ 1.14. "You" (or "Your")
77
+ means an individual or a legal entity exercising rights under this
78
+ License. For legal entities, "You" includes any entity that
79
+ controls, is controlled by, or is under common control with You. For
80
+ purposes of this definition, "control" means (a) the power, direct
81
+ or indirect, to cause the direction or management of such entity,
82
+ whether by contract or otherwise, or (b) ownership of more than
83
+ fifty percent (50%) of the outstanding shares or beneficial
84
+ ownership of such entity.
85
+
86
+ 2. License Grants and Conditions
87
+ --------------------------------
88
+
89
+ 2.1. Grants
90
+
91
+ Each Contributor hereby grants You a world-wide, royalty-free,
92
+ non-exclusive license:
93
+
94
+ (a) under intellectual property rights (other than patent or trademark)
95
+ Licensable by such Contributor to use, reproduce, make available,
96
+ modify, display, perform, distribute, and otherwise exploit its
97
+ Contributions, either on an unmodified basis, with Modifications, or
98
+ as part of a Larger Work; and
99
+
100
+ (b) under Patent Claims of such Contributor to make, use, sell, offer
101
+ for sale, have made, import, and otherwise transfer either its
102
+ Contributions or its Contributor Version.
103
+
104
+ 2.2. Effective Date
105
+
106
+ The licenses granted in Section 2.1 with respect to any Contribution
107
+ become effective for each Contribution on the date the Contributor first
108
+ distributes such Contribution.
109
+
110
+ 2.3. Limitations on Grant Scope
111
+
112
+ The licenses granted in this Section 2 are the only rights granted under
113
+ this License. No additional rights or licenses will be implied from the
114
+ distribution or licensing of Covered Software under this License.
115
+ Notwithstanding Section 2.1(b) above, no patent license is granted by a
116
+ Contributor:
117
+
118
+ (a) for any code that a Contributor has removed from Covered Software;
119
+ or
120
+
121
+ (b) for infringements caused by: (i) Your and any other third party's
122
+ modifications of Covered Software, or (ii) the combination of its
123
+ Contributions with other software (except as part of its Contributor
124
+ Version); or
125
+
126
+ (c) under Patent Claims infringed by Covered Software in the absence of
127
+ its Contributions.
128
+
129
+ This License does not grant any rights in the trademarks, service marks,
130
+ or logos of any Contributor (except as may be necessary to comply with
131
+ the notice requirements in Section 3.4).
132
+
133
+ 2.4. Subsequent Licenses
134
+
135
+ No Contributor makes additional grants as a result of Your choice to
136
+ distribute the Covered Software under a subsequent version of this
137
+ License (see Section 10.2) or under the terms of a Secondary License (if
138
+ permitted under the terms of Section 3.3).
139
+
140
+ 2.5. Representation
141
+
142
+ Each Contributor represents that the Contributor believes its
143
+ Contributions are its original creation(s) or it has sufficient rights
144
+ to grant the rights to its Contributions conveyed by this License.
145
+
146
+ 2.6. Fair Use
147
+
148
+ This License is not intended to limit any rights You have under
149
+ applicable copyright doctrines of fair use, fair dealing, or other
150
+ equivalents.
151
+
152
+ 2.7. Conditions
153
+
154
+ Sections 3.1, 3.2, 3.3, and 3.4 are conditions of the licenses granted
155
+ in Section 2.1.
156
+
157
+ 3. Responsibilities
158
+ -------------------
159
+
160
+ 3.1. Distribution of Source Form
161
+
162
+ All distribution of Covered Software in Source Code Form, including any
163
+ Modifications that You create or to which You contribute, must be under
164
+ the terms of this License. You must inform recipients that the Source
165
+ Code Form of the Covered Software is governed by the terms of this
166
+ License, and how they can obtain a copy of this License. You may not
167
+ attempt to alter or restrict the recipients' rights in the Source Code
168
+ Form.
169
+
170
+ 3.2. Distribution of Executable Form
171
+
172
+ If You distribute Covered Software in Executable Form then:
173
+
174
+ (a) such Covered Software must also be made available in Source Code
175
+ Form, as described in Section 3.1, and You must inform recipients of
176
+ the Executable Form how they can obtain a copy of such Source Code
177
+ Form by reasonable means in a timely manner, at a charge no more
178
+ than the cost of distribution to the recipient; and
179
+
180
+ (b) You may distribute such Executable Form under the terms of this
181
+ License, or sublicense it under different terms, provided that the
182
+ license for the Executable Form does not attempt to limit or alter
183
+ the recipients' rights in the Source Code Form under this License.
184
+
185
+ 3.3. Distribution of a Larger Work
186
+
187
+ You may create and distribute a Larger Work under terms of Your choice,
188
+ provided that You also comply with the requirements of this License for
189
+ the Covered Software. If the Larger Work is a combination of Covered
190
+ Software with a work governed by one or more Secondary Licenses, and the
191
+ Covered Software is not Incompatible With Secondary Licenses, this
192
+ License permits You to additionally distribute such Covered Software
193
+ under the terms of such Secondary License(s), so that the recipient of
194
+ the Larger Work may, at their option, further distribute the Covered
195
+ Software under the terms of either this License or such Secondary
196
+ License(s).
197
+
198
+ 3.4. Notices
199
+
200
+ You may not remove or alter the substance of any license notices
201
+ (including copyright notices, patent notices, disclaimers of warranty,
202
+ or limitations of liability) contained within the Source Code Form of
203
+ the Covered Software, except that You may alter any license notices to
204
+ the extent required to remedy known factual inaccuracies.
205
+
206
+ 3.5. Application of Additional Terms
207
+
208
+ You may choose to offer, and to charge a fee for, warranty, support,
209
+ indemnity or liability obligations to one or more recipients of Covered
210
+ Software. However, You may do so only on Your own behalf, and not on
211
+ behalf of any Contributor. You must make it absolutely clear that any
212
+ such warranty, support, indemnity, or liability obligation is offered by
213
+ You alone, and You hereby agree to indemnify every Contributor for any
214
+ liability incurred by such Contributor as a result of warranty, support,
215
+ indemnity or liability terms You offer. You may include additional
216
+ disclaimers of warranty and limitations of liability specific to any
217
+ jurisdiction.
218
+
219
+ 4. Inability to Comply Due to Statute or Regulation
220
+ ---------------------------------------------------
221
+
222
+ If it is impossible for You to comply with any of the terms of this
223
+ License with respect to some or all of the Covered Software due to
224
+ statute, judicial order, or regulation then You must: (a) comply with
225
+ the terms of this License to the maximum extent possible; and (b)
226
+ describe the limitations and the code they affect. Such description must
227
+ be placed in a text file included with all distributions of the Covered
228
+ Software under this License. Except to the extent prohibited by statute
229
+ or regulation, such description must be sufficiently detailed for a
230
+ recipient of ordinary skill to be able to understand it.
231
+
232
+ 5. Termination
233
+ --------------
234
+
235
+ 5.1. The rights granted under this License will terminate automatically
236
+ if You fail to comply with any of its terms. However, if You become
237
+ compliant, then the rights granted under this License from a particular
238
+ Contributor are reinstated (a) provisionally, unless and until such
239
+ Contributor explicitly and finally terminates Your grants, and (b) on an
240
+ ongoing basis, if such Contributor fails to notify You of the
241
+ non-compliance by some reasonable means prior to 60 days after You have
242
+ come back into compliance. Moreover, Your grants from a particular
243
+ Contributor are reinstated on an ongoing basis if such Contributor
244
+ notifies You of the non-compliance by some reasonable means, this is the
245
+ first time You have received notice of non-compliance with this License
246
+ from such Contributor, and You become compliant prior to 30 days after
247
+ Your receipt of the notice.
248
+
249
+ 5.2. If You initiate litigation against any entity by asserting a patent
250
+ infringement claim (excluding declaratory judgment actions,
251
+ counter-claims, and cross-claims) alleging that a Contributor Version
252
+ directly or indirectly infringes any patent, then the rights granted to
253
+ You by any and all Contributors for the Covered Software under Section
254
+ 2.1 of this License shall terminate.
255
+
256
+ 5.3. In the event of termination under Sections 5.1 or 5.2 above, all
257
+ end user license agreements (excluding distributors and resellers) which
258
+ have been validly granted by You or Your distributors under this License
259
+ prior to termination shall survive termination.
260
+
261
+ ************************************************************************
262
+ * *
263
+ * 6. Disclaimer of Warranty *
264
+ * ------------------------- *
265
+ * *
266
+ * Covered Software is provided under this License on an "as is" *
267
+ * basis, without warranty of any kind, either expressed, implied, or *
268
+ * statutory, including, without limitation, warranties that the *
269
+ * Covered Software is free of defects, merchantable, fit for a *
270
+ * particular purpose or non-infringing. The entire risk as to the *
271
+ * quality and performance of the Covered Software is with You. *
272
+ * Should any Covered Software prove defective in any respect, You *
273
+ * (not any Contributor) assume the cost of any necessary servicing, *
274
+ * repair, or correction. This disclaimer of warranty constitutes an *
275
+ * essential part of this License. No use of any Covered Software is *
276
+ * authorized under this License except under this disclaimer. *
277
+ * *
278
+ ************************************************************************
279
+
280
+ ************************************************************************
281
+ * *
282
+ * 7. Limitation of Liability *
283
+ * -------------------------- *
284
+ * *
285
+ * Under no circumstances and under no legal theory, whether tort *
286
+ * (including negligence), contract, or otherwise, shall any *
287
+ * Contributor, or anyone who distributes Covered Software as *
288
+ * permitted above, be liable to You for any direct, indirect, *
289
+ * special, incidental, or consequential damages of any character *
290
+ * including, without limitation, damages for lost profits, loss of *
291
+ * goodwill, work stoppage, computer failure or malfunction, or any *
292
+ * and all other commercial damages or losses, even if such party *
293
+ * shall have been informed of the possibility of such damages. This *
294
+ * limitation of liability shall not apply to liability for death or *
295
+ * personal injury resulting from such party's negligence to the *
296
+ * extent applicable law prohibits such limitation. Some *
297
+ * jurisdictions do not allow the exclusion or limitation of *
298
+ * incidental or consequential damages, so this exclusion and *
299
+ * limitation may not apply to You. *
300
+ * *
301
+ ************************************************************************
302
+
303
+ 8. Litigation
304
+ -------------
305
+
306
+ Any litigation relating to this License may be brought only in the
307
+ courts of a jurisdiction where the defendant maintains its principal
308
+ place of business and such litigation shall be governed by laws of that
309
+ jurisdiction, without reference to its conflict-of-law provisions.
310
+ Nothing in this Section shall prevent a party's ability to bring
311
+ cross-claims or counter-claims.
312
+
313
+ 9. Miscellaneous
314
+ ----------------
315
+
316
+ This License represents the complete agreement concerning the subject
317
+ matter hereof. If any provision of this License is held to be
318
+ unenforceable, such provision shall be reformed only to the extent
319
+ necessary to make it enforceable. Any law or regulation which provides
320
+ that the language of a contract shall be construed against the drafter
321
+ shall not be used to construe this License against a Contributor.
322
+
323
+ 10. Versions of the License
324
+ ---------------------------
325
+
326
+ 10.1. New Versions
327
+
328
+ Mozilla Foundation is the license steward. Except as provided in Section
329
+ 10.3, no one other than the license steward has the right to modify or
330
+ publish new versions of this License. Each version will be given a
331
+ distinguishing version number.
332
+
333
+ 10.2. Effect of New Versions
334
+
335
+ You may distribute the Covered Software under the terms of the version
336
+ of the License under which You originally received the Covered Software,
337
+ or under the terms of any subsequent version published by the license
338
+ steward.
339
+
340
+ 10.3. Modified Versions
341
+
342
+ If you create software not governed by this License, and you want to
343
+ create a new license for such software, you may create and use a
344
+ modified version of this License if you rename the license and remove
345
+ any references to the name of the license steward (except to note that
346
+ such modified license differs from this License).
347
+
348
+ 10.4. Distributing Source Code Form that is Incompatible With Secondary
349
+ Licenses
350
+
351
+ If You choose to distribute Source Code Form that is Incompatible With
352
+ Secondary Licenses under the terms of this version of the License, the
353
+ notice described in Exhibit B of this License must be attached.
354
+
355
+ Exhibit A - Source Code Form License Notice
356
+ -------------------------------------------
357
+
358
+ This Source Code Form is subject to the terms of the Mozilla Public
359
+ License, v. 2.0. If a copy of the MPL was not distributed with this
360
+ file, You can obtain one at https://mozilla.org/MPL/2.0/.
361
+
362
+ If it is not possible or desirable to put the notice in a particular
363
+ file, then You may include the notice in a location (such as a LICENSE
364
+ file in a relevant directory) where a recipient would be likely to look
365
+ for such a notice.
366
+
367
+ You may add additional accurate notices of copyright ownership.
368
+
369
+ Exhibit B - "Incompatible With Secondary Licenses" Notice
370
+ ---------------------------------------------------------
371
+
372
+ This Source Code Form is "Incompatible With Secondary Licenses", as
373
+ defined by the Mozilla Public License, v. 2.0.
package/README.md ADDED
@@ -0,0 +1,161 @@
1
+ # opencode-adversarial-review
2
+
3
+ <p align="center">Challenge code with adversarial review</p>
4
+ <p align="center">
5
+ <a href="https://www.npmjs.com/package/@capybearista/opencode-adversarial-review"><img alt="npm" src="https://img.shields.io/npm/v/@capybearista/opencode-adversarial-review?style=flat-square&color=8d60e6" /></a>
6
+ <a href="https://www.npmjs.com/package/@capybearista/opencode-adversarial-review"><img alt="npm" src="https://img.shields.io/npm/dm/@capybearista/opencode-adversarial-review?style=flat-square&color=6067e6" /></a>
7
+ <a href="https://opencode.ai"><img alt="opencode" src="https://img.shields.io/badge/OpenCode-Plugin-orange?style=flat-square&color=60a5e6
8
+ " /></a>
9
+ <a href="https://opensource.org/licenses/MPL-2.0"><img alt="license" src="https://img.shields.io/badge/License-MPL--2.0-blue.svg?style=flat-square&color=60dfe6" /></a>
10
+ </p>
11
+ ---
12
+
13
+ ## Why?
14
+
15
+ > Provides an adversarial code review agent that challenges implementation approach and design choices, not just finding bugs. Uses a clean-context subagent so the review is unbiased by conversation history.
16
+
17
+ ## Philosophy: Extending OpenCode
18
+
19
+ OpenCode is designed to be highly extensible. This plugin hooks into the OpenCode lifecycle to provide additional functionality seamlessly into your workflows. This plugin is modeled after the Codex CLI's adversarial review system, focusing on "breaking confidence" rather than validating changes.
20
+
21
+ ### Architecture
22
+
23
+ ```mermaid
24
+ graph TB
25
+ subgraph Host [OpenCode Host]
26
+ User([User]) -->|/adversarial-review| Command[Command Template]
27
+ end
28
+
29
+ subgraph Injection [Context Injection]
30
+ direction LR
31
+ Command -->|!git status| S[Status]
32
+ Command -->|!git log| L[Commits]
33
+ Command -->|!git diff| D[Diff Summary]
34
+ Command -->|!cat| U[Untracked]
35
+ end
36
+
37
+ subgraph Adversary [Adversarial Subagent]
38
+ direction TB
39
+ Reviewer{Adversarial Reviewer}
40
+ S & L & D & U --> Reviewer
41
+
42
+ Reviewer -->|Self-Collect| Tools[Explorer Tools]
43
+ Tools -->|Source Code| Reviewer
44
+ end
45
+
46
+ Reviewer -->|Structured JSON| User
47
+
48
+ classDef host fill:#bbf,stroke:#333,stroke-width:2px;
49
+ classDef collection fill:#dfd,stroke:#333,stroke-width:1px,stroke-dasharray: 5 5;
50
+ classDef adversary fill:#f9f,stroke:#333,stroke-width:2px;
51
+
52
+ class Host host;
53
+ class Collection collection;
54
+ class Adversary adversary;
55
+ ```
56
+
57
+ The plugin uses a **stateless subagent architecture**. When the command is invoked, a deterministic shell script collects git metadata (diff stat, untracked files, recent commits) and injects it into a fresh subagent session. This ensures the review is unbiased by the primary agent's conversation history.
58
+
59
+ ## Features
60
+
61
+ - **Adversarial Persona**: A specialized subagent prompted to find reasons *not* to ship, prioritizing auth gaps, race conditions, and data loss.
62
+ - **Dynamic Context Collection**: Automatically switches between full-inline diff (for 1-2 files) and high-level stat (for larger changes).
63
+ - **Subagent Self-Collection**: The subagent uses whitelisted git and file tools to "pull" the specific file contents it needs based on the initial diff summary.
64
+ - **Structured JSON Output**: Returns findings with severity, file locations, confidence scores, and concrete recommendations.
65
+ - **Configurable Scope**: Support for `--base <ref>`, `--scope branch`, and `--scope working-tree`.
66
+
67
+ ## Install
68
+
69
+ Add the plugin to `opencode.json` or `opencode.jsonc`:
70
+ ```json
71
+ {
72
+ "plugin": ["@capybearista/opencode-adversarial-review"]
73
+ }
74
+ ```
75
+
76
+ You can also install it through the CLI:
77
+
78
+ ```bash
79
+ opencode plugin -g @capybearista/opencode-adversarial-review # global install
80
+ opencode plugin @capybearista/opencode-adversarial-review # project-local install
81
+ ```
82
+
83
+ ## Usage
84
+
85
+ Run a review on your current working tree changes:
86
+ ```bash
87
+ /adversarial-review
88
+ ```
89
+
90
+ ### Arguments
91
+
92
+ | Argument | Values | Description |
93
+ | :--- | :--- | :--- |
94
+ | `--scope` | `auto`, `working-tree`, `branch` | The range of changes to review. Defaults to `auto`. |
95
+ | `--base` | `<git-ref>` | The base reference (branch or commit) to compare against when using `branch` scope. |
96
+
97
+ - **`auto`**: Reviews using the broadest context the provided information supports.
98
+ - **`working-tree`**: Reviews staged and unstaged changes against `HEAD`.
99
+ - **`branch`**: Reviews all changes on the current branch since it diverged from the upstream or main branch.
100
+ - **`focus ...`**: Any trailing text is treated as a focus area for the review.
101
+
102
+ ### Examples
103
+
104
+ Force review of only working tree changes (ignoring branch history):
105
+ ```bash
106
+ /adversarial-review --scope working-tree
107
+ ```
108
+
109
+ Review all changes on the current branch (automatically finds the fork point):
110
+ ```bash
111
+ /adversarial-review --scope branch
112
+ ```
113
+
114
+ Review a specific branch against its fork point from `main`:
115
+ ```bash
116
+ /adversarial-review --base main
117
+ ```
118
+
119
+ Review with a specific focus area:
120
+ ```bash
121
+ /adversarial-review --base main focus on race conditions in the auth middleware
122
+ ```
123
+
124
+ ## Configuration
125
+
126
+ | Property | Type | Description |
127
+ | :--- | :--- | :--- |
128
+ | `agent.adversarial-review.model` | `string` | The model to use for the subagent (defaults to `openai/gpt-5.4`). |
129
+ | `agent.adversarial-review.temperature` | `number` | Sampling temperature (defaults to `0.1` for deterministic review). |
130
+ | `command.adversarial-review.template` | `string` | The shell-injected template used to gather git context. |
131
+
132
+ This plugin requires no manual configuration out of the box, but you can override the subagent model in your local `opencode.json`.
133
+
134
+ ## Permissions & Security
135
+
136
+ This plugin is designed with a "least privilege" security model. The adversarial subagent is strictly sandboxed to prevent accidental or malicious modifications to your codebase:
137
+
138
+ - **Edit**: Explicitly denied (`edit: deny`).
139
+ - **Bash**: Restricted to a read-only whitelist of 12 Git patterns (e.g., `git diff`, `git log`, `git status`). All other shell commands are blocked.
140
+ - **Read/Grep/Glob**: Allowed (read-only) to enable code inspection.
141
+ - **Network**: Web fetch and search are disabled to ensure the review remains focused on the files at hand.
142
+
143
+ ## Troubleshooting
144
+
145
+ - **"No changes to review"**: Ensure you have staged or unstaged changes, or use `--base` to review a committed branch.
146
+ - **Model timeouts**: Large diffs may require a model with a larger context window or more time. The subagent is whitelisted to `read` files if the diff stat is too long to include.
147
+ - **Git errors**: Ensure you are running within a git repository. The command relies on `git` being available in your PATH.
148
+
149
+ ## Contributing
150
+
151
+ This package lives in the `opencode-plugins` monorepo.
152
+
153
+ - Run `bun run build`, `bun run typecheck`, `bun run lint`, and `bun test` before opening a PR.
154
+ - Keep the plugin focused on the adversarial code review function.
155
+ - Prefer small, direct changes.
156
+
157
+ Please open an issue or check for existing ones before creating a pull request.
158
+
159
+ ## License
160
+
161
+ [MPL-2.0](LICENSE)
@@ -0,0 +1,7 @@
1
+ import type { Plugin } from "@opencode-ai/plugin";
2
+ export declare const AdversarialReviewPlugin: Plugin;
3
+ declare const _default: {
4
+ id: string;
5
+ server: Plugin;
6
+ };
7
+ export default _default;
package/dist/index.js ADDED
@@ -0,0 +1,176 @@
1
+ const PLUGIN_ID = "capybearista.opencode-adversarial-review";
2
+ const ADVERSARIAL_REVIEW_PROMPT = `<role>
3
+ You are an adversarial code review agent.
4
+ Your job is to break confidence in the change, not to validate it.
5
+ </role>
6
+
7
+ <task>
8
+ Review the provided repository context as if you are trying to find the strongest reasons this change should not ship yet.
9
+ The user's focus and target arguments are in the message below.
10
+
11
+ If the arguments include \`--scope auto\`, review using the broadest context the provided information supports (default).
12
+ If \`--scope working-tree\`, review staged and unstaged changes against HEAD.
13
+ If \`--scope branch\`, collect the diff for all changes on the current branch. Determine the fork point by running \`git merge-base HEAD <upstream>\` where \`<upstream>\` is the tracking branch of HEAD, or \`origin/main\`, or \`main\` (in order of preference). Then run \`git diff <fork>...HEAD\`.
14
+ If \`--base <ref>\` is provided without \`--scope\`, treat it as \`--scope branch --base <ref>\`.
15
+ If \`--base <ref>\` is provided alongside \`--scope branch\`, use that ref as the base in \`git diff <ref>...HEAD\`.
16
+ </task>
17
+
18
+ <operating_stance>
19
+ Default to skepticism.
20
+ Assume the change can fail in subtle, high-cost, or user-visible ways until the evidence says otherwise.
21
+ Do not give credit for good intent, partial fixes, or likely follow-up work.
22
+ If something only works on the happy path, treat that as a real weakness.
23
+ </operating_stance>
24
+
25
+ <attack_surface>
26
+ Prioritize the kinds of failures that are expensive, dangerous, or hard to detect:
27
+ - auth, permissions, tenant isolation, and trust boundaries
28
+ - data loss, corruption, duplication, and irreversible state changes
29
+ - rollback safety, retries, partial failure, and idempotency gaps
30
+ - race conditions, ordering assumptions, stale state, and re-entrancy
31
+ - empty-state, null, timeout, and degraded dependency behavior
32
+ - version skew, schema drift, migration hazards, and compatibility regressions
33
+ - observability gaps that would hide failure or make recovery harder
34
+ </attack_surface>
35
+
36
+ <review_method>
37
+ Actively try to disprove the change.
38
+ Look for violated invariants, missing guards, unhandled failure paths, and assumptions that stop being true under stress.
39
+ Trace how bad inputs, retries, concurrent actions, or partially completed operations move through the code.
40
+ If the user supplied a focus area, weight it heavily, but still report any other material issue you can defend.
41
+ If the diff context is limited (only stat, no full diff), use the available tools (read, grep, glob) to inspect specific files before finalizing.
42
+ </review_method>
43
+
44
+ <context_type>
45
+ The diff context either contains a full inline diff (for changes to 1-2 files) or a summary stat only (for larger changes). If you see a stat-only section without a full inline diff, use your tools to inspect the changed files directly. If you see a full inline diff, use it as primary evidence and supplement with tools as needed.
46
+ </context_type>
47
+
48
+ <finding_bar>
49
+ Report only material findings.
50
+ Do not include style feedback, naming feedback, low-value cleanup, or speculative concerns without evidence.
51
+ A finding should answer:
52
+ 1. What can go wrong?
53
+ 2. Why is this code path vulnerable?
54
+ 3. What is the likely impact?
55
+ 4. What concrete change would reduce the risk?
56
+ </finding_bar>
57
+
58
+ <structured_output_contract>
59
+ Output valid JSON matching this schema:
60
+
61
+ {
62
+ "verdict": "approve" | "needs-attention",
63
+ "summary": "terse ship/no-ship assessment",
64
+ "findings": [
65
+ {
66
+ "severity": "critical" | "high" | "medium" | "low",
67
+ "title": "short finding title",
68
+ "body": "detailed explanation",
69
+ "file": "relative file path",
70
+ "line_start": 1,
71
+ "line_end": 1,
72
+ "confidence": 0.0-1.0,
73
+ "recommendation": "concrete fix suggestion"
74
+ }
75
+ ],
76
+ "next_steps": ["actionable next step"]
77
+ }
78
+
79
+ Use \`needs-attention\` if there is any material risk worth blocking on.
80
+ Use \`approve\` only if you cannot support any substantive adversarial finding from the provided context.
81
+ Keep the output compact and specific.
82
+ </structured_output_contract>
83
+
84
+ <grounding_rules>
85
+ Be aggressive, but stay grounded.
86
+ Every finding must be defensible from the provided repository context or tool outputs.
87
+ Do not invent files, lines, code paths, incidents, attack chains, or runtime behavior you cannot support.
88
+ If a conclusion depends on an inference, state that explicitly in the finding body and keep the confidence honest.
89
+ </grounding_rules>
90
+
91
+ <calibration_rules>
92
+ Prefer one strong finding over several weak ones.
93
+ Do not dilute serious issues with filler.
94
+ If the change looks safe, say so directly and return no findings.
95
+ </calibration_rules>
96
+
97
+ <final_check>
98
+ Before finalizing, check that each finding is:
99
+ - adversarial rather than stylistic
100
+ - tied to a concrete code location
101
+ - plausible under a real failure scenario
102
+ - actionable for an engineer fixing the issue
103
+ </final_check>`;
104
+ const COMMAND_TEMPLATE = `## Adversarial Review
105
+
106
+ Arguments: $ARGUMENTS
107
+ Target: code changes
108
+
109
+ ## Git Context
110
+
111
+ !\`printf "=== Branch ===\\n" && git branch --show-current\`
112
+ !\`printf "=== Status ===\\n" && git status --short --untracked-files=all\`
113
+ !\`printf "=== Recent Commits ===\\n" && git log --oneline -3\`
114
+ !\`printf "=== Changed Files ===\\n" && git diff HEAD --name-only\`
115
+ !\`printf "=== Untracked File Contents ===\\n"; git -c core.quotepath=false ls-files --others --exclude-standard | head -5 | while IFS= read -r f; do printf "--- %s ---\\n" "$f" && cat -- "$f" 2>/dev/null | head -c 16384 && printf "\\n"; done\`
116
+ !\`FILES=\$(git diff HEAD --name-only | wc -l | tr -d ' '); if [ "\$FILES" -gt 0 ] && [ "\$FILES" -le 5 ]; then printf "=== Full Diff ===\\n" && git diff HEAD; else printf "=== Diff Stat ===\\n" && git diff HEAD --stat; fi\``;
117
+ const AGENT_NAME = "adversarial-review";
118
+ const CMD_NAME = "adversarial-review";
119
+ export const AdversarialReviewPlugin = async () => {
120
+ return {
121
+ config: async (cfg) => {
122
+ try {
123
+ cfg.agent ??= {};
124
+ cfg.agent[AGENT_NAME] ??= {};
125
+ const agent = cfg.agent[AGENT_NAME];
126
+ agent.description ??=
127
+ "Adversarial code review — challenges implementation approach and design choices";
128
+ agent.mode ??= "subagent";
129
+ agent.model ??= "openai/gpt-5.4";
130
+ agent.temperature ??= 0.1;
131
+ agent.color ??= "warning";
132
+ agent.permission ??= {};
133
+ const agentPerm = agent.permission;
134
+ agentPerm.edit = "deny";
135
+ agentPerm.bash ??= {
136
+ "git blame*": "allow",
137
+ "git branch": "allow",
138
+ "git diff*": "allow",
139
+ "git log*": "allow",
140
+ "git ls-files*": "allow",
141
+ "git merge-base*": "allow",
142
+ "git rev-list*": "allow",
143
+ "git rev-parse*": "allow",
144
+ "git show*": "allow",
145
+ "git stash list*": "allow",
146
+ "git stash show*": "allow",
147
+ "git status*": "allow",
148
+ "*": "deny",
149
+ };
150
+ agentPerm.read ??= "allow";
151
+ agentPerm.glob ??= "allow";
152
+ agentPerm.grep ??= "allow";
153
+ agentPerm.webfetch ??= "deny";
154
+ agentPerm.websearch ??= "deny";
155
+ agent.prompt ??= ADVERSARIAL_REVIEW_PROMPT;
156
+ cfg.command ??= {};
157
+ cfg.command[CMD_NAME] ??= {};
158
+ const cmd = cfg.command[CMD_NAME];
159
+ cmd.description ??= "Run an adversarial code review that challenges the implementation";
160
+ cmd.argumentHint ??= "[--base <ref>] [--scope auto|working-tree|branch] [focus ...]";
161
+ cmd.agent ??= AGENT_NAME;
162
+ cmd.subtask ??= true;
163
+ cmd.template ??= COMMAND_TEMPLATE;
164
+ }
165
+ catch (err) {
166
+ console.error(`[${PLUGIN_ID}] Failed to register agent and command:`, err instanceof Error ? err.message : String(err));
167
+ throw err;
168
+ }
169
+ },
170
+ };
171
+ };
172
+ export default {
173
+ id: PLUGIN_ID,
174
+ server: AdversarialReviewPlugin,
175
+ };
176
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
package/package.json ADDED
@@ -0,0 +1,36 @@
1
+ {
2
+ "name": "@capybearista/opencode-adversarial-review",
3
+ "version": "0.1.0",
4
+ "description": "Adversarial code review plugin",
5
+ "author": "capyBearista <capybearista@gmail.com>",
6
+ "license": "MPL-2.0",
7
+ "type": "module",
8
+ "main": "./dist/index.js",
9
+ "types": "./dist/index.d.ts",
10
+ "files": [
11
+ "dist"
12
+ ],
13
+ "scripts": {
14
+ "build": "tsc",
15
+ "typecheck": "tsc --noEmit",
16
+ "check": "bunx @biomejs/biome check --write .",
17
+ "lint": "bunx @biomejs/biome check .",
18
+ "ci": "bunx @biomejs/biome ci .",
19
+ "test": "bun test"
20
+ },
21
+ "exports": {
22
+ ".": {
23
+ "types": "./dist/index.d.ts",
24
+ "default": "./dist/index.js"
25
+ }
26
+ },
27
+ "peerDependencies": {
28
+ "@opencode-ai/plugin": ">=1.14.0"
29
+ },
30
+ "devDependencies": {
31
+ "@opencode-ai/plugin": ">=1.14.0",
32
+ "@tsconfig/node22": "^22.0.0",
33
+ "@types/bun": "latest",
34
+ "typescript": "^6.0.3"
35
+ }
36
+ }