@hydranium/cli 1.0.0-next.10

package/lib/commands/lint-grammar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-grammar.d.ts","sourceRoot":"","sources":["../../src/commands/lint-grammar.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAGlF,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAQhF,yDAAyD;AACzD,MAAM,WAAW,yBAA0B,SAAQ,kBAAkB;IAClE,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,oGAAoG;IACpG,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IACxB,8DAA8D;IAC9D,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,oEAAoE;AACpE,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,EAAE,CAYvF;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,yBAAyB,GAAG,OAAO,CAAC,IAAI,CAAC,CAEhF"}

package/lib/commands/lint-grammar.js

@@ -0,0 +1,42 @@
+/********************************************************************************
+ * 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 { fileURLToPath } from 'node:url';
+import { runDriverChild } from './headless-harness.js';
+/**
+ * Absolute path to the spawned driver. From `lib/commands/lint-grammar.js` the
+ * compiled driver sits beside it at `lib/commands/lint-grammar-driver.js`.
+ */
+const DRIVER = fileURLToPath(new URL('./lint-grammar-driver.js', import.meta.url));
+/** Build the argv the driver child parses. Pure → unit-testable. */
+export function buildLintGrammarDriverArgs(options) {
+    const args = ['--services', options.servicesModule];
+    for (const property of options.nameProperties ?? []) {
+        args.push('--name-property', property);
+    }
+    if (options.json) {
+        args.push('--json');
+    }
+    if (options.strict) {
+        args.push('--strict');
+    }
+    return args;
+}
+/**
+ * Headless grammar-convention lint — a CI gate that checks a head's grammar against
+ * the framework's expectations (nameable cross-reference targets, an entry rule) and
+ * exits non-zero when a violation is found (`--strict` also fails on warnings).
+ * Read-only: no workspace is built (the reflection is static once the head registers
+ * its language), so this subcommand takes only `--services` and the name-property
+ * overrides. The work runs in a spawned child that dynamic-imports the head's
+ * `createServices` module, keeping the binary language-agnostic.
+ */
+export function runLintGrammar(options) {
+    return runDriverChild(['--max-old-space-size=8192', DRIVER, ...buildLintGrammarDriverArgs(options)], options);
+}
+//# sourceMappingURL=lint-grammar.js.map

package/lib/commands/lint-grammar.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lint-grammar.js","sourceRoot":"","sources":["../../src/commands/lint-grammar.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,cAAc,EAA2B,MAAM,uBAAuB,CAAC;AAEhF;;;GAGG;AACH,MAAM,MAAM,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC,0BAA0B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAcnF,oEAAoE;AACpE,MAAM,UAAU,0BAA0B,CAAC,OAAkC;IAC1E,MAAM,IAAI,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,cAAc,CAAC,CAAC;IACpD,KAAK,MAAM,QAAQ,IAAI,OAAO,CAAC,cAAc,IAAI,EAAE,EAAE,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACvB,CAAC;IACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;QAClB,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACzB,CAAC;IACD,OAAO,IAAI,CAAC;AACf,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,OAAkC;IAC9D,OAAO,cAAc,CAAC,CAAC,2BAA2B,EAAE,MAAM,EAAE,GAAG,0BAA0B,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACjH,CAAC"}

package/lib/commands/measure-memory-args.d.ts

@@ -0,0 +1,23 @@
+/********************************************************************************
+ * 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 UsageError } from './harness-args.js';
+import { type MeasureMemoryCommandOptions } from './measure-memory.js';
+/**
+ * Every flag `measure-memory` accepts, derived from the sets the parser is
+ * handed so the list cannot claim a flag the parser would reject. `--services`
+ * is consumed by the shared harness parser itself, so it is in neither set.
+ */
+export declare const MEASURE_MEMORY_FLAGS: readonly string[];
+/** The subset that takes a value, so `--help` in a value position reads as data. */
+export declare const MEASURE_MEMORY_VALUE_FLAGS: readonly string[];
+/** The `--help` text, as data, held to {@link MEASURE_MEMORY_FLAGS} by a test. */
+export declare const MEASURE_MEMORY_HELP: readonly string[];
+export declare function parseMeasureMemoryArgs(args: string[], onError?: UsageError): MeasureMemoryCommandOptions;
+export declare function runMeasureMemoryCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=measure-memory-args.d.ts.map

