opencode-resolve 0.1.10 → 0.1.11

package/README.ko.md

@@ -176,6 +176,30 @@ OPENCODE_RESOLVE_SKIP_POSTINSTALL=1 npm install -g opencode-resolve
 opencode plugin opencode-resolve --global --force
 ```
 
+그래도 OpenCode가 계속 예전 패키지를 로드하면, OpenCode 플러그인 캐시 항목만 지우고 다시 설치하세요. 이 절차는 `~/.config/opencode/resolve.json`을 삭제하지 않습니다.
+
+Linux/macOS:
+
+```sh
+export OPENCODE_CACHE_ROOT="${XDG_CACHE_HOME:-$HOME/.cache}/opencode"
+rm -rf "$OPENCODE_CACHE_ROOT/packages/opencode-resolve@latest"
+opencode plugin opencode-resolve@latest --global --force
+node -e "console.log(require(process.env.OPENCODE_CACHE_ROOT + '/packages/opencode-resolve@latest/node_modules/opencode-resolve/package.json').version)"
+```
+
+Windows PowerShell:
+
+```powershell
+$OpenCodeCacheRoot = if ($env:XDG_CACHE_HOME) { Join-Path $env:XDG_CACHE_HOME "opencode" } else { Join-Path $env:LOCALAPPDATA "opencode" }
+$PluginCache = Join-Path $OpenCodeCacheRoot "packages\opencode-resolve@latest"
+Remove-Item -Recurse -Force $PluginCache -ErrorAction SilentlyContinue
+opencode plugin opencode-resolve@latest --global --force
+$Pkg = Join-Path $PluginCache "node_modules\opencode-resolve\package.json"
+node -e "console.log(require(process.argv[1]).version)" $Pkg
+```
+
+캐시 새로고침 후 OpenCode를 재시작하세요.
+
 ### 수동 대안
 
 `postinstall`이 플러그인을 등록하지 않았다면, `~/.config/opencode/opencode.json`에 직접 추가:
@@ -864,6 +888,28 @@ opencode plugin opencode-resolve --global --force
 # OpenCode 재시작
 ```
 
+그래도 버전이 바뀌지 않으면 OpenCode가 패키지 캐시를 재사용하는 상태입니다. 해당 플러그인 캐시 항목만 hard refresh 하세요:
+
+Linux/macOS:
+
+```sh
+export OPENCODE_CACHE_ROOT="${XDG_CACHE_HOME:-$HOME/.cache}/opencode"
+rm -rf "$OPENCODE_CACHE_ROOT/packages/opencode-resolve@latest"
+opencode plugin opencode-resolve@latest --global --force
+node -e "console.log(require(process.env.OPENCODE_CACHE_ROOT + '/packages/opencode-resolve@latest/node_modules/opencode-resolve/package.json').version)"
+```
+
+Windows PowerShell:
+
+```powershell
+$OpenCodeCacheRoot = if ($env:XDG_CACHE_HOME) { Join-Path $env:XDG_CACHE_HOME "opencode" } else { Join-Path $env:LOCALAPPDATA "opencode" }
+$PluginCache = Join-Path $OpenCodeCacheRoot "packages\opencode-resolve@latest"
+Remove-Item -Recurse -Force $PluginCache -ErrorAction SilentlyContinue
+opencode plugin opencode-resolve@latest --global --force
+$Pkg = Join-Path $PluginCache "node_modules\opencode-resolve\package.json"
+node -e "console.log(require(process.argv[1]).version)" $Pkg
+```
+
 업그레이드 후 `postinstall`이 `resolve.json`에 추가적 마이그레이션을 실행합니다 — 새 키가 추가되고, 기존 키는 절대 수정되지 않습니다.
 
 ### 특정 버전 고정

package/README.md

