@procedures/mark 0.0.0-stage → 0.2.0

package/dist/args.js

@@ -0,0 +1,351 @@
+/**
+ * Command Line Splitting
+ *
+ * Splits the argv of `mark` into the global flags, the command path, and the input of the
+ * procedure. The rules (deep dive CLI-7, CLI-9, CLI-10, CLI-11):
+ *
+ * - A flag before the command path is a global flag.
+ * - After the path, a flag is the procedure's when the procedure declares it (its field name, the
+ *   kebab-case name, or its short letter). Otherwise it is a global flag. Otherwise it is an error.
+ *   So `mark docker compose down -v` gives `-v` to the procedure, not to `--version`.
+ * - Each value is converted by the type of its field: a string field keeps its text.
+ * - A repeated array flag collects its values. A repeated record flag (`--env A=1 --env B=2`) merges.
+ * - A boolean flag takes `true`/`false` after it, or `--flag=false`, or `--no-flag`.
+ * - A negative number is a value, not a flag. `--` ends the flags.
+ * - The positional fields take the arguments in order. A last array field takes the rest.
+ *   An argument that no field takes is an error.
+ */
+import { findGlobalFlag } from "@procedures/lib/cli-flags";
+import { convertValue, fieldsOf, mergeValue, toCamel, toKebab, } from "./parse.js";
+const NEGATIVE_NUMBER = /^-(\d+\.?\d*|\.\d+)([eE][-+]?\d+)?$/;
+const ANY = { kind: "any" };
+/** A token that is a flag (not a value, not a negative number, not "-" alone) */
+function isFlag(token) {
+    return token.startsWith("-") && token !== "-" && !NEGATIVE_NUMBER.test(token);
+}
+/**
+ * Find a procedure matching the given path
+ */
+export function findProcedure(procedures, path) {
+    return procedures.find((p) => p.path.length === path.length && p.path.every((seg, i) => seg === path[i]));
+}
+/**
+ * Find procedures that are children of the given path
+ */
+export function findChildren(procedures, path) {
+    return procedures.filter((p) => p.path.length > path.length && path.every((seg, i) => seg === p.path[i]));
+}
+/**
+ * The flags a procedure declares: each field of its input schema (camelCase and kebab-case
+ * names) and the short letters of its metadata.
+ */
+export function procedureFlags(procedure) {
+    const meta = (procedure?.metadata ?? {});
+    const schemaFields = procedure ? fieldsOf(procedure) : [];
+    const fields = new Map(schemaFields.map((field) => [field.name, field.fieldType]));
+    const long = new Map();
+    const short = new Map();
+    const addLong = (field) => {
+        const spec = { field, type: fields.get(field) ?? ANY };
+        long.set(field, spec);
+        long.set(toKebab(field), spec);
+    };
+    for (const field of fields.keys()) {
+        addLong(field);
+    }
+    for (const [field, letter] of Object.entries(meta.shorts ?? {})) {
+        if (!long.has(field)) {
+            addLong(field);
+        }
+        short.set(letter, { field, type: fields.get(field) ?? ANY });
+    }
+    return { long, short, fields, typed: schemaFields.length > 0, meta };
+}
+/** The state of one pass over the tokens */
+class TokenReader {
+    tokens;
+    index = 0;
+    constructor(tokens) {
+        this.tokens = tokens;
+    }
+    get current() {
+        return this.tokens[this.index];
+    }
+    /** The value of a flag: the inline value, or the next token when it is not a flag */
+    takeValue(inline) {
+        if (inline !== undefined) {
+            return inline;
+        }
+        const next = this.tokens[this.index + 1];
+        if (next !== undefined && !isFlag(next)) {
+            this.index++;
+            return next;
+        }
+        return undefined;
+    }
+    /** The value of a boolean flag: the inline value, or a next token that is "true" or "false" */
+    takeBoolean(inline) {
+        if (inline !== undefined) {
+            return inline;
+        }
+        const next = this.tokens[this.index + 1];
+        if (next === "true" || next === "false") {
+            this.index++;
+            return next;
+        }
+        return undefined;
+    }
+}
+/** Split "--name=value" (or "-n=value") into the name and the inline value */
+function splitInline(body) {
+    const eq = body.indexOf("=");
+    return eq === -1 ? { name: body, inline: undefined } : { name: body.slice(0, eq), inline: body.slice(eq + 1) };
+}
+/** Read one global flag. Returns an error message, or undefined. */
+function readGlobal(flag, label, inline, reader, globals) {
+    const name = flag.long;
+    if (flag.takesValue) {
+        const value = reader.takeValue(inline);
+        if (value === undefined) {
+            return `${label} needs a value`;
+        }
+        globals[name] = value;
+        return undefined;
+    }
+    if (inline !== undefined && inline !== "true" && inline !== "false") {
+        return `${label} needs true or false, not "${inline}"`;
+    }
+    globals[name] = inline !== "false";
+    return undefined;
+}
+/**
+ * Read the global flags before the command path. This needs no procedures: `mark` reads them
+ * before it loads the procedures (`--version`, `--server`, `-i`).
+ */
+export function parseLeadingGlobals(argv) {
+    const globals = {};
+    const errors = [];
+    const reader = new TokenReader(argv);
+    for (; reader.index < argv.length; reader.index++) {
+        const token = reader.current;
+        if (!isFlag(token) || token === "--") {
+            break;
+        }
+        const isLong = token.startsWith("--");
+        const { name, inline } = splitInline(token.slice(isLong ? 2 : 1));
+        const flag = isLong || name.length === 1 ? findGlobalFlag(name, !isLong) : undefined;
+        if (!flag) {
+            errors.push(`Unknown option before the command: ${token}`);
+            continue;
+        }
+        const error = readGlobal(flag, isLong ? `--${name}` : `-${name}`, inline, reader, globals);
+        if (error) {
+            errors.push(error);
+        }
+    }
+    const rest = argv.slice(reader.index);
+    if (rest[0] === "--") {
+        rest.shift();
+    }
+    return { globals, rest, errors };
+}
+/**
+ * The command path at the start of the tokens: the longest run of words that names a procedure
+ * or a group of procedures. The first word is part of the path even when it names nothing (the
+ * command is then unknown).
+ */
+function readPath(tokens, procedures) {
+    const path = [];
+    for (const token of tokens) {
+        if (isFlag(token) || token === "--") {
+            break;
+        }
+        const testPath = [...path, token];
+        if (findProcedure(procedures, testPath)) {
+            path.push(token);
+            break;
+        }
+        if (findChildren(procedures, testPath).length > 0 || path.length === 0) {
+            path.push(token);
+            continue;
+        }
+        break;
+    }
+    return path;
+}
+/**
+ * Split a whole command line: global flags, the command path, and the procedure input
+ */
+export function parseCommandLine(argv, procedures) {
+    const leading = parseLeadingGlobals(argv);
+    const globals = leading.globals;
+    const errors = [...leading.errors];
+    const path = readPath(leading.rest, procedures);
+    const procedure = findProcedure(procedures, path);
+    const flags = procedureFlags(procedure);
+    const input = {};
+    const fromFlag = new Set();
+    const positionals = [];
+    const setField = (spec, text, label) => {
+        const converted = convertValue(text, spec.type, label);
+        if (!converted.ok) {
+            errors.push(converted.error);
+            return;
+        }
+        input[spec.field] = mergeValue(input[spec.field], converted.value, spec.type);
+        fromFlag.add(spec.field);
+    };
+    /** Read one procedure flag. Returns false when the procedure does not declare it. */
+    const readProcedureFlag = (spec, label, inline, reader) => {
+        if (!spec) {
+            return false;
+        }
+        if (spec.type.kind === "boolean") {
+            setField(spec, reader.takeBoolean(inline) ?? "true", label);
+            return true;
+        }
+        const value = reader.takeValue(inline);
+        if (value === undefined) {
+            errors.push(`${label} needs a value`);
+            return true;
+        }
+        setField(spec, value, label);
+        return true;
+    };
+    /** A flag that neither the procedure nor the globals have */
+    const readOther = (name, label, inline, reader) => {
+        if (procedure && !flags.typed) {
+            // The schema has no readable fields: pass the flag through, as JSON or text
+            const value = reader.takeValue(inline);
+            setField({ field: toCamel(name), type: ANY }, value ?? "true", label);
+            return;
+        }
+        const where = path.length > 0 ? ` for mark ${path.join(" ")}` : "";
+        errors.push(`Unknown option${where}: ${label}`);
+    };
+    const reader = new TokenReader(leading.rest);
+    reader.index = path.length;
+    let onlyPositionals = false;
+    for (; reader.index < leading.rest.length; reader.index++) {
+        const token = reader.current;
+        if (onlyPositionals || !isFlag(token)) {
+            positionals.push(token);
+            continue;
+        }
+        if (token === "--") {
+            onlyPositionals = true;
+            continue;
+        }
+        if (token.startsWith("--")) {
+            const { name, inline } = splitInline(token.slice(2));
+            const label = `--${name}`;
+            if (readProcedureFlag(flags.long.get(name), label, inline, reader)) {
+                continue;
+            }
+            // --no-<flag> sets a boolean field to false
+            const negated = name.startsWith("no-") ? flags.long.get(name.slice(3)) : undefined;
+            if (negated?.type.kind === "boolean") {
+                if (inline !== undefined) {
+                    errors.push(`${label} takes no value`);
+                }
+                else {
+                    setField(negated, "false", label);
+                }
+                continue;
+            }
+            const global = findGlobalFlag(name, false);
+            if (global) {
+                const error = readGlobal(global, label, inline, reader, globals);
+                if (error)
+                    errors.push(error);
+                continue;
+            }
+            readOther(name, label, inline, reader);
+            continue;
+        }
+        // Short flags: "-x", "-x=value", "-xvalue" (a flag with a value), or "-abc" (boolean flags)
+        const { name: body, inline } = splitInline(token.slice(1));
+        for (let k = 0; k < body.length; k++) {
+            const letter = body[k];
+            const label = `-${letter}`;
+            const last = k === body.length - 1;
+            const attached = last ? inline : body.slice(k + 1);
+            const spec = flags.short.get(letter);
+            const global = spec ? undefined : findGlobalFlag(letter, true);
+            const takesValue = spec ? spec.type.kind !== "boolean" : global?.takesValue === true;
+            if (!spec && !global) {
+                if (body.length === 1) {
+                    readOther(letter, label, inline, reader);
+                }
+                else {
+                    errors.push(`Unknown option ${label} in ${token}`);
+                }
+                break;
+            }
+            if (takesValue || last) {
+                // The rest of the token (or the next token) is the value of this flag
+                if (spec) {
+                    readProcedureFlag(spec, label, attached === "" ? undefined : attached, reader);
+                }
+                else {
+                    const error = readGlobal(global, label, attached === "" ? undefined : attached, reader, globals);
+                    if (error)
+                        errors.push(error);
+                }
+                break;
+            }
+            if (spec) {
+                setField(spec, "true", label);
+            }
+            else {
+                globals[global.long] = true;
+            }
+        }
+    }
+    // Positional fields take the arguments in order; a last array field takes the rest
+    const positionalFields = flags.meta.args ?? [];
+    let next = 0;
+    if (procedure) {
+        positionalFields.forEach((field, k) => {
+            if (next >= positionals.length) {
+                return;
+            }
+            const type = flags.fields.get(field) ?? ANY;
+            const many = type.kind === "array" && k === positionalFields.length - 1;
+            const texts = many ? positionals.slice(next) : [positionals[next]];
+            next += texts.length;
+            if (fromFlag.has(field)) {
+                errors.push(`${field} is given twice: as an argument and as --${toKebab(field)}`);
+                return;
+            }
+            let value;
+            if (many && texts.length > 1) {
+                const items = [];
+                for (const text of texts) {
+                    const converted = convertValue(text, type.item ?? ANY, field);
+                    if (!converted.ok) {
+                        errors.push(converted.error);
+                        return;
+                    }
+                    items.push(converted.value);
+                }
+                value = items;
+            }
+            else {
+                const converted = convertValue(texts[0], type, field);
+                if (!converted.ok) {
+                    errors.push(converted.error);
+                    return;
+                }
+                value = converted.value;
+            }
+            input[field] = value;
+        });
+    }
+    const extraArguments = positionals.slice(next);
+    if (procedure && extraArguments.length > 0) {
+        errors.push(`Unexpected argument${extraArguments.length > 1 ? "s" : ""} for mark ${path.join(" ")}: ${extraArguments.join(" ")}`);
+    }
+    return { path, procedure, input, globals, extraArguments, errors };
+}
+//# sourceMappingURL=args.js.map

