@hydranium/cli 1.0.0-next.10

package/lib/commands/watch.js

@@ -0,0 +1,112 @@
+/********************************************************************************
+ * 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 { logLevelEnv } from '../log-level.js';
+import { spawnDataServer } from '../spawn-data-server.js';
+/**
+ * Wait for the handle's premature-death rejection, and swallow it once the watch
+ * is being torn down.
+ *
+ * `watch` ends on SIGINT, which a shell delivers to the whole process group, so
+ * the child dies of the same keystroke. Its `unwatchModelDocument` round trip can
+ * then never be answered, leaving the loop pending and the child's exit the only
+ * settled outcome — so unfiltered, every clean Ctrl-C is reported as
+ * `exited before the request completed (… signal=SIGINT)`. Resolving instead
+ * also settles the race the loop can no longer settle.
+ *
+ * The check waits a turn of the event loop rather than reading `aborted` in the
+ * rejection's own turn: the child's death and this process's own SIGINT are
+ * delivered together and their order is the kernel's to choose. A genuine
+ * mid-watch crash pays that one turn before it is reported.
+ */
+async function resolveOnceShuttingDown(whenTerminated, signal) {
+    if (!whenTerminated) {
+        return new Promise(() => undefined);
+    }
+    try {
+        await whenTerminated;
+    }
+    catch (err) {
+        await new Promise(resolve => setTimeout(resolve, 0));
+        if (signal?.aborted) {
+            return;
+        }
+        throw err;
+    }
+}
+/**
+ * Wire SIGINT to abort the given controller. Returns a function that
+ * un-wires the listener — call it once the subcommand exits so future
+ * SIGINTs don't trigger an already-aborted controller.
+ */
+export function wireSigintAbort(controller) {
+    const handler = () => controller.abort();
+    process.once('SIGINT', handler);
+    return () => process.removeListener('SIGINT', handler);
+}
+export async function runWatch(options) {
+    const write = options.write ?? ((line) => process.stdout.write(line));
+    const clientId = options.clientId ?? 'hydranium-cli';
+    // Local client: filters by URI (so multiple watchers on the same wire
+    // don't cross-pollinate) and writes each event as one JSON line.
+    // `onProjectsChanged` and `onDocumentSaved` are no-ops here — `watch`
+    // streams build-phase update events. Project lifecycle and persistence
+    // events are out of band for the CLI's per-URI update view.
+    const localClient = {
+        onDocumentUpdated(event) {
+            if (event.document.uri !== options.uri) {
+                return;
+            }
+            write(`${JSON.stringify(event)}\n`);
+        },
+        onDocumentSaved() {
+            // Persistence is out of band for the per-URI update view.
+        },
+        onProjectsChanged() {
+            // Project lifecycle is out of band for the per-URI update view.
+        }
+    };
+    // One body for both paths: a test handle that returned before the race would
+    // leave the premature-death branch it stands in for uncoverable.
+    const handle = options.__handleForTest ??
+        spawnDataServer({
+            command: options.serverCommand,
+            args: options.serverArgs,
+            cwd: options.cwd,
+            env: options.logLevel ? logLevelEnv(options.logLevel) : undefined
+        }, localClient);
+    options.__handleForTest?.bindClient(localClient);
+    try {
+        // Race the subscription loop against the child's premature death so a mid-watch
+        // server crash exits with a clear message instead of hanging until Ctrl-C. Guard
+        // the loop's late rejection (an unwatch write to a dead stream) so it does not
+        // surface as an unhandled rejection when the death wins the race.
+        const loop = runWatchOnce(handle.server, options.uri, clientId, options.signal);
+        void loop.catch(() => undefined);
+        await Promise.race([loop, resolveOnceShuttingDown(handle.whenTerminated, options.signal)]);
+    }
+    finally {
+        await handle.shutdown();
+    }
+}
+async function runWatchOnce(server, uri, clientId, signal) {
+    await server.watchModelDocument({ uri, clientId });
+    try {
+        await new Promise(resolve => {
+            if (signal?.aborted) {
+                resolve();
+                return;
+            }
+            signal?.addEventListener('abort', () => resolve(), { once: true });
+        });
+    }
+    finally {
+        await server.unwatchModelDocument({ uri, clientId });
+    }
+}
+//# sourceMappingURL=watch.js.map

