ci: Add @graphprotocol/gnd npm wrapper package

Add a wrapper package that installs the correct platform-specific gnd
binary via optionalDependencies. This enables `npm install -g
@graphprotocol/gnd` and `npx @graphprotocol/gnd`.

The wrapper includes:
- gnd/npm/bin/gnd.js: launcher script that resolves the platform binary
- gnd/npm/README.md: package documentation
- publish-npm-wrapper workflow job that runs after platform packages

Author: lutter

.github/workflows/gnd-binary-build.yml

@@ -279,3 +279,73 @@ jobs:
       - name: Publish
         run: npm publish --provenance --access public --tag ${{ steps.version.outputs.tag }} ${{ inputs.dry_run && '--dry-run' || '' }}
         working-directory: pkg
+
+  publish-npm-wrapper:
+    name: Publish @graphprotocol/gnd wrapper
+    needs: publish-npm
+    if: startsWith(github.ref, 'refs/tags/')
+    runs-on: ubuntu-latest
+    permissions:
+      id-token: write
+      contents: read
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: 24
+
+      - name: Determine version and npm tag
+        id: version
+        shell: bash
+        run: |
+          VERSION="${{ github.ref_name }}"
+          VERSION="${VERSION#v}"
+          echo "version=${VERSION}" >> $GITHUB_OUTPUT
+          if [[ "$VERSION" == *-* ]]; then
+            PRE="${VERSION#*-}"
+            TAG="${PRE%%.*}"
+            echo "tag=${TAG}" >> $GITHUB_OUTPUT
+          else
+            echo "tag=latest" >> $GITHUB_OUTPUT
+          fi
+
+      - name: Create wrapper package
+        shell: bash
+        run: |
+          VERSION="${{ steps.version.outputs.version }}"
+
+          mkdir -p pkg/bin
+          cp gnd/npm/bin/gnd.js pkg/bin/gnd.js
+          cp gnd/npm/README.md pkg/README.md
+
+          cat > pkg/package.json << EOF
+          {
+            "name": "@graphprotocol/gnd",
+            "version": "${VERSION}",
+            "description": "Graph Node Development CLI",
+            "bin": {
+              "gnd": "./bin/gnd.js"
+            },
+            "optionalDependencies": {
+              "@graphprotocol/gnd-darwin-arm64": "${VERSION}",
+              "@graphprotocol/gnd-darwin-x64": "${VERSION}",
+              "@graphprotocol/gnd-linux-arm64": "${VERSION}",
+              "@graphprotocol/gnd-linux-x64": "${VERSION}",
+              "@graphprotocol/gnd-win32-x64": "${VERSION}"
+            },
+            "publishConfig": {
+              "access": "public",
+              "provenance": true
+            },
+            "license": "(Apache-2.0 OR MIT)",
+            "repository": {
+              "type": "git",
+              "url": "https://github.com/graphprotocol/graph-node.git"
+            }
+          }
+          EOF
+
+      - name: Publish
+        run: npm publish --provenance --access public --tag ${{ steps.version.outputs.tag }} ${{ inputs.dry_run && '--dry-run' || '' }}
+        working-directory: pkg

gnd/npm/README.md

@@ -0,0 +1,35 @@
+# The Graph CLI
+
+This package installs the CLI for developing subgraphs for [The Graph
+Network](https://thegraph.com/subgraphs/) It supports all aspects of
+[developing, testing, and deploying subgraphs](https://thegraph.com/docs/en/subgraphs/quick-start/) locally and
+on the network.
+
+This package is a complete replacement for the older
+[graph-cli](https://www.npmjs.com/package/@graphprotocol/graph-cli) which
+will over time be migrated to be a simple wrapper for `gnd`. Older
+documentation will reference `graph-cli` in its instructions; running
+`alias graph=gnd` in the shell make it possible to follow these
+instructions verbatim with `gnd`.
+
+Besides the tools to develop subgraphs, `gnd` also contains a version of
+[graph-node](https://github.com/graphprotocol/graph-node) tailored to
+running subgraphs locally via `gnd dev`.
+
+
+## Getting started
+
+Run `npm install -g @graphprotocol/gnd` to install `gnd`.
+
+After installation, you can create and run an example subgraph locally with
+```bash
+gnd init --from-example ethereum-gravatar 'My new subgraph' new-subgraph
+cd new-subgraph
+gnd codegen
+gnd build
+gnd dev --ethereum-rpc 'mainnet:<RPC URL>'
+```
+
+If you have an existing contract for which you want to write a subgraph,
+have a look at `gnd help init` and the `--from-contract` option. You can
+also simply run `gnd init` and follow the prompts to set up your subgraph.

gnd/npm/bin/gnd.js

@@ -0,0 +1,33 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+
+const PLATFORMS = {
+  "darwin-arm64": "@graphprotocol/gnd-darwin-arm64",
+  "darwin-x64": "@graphprotocol/gnd-darwin-x64",
+  "linux-arm64": "@graphprotocol/gnd-linux-arm64",
+  "linux-x64": "@graphprotocol/gnd-linux-x64",
+  "win32-x64": "@graphprotocol/gnd-win32-x64",
+};
+
+const key = `${process.platform}-${process.arch}`;
+const pkg = PLATFORMS[key];
+if (!pkg) {
+  console.error(`Unsupported platform: ${key}`);
+  process.exit(1);
+}
+
+const bin = process.platform === "win32" ? "gnd.exe" : "gnd";
+const binPath = path.join(
+  require.resolve(`${pkg}/package.json`),
+  "..",
+  "bin",
+  bin
+);
+
+try {
+  execFileSync(binPath, process.argv.slice(2), { stdio: "inherit" });
+} catch (e) {
+  process.exit(e.status ?? 1);
+}