feat(cli): delegate commands to gnd by default

`graph <cmd>` now execs the matching `gnd <cmd>` (the Rust
`@graphprotocol/gnd` binary). Two exceptions stay on the oclif/TS path:
`local`, which has no gnd equivalent, and `dev`, which is a thin oclif
shim that spawns `gnd dev` so the command is discoverable from
`graph --help`. Set `GRAPH_CLI_IGNORE_GND=1` to force the TS
implementation everywhere; the test suite does this automatically.

Author: lutter

packages/cli/bin/run.js

@@ -2,6 +2,7 @@
 import process from 'node:process';
 import semver from 'semver';
 import { execute } from '@oclif/core';
+import { runGnd } from '../dist/command-helpers/gnd.js';
 import { nodeVersion } from '../dist/version.js';
 
 if (!semver.satisfies(process.version, nodeVersion)) {
@@ -11,4 +12,11 @@ if (!semver.satisfies(process.version, nodeVersion)) {
   process.exit(1);
 }
 
-await execute({ dir: import.meta.url });
+const args = process.argv.slice(2);
+const useGnd = !process.env.GRAPH_CLI_IGNORE_GND && args[0] !== 'local';
+
+if (useGnd) {
+  runGnd(args);
+} else {
+  await execute({ dir: import.meta.url });
+}

packages/cli/src/command-helpers/gnd.ts

@@ -0,0 +1,18 @@
+import { spawnSync } from 'node:child_process';
+import { createRequire } from 'node:module';
+import process from 'node:process';
+
+const require = createRequire(import.meta.url);
+
+export function runGnd(args: string[]): never {
+  const gndEntry = require.resolve('@graphprotocol/gnd/bin/gnd.js');
+  const result = spawnSync(process.execPath, [gndEntry, ...args], { stdio: 'inherit' });
+  if (result.error) {
+    process.stderr.write(`Failed to launch gnd: ${result.error.message}\n`);
+    process.exit(1);
+  }
+  if (result.signal) {
+    process.kill(process.pid, result.signal);
+  }
+  process.exit(result.status ?? 1);
+}

packages/cli/src/commands/dev.ts

@@ -0,0 +1,15 @@
+import { Command } from '@oclif/core';
+import { runGnd } from '../command-helpers/gnd.js';
+
+export default class DevCommand extends Command {
+  static description =
+    'Run graph-node in dev mode. Delegates to `gnd dev`; run `graph dev --help` (without GRAPH_CLI_IGNORE_GND set) for the full list of supported flags.';
+
+  static strict = false;
+
+  static args = {};
+
+  async run() {
+    runGnd(['dev', ...this.argv]);
+  }
+}

packages/cli/tests/cli/globalSetup.ts

@@ -4,5 +4,6 @@ import { linkCli } from './link';
 
 export default async () => {
   process.env.GRAPH_CLI_TESTS = '1';
+  process.env.GRAPH_CLI_IGNORE_GND = '1';
   await linkCli();
 };