package/lib/commands/watch.js.map

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

package/lib/index.d.ts

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './commands/generate-transfer-model.js';
+export * from './commands/projects.js';
+export * from './commands/query.js';
+export * from './commands/save.js';
+export * from './commands/watch.js';
+export * from './package-name.js';
+export * from './spawn-data-server.js';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/lib/index.js

@@ -0,0 +1,16 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+export * from './commands/generate-transfer-model.js';
+export * from './commands/projects.js';
+export * from './commands/query.js';
+export * from './commands/save.js';
+export * from './commands/watch.js';
+export * from './package-name.js';
+export * from './spawn-data-server.js';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,uCAAuC,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC"}

package/lib/log-level.d.ts

@@ -0,0 +1,39 @@
+/********************************************************************************
+ * 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 LogThreshold } from '@hydranium/protocol';
+/**
+ * Validate a raw `--log-level` argument into a {@link LogThreshold}. Throws on
+ * an unrecognised value so the CLI's top-level `catch` surfaces a clean error
+ * and exits non-zero (mirroring how the other option parsers fail fast). Use
+ * for the argv-supplied value; the resolved threshold is handed to
+ * {@link logLevelEnv} to target the spawned server.
+ */
+export declare function parseLogLevelOption(raw: string): LogThreshold;
+/**
+ * Build the environment override that targets *only the spawned server's* log
+ * threshold. Passed to `spawnDataServer` as `env`, it sets the same
+ * `HYDRANIUM_LOG_LEVEL` variable the server reads at startup — the CLI's own
+ * logging is unaffected, unlike an ambient `HYDRANIUM_LOG_LEVEL=…` that the
+ * child would inherit alongside the parent. The server owns *how* log level
+ * works; this only routes the CLI's request onto the channel it already reads.
+ *
+ * **The variable is read by `LspLogger`'s constructor**, which is bound on the
+ * `Logger` slot by `createLspServerSharedModule`. A server that overrides that
+ * slot with a logger of its own therefore decides for itself whether this flag
+ * means anything — which is the intended seam, not a gap. A server composing no
+ * head module at all binds `@hydranium/core`'s `NoopLogger` and stays silent
+ * regardless, so the flag is inert against it.
+ *
+ * Output lands on the spawned server's **stderr**, which
+ * `spawnDataServer` inherits to the user by default. It deliberately does
+ * not go to stdout: that is the JSON-RPC channel, so a log line there would
+ * corrupt the very request this flag was set to diagnose.
+ */
+export declare function logLevelEnv(level: LogThreshold): Record<string, string>;
+//# sourceMappingURL=log-level.d.ts.map

package/lib/log-level.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.d.ts","sourceRoot":"","sources":["../src/log-level.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAqD,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAE3G;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,CAM7D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAEvE"}

package/lib/log-level.js