package/lib/commands/measure-memory-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-memory-args.d.ts","sourceRoot":"","sources":["../../src/commands/measure-memory-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EAUJ,KAAK,UAAU,EACjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAA4C,KAAK,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAcjH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,SAAS,MAAM,EAAmD,CAAC;AAEtG,oFAAoF;AACpF,eAAO,MAAM,0BAA0B,EAAE,SAAS,MAAM,EAAoC,CAAC;AAE7F,kFAAkF;AAClF,eAAO,MAAM,mBAAmB,EAAE,SAAS,MAAM,EA4BhD,CAAC;AAwBF,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,2BAA2B,CAgBvH;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMrE"}

package/lib/commands/measure-memory-args.js

@@ -0,0 +1,106 @@
+/********************************************************************************
+ * 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 { exitWithUsage, helpRequested, LOG_LEVEL_FLAG, logLevelHelpLine, logLevelOption, numericOption, parseHarnessArgs, printHelp, SERVICES_FLAG } from './harness-args.js';
+import { parseProfileDimensions, runMeasureMemory } from './measure-memory.js';
+const VALUE_FLAGS = [
+    '--edits',
+    '--edit-docs',
+    '--churn-suffix',
+    '--settle',
+    '--snapshot-path',
+    '--profile',
+    '--session-out',
+    LOG_LEVEL_FLAG
+];
+const BOOL_FLAGS = ['--snapshot', '--json'];
+/**
+ * Every flag `measure-memory` accepts, derived from the sets the parser is
+ * handed so the list cannot claim a flag the parser would reject. `--services`
+ * is consumed by the shared harness parser itself, so it is in neither set.
+ */
+export const MEASURE_MEMORY_FLAGS = [SERVICES_FLAG, ...VALUE_FLAGS, ...BOOL_FLAGS];
+/** The subset that takes a value, so `--help` in a value position reads as data. */
+export const MEASURE_MEMORY_VALUE_FLAGS = [SERVICES_FLAG, ...VALUE_FLAGS];
+/** The `--help` text, as data, held to {@link MEASURE_MEMORY_FLAGS} by a test. */
+export const MEASURE_MEMORY_HELP = [
+    'Usage: hydranium-cli measure-memory --services <module> <workspace> [options]',
+    '',
+    'Measure model-store memory for a workspace. `<module>` is an ESM module that',
+    'exports a zero-arg `createServices(): { shared }` thunk (the head wires its own',
+    'filesystem inside). Runs in a `--expose-gc` child for post-GC readings; the',
+    'baseline / after-build / churn lines print on stdout. Needs @hydranium/core.',
+    '',
+    'Options:',
+    '  --services <module>   ESM module exporting `createServices(): { shared }` (required).',
+    '  <workspace>           Workspace root (path or file URI) to build (required).',
+    '  --edits <N>           Rebuild-churn cycles to probe for retention. Default: 0 (skip).',
+    '  --edit-docs <N>       Documents to churn per cycle. Default: 25.',
+    '  --churn-suffix <ext>  Only churn documents whose URI ends with this suffix.',
+    '  --settle <ms>         Wait <ms> after the build before measuring, so a',
+    '                        timer-driven residency policy (shed-closed-when-idle)',
+    "                        sheds first. Pass above the policy's idleMs; omit to",
+    '                        measure the pre-shed (always-keep) baseline.',
+    '  --snapshot            Write a `.heapsnapshot` after the build.',
+    '  --snapshot-path <p>   Snapshot path. Default: <cwd>/<workspace-basename>.heapsnapshot.',
+    '  --profile <dims>      Capture sampled profiles around the build (+churn) into a',
+    '                        profiling session. Comma-separated: cpu,alloc,gc,eld,heap.',
+    '  --session-out <dir>   Parent directory for the profiling session folder (with --profile).',
+    '  --json                Emit the measurement as one JSON document instead of the',
+    '                        progress lines: documentCount, buildMs, emptyHeapBytes,',
+    '                        afterBuildHeapBytes, and churnGrowthBytes / snapshotPath /',
+    '                        profilingSession where the run produced them.',
+    logLevelHelpLine(22)
+];
+/**
+ * Validate `--profile` in the PARENT, where the numeric flags beside it are
+ * already validated.
+ *
+ * Returns the RAW string rather than the parsed dimensions on purpose: the child
+ * re-parses them, because that is where they are used, and this exists only so a
+ * typo fails as a usage error before a process is spawned and a whole head
+ * imported. Parsing here and passing the result would change what crosses to the
+ * child for no gain.
+ */
+function validatedProfile(csv, onError) {
+    if (csv === undefined) {
+        return undefined;
+    }
+    try {
+        parseProfileDimensions(csv);
+    }
+    catch (err) {
+        onError(`Option --profile: ${err instanceof Error ? err.message : String(err)}`);
+    }
+    return csv;
+}
+export function parseMeasureMemoryArgs(args, onError = exitWithUsage) {
+    const { servicesModule, workspace, options } = parseHarnessArgs(args, 'measure-memory', VALUE_FLAGS, BOOL_FLAGS, { onError });
+    return {
+        servicesModule,
+        workspace,
+        editCycles: numericOption(options['--edits'], '--edits', onError),
+        editDocs: numericOption(options['--edit-docs'], '--edit-docs', onError),
+        churnSuffix: options['--churn-suffix'],
+        settleMs: numericOption(options['--settle'], '--settle', onError),
+        writeSnapshot: options['--snapshot'] === 'true',
+        snapshotPath: options['--snapshot-path'],
+        profile: validatedProfile(options['--profile'], onError),
+        sessionOut: options['--session-out'],
+        json: options['--json'] === 'true',
+        logLevel: logLevelOption(options[LOG_LEVEL_FLAG])
+    };
+}
+export function runMeasureMemoryCommand(args) {
+    if (helpRequested(args, MEASURE_MEMORY_VALUE_FLAGS)) {
+        printHelp(MEASURE_MEMORY_HELP);
+        return Promise.resolve();
+    }
+    return runMeasureMemory(parseMeasureMemoryArgs(args));
+}
+//# sourceMappingURL=measure-memory-args.js.map

