@hydranium/cli 1.0.0-next.42 → 1.0.0-next.421

package/README.md

@@ -1,240 +1,161 @@
 # `@hydranium/cli`
 
-The headless tool surface of the [Hydranium](https://github.com/eclipse-emfcloud/hydranium)
-framework, published as the `hydranium-cli` binary.
-
-Install it if you are building a Hydranium language. `init` scaffolds a complete project from one
-invocation; the other twelve subcommands drive an already-built head from a shell or a CI step —
-grammar introspection, headless validation, transfer-model codegen, memory measurement, and
-operations against a spawned data-server.
+The `hydranium-cli` binary of the
+[Hydranium](https://github.com/eclipse-emfcloud/hydranium) framework. You
+install it when you build a Hydranium language: `init` scaffolds the project,
+and the other commands drive your built head from a shell or a CI step.
 
 ## What it gives you
 
-- **`init`** — a buildable project (starter grammar, `create<Name>Services` DI wiring, an LSP +
-  data-server launch, `langium-config.json`, build scripts) from one command, or from a wizard that
-  echoes the flags it composed.
-- **CI gates that need no editor** — `validate` exits non-zero on a diagnostic; `lint-grammar`
-  checks that every concrete cross-reference target carries a name property and that each language
-  declares an entry rule.
-- **Grammar introspection** — `reflect` (type hierarchy, terminals, every cross-reference target;
-  Markdown or `--json`) and `model-docs` (a navigable Markdown model reference for your own docs).
-- **Codegen** — `generate-transfer-model` turns a Langium-generated AST into a serializable transfer
-  model, once or in `--watch`.
-- **Memory and profiling** — `measure-memory`, `ast-ground-truth`, and the memlab-based
-  `analyze-heap`.
-- **Data-server operations** — `projects`, `query`, `save` and `watch` spawn a data-server child and
-  speak its protocol, printing JSON / NDJSON a script can pipe.
+- Scaffold a buildable language project with one `init` command, or answer a
+  wizard that echoes the command it composed.
+- Fail a CI step on a diagnostic or a grammar-convention violation, with no
+  editor running.
+- Dump your grammar's reflection, or write a Markdown model reference for your
+  own docs.
+- Generate the serializable transfer model from Langium's generated AST.
+- Measure model-store memory and analyze a V8 heap snapshot.
+- Install optional coding-agent skills after scaffolding and check their
+  declared compatibility with your project's installed dependencies.
+- List, read, create, save and watch documents through a spawned data server,
+  printing JSON a script can pipe, and delete them.
 
 ## 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:
+`init` needs no install:
 
 ```bash
 npx @hydranium/cli init ./my-lang --name MyLang
 ```
 
-For the subcommands you run repeatedly, add it to the project it inspects, or install it globally:
+For the commands you run repeatedly, add it to the project it inspects, or
+install it globally:
 
 ```bash
 npm install --save-dev @hydranium/cli
 npm install --global @hydranium/cli
 ```
 
-The framework edges are **peer dependencies** — `@hydranium/core`, `@hydranium/data-server`,
-`@hydranium/langium`, `@hydranium/protocol` and `vscode-jsonrpc` — so the CLI runs the same physical
-copies as the head it inspects (`init` itself needs none of them). The memlab packages
-`analyze-heap` loads are **optional peer dependencies**, so installing this package pulls no browser:
-run `npm install @memlab/core @memlab/heap-analysis` (heavy, ~86 MB) before the first
-`analyze-heap`. Every other subcommand works without them.
-
-## Subcommands
-
-`hydranium-cli --help` lists them; `hydranium-cli <command> --help` prints one command's own flags.
-
-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.
-
-**Scaffolding**
-
-- `init <target-dir>` — scaffold a new language project. See the section below.
-
-**Grammar and workspace** (`--services <module>`)
-
-- `reflect` — dump the grammar/AST reflection: type hierarchy, per-language terminals and entry
-  rule, every cross-reference target. `--json`, `--out-file <file>`.
-- `lint-grammar` — check the grammar against framework conventions; non-zero exit on a violation.
-  `--name-property <p>` (repeatable), `--strict`, `--json`.
-- `model-docs` — emit a navigable Markdown model reference on stdout, or into `--out-file <file>`.
-- `validate <workspace>` — build a workspace headlessly and report its diagnostics; non-zero exit on
-  any error. `--strict` (also fail on warnings), `--json`, `--out-file <file>`.
-- `measure-memory <workspace>` — measure model-store memory in an `--expose-gc` child.
-  `--edits <N>`, `--edit-docs <N>`, `--churn-suffix <ext>`, `--settle <ms>`, `--snapshot`,
-  `--snapshot-path <p>`, `--profile <dims>`, `--session-out <dir>`, `--json`.
-- `ast-ground-truth <workspace>` — tally the live model's AST nodes by `$type`, the ground truth
-  `analyze-heap --validate` checks a snapshot against. `--out-file <file>`.
-
-All six also take `--log-level <off|error|warn|info|debug|trace>`, which sets the threshold for the
-head the subcommand boots — not for the CLI itself. It reaches the head through the child's
-environment, so a head that binds a logger of its own decides what the flag means to it.
-
-The three `<workspace>` commands resolve that argument to an existing directory before they start —
-a filesystem path or a `file:` URI — and exit 2 naming it when it reaches none. Without that a CI
-step whose path has rotted builds nothing, reports whatever documents the head contributes
-independently of the workspace, and exits 0; the count is a property of the head, so it can be
-plausibly non-zero and cannot be read as the tell.
-
-**Codegen**
-
-- `generate-transfer-model` — generate a transfer-model TypeScript file from a Langium AST.
-  `--ast-file`, `--augmentation-file` and `--out-file` are required, and may come from
-  `--config <path>` instead; `--langium-config <path>` derives `--ast-file` from that config's `out`
-  directory. `--watch` regenerates on change, and the output-naming flags (`--element-type-name`,
-  `--terminals-name`, `--terminals-source-name`, `--skip-type-alias`, `--skip-terminal`,
-  `--regen-command`) tune the emitted file.
-
-**Heap analysis**
-
-- `analyze-heap <snapshot>` — Langium-aware V8 heap-snapshot analysis. Its flags (`--out-file`,
-  `--json`, `--diff`, `--validate <gt.json>`, `--renderer`, and the drill-down tuning flags) are
-  declared alongside every other subcommand's, so an unrecognised one is rejected rather than
-  ignored.
-
-**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>`
-and `--log-level <off|error|warn|info|debug|trace>`.
-
-`--server` has to name an entry that puts the **data** protocol on stdio, which for a scaffolded
-project is `lib/data-server-main.js` — `init` emits it, and the `<project-id>-data-server` bin key
-points at it. `lib/main.js` is the editor entry: stdio there carries LSP and the data head is a
-socket whose port is published over the LSP connection, so pointing `--server` at it answers
-`Unhandled method data-server/getProjects` (or, without `--stdio`, exits on "Connection input stream
-is not set"). Pass the workspace as the entry's own argument rather than through `--cwd`: `--cwd`
-re-roots the child, so a relative entry path would resolve against the workspace — the parser
-refuses that combination by name rather than letting the child fail on a bare module-not-found.
-An absolute entry path works with `--cwd`.
-
-```bash
-hydranium-cli projects --server "node ./lib/data-server-main.js ./models"
+| Peer                     | Range         |
+| ------------------------ | ------------- |
+| `@hydranium/core`        | `^1.0.0-next` |
+| `@hydranium/data-server` | `^1.0.0-next` |
+| `@hydranium/langium`     | `^1.0.0-next` |
+| `@hydranium/protocol`    | `^1.0.0-next` |
+| `@memlab/core`           | `^2.0.3`      |
+| `@memlab/heap-analysis`  | `^2.0.3`      |
+| `vscode-jsonrpc`         | `^9.0.3`      |
+
+The two memlab packages are optional peers that only `analyze-heap` loads:
+install them with `npm install @memlab/core @memlab/heap-analysis` before its
+first run.
+
+## Commands
+
+`hydranium-cli --help` lists the commands, and `hydranium-cli <command> --help`
+lists each command's flags.
+
+- **Scaffolding.** `init` writes a project you can build right away: a server
+  package, a protocol package its clients share, a client package with a
+  diagram, a browser page around the heads with `--hosts browser`, VS Code
+  extensions with `--hosts vscode`, a Theia extension with a browser
+  application with `--hosts theia-browser` or an Electron one with
+  `--hosts theia-electron`, and a starter workspace.
+- **Grammar and workspace.** Boot your built head to reflect its grammar, lint
+  it, write a model reference, validate a workspace, or count its AST nodes.
+- **Agent skills.** The wizard offers Hydranium and upstream Langium skills
+  after scaffolding. `check-skills` checks installed skill metadata against
+  your dependencies; see *Work with coding-agent skills* in the adopter guides.
+- **Codegen.** `generate-transfer-model` turns the AST into a transfer model,
+  once or on watch, and can also write each grammar's language id and
+  extensions for a package your clients share without Langium, and a
+  `transferNode` builder for your tests.
+- **Translations.** `message-catalogue` writes an English starter catalogue
+  from the message barrels of your installed heads and your language.
+- **Memory.** Measure a workspace's model-store memory, and analyze a heap
+  snapshot.
+- **Data server.** Spawn your data head and list projects, or query, create,
+  save, delete or watch a document.
+
+Commands that boot your language need an ESM module exporting a zero-arg
+`createServices()` that returns `{ shared }`. Declare its file path once in
+`package.json`:
+
+```json
+{
+  "hydranium": {
+    "services": "./server/lib/node/services.js"
+  }
+}
 ```
 
-- `projects` — list the projects the server exposes, one JSON envelope per line.
-- `query --uri <uri>` — print that document's envelope as a single JSON line.
-- `save --uri <uri> --content <text|@file>` — update and persist the document; an `@`-prefixed value
-  reads the content from a file. `--client-id <id>`. This is the only writing subcommand, and it
-  spawns a data server of its own: a workspace has a **single writer**, so pointing it at one an
-  editor already has open is two writers and the later write wins. Neither process will see a
-  half-written file, but nothing serialises them either, so a lost write is the documented
-  outcome rather than a defect — the guarantee, its one exception and what it does not cover are
-  in [Status: one process writes a workspace](../../docs/adopting/status.md#one-process-writes-a-workspace).
-- `watch --uri <uri>` — subscribe to document updates and print events as NDJSON until Ctrl-C.
-  `--client-id <id>`.
-
-## `init` in detail
-
-`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.
-
-Project options are position-free:
-
-- `<target-dir>` and `--name <Name>` are required. `--name` is the PascalCase **project** name and
-  drives the shared generated symbols (`<Name>AstReflection`, `<Name>GeneratedSharedModule`).
-- `--heads <list>` picks the protocol heads from `lsp`, `data`, `glsp`; default `lsp,data`. `lsp` is
-  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.
-
-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
-`--public`, because it also declares `"license": "UNLICENSED"` — a scaffold cannot pick a licence for
-your project, and a package that grants no rights has no business being publishable to a public
-registry. Choose a licence, then pass `--public`. The wizard asks this on every run rather than
-letting a default settle it. `files` is not cosmetic: without it npm falls back
-to the `.gitignore` the scaffold also writes, which ignores `lib/` — so a publish would ship `main`
-and omit the `bin` targets beside it, and succeed. There is deliberately no `repository`: a scaffold
-cannot know yours, and tooling follows that field rather than merely displaying it.
-
-There is one `bin` key per executable entry — `<project-id>` for `src/main.ts`, plus
-`<project-id>-data-server` for `src/data-server-main.ts` when `data` is in `--heads`. Both sources
-begin with a `#!` line, because npm sets the exec bit on a linked target without adding one: a
-first line that is anything else is handed to the shell.
-
-Grammar options are **repeatable and order-scoped**: each applies to the `--grammar` it follows.
-
-- `--grammar <Name>` — the PascalCase grammar name; pass it once per grammar. Defaults to `--name`.
-- `--extensions <list>` — comma-separated file extensions for that grammar, leading dot optional;
-  accumulates. Defaults to the kebab-cased grammar name.
-- `--language-id <id>` — override that grammar's derived routing key.
-- `--diagram` — scaffold a GLSP diagram for that grammar; requires `glsp` in `--heads`.
-
-Leave `--name` off on an interactive terminal and `init` prompts instead, then echoes the command it
-composed before running it — so the wizard is a way to reach an `init` command line, not an
-alternative to one. Without a TTY a missing `--name` stays an error, so CI never hangs.
+The CLI reads the nearest `package.json` from your current directory upwards
+and resolves this path relative to that manifest. It stops at that package,
+even if it has no setting. A standalone scaffold configures its root and server
+package, so `npx hydranium-cli reflect` works from either after building. For a
+scaffold added to an existing workspace, run from its server package or pass
+`--services` from the workspace root.
+
+`--services <module>` overrides the setting and resolves relative to your
+current directory. To run TypeScript source, register a loader with `--import`:
+`npx hydranium-cli reflect --import tsx --services ./server/src/node/services.ts`.
+
+The data-server commands take `--server "<cmd> [args...]"`. Point it at the
+data head's stdio entry, `server/lib/data-server-main.js` in a scaffolded
+project, not at the editor entry `server/lib/main.js`, whose stdio carries LSP.
+Pass the workspace as the entry's argument rather than through `--cwd`:
 
 ```bash
-# Scaffold, install, build
-npx @hydranium/cli init ./my-lang --name MyLang
-cd my-lang
-npm install
-npm run build                # langium generate + tsc, into lib/
-npm test                     # the scaffolded DI-composition test
-
-# The editor entry: LSP on stdio, every other head on a published socket
-node lib/main.js --stdio
-
-# The data head alone, on stdio — the entry the four --server subcommands spawn
-hydranium-cli projects --server "node ./lib/data-server-main.js ./models"
-
-# Drive the rest of the CLI against the built factory
-npx hydranium-cli reflect      --services ./lib/services.js
-npx hydranium-cli lint-grammar --services ./lib/services.js
-npx hydranium-cli validate     --services ./lib/services.js ./models
-npx hydranium-cli model-docs   --services ./lib/services.js --out-file model-reference.md
-
-# Several grammars, three heads, one of them with a diagram
-npx @hydranium/cli init ./order-flow --name OrderFlow --heads lsp,data,glsp \
-   --grammar Domain --grammar Process --diagram \
-   --grammar Layout --extensions diagram
+hydranium-cli projects --server "node ./server/lib/data-server-main.js ./workspace"
 ```
 
-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).
+`create`, `save` and `delete` spawn a data server of their own, and a
+workspace has one writer. Writing in a workspace an editor has open makes two
+writers, and one write is lost: an editor that holds a deleted file can save it
+back.
+
+`generate-transfer-model` emits a constant under each type's name, as Langium
+does for the AST. If the module that re-exports the generated model narrows an
+interface, its declaration hides the generated constant of the same name, so
+re-export that constant beside it. The generated `<LanguageId>TransferTypes`
+map still names the generated interface, so declare the map under its own
+name too, and `transferNode` builds the narrowed type. That reaches only the
+type's own entry: a property or a union that holds the type, here a
+`Declaration`, still names the generated interface.
+
+```ts
+import * as generated from './generated-hydranium/transfer-model.js';
+export * from './generated-hydranium/transfer-model.js';
+export interface Entity extends generated.Entity {
+   name: `${string}Entity`;
+}
+export const Entity = generated.Entity;
+export type OrderFlowTransferTypes = Omit<generated.OrderFlowTransferTypes, 'Entity'> & { Entity: Entity };
+```
 
-## Entry points
+Commands that spawn a child give it a heap ceiling; set
+`HYDRANIUM_CLI_MAX_OLD_SPACE_MB` to state your own in MiB.
 
-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.
+## Entry points
 
-| Entry            | Kind   | Contents                         |
-| ---------------- | ------ | -------------------------------- |
-| `hydranium-cli`  | `bin`  | The binary — all 13 subcommands. |
-| `@hydranium/cli` | `main` | Programmatic API (see below).    |
+| Subpath          | Use it for                                                                   | Runs in |
+| ---------------- | ---------------------------------------------------------------------------- | ------- |
+| `hydranium-cli`  | The binary (`bin`).                                                          | Node    |
+| `.`              | Spawn a data server and get a typed proxy; run the codegen as a function.    | Node    |
+| `./lib/cli.js`   | Resolve the binary's file by specifier, to spawn it from a script or a test. | Node    |
 
-The programmatic surface is the part of the CLI worth calling from your own scripts and tests rather
-than through argv: `spawnDataServer` / `withDataServer` (spawn a data-server child and get a typed
-proxy, with teardown), `generateTransferModel` / `watchTransferModel` (the codegen, as a function),
-and the `runProjects` / `runQuery` / `runSave` / `runWatch` command bodies.
+The subpaths need a TypeScript `moduleResolution` that reads `exports`
+(`NodeNext` or `Bundler`); see *Requirements* in
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## 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: every release is a prerelease that may break the API, so pin an exact
+version. Guides and known limitations:
+[Adopting Hydranium](https://github.com/eclipse-emfcloud/hydranium/blob/main/docs/ADOPTING.md).
 
 ## License
 
 `MIT` — see this package's [`LICENSE`](./LICENSE), and the repository
-[`NOTICE.md`](../../NOTICE.md) for third-party notices.
+[`NOTICE.md`](https://github.com/eclipse-emfcloud/hydranium/blob/main/NOTICE.md)
+for third-party notices.

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/heap-analysis/heap/core/load.mjs

@@ -24,10 +24,10 @@ const mb = bytes => bytes / (1024 * 1024);
  * @param {(msg: string) => void} [log] timestamped progress sink (defaults to stderr)
  */
 export async function loadHeap(file, log = progress) {
-   const t0 = Date.now();
+   const t0 = performance.now();
    log(`Loading ${file} ...`);
    const heap = await getFullHeapFromFile(file);
-   const loadSeconds = (Date.now() - t0) / 1000;
+   const loadSeconds = (performance.now() - t0) / 1000;
 
    let totalShallow = 0;
    heap.nodes.forEach(node => {

package/heap-analysis/heap/langium/langium.classifier.mjs

@@ -86,6 +86,16 @@ const LANGIUM_GRAMMAR_TYPES = [
    'StringLiteral'
 ];
 
+// Own fields every description payload has, as a literal or a class instance;
+// the segments are left out because a class may expose them as prototype getters.
+const isDescriptionPayload = props => has(props, 'name', 'type', 'documentUri', 'path');
+
+// The payload carries `type` = the described node's element kind. Labelled
+// `AstNodeDescription:base:<kind>` so it nests under the description family: L2
+// `base` aggregates all payloads (alongside the L2 scope-wrapper layers), L3
+// `<kind>` is the per-element-kind split.
+const descriptionPayloadLabel = node => `AstNodeDescription:base:${stringProp(node, 'type') ?? 'unknown'}`;
+
 /** @type {import('./concepts.mjs').ConceptClassifier} */
 export const langiumClassifier = {
    classify(node) {
@@ -115,6 +125,16 @@ export const langiumClassifier = {
             }
             return `CST:${cstRole}`;
          }
+         // Index manager is an attribution anchor but keeps its real name; Map/MultiMap
+         // stay their own names too (referrer edges show which are the scope index).
+         if (name.endsWith('IndexManager') || name === 'MultiMap' || name === 'Map') {
+            return name;
+         }
+         // A description built as a class instance carries the base payload's
+         // own fields; label it like the literal payload, whatever its class name.
+         if (isDescriptionPayload(propertySet(node))) {
+            return descriptionPayloadLabel(node);
+         }
          // Any class whose name ends in AstNodeDescription is a description wrapper;
          // the prefix is the scope layer (Local, Global, ...). Labelled
          // `AstNodeDescription:<layer>` so it nests under the description family at
@@ -123,11 +143,6 @@ export const langiumClassifier = {
             const layer = name.slice(0, -'AstNodeDescription'.length) || 'base';
             return `AstNodeDescription:${layer}`;
          }
-         // Index manager is an attribution anchor but keeps its real name; Map/MultiMap
-         // stay their own names too (referrer edges show which are the scope index).
-         if (name.endsWith('IndexManager') || name === 'MultiMap' || name === 'Map') {
-            return name;
-         }
          return undefined; // defer (engine → class:<name>, or a later classifier)
       }
 
@@ -161,12 +176,8 @@ export const langiumClassifier = {
       if (has(props, 'value', 'lexerErrors', 'parserErrors')) {
          return 'ParseResult';
       }
-      if (has(props, 'name', 'nameSegment', 'documentUri', 'node', 'selectionSegment')) {
-         // The base description payload carries `type` = the described node's element
-         // kind. Labelled `AstNodeDescription:base:<kind>` so it nests under the
-         // description family: L2 `base` aggregates all payloads (alongside the L2
-         // scope-wrapper layers above), L3 `<kind>` is the per-element-kind split.
-         return `AstNodeDescription:base:${stringProp(node, 'type') ?? 'unknown'}`;
+      if (isDescriptionPayload(props)) {
+         return descriptionPayloadLabel(node);
       }
       if (has(props, '$refText', 'ref')) {
          return 'Reference';

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/cli.js

@@ -8,14 +8,19 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 import { Command } from 'commander';
+import { describeError } from '@hydranium/protocol';
 import { readCliVersion } from './cli-version.js';
 import { runAnalyzeHeapCommand } from './commands/analyze-heap-args.js';
 import { runAstGroundTruthCommand } from './commands/ast-ground-truth-args.js';
+import { runCreateCommand } from './commands/create-args.js';
+import { runCheckSkillsCommand } from './commands/check-skills-args.js';
+import { runDeleteCommand } from './commands/delete-args.js';
 import { runGenerateTransferModelCommand } from './commands/generate-transfer-model-args.js';
 import { runInitCommand } from './commands/init-args.js';
 import { InitWizardCancelled } from './commands/init-prompt.js';
 import { runLintGrammarCommand } from './commands/lint-grammar-args.js';
 import { runMeasureMemoryCommand } from './commands/measure-memory-args.js';
+import { runMessageCatalogueCommand } from './commands/message-catalogue-args.js';
 import { runModelDocsCommand } from './commands/model-docs-args.js';
 import { runProjectsCommand } from './commands/projects-args.js';
 import { runQueryCommand } from './commands/query-args.js';
@@ -42,6 +47,9 @@ const COMMANDS = {
         summary: "Tally a workspace's live-model $types (analyze-heap --validate input).",
         run: runAstGroundTruthCommand
     },
+    create: { summary: 'Create a new document and its file via a data-server subprocess.', run: runCreateCommand },
+    'check-skills': { summary: 'Check installed agent skills against project dependency versions.', run: runCheckSkillsCommand },
+    delete: { summary: 'Delete a document, its file included, via a data-server subprocess.', run: runDeleteCommand },
     'generate-transfer-model': {
         summary: 'Generate a transfer-model TypeScript file from a Langium AST.',
         run: runGenerateTransferModelCommand
@@ -49,11 +57,12 @@ const COMMANDS = {
     init: { summary: 'Scaffold a new Hydranium language project (grammar + server head).', run: runInitCommand },
     'lint-grammar': { summary: 'Check a grammar against framework conventions (CI gate).', run: runLintGrammarCommand },
     'measure-memory': { summary: 'Measure model-store memory for a workspace (needs @hydranium/core).', run: runMeasureMemoryCommand },
+    'message-catalogue': { summary: 'Emit a starter translation catalogue from message barrels.', run: runMessageCatalogueCommand },
     'model-docs': { summary: 'Generate a navigable Markdown model reference for adopter docs.', run: runModelDocsCommand },
     projects: { summary: 'List projects exposed by a data-server subprocess.', run: runProjectsCommand },
     query: { summary: 'Print the data-server document envelope for a URI.', run: runQueryCommand },
     reflect: { summary: "Dump a head's grammar/AST reflection (types, terminals, refs).", run: runReflectCommand },
-    save: { summary: 'Update + persist a document via a data-server subprocess.', run: runSaveCommand },
+    save: { summary: 'Update + persist an existing document via a data-server subprocess.', run: runSaveCommand },
     validate: { summary: 'Validate a workspace headlessly; non-zero exit on errors (CI gate).', run: runValidateCommand },
     watch: { summary: 'Subscribe to data-server document updates; print events as NDJSON.', run: runWatchCommand }
 };
@@ -129,7 +138,7 @@ main(process.argv.slice(2)).catch(err => {
     if (err instanceof InitWizardCancelled) {
         process.exit(130);
     }
-    console.error(err instanceof Error ? err.message : String(err));
+    console.error(describeError(err));
     process.exit(1);
 });
 //# sourceMappingURL=cli.js.map

package/lib/cli.js.map

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

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

@@ -1 +1 @@
-{"version":3,"file":"analyze-heap-args.d.ts","sourceRoot":"","sources":["../../src/commands/analyze-heap-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAoB7F;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA6D,CAAC;AAE9G,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAAgB,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EA8D9C,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,eAAe,CAqCzG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/F"}
+{"version":3,"file":"analyze-heap-args.d.ts","sourceRoot":"","sources":["../../src/commands/analyze-heap-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpF,OAAO,EAA2C,KAAK,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAoB7F;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAA6D,CAAC;AAE9G,0FAA0F;AAC1F,eAAO,MAAM,wBAAwB,EAAE,SAAS,MAAM,EAAgB,CAAC;AAEvE;;;;;;GAMG;AACH,eAAO,MAAM,iBAAiB,EAAE,SAAS,MAAM,EA6D9C,CAAC;AAEF,gEAAgE;AAChE,MAAM,WAAW,eAAe;IAC7B,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,yEAAyE;IACzE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,eAAe,CAqCzG;AAED,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,GAAE,eAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe/F"}

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

@@ -48,8 +48,7 @@ export const ANALYZE_HEAP_HELP = [
     'AST node -> $type, GModel -> kind -> subtype), the duplicate-string / cut-point /',
     'per-document drill-downs, and sample retainer paths. Loading is the only real',
     'cost, so the drill-downs run by default; tune or disable them with the flags',
-    'below. The Markdown reads fine as text, saves as a .md file (--out-file), and',
-    'is ideal input for the memory-analysis skill.',
+    'below. The Markdown reads fine as text and saves as a .md file (--out-file).',
     '',
     'Reading a snapshot needs the optional @memlab/core + @memlab/heap-analysis peer',
     'dependencies (`npm install @memlab/core @memlab/heap-analysis`); --diff and',

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"}