@hydranium/cli 1.0.0-next.24 → 1.0.0-next.241

package/README.md

@@ -27,12 +27,6 @@ operations against a spawned data-server.
 
 ## Install
 
-> **Nothing in `@hydranium/*` is on npm yet**, so every `npx` line below
-> resolves to no package and fails with `E404`. Until the first release the CLI
-> is reachable only from a clone of this repository: run `npm run build`, then
-> substitute `node packages/cli/lib/cli.js` for the `npx …` prefix. Subcommands,
-> flags and output are the same either way.
-
 `init` needs no install at all:
 
 ```bash
@@ -61,6 +55,14 @@ Most subcommands take `--services <module>`: an ESM module exporting a zero-arg
 `createServices(): { shared }` thunk — normally your build's `./lib/services.js`. The head wires its
 own filesystem inside, so the CLI boots it with no arguments.
 
+To run the head from its TypeScript source instead, register a loader with `--import <specifier>`
+(repeatable), which the CLI passes as Node's own `--import` to the process that imports the head:
+`npx hydranium-cli reflect --import tsx --services ./src/services.ts`. A package name resolves from
+the directory the command runs in, as Node's flag does; a path, absolute or relative, is resolved
+against that directory and passed on as a file URL, so Windows paths work too. Node's built-in type
+stripping is not enough on its own: it neither maps a head's `./x.js` imports to their `.ts` sources
+nor accepts the namespaces Langium generates.
+
 **Scaffolding**
 
 - `init <target-dir>` — scaffold a new language project. See the section below.
@@ -106,6 +108,20 @@ plausibly non-zero and cannot be read as the tell.
   declared alongside every other subcommand's, so an unrecognised one is rejected rather than
   ignored.
 
+**Child-process heap ceiling** (`HYDRANIUM_CLI_MAX_OLD_SPACE_MB`)
+
+Subcommands that spawn a child — `analyze-heap`, `measure-memory`, `validate`, `lint-grammar`,
+`reflect`, `model-docs`, `ast-ground-truth` — give it `--max-old-space-size=8192` on a machine with
+no cgroup memory limit, and **no ceiling at all when there is one**. A ceiling above the limit lets
+V8 grow past it without collecting hard, so the kernel kills the container rather than the child
+reporting a heap error.
+
+Under a limit, Node derives its own ceiling from that limit, which is a fraction of it — so a
+roomy container gives a child less than the same machine would unconstrained. Set
+`HYDRANIUM_CLI_MAX_OLD_SPACE_MB` to state a ceiling in MiB; it wins in a container too. `0` means
+"let Node decide". A value below 256, or one carrying a unit suffix, is reported and ignored rather
+than passed on.
+
 **Data-server operations** (`--server "<cmd> [args...]"`)
 
 These spawn a data-server child and talk to it over its protocol. All four also take `--cwd <dir>`
@@ -141,8 +157,8 @@ hydranium-cli projects --server "node ./lib/data-server-main.js ./models"
 
 `init` writes a project you can build immediately, and it writes **only inside the target
 directory** — it refuses a non-empty directory without `--force`, and it never edits a surrounding
-manifest (a root `workspaces` entry is printed, not added). It also does **not** run `npm install`
-or `langium generate`; both are printed as next steps.
+manifest (a root `workspaces` entry and dependency pins are printed, not added). It also does
+**not** run `npm install` or `langium generate`; both are printed as next steps.
 
 Project options are position-free:
 
@@ -152,6 +168,9 @@ Project options are position-free:
   mandatory — it owns the workspace, the build pipeline and the shared tier the others read through.
 - `--monorepo` scaffolds a member of the surrounding npm workspace, `--scope <@scope>` sets the npm
   scope, `--public` drops the emitted `"private": true`, `--force` allows a non-empty directory.
+  `--monorepo` also prints the exact pins, `langium` and the LSP stack among them, for the root's
+  `devDependencies`: npm installs a root's own dependencies at the top of the tree, so another
+  member's version cannot leave this package on a copy the framework does not share.
 
 The emitted manifest carries `files` (`lib`, `src`, `syntaxes`), a derived `description` and
 `keywords`, and an empty `author` for you to fill. It is `"private": true` unless you pass
@@ -188,6 +207,10 @@ npm install
 npm run build                # langium generate + tsc, into lib/
 npm test                     # the scaffolded DI-composition test
 
+# A model to work on: the starter grammar's nodes, one referencing the other
+mkdir models
+printf 'node Start -> End\nnode End\n' > models/first.my-lang
+
 # The editor entry: LSP on stdio, every other head on a published socket
 node lib/main.js --stdio
 
@@ -206,18 +229,15 @@ npx @hydranium/cli init ./order-flow --name OrderFlow --heads lsp,data,glsp \
    --grammar Layout --extensions diagram
 ```
 