package/lib/commands/measure-memory-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-memory-args.js","sourceRoot":"","sources":["../../src/commands/measure-memory-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,aAAa,EAEf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,sBAAsB,EAAE,gBAAgB,EAAoC,MAAM,qBAAqB,CAAC;AAEjH,MAAM,WAAW,GAAG;IACjB,SAAS;IACT,aAAa;IACb,gBAAgB;IAChB,UAAU;IACV,iBAAiB;IACjB,WAAW;IACX,eAAe;IACf,cAAc;CACP,CAAC;AACX,MAAM,UAAU,GAAG,CAAC,YAAY,EAAE,QAAQ,CAAU,CAAC;AAErD;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAsB,CAAC,aAAa,EAAE,GAAG,WAAW,EAAE,GAAG,UAAU,CAAC,CAAC;AAEtG,oFAAoF;AACpF,MAAM,CAAC,MAAM,0BAA0B,GAAsB,CAAC,aAAa,EAAE,GAAG,WAAW,CAAC,CAAC;AAE7F,kFAAkF;AAClF,MAAM,CAAC,MAAM,mBAAmB,GAAsB;IACnD,+EAA+E;IAC/E,EAAE;IACF,8EAA8E;IAC9E,iFAAiF;IACjF,6EAA6E;IAC7E,8EAA8E;IAC9E,EAAE;IACF,UAAU;IACV,yFAAyF;IACzF,gFAAgF;IAChF,yFAAyF;IACzF,oEAAoE;IACpE,+EAA+E;IAC/E,0EAA0E;IAC1E,+EAA+E;IAC/E,8EAA8E;IAC9E,sEAAsE;IACtE,kEAAkE;IAClE,0FAA0F;IAC1F,mFAAmF;IACnF,oFAAoF;IACpF,6FAA6F;IAC7F,kFAAkF;IAClF,iFAAiF;IACjF,oFAAoF;IACpF,uEAAuE;IACvE,gBAAgB,CAAC,EAAE,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,SAAS,gBAAgB,CAAC,GAAuB,EAAE,OAAmB;IACnE,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,SAAS,CAAC;IACpB,CAAC;IACD,IAAI,CAAC;QACF,sBAAsB,CAAC,GAAG,CAAC,CAAC;IAC/B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACrB,OAAO,CAAC,qBAAqB,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,GAAG,CAAC;AACd,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAc,EAAE,UAAsB,aAAa;IACvF,MAAM,EAAE,cAAc,EAAE,SAAS,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,gBAAgB,EAAE,WAAW,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,CAAC,CAAC;IAC9H,OAAO;QACJ,cAAc;QACd,SAAS;QACT,UAAU,EAAE,aAAa,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,SAAS,EAAE,OAAO,CAAC;QACjE,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,aAAa,EAAE,OAAO,CAAC;QACvE,WAAW,EAAE,OAAO,CAAC,gBAAgB,CAAC;QACtC,QAAQ,EAAE,aAAa,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,UAAU,EAAE,OAAO,CAAC;QACjE,aAAa,EAAE,OAAO,CAAC,YAAY,CAAC,KAAK,MAAM;QAC/C,YAAY,EAAE,OAAO,CAAC,iBAAiB,CAAC;QACxC,OAAO,EAAE,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;QACxD,UAAU,EAAE,OAAO,CAAC,eAAe,CAAC;QACpC,IAAI,EAAE,OAAO,CAAC,QAAQ,CAAC,KAAK,MAAM;QAClC,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;KACnD,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,IAAc;IACnD,IAAI,aAAa,CAAC,IAAI,EAAE,0BAA0B,CAAC,EAAE,CAAC;QACnD,SAAS,CAAC,mBAAmB,CAAC,CAAC;QAC/B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,gBAAgB,CAAC,sBAAsB,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC"}

