@mrclrchtr/supi-tree-sitter 0.1.0

package/README.md

@@ -0,0 +1,97 @@
+# @mrclrchtr/supi-tree-sitter
+
+Tree-sitter structural analysis for the [pi coding agent](https://github.com/earendil-works/pi).
+
+This package registers a `tree_sitter` tool and also exports a small TypeScript service API for other SuPi extensions. It is designed as a standalone structural-analysis substrate: it does not depend on `supi-lsp` or semantic language-server tooling, and it remains correct and useful when installed by itself.
+
+## Install
+
+```bash
+pi install npm:@mrclrchtr/supi-tree-sitter
+```
+
+Standalone installs include the runtime grammar dependencies needed for the supported non-vendored languages. Kotlin and SQL use vendored WASM grammars bundled with this package.
+
+It is also bundled by the full SuPi meta-package:
+
+```bash
+pi install npm:@mrclrchtr/supi
+```
+
+## Supported files
+
+The runtime can parse these file families:
+
+- **JavaScript / TypeScript** — `.ts`, `.tsx`, `.mts`, `.cts`, `.js`, `.jsx`, `.mjs`, `.cjs`
+- **Python** — `.py`, `.pyi`
+- **Rust** — `.rs`
+- **Go** — `.go`, `.mod`
+- **C / C++** — `.c`, `.h`, `.cpp`, `.hpp`, `.cc`, `.cxx`, `.hxx`, `.c++`, `.h++`
+- **Java** — `.java`
+- **Kotlin** — `.kt`, `.kts`
+- **Ruby** — `.rb`
+- **Bash / Shell** — `.sh`, `.bash`, `.zsh`
+- **HTML** — `.html`, `.htm`, `.xhtml`
+- **R** — `.r`
+- **SQL** — `.sql`
+
+Grammar `.wasm` files are resolved from installed package metadata for npm-shipped grammars, not from repository-relative paths.
+
+## `tree_sitter` tool
+
+Actions:
+
+- `outline` — list structural declarations such as functions, classes, interfaces, methods, and variables (**currently JavaScript / TypeScript only**)
+- `imports` — list import statements and module specifiers (**currently JavaScript / TypeScript only**)
+- `exports` — list exported declarations, re-exports, and TypeScript `export =` assignments (**currently JavaScript / TypeScript only**)
+- `node_at` — return the smallest syntax node at a 1-based `line`/`character` position, plus ancestry (all supported grammars)
+- `query` — run a custom Tree-sitter query and return captures (all supported grammars)
+- `callees` — find outgoing function/method calls from a position; supports all grammars with a callee query configured
+
+Coordinates are 1-based and compatible with the `lsp` tool. `character` is a UTF-16 code-unit column. Relative file paths resolve from the pi session working directory.
+
+Large result sets are capped at 100 emitted items per tool response. For outlines, nested children count toward the same cap so deeply nested classes do not bypass the limit.
+
+## Service API
+
+```ts
+import { createTreeSitterSession } from "@mrclrchtr/supi-tree-sitter";
+
+const session = createTreeSitterSession(process.cwd());
+try {
+  const parseable = await session.canParse("src/index.ts");
+  if (parseable.kind === "success") {
+    console.log(parseable.data.file, parseable.data.language);
+  }
+
+  const outline = await session.outline("src/index.ts");
+  if (outline.kind === "success") {
+    console.log(outline.data);
+  }
+
+  const callees = await session.calleesAt("src/index.ts", 1, 10);
+  if (callees.kind === "success") {
+    console.log(callees.data.enclosingScope.name, callees.data.callees);
+  }
+} finally {
+  session.dispose();
+}
+```
+
+`canParse(file)` validates that a supported file can be read and parsed, then returns the resolved file path and grammar id. It does not expose the raw Tree-sitter tree; use `outline`, `query`, `imports`, `exports`, `nodeAt`, or `calleesAt` for structured results.
+
+`calleesAt(file, line, character)` extracts structural outgoing calls from the enclosing function/method scope at the given position. It returns the enclosing scope name and a deduplicated list of callees with their source ranges.
+
+Exported types include `TreeSitterResult`, `TreeSitterSession`, `OutlineItem`, `ImportRecord`, `ExportRecord`, `NodeAtResult`, `QueryCapture`, `CalleesAtResult`, `SourceRange`, `GrammarId`, and `SupportedExtension`.
+
+Always call `dispose()` when the session is no longer needed. The runtime lazily initializes grammars, reuses parser instances within a session, deduplicates concurrent first-use grammar initialization, and retries after initialization failures.
+
+## Positioning
+
+`supi-tree-sitter` is the structural-analysis substrate in SuPi's layered code-understanding stack:
+
+- `supi-tree-sitter` — parser-backed structural analysis (this package)
+- `supi-lsp` — live semantic analysis through language servers
+- `supi-code-intelligence` — higher-level agent-facing analysis built on top of both substrates
+
+Each substrate can be installed and used independently. `supi-tree-sitter` does not require `supi-lsp` to be present, and its prompt guidance is written so it remains correct in standalone installs.

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@mrclrchtr/supi-tree-sitter",
+  "version": "0.1.0",
+  "description": "SuPi Tree-sitter extension — structural AST analysis for pi",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mrclrchtr/supi.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "pi-package",
+    "pi",
+    "pi-coding-agent"
+  ],
+  "files": [
+    "src/**/*.ts",
+    "src/**/*.json",
+    "resources",
+    "scripts/*.mjs",
+    "!__tests__"
+  ],
+  "scripts": {
+    "vendor:wasm": "node scripts/vendor-wasm.mjs",
+    "check:wasm": "node scripts/vendor-wasm.mjs --check",
+    "generate:kotlin-wasm": "node scripts/generate-kotlin-wasm.mjs",
+    "check:kotlin-wasm": "node scripts/generate-kotlin-wasm.mjs --check",
+    "generate:sql-wasm": "node scripts/generate-sql-wasm.mjs",
+    "check:sql-wasm": "node scripts/generate-sql-wasm.mjs --check"
+  },
+  "dependencies": {
+    "web-tree-sitter": "^0.26.8"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "*",
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "devDependencies": {
+    "@davisvaughan/tree-sitter-r": "^1.2.0",
+    "@derekstride/tree-sitter-sql": "^0.3.11",
+    "@types/node": "^25.6.0",
+    "tree-sitter-bash": "^0.23.0",
+    "tree-sitter-c": "^0.23.0",
+    "tree-sitter-cli": "0.22.6",
+    "tree-sitter-cpp": "^0.23.0",
+    "tree-sitter-go": "^0.23.0",
+    "tree-sitter-html": "^0.23.0",
+    "tree-sitter-java": "^0.23.0",
+    "tree-sitter-javascript": "^0.23.0",
+    "tree-sitter-kotlin": "^0.3.8",
+    "tree-sitter-python": "^0.23.0",
+    "tree-sitter-ruby": "^0.23.0",
+    "tree-sitter-rust": "^0.23.0",
+    "tree-sitter-typescript": "^0.23.0",
+    "vitest": "^4.1.4",
+    "@mrclrchtr/supi-test-utils": "workspace:*"
+  },
+  "pi": {
+    "extensions": [
+      "./src/tree-sitter.ts"
+    ]
+  },
+  "main": "src/index.ts"
+}

