opencode-resolve 0.1.16 → 0.1.18

package/README.ko.md

@@ -52,6 +52,15 @@ opencode plugin opencode-resolve --global --force
 
 ## 설치
 
+### 한 줄 설치 (권장)
+
+```sh
+npm install -g opencode-resolve@latest
+opencode-resolve setup
+```
+
+`opencode-resolve setup`이 `opencode.json`의 provider/model을 자동 감지하고, 합리적인 기본값으로 짧은 Q&A를 거친 뒤(엔터로 모두 통과 가능) `resolve.json`을 작성하고 OpenCode 플러그인 캐시를 새로고침합니다. 모델 핀을 보존한 채 언제든 다시 실행해 재설정할 수 있습니다.
+
 ### 요구 사항
 
 - OpenCode 실행 가능: `opencode --version`

package/README.md

@@ -52,6 +52,15 @@ Default enabled agents:
 
 ## Install
 
+### One command (recommended)
+
+```sh
+npm install -g opencode-resolve@latest
+opencode-resolve setup
+```
+
+`opencode-resolve setup` auto-detects your providers and models from `opencode.json`, walks you through a short Q&A with sensible defaults (press enter to accept each), writes `resolve.json`, and refreshes the OpenCode plugin cache. Re-run any time to reconfigure without losing your model pins.
+
 ### Requirements
 
 - OpenCode installed and runnable: `opencode --version`

package/dist/index.js

@@ -3,9 +3,20 @@ export * from "./agents.js";
 export * from "./utils.js";
 export * from "./config.js";
 export * from "./state.js";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
 import { getTools } from "./tools/index.js";
 import { getHooks } from "./hooks/index.js";
 import { createSessionState } from "./state.js";