package/lib/commands/measure-memory-driver.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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=measure-memory-driver.d.ts.map

package/lib/commands/measure-memory-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-memory-driver.d.ts","sourceRoot":"","sources":["../../src/commands/measure-memory-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF"}

package/lib/commands/measure-memory-driver.js

@@ -0,0 +1,110 @@
+/********************************************************************************
+ * 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
+ ********************************************************************************/
+/*
+ * Spawned child of the `measure-memory` subcommand. Launched by the parent with
+ * `node --expose-gc --max-old-space-size=8192 <this> --services <module> <workspace> ...`
+ * so the underlying harness gets post-GC readings. It dynamic-imports the head's
+ * services module and runs the framework's `measureModelMemory`, streaming the
+ * baseline / after-build / churn lines to stdout. Never imported — only spawned.
+ */
+import { loadHeadlessContext } from './headless-harness.js';
+import { parseProfileDimensions } from './measure-memory.js';
+function parseArgs(argv) {
+    const parsed = { writeSnapshot: false, json: false };
+    for (let index = 0; index < argv.length; index += 1) {
+        const flag = argv[index];
+        const next = () => {
+            const value = argv[index + 1];
+            if (value === undefined) {
+                console.error(`Missing value for ${flag}`);
+                process.exit(1);
+            }
+            index += 1;
+            return value;
+        };
+        switch (flag) {
+            case '--services':
+                parsed.servicesModule = next();
+                break;
+            case '--edits':
+                parsed.editCycles = Number(next());
+                break;
+            case '--edit-docs':
+                parsed.editDocs = Number(next());
+                break;
+            case '--churn-suffix':
+                parsed.churnDocSuffix = next();
+                break;
+            case '--settle':
+                parsed.settleMs = Number(next());
+                break;
+            case '--snapshot':
+                parsed.writeSnapshot = true;
+                break;
+            case '--snapshot-path':
+                parsed.snapshotPath = next();
+                break;
+            case '--profile':
+                parsed.profile = next();
+                break;
+            case '--session-out':
+                parsed.sessionOut = next();
+                break;
+            case '--json':
+                parsed.json = true;
+                break;
+            default:
+                if (flag.startsWith('--')) {
+                    console.error(`Unknown option: ${flag}`);
+                    process.exit(1);
+                }
+                parsed.workspace = flag;
+        }
+    }
+    return parsed;
+}
+async function main(argv) {
+    const args = parseArgs(argv);
+    if (!args.servicesModule || !args.workspace) {
+        console.error('measure-memory-driver: --services <module> and a <workspace> are required.');
+        process.exit(1);
+    }
+    const { createServices, coreNode } = await loadHeadlessContext(args.servicesModule);
+    const result = await coreNode.measureModelMemory({
+        createServices,
+        workspace: args.workspace,
+        editCycles: args.editCycles,
+        editDocs: args.editDocs,
+        churnDocSuffix: args.churnDocSuffix,
+        settleMs: args.settleMs,
+        writeSnapshot: args.writeSnapshot,
+        snapshotPath: args.snapshotPath,
+        profile: args.profile ? parseProfileDimensions(args.profile) : undefined,
+        sessionOut: args.sessionOut,
+        // Omitted under `--json` rather than redirected: every progress line would
+        // otherwise land on the same stream as the document, so the caller's
+        // `JSON.parse` would see a preamble it has no way to bound.
+        log: args.json ? undefined : line => console.log(line)
+    });
+    if (args.json) {
+        console.log(JSON.stringify(result, null, 2));
+        return;
+    }
+    console.log(`SUMMARY: docs=${result.documentCount} build=${Math.round(result.buildMs)}ms`);
+    if (result.profilingSession) {
+        console.log(`SESSION: ${result.profilingSession}`);
+    }
+}
+main(process.argv.slice(2))
+    .then(() => process.exit(0))
+    .catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+});
+//# sourceMappingURL=measure-memory-driver.js.map