@@ -176,6 +176,30 @@ OPENCODE_RESOLVE_SKIP_POSTINSTALL=1 npm install -g opencode-resolve
 opencode plugin opencode-resolve --global --force
 ```
 
+If OpenCode keeps loading the old package anyway, clear only the OpenCode plugin cache entry and install again. This does **not** delete `~/.config/opencode/resolve.json`.
+
+Linux/macOS:
+
+```sh
+export OPENCODE_CACHE_ROOT="${XDG_CACHE_HOME:-$HOME/.cache}/opencode"
+rm -rf "$OPENCODE_CACHE_ROOT/packages/opencode-resolve@latest"
+opencode plugin opencode-resolve@latest --global --force
+node -e "console.log(require(process.env.OPENCODE_CACHE_ROOT + '/packages/opencode-resolve@latest/node_modules/opencode-resolve/package.json').version)"
+```
+
+Windows PowerShell:
+
+```powershell
+$OpenCodeCacheRoot = if ($env:XDG_CACHE_HOME) { Join-Path $env:XDG_CACHE_HOME "opencode" } else { Join-Path $env:LOCALAPPDATA "opencode" }
+$PluginCache = Join-Path $OpenCodeCacheRoot "packages\opencode-resolve@latest"
+Remove-Item -Recurse -Force $PluginCache -ErrorAction SilentlyContinue
+opencode plugin opencode-resolve@latest --global --force
+$Pkg = Join-Path $PluginCache "node_modules\opencode-resolve\package.json"
+node -e "console.log(require(process.argv[1]).version)" $Pkg
+```
+
+Restart OpenCode after the cache refresh.
+
 ### Manual fallback
 
 If `postinstall` didn't register the plugin, add it to `~/.config/opencode/opencode.json` yourself:
@@ -864,6 +888,28 @@ opencode plugin opencode-resolve --global --force
 # Restart OpenCode
 ```
 
+If the version still does not change, OpenCode is reusing its package cache. Hard-refresh that one plugin entry:
+
+Linux/macOS:
+
+```sh
+export OPENCODE_CACHE_ROOT="${XDG_CACHE_HOME:-$HOME/.cache}/opencode"
+rm -rf "$OPENCODE_CACHE_ROOT/packages/opencode-resolve@latest"
+opencode plugin opencode-resolve@latest --global --force
+node -e "console.log(require(process.env.OPENCODE_CACHE_ROOT + '/packages/opencode-resolve@latest/node_modules/opencode-resolve/package.json').version)"
+```
+
+Windows PowerShell:
+
+```powershell
+$OpenCodeCacheRoot = if ($env:XDG_CACHE_HOME) { Join-Path $env:XDG_CACHE_HOME "opencode" } else { Join-Path $env:LOCALAPPDATA "opencode" }
+$PluginCache = Join-Path $OpenCodeCacheRoot "packages\opencode-resolve@latest"
+Remove-Item -Recurse -Force $PluginCache -ErrorAction SilentlyContinue
+opencode plugin opencode-resolve@latest --global --force
+$Pkg = Join-Path $PluginCache "node_modules\opencode-resolve\package.json"
+node -e "console.log(require(process.argv[1]).version)" $Pkg
+```
+
 After upgrading, `postinstall` runs additive migration on your `resolve.json` — new keys are added, existing keys are never modified.
 
 ### Pinning a specific version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "opencode-resolve",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "OpenCode plugin that adds a lightweight resolver/coder harness for continuous agentic coding.",
   "type": "module",
   "homepage": "https://github.com/jshsakura/opencode-resolve#readme",

package/scripts/postinstall.mjs