package/dist/args.js.map

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

package/dist/ask.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Questions for missing arguments.
+ *
+ * When a person runs mark in a terminal and a required argument is missing, mark asks for it:
+ * the question shows the name, the type and the description of the field. mark does not ask
+ * when stdin or stdout is not a terminal, when the environment variable CI is set, with
+ * `--no-input`, or when the procedure sets `interactive: false` in its CLI metadata. Then a
+ * missing argument is an error of the input, as before.
+ */
+import { type CLIMeta, type SchemaFieldInfo } from "./parse.js";
+/** The answer to one question: the text of the person, or `cancelled` */
+export type Answer = {
+    value: unknown;
+} | {
+    cancelled: true;
+};
+/** A function that asks one question. Tests give a fake. */
+export type Asker = (field: SchemaFieldInfo, message: string) => Promise<Answer>;
+/** The terminal state that decides if mark can ask */
+export interface Terminal {
+    stdinIsTTY: boolean;
+    stdoutIsTTY: boolean;
+    env: Record<string, string | undefined>;
+}
+export declare function processTerminal(): Terminal;
+/** True when mark can ask for a missing argument */
+export declare function canAsk(noInput: boolean, meta: CLIMeta, terminal: Terminal): boolean;
+/** The required fields that the input does not give (a field with a default is not missing) */
+export declare function missingFields(fields: readonly SchemaFieldInfo[], input: Record<string, unknown>): SchemaFieldInfo[];
+/** The question of a field: its name, its type and its description */
+export declare function questionOf(field: SchemaFieldInfo): string;
+/** The result of the questions: the input with the answers, or the reason to stop */
+export type Asked = {
+    ok: true;
+    input: Record<string, unknown>;
+} | {
+    ok: false;
+    cancelled: boolean;
+    error: string;
+};
+/**
+ * Ask for each missing field, in order, and convert each answer by the type of its field. An
+ * array field takes the words of the answer.
+ */
+export declare function askMissing(missing: readonly SchemaFieldInfo[], input: Record<string, unknown>, ask: Asker): Promise<Asked>;
+/** The asker of the terminal: a yes/no question for a boolean, a choice for an enum, text otherwise */
+export declare const terminalAsker: Asker;
+//# sourceMappingURL=ask.d.ts.map