package/resources/grammars/bash/tree-sitter-bash.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-bash",
+    "version": "0.23.3"
+  },
+  "sha256": "d1844429a58620f306b6f42aebe92298243ca8120cd833a3ab5d87c7a2e7b9fd"
+}

package/resources/grammars/c/tree-sitter-c.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-c",
+    "version": "0.23.6"
+  },
+  "sha256": "146f85977800935f18b06940518b16ded13cf4007ef0e3190573b969a98b9adc"
+}

package/resources/grammars/cpp/tree-sitter-cpp.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-cpp",
+    "version": "0.23.4"
+  },
+  "sha256": "174eb0deb75b2ec7881bcacda9f995648d8e683956e5c2267e69ab6dc503fcbf"
+}

package/resources/grammars/go/tree-sitter-go.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-go",
+    "version": "0.23.4"
+  },
+  "sha256": "6dfc8eacdad0a54d0cad0d888851bd19cdd14d82582f110f888bbf6f9e5e2d64"
+}

package/resources/grammars/html/tree-sitter-html.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-html",
+    "version": "0.23.2"
+  },
+  "sha256": "c48fcd82c7ea8bf943180088ba7f28c48b2bb5287874179168bf9d31e394cf85"
+}

package/resources/grammars/java/tree-sitter-java.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-java",
+    "version": "0.23.5"
+  },
+  "sha256": "4fdeac4ca6ca089f06c6f7e562abcac1733cd465728cc7031ebb73c2019122c4"
+}