@@ -0,0 +1,47 @@
+/********************************************************************************
+ * 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 { DEFAULT_LOG_LEVEL_ENV, LEVEL_ORDER, parseLogLevel } from '@hydranium/protocol';
+/**
+ * Validate a raw `--log-level` argument into a {@link LogThreshold}. Throws on
+ * an unrecognised value so the CLI's top-level `catch` surfaces a clean error
+ * and exits non-zero (mirroring how the other option parsers fail fast). Use
+ * for the argv-supplied value; the resolved threshold is handed to
+ * {@link logLevelEnv} to target the spawned server.
+ */
+export function parseLogLevelOption(raw) {
+    const level = parseLogLevel(raw);
+    if (!level) {
+        throw new Error(`Invalid --log-level: ${raw} (expected one of: ${Object.keys(LEVEL_ORDER).join(', ')})`);
+    }
+    return level;
+}
+/**
+ * Build the environment override that targets *only the spawned server's* log
+ * threshold. Passed to `spawnDataServer` as `env`, it sets the same
+ * `HYDRANIUM_LOG_LEVEL` variable the server reads at startup — the CLI's own
+ * logging is unaffected, unlike an ambient `HYDRANIUM_LOG_LEVEL=…` that the
+ * child would inherit alongside the parent. The server owns *how* log level
+ * works; this only routes the CLI's request onto the channel it already reads.
+ *
+ * **The variable is read by `LspLogger`'s constructor**, which is bound on the
+ * `Logger` slot by `createLspServerSharedModule`. A server that overrides that
+ * slot with a logger of its own therefore decides for itself whether this flag
+ * means anything — which is the intended seam, not a gap. A server composing no
+ * head module at all binds `@hydranium/core`'s `NoopLogger` and stays silent
+ * regardless, so the flag is inert against it.
+ *
+ * Output lands on the spawned server's **stderr**, which
+ * `spawnDataServer` inherits to the user by default. It deliberately does
+ * not go to stdout: that is the JSON-RPC channel, so a log line there would
+ * corrupt the very request this flag was set to diagnose.
+ */
+export function logLevelEnv(level) {
+    return { [DEFAULT_LOG_LEVEL_ENV]: level };
+}
+//# sourceMappingURL=log-level.js.map

package/lib/log-level.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log-level.js","sourceRoot":"","sources":["../src/log-level.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,qBAAqB,EAAE,WAAW,EAAE,aAAa,EAAqB,MAAM,qBAAqB,CAAC;AAE3G;;;;;;GAMG;AACH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC5C,MAAM,KAAK,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,KAAK,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,wBAAwB,GAAG,sBAAsB,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC5G,CAAC;IACD,OAAO,KAAK,CAAC;AAChB,CAAC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,WAAW,CAAC,KAAmB;IAC5C,OAAO,EAAE,CAAC,qBAAqB,CAAC,EAAE,KAAK,EAAE,CAAC;AAC7C,CAAC"}

package/lib/package-name.d.ts

@@ -0,0 +1,33 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/**
+ * Validates against the npm package-name grammar (scoped or unscoped,
+ * lowercase, etc.).
+ *
+ * Published on this barrel with no caller inside the framework: it is
+ * scaffolding vocabulary for a generator that composes package names of its
+ * own, which is a job an adopter does in its own repository. It lives on the
+ * CLI rather than on the wire-contract package because a package name has no
+ * wire meaning and a client bundle should not carry the pattern.
+ */
+export declare const NPM_PACKAGE_NAME_REGEX: RegExp;
+/**
+ * Convert an npm package name to a Pascal-case identifier. The optional scope
+ * prefix is dropped; remaining segments separated by `-`, `.`, or `~` are
+ * Pascal-cased and concatenated.
+ *
+ * `'@my-org/foo-bar'` → `'FooBar'`
+ *
+ * The inverse direction of the `kebab` derivation the scaffolder itself runs:
+ * that one starts from a PascalCase project name and produces the package id,
+ * this one recovers an identifier from a package name that already exists.
+ * Same outside-reader constraint as {@link NPM_PACKAGE_NAME_REGEX}.
+ */
+export declare function packageNameToId(input: string): string;
+//# sourceMappingURL=package-name.d.ts.map

package/lib/package-name.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-name.d.ts","sourceRoot":"","sources":["../src/package-name.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF;;;;;;;;;GASG;AACH,eAAO,MAAM,sBAAsB,QAAoF,CAAC;AAExH;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAGrD"}

package/lib/package-name.js

