opencode-worker 0.1.1 → 0.1.3

package/README.md

@@ -5,7 +5,8 @@ Run the official OpenCode CLI as an isolated, time-boxed worker. One package, tw
 - `opencode-worker run` — CLI, prints one JSON result
 - `opencode-worker mcp` — MCP stdio server (async jobs)
 
-No dependencies. Node ≥ 20. OpenCode is **not** bundled: pass `--opencode-bin`, set `OPENCODE_WORKER_BIN`, or have `opencode` on `PATH`.
+No dependencies. Node ≥ 20. OpenCode is **not** bundled: pass `--opencode-bin`, set `OPENCODE_WORKER_BIN`, or have `opencode` on `PATH` (checked in that order).
+A set-but-empty `--opencode-bin`/`OPENCODE_WORKER_BIN` fails with `BIN_EMPTY` instead of falling back to `PATH`; this usually means a shell variable was not expanded in your MCP config.
 
 ## Safety defaults
 
@@ -90,3 +91,14 @@ Closing stdin or SIGINT/SIGTERM/SIGHUP cancels running jobs and records them as
 
 - `<dir>/.opencode-worker/` holds state, snapshots and logs per run; delete it when done.
 - The before-snapshot copies the whole directory: use small, task-scoped directories.
+
+## Releasing
+
+Publishing runs in GitHub Actions via npm Trusted Publishing (OIDC): no npm token or OTP.
+
+```sh
+npm version patch        # bumps package.json, commits, tags vX.Y.Z
+git push --follow-tags   # the tag triggers .github/workflows/publish.yml
+```
+
+The workflow fails if the tag does not match `package.json` `version`.

package/lib/worker.mjs

@@ -22,14 +22,20 @@ export class WorkerError extends Error {
 }
 
 export function resolveOpencodeBin(explicit) {
-  const candidates = [explicit, process.env.OPENCODE_WORKER_BIN].filter(Boolean);
-  for (const c of candidates) {
-    if (fs.existsSync(c)) return path.resolve(c);
-    throw new WorkerError("BIN_NOT_FOUND", `opencode binary not found: ${c}`);
+  const sources = [
+    ["--opencode-bin", explicit],
+    ["OPENCODE_WORKER_BIN", process.env.OPENCODE_WORKER_BIN],
+  ];
+  for (const [name, value] of sources) {
+    if (value === undefined || value === null) continue;
+    // A set-but-empty value is almost always an unexpanded shell variable; never fall back to PATH silently.
+    if (value.trim() === "") throw new WorkerError("BIN_EMPTY", `${name} is set but empty; give the absolute path to the opencode binary`);
+    if (!fs.existsSync(value)) throw new WorkerError("BIN_NOT_FOUND", `opencode binary not found at ${name}=${value}`);
+    return path.resolve(value);
   }
   const which = spawnSync("/usr/bin/env", ["which", "opencode"], { encoding: "utf8" });
   if (which.status === 0 && which.stdout.trim()) return which.stdout.trim();
-  throw new WorkerError("BIN_NOT_FOUND", "opencode not found (use --opencode-bin or OPENCODE_WORKER_BIN)");
+  throw new WorkerError("BIN_NOT_FOUND", "opencode not found on PATH (set OPENCODE_WORKER_BIN or --opencode-bin)");
 }
 
 function opencodeVersion(bin) {

package/package.json

@@ -1,10 +1,22 @@
 {
   "name": "opencode-worker",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Run the official OpenCode CLI as an isolated, time-boxed worker. CLI + MCP stdio server.",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/goofy1goober4/opencode-worker.git"
+  },
   "type": "module",
-  "bin": { "opencode-worker": "bin/opencode-worker.mjs" },
-  "files": ["bin", "lib", "README.md"],
-  "engines": { "node": ">=20" },
+  "bin": {
+    "opencode-worker": "bin/opencode-worker.mjs"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
   "license": "MIT"
 }