@assemora/cli 0.1.0

package/dist/config.js

@@ -0,0 +1,156 @@
+/**
+ * `assemora.config.ts` — how the CLI finds the project (SPEC.md §79, ADR-0021).
+ *
+ * The config is the whole of the CLI's knowledge of an application. It hands back an
+ * application the CLI boots itself, and every path it declares is relative to the
+ * config file rather than to whatever directory the command was typed in, so
+ * `assemora db:migrate` means the same thing from `src/` as it does from the root.
+ *
+ * Node 24 strips TypeScript types natively, so a `.ts` config is imported directly:
+ * no transpiler, no dependency, and the file the developer edits is the file that
+ * runs.
+ */
+import { stat } from 'node:fs/promises';
+import { dirname, join, resolve as resolvePath } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { AssemoraError, ConfigurationError } from '@assemora/core';
+/**
+ * Identity, plus types.
+ *
+ * It exists so that the object is checked where it is written, which is the only
+ * place a mistake in it is cheap to fix.
+ */
+export const defineConfig = (config) => config;
+/** In the order they are looked for, in each directory, on the way up. */
+export const CONFIG_FILENAMES = ['assemora.config.ts', 'assemora.config.js'];
+export const DEFAULT_PATHS = {
+    source: 'src',
+    migrations: 'database/migrations',
+    generated: '.assemora/generated',
+};
+const isRecord = (value) => typeof value === 'object' && value !== null;
+const isFile = async (path) => {
+    try {
+        return (await stat(path)).isFile();
+    }
+    catch {
+        return false;
+    }
+};
+const findConfig = async (from) => {
+    let directory = from;
+    for (;;) {
+        for (const name of CONFIG_FILENAMES) {
+            const candidate = join(directory, name);
+            if (await isFile(candidate))
+                return candidate;
+        }
+        const parent = dirname(directory);
+        if (parent === directory)
+            return undefined;
+        directory = parent;
+    }
+};
+/** Every complaint names the file and the field, because that is where the fix goes. */
+const invalid = (file, field, expected) => new ConfigurationError(`${file}: "${field}" ${expected}`);
+const optionalString = (value, file, field) => {
+    if (value === undefined)
+        return undefined;
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw invalid(file, field, 'must be a non-empty path');
+    }
+    return value;
+};
+const optionalRecord = (value, file, field) => {
+    if (value === undefined)
+        return undefined;
+    if (!isRecord(value))
+        throw invalid(file, field, 'must be an object');
+    return value;
+};
+const requiredString = (value, file, field) => {
+    if (typeof value !== 'string' || value.trim() === '') {
+        throw invalid(file, field, 'must be a non-empty string');
+    }
+};
+/**
+ * Checks the shape of the default export.
+ *
+ * A config is ordinary TypeScript that ran a moment ago, so nothing here can be
+ * trusted to be what it claims. What survives this is cast once, deliberately, and
+ * that cast is the only place the declared type meets the imported value.
+ */
+const validate = (imported, file) => {
+    if (!isRecord(imported) || imported.default === undefined) {
+        throw new ConfigurationError(`${file} has no default export. It must \`export default defineConfig({ app: … })\`.`);
+    }
+    const declared = imported.default;
+    if (!isRecord(declared)) {
+        throw new ConfigurationError(`${file}: the default export must be the object defineConfig() returns`);
+    }
+    if (typeof declared.app !== 'function') {
+        throw invalid(file, 'app', "must be a function returning the application, for example: app: () => import('./src/app.ts').then((module) => module.createApp())");
+    }
+    optionalString(declared.server, file, 'server');
+    const paths = optionalRecord(declared.paths, file, 'paths');
+    if (paths !== undefined) {
+        optionalString(paths.source, file, 'paths.source');
+        optionalString(paths.migrations, file, 'paths.migrations');
+        optionalString(paths.generated, file, 'paths.generated');
+    }
+    const openapi = optionalRecord(declared.openapi, file, 'openapi');
+    if (openapi !== undefined) {
+        optionalString(openapi.out, file, 'openapi.out');
+        const info = optionalRecord(openapi.info, file, 'openapi.info');
+        if (info !== undefined) {
+            requiredString(info.title, file, 'openapi.info.title');
+            requiredString(info.version, file, 'openapi.info.version');
+        }
+    }
+    const sdk = optionalRecord(declared.sdk, file, 'sdk');
+    if (sdk !== undefined) {
+        optionalString(sdk.out, file, 'sdk.out');
+        optionalString(sdk.clientModule, file, 'sdk.clientModule');
+    }
+    return declared;
+};
+/**
+ * Finds the project's config, walking up from `cwd`, and validates it.
+ *
+ * Walking up is what lets a command be typed from anywhere inside the project, which
+ * is how every other tool a developer already has behaves.
+ */
+export const loadConfig = async (cwd) => {
+    const from = resolvePath(cwd);
+    const file = await findConfig(from);
+    if (file === undefined) {
+        throw new ConfigurationError(`No ${CONFIG_FILENAMES.join(' or ')} in ${from} or any directory above it. ` +
+            'Run the command inside an Assemora project, or create one with `assemora new`.');
+    }
+    let imported;
+    try {
+        imported = await import(pathToFileURL(file).href);
+    }
+    catch (error) {
+        // The cause carries the real stack — a syntax error points at their line, not
+        // ours — and `run --debug` walks it.
+        throw new AssemoraError('CONFIGURATION_ERROR', `${file} could not be imported: ${error instanceof Error ? error.message : String(error)}`, { cause: error });
+    }
+    const config = validate(imported, file);
+    const root = dirname(file);
+    const resolve = (path) => resolvePath(root, path);
+    const declared = config.paths ?? {};
+    return {
+        config,
+        file,
+        root,
+        paths: {
+            source: resolve(declared.source ?? DEFAULT_PATHS.source),
+            migrations: resolve(declared.migrations ?? DEFAULT_PATHS.migrations),
+            generated: resolve(declared.generated ?? DEFAULT_PATHS.generated),
+        },
+        server: config.server === undefined ? undefined : resolve(config.server),
+        resolve,
+    };
+};
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,19 @@
+import './commands/index.js';
+import { type CliCommand } from './registry.js';
+export { type AssemoraConfig, type AssemoraPaths, defineConfig, type LoadedConfig, type ResolvedPaths, } from './config.js';
+export type RunOptions = {
+    /** Where the command runs. Defaults to `process.cwd()`. */
+    readonly cwd?: string;
+    /** What `--version` prints. Defaults to the version of this package. */
+    readonly version?: string;
+    /** The command table. Defaults to everything the groups registered. */
+    readonly commands?: readonly CliCommand[];
+};
+/**
+ * Resolves one invocation and returns its exit code.
+ *
+ * It never calls `process.exit`: a test drives it in-process, and a command that has
+ * written to a pipe needs the process to flush before it leaves.
+ */
+export declare const run: (argv: readonly string[], options?: RunOptions) => Promise<number>;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAeA,OAAO,qBAAqB,CAAA;AAG5B,OAAO,EAAE,KAAK,UAAU,EAAiD,MAAM,eAAe,CAAA;AAE9F,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,YAAY,EACZ,KAAK,YAAY,EACjB,KAAK,aAAa,GACnB,MAAM,aAAa,CAAA;AAEpB,MAAM,MAAM,UAAU,GAAG;IACvB,2DAA2D;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAA;IACrB,wEAAwE;IACxE,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,SAAS,UAAU,EAAE,CAAA;CAC1C,CAAA;AAkFD;;;;;GAKG;AACH,eAAO,MAAM,GAAG,SAAgB,SAAS,MAAM,EAAE,YAAW,UAAU,KAAQ,OAAO,CAAC,MAAM,CAyC3F,CAAA"}