+import { PLUGIN_VERSION } from "./utils.js";
+if (process.env.OPENCODE_RESOLVE_QUIET !== "1") {
+    let where = "";
+    try {
+        where = ` (from: ${dirname(fileURLToPath(import.meta.url))})`;
+    }
+    catch { /* ignore */ }
+    console.log(`[opencode-resolve] v${PLUGIN_VERSION} loaded${where}`);
+}
 export const OpencodeResolve = async ({ directory }, options) => {
     const sessionState = createSessionState();
     return {

package/dist/tools/index.d.ts

@@ -238,6 +238,11 @@ export declare function getTools(sessionState: SessionState): {
         args: {};
         execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<import("@opencode-ai/plugin").ToolResult>;
     };
+    "resolve-version": {
+        description: string;
+        args: {};
+        execute(args: Record<string, never>, context: import("@opencode-ai/plugin").ToolContext): Promise<import("@opencode-ai/plugin").ToolResult>;
+    };
     "resolve-state": {
         description: string;
         args: {

package/dist/tools/index.js

@@ -2,7 +2,9 @@ import { tool } from "@opencode-ai/plugin";
 import { stat, readFile, access } from "node:fs/promises";
 import { resolve, join } from "node:path";
 import { writeFileSync, mkdirSync } from "node:fs";
-import { classifyBashCommand, runCommand, sanitizeShellArg, truncateOutput } from "../utils.js";
+import { fileURLToPath } from "node:url";
+import { dirname } from "node:path";
+import { classifyBashCommand, runCommand, sanitizeShellArg, truncateOutput, PLUGIN_VERSION } from "../utils.js";
 import { DIAGNOSTICS_TTL_MS } from "../state.js";
 import { VALID_PROFILES, VALID_TIERS, VALID_AGENT_NAME_SET, VALID_AGENT_NAMES } from "../agents.js";
 const WRITE_CAPABLE_AGENTS = new Set(["resolver", "codex", "coder", "glm", "gpt-coder", "debugger"]);
@@ -1140,6 +1142,23 @@ export function getTools(sessionState) {
                 return results.join("\n");
             },
         }),
+        "resolve-version": tool({
+            description: "Report the currently loaded opencode-resolve plugin version and the cache path it was loaded from. Use to confirm whether a recent install/update actually took effect inside OpenCode.",
+            args: {},
+            async execute(_args, ctx) {
+                let loadedFrom = "unknown";
+                try {
+                    loadedFrom = dirname(fileURLToPath(import.meta.url));
+                }
+                catch { /* ignore */ }
+                const lines = [
+                    `opencode-resolve v${PLUGIN_VERSION}`,
+                    `loaded from: ${loadedFrom}`,
+                ];
+                ctx.metadata({ title: `version: v${PLUGIN_VERSION}` });
+                return lines.join("\n");
+            },
+        }),
         "resolve-state": tool({
             description: "Read or write session state checkpoints to .opencode/resolve-state.json. Enables session resumption and cross-turn state persistence. Use 'save' to checkpoint current progress, 'load' to read last checkpoint.",
             args: {

package/package.json

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

package/scripts/postinstall.mjs

@@ -84,11 +84,41 @@ if (process.env.OPENCODE_RESOLVE_SKIP_POSTINSTALL === "1") {
 const pluginVersion = await readOwnVersion()
 console.log(`[${packageName}] installing v${pluginVersion}`)
 
+async function printSummaryBanner(version) {
+  let resolveSummary = ""
+  try {
+    const raw = await readFile(resolveConfigPath, "utf8")
+    const cfg = JSON.parse(raw)
+    const parts = []
+    if (cfg.profile) parts.push(`profile=${cfg.profile}`)
+    if (cfg.tier) parts.push(`tier=${cfg.tier}`)
+    const enabled = Array.isArray(cfg.enabled) ? cfg.enabled.length : Object.keys(cfg.agents ?? {}).length
+    if (enabled) parts.push(`${enabled} agents`)
+    if (parts.length > 0) resolveSummary = parts.join(", ")
+  } catch { /* file may not exist on partial flows */ }
+
+  const lines = [
+    `✓ opencode-resolve v${version} installed`,
+    `  Config: ${resolveConfigPath}${resolveSummary ? `  (${resolveSummary})` : ""}`,
+    `  Next:   restart OpenCode to load the plugin`,
+    `  Verify: opencode run "list available agents"   (must show resolver + coder)`,
+    `          or inside any session: run resolve-version`,
+  ]
+  const width = Math.max(...lines.map((l) => l.length)) + 2
+  const bar = "═".repeat(Math.min(width, 100))
+  console.log("")
+  console.log(bar)
+  for (const line of lines) console.log(line)
+  console.log(bar)
+  console.log("")
+}
+
 try {
   await registerPlugin()
   await refreshSelfPluginCache(pluginVersion)
   await offerCompanionPlugins()
   console.log(`[${packageName}] v${pluginVersion} install complete — restart OpenCode to load the plugin`)
+  await printSummaryBanner(pluginVersion)
 } catch (error) {
   console.warn(`[${packageName}] automatic OpenCode registration skipped: ${formatError(error)}`)
   console.warn(`[${packageName}] add "${packageName}" to your OpenCode plugin list manually if needed.`)
@@ -359,8 +389,10 @@ async function createAdaptiveResolveConfig(opencodeConfig, scriptedAnswers, opti
   } else if (preservedModels) {
     resolveConfig.models = { ...preservedModels }
   } else {
-    console.log(`[${packageName}] no GPT/GLM models detected in opencode.json — agents inherit the top-level model`)
-    console.log(`[${packageName}] to configure model pinning, rerun setup in a TTY or edit ${resolveConfigPath}`)
+    const providerHint = currentModel ? ` (top-level model: ${currentModel})` : ""
+    console.log(`[${packageName}] no GPT/GLM models detected in opencode.json — agents inherit the top-level model${providerHint}`)
+    console.log(`[${packageName}] to pin role-specific models, edit ${resolveConfigPath} ("models" section)`)
+    console.log(`[${packageName}] or rerun setup in a TTY: ${packageName} setup --models`)
   }
 
   await writeFile(resolveConfigPath, `${JSON.stringify(resolveConfig, null, 2)}\n`)
@@ -563,8 +595,13 @@ async function buildInteractivePreset(currentModel, allModels, scriptedAnswers)
   const rl = createPromptInterface(scriptedAnswers)
   try {
     console.log("")
-    console.log(`[${packageName}] Choose resolve profile:`)
-    console.log("  1. mix — neutral resolver plus optional Codex and GLM primary agents")
+    console.log("──────────────────────────────────────────────────────────────")
+    console.log(` opencode-resolve setup`)
+    console.log(` Press enter at any prompt to accept the default in [brackets].`)
+    console.log("──────────────────────────────────────────────────────────────")
+    console.log("")
+    console.log(`[${packageName}] Step 1/2 — Choose resolve profile:`)
+    console.log("  1. mix — neutral resolver plus optional Codex and GLM primary agents (recommended)")
     console.log("  2. gpt — GPT/Codex-only, three-tier")
     console.log("  3. glm — GLM-only, three-tier")
     const profileAnswer = await askChoice(rl, "Profile [1=mix, 2=gpt, 3=glm, default 1]: ", ["1", "2", "3"], "1")