package/lib/commands/measure-memory-driver.js.map

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

package/lib/commands/measure-memory.d.ts

@@ -0,0 +1,68 @@
+/********************************************************************************
+ * 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 { ProfileCaptureOptions } from '@hydranium/core/node';
+import { type DriverSpawnOptions } from './headless-harness.js';
+/** Options for the {@link runMeasureMemory} subcommand. */
+export interface MeasureMemoryCommandOptions extends DriverSpawnOptions {
+    /** ESM module exporting a zero-arg `createServices(): { shared }` thunk. */
+    readonly servicesModule: string;
+    /** Workspace root (filesystem path or file URI) to build. */
+    readonly workspace: string;
+    /** Rebuild-churn cycles to probe for retention (default 0 = skip). */
+    readonly editCycles?: number;
+    /** Documents to churn per cycle. */
+    readonly editDocs?: number;
+    /** Only churn documents whose URI path ends with this suffix. */
+    readonly churnSuffix?: string;
+    /**
+     * Wait this many milliseconds after the build before measuring, so a
+     * timer-driven residency policy (`CstResidencyService`'s
+     * `shed-closed-when-idle`) sheds before the reading is taken. Pass a value
+     * comfortably above the policy's `idleMs`; omit (or `0`) to measure the
+     * pre-shed heap (the always-keep-equivalent baseline).
+     */
+    readonly settleMs?: number;
+    /** Write a `.heapsnapshot` after the build. */
+    readonly writeSnapshot?: boolean;
+    /** Snapshot path (default `<cwd>/<workspace-basename>.heapsnapshot`). */
+    readonly snapshotPath?: string;
+    /** Comma-separated profile dimensions to capture; see {@link parseProfileDimensions} for the tokens. */
+    readonly profile?: string;
+    /** Parent directory for the profiling session folder. Only used with {@link profile}. */
+    readonly sessionOut?: string;
+    /**
+     * Emit the `MeasureModelMemoryResult` as JSON instead of the progress lines.
+     *
+     * The progress lines are suppressed rather than kept alongside it, because the
+     * flag exists so a script can read stdout as one document — a preamble on the
+     * same stream would leave every caller stripping it by hand.
+     */
+    readonly json?: boolean;
+}
+/**
+ * Parse a `--profile` dimension list (`cpu,alloc,gc,eld,heap`) into
+ * {@link ProfileCaptureOptions}. Case- and whitespace-tolerant; throws on an
+ * unknown token so a typo fails loud rather than silently capturing nothing.
+ */
+export declare function parseProfileDimensions(csv: string): ProfileCaptureOptions;
+/**
+ * Build the argv the driver child parses. Pure → unit-testable; mirrors the
+ * driver's own option names.
+ */
+export declare function buildDriverArgs(options: MeasureMemoryCommandOptions): string[];
+/**
+ * Headless model-store memory measurement. `hydranium-cli` is language-agnostic
+ * and cannot import a head's `create<Lang>Services`, so the head passes a module
+ * that exports a zero-arg `createServices` thunk (`--services`). Because the
+ * underlying `measureModelMemory` harness needs post-GC readings, the work runs
+ * in a spawned child launched with `--expose-gc`; the driver dynamic-imports the
+ * module and reports the baseline / after-build / churn lines on stdout.
+ */
+export declare function runMeasureMemory(options: MeasureMemoryCommandOptions): Promise<void>;
+//# sourceMappingURL=measure-memory.d.ts.map

