@timiagama/ecr 0.0.1 → 0.1.0

package/dist/cli.js

@@ -0,0 +1,591 @@
+/**
+ * ECR Command Line
+ *
+ * The executable entry point is `bin.ts`; this module only defines the
+ * commands, so that tests can drive them without spawning a process.
+ *
+ * Three commands, and deliberately no more:
+ *
+ * - `lint`  validates a corpus against the ECR structural rules
+ * - `stats` measures the explicit structure a corpus already carries
+ * - `init`  installs the ECR documentation, including the agent navigation
+ *           protocol, beside a corpus
+ *
+ * There is no `backlinks` command, and there should never be one. ECR's claim
+ * is that a corpus is navigable with `grep` alone; a navigation command here
+ * would quietly make the tool a dependency of the thing it exists to prove
+ * unnecessary. Navigation belongs in the protocol `init` installs, not in this
+ * binary.
+ */
+import { cpSync, existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync } from 'node:fs';
+import { dirname, join, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { Ecr } from './ecr.js';
+import { ECR_SPEC_VERSION } from './spec-version.js';
+import { CorpusLoader } from './cli/corpus-loader.js';
+import { PROJECT_IGNORE_FILENAME, ProjectIgnoreFile } from './cli/project-ignore.js';
+import { CorpusStatistics } from './cli/corpus-statistics.js';
+import { DiagnosticReporter } from './cli/diagnostic-reporter.js';
+import { showControlCharacters } from './cli/safe-text.js';
+import { DEFAULT_SUPERVISION_LIMITS, SUPERVISED_VARIABLE, Supervisor } from './cli/supervisor.js';
+/** Process exit code signalling success. */
+const EXIT_SUCCESS = 0;
+/** Process exit code signalling that the corpus contains errors. */
+const EXIT_VALIDATION_FAILED = 1;
+/**
+ * Process exit code signalling that the command could not run: arguments it
+ * could not understand, or a corpus it could not find or fully read.
+ */
+const EXIT_USAGE_ERROR = 2;
+/**
+ * What `init` installs, from the package root, keeping each path as it is in
+ * the repository so the README's relative links work in the installed copy.
+ */
+const INSTALLED_DOCUMENTATION = [
+    'README.md',
+    'LICENSE',
+    'NOTICE',
+    'protocol',
+    'spec',
+    'examples',
+];
+/** Every exit code this command itself produces. */
+const EXIT_CODES = [EXIT_SUCCESS, EXIT_VALIDATION_FAILED, EXIT_USAGE_ERROR];
+/**
+ * How V8 says it has run out of heap. It says so differently depending on
+ * when it happens: "Reached heap limit" once running, "JavaScript heap out of
+ * memory" on an allocation, and "Fatal JavaScript out of memory" while it is
+ * still starting, which is what a limit of a megabyte or two produces.
+ */
+const HEAP_EXHAUSTED = /Reached heap limit|out of memory/i;
+/**
+ * The longest time limit that can be applied: `spawnSync` takes milliseconds
+ * as a 32-bit count, which is about twenty-five days.
+ */
+const MAXIMUM_TIMEOUT_SECONDS = 2_147_483;
+/** The largest heap limit that can be applied, in mebibytes: a tebibyte. */
+const MAXIMUM_MEMORY_MIB = 1_048_576;
+/** Where `lint` and `stats` look when no directory is given. */
+const DEFAULT_CORPUS_DIRECTORY = 'docs';
+/**
+ * Where `init` installs when no directory is given: beside the corpus, never
+ * in it, because the specification's own DocIDs would collide with the
+ * user's.
+ */
+const DEFAULT_INSTALL_DIRECTORY = 'ecr';
+/** Usage text shown for `--help` and on a usage error. */
+const USAGE_TEXT = `
+  ecr - Explicit Constraint Referencing
+
+  Usage
+    ecr lint  [directory] [options]   validate a corpus
+    ecr stats [directory] [options]   measure a corpus
+    ecr init  [directory]             install the ECR documentation
+
+  Options
+    --format <pretty|json>   output format (default: pretty)
+    --ignore <glob>          exclude paths; repeatable
+    --example                lint or measure the example corpus bundled
+                             with this package, instead of a directory
+    --timeout <seconds>      stop lint or stats if it takes longer
+                             (default: 120; 0 for no limit)
+    --max-memory <MiB>       cap the heap lint or stats may use
+                             (default: 2048; 0 for node's own default)
+    --version                show the linter and spec versions
+    --help                   show this message
+
+  The directory defaults to ./docs, or to ./ecr for init.
+
+  lint and stats parse your documents in a separate process, so that a
+  document which takes unreasonably long to parse stops rather than hanging
+  the command. A run that has to be stopped prints nothing and exits 2,
+  because a report of a corpus that was never finished is not a report.
+
+  Patterns in .ecrignore, in the directory the command runs from, are
+  excluded too. They are relative to that directory; --ignore patterns are
+  relative to the directory being linted.
+
+  Exit codes
+    0  no errors
+    1  the corpus contains errors
+    2  the command could not run
+`;
+/**
+ * Parses command-line arguments.
+ *
+ * Throws on anything it cannot understand rather than guessing, because a
+ * silently misread `--ignore` would quietly exclude documents from validation.
+ */
+export class ArgumentParser {
+    /**
+     * Parses an argument list.
+     *
+     * @param argv - Arguments, excluding the node executable and script path
+     * @returns The parsed command line
+     * @throws Error when the arguments cannot be understood
+     */
+    parse(argv) {
+        const [commandCandidate, ...rest] = argv;
+        if (commandCandidate === undefined) {
+            throw new Error('No command given.');
+        }
+        if (!this.isCommandName(commandCandidate)) {
+            throw new Error(`Unknown command "${commandCandidate}".`);
+        }
+        let corpusRoot = undefined;
+        let useExample = false;
+        let format = 'pretty';
+        let timeoutSeconds = undefined;
+        let maxMemoryMib = undefined;
+        const ignorePatterns = [];
+        for (let index = 0; index < rest.length; index += 1) {
+            const argument = rest[index] ?? '';
+            if (argument === '--example') {
+                useExample = true;
+                continue;
+            }
+            if (argument === '--format') {
+                const value = rest[index + 1];
+                if (value !== 'pretty' && value !== 'json') {
+                    throw new Error('--format expects "pretty" or "json".');
+                }
+                format = value;
+                index += 1;
+                continue;
+            }
+            if (argument === '--ignore') {
+                const value = rest[index + 1];
+                if (value === undefined || value.startsWith('--')) {
+                    throw new Error('--ignore expects a glob pattern.');
+                }
+                ignorePatterns.push(value);
+                index += 1;
+                continue;
+            }
+            if (argument === '--timeout') {
+                timeoutSeconds = ArgumentParser.readWholeNumber(rest[index + 1], '--timeout', 'seconds', MAXIMUM_TIMEOUT_SECONDS);
+                index += 1;
+                continue;
+            }
+            if (argument === '--max-memory') {
+                maxMemoryMib = ArgumentParser.readWholeNumber(rest[index + 1], '--max-memory', 'mebibytes', MAXIMUM_MEMORY_MIB);
+                index += 1;
+                continue;
+            }
+            if (argument.startsWith('--')) {
+                throw new Error(`Unknown option "${argument}".`);
+            }
+            if (corpusRoot !== undefined) {
+                throw new Error('More than one directory given.');
+            }
+            corpusRoot = argument;
+        }
+        if (useExample && commandCandidate === 'init') {
+            throw new Error('--example works with lint and stats; init installs into your own project.');
+        }
+        if (useExample && corpusRoot !== undefined) {
+            throw new Error('Give a directory or --example, not both.');
+        }
+        return {
+            command: commandCandidate,
+            corpusRoot: corpusRoot ?? (commandCandidate === 'init' ? DEFAULT_INSTALL_DIRECTORY : DEFAULT_CORPUS_DIRECTORY),
+            useExample,
+            format,
+            ignorePatterns,
+            ...(timeoutSeconds !== undefined ? { timeoutSeconds } : {}),
+            ...(maxMemoryMib !== undefined ? { maxMemoryMib } : {}),
+        };
+    }
+    /**
+     * Reads an option's value as a whole number of some unit, where zero means
+     * no limit.
+     *
+     * @param value - The argument following the option
+     * @param option - The option's name, for the message
+     * @param unit - What the number counts, for the message
+     * @param maximum - The largest value the limit can be applied as
+     * @returns The number
+     * @throws When the value is missing, is not a whole number, or is beyond what can be applied
+     */
+    static readWholeNumber(value, option, unit, maximum) {
+        const parsed = value === undefined ? Number.NaN : Number(value);
+        if (!Number.isInteger(parsed) || parsed < 0) {
+            throw new Error(`${option} expects a whole number of ${unit}, or 0 for no limit.`);
+        }
+        // A limit too large to apply is not the same as no limit: passed on, it
+        // would fail inside the machinery that imposes it rather than here.
+        if (parsed > maximum) {
+            throw new Error(`${option} expects at most ${String(maximum)} ${unit}, or 0 for no limit.`);
+        }
+        return parsed;
+    }
+    /**
+     * Determines whether a string names a supported command.
+     *
+     * @param candidate - The string to test
+     * @returns `true` when the string is a command name
+     */
+    isCommandName(candidate) {
+        return candidate === 'lint' || candidate === 'stats' || candidate === 'init';
+    }
+}
+/**
+ * Runs the CLI commands.
+ *
+ * Output is returned rather than printed so that the commands can be exercised
+ * directly by tests without capturing a stream.
+ */
+export class EcrCommandLine {
+    /** Parses the command line. */
+    argumentParser;
+    /**
+     * The directory the command runs from: relative directories resolve against
+     * it, and it is the project root whose `.ecrignore` applies.
+     */
+    workingDirectory;
+    /** The package's own root, holding `package.json` and what `init` installs. */
+    packageRoot;
+    /** How to run the parsing commands in a child process, when asked to. */
+    supervision;
+    /**
+     * Creates a command-line runner.
+     *
+     * @param options - Where the command runs from and where the package lives; both default to the real ones
+     */
+    constructor(options = {}) {
+        this.argumentParser = new ArgumentParser();
+        this.workingDirectory = options.workingDirectory ?? process.cwd();
+        // Resolved relative to this module, so it is correct whether the CLI runs
+        // from source, from `dist/`, or from an installed package.
+        this.packageRoot = options.packageRoot ?? resolve(dirname(fileURLToPath(import.meta.url)), '..');
+        this.supervision = options.supervision;
+    }
+    /**
+     * Runs one invocation.
+     *
+     * @param argv - Arguments, excluding the node executable and script path
+     * @returns The text to print and the process exit code
+     */
+    run(argv) {
+        if (argv.length === 0) {
+            return this.fail(USAGE_TEXT);
+        }
+        if (argv.includes('--help')) {
+            return this.succeed(USAGE_TEXT);
+        }
+        if (argv.includes('--version')) {
+            return this.succeed(`ecr ${this.showPackageVersion()} (ECR spec ${ECR_SPEC_VERSION})\n`);
+        }
+        let parsed;
+        try {
+            parsed = this.argumentParser.parse(argv);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return this.fail(`  ${message}\n${USAGE_TEXT}`);
+        }
+        const corpusRoot = resolve(this.workingDirectory, parsed.corpusRoot);
+        // `init` installs the documentation, so it may create the directory; the
+        // other commands read a corpus that must already exist.
+        if (parsed.command === 'init') {
+            return this.runInit(corpusRoot, parsed.corpusRoot);
+        }
+        // Everything past this point parses documents, which is the work that
+        // cannot be bounded from the inside.
+        const supervision = this.readSupervision();
+        if (supervision !== undefined) {
+            return this.runSupervised(supervision, argv, parsed);
+        }
+        // The bundled example belongs to the package, not the project, so the
+        // project's .ecrignore does not apply to it; --ignore still does.
+        if (parsed.useExample) {
+            return this.runValidation(parsed, join(this.packageRoot, 'examples', 'docs'), 'the bundled example corpus', false);
+        }
+        return this.runValidation(parsed, corpusRoot, parsed.corpusRoot, true);
+    }
+    /**
+     * Runs `lint` or `stats` against a corpus.
+     *
+     * @param parsed - The parsed command line
+     * @param corpusRoot - Resolved corpus directory
+     * @param displayedRoot - How to name the corpus in messages
+     * @param applyProjectIgnore - Whether the project's `.ecrignore` applies
+     * @returns The text to print and the process exit code
+     */
+    runValidation(parsed, corpusRoot, displayedRoot, applyProjectIgnore) {
+        if (!existsSync(corpusRoot) || !statSync(corpusRoot).isDirectory()) {
+            return this.fail(`  Directory not found: ${displayedRoot}\n`);
+        }
+        let projectIgnore = undefined;
+        if (applyProjectIgnore) {
+            const read = new ProjectIgnoreFile(this.workingDirectory).read();
+            if (read.kind === 'unreadable') {
+                return this.fail(`  Could not read ${PROJECT_IGNORE_FILENAME} (${read.reason}).\n`);
+            }
+            if (read.kind === 'patterns') {
+                projectIgnore = { workingDirectory: this.workingDirectory, patterns: read.patterns };
+            }
+        }
+        const loader = new CorpusLoader(corpusRoot, parsed.ignorePatterns, projectIgnore);
+        const loaded = loader.load();
+        if (loaded.rootExcluded) {
+            return this.fail(`  ${displayedRoot} is excluded by ${PROJECT_IGNORE_FILENAME}, so there is nothing to check.\n`);
+        }
+        // A corpus that was not fully read cannot pass or be summarised, so the
+        // command cannot run; the walk still finished, so every such path is named.
+        if (loaded.unreadablePaths.length > 0) {
+            return this.fail('  Could not read:\n' +
+                loaded.unreadablePaths.map((unreadable) => `    ${unreadable.path} (${unreadable.reason})\n`).join('') +
+                '  Fix these paths, or exclude them with --ignore.\n');
+        }
+        if (loaded.documents.length === 0) {
+            // Links are the likeliest reason a directory of documents yields none.
+            const links = DiagnosticReporter.listNotFollowed(loaded.notFollowedPaths);
+            return this.fail(`  No Markdown documents found in ${displayedRoot}\n` +
+                links.map((line) => `${line}\n`).join('') +
+                (links.length > 0 ? '  Links are not followed, because `rg` and `grep -r` do not follow them either.\n' : ''));
+        }
+        const corpusResult = new Ecr().validateCorpus(loaded.documents);
+        const reporter = new DiagnosticReporter(parsed.format);
+        if (parsed.command === 'stats') {
+            const statistics = new CorpusStatistics(corpusResult);
+            return this.succeed(reporter.reportStatistics(statistics.summarise(), loaded.notFollowedPaths));
+        }
+        const output = reporter.reportValidation(corpusResult, loaded.excludedPaths, loaded.notFollowedPaths);
+        const hasErrors = this.tellCorpusHasErrors(corpusResult);
+        // A report of a failing corpus is still the command's result, so it goes
+        // to stdout; only the exit code signals the failure.
+        return {
+            output,
+            stream: 'stdout',
+            exitCode: hasErrors ? EXIT_VALIDATION_FAILED : EXIT_SUCCESS,
+        };
+    }
+    /**
+     * Installs the ECR documentation into a new or empty directory, keeping the
+     * repository's layout, and adds that directory to the project's
+     * `.ecrignore` so that linting the project does not validate it.
+     *
+     * Everything that could stop the installation is checked before anything is
+     * written, and a failure part-way removes what was copied.
+     *
+     * @param destination - Resolved installation directory
+     * @param displayedDestination - The directory as the user typed it, for messages
+     * @returns The text to print and the process exit code
+     */
+    runInit(destination, displayedDestination) {
+        const packageRoot = this.packageRoot;
+        const missing = INSTALLED_DOCUMENTATION.filter((path) => !existsSync(join(packageRoot, path)));
+        if (missing.length > 0) {
+            return this.fail(`  The packaged documentation is incomplete; missing: ${missing.join(', ')}\n`);
+        }
+        const existed = existsSync(destination);
+        let isDirectory = false;
+        let isEmpty = true;
+        try {
+            isDirectory = existed && statSync(destination).isDirectory();
+            isEmpty = !isDirectory || readdirSync(destination).length === 0;
+        }
+        catch (error) {
+            return this.fail(`  Could not examine ${displayedDestination} (${ProjectIgnoreFile.showReason(error)}), so nothing was installed.\n`);
+        }
+        if (existed && !isDirectory) {
+            return this.fail(`  ${displayedDestination} exists but is not a directory.\n`);
+        }
+        // It may hold the user's own documents, so the advice is to choose
+        // another directory; deleting is only right for an earlier installation.
+        if (!isEmpty) {
+            return this.fail(`  ${displayedDestination} already exists and is not empty.\n` +
+                '  init installs into a new or empty directory, so choose another one.\n' +
+                '  If this is an earlier ECR installation, delete it and run init again\n' +
+                '  to install this version.\n');
+        }
+        const exclusion = ProjectIgnoreFile.readInstallExclusion(this.workingDirectory, destination);
+        if (exclusion.kind === 'invalid') {
+            return this.fail(`  Cannot install into ${displayedDestination}: ${exclusion.reason}.\n`);
+        }
+        const ignoreFile = new ProjectIgnoreFile(this.workingDirectory);
+        const currentIgnore = ignoreFile.read();
+        if (exclusion.kind === 'pattern' && currentIgnore.kind === 'unreadable') {
+            return this.fail(`  Could not read ${PROJECT_IGNORE_FILENAME} (${currentIgnore.reason}), so nothing was installed.\n`);
+        }
+        try {
+            mkdirSync(destination, { recursive: true });
+            for (const path of INSTALLED_DOCUMENTATION) {
+                cpSync(join(packageRoot, path), join(destination, path), { recursive: true, errorOnExist: true, force: false });
+            }
+        }
+        catch (error) {
+            const reason = ProjectIgnoreFile.showReason(error);
+            const cleanupFailure = this.removePartialInstallation(destination, existed);
+            if (cleanupFailure !== undefined) {
+                return this.fail(`  Could not install the documentation (${reason}), and could not remove\n` +
+                    `  what was copied (${cleanupFailure}). Delete ${displayedDestination} before running init again.\n`);
+            }
+            return this.fail(`  Could not install the documentation (${reason}), so nothing was installed.\n`);
+        }
+        let ignoreNote = `  ${displayedDestination} is outside this directory, so ${PROJECT_IGNORE_FILENAME} was not changed.\n`;
+        if (exclusion.kind === 'pattern') {
+            try {
+                ignoreNote = ignoreFile.addPattern(exclusion.pattern) === 'added'
+                    ? `  Added ${exclusion.pattern} to ${PROJECT_IGNORE_FILENAME}, so linting this project skips it.\n`
+                    : `  ${PROJECT_IGNORE_FILENAME} already excludes it (${exclusion.pattern}).\n`;
+            }
+            catch (error) {
+                return this.fail(`  Installed the documentation in ${displayedDestination}, but could not update ` +
+                    `${PROJECT_IGNORE_FILENAME} (${ProjectIgnoreFile.showReason(error)}).\n` +
+                    `  Add this line to ${PROJECT_IGNORE_FILENAME} yourself: ${exclusion.pattern}\n`);
+            }
+        }
+        // Success says where the documentation went, in a name the user gave,
+        // so it is made safe to print for the same reason a failure is.
+        return this.succeed(showControlCharacters(`\n  Installed the ECR documentation in ${displayedDestination}\n\n` +
+            `  Start with ${join(displayedDestination, 'README.md')}\n` +
+            `  Point your coding agent at ${join(displayedDestination, 'protocol', 'navigation-protocol.md')}\n` +
+            '  It is the half that does the navigating; the linter only checks structure.\n\n' +
+            `${ignoreNote}\n`));
+    }
+    /**
+     * Removes what a failed installation copied. The destination was new or
+     * empty, so nothing of the user's is inside it.
+     *
+     * @param destination - The installation directory
+     * @param existed - Whether it existed, empty, before installation began
+     * @returns Why removal failed, or `undefined` when everything copied was removed
+     */
+    removePartialInstallation(destination, existed) {
+        try {
+            if (!existed) {
+                rmSync(destination, { recursive: true, force: true });
+                return undefined;
+            }
+            for (const path of INSTALLED_DOCUMENTATION) {
+                rmSync(join(destination, path), { recursive: true, force: true });
+            }
+            return undefined;
+        }
+        catch (error) {
+            return ProjectIgnoreFile.showReason(error);
+        }
+    }
+    /**
+     * Reads how this invocation should bound its parsing, if at all.
+     *
+     * @returns The supervision settings, or `undefined` when this invocation does the work itself
+     */
+    readSupervision() {
+        // The child is this same executable, and must do the work rather than
+        // start a child of its own.
+        return process.env[SUPERVISED_VARIABLE] === '1' ? undefined : this.supervision;
+    }
+    /**
+     * Runs `lint` or `stats` in a child process with a time limit and a heap
+     * limit, and passes on what it produced.
+     *
+     * A child that had to be stopped produced no usable report, however much of
+     * one reached this process, so none of it is passed on: the invocation
+     * failed, and says why.
+     *
+     * @param settings - Where the child's script is, and any limits overriding the defaults
+     * @param argv - The arguments to pass on, exactly as they were given
+     * @param parsed - The same arguments, for the limits they carry
+     * @returns The child's output and exit code, or the reason it was stopped
+     */
+    runSupervised(settings, argv, parsed) {
+        // What the command line asked for wins; what the run was configured with
+        // stands where the command line said nothing; the defaults are the rest.
+        const limits = {
+            ...DEFAULT_SUPERVISION_LIMITS,
+            ...settings.limits,
+            ...(parsed.timeoutSeconds !== undefined ? { timeoutMs: parsed.timeoutSeconds * 1000 } : {}),
+            ...(parsed.maxMemoryMib !== undefined ? { memoryMib: parsed.maxMemoryMib } : {}),
+        };
+        const outcome = new Supervisor(settings.entryPoint, limits, this.workingDirectory).run(argv);
+        if (outcome.kind === 'stopped') {
+            return this.fail(`  ecr did not finish: ${outcome.reason}.\n`);
+        }
+        // Every code this command exits with means something. A child that ended
+        // with any other did not end as this command ends: it ran out of heap, or
+        // the runtime beneath it stopped. Passing such a code on would offer it
+        // as a verdict on the corpus, and on Windows as a number no caller could
+        // read.
+        if (!EXIT_CODES.includes(outcome.exitCode)) {
+            return this.fail(`  ecr did not finish: ${this.showAbnormalExit(outcome, limits)}.\n`);
+        }
+        // A verdict on a corpus comes with the report it is a verdict on. A child
+        // that exited 1 having printed nothing never got as far as validating,
+        // and passing that code on would read as a corpus full of errors.
+        if (outcome.stdout === '' && outcome.exitCode === EXIT_VALIDATION_FAILED) {
+            return this.fail(`  ecr did not finish: the run failed without producing a report.\n${outcome.stderr}`);
+        }
+        // A command writes to one stream per invocation, so whichever the child
+        // used is the one this process writes to.
+        return outcome.stdout === ''
+            ? { output: outcome.stderr, stream: 'stderr', exitCode: outcome.exitCode }
+            : { output: outcome.stdout, stream: 'stdout', exitCode: outcome.exitCode };
+    }
+    /**
+     * Describes a child that ended in a way this command never ends.
+     *
+     * Running out of heap is worth naming, because it is the one such ending a
+     * user can do anything about, and the limit that caused it is one they set.
+     *
+     * @param outcome - What the child produced before it ended
+     * @param limits - The limits it was given
+     * @returns The reason, as a phrase completing "ecr did not finish..."
+     */
+    showAbnormalExit(outcome, limits) {
+        if (HEAP_EXHAUSTED.test(outcome.stderr)) {
+            return (`it ran out of heap, limited to ${String(limits.memoryMib)} MiB. ` +
+                `Raise the limit with --max-memory <MiB>, or 0 for node's own default`);
+        }
+        return `the run ended unexpectedly (exit ${String(outcome.exitCode)})`;
+    }
+    /**
+     * Builds a successful outcome, written to stdout.
+     *
+     * @param output - The text to print
+     * @returns The outcome
+     */
+    succeed(output) {
+        return { output, stream: 'stdout', exitCode: EXIT_SUCCESS };
+    }
+    /**
+     * Builds the outcome of an invocation that could not run, written to stderr.
+     *
+     * @param output - The message to print
+     * @returns The outcome
+     */
+    fail(output) {
+        // A message names paths that came from the disk, so it is made safe to
+        // print for the same reason a report of a document's text is.
+        return { output: showControlCharacters(output), stream: 'stderr', exitCode: EXIT_USAGE_ERROR };
+    }
+    /**
+     * Reads the published package version from `package.json`.
+     *
+     * @returns The package version
+     */
+    showPackageVersion() {
+        const manifestText = readFileSync(join(this.packageRoot, 'package.json'), 'utf8');
+        const manifest = JSON.parse(manifestText);
+        return manifest.version;
+    }
+    /**
+     * Determines whether a corpus result contains any error-severity diagnostic.
+     *
+     * @param corpusResult - The result to inspect
+     * @returns `true` when at least one error was reported
+     */
+    tellCorpusHasErrors(corpusResult) {
+        for (const entry of corpusResult.documents) {
+            for (const diagnostic of entry.result.diagnostics) {
+                if (diagnostic.severity === 'error') {
+                    return true;
+                }
+            }
+        }
+        return corpusResult.diagnostics.some((diagnostic) => diagnostic.severity === 'error');
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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