opencode-yul 0.0.12

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const Yul: Plugin;

package/dist/index.js

@@ -0,0 +1,89 @@
+// yul OpenCode plugin: keeps dependencies current by blocking `write`/`edit`
+// tool calls that would pin a newly added/changed dependency to a version
+// older than what's actually released.
+//
+// Distributed as the npm package "opencode-yul" — add it to the `plugin`
+// array in your project's opencode.json/opencode.jsonc:
+//
+//   { "plugin": ["opencode-yul"] }
+//
+// NOTE: `input.tool` values and `output.args` field names below were
+// confirmed against the built-in write/edit tool schemas in opencode-ai@1.18.31
+// (write: {content, filePath}; edit: {filePath, oldString, newString, replaceAll}).
+// Re-check if the hook stops firing after an OpenCode upgrade changes these.
+import { spawnSync } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, rmSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+// Bumped in lockstep with .claude-plugin/plugin.json and this package's own
+// package.json version by the release workflow — it's what pins which yul
+// binary this plugin downloads and runs.
+const YUL_VERSION = "0.0.12";
+const CACHE_ROOT = join(process.env.XDG_CACHE_HOME ?? join(homedir(), ".cache"), "yul");
+const CACHE_DIR = join(CACHE_ROOT, `v${YUL_VERSION}`);
+const BIN_PATH = join(CACHE_DIR, "yul");
+// ensureYul downloads the pinned yul release binary into the cache dir if
+// it isn't already there, then prunes caches left behind by other versions.
+// Mirrors scripts/ensure-yul.sh, minus the "newer release available"
+// notice, which has no obvious OpenCode-side equivalent to print to.
+function ensureYul() {
+    if (existsSync(BIN_PATH))
+        return;
+    mkdirSync(CACHE_DIR, { recursive: true });
+    const result = spawnSync("sh", ["-c", `curl -fsSL "https://raw.githubusercontent.com/chains-project/yul/v${YUL_VERSION}/install.sh" | sh`], {
+        env: { ...process.env, YUL_VERSION: `v${YUL_VERSION}`, YUL_INSTALL_DIR: CACHE_DIR },
+        stdio: "ignore",
+        timeout: 60_000, // matches the outer timeout Claude Code's hooks.json puts on the equivalent script
+    });
+    if (result.status !== 0 || !existsSync(BIN_PATH))
+        return; // fail open: hook below no-ops until the binary exists
+    if (existsSync(CACHE_ROOT)) {
+        for (const entry of readdirSync(CACHE_ROOT, { withFileTypes: true })) {
+            if (entry.isDirectory() && entry.name.startsWith("v") && entry.name !== `v${YUL_VERSION}`) {
+                rmSync(join(CACHE_ROOT, entry.name), { recursive: true, force: true });
+            }
+        }
+    }
+}
+function toHookInput(tool, args) {
+    if (tool === "write") {
+        return { tool_name: "Write", tool_input: { file_path: args.filePath, content: args.content } };
+    }
+    if (tool === "edit") {
+        return {
+            tool_name: "Edit",
+            tool_input: {
+                file_path: args.filePath,
+                old_string: args.oldString,
+                new_string: args.newString,
+                replace_all: args.replaceAll,
+            },
+        };
+    }
+    return undefined;
+}
+export const Yul = async () => {
+    try {
+        ensureYul();
+    }
+    catch {
+        // fail open: cache setup errors must not disable OpenCode
+    }
+    return {
+        "tool.execute.before": async (input, output) => {
+            if (!existsSync(BIN_PATH))
+                return; // fail open: still downloading, or offline install
+            const hookInput = toHookInput(input.tool, output.args);
+            if (!hookInput)
+                return;
+            const result = spawnSync(BIN_PATH, [], {
+                input: JSON.stringify(hookInput),
+                encoding: "utf8",
+            });
+            if (result.status === 2) {
+                throw new Error(result.stderr || "yul: dependency pin is outdated");
+            }
+            // any other exit code (0, or a resolver/plumbing error) fails open
+        },
+    };
+};

package/package.json

@@ -0,0 +1,43 @@
+{
+  "$schema": "https://json.schemastore.org/package.json",
+  "name": "opencode-yul",
+  "version": "0.0.12",
+  "description": "Forces models to use the latest versions of dependencies instead of outdated versions from model training data.",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chains-project/yul.git",
+    "directory": "opencode-yul"
+  },
+  "homepage": "https://github.com/chains-project/yul",
+  "license": "MIT",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "dependencies"
+  ],
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=1.0.0"
+  },
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.0.0",
+    "@types/node": "^26.6.2",
+    "typescript": "^7.0.2"
+  }
+}