-The scaffold wires only the framework defaults. The seams a real language customizes are walked
-beside those defaults in
-[`docs/concepts/framework-vs-adopter.md`](../../docs/concepts/framework-vs-adopter.md).
+The scaffold wires only the framework defaults. The seams a real language customizes are in
+[Adopting Hydranium](../../docs/ADOPTING.md).
 
 ## Entry points
 
 This package declares a two-key `exports` map — the root barrel and the CLI
-binary — plus a `main` and a `bin`. The binary key is spelled `./lib/cli.js` and
-carries no bare alias: the pairing rule that gives every subpath a `./lib/` twin
-runs one way only, and a key already spelled that way resolves under both
-resolvers as it stands. A consumer that spawns the binary resolves it by
-specifier, and `bin` offers a shim on `PATH` rather than a path.
+binary — plus a `main` and a `bin`. The binary key names the file, `./lib/cli.js`:
+a consumer that spawns the binary resolves it by specifier, and `bin` offers a
+shim on `PATH` rather than a path.
 
 | Entry            | Kind   | Contents                         |
 | ---------------- | ------ | -------------------------------- |
@@ -231,8 +251,9 @@ and the `runProjects` / `runQuery` / `runSave` / `runWatch` command bodies.
 
 ## Status
 
-Alpha — pre-v0, not yet published. The subcommand surface and the programmatic API are both still
-moving. See the [repository README](../../README.md) for the current status and known limitations.
+Alpha — pre-v0, published as a `1.0.0-next` prerelease on every merge to `main`. The subcommand
+surface and the programmatic API are both still moving. See the [repository README](../../README.md)
+for the current status and known limitations.
 
 ## License
 

package/bin/hydranium-cli.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+
+// Committed rather than built, so the first install of a fresh clone links it:
+// npm skips a `bin` whose target is missing, and `lib/` exists only after a build.
+import '../lib/cli.js';

package/lib/cli-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli-version.js","sourceRoot":"","sources":["../src/cli-version.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,+FAA+F;AAC/F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAA0B,CAAC;IAC1F,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC3B,CAAC"}
+{"version":3,"file":"cli-version.js","sourceRoot":"","sources":["../src/cli-version.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAEvC,+FAA+F;AAC/F,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,iBAAiB,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,UAAU,cAAc;IAC3B,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAA0B,CAAC;IAC1F,IAAI,OAAO,QAAQ,CAAC,OAAO,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,KAAK,EAAE,EAAE,CAAC;QACnE,MAAM,IAAI,KAAK,CAAC,sEAAsE,CAAC,CAAC;IAC3F,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC3B,CAAC"}

package/lib/commands/analyze-heap-args.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-heap-args.js","sourceRoot":"","sources":["../../src/commands/analyze-heap-args.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"analyze-heap-args.js","sourceRoot":"","sources":["../../src/commands/analyze-heap-args.ts"],"names":[],"mappings":"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"}

package/lib/commands/analyze-heap.d.ts

@@ -6,6 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
+import { type HeapReading } from '../driver-heap.js';
 /**
  * Selects the JSON-vs-JSON comparison, which reads two analysis artifacts and
  * needs neither a snapshot nor memlab. Declared here rather than in the args
@@ -18,6 +19,8 @@ export interface AnalyzeHeapDeps {
     readonly __spawnForTest?: (execArgs: string[]) => Promise<number>;
     /** Override the memlab-availability check. */
     readonly __memlabInstalledForTest?: () => boolean;