package/resources/grammars/javascript/tree-sitter-javascript.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-javascript",
+    "version": "0.23.1"
+  },
+  "sha256": "4a378293fe7853cbee2836023be072dafa0e53b3b5edb245920838ca834ed121"
+}

package/resources/grammars/kotlin/tree-sitter-kotlin.wasm.json

@@ -0,0 +1,12 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-kotlin",
+    "version": "0.3.8",
+    "repository": "https://github.com/fwcd/tree-sitter-kotlin",
+    "releaseAsset": "https://github.com/fwcd/tree-sitter-kotlin/releases/download/0.3.8/tree-sitter-kotlin.wasm"
+  },
+  "generatedWith": {
+    "treeSitterCli": "0.22.6"
+  },
+  "sha256": "c624e7443b371c28adc5d81674e73067564c12555ebe3ed96a6c8db814b7602d"
+}

package/resources/grammars/python/tree-sitter-python.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-python",
+    "version": "0.23.6"
+  },
+  "sha256": "8c93692fb368e288a5824cee55773c9b3602804f513bda48c97661e52e9c2da2"
+}

package/resources/grammars/r/tree-sitter-r.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "@davisvaughan/tree-sitter-r",
+    "version": "1.2.0"
+  },
+  "sha256": "2a8f5acd1c53d91e0ec5c01a6830d8ac7f5a7f96f0ac4b3768c016c8e9d07711"
+}

package/resources/grammars/ruby/tree-sitter-ruby.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-ruby",
+    "version": "0.23.1"
+  },
+  "sha256": "09a96427d7c72f0613ed470cd9812223fc4a91d6a9c025c0235cc6bd59ff96f4"
+}

package/resources/grammars/rust/tree-sitter-rust.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-rust",
+    "version": "0.23.3"
+  },
+  "sha256": "f65f354215611fd94ad34134b3427eb3d58cbb745df7b6509ba722184db73d57"
+}

package/resources/grammars/sql/tree-sitter-sql.wasm.json

@@ -0,0 +1,19 @@
+{
+  "source": {
+    "npmPackage": "@derekstride/tree-sitter-sql",
+    "version": "0.3.11",
+    "repository": "https://github.com/derekstride/tree-sitter-sql"
+  },
+  "generatedWith": {
+    "treeSitterCli": "0.22.6"
+  },
+  "sha256": "0871a3bd488ed39f5a521484337f07a43bd6aa95dbdf1cdd24744deecafa58fc",
+  "trust": {
+    "note": "The @derekstride/tree-sitter-sql npm package is a devDependency only. It is never resolved at runtime — the vendored WASM above is the sole runtime artifact. The npm package's install script uses 'npx --yes' which some package managers flag as a supply-chain risk; pnpm ignores build scripts by default, so this script never runs during install. The WASM was built locally from the package source (not downloaded from npm). See scripts/generate-sql-wasm.mjs for the rebuild procedure.",
+    "alternativesConsidered": [
+      "tree-sitter-sql (m-novikov, 2021, stale)",
+      "tree-sitter-sql-bigquery (BigQuery-specific)",
+      "dialect-specific grammars (too narrow)"
+    ]
+  }
+}