@@ -0,0 +1,37 @@
+/********************************************************************************
+ * 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 { toPascal } from '@hydranium/protocol';
+/**
+ * Validates against the npm package-name grammar (scoped or unscoped,
+ * lowercase, etc.).
+ *
+ * Published on this barrel with no caller inside the framework: it is
+ * scaffolding vocabulary for a generator that composes package names of its
+ * own, which is a job an adopter does in its own repository. It lives on the
+ * CLI rather than on the wire-contract package because a package name has no
+ * wire meaning and a client bundle should not carry the pattern.
+ */
+export const NPM_PACKAGE_NAME_REGEX = /^(?:(?:@(?:[a-z0-9-*~][a-z0-9-*._~]*)?\/[a-z0-9-._~])|[a-z0-9-~])[a-z0-9-._~]*$/;
+/**
+ * Convert an npm package name to a Pascal-case identifier. The optional scope
+ * prefix is dropped; remaining segments separated by `-`, `.`, or `~` are
+ * Pascal-cased and concatenated.
+ *
+ * `'@my-org/foo-bar'` → `'FooBar'`
+ *
+ * The inverse direction of the `kebab` derivation the scaffolder itself runs:
+ * that one starts from a PascalCase project name and produces the package id,
+ * this one recovers an identifier from a package name that already exists.
+ * Same outside-reader constraint as {@link NPM_PACKAGE_NAME_REGEX}.
+ */
+export function packageNameToId(input) {
+    const unscoped = input.split('/').at(-1);
+    return unscoped.split(/[~.-]/).map(toPascal).join('');
+}
+//# sourceMappingURL=package-name.js.map

package/lib/package-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-name.js","sourceRoot":"","sources":["../src/package-name.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,iFAAiF,CAAC;AAExH;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,KAAa;IAC1C,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IAC1C,OAAO,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AACzD,CAAC"}

package/lib/spawn-data-server.d.ts