+    /** Decide the heap ceiling from a stated cgroup reading rather than the machine's. */
+    readonly __heapReadingForTest?: HeapReading;
 }
 /**
  * Run the heap-snapshot analyzer. Memlab is an OPTIONAL PEER dependency and a

package/lib/commands/analyze-heap.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-heap.d.ts","sourceRoot":"","sources":["../../src/commands/analyze-heap.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAuBlF;;;;GAIG;AACH,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,8CAA8C;IAC9C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;CACpD;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9F"}
+{"version":3,"file":"analyze-heap.d.ts","sourceRoot":"","sources":["../../src/commands/analyze-heap.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAkB,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAqBrE;;;;GAIG;AACH,eAAO,MAAM,SAAS,WAAW,CAAC;AAElC,mGAAmG;AACnG,MAAM,WAAW,eAAe;IAC7B,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClE,8CAA8C;IAC9C,QAAQ,CAAC,wBAAwB,CAAC,EAAE,MAAM,OAAO,CAAC;IAClD,sFAAsF;IACtF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,WAAW,CAAC;CAC9C;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgB9F"}

package/lib/commands/analyze-heap.js

@@ -7,6 +7,7 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 import { fileURLToPath } from 'node:url';
+import { driverHeapArgs } from '../driver-heap.js';
 import { spawnNodeChild } from './headless-harness.js';
 /**
  * Absolute path to the bundled memlab-based analyzer (a standalone ESM script
@@ -55,7 +56,7 @@ export async function runAnalyzeHeap(args, deps = {}) {
         return;
     }
     const spawnChild = deps.__spawnForTest ?? spawnNodeChild;
-    const code = await spawnChild(['--max-old-space-size=8192', ANALYZER, ...args]);
+    const code = await spawnChild([...driverHeapArgs(deps.__heapReadingForTest), ANALYZER, ...args]);
     if (code) {
         process.exitCode = code;
     }

package/lib/commands/analyze-heap.js.map

@@ -1 +1 @@
-{"version":3,"file":"analyze-heap.js","sourceRoot":"","sources":["../../src/commands/analyze-heap.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,sCAAsC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEjG,+FAA+F;AAC/F,SAAS,eAAe;IACrB,MAAM,OAAO,GAAI,MAAM,CAAC,IAAoD,CAAC,OAAO,CAAC;IACrF,IAAI,CAAC;QACF,OAAO,EAAE,CAAC,uBAAuB,CAAC,CAAC;QACnC,OAAO,OAAO,KAAK,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACN,OAAO,KAAK,CAAC;IAChB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAUlC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,OAAwB,EAAE;IAC5E,MAAM,iBAAiB,GAAG,IAAI,CAAC,wBAAwB,IAAI,eAAe,CAAC;IAC3E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACrD,OAAO,CAAC,KAAK,CACV,qFAAqF;YAClF,sFAAsF;YACtF,kDAAkD,CACvD,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACV,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,CAAC,2BAA2B,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IAChF,IAAI,IAAI,EAAE,CAAC;QACR,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC3B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"analyze-heap.js","sourceRoot":"","sources":["../../src/commands/analyze-heap.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAAoB,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,sCAAsC,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAEjG,+FAA+F;AAC/F,SAAS,eAAe;IACrB,MAAM,OAAO,GAAI,OAAO,IAAoD,CAAC,OAAO,CAAC;IACrF,IAAI,CAAC;QACF,OAAO,EAAE,CAAC,uBAAuB,CAAC,CAAC;QACnC,OAAO,OAAO,KAAK,SAAS,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACN,OAAO,KAAK,CAAC;IAChB,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC;AAYlC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAc,EAAE,IAAI,GAAoB,EAAE;IAC5E,MAAM,iBAAiB,GAAG,IAAI,CAAC,wBAAwB,IAAI,eAAe,CAAC;IAC3E,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,CAAC;QACrD,OAAO,CAAC,KAAK,CACV,qFAAqF;YAClF,sFAAsF;YACtF,kDAAkD,CACvD,CAAC;QACF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACV,CAAC;IACD,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC;IACzD,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,CAAC,GAAG,cAAc,CAAC,IAAI,CAAC,oBAAoB,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACjG,IAAI,IAAI,EAAE,CAAC;QACR,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC;IAC3B,CAAC;AACJ,CAAC"}

package/lib/commands/ast-ground-truth-args.d.ts

@@ -10,8 +10,9 @@ import { type AstGroundTruthCommandOptions } from './ast-ground-truth.js';
 import { type UsageError } from './harness-args.js';
 /**
  * Every flag `ast-ground-truth` accepts, derived from the sets the parser is
- * handed so the list cannot claim a flag the parser would reject. `--services`
- * is consumed by the shared harness parser itself, so it is in neither set.
+ * handed so the list cannot claim a flag the parser would reject.
+ * {@link HARNESS_VALUE_FLAGS} are consumed by the shared harness parser itself,
+ * so they are in neither set.
  */
 export declare const AST_GROUND_TRUTH_FLAGS: readonly string[];
 /** The subset that takes a value, so `--help` in a value position reads as data. */

