@snarkipus/opencode-beads 0.9.4 → 0.10.0

package/README.md

@@ -30,7 +30,7 @@ Add the version-pinned plugin to `~/.config/opencode/opencode.json`:
 
 ```json
 {
-  "plugin": ["@snarkipus/opencode-beads@0.9.4"]
+  "plugin": ["@snarkipus/opencode-beads@0.10.0"]
 }
 ```
 
@@ -38,13 +38,13 @@ Restart OpenCode. Update the pin explicitly when upgrading; an unpinned package
 
 ### 0.9.3 recovery notice
 
-Version 0.9.3 contained command guidance from the withdrawn upstream Beads v1.2.1 release. This plugin did not bundle the `bd` binary or implement database migrations, but it could invoke a consumer-installed v1.2.1 binary through `bd prime`. Even one v1.2.1 execution could migrate the database. Upgrade the plugin package to 0.9.4; if v1.2.1 was installed and may have run, also follow the [upstream database recovery guidance](https://github.com/gastownhall/beads/blob/v1.2.2/docs/RECOVERY-1.2.1.md).
+Version 0.9.3 contained command guidance from the withdrawn upstream Beads v1.2.1 release. This plugin did not bundle the `bd` binary or implement database migrations, but it could invoke a consumer-installed v1.2.1 binary through `bd prime`. Even one v1.2.1 execution could migrate the database. Upgrade the plugin package to 0.9.4 or later; if v1.2.1 was installed and may have run, also follow the [upstream database recovery guidance](https://github.com/gastownhall/beads/blob/v1.2.2/docs/RECOVERY-1.2.1.md).
 
 ## Context injection
 
 The plugin runs full `bd prime` when a primary-agent session first receives a message and after compaction. Prime supplies the canonical current workflow, command guidance, and persistent memories; the plugin adds only compact OpenCode-specific safety and delegation guidance.
 
-Known regular subagents remain excluded, including `explore` and `general`, while `beads-task-agent` remains eligible. If agent lookup fails, context injection fails open to preserve compatibility with unknown custom primary agents.
+Known regular subagents remain excluded, including `explore` and `general`, while `beads-task-agent` and `beads-task-agent-luna` remain eligible. If agent lookup fails, context injection fails open to preserve compatibility with unknown custom primary agents.
 
 If `bd` is unavailable, the project is uninitialized, or prime fails or returns no content, injection is silently skipped and remains retryable. Vendored commands stay available, and the task agent retains a bounded standalone quick reference for `ready`, `show`, atomic claim, discovered follow-up, validate before closure, and close.
 
@@ -52,7 +52,7 @@ If `bd` is unavailable, the project is uninitialized, or prime fails or returns
 
 Vendored workflows are registered under `/beads:*`, including `/beads:ready`, `/beads:create`, and `/beads:show`. The plugin does not generate a command for every `bd` subcommand; use the CLI and the generated [Beads CLI reference](https://beads.gascity.com/cli-reference/index) for the complete surface.
 
-Explicit command and agent definitions in OpenCode configuration take precedence over plugin definitions with the same name. Exact `beads:*` or `beads-task-agent` collisions produce a grouped, rate-limited warning without preventing non-conflicting definitions from loading.
+Explicit command definitions in OpenCode configuration replace plugin commands with the same name. Task-agent overrides merge field-by-field over plugin defaults, so a partial override does not discard the bounded prompt or subagent mode. Explicit fields (including `prompt`, `permission`, `tools`, `model`, `variant`, and `disable`) win; nested fields are replaced, not deep-merged. Conflicting `beads:*` commands or either named task-agent profile produce a grouped, rate-limited warning without preventing definitions from loading. An empty profile opt-in does not warn.
 
 ## Task agent
 
@@ -60,6 +60,26 @@ Explicit command and agent definitions in OpenCode configuration take precedence
 
 Its runtime prompt is a fork-owned bounded OpenCode adaptation. The vendored upstream task-agent artifact supplies metadata, provenance, and compatibility validation; it is not executed as upstream's autonomous multi-task loop.
 
+### Opt-in Luna Max profile
+
+The default `beads-task-agent` leaves model and reasoning variant unset, preserving OpenCode's caller inheritance. To add the named Luna Max profile, merge this entry into your project `opencode.json` alongside the plugin entry:
+
+```json
+{
+  "agent": {
+    "beads-task-agent-luna": {}
+  }
+}
+```
+
+The plugin fills this profile with `model: "openai/gpt-5.6-luna"` and `variant: "max"`, using exactly the same shared prompt, subagent mode, and inherited permissions/tools as the vanilla agent. Per-agent overrides remain independent: customizations to `beads-task-agent` are not copied to Luna. Both profiles get full prime context at startup and after compaction and retain the same exact-one-Bead workflow.
+
+Choose `beads-task-agent-luna` explicitly as the task tool's `subagent_type` (or ask the primary agent to delegate to that name). Default delegation guidance still names `beads-task-agent`; enabling Luna does not reroute existing calls or change the primary agent's model/variant. No extra orchestrator or plugin-specific config file is involved.
+
+Omit the Luna entry from the effective configuration to keep it unregistered; set `"disable": true` inside the entry to disable it using OpenCode's normal agent configuration. To undo the opt-in, remove the entry at its source and restart OpenCode; omission in a child project does not remove an ancestor/global entry. Explicit routing or prompt overrides are honored, so changing those fields opts out of the corresponding profile defaults.
+
+Luna requires access to `openai/gpt-5.6-luna` and its `max` variant in your OpenCode provider setup. The plugin does not install models, configure authentication, or silently fall back to another model. Native Luna Max routing was verified on OpenCode 1.18.29; the plugin's general compatibility range is not a guarantee that every provider account exposes this model.
+
 ## Vendored content
 
 [`scripts/sync-beads.sh`](scripts/sync-beads.sh) copies the reviewed upstream command templates and task-agent artifact into `vendor/`. [`vendor/manifest.json`](vendor/manifest.json) pins the upstream tag and commit and records source paths, sorted inventory, byte lengths, and SHA-256 checksums. A deterministic adaptation layer translates reviewed host-specific instructions to OpenCode's CLI-only model.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@snarkipus/opencode-beads",
-  "version": "0.9.4",
+  "version": "0.10.0",
   "type": "module",
   "description": "A maintained OpenCode integration for the Beads issue tracker, including context injection, vendored workflows, and a task agent.",
   "author": "Matt Jackson",

package/src/plugin-core.ts

@@ -1,4 +1,5 @@
 import type { Hooks } from "@opencode-ai/plugin";
+import type { AgentConfig as AgentConfigV2 } from "@opencode-ai/sdk/v2";
 import type {
   Agent,
   SessionMessagesResponse,
@@ -11,6 +12,12 @@ import { PrimeTimeoutError } from "./prime";
 import { beadsGuidance, loadAgent, loadCommands } from "./vendor";
 
 const BEADS_TASK_AGENT = "beads-task-agent";
+const BEADS_TASK_AGENT_LUNA = "beads-task-agent-luna";
+
+/** Both named profiles use the same bounded task-agent context. */
+function isBeadsTaskAgent(name: string | undefined): boolean {
+  return name === BEADS_TASK_AGENT || name === BEADS_TASK_AGENT_LUNA;
+}
 
 type ChatMessageInput = Parameters<NonNullable<Hooks["chat.message"]>>[0];
 type SessionMessageResponse = SessionMessagesResponse[number];
@@ -99,7 +106,7 @@ function beadsContextAudience(text: string): InjectionAudience | undefined {
 }
 
 function injectionAudience(agentName: string | undefined): InjectionAudience {
-  return agentName === BEADS_TASK_AGENT ? "task-agent" : "primary";
+  return isBeadsTaskAgent(agentName) ? "task-agent" : "primary";
 }
 
 /** Resolve OpenCode project scope without falling back to the process directory. */
@@ -160,7 +167,7 @@ export async function createBeadsController(
     agentName: string | undefined,
     sessionID: string
   ): Promise<boolean> {
-    if (!agentName || agentName === BEADS_TASK_AGENT) return true;
+    if (!agentName || isBeadsTaskAgent(agentName)) return true;
 
     const availableAgents = await runtime.getAgents(directory).catch(async () => {
       await diagnoseSession("agents_lookup_failed", sessionID);
@@ -315,16 +322,29 @@ export async function createBeadsController(
     },
 
     async configure(config) {
+      // A named config entry opts in without another plugin option or config file.
+      const configuredAgents = { ...agents };
+      if (Object.hasOwn(config.agent ?? {}, BEADS_TASK_AGENT_LUNA)) {
+        configuredAgents[BEADS_TASK_AGENT_LUNA] = {
+          ...agents[BEADS_TASK_AGENT],
+          model: "openai/gpt-5.6-luna",
+          variant: "max",
+        } satisfies AgentConfigV2;
+      }
       const commandCollisions = Object.keys(config.command ?? {})
         .filter(
           (name) =>
             Object.hasOwn(commands, name) && config.command?.[name] !== commands[name]
         )
         .sort();
-      const agentCollisions = Object.keys(config.agent ?? {})
-        .filter(
-          (name) => Object.hasOwn(agents, name) && config.agent?.[name] !== agents[name]
+      const agentCollisions = Object.entries(configuredAgents)
+        .filter(([name, defaults]) =>
+          defaults !== undefined &&
+          Object.entries(config.agent?.[name] ?? {}).some(
+            ([key, value]) => value !== defaults[key]
+          )
         )
+        .map(([name]) => name)
         .sort();
 
       await Promise.all(
@@ -341,7 +361,11 @@ export async function createBeadsController(
       );
 
       config.command = { ...commands, ...config.command };
-      config.agent = { ...agents, ...config.agent };
+      const mergedAgents = { ...config.agent };
+      for (const [name, defaults] of Object.entries(configuredAgents)) {
+        mergedAgents[name] = { ...defaults, ...config.agent?.[name] };
+      }
+      config.agent = mergedAgents;
     },
   };
 }