package/dist/index.js

@@ -0,0 +1,133 @@
+/**
+ * `@assemora/cli` — the front door (SPEC.md §77, ADR-0021).
+ *
+ * The CLI is one more client of the application layer. It never imports a feature
+ * package and never reaches a database on its own: it loads the project's
+ * `assemora.config.ts`, boots the application that config hands back, and asks it
+ * questions through the Schema Registry and the Query Bus — the same two doors
+ * Studio and an agent use.
+ *
+ * `run()` returns the exit code instead of taking the process down with it, so the
+ * whole CLI is drivable from a test. `bin.ts` is what exits.
+ */
+import { readFile } from 'node:fs/promises';
+import { bool, parseArgs } from './args.js';
+import './commands/index.js';
+import { detail, fail, line } from './output.js';
+import { shutdown } from './project.js';
+import { commandHelpText, helpText, registeredCommands } from './registry.js';
+export { defineConfig, } from './config.js';
+const UNKNOWN_VERSION = '0.0.0-unknown';
+/**
+ * Read rather than compiled in, so that a published build reports its own version
+ * and a checkout reports the one in the repository.
+ */
+const declaredVersion = async () => {
+    try {
+        const manifest = JSON.parse(await readFile(new URL('../package.json', import.meta.url), 'utf8'));
+        const version = typeof manifest === 'object' && manifest !== null
+            ? manifest.version
+            : undefined;
+        return typeof version === 'string' ? version : UNKNOWN_VERSION;
+    }
+    catch {
+        return UNKNOWN_VERSION;
+    }
+};
+const messageOf = (error) => error instanceof Error ? error.message : String(error);
+/** The console methods that write to stdout, which is the stream the answer owns. */
+const LOGGING = ['log', 'info', 'debug'];
+/**
+ * Keeps stdout for the answer, for as long as this invocation lasts.
+ *
+ * `@assemora/core`'s logger writes info records with `console.log`, and every command
+ * that inspects an application boots one — so `assemora routes --json | jq` was handed
+ * a boot record before the JSON, and `assemora api:openapi --stdout > openapi.json`
+ * wrote a file that was not a document. The CLI cannot reach into the logger: the
+ * project's config builds the application, and `logger` is its option to pass. What
+ * the CLI does own is what stdout means for one invocation, and this is that: anything
+ * that is not the answer goes to stderr, which is the rule the whole of `output.ts` is
+ * written to.
+ *
+ * The REPL is unaffected — it writes to its own stream — though a `console.log` typed
+ * inside it lands on stderr, where a terminal shows it just the same.
+ *
+ * It is put back afterwards because `run()` is called in process, by `assemora new`
+ * running two commands and by every test in this package.
+ */
+const keepStdoutForTheAnswer = () => {
+    const original = LOGGING.map((name) => [name, console[name]]);
+    for (const [name] of original) {
+        console[name] = (...values) => {
+            console.error(...values);
+        };
+    }
+    return () => {
+        for (const [name, method] of original)
+            console[name] = method;
+    };
+};
+/** The stack and every cause below it — what `--debug` is for. */
+const reportStack = (error) => {
+    let current = error;
+    while (current instanceof Error) {
+        detail(current.stack ?? `${current.name}: ${current.message}`);
+        current = current.cause;
+    }
+};
+const close = async (debug) => {
+    try {
+        await shutdown();
+    }
+    catch (error) {
+        // Failing to close is not what the command was asked to do, so it must not
+        // change the exit code. It is still worth saying when somebody is looking.
+        if (debug)
+            detail(`The application did not shut down cleanly: ${messageOf(error)}`);
+    }
+};
+/**
+ * Resolves one invocation and returns its exit code.
+ *
+ * It never calls `process.exit`: a test drives it in-process, and a command that has
+ * written to a pipe needs the process to flush before it leaves.
+ */
+export const run = async (argv, options = {}) => {
+    const args = parseArgs(argv);
+    const commands = options.commands ?? registeredCommands();
+    const debug = bool(args, 'debug');
+    const restoreConsole = keepStdoutForTheAnswer();
+    try {
+        if (bool(args, 'version')) {
+            line(options.version ?? (await declaredVersion()));
+            return 0;
+        }
+        // No command at all is a question, not a mistake: the answer is the list.
+        if (args.command === undefined) {
+            line(helpText(commands));
+            return 0;
+        }
+        const command = commands.find((entry) => entry.name === args.command);
+        if (command === undefined) {
+            fail(`Unknown command "${args.command}". Run \`assemora --help\` to see what there is.`);
+            return 2;
+        }
+        if (bool(args, 'help') || bool(args, 'h')) {
+            line(commandHelpText(command));
+            return 0;
+        }
+        return await command.handler({ args, cwd: options.cwd ?? process.cwd() });
+    }
+    catch (error) {
+        fail(messageOf(error));
+        if (debug)
+            reportStack(error);
+        return 1;
+    }
+    finally {
+        // Shutting down is still the application talking, so the redirect outlives it.
+        await close(debug);
+        restoreConsole();
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Writing to a terminal (SPEC.md §77).
+ *
+ * Two rules run through everything here. Anything that is not the answer — a
+ * warning, an error, a stack — goes to stderr, so `assemora api:openapi --stdout`
+ * and `assemora routes --json` stay pipeable. And terminal formatting is for a
+ * terminal: colour needs a TTY with `NO_COLOR` unset, and column alignment needs a
+ * TTY at all, because a pipe wants the data rather than the padding.
+ *
+ * The write target is a module-level seam rather than a parameter every command
+ * would have to thread. `captureOutput()` is what a test installs in its place.
+ */
+/** What this module writes to. `process.stdout` and `process.stderr` satisfy it. */
+export type OutputStream = {
+    write(text: string): unknown;
+    readonly isTTY?: boolean;
+    readonly columns?: number;
+};
+export type OutputTarget = {
+    readonly stdout: OutputStream;
+    readonly stderr: OutputStream;
+};
+/** Sends output somewhere else. Tests use `captureOutput()`; this is the raw seam. */
+export declare const useOutput: (next: OutputTarget) => void;
+export declare const resetOutput: () => void;
+export type CapturedOutput = {
+    /** Everything written to stdout so far. */
+    readonly stdout: string;
+    /** Everything written to stderr so far. */
+    readonly stderr: string;
+    restore(): void;
+};
+/**
+ * Records output instead of printing it.
+ *
+ * `tty` decides whether the captured run believes it is talking to a terminal, so a
+ * test can assert both the aligned form and the piped one; it defaults to `false`,
+ * which is the form assertions are written against.
+ */
+export declare const captureOutput: (options?: {
+    readonly tty?: boolean;
+    readonly width?: number;
+}) => CapturedOutput;
+declare const CODES: {
+    readonly bold: '\u001B[1m';
+    readonly dim: '\u001B[2m';
+    readonly red: '\u001B[31m';
+    readonly green: '\u001B[32m';
+    readonly yellow: '\u001B[33m';
+    readonly cyan: '\u001B[36m';
+};
+export type StyleName = keyof typeof CODES;
+/**
+ * Colour for text a command writes to stdout itself.
+ *
+ * Each call asks at the moment it is made, so installing a capture target before it
+ * runs is enough to turn colour off — nothing is decided at import time.
+ */
+export declare const style: Readonly<Record<StyleName, (text: string) => string>>;
+/** One line to stdout. This is the answer; everything else is commentary. */
+export declare const line: (text?: string) => void;
+/** A line that reports success. */
+export declare const ok: (text: string) => void;
+/**
+ * Something the command did anyway, and the reader has to know about — a
+ * destructive column drop, a skipped file (SPEC.md §34).
+ *
+ * The `warning:` word is not decoration: it is the only part of the classification
+ * that survives colour being unavailable.
+ */
+export declare const warn: (text: string) => void;
+/** Something the command did not do. */
+export declare const fail: (text: string) => void;
+/** Secondary context on stderr — a stack under `--debug`, a hint under an error. */
+export declare const detail: (text: string) => void;
+/** The `--json` half of every listing. Two-space indent, because a human reads it too. */
+export declare const json: (value: unknown) => void;
+export type Column<Row> = {
+    readonly header: string;
+    readonly value: (row: Row) => string;
+    readonly align?: 'left' | 'right';
+};
+/**
+ * A listing, as a grid.
+ *
+ * A long cell is truncated rather than wrapped. A wrapped cell turns a forty-row
+ * listing into a paragraph and destroys the one thing a grid is for — reading down a
+ * column — and nothing is lost by it, because every listing also answers `--json`,
+ * which is what the next command in the pipe wanted anyway (ADR-0021).
+ *
+ * No rows means no output. An empty grid says less than the sentence the command can
+ * write instead, so the command writes it.
+ */
+export declare const table: <Row>(rows: readonly Row[], columns: readonly Column<Row>[]) => void;
+export {};
+//# sourceMappingURL=output.d.ts.map

package/dist/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,oFAAoF;AACpF,MAAM,MAAM,YAAY,GAAG;IACzB,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAA;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B,CAAA;AAED,MAAM,MAAM,YAAY,GAAG;IACzB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAC9B,CAAA;AAMD,sFAAsF;AACtF,eAAO,MAAM,SAAS,SAAU,YAAY,KAAG,IAE9C,CAAA;AAED,eAAO,MAAM,WAAW,QAAO,IAE9B,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,OAAO,IAAI,IAAI,CAAA;CAChB,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,aACf;IAAE,QAAQ,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,KAC3D,cAwBF,CAAA;AAID,QAAA,MAAM,KAAK;aACT,IAAI,EAAE,WAAW;aACjB,GAAG,EAAE,WAAW;aAChB,GAAG,EAAE,YAAY;aACjB,KAAK,EAAE,YAAY;aACnB,MAAM,EAAE,YAAY;aACpB,IAAI,EAAE,YAAY;CACV,CAAA;AAEV,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,KAAK,CAAA;AAY1C;;;;;GAKG;AACH,eAAO,MAAM,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC,CAOvE,CAAA;AAED,6EAA6E;AAC7E,eAAO,MAAM,IAAI,qBAAgB,IAEhC,CAAA;AAED,mCAAmC;AACnC,eAAO,MAAM,EAAE,SAAU,MAAM,KAAG,IAEjC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,IAAI,SAAU,MAAM,KAAG,IAEnC,CAAA;AAED,wCAAwC;AACxC,eAAO,MAAM,IAAI,SAAU,MAAM,KAAG,IAEnC,CAAA;AAED,oFAAoF;AACpF,eAAO,MAAM,MAAM,SAAU,MAAM,KAAG,IAErC,CAAA;AAED,0FAA0F;AAC1F,eAAO,MAAM,IAAI,UAAW,OAAO,KAAG,IAErC,CAAA;AAED,MAAM,MAAM,MAAM,CAAC,GAAG,IAAI;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,MAAM,CAAA;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAClC,CAAA;AA4CD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,KAAK,GAAI,GAAG,QAAQ,SAAS,GAAG,EAAE,WAAW,SAAS,MAAM,CAAC,GAAG,CAAC,EAAE,KAAG,IAuClF,CAAA"}

package/dist/output.js

@@ -0,0 +1,181 @@
+/**
+ * Writing to a terminal (SPEC.md §77).
+ *
+ * Two rules run through everything here. Anything that is not the answer — a
+ * warning, an error, a stack — goes to stderr, so `assemora api:openapi --stdout`
+ * and `assemora routes --json` stay pipeable. And terminal formatting is for a
+ * terminal: colour needs a TTY with `NO_COLOR` unset, and column alignment needs a
+ * TTY at all, because a pipe wants the data rather than the padding.
+ *
+ * The write target is a module-level seam rather than a parameter every command
+ * would have to thread. `captureOutput()` is what a test installs in its place.
+ */
+const processTarget = () => ({ stdout: process.stdout, stderr: process.stderr });
+let target = processTarget();
+/** Sends output somewhere else. Tests use `captureOutput()`; this is the raw seam. */
+export const useOutput = (next) => {
+    target = next;
+};
+export const resetOutput = () => {
+    target = processTarget();
+};
+/**
+ * Records output instead of printing it.
+ *
+ * `tty` decides whether the captured run believes it is talking to a terminal, so a
+ * test can assert both the aligned form and the piped one; it defaults to `false`,
+ * which is the form assertions are written against.
+ */
+export const captureOutput = (options = {}) => {
+    const previous = target;
+    const out = [];
+    const err = [];
+    const stream = (sink) => ({
+        write: (text) => sink.push(text),
+        isTTY: options.tty ?? false,
+        columns: options.width ?? 80,
+    });
+    target = { stdout: stream(out), stderr: stream(err) };
+    return {
+        get stdout() {
+            return out.join('');
+        },
+        get stderr() {
+            return err.join('');
+        },
+        restore: () => {
+            target = previous;
+        },
+    };
+};
+const RESET = '\u001b[0m';
+const CODES = {
+    bold: '\u001b[1m',
+    dim: '\u001b[2m',
+    red: '\u001b[31m',
+    green: '\u001b[32m',
+    yellow: '\u001b[33m',
+    cyan: '\u001b[36m',
+};
+/**
+ * `NO_COLOR` set to anything non-empty turns colour off everywhere, which is the
+ * whole of https://no-color.org — the value is never inspected.
+ */
+const colourAllowed = (stream) => stream.isTTY === true && (process.env.NO_COLOR ?? '') === '';
+const paint = (stream, name, text) => colourAllowed(stream) ? `${CODES[name]}${text}${RESET}` : text;
+/**
+ * Colour for text a command writes to stdout itself.
+ *
+ * Each call asks at the moment it is made, so installing a capture target before it
+ * runs is enough to turn colour off — nothing is decided at import time.
+ */
+export const style = {
+    bold: (text) => paint(target.stdout, 'bold', text),
+    dim: (text) => paint(target.stdout, 'dim', text),
+    red: (text) => paint(target.stdout, 'red', text),
+    green: (text) => paint(target.stdout, 'green', text),
+    yellow: (text) => paint(target.stdout, 'yellow', text),
+    cyan: (text) => paint(target.stdout, 'cyan', text),
+};
+/** One line to stdout. This is the answer; everything else is commentary. */
+export const line = (text = '') => {
+    target.stdout.write(`${text}\n`);
+};
+/** A line that reports success. */
+export const ok = (text) => {
+    target.stdout.write(`${paint(target.stdout, 'green', text)}\n`);
+};
+/**
+ * Something the command did anyway, and the reader has to know about — a
+ * destructive column drop, a skipped file (SPEC.md §34).
+ *
+ * The `warning:` word is not decoration: it is the only part of the classification
+ * that survives colour being unavailable.
+ */
+export const warn = (text) => {
+    target.stderr.write(`${paint(target.stderr, 'yellow', `warning: ${text}`)}\n`);
+};
+/** Something the command did not do. */
+export const fail = (text) => {
+    target.stderr.write(`${paint(target.stderr, 'red', `error: ${text}`)}\n`);
+};
+/** Secondary context on stderr — a stack under `--debug`, a hint under an error. */
+export const detail = (text) => {
+    target.stderr.write(`${paint(target.stderr, 'dim', text)}\n`);
+};
+/** The `--json` half of every listing. Two-space indent, because a human reads it too. */
+export const json = (value) => {
+    target.stdout.write(`${JSON.stringify(value, null, 2)}\n`);
+};
+const GAP = '  ';
+/** Below this a truncated column shows more ellipsis than content. */
+const MIN_WIDTH = 6;
+const cellText = (text) => text.replace(/[\r\n\t]+/g, ' ');
+const truncate = (text, width) => text.length <= width ? text : `${text.slice(0, Math.max(width - 1, 0))}…`;
+const pad = (text, width, align) => align === 'right' ? text.padStart(width) : text.padEnd(width);
+/**
+ * Shrinks the widest column, one character at a time, until the row fits.
+ *
+ * Taking it off the widest column is what keeps a listing readable: an over-long
+ * description loses characters while the name and the method beside it keep all of
+ * theirs, which is the opposite of what shrinking everything proportionally does.
+ */
+const fit = (widths, available) => {
+    const fitted = [...widths];
+    const gaps = GAP.length * Math.max(fitted.length - 1, 0);
+    let total = fitted.reduce((sum, width) => sum + width, 0) + gaps;
+    while (total > available) {
+        let widest = 0;
+        for (let index = 1; index < fitted.length; index += 1) {
+            if ((fitted[index] ?? 0) > (fitted[widest] ?? 0))
+                widest = index;
+        }
+        if ((fitted[widest] ?? 0) <= MIN_WIDTH)
+            break;
+        fitted[widest] = (fitted[widest] ?? 0) - 1;
+        total -= 1;
+    }
+    return fitted;
+};
+/**
+ * A listing, as a grid.
+ *
+ * A long cell is truncated rather than wrapped. A wrapped cell turns a forty-row
+ * listing into a paragraph and destroys the one thing a grid is for — reading down a
+ * column — and nothing is lost by it, because every listing also answers `--json`,
+ * which is what the next command in the pipe wanted anyway (ADR-0021).
+ *
+ * No rows means no output. An empty grid says less than the sentence the command can
+ * write instead, so the command writes it.
+ */
+export const table = (rows, columns) => {
+    if (rows.length === 0 || columns.length === 0)
+        return;
+    const header = columns.map((column) => cellText(column.header));
+    const body = rows.map((row) => columns.map((column) => cellText(column.value(row))));
+    const aligned = target.stdout.isTTY === true;
+    if (!aligned) {
+        // Piped: the separator is all the structure a reader downstream can use, and
+        // padding a column to a width nobody can see only adds trailing whitespace.
+        target.stdout.write(`${[header, ...body].map((cells) => cells.join(GAP)).join('\n')}\n`);
+        return;
+    }
+    const natural = columns.map((_, index) => Math.max(header[index]?.length ?? 0, ...body.map((cells) => cells[index]?.length ?? 0)));
+    const available = typeof target.stdout.columns === 'number' ? target.stdout.columns : 80;
+    const widths = fit(natural, available);
+    const render = (cells) => cells
+        .map((cell, index) => {
+        const width = widths[index] ?? cell.length;
+        const shown = truncate(cell, width);
+        // The last column is never padded: trailing spaces are invisible until
+        // somebody copies the line out of the terminal.
+        return index === cells.length - 1 && (columns[index]?.align ?? 'left') === 'left'
+            ? shown
+            : pad(shown, width, columns[index]?.align ?? 'left');
+    })
+        .join(GAP);
+    target.stdout.write(`${paint(target.stdout, 'dim', render(header))}\n`);
+    for (const cells of body)
+        target.stdout.write(`${render(cells)}\n`);
+};
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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