package/lib/commands/ast-ground-truth-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ast-ground-truth-args.d.ts","sourceRoot":"","sources":["../../src/commands/ast-ground-truth-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAqB,KAAK,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EASJ,KAAK,UAAU,EACjB,MAAM,mBAAmB,CAAC;AAK3B;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAoC,CAAC;AAEzF,oFAAoF;AACpF,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAA2B,CAAC;AAEtF,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAalD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,4BAA4B,CAGzH;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE"}
+{"version":3,"file":"ast-ground-truth-args.d.ts","sourceRoot":"","sources":["../../src/commands/ast-ground-truth-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAqB,KAAK,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EAUJ,KAAK,UAAU,EACjB,MAAM,mBAAmB,CAAC;AAK3B;;;;;GAKG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAA6C,CAAC;AAElG,oFAAoF;AACpF,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAA2B,CAAC;AAEtF,oFAAoF;AACpF,eAAO,MAAM,qBAAqB,EAAE,SAAS,MAAM,EAclD,CAAC;AAEF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,4BAA4B,CAGzH;AAED,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMtE"}

package/lib/commands/ast-ground-truth-args.js

@@ -7,20 +7,21 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 import { runAstGroundTruth } from './ast-ground-truth.js';
-import { exitWithUsage, helpRequested, LOG_LEVEL_FLAG, logLevelHelpLine, logLevelOption, parseHarnessArgs, printHelp, SERVICES_FLAG } from './harness-args.js';
+import { exitWithUsage, HARNESS_VALUE_FLAGS, helpRequested, importHelpLines, LOG_VALUE_FLAGS, logHelpLines, logOptions, parseHarnessArgs, printHelp } from './harness-args.js';
 import { OUT_FILE_FLAG } from './headless-harness.js';
-const VALUE_FLAGS = [OUT_FILE_FLAG, LOG_LEVEL_FLAG];
+const VALUE_FLAGS = [OUT_FILE_FLAG, ...LOG_VALUE_FLAGS];
 /**
  * Every flag `ast-ground-truth` accepts, derived from the sets the parser is
- * handed so the list cannot claim a flag the parser would reject. `--services`
- * is consumed by the shared harness parser itself, so it is in neither set.
+ * handed so the list cannot claim a flag the parser would reject.
+ * {@link HARNESS_VALUE_FLAGS} are consumed by the shared harness parser itself,
+ * so they are in neither set.
  */
-export const AST_GROUND_TRUTH_FLAGS = [SERVICES_FLAG, ...VALUE_FLAGS];
+export const AST_GROUND_TRUTH_FLAGS = [...HARNESS_VALUE_FLAGS, ...VALUE_FLAGS];
 /** The subset that takes a value, so `--help` in a value position reads as data. */
 export const AST_GROUND_TRUTH_VALUE_FLAGS = AST_GROUND_TRUTH_FLAGS;
 /** The `--help` text, as data, held to {@link AST_GROUND_TRUTH_FLAGS} by a test. */
 export const AST_GROUND_TRUTH_HELP = [
-    'Usage: hydranium-cli ast-ground-truth --services <module> <workspace> [--out-file <file>] [--log-level <lvl>]',
+    'Usage: hydranium-cli ast-ground-truth --services <module> [--import <specifier>]... <workspace> [--out-file <file>] [--log-level <lvl>] [--log-file <file>] [--log-file-level <lvl>]',
     '',
     "Tally a workspace's live-model AST nodes by `$type` — the ground truth that",
     '`analyze-heap --validate <gt.json>` checks a heap snapshot against. `<module>`',
@@ -29,13 +30,14 @@ export const AST_GROUND_TRUTH_HELP = [
     '',
     'Options:',
     '  --services <module>   ESM module exporting `createServices(): { shared }` (required).',
+    ...importHelpLines(22),
     '  <workspace>           Workspace root (path or file URI) to build (required).',
     '  --out-file <file>     Write the JSON to this file instead of stdout.',
-    logLevelHelpLine(22)
+    ...logHelpLines(22)
 ];
 export function parseAstGroundTruthArgs(args, onError = exitWithUsage) {
-    const { servicesModule, workspace, options } = parseHarnessArgs(args, 'ast-ground-truth', VALUE_FLAGS, [], { onError });
-    return { servicesModule, workspace, outFile: options[OUT_FILE_FLAG], logLevel: logLevelOption(options[LOG_LEVEL_FLAG]) };
+    const { servicesModule, imports, workspace, options } = parseHarnessArgs(args, 'ast-ground-truth', VALUE_FLAGS, [], { onError });
+    return { servicesModule, imports, workspace, outFile: options[OUT_FILE_FLAG], ...logOptions(options) };
 }
 export function runAstGroundTruthCommand(args) {
     if (helpRequested(args, AST_GROUND_TRUTH_VALUE_FLAGS)) {

package/lib/commands/ast-ground-truth-args.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast-ground-truth-args.js","sourceRoot":"","sources":["../../src/commands/ast-ground-truth-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,iBAAiB,EAAqC,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EACJ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,aAAa,EAEf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,cAAc,CAAU,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB,CAAC,aAAa,EAAE,GAAG,WAAW,CAAC,CAAC;AAEzF,oFAAoF;AACpF,MAAM,CAAC,MAAM,4BAA4B,GAAsB,sBAAsB,CAAC;AAEtF,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACrD,+GAA+G;IAC/G,EAAE;IACF,6EAA6E;IAC7E,gFAAgF;IAChF,oEAAoE;IACpE,0EAA0E;IAC1E,EAAE;IACF,UAAU;IACV,yFAAyF;IACzF,gFAAgF;IAChF,wEAAwE;IACxE,gBAAgB,CAAC,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,IAAc,EAAE,UAAsB,aAAa;IACxF,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACxH,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;AAC5H,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAc;IACpD,IAAI,aAAa,CAAC,IAAI,EAAE,4BAA4B,CAAC,EAAE,CAAC;QACrD,SAAS,CAAC,qBAAqB,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,iBAAiB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC"}
+{"version":3,"file":"ast-ground-truth-args.js","sourceRoot":"","sources":["../../src/commands/ast-ground-truth-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,iBAAiB,EAAqC,MAAM,uBAAuB,CAAC;AAC7F,OAAO,EACJ,aAAa,EACb,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,eAAe,EACf,YAAY,EACZ,UAAU,EACV,gBAAgB,EAChB,SAAS,EAEX,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,GAAG,eAAe,CAAU,CAAC;AAEjE;;;;;GAKG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAsB,CAAC,GAAG,mBAAmB,EAAE,GAAG,WAAW,CAAC,CAAC;AAElG,oFAAoF;AACpF,MAAM,CAAC,MAAM,4BAA4B,GAAsB,sBAAsB,CAAC;AAEtF,oFAAoF;AACpF,MAAM,CAAC,MAAM,qBAAqB,GAAsB;IACrD,sLAAsL;IACtL,EAAE;IACF,6EAA6E;IAC7E,gFAAgF;IAChF,oEAAoE;IACpE,0EAA0E;IAC1E,EAAE;IACF,UAAU;IACV,yFAAyF;IACzF,GAAG,eAAe,CAAC,EAAE,CAAC;IACtB,gFAAgF;IAChF,wEAAwE;IACxE,GAAG,YAAY,CAAC,EAAE,CAAC;CACrB,CAAC;AAEF,MAAM,UAAU,uBAAuB,CAAC,IAAc,EAAE,OAAO,GAAe,aAAa;IACxF,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,kBAAkB,EAAE,WAAW,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IACjI,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;AAC1G,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,IAAc;IACpD,IAAI,aAAa,CAAC,IAAI,EAAE,4BAA4B,CAAC,EAAE,CAAC;QACrD,SAAS,CAAC,qBAAqB,CAAC,CAAC;QACjC,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,iBAAiB,CAAC,uBAAuB,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3D,CAAC"}

package/lib/commands/ast-ground-truth.js

@@ -31,6 +31,6 @@ export function buildGroundTruthDriverArgs(options) {
  * `--out-file`). No `--expose-gc` needed — this walks the AST, it does not weigh it.
  */
 export function runAstGroundTruth(options) {
-    return runDriverChild(['--max-old-space-size=8192', DRIVER, ...buildGroundTruthDriverArgs(options)], options);
+    return runDriverChild([DRIVER, ...buildGroundTruthDriverArgs(options)], options);
 }
 //# sourceMappingURL=ast-ground-truth.js.map

package/lib/commands/ast-ground-truth.js.map

@@ -1 +1 @@
-{"version":3,"file":"ast-ground-truth.js","sourceRoot":"","sources":["../../src/commands/ast-ground-truth.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAE/F;;;GAGG;AACH,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAYvF,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CAAC,OAAqC;IAC7E,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAqC;IACpE,OAAO,cAAc,CAAC,CAAC,2BAA2B,EAAE,MAAM,EAAE,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACjH,CAAC"}
+{"version":3,"file":"ast-ground-truth.js","sourceRoot":"","sources":["../../src/commands/ast-ground-truth.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAE/F;;;GAGG;AACH,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,8BAA8B,EAAE,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAYvF,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CAAC,OAAqC;IAC7E,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;IACvE,IAAI,OAAO,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IACD,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAqC;IACpE,OAAO,cAAc,CAAC,CAAC,MAAM,EAAE,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACpF,CAAC"}

package/lib/commands/generate-ast-builder.d.ts

@@ -0,0 +1,49 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import type { SourceFile } from 'ts-morph';
+/** Inputs for {@link emitAstBuilder}, resolved by the transfer-model command. */
+export interface EmitAstBuilderOptions {
+    /** Destination path for the generated builder module. */
+    outFile: string;
+    /** Path to the Langium-generated AST file the builder imports from. */
+    astFile: string;
+    /** Language id derived from the `<LanguageId>AstReflection` class name. */
+    languageId: string;
+    /** Header line naming the command that regenerates the file. */
+    regenCommand: string;
+}
+/**
+ * Emit a module binding {@link makeAstNodeBuilder} to a project's reflection,
+ * once per grammar plus once across all of them.
+ *
+ * **The binding is boilerplate with exactly one degree of freedom** — the type
+ * map — so hand-writing it buys nothing and goes stale the moment a grammar is
+ * added. Generating it is also the only way a narrowed binding can exist at all:
+ * the per-grammar type maps live in namespaces Langium emits only on its
+ * multi-language path, so a single-grammar project gets the merged binding alone
+ * and there is nothing to narrow.
+ *
+ * **A narrowed binding is only as narrow as its grammar's import closure.**
+ * Langium's per-grammar `AstType` lists everything REACHABLE from that grammar,
+ * so where one grammar imports all the others its map equals the project's and
+ * its binding checks nothing the merged one does not. The emitted doc says so at
+ * each declaration rather than promising a guarantee the type map cannot give.
+ *
+ * Answers `false` when the AST source declares no whole-project type alias,
+ * which means the file did not come from `langium generate` and the caller
+ * should report rather than write a module that cannot compile.
+ */
+export declare function emitAstBuilder(astSource: SourceFile, options: EmitAstBuilderOptions): boolean;
+/**
+ * The module text {@link emitAstBuilder} would write, or `undefined` when the
+ * AST source declares no whole-project type alias. Pure over its inputs, so the
+ * emitted shape is testable without touching a filesystem.
+ */
+export declare function buildAstBuilderSource(astSource: SourceFile, options: EmitAstBuilderOptions): string | undefined;
+//# sourceMappingURL=generate-ast-builder.d.ts.map

package/lib/commands/generate-ast-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-ast-builder.d.ts","sourceRoot":"","sources":["../../src/commands/generate-ast-builder.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,iFAAiF;AACjF,MAAM,WAAW,qBAAqB;IACnC,yDAAyD;IACzD,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,OAAO,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;CACvB;AAyBD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAc7F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,GAAG,MAAM,GAAG,SAAS,CAqB/G"}

package/lib/commands/generate-ast-builder.js

@@ -0,0 +1,200 @@
+/********************************************************************************
+ * Copyright (c) 2026 CrossBreeze, EclipseSource and others.
+ *
+ * This program and the accompanying materials are made available under the
+ * terms of the MIT License which is available in the project root.
+ *
+ * SPDX-License-Identifier: MIT
+ ********************************************************************************/
+import * as fs from 'fs';
+import * as path from 'path';
+/**
+ * Langium declares this type alias inside each language's namespace in a
+ * multi-language project. Its presence is what marks a namespace as a grammar's
+ * type registry rather than an incidental one.
+ */
+const NAMESPACED_AST_TYPE_NAME = 'AstType';
+/** Export name of the merged, whole-project binding. */
+const MERGED_EXPORT_NAME = 'astNode';
+/**
+ * Emit a module binding {@link makeAstNodeBuilder} to a project's reflection,
+ * once per grammar plus once across all of them.
+ *
+ * **The binding is boilerplate with exactly one degree of freedom** — the type
+ * map — so hand-writing it buys nothing and goes stale the moment a grammar is
+ * added. Generating it is also the only way a narrowed binding can exist at all:
+ * the per-grammar type maps live in namespaces Langium emits only on its
+ * multi-language path, so a single-grammar project gets the merged binding alone
+ * and there is nothing to narrow.
+ *
+ * **A narrowed binding is only as narrow as its grammar's import closure.**
+ * Langium's per-grammar `AstType` lists everything REACHABLE from that grammar,
+ * so where one grammar imports all the others its map equals the project's and
+ * its binding checks nothing the merged one does not. The emitted doc says so at
+ * each declaration rather than promising a guarantee the type map cannot give.
+ *
+ * Answers `false` when the AST source declares no whole-project type alias,
+ * which means the file did not come from `langium generate` and the caller
+ * should report rather than write a module that cannot compile.
+ */
+export function emitAstBuilder(astSource, options) {
+    const content = buildAstBuilderSource(astSource, options);
+    if (content === undefined) {
+        return false;
+    }
+    fs.mkdirSync(path.dirname(options.outFile), { recursive: true });
+    if (fs.existsSync(options.outFile) && fs.readFileSync(options.outFile, 'utf-8') === content) {
+        console.log('AST builder is up to date.');
+        return true;
+    }
+    fs.writeFileSync(options.outFile, content, 'utf-8');
+    console.log(`Generated: ${options.outFile}`);
+    return true;
+}
+/**
+ * The module text {@link emitAstBuilder} would write, or `undefined` when the
+ * AST source declares no whole-project type alias. Pure over its inputs, so the
+ * emitted shape is testable without touching a filesystem.
+ */
+export function buildAstBuilderSource(astSource, options) {
+    const mergedTypeMap = `${options.languageId}AstType`;
+    if (!astSource.getTypeAlias(mergedTypeMap)) {
+        return undefined;
+    }
+    const bindings = [{ exportName: MERGED_EXPORT_NAME, typeMap: mergedTypeMap }];
+    for (const namespace of findGrammarNamespaces(astSource)) {
+        bindings.push({
+            exportName: builderExportName(namespace),
+            typeMap: `${namespace}.${NAMESPACED_AST_TYPE_NAME}`,
+            namespace
+        });
+    }
+    assertDistinctExportNames(bindings);
+    return renderAstBuilder(bindings, {
+        reflectionName: findReflectionConstName(astSource, options.languageId),
+        importPath: relativeImportPath(options.outFile, options.astFile),
+        regenCommand: options.regenCommand
+    });
+}
+/**
+ * Namespaces that carry a grammar's type registry, in declaration order.
+ *
+ * Keyed on the nested `AstType` alias rather than on the namespace being
+ * exported, because an adopter's augmentation can add namespaces to the same
+ * file for unrelated reasons and only the ones Langium emits per grammar have
+ * a type map to bind.
+ */
+function findGrammarNamespaces(astSource) {
+    const names = [];
+    for (const module of astSource.getModules()) {
+        const name = module.getName();
+        if (name && module.getTypeAlias(NAMESPACED_AST_TYPE_NAME)) {
+            names.push(name);
+        }
+    }
+    return names;
+}
+/**
+ * `Domain` → `domainNode`. Lower-cases the leading character only, so a grammar
+ * named `OrderFlow` reads as `orderFlowNode` rather than losing its word break.
+ */
+function builderExportName(namespace) {
+    return `${namespace.charAt(0).toLowerCase()}${namespace.slice(1)}Node`;
+}
+/**
+ * Two grammars whose names differ only in their leading character collapse to
+ * one export. Emitting anyway would silently drop a binding, so fail with both
+ * names rather than leave the caller to discover it at compile time.
+ */
+function assertDistinctExportNames(bindings) {
+    const seen = new Map();
+    for (const binding of bindings) {
+        const previous = seen.get(binding.exportName);
+        if (previous !== undefined) {
+            throw new Error(`Cannot emit the AST builder: grammars '${previous}' and '${binding.namespace}' both map to the export ` +
+                `'${binding.exportName}'. Rename one grammar so the generated bindings stay distinct.`);
+        }
+        seen.set(binding.exportName, binding.namespace ?? MERGED_EXPORT_NAME);
+    }
+}
+/**
+ * Name of the const holding the project's reflection instance.
+ *
+ * Langium emits `export const reflection = new <LanguageId>AstReflection()`, but
+ * the const is located by its initializer rather than by that name so a renamed
+ * export still resolves. Falls back to the emitted default when no declaration
+ * matches, which keeps the output compiling against a stock Langium file.
+ */
+function findReflectionConstName(astSource, languageId) {
+    const reflectionClass = `${languageId}AstReflection`;
+    for (const declaration of astSource.getVariableDeclarations()) {
+        if (declaration.getInitializer()?.getText().replace(/\s/g, '') === `new${reflectionClass}()`) {
+            return declaration.getName();
+        }
+    }
+    return 'reflection';
+}
+/**
+ * Module specifier for the AST file as seen from the generated module's own
+ * directory. Emitted with a `.js` extension and posix separators because the
+ * output is ESM TypeScript, where the specifier names the compiled sibling.
+ */
+function relativeImportPath(outFile, astFile) {
+    const relative = path.relative(path.dirname(path.resolve(outFile)), path.resolve(astFile));
+    const posix = relative.split(path.sep).join('/').replace(/\.ts$/, '.js');
+    return posix.startsWith('.') ? posix : `./${posix}`;
+}
+function renderAstBuilder(bindings, context) {
+    const imported = [context.reflectionName, ...bindings.map(binding => `type ${binding.namespace ?? binding.typeMap}`)];
+    const out = [];
+    out.push('/******************************************************************************');
+    out.push(' * Generated from the Langium AST — DO NOT EDIT MANUALLY!');
+    out.push(` * ${context.regenCommand}`);
+    out.push(' ******************************************************************************/');
+    out.push('');
+    out.push('/* eslint-disable */');
+    out.push('');
+    out.push("import { makeAstNodeBuilder } from '@hydranium/core';");
+    out.push(`import { ${imported.join(', ')} } from '${context.importPath}';`);
+    out.push('');
+    // A single-grammar project has nothing to narrow to, so the merged binding is
+    // simply THE binding there and must not point at a sibling that was not emitted.
+    const narrowed = bindings.some(binding => binding.namespace !== undefined);
+    const guarantee = [
+        ' * Mandatory fields are a type error at the call site, and grammar-declared',
+        ' * containment arrays are materialised from reflection metadata, so a built',
+        ' * node carries `[]` where a cast literal would leave `undefined`.'
+    ];
+    for (const binding of bindings) {
+        out.push('/**');
+        if (binding.namespace !== undefined) {
+            out.push(` * AST-node factory narrowed to the '${binding.namespace}' grammar.`);
+            out.push(' *');
+            out.push(' * Narrowed by grammar REACHABILITY, not by ownership: a grammar that');
+            out.push(" * imports another sees that one's types too, so this binding is only as");
+            out.push(` * narrow as '${binding.namespace}'s import closure. Where that closure is the`);
+            out.push(' * whole project, it accepts exactly what the merged binding does and the');
+            out.push(' * choice is documentation rather than a check.');
+            out.push(' *');
+            out.push(...guarantee);
+        }
+        else if (narrowed) {
+            out.push(' * AST-node factory spanning every grammar in this project.');
+            out.push(' *');
+            out.push(' * Prefer the narrowed binding matching the grammar the call site works in:');
+            out.push(" * it rejects a type outside that grammar's import closure, which this one");
+            out.push(' * accepts from anywhere. Reach for this one where a call site genuinely');
+            out.push(' * spans grammars.');
+        }
+        else {
+            out.push(" * AST-node factory for this project's grammar.");
+            out.push(' *');
+            out.push(...guarantee);
+        }
+        out.push(' */');
+        out.push(`export const ${binding.exportName} = makeAstNodeBuilder<${binding.typeMap}>(${context.reflectionName});`);
+        out.push('');
+    }
+    return out.join('\n');
+}
+//# sourceMappingURL=generate-ast-builder.js.map

package/lib/commands/generate-ast-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-ast-builder.js","sourceRoot":"","sources":["../../src/commands/generate-ast-builder.ts"],"names":[],"mappings":"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"}

package/lib/commands/generate-transfer-model-args.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"generate-transfer-model-args.d.ts","sourceRoot":"","sources":["../../src/commands/generate-transfer-model-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAA6C,KAAK,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5H,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7F;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAa1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,EAAE,SAAS,MAAM,EAAqE,CAAC;AAEvI,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EA4BzD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACnC,KAAK,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,qBAAqB,CAsE/G;AAcD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpF"}
+{"version":3,"file":"generate-transfer-model-args.d.ts","sourceRoot":"","sources":["../../src/commands/generate-transfer-model-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAA6C,KAAK,4BAA4B,EAAE,MAAM,8BAA8B,CAAC;AAC5H,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAG7F;;;;;;;;GAQG;AACH,eAAO,MAAM,6BAA6B,EAAE,SAAS,MAAM,EAc1D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,mCAAmC,EAAE,SAAS,MAAM,EAAqE,CAAC;AAEvI,2FAA2F;AAC3F,eAAO,MAAM,4BAA4B,EAAE,SAAS,MAAM,EAkCzD,CAAC;AAEF,2FAA2F;AAC3F,MAAM,WAAW,qBAAqB;IACnC,KAAK,EAAE,OAAO,CAAC,4BAA4B,CAAC,CAAC;IAC7C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,OAAO,CAAC;CACjB;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,qBAAqB,CAyE/G;AAcD,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAiCpF"}

package/lib/commands/generate-transfer-model-args.js

@@ -27,6 +27,7 @@ export const GENERATE_TRANSFER_MODEL_FLAGS = [
     '--ast-file',
     '--augmentation-file',
     '--out-file',
+    '--ast-builder-file',
     '--element-type-name',
     '--terminals-name',
     '--terminals-source-name',
@@ -44,7 +45,8 @@ export const GENERATE_TRANSFER_MODEL_VALUE_FLAGS = GENERATE_TRANSFER_MODEL_FLAGS
 export const GENERATE_TRANSFER_MODEL_HELP = [
     'Usage: hydranium-cli generate-transfer-model [options]',
     '',
-    'Generate a serializable transfer-model TypeScript file from a Langium AST. The',
+    'Generate a serializable transfer-model TypeScript file from a Langium AST, and',
+    'optionally an AST-node builder module bound to the same reflection. The',
     'required inputs (--ast-file / --augmentation-file / --out-file) may instead come',
     'from a --config JSON file, and --ast-file can be auto-discovered from a Langium',
     "config's `out` directory. Precedence, highest first: explicit flags, then the",
@@ -63,6 +65,11 @@ export const GENERATE_TRANSFER_MODEL_HELP = [
     '                                directory: it treats that directory as exclusively',
     '                                its own, so every `langium generate` reports this',
     '                                file as unexpected and offers to delete it.',
+    '  --ast-builder-file <path>     Also emit an AST-node builder module here: one',
+    '                                makeAstNodeBuilder binding per grammar, plus one',
+    '                                spanning all of them. Omit if nothing constructs',
+    '                                AST nodes. Same restriction as --out-file: keep it',
+    "                                out of langium-cli's own `out` directory.",
     '  --element-type-name <name>    Base element type name in output. Default: TransferElement.',
     '  --terminals-name <name>       Terminals const name in output. Default: ModelTerminals.',
     '  --terminals-source-name <n>   Source-side terminals variable name. Default: <LanguageId>Terminals.',
@@ -106,6 +113,9 @@ export function parseGenerateOptions(args, onError = exitWithUsage) {
             case '--out-file':
                 flags.outFile = next();
                 break;
+            case '--ast-builder-file':
+                flags.astBuilderFile = next();
+                break;
             case '--element-type-name':
                 flags.elementTypeName = next();
                 break;