@hydranium/cli 1.0.0-next.272 → 1.0.0-next.273

package/README.md

@@ -15,8 +15,8 @@ and the other commands drive your built head from a shell or a CI step.
   own docs.
 - Generate the serializable transfer model from Langium's generated AST.
 - Measure model-store memory and analyze a V8 heap snapshot.
-- List, read, save and watch documents through a spawned data server, printing
-  JSON a script can pipe.
+- List, read, save and watch documents through a spawned data server,
+  printing JSON a script can pipe, and delete them.
 
 ## Install
 
@@ -60,8 +60,8 @@ lists each command's flags.
   once or on watch.
 - **Memory.** Measure a workspace's model-store memory, and analyze a heap
   snapshot.
-- **Data server.** Spawn your data head and list projects, or query, save or
-  watch a document.
+- **Data server.** Spawn your data head and list projects, or query, save,
+  delete or watch a document.
 
 The commands that boot your head take `--services <module>`. That is an ESM
 module exporting a zero-arg `createServices()` that returns `{ shared }`,
@@ -78,8 +78,10 @@ as the entry's argument rather than through `--cwd`:
 hydranium-cli projects --server "node ./lib/data-server-main.js ./models"
 ```
 
-`save` spawns a data server of its own, and a workspace has one writer. Saving
-into a workspace an editor has open makes two writers, and one write is lost.
+`save` and `delete` spawn a data server of their own, and a workspace has one
+writer. Saving or deleting 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.
 
 Commands that spawn a child give it a heap ceiling; set
 `HYDRANIUM_CLI_MAX_OLD_SPACE_MB` to state your own in MiB.

package/lib/cli.js

@@ -12,6 +12,7 @@ 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 { 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';
@@ -43,6 +44,7 @@ const COMMANDS = {
         summary: "Tally a workspace's live-model $types (analyze-heap --validate input).",
         run: runAstGroundTruthCommand
     },
+    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

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/delete-args.d.ts

@@ -0,0 +1,17 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 UsageError } from './harness-args.js';
+import { type DeleteCommandOptions } from './delete.js';
+/** Every flag `delete` accepts, each of which takes a value. */
+export declare const DELETE_FLAGS: readonly string[];
+/** The `--help` text, as data, held to {@link DELETE_FLAGS} by a test. */
+export declare const DELETE_HELP: readonly string[];
+export declare function parseDeleteArgs(args: string[], onError?: UsageError): DeleteCommandOptions;
+export declare function runDeleteCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=delete-args.d.ts.map

package/lib/commands/delete-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-args.d.ts","sourceRoot":"","sources":["../../src/commands/delete-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EASJ,KAAK,UAAU,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,oBAAoB,EAAa,MAAM,aAAa,CAAC;AAInE,gEAAgE;AAChE,eAAO,MAAM,YAAY,EAAE,SAAS,MAAM,EAAgD,CAAC;AAE3F,0EAA0E;AAC1E,eAAO,MAAM,WAAW,EAAE,SAAS,MAAM,EAYxC,CAAC;AAEF,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,oBAAoB,CAazG;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAM9D"}

package/lib/commands/delete-args.js

@@ -0,0 +1,49 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { assertRequired, exitWithUsage, helpRequested, logHelpLines, parseFlagOptions, parseServerSpawnOptions, printHelp, SERVER_SPAWN_VALUE_FLAGS } from './harness-args.js';
+import { runDelete } from './delete.js';
+const OWN_FLAGS = ['--uri', '--client-id'];
+/** Every flag `delete` accepts, each of which takes a value. */
+export const DELETE_FLAGS = [...SERVER_SPAWN_VALUE_FLAGS, ...OWN_FLAGS];
+/** The `--help` text, as data, held to {@link DELETE_FLAGS} by a test. */
+export const DELETE_HELP = [
+    'Usage: hydranium-cli delete --server "<cmd>..." --uri <uri> [--client-id <id>] [--cwd <dir>] [--log-level <lvl>] [--log-file <file>] [--log-file-level <lvl>]',
+    '',
+    'Delete the document at `<uri>`, its file and then the document, via deleteModelDocument,',
+    'whatever text it holds. Prints nothing.',
+    '',
+    'Options:',
+    '  --server "<cmd>"      Command-line for the data-server subprocess (required).',
+    '  --uri <uri>           Document URI (required).',
+    '  --client-id <id>      clientId the deletion is attributed to. Default: hydranium-cli.',
+    '  --cwd <dir>           Working directory for the spawned child. Default: cwd.',
+    ...logHelpLines(22, 'the spawned server')
+];
+export function parseDeleteArgs(args, onError = exitWithUsage) {
+    const { serverCommand, serverArgs, cwd, logLevel, logFile, logFileLevel, extra } = parseServerSpawnOptions(args, 'delete', onError);
+    const { uri, clientId } = parseFlagOptions(extra, 'delete', OWN_FLAGS, onError);
+    return {
+        serverCommand,
+        serverArgs,
+        cwd,
+        logLevel,
+        logFile,
+        logFileLevel,
+        uri: assertRequired(uri, '--uri', 'delete', onError),
+        clientId
+    };
+}
+export function runDeleteCommand(args) {
+    if (helpRequested(args, DELETE_FLAGS)) {
+        printHelp(DELETE_HELP);
+        return Promise.resolve();
+    }
+    return runDelete(parseDeleteArgs(args));
+}
+//# sourceMappingURL=delete-args.js.map

package/lib/commands/delete-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete-args.js","sourceRoot":"","sources":["../../src/commands/delete-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,cAAc,EACd,aAAa,EACb,aAAa,EACb,YAAY,EACZ,gBAAgB,EAChB,uBAAuB,EACvB,SAAS,EACT,wBAAwB,EAE1B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA6B,SAAS,EAAE,MAAM,aAAa,CAAC;AAEnE,MAAM,SAAS,GAAG,CAAC,OAAO,EAAE,aAAa,CAAU,CAAC;AAEpD,gEAAgE;AAChE,MAAM,CAAC,MAAM,YAAY,GAAsB,CAAC,GAAG,wBAAwB,EAAE,GAAG,SAAS,CAAC,CAAC;AAE3F,0EAA0E;AAC1E,MAAM,CAAC,MAAM,WAAW,GAAsB;IAC3C,+JAA+J;IAC/J,EAAE;IACF,0FAA0F;IAC1F,yCAAyC;IACzC,EAAE;IACF,UAAU;IACV,iFAAiF;IACjF,kDAAkD;IAClD,yFAAyF;IACzF,gFAAgF;IAChF,GAAG,YAAY,CAAC,EAAE,EAAE,oBAAoB,CAAC;CAC3C,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,IAAc,EAAE,OAAO,GAAe,aAAa;IAChF,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,GAAG,uBAAuB,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC;IACpI,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IAChF,OAAO;QACJ,aAAa;QACb,UAAU;QACV,GAAG;QACH,QAAQ;QACR,OAAO;QACP,YAAY;QACZ,GAAG,EAAE,cAAc,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC;QACpD,QAAQ;KACV,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAc;IAC5C,IAAI,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;QACrC,SAAS,CAAC,WAAW,CAAC,CAAC;QACvB,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,SAAS,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC;AAC3C,CAAC"}

package/lib/commands/delete.d.ts

@@ -0,0 +1,30 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { TransferElement } from '@hydranium/protocol';
+import type { DataServerProtocol } from '@hydranium/protocol/data';
+import { type LogOptions } from '../log-level.js';
+/**
+ * Options for the {@link runDelete} subcommand. Deletes the document at `uri`,
+ * its file and then the document, via the data-server's `deleteModelDocument`
+ * RPC, whatever text it holds. Prints nothing; a failed delete rejects.
+ *
+ * `clientId` defaults to `'hydranium-cli'`. The command deletes as a client
+ * session under it: it registers the session, opens the document, deletes it,
+ * and ends the session.
+ */
+export interface DeleteCommandOptions extends LogOptions {
+    readonly serverCommand: string;
+    readonly serverArgs?: readonly string[];
+    readonly cwd?: string;
+    readonly uri: string;
+    readonly clientId?: string;
+    readonly __proxyForTest?: DataServerProtocol<TransferElement>;
+}
+export declare function runDelete(options: DeleteCommandOptions): Promise<void>;
+//# sourceMappingURL=delete.d.ts.map

package/lib/commands/delete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.d.ts","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAU,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG1D;;;;;;;;GAQG;AACH,MAAM,WAAW,oBAAqB,SAAQ,UAAU;IACrD,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,CAAC,EAAE,kBAAkB,CAAC,eAAe,CAAC,CAAC;CAChE;AAED,wBAAsB,SAAS,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe5E"}

package/lib/commands/delete.js

@@ -0,0 +1,41 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { logEnv } from '../log-level.js';
+import { withDataServer } from '../spawn-data-server.js';
+export async function runDelete(options) {
+    const clientId = options.clientId ?? 'hydranium-cli';
+    if (options.__proxyForTest) {
+        await deleteOpened(options.__proxyForTest, options.uri, clientId);
+        return;
+    }
+    await withDataServer({
+        command: options.serverCommand,
+        args: options.serverArgs,
+        cwd: options.cwd,
+        env: logEnv(options)
+    }, server => deleteOpened(server, options.uri, clientId));
+}
+/**
+ * Delete `uri` as the session `clientId`, and end the session whether the
+ * delete succeeded or not. An end that fails after a failed delete is
+ * swallowed: the delete's error is the one the user needs.
+ */
+async function deleteOpened(server, uri, clientId) {
+    await server.createSession({ clientId, label: 'hydranium-cli' });
+    try {
+        await server.openModelDocument({ uri, clientId });
+        await server.deleteModelDocument({ uri, clientId, baseVersion: 'any' });
+    }
+    catch (error) {
+        await server.closeSession({ clientId }).catch(() => undefined);
+        throw error;
+    }
+    await server.closeSession({ clientId });
+}
+//# sourceMappingURL=delete.js.map

package/lib/commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAIlF,OAAO,EAAE,MAAM,EAAmB,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAoBzD,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAA6B;IAC1D,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,eAAe,CAAC;IACrD,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC1B,MAAM,YAAY,CAAC,OAAO,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QAClE,OAAO;IACV,CAAC;IACD,MAAM,cAAc,CACjB;QACG,OAAO,EAAE,OAAO,CAAC,aAAa;QAC9B,IAAI,EAAE,OAAO,CAAC,UAAU;QACxB,GAAG,EAAE,OAAO,CAAC,GAAG;QAChB,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC;KACtB,EACD,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,EAAE,QAAQ,CAAC,CACvD,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,YAAY,CACxB,MAAiI,EACjI,GAAW,EACX,QAAgB;IAEhB,MAAM,MAAM,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;IACjE,IAAI,CAAC;QACF,MAAM,MAAM,CAAC,iBAAiB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,CAAC,CAAC;QAClD,MAAM,MAAM,CAAC,mBAAmB,CAAC,EAAE,GAAG,EAAE,QAAQ,EAAE,WAAW,EAAE,KAAK,EAAE,CAAC,CAAC;IAC3E,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACvB,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/D,MAAM,KAAK,CAAC;IACf,CAAC;IACD,MAAM,MAAM,CAAC,YAAY,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC;AAC3C,CAAC"}

package/lib/index.d.ts

@@ -6,6 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
+export * from './commands/delete.js';
 export * from './commands/generate-ast-builder.js';
 export * from './commands/generate-transfer-model.js';
 export * from './commands/projects.js';

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,oCAAoC,CAAC;AACnD,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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,oCAAoC,CAAC;AACnD,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

@@ -6,6 +6,7 @@
  *
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
+export * from './commands/delete.js';
 export * from './commands/generate-ast-builder.js';
 export * from './commands/generate-transfer-model.js';
 export * from './commands/projects.js';

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,oCAAoC,CAAC;AACnD,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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,cAAc,sBAAsB,CAAC;AACrC,cAAc,oCAAoC,CAAC;AACnD,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hydranium/cli",
-  "version": "1.0.0-next.272",
+  "version": "1.0.0-next.273",
   "description": "Build-time codegen tools + data-server subcommands for the hydranium framework.",
   "keywords": [
     "cli",
@@ -71,11 +71,11 @@
   "devDependencies": {
     "@eclipse-glsp/graph": "2.7.0",
     "@eclipse-glsp/server": "2.7.0",
-    "@hydranium/core": "1.0.0-next.272",
-    "@hydranium/data-server": "1.0.0-next.272",
-    "@hydranium/glsp-server": "1.0.0-next.272",
-    "@hydranium/langium": "1.0.0-next.272",
-    "@hydranium/protocol": "1.0.0-next.272",
+    "@hydranium/core": "1.0.0-next.273",
+    "@hydranium/data-server": "1.0.0-next.273",
+    "@hydranium/glsp-server": "1.0.0-next.273",
+    "@hydranium/langium": "1.0.0-next.273",
+    "@hydranium/protocol": "1.0.0-next.273",
     "@types/node": "^22.0.0",
     "inversify": "6.2.2",
     "langium": "4.3.1",
@@ -89,10 +89,10 @@
     "vscode-languageserver-protocol": "3.18.1"
   },
   "peerDependencies": {
-    "@hydranium/core": "1.0.0-next.272",
-    "@hydranium/data-server": "1.0.0-next.272",
-    "@hydranium/langium": "1.0.0-next.272",
-    "@hydranium/protocol": "1.0.0-next.272",
+    "@hydranium/core": "1.0.0-next.273",
+    "@hydranium/data-server": "1.0.0-next.273",
+    "@hydranium/langium": "1.0.0-next.273",
+    "@hydranium/protocol": "1.0.0-next.273",
     "@memlab/core": "^2.0.3",
     "@memlab/heap-analysis": "^2.0.3",
     "vscode-jsonrpc": "^9.0.0"

package/src/cli.ts

@@ -13,6 +13,7 @@ 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 { 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';
@@ -45,6 +46,7 @@ const COMMANDS: Record<string, { readonly summary: string; readonly run: (args:
       summary: "Tally a workspace's live-model $types (analyze-heap --validate input).",
       run: runAstGroundTruthCommand
    },
+   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

package/src/commands/delete-args.ts

@@ -0,0 +1,64 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 {
+   assertRequired,
+   exitWithUsage,
+   helpRequested,
+   logHelpLines,
+   parseFlagOptions,
+   parseServerSpawnOptions,
+   printHelp,
+   SERVER_SPAWN_VALUE_FLAGS,
+   type UsageError
+} from './harness-args.js';
+import { type DeleteCommandOptions, runDelete } from './delete.js';
+
+const OWN_FLAGS = ['--uri', '--client-id'] as const;
+
+/** Every flag `delete` accepts, each of which takes a value. */
+export const DELETE_FLAGS: readonly string[] = [...SERVER_SPAWN_VALUE_FLAGS, ...OWN_FLAGS];
+
+/** The `--help` text, as data, held to {@link DELETE_FLAGS} by a test. */
+export const DELETE_HELP: readonly string[] = [
+   'Usage: hydranium-cli delete --server "<cmd>..." --uri <uri> [--client-id <id>] [--cwd <dir>] [--log-level <lvl>] [--log-file <file>] [--log-file-level <lvl>]',
+   '',
+   'Delete the document at `<uri>`, its file and then the document, via deleteModelDocument,',
+   'whatever text it holds. Prints nothing.',
+   '',
+   'Options:',
+   '  --server "<cmd>"      Command-line for the data-server subprocess (required).',
+   '  --uri <uri>           Document URI (required).',
+   '  --client-id <id>      clientId the deletion is attributed to. Default: hydranium-cli.',
+   '  --cwd <dir>           Working directory for the spawned child. Default: cwd.',
+   ...logHelpLines(22, 'the spawned server')
+];
+
+export function parseDeleteArgs(args: string[], onError: UsageError = exitWithUsage): DeleteCommandOptions {
+   const { serverCommand, serverArgs, cwd, logLevel, logFile, logFileLevel, extra } = parseServerSpawnOptions(args, 'delete', onError);
+   const { uri, clientId } = parseFlagOptions(extra, 'delete', OWN_FLAGS, onError);
+   return {
+      serverCommand,
+      serverArgs,
+      cwd,
+      logLevel,
+      logFile,
+      logFileLevel,
+      uri: assertRequired(uri, '--uri', 'delete', onError),
+      clientId
+   };
+}
+
+export function runDeleteCommand(args: string[]): Promise<void> {
+   if (helpRequested(args, DELETE_FLAGS)) {
+      printHelp(DELETE_HELP);
+      return Promise.resolve();
+   }
+   return runDelete(parseDeleteArgs(args));
+}

package/src/commands/delete.ts

@@ -0,0 +1,69 @@
+/********************************************************************************
+ * Copyright (c) 2026 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 { TransferElement } from '@hydranium/protocol';
+import type { DataServerProtocol } from '@hydranium/protocol/data';
+import { logEnv, type LogOptions } from '../log-level.js';
+import { withDataServer } from '../spawn-data-server.js';
+
+/**
+ * Options for the {@link runDelete} subcommand. Deletes the document at `uri`,
+ * its file and then the document, via the data-server's `deleteModelDocument`
+ * RPC, whatever text it holds. Prints nothing; a failed delete rejects.
+ *
+ * `clientId` defaults to `'hydranium-cli'`. The command deletes as a client
+ * session under it: it registers the session, opens the document, deletes it,
+ * and ends the session.
+ */
+export interface DeleteCommandOptions extends LogOptions {
+   readonly serverCommand: string;
+   readonly serverArgs?: readonly string[];
+   readonly cwd?: string;
+   readonly uri: string;
+   readonly clientId?: string;
+   readonly __proxyForTest?: DataServerProtocol<TransferElement>;
+}
+
+export async function runDelete(options: DeleteCommandOptions): Promise<void> {
+   const clientId = options.clientId ?? 'hydranium-cli';
+   if (options.__proxyForTest) {
+      await deleteOpened(options.__proxyForTest, options.uri, clientId);
+      return;
+   }
+   await withDataServer(
+      {
+         command: options.serverCommand,
+         args: options.serverArgs,
+         cwd: options.cwd,
+         env: logEnv(options)
+      },
+      server => deleteOpened(server, options.uri, clientId)
+   );
+}
+
+/**
+ * Delete `uri` as the session `clientId`, and end the session whether the
+ * delete succeeded or not. An end that fails after a failed delete is
+ * swallowed: the delete's error is the one the user needs.
+ */
+async function deleteOpened(
+   server: Pick<DataServerProtocol<TransferElement>, 'createSession' | 'openModelDocument' | 'deleteModelDocument' | 'closeSession'>,
+   uri: string,
+   clientId: string
+): Promise<void> {
+   await server.createSession({ clientId, label: 'hydranium-cli' });
+   try {
+      await server.openModelDocument({ uri, clientId });
+      await server.deleteModelDocument({ uri, clientId, baseVersion: 'any' });
+   } catch (error: unknown) {
+      await server.closeSession({ clientId }).catch(() => undefined);
+      throw error;
+   }
+   await server.closeSession({ clientId });
+}

package/src/index.ts

@@ -7,6 +7,7 @@
  * SPDX-License-Identifier: MIT
  ********************************************************************************/
 
+export * from './commands/delete.js';
 export * from './commands/generate-ast-builder.js';
 export * from './commands/generate-transfer-model.js';
 export * from './commands/projects.js';