package/resources/grammars/tsx/tree-sitter-tsx.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-typescript",
+    "version": "0.23.2"
+  },
+  "sha256": "79e5da75ea62855a0cd67177685f0164eac87d5f630b3cbe1e0a099751ad30f8"
+}

package/resources/grammars/typescript/tree-sitter-typescript.wasm.json

@@ -0,0 +1,7 @@
+{
+  "source": {
+    "npmPackage": "tree-sitter-typescript",
+    "version": "0.23.2"
+  },
+  "sha256": "778025db5a8be0e70f8ccc3671e486dfeddd048c25d9e8a70c26de2e1bf6f97d"
+}

package/scripts/generate-kotlin-wasm.mjs

@@ -0,0 +1,126 @@
+#!/usr/bin/env node
+
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import { createRequire } from "node:module";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(scriptDir, "..");
+const wasmDir = path.join(packageRoot, "resources", "grammars", "kotlin");
+const wasmPath = path.join(wasmDir, "tree-sitter-kotlin.wasm");
+const metadataPath = path.join(wasmDir, "tree-sitter-kotlin.wasm.json");
+const checkMode = process.argv.includes("--check");
+
+function readPackage(packageName) {
+  const packageJsonPath = require.resolve(`${packageName}/package.json`);
+  return {
+    dir: path.dirname(packageJsonPath),
+    json: JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")),
+  };
+}
+
+function sha256(filePath) {
+  return createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+}
+
+function readMetadata() {
+  return JSON.parse(fs.readFileSync(metadataPath, "utf-8"));
+}
+
+function expectedReleaseAsset(version) {
+  return `https://github.com/fwcd/tree-sitter-kotlin/releases/download/${version}/tree-sitter-kotlin.wasm`;
+}
+
+function assertKotlinWasmCurrent() {
+  const kotlinPackage = readPackage("tree-sitter-kotlin");
+  const metadata = readMetadata();
+  const actualSha = sha256(wasmPath);
+  const errors = [];
+
+  if (metadata.source?.npmPackage !== "tree-sitter-kotlin") {
+    errors.push("metadata source package must be tree-sitter-kotlin");
+  }
+  if (metadata.source?.version !== kotlinPackage.json.version) {
+    errors.push(
+      `metadata pins tree-sitter-kotlin ${metadata.source?.version}, but installed package is ${kotlinPackage.json.version}`,
+    );
+  }
+  if (metadata.source?.releaseAsset !== expectedReleaseAsset(kotlinPackage.json.version)) {
+    errors.push(
+      "metadata release asset URL does not match the installed tree-sitter-kotlin version",
+    );
+  }
+  if (metadata.sha256 !== actualSha) {
+    errors.push(`metadata sha256 ${metadata.sha256} does not match vendored file ${actualSha}`);
+  }
+
+  if (errors.length > 0) {
+    throw new Error(
+      `Vendored Kotlin Tree-sitter WASM is stale:\n- ${errors.join("\n- ")}\nRun: pnpm --filter @mrclrchtr/supi-tree-sitter generate:kotlin-wasm`,
+    );
+  }
+
+  process.stdout.write(
+    `Kotlin Tree-sitter WASM is current (${kotlinPackage.json.version}, ${actualSha}).\n`,
+  );
+}
+
+function generateKotlinWasm() {
+  const kotlinPackage = readPackage("tree-sitter-kotlin");
+  const cliPackage = readPackage("tree-sitter-cli");
+  const cliPath = path.join(cliPackage.dir, "cli.js");
+  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "supi-kotlin-wasm-"));
+  const grammarDir = path.join(tempRoot, "tree-sitter-kotlin");
+
+  try {
+    fs.cpSync(kotlinPackage.dir, grammarDir, { recursive: true });
+    const result = spawnSync(process.execPath, [cliPath, "build", "--wasm"], {
+      cwd: grammarDir,
+      stdio: "inherit",
+    });
+
+    if (result.status !== 0) {
+      throw new Error(
+        "tree-sitter build --wasm failed. Install Docker or Emscripten, then rerun generate:kotlin-wasm.",
+      );
+    }
+
+    const generatedWasmPath = path.join(grammarDir, "tree-sitter-kotlin.wasm");
+    if (!fs.existsSync(generatedWasmPath)) {
+      throw new Error(`Expected generated WASM at ${generatedWasmPath}`);
+    }
+
+    fs.mkdirSync(wasmDir, { recursive: true });
+    fs.copyFileSync(generatedWasmPath, wasmPath);
+
+    const checksum = sha256(wasmPath);
+    const metadata = {
+      source: {
+        npmPackage: "tree-sitter-kotlin",
+        version: kotlinPackage.json.version,
+        repository: "https://github.com/fwcd/tree-sitter-kotlin",
+        releaseAsset: expectedReleaseAsset(kotlinPackage.json.version),
+      },
+      generatedWith: {
+        treeSitterCli: cliPackage.json.version,
+      },
+      sha256: checksum,
+    };
+    fs.writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`);
+    process.stdout.write(`Generated ${wasmPath}\n`);
+    process.stdout.write(`SHA256 ${checksum}\n`);
+  } finally {
+    fs.rmSync(tempRoot, { recursive: true, force: true });
+  }
+}
+
+if (checkMode) {
+  assertKotlinWasmCurrent();
+} else {
+  generateKotlinWasm();
+}

package/scripts/generate-sql-wasm.mjs

@@ -0,0 +1,144 @@
+#!/usr/bin/env node
+/**
+ * SQL Tree-sitter WASM generator
+ *
+ * Rebuilds the vendored SQL grammar WASM from the @derekstride/tree-sitter-sql
+ * npm package. This package is a devDependency ONLY — the vendored WASM is the
+ * sole runtime artifact. The npm package is never resolved at runtime.
+ *
+ * Trust considerations:
+ * - The @derekstride/tree-sitter-sql install script uses "npx --yes", which
+ *   some package managers flag as a supply-chain risk. pnpm ignores build
+ *   scripts by default, so this script never runs during install.
+ * - The WASM is built locally from the installed package source (not downloaded
+ *   from npm). The build uses tree-sitter-cli 0.22.6 with Emscripten/Docker.
+ * - Alternatives considered: tree-sitter-sql (m-novikov, stale since 2021),
+ *   tree-sitter-sql-bigquery (dialect-specific), and dialect-specific grammars.
+ *   derekstride/tree-sitter-sql is the most mature general-purpose SQL grammar.
+ *
+ * Usage:
+ *   pnpm --filter @mrclrchtr/supi-tree-sitter generate:sql-wasm
+ *   pnpm --filter @mrclrchtr/supi-tree-sitter check:sql-wasm
+ */
+
+import { spawnSync } from "node:child_process";
+import { createHash } from "node:crypto";
+import * as fs from "node:fs";
+import { createRequire } from "node:module";
+import * as os from "node:os";
+import * as path from "node:path";
+import { fileURLToPath } from "node:url";
+
+const require = createRequire(import.meta.url);
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.resolve(scriptDir, "..");
+const wasmDir = path.join(packageRoot, "resources", "grammars", "sql");
+const wasmPath = path.join(wasmDir, "tree-sitter-sql.wasm");
+const metadataPath = path.join(wasmDir, "tree-sitter-sql.wasm.json");
+const checkMode = process.argv.includes("--check");
+
+function readPackage(packageName) {
+  const packageJsonPath = require.resolve(`${packageName}/package.json`);
+  return {
+    dir: path.dirname(packageJsonPath),
+    json: JSON.parse(fs.readFileSync(packageJsonPath, "utf-8")),
+  };
+}
+
+function sha256(filePath) {
+  return createHash("sha256").update(fs.readFileSync(filePath)).digest("hex");
+}
+
+function readMetadata() {
+  return JSON.parse(fs.readFileSync(metadataPath, "utf-8"));
+}
+
+function assertSqlWasmCurrent() {
+  const sqlPackage = readPackage("@derekstride/tree-sitter-sql");
+  const metadata = readMetadata();
+  const actualSha = sha256(wasmPath);
+  const errors = [];
+
+  if (metadata.source?.npmPackage !== "@derekstride/tree-sitter-sql") {
+    errors.push("metadata source package must be @derekstride/tree-sitter-sql");
+  }
+  if (metadata.source?.version !== sqlPackage.json.version) {
+    errors.push(
+      `metadata pins @derekstride/tree-sitter-sql ${metadata.source?.version}, but installed package is ${sqlPackage.json.version}`,
+    );
+  }
+  if (metadata.sha256 !== actualSha) {
+    errors.push(`metadata sha256 ${metadata.sha256} does not match vendored file ${actualSha}`);
+  }
+
+  if (errors.length > 0) {
+    throw new Error(
+      `Vendored SQL Tree-sitter WASM is stale:\n- ${errors.join("\n- ")}\nRun: pnpm --filter @mrclrchtr/supi-tree-sitter generate:sql-wasm`,
+    );
+  }
+
+  process.stdout.write(
+    `SQL Tree-sitter WASM is current (${sqlPackage.json.version}, ${actualSha}).\n`,
+  );
+}
+
+function generateSqlWasm() {
+  const sqlPackage = readPackage("@derekstride/tree-sitter-sql");
+  const cliPackage = readPackage("tree-sitter-cli");
+  const cliPath = path.join(cliPackage.dir, "cli.js");
+  const tempRoot = fs.mkdtempSync(path.join(os.tmpdir(), "supi-sql-wasm-"));
+  const grammarDir = path.join(tempRoot, "tree-sitter-sql");
+
+  try {
+    fs.cpSync(sqlPackage.dir, grammarDir, { recursive: true });
+
+    // tree-sitter-cli 0.22.6 requires a "tree-sitter" section in package.json
+    const grammarPackageJsonPath = path.join(grammarDir, "package.json");
+    const grammarPackageJson = JSON.parse(fs.readFileSync(grammarPackageJsonPath, "utf-8"));
+    grammarPackageJson["tree-sitter"] = [{ scope: "source.sql" }];
+    fs.writeFileSync(grammarPackageJsonPath, JSON.stringify(grammarPackageJson, null, 2));
+
+    const result = spawnSync(process.execPath, [cliPath, "build", "--wasm"], {
+      cwd: grammarDir,
+      stdio: "inherit",
+    });
+
+    if (result.status !== 0) {
+      throw new Error(
+        "tree-sitter build --wasm failed. Install Docker or Emscripten, then rerun generate:sql-wasm.",
+      );
+    }
+
+    const generatedWasmPath = path.join(grammarDir, "tree-sitter-sql.wasm");
+    if (!fs.existsSync(generatedWasmPath)) {
+      throw new Error(`Expected generated WASM at ${generatedWasmPath}`);
+    }
+
+    fs.mkdirSync(wasmDir, { recursive: true });
+    fs.copyFileSync(generatedWasmPath, wasmPath);
+
+    const checksum = sha256(wasmPath);
+    const metadata = {
+      source: {
+        npmPackage: "@derekstride/tree-sitter-sql",
+        version: sqlPackage.json.version,
+        repository: "https://github.com/derekstride/tree-sitter-sql",
+      },
+      generatedWith: {
+        treeSitterCli: cliPackage.json.version,
+      },
+      sha256: checksum,
+    };
+    fs.writeFileSync(metadataPath, `${JSON.stringify(metadata, null, 2)}\n`);
+    process.stdout.write(`Generated ${wasmPath}\n`);
+    process.stdout.write(`SHA256 ${checksum}\n`);
+  } finally {
+    fs.rmSync(tempRoot, { recursive: true, force: true });
+  }
+}
+
+if (checkMode) {
+  assertSqlWasmCurrent();
+} else {
+  generateSqlWasm();
+}