plugin loader: local plugin hot-reload never re-evaluates when config dir is a symlink (stale Bun module cache) #52240

Activity

1. github-actions

   assigned

   rekram1-node

   on Sep 30, 2026
2. github-actions

   added

   needs:complianceThis means the issue will auto-close after 2 hours.This means the issue will auto-close after 2 hours.

   and removed

   needs:complianceThis means the issue will auto-close after 2 hours.This means the issue will auto-close after 2 hours.

   on Sep 30, 2026
3. github-actions commented on Sep 30, 2026

   

   github-actionsBot

   on Sep 30, 2026 – with GitHub Actions

   Contributor

   More actions

   Thanks for updating the issue with the Bug Report description and reproduction details.
4. jp41011 commented on Sep 30, 2026

   

   jp41011

   on Sep 30, 2026

   Last edited by jp41011

   Author

   More actions

   This does seem related to a previous issue: #51602
   But it looks like that one was automatically closed.

   Main issue content was by the report skill built into opencode.
   I'll leave that in case its useful.

   Additional information from the human:
   I noticed this issue because i had setup the herdr plugin for opencode while i was using opencode v1.
   I then upgraded to opencode v2. I ran the opencode v1 to v2 migration
   But I think at the time herdr did not have a version that was compatible with opeoncode v2.
   I just ignored the popup message with the herdr plugin error message.
   Until today when i finally had enough energy to update some skills and plugins.
   I updated herdr. Their site says it now supports opencode v2.

   I closed and reopened opencode. Thinking that restart would be enough.
   but I still got the herdr plugin error message on startup.

   I forgot about the switch to the opencode service, in opencode v2, running in the background and i technically did not restart that.

   So maybe this can be attributed to the dumb human behind the keyboard.
   Or maybe a reminder can be shown to the user reminding them they need to restart the opencode service and not just the client instance. I don't know. Documenting it here in case its useful to someone else in the future.

   p.s. I do have a dotfiles folder that I symlink to my ~/.config/opencode/ directory using gnu stow. I don't think that was the main issue. But maybe it didn't help with the caching.

   Thank you.
5. opencodejr commented on Oct 28, 2026

   

   opencodejrBot

   on Oct 28, 2026

   More actions

   Thanks for the detailed report and the minimal repro. I could reproduce this.

   On 2.0.20: I made ~/.config/opencode a symlink to a real directory containing package.json and plugins/herdr-agent-state.js, with only a named export in the plugin. The service failed to load the plugin, as expected for that file. I then added export default { id: "herdr.opencode", setup() {} } in place. The watcher triggered a reload, and it failed again with the same SchemaError(Missing key at ["default"]).

   On the latest dev (86ce19d), run from source: the script below edits the plugin and reads it again. It shows the same thing:

   • With a real config directory, the reload picks up the new default export.
   • With a symlinked one, the reload still returns the old module.

   This matches your analysis: source.bun.ts clears the module cache using the symlink path, not the resolved real path. Until it's addressed, restarting the service after editing the plugin (or pointing the config at the real directory) works around it.

   Reproduction script (reload-symlink.ts)

   // Reproduces #52240: local plugin reload returns a stale module when the plugin
   // path goes through a symlinked directory (Bun runtime).
   // Run from a checkout: bun /workspace/repro/reload-symlink.ts [/path/to/opencode/repo]
   import { mkdtempSync, mkdirSync, writeFileSync, symlinkSync, realpathSync } from "node:fs"
   import os from "node:os"
   import path from "node:path"
   import { pathToFileURL } from "node:url"
   
   const repo = process.argv[2] ?? "/workspace/repo"
   const { createPluginSources } = await import(path.join(repo, "packages/plugin/src/source.ts"))
   
   for (const linked of [false, true]) {
     const base = mkdtempSync(path.join(os.tmpdir(), "oc-52240-"))
     const real = path.join(base, "dotfiles-opencode")
     mkdirSync(path.join(real, "plugins"), { recursive: true })
     writeFileSync(path.join(real, "package.json"), "{}\n")
     const config = linked ? path.join(base, "config-opencode") : real
     if (linked) symlinkSync(real, config, "dir")
     const file = path.join(config, "plugins", "herdr-agent-state.js")
     writeFileSync(file, "export const HerdrAgentStatePlugin = async () => ({})\n")
   
     const sources = createPluginSources(async () => {})
     const entry = pathToFileURL(file).href
     const first = await sources.read(entry)
     // edit the file in place (as the watcher-triggered reload would see)
     writeFileSync(
       file,
       'export const HerdrAgentStatePlugin = async () => ({})\nexport default { id: "herdr.opencode", setup() {} }\n',
     )
     const second = await sources.read(entry)
     console.log(
       `${linked ? "symlinked" : "real     "} config dir: first=${JSON.stringify(Object.keys(first.module))} ` +
         `reload=${JSON.stringify(Object.keys(second.module))} versionChanged=${first.version !== second.version}` +
         (linked ? ` (real path ${realpathSync(file)})` : ""),
     )
     sources.dispose()
   }

   Run it: bun reload-symlink.ts
6. opencodejr

   added

   reproduced

   on Oct 28, 2026