package/dist/ask.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ask.d.ts","sourceRoot":"","sources":["../src/ask.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAgB,KAAK,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAE9E,yEAAyE;AACzE,MAAM,MAAM,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,SAAS,EAAE,IAAI,CAAA;CAAE,CAAC;AAE9D,4DAA4D;AAC5D,MAAM,MAAM,KAAK,GAAG,CAAC,KAAK,EAAE,eAAe,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;AAEjF,sDAAsD;AACtD,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CACzC;AAED,wBAAgB,eAAe,IAAI,QAAQ,CAM1C;AAED,oDAAoD;AACpD,wBAAgB,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CASnF;AAED,+FAA+F;AAC/F,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,eAAe,EAAE,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,eAAe,EAAE,CAEnH;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAIzD;AAED,qFAAqF;AACrF,MAAM,MAAM,KAAK,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAC5C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,OAAO,EAAE,SAAS,eAAe,EAAE,EACnC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC9B,GAAG,EAAE,KAAK,GACT,OAAO,CAAC,KAAK,CAAC,CA+BhB;AAED,uGAAuG;AACvG,eAAO,MAAM,aAAa,EAAE,KAc3B,CAAC"}

package/dist/ask.js

@@ -0,0 +1,91 @@
+/**
+ * Questions for missing arguments.
+ *
+ * When a person runs mark in a terminal and a required argument is missing, mark asks for it:
+ * the question shows the name, the type and the description of the field. mark does not ask
+ * when stdin or stdout is not a terminal, when the environment variable CI is set, with
+ * `--no-input`, or when the procedure sets `interactive: false` in its CLI metadata. Then a
+ * missing argument is an error of the input, as before.
+ */
+import { convertValue } from "./parse.js";
+export function processTerminal() {
+    return {
+        stdinIsTTY: process.stdin.isTTY === true,
+        stdoutIsTTY: process.stdout.isTTY === true,
+        env: process.env,
+    };
+}
+/** True when mark can ask for a missing argument */
+export function canAsk(noInput, meta, terminal) {
+    if (noInput || meta.interactive === false) {
+        return false;
+    }
+    const ci = terminal.env["CI"];
+    if (ci !== undefined && ci !== "" && ci !== "false" && ci !== "0") {
+        return false;
+    }
+    return terminal.stdinIsTTY && terminal.stdoutIsTTY;
+}
+/** The required fields that the input does not give (a field with a default is not missing) */
+export function missingFields(fields, input) {
+    return fields.filter((field) => field.required && field.defaultValue === undefined && input[field.name] === undefined);
+}
+/** The question of a field: its name, its type and its description */
+export function questionOf(field) {
+    const many = field.fieldType.kind === "array" ? " (separate the values with spaces)" : "";
+    const description = field.description ? `: ${field.description}` : "";
+    return `${field.name} (${field.type})${description}${many}`;
+}
+/**
+ * Ask for each missing field, in order, and convert each answer by the type of its field. An
+ * array field takes the words of the answer.
+ */
+export async function askMissing(missing, input, ask) {
+    const result = { ...input };
+    for (const field of missing) {
+        const answer = await ask(field, questionOf(field));
+        if ("cancelled" in answer) {
+            return { ok: false, cancelled: true, error: "Cancelled" };
+        }
+        if (typeof answer.value !== "string") {
+            result[field.name] = answer.value;
+            continue;
+        }
+        const kind = field.fieldType.kind;
+        if (kind === "array") {
+            const words = answer.value.trim().split(/\s+/).filter((word) => word.length > 0);
+            const item = field.fieldType.item ?? { kind: "any" };
+            const values = [];
+            for (const word of words) {
+                const converted = convertValue(word, item, field.name);
+                if (!converted.ok)
+                    return { ok: false, cancelled: false, error: converted.error };
+                values.push(converted.value);
+            }
+            result[field.name] = values;
+            continue;
+        }
+        const converted = convertValue(answer.value, field.fieldType, field.name);
+        if (!converted.ok) {
+            return { ok: false, cancelled: false, error: converted.error };
+        }
+        result[field.name] = converted.value;
+    }
+    return { ok: true, input: result };
+}
+/** The asker of the terminal: a yes/no question for a boolean, a choice for an enum, text otherwise */
+export const terminalAsker = async (field, message) => {
+    const { prompts } = await import("./prompts.js");
+    let value;
+    if (field.fieldType.kind === "boolean") {
+        value = await prompts.confirm(message);
+    }
+    else if (field.fieldType.kind === "enum" && field.enumValues) {
+        value = await prompts.select(message, field.enumValues.map((option) => ({ value: option, label: option })));
+    }
+    else {
+        value = await prompts.text(message);
+    }
+    return prompts.isCancel(value) ? { cancelled: true } : { value };
+};
+//# sourceMappingURL=ask.js.map