package/lib/commands/measure-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"measure-memory.d.ts","sourceRoot":"","sources":["../../src/commands/measure-memory.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAElE,OAAO,EAAkB,KAAK,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAQhF,2DAA2D;AAC3D,MAAM,WAAW,2BAA4B,SAAQ,kBAAkB;IACpE,4EAA4E;IAC5E,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,sEAAsE;IACtE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oCAAoC;IACpC,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,iEAAiE;IACjE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B;;;;;;OAMG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+CAA+C;IAC/C,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,yEAAyE;IACzE,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;IAC/B,wGAAwG;IACxG,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,yFAAyF;IACzF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;;;OAMG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;CAC1B;AAED;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,qBAAqB,CAgCzE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,2BAA2B,GAAG,MAAM,EAAE,CA8B9E;AAED;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,CAEpF"}

package/lib/commands/measure-memory.js

@@ -0,0 +1,100 @@
+/********************************************************************************
+ * 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 { fileURLToPath } from 'node:url';
+import { runDriverChild } from './headless-harness.js';
+/**
+ * Absolute path to the spawned driver. From `lib/commands/measure-memory.js`
+ * the compiled driver sits beside it at `lib/commands/measure-memory-driver.js`.
+ */
+const DRIVER = fileURLToPath(new URL('./measure-memory-driver.js', import.meta.url));
+/**
+ * Parse a `--profile` dimension list (`cpu,alloc,gc,eld,heap`) into
+ * {@link ProfileCaptureOptions}. Case- and whitespace-tolerant; throws on an
+ * unknown token so a typo fails loud rather than silently capturing nothing.
+ */
+export function parseProfileDimensions(csv) {
+    const options = {};
+    for (const raw of csv.split(',')) {
+        const token = raw.trim().toLowerCase();
+        if (!token) {
+            continue;
+        }
+        switch (token) {
+            case 'cpu':
+                options.cpu = true;
+                break;
+            case 'alloc':
+            case 'allocation':
+                options.allocation = true;
+                break;
+            case 'gc':
+                options.gc = true;
+                break;
+            case 'eld':
+            case 'eventloop':
+            case 'event-loop':
+                options.eventLoopDelay = true;
+                break;
+            case 'heap':
+            case 'heapsnapshot':
+                options.heapSnapshot = true;
+                break;
+            default:
+                throw new Error(`Unknown profile dimension: ${token} (expected cpu, alloc, gc, eld, heap)`);
+        }
+    }
+    return options;
+}
+/**
+ * Build the argv the driver child parses. Pure → unit-testable; mirrors the
+ * driver's own option names.
+ */
+export function buildDriverArgs(options) {
+    const args = ['--services', options.servicesModule, options.workspace];
+    if (options.editCycles !== undefined) {
+        args.push('--edits', String(options.editCycles));
+    }
+    if (options.editDocs !== undefined) {
+        args.push('--edit-docs', String(options.editDocs));
+    }
+    if (options.churnSuffix !== undefined) {
+        args.push('--churn-suffix', options.churnSuffix);
+    }
+    if (options.settleMs !== undefined) {
+        args.push('--settle', String(options.settleMs));
+    }
+    if (options.writeSnapshot) {
+        args.push('--snapshot');
+    }
+    if (options.snapshotPath !== undefined) {
+        args.push('--snapshot-path', options.snapshotPath);
+    }
+    if (options.profile !== undefined) {
+        args.push('--profile', options.profile);
+    }
+    if (options.sessionOut !== undefined) {
+        args.push('--session-out', options.sessionOut);
+    }
+    if (options.json) {
+        args.push('--json');
+    }
+    return args;
+}
+/**
+ * Headless model-store memory measurement. `hydranium-cli` is language-agnostic
+ * and cannot import a head's `create<Lang>Services`, so the head passes a module
+ * that exports a zero-arg `createServices` thunk (`--services`). Because the
+ * underlying `measureModelMemory` harness needs post-GC readings, the work runs
+ * in a spawned child launched with `--expose-gc`; the driver dynamic-imports the
+ * module and reports the baseline / after-build / churn lines on stdout.
+ */
+export function runMeasureMemory(options) {
+    return runDriverChild(['--expose-gc', '--max-old-space-size=8192', DRIVER, ...buildDriverArgs(options)], options);
+}
+//# sourceMappingURL=measure-memory.js.map