@@ -0,0 +1,102 @@
+/********************************************************************************
+ * 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 TransferDiagnostic, type TransferElement } from '@hydranium/protocol';
+import { type DataClientProtocol, type DataServerProtocol } from '@hydranium/protocol/data';
+import { type ChildProcess } from 'node:child_process';
+import { type MessageConnection } from 'vscode-jsonrpc/node';
+/**
+ * Options for {@link spawnDataServer}. `command` is the binary or script
+ * path; `args` are the command-line arguments passed to it. The adopter's
+ * server is expected to bootstrap a `DataServer` against the supplied
+ * MessageConnection and call `connection.listen()` so its stdin/stdout
+ * carry the JSON-RPC stream.
+ *
+ * `shutdown()` disposes the JSON-RPC connection and waits for the child
+ * to exit with a configurable timeout. Subcommands that take a SIGINT
+ * (e.g. `watch`) call shutdown on the cleanup path so the child doesn't
+ * stay orphaned.
+ */
+export interface SpawnDataServerOptions {
+    readonly command: string;
+    readonly args?: readonly string[];
+    /**
+     * Working directory for the spawned child. Default: current cwd.
+     * Useful when the child resolves model files relative to a workspace
+     * root that differs from where the CLI was invoked.
+     */
+    readonly cwd?: string;
+    /**
+     * Additional environment variables for the child. Merged on top of
+     * `process.env`. Default: no overrides.
+     */
+    readonly env?: Readonly<Record<string, string | undefined>>;
+    /**
+     * Where to pipe the child's stderr. Default: inherited from the
+     * parent (visible to the user). Set to `'ignore'` for quiet
+     * scripted use; set to `'pipe'` to capture for assertion in tests.
+     */
+    readonly stderr?: 'inherit' | 'ignore' | 'pipe';
+}
+/**
+ * Lifecycle handle for a spawned data-server. Owns the child process,
+ * the JSON-RPC connection, and the typed protocol proxy. Always pair
+ * {@link spawnDataServer} with {@link DataServerHandle.shutdown} (in a
+ * `try`/`finally` or equivalent) so the child doesn't outlive the CLI
+ * invocation.
+ */
+export interface DataServerHandle<TTransfer extends TransferElement, TDiagnostic extends TransferDiagnostic = TransferDiagnostic> {
+    /** Typed server proxy — the consumer-facing surface for protocol calls. */
+    readonly server: DataServerProtocol<TTransfer, TDiagnostic>;
+    /** Raw child process — for stderr piping in tests; do not write to stdin/stdout directly. */
+    readonly child: ChildProcess;
+    /** vscode-jsonrpc connection — for callers wanting fine-grained lifecycle control. */
+    readonly connection: MessageConnection;
+    /**
+     * Rejects when the child fails to start (e.g. `ENOENT` for a missing
+     * command) or exits before {@link DataServerHandle.shutdown} is
+     * requested — i.e. a premature death that would otherwise leave an
+     * in-flight RPC hanging forever. Never resolves. Race a protocol call
+     * against it (see {@link withDataServer}) to fail fast with a clear
+     * message instead of hanging or crashing on an unhandled `'error'`
+     * event. Always internally handled, so ignoring it never triggers an
+     * unhandled-rejection crash.
+     */
+    readonly whenTerminated: Promise<never>;
+    /**
+     * Tear down the connection + wait for the child to exit. Resolves
+     * once the child has terminated (gracefully or via SIGTERM). Safe
+     * to call multiple times.
+     */
+    shutdown(timeoutMs?: number): Promise<void>;
+}
+/**
+ * Spawn a data-server subprocess and wire a typed proxy over its
+ * stdio JSON-RPC. The function returns once the connection is
+ * listening; protocol calls are queued behind the underlying
+ * MessageConnection's ordering guarantees.
+ *
+ * Supplying `localClient` registers its `DataClientProtocol` methods as
+ * inbound-notification handlers on the connection — the data-server's
+ * `data-server/onDocumentUpdated` notifications dispatch to
+ * `localClient.onDocumentUpdated`. Subcommands like `watch` use this to
+ * stream events; subcommands like `projects` / `query` / `save` pass
+ * no localClient.
+ */
+export declare function spawnDataServer<TTransfer extends TransferElement, TDiagnostic extends TransferDiagnostic = TransferDiagnostic>(options: SpawnDataServerOptions, localClient?: DataClientProtocol<TTransfer, TDiagnostic>): DataServerHandle<TTransfer, TDiagnostic>;
+/**
+ * Spawn a data-server, run `use` against its typed proxy, and always shut the
+ * child down afterwards. The `use` call is raced against
+ * {@link DataServerHandle.whenTerminated}, so a spawn failure or a premature child
+ * exit rejects with a clear message instead of hanging on an RPC that can never be
+ * answered. This is the one-shot counterpart the `projects` / `query` / `save`
+ * subcommands compose; `watch` races its own long-running loop against
+ * `whenTerminated` directly.
+ */
+export declare function withDataServer<TTransfer extends TransferElement, TDiagnostic extends TransferDiagnostic, R>(options: SpawnDataServerOptions, use: (server: DataServerProtocol<TTransfer, TDiagnostic>, handle: DataServerHandle<TTransfer, TDiagnostic>) => Promise<R>, localClient?: DataClientProtocol<TTransfer, TDiagnostic>): Promise<R>;
+//# sourceMappingURL=spawn-data-server.d.ts.map

package/lib/spawn-data-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spawn-data-server.d.ts","sourceRoot":"","sources":["../src/spawn-data-server.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAkB,KAAK,kBAAkB,EAAE,KAAK,eAAe,EAAE,MAAM,qBAAqB,CAAC;AACpG,OAAO,EAGJ,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACzB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,oBAAoB,CAAC;AAC9D,OAAO,EAAqE,KAAK,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAEhI;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,sBAAsB;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC;;;;OAIG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC;IAC5D;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;CAClD;AAED;;;;;;GAMG;AACH,MAAM,WAAW,gBAAgB,CAAC,SAAS,SAAS,eAAe,EAAE,WAAW,SAAS,kBAAkB,GAAG,kBAAkB;IAC7H,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC;IAC5D,6FAA6F;IAC7F,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,sFAAsF;IACtF,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;IACvC;;;;;;;;;OASG;IACH,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IACxC;;;;OAIG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,SAAS,SAAS,eAAe,EAAE,WAAW,SAAS,kBAAkB,GAAG,kBAAkB,EAC3H,OAAO,EAAE,sBAAsB,EAC/B,WAAW,CAAC,EAAE,kBAAkB,CAAC,SAAS,EAAE,WAAW,CAAC,GACxD,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,CAqH1C;AAED;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAAC,SAAS,SAAS,eAAe,EAAE,WAAW,SAAS,kBAAkB,EAAE,CAAC,EAC9G,OAAO,EAAE,sBAAsB,EAC/B,GAAG,EAAE,CAAC,MAAM,EAAE,kBAAkB,CAAC,SAAS,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,gBAAgB,CAAC,SAAS,EAAE,WAAW,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EACzH,WAAW,CAAC,EAAE,kBAAkB,CAAC,SAAS,EAAE,WAAW,CAAC,GACxD,OAAO,CAAC,CAAC,CAAC,CAYZ"}