@@ -91,30 +91,55 @@ async function registerPlugin() {
   await mkdir(configDir, { recursive: true })
   const scriptedAnswers = await readScriptedAnswersIfNeeded()
 
-  const config = await readOpenCodeConfig()
-  let configChanged = addPlugin(config)
-
-  // Inject ZAI MCP servers when GLM is detected
-  const allModels = detectAllModels(config)
+  const probe = await readOpenCodeConfig()
+  const allModels = detectAllModels(probe)
   const hasGLM = allModels.some((m) => isGLMModel(m))
-  if (hasGLM) {
-    const mcpChanged = await injectZAIMCPs(config)
-    configChanged = configChanged || mcpChanged
-  }
+  const pluginNeeded = !isPluginRegisteredIn(probe)
+  const missingMCPNames = hasGLM
+    ? Object.keys(ZAI_MCP_SERVERS).filter((name) => probe.mcp?.[name] === undefined)
+    : []
 
-  if (configChanged) {
-    await writeFile(opencodeConfigPath, `${JSON.stringify(config, null, 2)}\n`)
+  if (pluginNeeded || missingMCPNames.length > 0) {
+    const fresh = await readOpenCodeConfig()
+    if (pluginNeeded) applyPluginPatch(fresh)
+    if (missingMCPNames.length > 0) applyMCPPatches(fresh, missingMCPNames)
+    await writeFile(opencodeConfigPath, `${JSON.stringify(fresh, null, 2)}\n`)
     console.log(`[${packageName}] updated ${opencodeConfigPath}`)
   } else {
     console.log(`[${packageName}] already registered in ${opencodeConfigPath}`)
   }
 
   if (!(await exists(resolveConfigPath))) {
-    await createAdaptiveResolveConfig(config, scriptedAnswers)
+    await createAdaptiveResolveConfig(probe, scriptedAnswers)
     return
   }
 
-  await handleExistingResolveConfig(config, scriptedAnswers)
+  await handleExistingResolveConfig(probe, scriptedAnswers)
+}
+
+function isPluginRegisteredIn(config) {
+  return Array.isArray(config.plugin) && config.plugin.some(isRegisteredPluginEntry)
+}
+
+function applyPluginPatch(config) {
+  config.plugin ??= []
+  if (!Array.isArray(config.plugin)) {
+    throw new Error(`${opencodeConfigPath}.plugin must be an array`)
+  }
+  if (!config.plugin.some(isRegisteredPluginEntry)) {
+    config.plugin.push(packageName)
+  }
+}
+
+function applyMCPPatches(config, names) {
+  config.mcp ??= {}
+  for (const name of names) {
+    if (config.mcp[name] === undefined) {
+      config.mcp[name] = ZAI_MCP_SERVERS[name]
+    }
+  }
+  console.log(`[${packageName}] injected ZAI MCP server config: ${names.join(", ")}`)
+  console.log(`[${packageName}] note: API keys are not copied into opencode.json; export Z_AI_API_KEY if the MCP server requires it.`)
 }
 
 async function handleExistingResolveConfig(opencodeConfig, scriptedAnswers) {
@@ -724,38 +749,7 @@ async function readOpenCodeConfig() {
   return parsed
 }
 
-function addPlugin(config) {
-  config.plugin ??= []
-  if (!Array.isArray(config.plugin)) {
-    throw new Error(`${opencodeConfigPath}.plugin must be an array`)
-  }
-
-  if (config.plugin.some(isRegisteredPluginEntry)) return false
-  config.plugin.push(packageName)
-  return true
-}
-
-async function injectZAIMCPs(config) {
-  config.mcp ??= {}
-  if (!isObject(config.mcp)) return false
-
-  const added = []
-  for (const [name, mcpConfig] of Object.entries(ZAI_MCP_SERVERS)) {
-    if (config.mcp[name] === undefined) {
-      config.mcp[name] = mcpConfig
-      added.push(name)
-    }
-  }
 
-  if (added.length > 0) {
-    console.log(`[${packageName}] injected ZAI MCP server config: ${added.join(", ")}`)
-    console.log(`[${packageName}] note: API keys are not copied into opencode.json; export Z_AI_API_KEY if the MCP server requires it.`)
-    return true
-  }
-
-  console.log(`[${packageName}] ZAI MCP server already present — skipping`)
-  return false
-}
 
 function isRegisteredPluginEntry(entry) {
   if (typeof entry === "string") return isResolvePluginName(entry)
@@ -879,13 +873,25 @@ async function installCompanion(pkg) {
 }
 
 async function addCompanionToOpenCodeConfig(pluginEntry) {
-  const config = await readOpenCodeConfig()
-  config.plugin ??= []
-  if (!Array.isArray(config.plugin)) {
-    throw new Error(`${opencodeConfigPath}.plugin must be an array`)
-  }
   const baseName = stripVersionSuffix(pluginEntry)
-  const alreadyPresent = config.plugin.some((entry) => {
+  const probe = await readOpenCodeConfig()
+  const alreadyPresent = isCompanionPresent(probe, baseName)
+  if (alreadyPresent) return
+
+  const fresh = await readOpenCodeConfig()
+  if (!isCompanionPresent(fresh, baseName)) {
+    fresh.plugin ??= []
+    if (!Array.isArray(fresh.plugin)) {
+      throw new Error(`${opencodeConfigPath}.plugin must be an array`)
+    }
+    fresh.plugin.push(pluginEntry)
+    await writeFile(opencodeConfigPath, `${JSON.stringify(fresh, null, 2)}\n`)
+  }
+}
+
+function isCompanionPresent(config, baseName) {
+  if (!Array.isArray(config.plugin)) return false
+  return config.plugin.some((entry) => {
     const raw = typeof entry === "string"
       ? entry
       : Array.isArray(entry) && typeof entry[0] === "string"
@@ -893,7 +899,4 @@ async function addCompanionToOpenCodeConfig(pluginEntry) {
         : null
     return raw !== null && stripVersionSuffix(raw) === baseName
   })
-  if (alreadyPresent) return
-  config.plugin.push(pluginEntry)
-  await writeFile(opencodeConfigPath, `${JSON.stringify(config, null, 2)}\n`)
 }