chore: improve tooling

.github/workflows/release.yml

@@ -31,8 +31,8 @@ jobs:
         with:
           publish: bun run release
           version: bun run version
-          commit: "chore: release new package version"
-          title: "🚀🚢 Release new package version 🚀🚢"
+          commit: 'chore: release new package version'
+          title: '🚀🚢 Release new package version 🚀🚢'
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

.lintstagedrc.json

@@ -0,0 +1,3 @@
+{
+  "**/*.{ts,tsx}": ["eslint --fix", "oxfmt"]
+}

.oxfmtrc.json

@@ -0,0 +1,11 @@
+{
+  "$schema": "./node_modules/oxfmt/configuration_schema.json",
+  "singleQuote": true,
+  "trailingComma": "all",
+  "printWidth": 80,
+  "tabWidth": 2,
+  "semi": false,
+  "arrowParens": "always",
+  "sortPackageJson": false,
+  "ignorePatterns": ["node_modules", "dist", ".opencode"]
+}

AGENTS.md

@@ -46,36 +46,43 @@ package.json              ← npm package config
 ## Commands
 
 ### Install dependencies
+
 ```sh
 bun install
 ```
 
 ### Build (emit JS + declarations to dist/)
+
 ```sh
 bun run build
 ```
 
 ### Type-check (no emit)
+
 ```sh
 bunx tsc --noEmit
 ```
 
 ### Run all tests
+
 ```sh
 bun test
 ```
 
 ### Run a single test file
+
 ```sh
 bun test src/index.test.ts
 ```
 
 ### Run tests matching a name pattern
+
 ```sh
 bun test --test-name-pattern "pattern here"
 ```
 
 ### Run tests in watch mode
+
 ```sh
 bun test --watch
 ```
@@ -86,19 +93,19 @@ bun test --watch
 
 Always use Bun's built-in APIs instead of third-party equivalents:
 
-| Task | Use | Do NOT use |
-|---|---|---|
-| Run a file | `bun <file>` | `node <file>`, `ts-node <file>` |
-| HTTP server | `Bun.serve()` | `express`, `fastify` |
-| SQLite | `bun:sqlite` | `better-sqlite3` |
-| Redis | `Bun.redis` | `ioredis` |
-| Postgres | `Bun.sql` | `pg`, `postgres.js` |
-| WebSocket | built-in `WebSocket` | `ws` |
-| File I/O | `Bun.file()` | `node:fs` readFile/writeFile |
-| Shell commands | `Bun.$\`cmd\`` | `execa`, `child_process` |
-| Environment vars | automatic `.env` loading | `dotenv` |
-| Frontend | `Bun.serve()` with HTML imports | `vite`, `webpack`, `esbuild` |
-| Testing | `bun test` | `jest`, `vitest` |
+| Task             | Use                             | Do NOT use                      |
+| ---------------- | ------------------------------- | ------------------------------- |
+| Run a file       | `bun <file>`                    | `node <file>`, `ts-node <file>` |
+| HTTP server      | `Bun.serve()`                   | `express`, `fastify`            |
+| SQLite           | `bun:sqlite`                    | `better-sqlite3`                |
+| Redis            | `Bun.redis`                     | `ioredis`                       |
+| Postgres         | `Bun.sql`                       | `pg`, `postgres.js`             |
+| WebSocket        | built-in `WebSocket`            | `ws`                            |
+| File I/O         | `Bun.file()`                    | `node:fs` readFile/writeFile    |
+| Shell commands   | `Bun.$\`cmd\``                  | `execa`, `child_process`        |
+| Environment vars | automatic `.env` loading        | `dotenv`                        |
+| Frontend         | `Bun.serve()` with HTML imports | `vite`, `webpack`, `esbuild`    |
+| Testing          | `bun test`                      | `jest`, `vitest`                |
 
 ---
 
@@ -180,6 +187,7 @@ Key settings from `tsconfig.json`:
 ### Testing
 
 - Use Bun's built-in `bun:test` — do not install Jest or Vitest.
+
   ```ts
   import { test, expect, describe, beforeEach } from "bun:test";
 
@@ -189,6 +197,7 @@ Key settings from `tsconfig.json`:
     });
   });
   ```
+
 - Place test files next to the code they test, e.g., `foo.ts` → `foo.test.ts`.
 - Test file discovery: `**/*.test.ts`, `**/*.test.tsx`, `**/*.spec.ts`, `**/*.spec.tsx`.
 
@@ -206,5 +215,5 @@ The `.cursor/rules/use-bun-instead-of-node-vite-npm-pnpm.mdc` rule applies to al
 > Default to using Bun instead of Node.js.
 > `Bun.serve()` supports WebSockets, HTTPS, and routes — don't use Express.
 > HTML imports with `Bun.serve()` for frontend — don't use Vite.
-> `Bun.$\`ls\`` instead of execa.
+> `Bun.$` instead of execa.
 > Bun automatically loads `.env` — don't use dotenv.

eslint.config.js

@@ -0,0 +1,40 @@
+import js from "@eslint/js";
+import tseslint from "typescript-eslint";
+import prettier from "eslint-config-prettier/flat";
+
+export default tseslint.config(
+  {
+    ignores: ["dist", "node_modules", "*.config.js"],
+  },
+  js.configs.recommended,
+  ...tseslint.configs.recommended,
+  prettier,
+  {
+    files: ["**/*.ts"],
+    languageOptions: {
+      ecmaVersion: "latest",
+      sourceType: "module",
+      parser: tseslint.parser,
+      parserOptions: {
+        ecmaVersion: "latest",
+        sourceType: "module",
+      },
+      globals: {
+        // Node.js globals
+        console: "readonly",
+        process: "readonly",
+        Buffer: "readonly",
+        // Web APIs
+        URL: "readonly",
+        AbortController: "readonly",
+        // Bun globals
+        Bun: "readonly",
+      },
+    },
+    rules: {
+      "@typescript-eslint/explicit-function-return-type": "off",
+      "@typescript-eslint/no-explicit-any": "warn",
+      "no-console": "error",
+    },
+  }
+);

package.json

@@ -18,12 +18,17 @@
     "build:bundle": "bun build src/index.ts --outfile dist/index.js --format esm --target bun --external @opencode-ai/plugin",
     "build:types": "tsc --project tsconfig.build.json",
     "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "format": "oxfmt 'src/**/*.ts'",
+    "format:check": "oxfmt --check 'src/**/*.ts'",
     "version": "changeset version",
     "release": "bun run build && changeset publish",
     "prepare": "simple-git-hooks"
   },
   "simple-git-hooks": {
-    "commit-msg": "bunx commitlint --edit $1"
+    "commit-msg": "bunx commitlint --edit $1",
+    "pre-commit": "bunx lint-staged"
   },
   "keywords": [
     "opencode",
@@ -50,9 +55,17 @@
     "@changesets/cli": "^2.30.0",
     "@commitlint/cli": "^20.5.0",
     "@commitlint/config-conventional": "^20.5.0",
+    "@eslint/js": "^9.39.1",
     "@opencode-ai/plugin": "1.2.27",
     "@types/bun": "1.3.10",
-    "simple-git-hooks": "^2.13.1"
+    "@types/node": "^20.11.5",
+    "bun-types": "^1.3.11",
+    "eslint": "^9.39.1",
+    "eslint-config-prettier": "10.1.8",
+    "lint-staged": "^15.2.0",
+    "oxfmt": "^0.42.0",
+    "simple-git-hooks": "^2.13.1",
+    "typescript-eslint": "^8.57.0"
   },
   "peerDependencies": {
     "@opencode-ai/plugin": "^1.1.0",