package/lib/commands/measure-memory.js.map

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

package/lib/commands/model-docs-args.d.ts

@@ -0,0 +1,23 @@
+/********************************************************************************
+ * 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 UsageError } from './harness-args.js';
+import { type ModelDocsCommandOptions } from './model-docs.js';
+/**
+ * Every flag `model-docs` accepts, derived from the sets the parser is handed so
+ * the list cannot claim a flag the parser would reject. `--services` is consumed
+ * by the shared harness parser itself, so it is in neither set.
+ */
+export declare const MODEL_DOCS_FLAGS: readonly string[];
+/** The subset that takes a value, so `--help` in a value position reads as data. */
+export declare const MODEL_DOCS_VALUE_FLAGS: readonly string[];
+/** The `--help` text, as data, held to {@link MODEL_DOCS_FLAGS} by a test. */
+export declare const MODEL_DOCS_HELP: readonly string[];
+export declare function parseModelDocsArgs(args: string[], onError?: UsageError): ModelDocsCommandOptions;
+export declare function runModelDocsCommand(args: string[]): Promise<void>;
+//# sourceMappingURL=model-docs-args.d.ts.map

package/lib/commands/model-docs-args.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-docs-args.d.ts","sourceRoot":"","sources":["../../src/commands/model-docs-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EASJ,KAAK,UAAU,EACjB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAgB,KAAK,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAI7E;;;;GAIG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAAoC,CAAC;AAEnF,oFAAoF;AACpF,eAAO,MAAM,sBAAsB,EAAE,SAAS,MAAM,EAAqB,CAAC;AAE1E,8EAA8E;AAC9E,eAAO,MAAM,eAAe,EAAE,SAAS,MAAM,EAgB5C,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,UAA0B,GAAG,uBAAuB,CAM/G;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMjE"}

package/lib/commands/model-docs-args.js

