@weaveio/weave-adapter-opencode 0.0.0-preview-20260708131242 → 0.0.0-preview-20260710143728

package/README.md

@@ -2,19 +2,33 @@
 
 OpenCode adapter for Weave.
 
-## Plugin entrypoint
+## Installation
 
-When loading this adapter as an OpenCode plugin, use the plugin bundle entrypoint:
+Add the adapter as a plugin in your `opencode.json` (or `opencode.jsonc`). Use the **full versioned package specifier**:
 
 ```json
 {
   "plugin": [
-    "@weaveio/weave-adapter-opencode/plugin"
+    "@weaveio/weave-adapter-opencode@0.0.1"
   ]
 }
 ```
 
-For a direct file URL during local development, point OpenCode at `dist/plugin.js`, not `dist/index.js`:
+For preview/snapshot versions:
+
+```json
+{
+  "plugin": [
+    "@weaveio/weave-adapter-opencode@0.0.0-preview-20260708134505"
+  ]
+}
+```
+
+OpenCode resolves the plugin from npm at startup, so the version must be pinned explicitly in the `plugin` array. There is no separate `npm install` step — OpenCode handles package fetching.
+
+## Local development
+
+For local development, point OpenCode at the built `dist/plugin.js` via a file URL:
 
 ```json
 {
@@ -30,8 +44,6 @@ Rebuild the package before using a `dist/` file path so the plugin bundle matche
 bun run --filter @weaveio/weave-adapter-opencode build
 ```
 
-Do **not** use the bare package entry (`@weaveio/weave-adapter-opencode`) or `dist/index.js` as a plugin target. The bare entry is the programmatic barrel and exports non-plugin values in addition to the plugin function, which is incompatible with OpenCode's legacy plugin loader.
-
 ## Isolated OpenCode validation
 
 OpenCode merges global config, project config, explicit config, and plugin directories. `OPENCODE_CONFIG` and `OPENCODE_CONFIG_CONTENT` add config; they do not replace every other source by themselves.

package/dist/index.js