package/lib/spawn-data-server.js

@@ -0,0 +1,154 @@
+/********************************************************************************
+ * 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 { createRpcProxy } from '@hydranium/protocol';
+import { DATA_CLIENT_PROTOCOL_METHODS, DATA_SERVER_WIRE_PREFIX } from '@hydranium/protocol/data';
+import { spawn } from 'node:child_process';
+import { StreamMessageReader, StreamMessageWriter, createMessageConnection } from 'vscode-jsonrpc/node';
+/**
+ * Spawn a data-server subprocess and wire a typed proxy over its
+ * stdio JSON-RPC. The function returns once the connection is
+ * listening; protocol calls are queued behind the underlying
+ * MessageConnection's ordering guarantees.
+ *
+ * Supplying `localClient` registers its `DataClientProtocol` methods as
+ * inbound-notification handlers on the connection — the data-server's
+ * `data-server/onDocumentUpdated` notifications dispatch to
+ * `localClient.onDocumentUpdated`. Subcommands like `watch` use this to
+ * stream events; subcommands like `projects` / `query` / `save` pass
+ * no localClient.
+ */
+export function spawnDataServer(options, localClient) {
+    const child = spawn(options.command, [...(options.args ?? [])], {
+        cwd: options.cwd,
+        env: options.env ? { ...process.env, ...options.env } : process.env,
+        stdio: ['pipe', 'pipe', options.stderr ?? 'inherit']
+    });
+    if (!child.stdin || !child.stdout) {
+        // Mirrors the synchronous failure-to-create-pipes case Node surfaces
+        // when stdio isn't 'pipe' on either end. We always request 'pipe'
+        // for stdin/stdout, so this is defensive only.
+        //
+        // Worded for whoever passed the command, not for whoever wrote this
+        // function: the reachable way to arrive here is a `--server` value that
+        // does not start, and naming the internal spawner told that reader
+        // nothing they could act on.
+        child.kill();
+        throw new Error(`Could not start the data server: the command '${options.command}' provided no stdin/stdout pipe. ` +
+            'Check that --server names a runnable command, and that its own entry path resolves from --cwd.');
+    }
+    // Guard stdin against writes that flush after the child has died (spawn failure
+    // or a premature exit). vscode-jsonrpc queues a message write on `setImmediate`;
+    // if the child's stdin is destroyed by the time it flushes, Node's `write` errors
+    // and vscode-jsonrpc orphans that write-queue rejection (it surfaces transport
+    // errors only via `onError`, which we consume separately) — an unhandled
+    // rejection. Reporting the destroyed write as a silent success drops the doomed
+    // message; the child's death is already reported cleanly via `whenTerminated`.
+    const stdin = child.stdin;
+    const originalWrite = stdin.write.bind(stdin);
+    stdin.write = ((...writeArgs) => {
+        if (!stdin.destroyed) {
+            return originalWrite(...writeArgs);
+        }
+        const callback = writeArgs.find((arg) => typeof arg === 'function');
+        callback?.(null);
+        return true;
+    });
+    const reader = new StreamMessageReader(child.stdout);
+    const writer = new StreamMessageWriter(child.stdin);
+    const connection = createMessageConnection(reader, writer);
+    // Consume transport error / close so a child that dies mid-stream (its stdout
+    // closing, a write landing on a torn-down stdin) is observed here rather than
+    // escaping as an unhandled error — the death is reported via `whenTerminated`.
+    connection.onError(() => undefined);
+    connection.onClose(() => undefined);
+    connection.listen();
+    // One typed proxy over the data-server protocol; when a `localClient` is
+    // supplied its `on*` notification handlers are bound inbound on the same
+    // connection (skipped when absent — subcommands like `projects`/`query`).
+    const server = createRpcProxy(connection, {
+        methodNamespace: DATA_SERVER_WIRE_PREFIX,
+        localTarget: localClient,
+        localMethods: DATA_CLIENT_PROTOCOL_METHODS
+    });
+    // A premature child death (spawn `ENOENT`, a crash, or an exit before we asked
+    // for one) rejects `whenTerminated` so a racing RPC fails fast instead of
+    // hanging on a request that can never be answered. `terminating` gates it so an
+    // expected `shutdown()` exit does NOT reject. The `void .catch` guarantees the
+    // promise is always handled — an ignored failure can never crash the process
+    // with an unhandled 'error' event / rejection.
+    let terminating = false;
+    const whenTerminated = new Promise((_, reject) => {
+        child.once('error', error => {
+            if (!terminating) {
+                reject(new Error(`data-server process failed to start (command='${options.command}'): ${error.message}`));
+            }
+        });
+        child.once('exit', (code, signal) => {
+            if (!terminating) {
+                reject(new Error(`data-server process exited before the request completed ` +
+                    `(command='${options.command}', code=${code ?? 'null'}, signal=${signal ?? 'null'}).`));
+            }
+        });
+    });
+    void whenTerminated.catch(() => undefined);
+    let shutdownPromise;
+    const shutdown = (timeoutMs = 5_000) => {
+        if (shutdownPromise) {
+            return shutdownPromise;
+        }
+        terminating = true;
+        shutdownPromise = new Promise(resolve => {
+            const finalize = () => {
+                connection.dispose();
+                resolve();
+            };
+            if (child.exitCode !== null || child.signalCode !== null) {
+                finalize();
+                return;
+            }
+            const onExit = () => {
+                clearTimeout(killTimer);
+                finalize();
+            };
+            child.once('exit', onExit);
+            // Polite exit first — most servers handle SIGTERM by closing
+            // their JSON-RPC connection and returning from `connection.listen()`.
+            child.kill('SIGTERM');
+            const killTimer = setTimeout(() => {
+                child.kill('SIGKILL');
+            }, timeoutMs);
+        });
+        return shutdownPromise;
+    };
+    return { server, child, connection, whenTerminated, shutdown };
+}
+/**
+ * Spawn a data-server, run `use` against its typed proxy, and always shut the
+ * child down afterwards. The `use` call is raced against
+ * {@link DataServerHandle.whenTerminated}, so a spawn failure or a premature child
+ * exit rejects with a clear message instead of hanging on an RPC that can never be
+ * answered. This is the one-shot counterpart the `projects` / `query` / `save`
+ * subcommands compose; `watch` races its own long-running loop against
+ * `whenTerminated` directly.
+ */
+export async function withDataServer(options, use, localClient) {
+    const handle = spawnDataServer(options, localClient);
+    const usePromise = use(handle.server, handle);
+    // Defensively handle `usePromise` so that if `whenTerminated` wins the race
+    // (the child died), the losing in-flight RPC's later rejection — e.g. a write to
+    // the now-destroyed stdin — does not surface as an unhandled rejection.
+    void usePromise.catch(() => undefined);
+    try {
+        return await Promise.race([usePromise, handle.whenTerminated]);
+    }
+    finally {
+        await handle.shutdown();
+    }
+}
+//# sourceMappingURL=spawn-data-server.js.map

package/lib/spawn-data-server.js.map

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

package/lib/testing/echo-server.d.ts

@@ -0,0 +1,11 @@
+#!/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
+ ********************************************************************************/
+export {};
+//# sourceMappingURL=echo-server.d.ts.map

package/lib/testing/echo-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"echo-server.d.ts","sourceRoot":"","sources":["../../src/testing/echo-server.ts"],"names":[],"mappings":";AACA;;;;;;;kFAOkF"}