@@ -0,0 +1,53 @@
+/********************************************************************************
+ * 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 { exitWithUsage, helpRequested, LOG_LEVEL_FLAG, logLevelHelpLine, logLevelOption, parseHarnessArgs, printHelp, SERVICES_FLAG } from './harness-args.js';
+import { OUT_FILE_FLAG } from './headless-harness.js';
+import { runModelDocs } from './model-docs.js';
+const VALUE_FLAGS = [OUT_FILE_FLAG, LOG_LEVEL_FLAG];
+/**
+ * Every flag `model-docs` accepts, derived from the sets the parser is handed so
+ * the list cannot claim a flag the parser would reject. `--services` is consumed
+ * by the shared harness parser itself, so it is in neither set.
+ */
+export const MODEL_DOCS_FLAGS = [SERVICES_FLAG, ...VALUE_FLAGS];
+/** The subset that takes a value, so `--help` in a value position reads as data. */
+export const MODEL_DOCS_VALUE_FLAGS = MODEL_DOCS_FLAGS;
+/** The `--help` text, as data, held to {@link MODEL_DOCS_FLAGS} by a test. */
+export const MODEL_DOCS_HELP = [
+    'Usage: hydranium-cli model-docs --services <module> [--out-file <file>] [--log-level <lvl>]',
+    '',
+    'Generate a navigable Markdown reference of every AST node type — a type index,',
+    'cross-linked super/sub types, a reverse "referenced by" index, and a per-language',
+    'grammar summary — for publishing into adopter docs. Read-only: no workspace is',
+    'built. Emits Markdown on stdout, or into `--out-file`; the machine-readable form',
+    'is `hydranium-cli reflect --json`. `<module>` is an ESM module exporting a',
+    'zero-arg `createServices(): { shared }` thunk. Needs @hydranium/core.',
+    '',
+    'Options:',
+    '  --services <module>   ESM module exporting `createServices(): { shared }` (required).',
+    '  --out-file <file>     Write the Markdown to this file instead of stdout. Written',
+    '                        only once the report exists, unlike a shell redirection,',
+    '                        which truncates the file before the head is even booted.',
+    logLevelHelpLine(22)
+];
+export function parseModelDocsArgs(args, onError = exitWithUsage) {
+    const { servicesModule, options } = parseHarnessArgs(args, 'model-docs', VALUE_FLAGS, [], {
+        requireWorkspace: false,
+        onError
+    });
+    return { servicesModule, outFile: options[OUT_FILE_FLAG], logLevel: logLevelOption(options[LOG_LEVEL_FLAG]) };
+}
+export function runModelDocsCommand(args) {
+    if (helpRequested(args, MODEL_DOCS_VALUE_FLAGS)) {
+        printHelp(MODEL_DOCS_HELP);
+        return Promise.resolve();
+    }
+    return runModelDocs(parseModelDocsArgs(args));
+}
+//# sourceMappingURL=model-docs-args.js.map

package/lib/commands/model-docs-args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-docs-args.js","sourceRoot":"","sources":["../../src/commands/model-docs-args.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF;AAElF,OAAO,EACJ,aAAa,EACb,aAAa,EACb,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,SAAS,EACT,aAAa,EAEf,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAgC,MAAM,iBAAiB,CAAC;AAE7E,MAAM,WAAW,GAAG,CAAC,aAAa,EAAE,cAAc,CAAU,CAAC;AAE7D;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAsB,CAAC,aAAa,EAAE,GAAG,WAAW,CAAC,CAAC;AAEnF,oFAAoF;AACpF,MAAM,CAAC,MAAM,sBAAsB,GAAsB,gBAAgB,CAAC;AAE1E,8EAA8E;AAC9E,MAAM,CAAC,MAAM,eAAe,GAAsB;IAC/C,6FAA6F;IAC7F,EAAE;IACF,gFAAgF;IAChF,mFAAmF;IACnF,gFAAgF;IAChF,kFAAkF;IAClF,4EAA4E;IAC5E,uEAAuE;IACvE,EAAE;IACF,UAAU;IACV,yFAAyF;IACzF,oFAAoF;IACpF,kFAAkF;IAClF,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,CAAC;CACtB,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,IAAc,EAAE,UAAsB,aAAa;IACnF,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,gBAAgB,CAAC,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE;QACvF,gBAAgB,EAAE,KAAK;QACvB,OAAO;KACT,CAAC,CAAC;IACH,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,CAAC,aAAa,CAAC,EAAE,QAAQ,EAAE,cAAc,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,EAAE,CAAC;AACjH,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,IAAc;IAC/C,IAAI,aAAa,CAAC,IAAI,EAAE,sBAAsB,CAAC,EAAE,CAAC;QAC/C,SAAS,CAAC,eAAe,CAAC,CAAC;QAC3B,OAAO,OAAO,CAAC,OAAO,EAAE,CAAC;IAC5B,CAAC;IACD,OAAO,YAAY,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AACjD,CAAC"}

package/lib/commands/model-docs-driver.d.ts

@@ -0,0 +1,10 @@
+/********************************************************************************
+ * 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=model-docs-driver.d.ts.map

package/lib/commands/model-docs-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-docs-driver.d.ts","sourceRoot":"","sources":["../../src/commands/model-docs-driver.ts"],"names":[],"mappings":"AAAA;;;;;;;kFAOkF"}