@@ -19807,7 +19807,8 @@ function refinePromptFileSafe(field) {
 var ToolPermissionSchema = exports_external.enum(["allow", "deny", "ask"]);
 var DelegationTriggerSchema = exports_external.object({
   domain: exports_external.string(),
-  trigger: exports_external.string()
+  trigger: exports_external.string(),
+  routing_hint: exports_external.string().optional()
 });
 var ToolPolicySchema = exports_external.object({
   read: ToolPermissionSchema.optional(),
@@ -20166,7 +20167,7 @@ When to delegate to each specialist:
 
 {{#delegation.targets}}
 - **{{name}}** \u2014 {{description}}{{#triggers}}
-  - {{trigger}}{{/triggers}}
+  - {{routing_hint}}{{/triggers}}
 {{/delegation.targets}}
 
 Delegate aggressively to keep your context lean. Thread and Spindle are cheap (read-only); use them liberally for evidence gathering before routing to implementation agents.
@@ -20974,10 +20975,10 @@ agent shuttle {
   }
 
   triggers [
-    { domain "Implementation" trigger "Bounded coding tasks, file edits, feature work" }
-    { domain "Testing" trigger "Writing and running tests" }
-    { domain "Debugging" trigger "Diagnosing and fixing bugs in a specific area" }
-    { domain "Refactoring" trigger "Improving code structure without changing behavior" }
+    { domain "Implementation" trigger "Bounded coding tasks, file edits, feature work" routing_hint "Use for single-file changes, bug fixes, or clearly scoped implementation tasks" }
+    { domain "Testing" trigger "Writing and running tests" routing_hint "Use when tests need to be written, updated, or debugged" }
+    { domain "Debugging" trigger "Diagnosing and fixing bugs in a specific area" routing_hint "Use when a bug needs investigation and fixing in a known area" }
+    { domain "Refactoring" trigger "Improving code structure without changing behavior" routing_hint "Use for code cleanup, renaming, or restructuring without functional changes" }
   ]
 }
 
@@ -20997,9 +20998,9 @@ agent pattern {
   }
 
   triggers [
-    { domain "Planning" trigger "Creating structured implementation plans before execution" }
-    { domain "Architecture" trigger "Designing system structure, component boundaries, and data flow" }
-    { domain "Decomposition" trigger "Breaking complex goals into discrete, sequenced tasks" }
+    { domain "Planning" trigger "Creating structured implementation plans before execution" routing_hint "Use for multi-file features, complex refactors, or work spanning 5+ steps" }
+    { domain "Architecture" trigger "Designing system structure, component boundaries, and data flow" routing_hint "Use when system design decisions need to be made before implementation" }
+    { domain "Decomposition" trigger "Breaking complex goals into discrete, sequenced tasks" routing_hint "Use when a large goal needs to be broken into an actionable plan" }
   ]
 }
 
@@ -21019,9 +21020,9 @@ agent thread {
   }
 
   triggers [
-    { domain "Exploration" trigger "Tracing symbols, call graphs, and data flow across the codebase" }
-    { domain "Discovery" trigger "Locating where a concept, pattern, or behavior is implemented" }
-    { domain "Audit" trigger "Surveying existing code before planning a change" }
+    { domain "Exploration" trigger "Tracing symbols, call graphs, and data flow across the codebase" routing_hint "Use for fast codebase exploration \u2014 read-only and cheap" }
+    { domain "Discovery" trigger "Locating where a concept, pattern, or behavior is implemented" routing_hint "Use when answering 'where is X' or 'how does Y work' questions" }
+    { domain "Audit" trigger "Surveying existing code before planning a change" routing_hint "Use to gather evidence before routing to implementation agents" }
   ]
 }
 
@@ -21041,9 +21042,9 @@ agent spindle {
   }
 
   triggers [
-    { domain "Research" trigger "Fetching external documentation, API references, or library guides" }
-    { domain "Verification" trigger "Confirming facts, versions, or behaviors against authoritative sources" }
-    { domain "Discovery" trigger "Finding relevant third-party tools, packages, or standards" }
+    { domain "Research" trigger "Fetching external documentation, API references, or library guides" routing_hint "Use for external docs and research \u2014 read-only" }
+    { domain "Verification" trigger "Confirming facts, versions, or behaviors against authoritative sources" routing_hint "Use when facts need verification against official sources" }
+    { domain "Discovery" trigger "Finding relevant third-party tools, packages, or standards" routing_hint "Use when exploring external options, libraries, or standards" }
   ]
 }
 
@@ -21063,9 +21064,9 @@ agent weft {
   }
 
   triggers [
-    { domain "Code Review" trigger "Reviewing code quality, correctness, and maintainability" }
-    { domain "Gate" trigger "Approving or requesting changes before a task is considered complete" }
-    { domain "Feedback" trigger "Providing structured critique on a plan, design, or implementation" }
+    { domain "Code Review" trigger "Reviewing code quality, correctness, and maintainability" routing_hint "Use after non-trivial changes (3+ files, or when quality matters)" }
+    { domain "Gate" trigger "Approving or requesting changes before a task is considered complete" routing_hint "Use as a quality gate before considering work complete" }
+    { domain "Feedback" trigger "Providing structured critique on a plan, design, or implementation" routing_hint "Use when structured feedback is needed on plans or designs" }
   ]
 }
 
@@ -21085,9 +21086,9 @@ agent warp {
   }
 
   triggers [
-    { domain "Security" trigger "Auditing code for vulnerabilities, misconfigurations, or unsafe patterns" }
-    { domain "Gate" trigger "Security approval checkpoint before shipping or merging" }
-    { domain "Threat Modeling" trigger "Identifying attack surfaces and risk areas in a design or implementation" }
+    { domain "Security" trigger "Auditing code for vulnerabilities, misconfigurations, or unsafe patterns" routing_hint "MANDATORY when changes touch auth, crypto, tokens, secrets, sessions, CORS, CSP, or input validation" }
+    { domain "Gate" trigger "Security approval checkpoint before shipping or merging" routing_hint "Use as security gate before shipping security-sensitive changes" }
+    { domain "Threat Modeling" trigger "Identifying attack surfaces and risk areas in a design or implementation" routing_hint "Use when security implications of a design need analysis" }
   ]
 }
 
@@ -21505,6 +21506,7 @@ var ALLOWED_TEMPLATE_PATHS = new Set([
   "delegation.targets.triggers",
   "delegation.targets.triggers.domain",
   "delegation.targets.triggers.trigger",
+  "delegation.targets.triggers.routing_hint",
   "delegation.targets.isCategory",
   "delegation.targets.isCategory.name",
   "delegation.targets.isCategory.description",
@@ -21519,10 +21521,16 @@ function projectDelegationTarget(target) {
       domains.push(trigger.domain);
     }
   }
-  const triggers = target.triggers.map((t) => ({
-    domain: t.domain,
-    trigger: t.trigger
-  }));
+  const triggers = target.triggers.map((t) => {
+    const entry2 = {
+      domain: t.domain,
+      trigger: t.trigger
+    };
+    if (t.routing_hint !== undefined) {
+      entry2.routing_hint = t.routing_hint;
+    }
+    return entry2;
+  });
   const entry = {
     name: target.name,
     domains,

package/dist/plugin.js

@@ -19810,7 +19810,8 @@ function refinePromptFileSafe(field) {
 var ToolPermissionSchema = exports_external.enum(["allow", "deny", "ask"]);
 var DelegationTriggerSchema = exports_external.object({
   domain: exports_external.string(),
-  trigger: exports_external.string()
+  trigger: exports_external.string(),
+  routing_hint: exports_external.string().optional()
 });
 var ToolPolicySchema = exports_external.object({
   read: ToolPermissionSchema.optional(),
@@ -20169,7 +20170,7 @@ When to delegate to each specialist:
 
 {{#delegation.targets}}
 - **{{name}}** \u2014 {{description}}{{#triggers}}
-  - {{trigger}}{{/triggers}}
+  - {{routing_hint}}{{/triggers}}
 {{/delegation.targets}}
 
 Delegate aggressively to keep your context lean. Thread and Spindle are cheap (read-only); use them liberally for evidence gathering before routing to implementation agents.
@@ -20977,10 +20978,10 @@ agent shuttle {
   }
 
   triggers [
-    { domain "Implementation" trigger "Bounded coding tasks, file edits, feature work" }
-    { domain "Testing" trigger "Writing and running tests" }
-    { domain "Debugging" trigger "Diagnosing and fixing bugs in a specific area" }
-    { domain "Refactoring" trigger "Improving code structure without changing behavior" }
+    { domain "Implementation" trigger "Bounded coding tasks, file edits, feature work" routing_hint "Use for single-file changes, bug fixes, or clearly scoped implementation tasks" }
+    { domain "Testing" trigger "Writing and running tests" routing_hint "Use when tests need to be written, updated, or debugged" }
+    { domain "Debugging" trigger "Diagnosing and fixing bugs in a specific area" routing_hint "Use when a bug needs investigation and fixing in a known area" }
+    { domain "Refactoring" trigger "Improving code structure without changing behavior" routing_hint "Use for code cleanup, renaming, or restructuring without functional changes" }
   ]
 }
 
@@ -21000,9 +21001,9 @@ agent pattern {
   }
 
   triggers [
-    { domain "Planning" trigger "Creating structured implementation plans before execution" }
-    { domain "Architecture" trigger "Designing system structure, component boundaries, and data flow" }
-    { domain "Decomposition" trigger "Breaking complex goals into discrete, sequenced tasks" }
+    { domain "Planning" trigger "Creating structured implementation plans before execution" routing_hint "Use for multi-file features, complex refactors, or work spanning 5+ steps" }
+    { domain "Architecture" trigger "Designing system structure, component boundaries, and data flow" routing_hint "Use when system design decisions need to be made before implementation" }
+    { domain "Decomposition" trigger "Breaking complex goals into discrete, sequenced tasks" routing_hint "Use when a large goal needs to be broken into an actionable plan" }
   ]
 }
 
@@ -21022,9 +21023,9 @@ agent thread {
   }
 
   triggers [
-    { domain "Exploration" trigger "Tracing symbols, call graphs, and data flow across the codebase" }
-    { domain "Discovery" trigger "Locating where a concept, pattern, or behavior is implemented" }
-    { domain "Audit" trigger "Surveying existing code before planning a change" }
+    { domain "Exploration" trigger "Tracing symbols, call graphs, and data flow across the codebase" routing_hint "Use for fast codebase exploration \u2014 read-only and cheap" }
+    { domain "Discovery" trigger "Locating where a concept, pattern, or behavior is implemented" routing_hint "Use when answering 'where is X' or 'how does Y work' questions" }
+    { domain "Audit" trigger "Surveying existing code before planning a change" routing_hint "Use to gather evidence before routing to implementation agents" }
   ]
 }
 
@@ -21044,9 +21045,9 @@ agent spindle {
   }
 
   triggers [
-    { domain "Research" trigger "Fetching external documentation, API references, or library guides" }
-    { domain "Verification" trigger "Confirming facts, versions, or behaviors against authoritative sources" }
-    { domain "Discovery" trigger "Finding relevant third-party tools, packages, or standards" }
+    { domain "Research" trigger "Fetching external documentation, API references, or library guides" routing_hint "Use for external docs and research \u2014 read-only" }
+    { domain "Verification" trigger "Confirming facts, versions, or behaviors against authoritative sources" routing_hint "Use when facts need verification against official sources" }
+    { domain "Discovery" trigger "Finding relevant third-party tools, packages, or standards" routing_hint "Use when exploring external options, libraries, or standards" }
   ]
 }
 
@@ -21066,9 +21067,9 @@ agent weft {
   }
 
   triggers [
-    { domain "Code Review" trigger "Reviewing code quality, correctness, and maintainability" }
-    { domain "Gate" trigger "Approving or requesting changes before a task is considered complete" }
-    { domain "Feedback" trigger "Providing structured critique on a plan, design, or implementation" }
+    { domain "Code Review" trigger "Reviewing code quality, correctness, and maintainability" routing_hint "Use after non-trivial changes (3+ files, or when quality matters)" }
+    { domain "Gate" trigger "Approving or requesting changes before a task is considered complete" routing_hint "Use as a quality gate before considering work complete" }
+    { domain "Feedback" trigger "Providing structured critique on a plan, design, or implementation" routing_hint "Use when structured feedback is needed on plans or designs" }
   ]
 }
 
@@ -21088,9 +21089,9 @@ agent warp {
   }
 
   triggers [
-    { domain "Security" trigger "Auditing code for vulnerabilities, misconfigurations, or unsafe patterns" }
-    { domain "Gate" trigger "Security approval checkpoint before shipping or merging" }
-    { domain "Threat Modeling" trigger "Identifying attack surfaces and risk areas in a design or implementation" }
+    { domain "Security" trigger "Auditing code for vulnerabilities, misconfigurations, or unsafe patterns" routing_hint "MANDATORY when changes touch auth, crypto, tokens, secrets, sessions, CORS, CSP, or input validation" }
+    { domain "Gate" trigger "Security approval checkpoint before shipping or merging" routing_hint "Use as security gate before shipping security-sensitive changes" }
+    { domain "Threat Modeling" trigger "Identifying attack surfaces and risk areas in a design or implementation" routing_hint "Use when security implications of a design need analysis" }
   ]
 }
 
@@ -21412,6 +21413,7 @@ var ALLOWED_TEMPLATE_PATHS = new Set([
   "delegation.targets.triggers",
   "delegation.targets.triggers.domain",
   "delegation.targets.triggers.trigger",
+  "delegation.targets.triggers.routing_hint",
   "delegation.targets.isCategory",
   "delegation.targets.isCategory.name",
   "delegation.targets.isCategory.description",
@@ -21426,10 +21428,16 @@ function projectDelegationTarget(target) {
       domains.push(trigger.domain);
     }
   }
-  const triggers = target.triggers.map((t) => ({
-    domain: t.domain,
-    trigger: t.trigger
-  }));
+  const triggers = target.triggers.map((t) => {
+    const entry2 = {
+      domain: t.domain,
+      trigger: t.trigger
+    };
+    if (t.routing_hint !== undefined) {
+      entry2.routing_hint = t.routing_hint;
+    }
+    return entry2;
+  });
   const entry = {
     name: target.name,
     domains,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@weaveio/weave-adapter-opencode",
-  "version": "0.0.0-preview-20260708131242",
+  "version": "0.0.0-preview-20260710143728",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"