package/dist/ask.js.map

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

package/dist/bin.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env node
+/**
+ * The `mark` executable.
+ *
+ * Importing `@procedures/mark` gives the functions and runs nothing (deep dive CLI-17).
+ * This file runs the CLI. `node dist/cli.js` also runs it, for the documented commands.
+ */
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

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

package/dist/bin.js

@@ -0,0 +1,10 @@
+#!/usr/bin/env node
+/**
+ * The `mark` executable.
+ *
+ * Importing `@procedures/mark` gives the functions and runs nothing (deep dive CLI-17).
+ * This file runs the CLI. `node dist/cli.js` also runs it, for the documented commands.
+ */
+import { main } from "./cli.js";
+await main(process.argv.slice(2));
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+/**
+ * Mark CLI
+ *
+ * A generic CLI that reflects registered procedures.
+ * Uses custom procedure-based routing with modern terminal utilities.
+ */
+import type { AnyProcedure } from "@procedures/client";
+import { type ManifestCommand } from "./manifest.js";
+import { type Asker, type Terminal } from "./ask.js";
+/**
+ * CLI execution context, created once and reused
+ */
+export interface CliContext {
+    client: InstanceType<typeof import("@procedures/client").Client>;
+    procedures: AnyProcedure[];
+    verbose: boolean;
+}
+/**
+ * The context of a run that starts from the manifest: the commands are known, the procedures
+ * are not loaded. `load()` loads them when the command runs in this process.
+ */
+export interface ManifestContext {
+    commands: readonly ManifestCommand[];
+    verbose: boolean;
+    load: () => Promise<CliContext>;
+}
+/** The terminal and the asker of the questions for missing arguments (tests give fakes) */
+export interface ExecuteOptions {
+    terminal?: Terminal;
+    ask?: Asker;
+}
+/**
+ * Initialize the CLI context (load ecosystem, create client)
+ * This is the expensive part (~4s). Call once, reuse many times.
+ */
+export declare function initCli(verbose?: boolean): Promise<CliContext>;
+/**
+ * Execute a single command given argv tokens.
+ * Reusable by both CLI entry point and REPL.
+ *
+ * The exit code is 1 for an unknown command, a problem of the command line, invalid input, a
+ * thrown error, and a result that reports a failure (`success: false`, or an `exitCode` that is
+ * not 0: see failure.ts). Before, all of these exited with 0 (deep dive CLI-8).
+ *
+ * With a ManifestContext, the help and a call to the CLI server need no procedures: they load
+ * only when the command runs in this process (roadmap 1.3).
+ */
+export declare function executeArgs(argv: string[], ctx: CliContext | ManifestContext, options?: ExecuteOptions): Promise<void>;
+/**
+ * Run the CLI
+ */
+declare function run(argv: string[]): Promise<void>;
+/**
+ * Run the CLI and report an error that escapes it as one line, with exit code 1. With
+ * `--verbose`, the stack follows. (Before, an error such as an invalid port showed only an
+ * unhandled-rejection stack: deep dive CLI-16.)
+ */
+export declare function main(argv: readonly string[]): Promise<void>;
+export { run };
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA;;;;;GAKG;AAGH,OAAO,KAAK,EAAU,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAK/D,OAAO,EAAoC,KAAK,eAAe,EAAE,MAAM,eAAe,CAAC;AACvF,OAAO,EAAqE,KAAK,KAAK,EAAE,KAAK,QAAQ,EAAE,MAAM,UAAU,CAAC;AAmIxH;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,YAAY,CAAC,cAAc,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACjE,UAAU,EAAE,YAAY,EAAE,CAAC;IAC3B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IACrC,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;CACjC;AAED,2FAA2F;AAC3F,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB,GAAG,CAAC,EAAE,KAAK,CAAC;CACb;AAED;;;GAGG;AACH,wBAAsB,OAAO,CAAC,OAAO,UAAQ,GAAG,OAAO,CAAC,UAAU,CAAC,CAelE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,WAAW,CAC/B,IAAI,EAAE,MAAM,EAAE,EACd,GAAG,EAAE,UAAU,GAAG,eAAe,EACjC,OAAO,GAAE,cAAmB,GAC3B,OAAO,CAAC,IAAI,CAAC,CAmNf;AAuDD;;GAEG;AACH,iBAAe,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgFhD;AAED;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAUjE;AA0BD,OAAO,EAAE,GAAG,EAAE,CAAC"}