@duyquangnvx/agent-cli 0.27.0 → 0.28.0

package/dist/context.d.ts

@@ -36,6 +36,8 @@ export type NoNeeds = Needs<never, NoErrors, never>;
 export interface Context<Ports = unknown, Settings = unknown, Declared extends Needs = NoNeeds> {
     readonly cwd: string;
     readonly env: Env;
+    /** The platform the run is on: `process.platform`, or the `platform` a test passed to `runCli`. */
+    readonly platform: NodeJS.Platform;
     /** The CLI's version, as `--version` prints it. */
     readonly version: string;
     /** The bundler's stamp, as `--version` prints it; absent when the CLI runs unbundled. */
@@ -179,7 +181,7 @@ export interface PortsBase extends PortsBaseOfContext {
      */
     secret(name: string): Secret | undefined;
 }
-type PortsBaseOfContext = Pick<Context, "env" | "cwd" | "packageRoot" | "envFile" | "spawn" | "spawnDetached" | "files" | "clock" | "signal" | "progress" | "version" | "build" | "self" | "fileError">;
+type PortsBaseOfContext = Pick<Context, "env" | "platform" | "cwd" | "packageRoot" | "envFile" | "spawn" | "spawnDetached" | "files" | "clock" | "signal" | "progress" | "version" | "build" | "self" | "fileError">;
 export interface Project<Settings = unknown> {
     /** The folder holding the Project file. */
     readonly root: string;

package/dist/define-command.d.ts

@@ -4,6 +4,9 @@ import type { Needs } from "./context.js";
 import type { ActCommand, Command, DestructiveCommand, InputSchema, ListCommand, NoInput, ReadCommand, SecretDeclaration, ServeCommand, WriteCommand } from "./define.js";
 import type { ErrorTable, NoErrors } from "./error-table.js";
 import type { RowSchema } from "./list.js";
+import { type DeclaredRuntimeErrors } from "./runtime-codes.js";
+/** The codes a Command may declare in `errors`: the CLI's table and the Runtime's that only some Commands reach. */
+type Declarable<Table extends ErrorTable> = Table & DeclaredRuntimeErrors;
 type Kebab<Key extends string> = Key extends `${infer Head}${infer Tail}` ? `${Head extends Lowercase<Head> ? Head : `-${Lowercase<Head>}`}${Kebab<Tail>}` : Key;
 type Taken<Schema extends InputSchema> = Extract<Kebab<Extract<keyof Schema["shape"], string>>, StandardFlagName>;
 type Unreserved<Schema extends InputSchema> = [Taken<Schema>] extends [never] ? unknown : {
@@ -27,7 +30,9 @@ type NeededName<Secrets extends readonly SecretDeclaration[]> = Exclude<Secrets[
 type OptionalName<Secrets extends readonly SecretDeclaration[]> = Extract<Secrets[number], {
     readonly optional: true;
 }>["name"];
-type NeedsOf<Secrets extends readonly SecretDeclaration[], Errors extends ErrorTable> = Needs<NeededName<Secrets>, Errors, OptionalName<Secrets>>;
+type DeclarableCode<Table extends ErrorTable> = keyof Declarable<Table> & string;
+/** The `ctx` needs of a Command declaring `Secrets` and, of the codes it may declare, `Code`. */
+type Needed<Secrets extends readonly SecretDeclaration[], Table extends ErrorTable, Code extends DeclarableCode<Table>> = Needs<NeededName<Secrets>, Pick<Declarable<Table>, Code>, OptionalName<Secrets>>;
 type DeclaredSecrets<Secrets extends readonly SecretDeclaration[]> = {
     readonly secrets?: Secrets;
 } & NoInfer<string extends Secrets[number]["name"] ? {
@@ -37,20 +42,22 @@ type DeclaredSecrets<Secrets extends readonly SecretDeclaration[]> = {
 } : unknown>;
 /** Declares a Command whose `ctx.ports` is the CLI's `Ports`. */
 export interface DefineCommand<Ports, Settings = unknown, Table extends ErrorTable = NoErrors> {
-    <Row extends RowSchema, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: ListCommand<Args, Options, Row, Ports, Settings, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ListCommand<Args, Options, Row, Ports, Settings, NeedsOf<Secrets, Pick<Table, Code>>>;
-    <Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: ReadCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ReadCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema>;
-    <Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: ReadCommand<Args, Options, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ReadCommand<Args, Options, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput;
-    <Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: ActCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ActCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema>;
-    <Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: ActCommand<Args, Options, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ActCommand<Args, Options, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput;
-    <Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: ServeCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ServeCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema>;
-    <Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: ServeCommand<Args, Options, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ServeCommand<Args, Options, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput;
-    <Plan, Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: WriteCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): WriteCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema>;
-    <Plan, Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: WriteCommand<Args, Options, Plan, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): WriteCommand<Args, Options, Plan, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput;
-    <Plan, Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: DestructiveCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): DestructiveCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, NeedsOf<Secrets, Pick<Table, Code>>> & WithOutput<Schema>;
-    <Plan, Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends keyof Table & string = never>(command: DestructiveCommand<Args, Options, Plan, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): DestructiveCommand<Args, Options, Plan, Data, Ports, Settings, Data, NeedsOf<Secrets, Pick<Table, Code>>> & WithoutOutput;
+    <Row extends RowSchema, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: ListCommand<Args, Options, Row, Ports, Settings, Needed<Secrets, Table, Code>> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ListCommand<Args, Options, Row, Ports, Settings, Needed<Secrets, Table, Code>>;
+    <Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: ReadCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ReadCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema>;
+    <Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: ReadCommand<Args, Options, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ReadCommand<Args, Options, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput;
+    <Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: ActCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ActCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema>;
+    <Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: ActCommand<Args, Options, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ActCommand<Args, Options, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput;
+    <Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: ServeCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ServeCommand<Args, Options, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema>;
+    <Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: ServeCommand<Args, Options, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): ServeCommand<Args, Options, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput;
+    <Plan, Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: WriteCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): WriteCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema>;
+    <Plan, Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: WriteCommand<Args, Options, Plan, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): WriteCommand<Args, Options, Plan, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput;
+    <Plan, Schema extends z.ZodType, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: DestructiveCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema> & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): DestructiveCommand<Args, Options, Plan, Returns<Schema>, Ports, Settings, Prints<Schema>, Needed<Secrets, Table, Code>> & WithOutput<Schema>;
+    <Plan, Data, Args extends InputSchema = NoInput, Options extends InputSchema = NoInput, const Secrets extends readonly SecretDeclaration[] = readonly [], Code extends DeclarableCode<Table> = never>(command: DestructiveCommand<Args, Options, Plan, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput & WithoutStandardFlags<Args, Options> & DeclaredSecrets<Secrets>): DestructiveCommand<Args, Options, Plan, Data, Ports, Settings, Data, Needed<Secrets, Table, Code>> & WithoutOutput;
 }
 /** Throws when the Command's declaration breaks a rule its type cannot express; `label` names it. */
 export declare function checkCommand(command: Command, label: string, table: ErrorTable): void;
+/** Throws on a code in `errors` that is neither in `table` nor a Runtime code some Commands declare. */
+export declare function checkErrors(errors: readonly string[], label: string, table: ErrorTable): void;
 export declare function defineCommandFor<Ports, Settings, Table extends ErrorTable = NoErrors>(): DefineCommand<Ports, Settings, Table>;
 export declare const defineCommand: DefineCommand<unknown>;
 export {};

package/dist/define-command.js

@@ -1,5 +1,6 @@
 import { checkForce, checkNoStandardFlags } from "./command-line/flags.js";
 import { checkArrayArgLast, checkNoBooleanArrayOption, checkStdinFields, } from "./command-line/input.js";
+import { mustDeclare } from "./runtime-codes.js";
 /** Throws when the Command's declaration breaks a rule its type cannot express; `label` names it. */
 export function checkCommand(command, label, table) {
     checkNoStandardFlags(command, label);
@@ -7,10 +8,11 @@ export function checkCommand(command, label, table) {
     checkArrayArgLast(label, command.args);
     checkStdinFields(label, command.args, command.options);
     checkNoBooleanArrayOption(label, command.options);
-    checkErrors(command, label, table);
+    checkErrors(command.errors ?? [], label, table);
 }
-function checkErrors(command, label, table) {
-    const unknown = (command.errors ?? []).filter((code) => !Object.hasOwn(table, code));
+/** Throws on a code in `errors` that is neither in `table` nor a Runtime code some Commands declare. */
+export function checkErrors(errors, label, table) {
+    const unknown = errors.filter((code) => !mustDeclare(code, table));
     if (unknown.length > 0) {
         throw new Error(`${label} declares ${unknown.join(", ")} in errors, a code the Error table lacks`);
     }

package/dist/define-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"define-command.js","sourceRoot":"","sources":["../src/define-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAyB,MAAM,yBAAyB,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAmXjC,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,KAAa,EAAE,KAAiB;IAC7E,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3B,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,WAAW,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,OAAgB,EAAE,KAAa,EAAE,KAAiB;IACrE,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACrF,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAK9B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAA2B,OAAiB;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA2B,gBAAgB,EAAE,CAAC"}
+{"version":3,"file":"define-command.js","sourceRoot":"","sources":["../src/define-command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAyB,MAAM,yBAAyB,CAAC;AAClG,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,gBAAgB,GACjB,MAAM,yBAAyB,CAAC;AAgBjC,OAAO,EAA8B,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAiV7E,qGAAqG;AACrG,MAAM,UAAU,YAAY,CAAC,OAAgB,EAAE,KAAa,EAAE,KAAiB;IAC7E,oBAAoB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IACrC,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAC3B,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IACvD,yBAAyB,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAClD,WAAW,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;AAClD,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,WAAW,CAAC,MAAyB,EAAE,KAAa,EAAE,KAAiB;IACrF,MAAM,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,WAAW,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;IACnE,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,GAAG,KAAK,aAAa,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,0CAA0C,CAClF,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB;IAK9B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,QAAQ,CAA2B,OAAiB;IAC3D,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,MAAM,aAAa,GAA2B,gBAAgB,EAAE,CAAC"}

package/dist/define.d.ts

@@ -72,9 +72,10 @@ interface CommandBase<Args extends InputSchema, Options extends InputSchema, Dec
      */
     readonly secrets?: readonly SecretDeclaration<Declared["secretName"] | Declared["optionalSecretName"]>[];
     /**
-     * The codes of the CLI's Error table the Command throws, listed with their class in help JSON;
-     * `ctx.fail` throws only these. A run ending in a table code missing here, an `AggregateError`
-     * leaf included, fails as a bug (exit 70). Runtime codes are never listed.
+     * The codes of the CLI's Error table, and the Runtime codes only some Commands reach, such as
+     * `NO_LATEST`, that the Command throws, listed with their class in help JSON; `ctx.fail` throws
+     * only these. A run ending in one missing here, an `AggregateError` leaf included, fails as a bug
+     * (exit 70). A Runtime code any Command can meet is never listed.
      */
     readonly errors?: readonly (keyof Declared["errors"] & string)[];
     /**
@@ -286,6 +287,12 @@ export interface DoctorCheck<Ports = unknown, Settings = unknown> {
     readonly deadlineMs?: number;
     /** A problem in an advisory row shows but never fails `doctor`. */
     readonly advisory?: boolean;
+    /**
+     * The codes of the Error table, and the Runtime codes only some Commands reach, that the row fails
+     * with, thrown or as its finding's `code`; `doctor` declares those of every row that is not
+     * advisory. A row that is not advisory failing with one missing here fails `doctor` as a bug (exit 70).
+     */
+    readonly errors?: readonly string[];
     /**
      * `ctx.signal` aborts at the row's deadline. A thrown error is reported as this row's problem,
      * with its first Next step other than `ctx.rerun()` as the fix; one from `ctx.spawn` finding a

package/dist/define.js.map

@@ -1 +1 @@
-{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AA2bA,0FAA0F;AAC1F,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;AACzC,CAAC"}
+{"version":3,"file":"define.js","sourceRoot":"","sources":["../src/define.ts"],"names":[],"mappings":"AAkcA,0FAA0F;AAC1F,MAAM,UAAU,SAAS,CAAC,IAAwB;IAChD,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC;AACzC,CAAC"}

package/dist/errors.d.ts

@@ -1,5 +1,6 @@
 import type { Env } from "./context.js";
 import type { ErrorTable } from "./error-table.js";
+import type { ClassifiedLeaf } from "./failure.js";
 import { type NextStep, type Step } from "./next-step.js";
 import type { Style } from "./style.js";
 export interface CliErrorFields {
@@ -44,14 +45,9 @@ export interface ErrorFormat {
     readonly errors: ErrorTable;
     /** Where the CLI takes bug reports, read from package.json `bugs` only when a hint names it. */
     readonly bugs?: () => string | undefined;
-    /** Whether `error` is a bug: not a `CliError`, or one whose code nobody declared. */
-    readonly isBug: (error: unknown) => boolean;
-    readonly isWait: (error: unknown) => boolean;
 }
 export declare function errnoOf(error: unknown): string | undefined;
 export declare function isMissingFile(error: unknown): boolean;
-/** What `pending` resolves with, or undefined when it fails because a file is missing. */
-export declare function orMissing<T>(pending: Promise<T>): Promise<T | undefined>;
 export declare function isNothingThere(error: unknown): boolean;
 /** The CLI's own environment variable, such as `TOOL_DEBUG` for `cliVariable("tool", "DEBUG")`. */
 export declare function cliVariable(cliName: string, suffix: string): string;
@@ -65,5 +61,6 @@ export declare function traceOf(error: unknown): string;
  * empty `AggregateError` is a leaf.
  */
 export declare function errorsOf(error: unknown): readonly unknown[];
-export declare function formatRuntimeError(error: unknown, format: ErrorFormat): string;
+/** The classified errors a run failed with, as stderr carries them. */
+export declare function formatRuntimeError(leaves: readonly ClassifiedLeaf[], format: ErrorFormat): string;
 export {};

package/dist/errors.js

@@ -41,17 +41,6 @@ export function errnoOf(error) {
 export function isMissingFile(error) {
     return errnoOf(error) === "ENOENT";
 }
-/** What `pending` resolves with, or undefined when it fails because a file is missing. */
-export async function orMissing(pending) {
-    try {
-        return await pending;
-    }
-    catch (error) {
-        if (isMissingFile(error))
-            return undefined;
-        throw error;
-    }
-}
 // ENOTDIR: a part of the path is a file, so nothing can exist under it.
 export function isNothingThere(error) {
     return isMissingFile(error) || errnoOf(error) === "ENOTDIR";
@@ -79,12 +68,12 @@ function bugHint(format) {
     return bugs === undefined ? rerun : `${rerun}, then report it at ${bugs}`;
 }
 // A bug's own Next steps are the author's guess at a failure that was not meant to happen.
-function fieldsOf(error, format) {
+function fieldsOf({ error, exitClass }, format) {
     if (!(error instanceof CliError)) {
         return { code: INTERNAL, message: messageOf(error), hint: bugHint(format) };
     }
     const { code, message, hint, details, retryAt, next } = error;
-    if (format.isBug(error))
+    if (exitClass === "bug")
         return { code, message, hint: bugHint(format), details, retryAt };
     const lines = next.map((step) => lineOf(step, format.runAs));
     return { code, message, hint, details, retryAt, ...(lines.length === 0 ? {} : { next: lines }) };
@@ -98,11 +87,11 @@ export function traceOf(error) {
     return error instanceof Error ? (error.stack ?? error.message) : String(error);
 }
 /** Under debug: a bug's stack trace, then every error's cause chain. */
-function debugTrace(error, format) {
+function debugTrace({ error, exitClass }, format) {
     if (!isDebug(format))
         return undefined;
     const lines = [
-        ...(format.isBug(error) ? [traceOf(error)] : []),
+        ...(exitClass === "bug" ? [traceOf(error)] : []),
         ...causesOf(error).map((cause) => `caused by: ${traceOf(cause)}`),
     ];
     return lines.length === 0 ? undefined : lines.join("\n");
@@ -127,29 +116,29 @@ function printedDetail(error, format) {
     const value = Reflect.get(details, key);
     return typeof value === "string" ? value : undefined;
 }
-function labelOf(error, { isBug, isWait, style }) {
-    if (isWait(error))
+function labelOf({ exitClass }, style) {
+    if (exitClass === "wait")
         return style.yellow("wait:");
-    return style.red(isBug(error) ? "internal error:" : "error:");
+    return style.red(exitClass === "bug" ? "internal error:" : "error:");
 }
-function errorLines(error, format) {
-    const fields = fieldsOf(error, format);
-    const blocks = [printedDetail(error, format), debugTrace(error, format)].filter((block) => block !== undefined);
+function errorLines(leaf, format) {
+    const fields = fieldsOf(leaf, format);
+    const blocks = [printedDetail(leaf.error, format), debugTrace(leaf, format)].filter((block) => block !== undefined);
     const { style } = format;
-    const label = labelOf(error, format);
+    const label = labelOf(leaf, style);
     const between = blocks.map((block) => `${block}\n`).join("");
     const runs = (fields.next ?? []).map((line) => `${style.cyan("run:")} ${line}\n`).join("");
     return `${label} ${fields.message}\n${between}${style.cyan("hint:")} ${fields.hint}\n${runs}`;
 }
-export function formatRuntimeError(error, format) {
-    const errors = errorsOf(error);
+/** The classified errors a run failed with, as stderr carries them. */
+export function formatRuntimeError(leaves, format) {
     if (format.json) {
-        const printed = errors.map((each) => ({
-            ...fieldsOf(each, format),
-            stack: debugTrace(each, format),
+        const printed = leaves.map((leaf) => ({
+            ...fieldsOf(leaf, format),
+            stack: debugTrace(leaf, format),
         }));
         return `${JSON.stringify({ errors: printed })}\n`;
     }
-    return errors.map((each) => errorLines(each, format)).join("");
+    return leaves.map((leaf) => errorLines(leaf, format)).join("");
 }
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/execute.d.ts

@@ -1,33 +1,24 @@
-import type { Files } from "./context/files.js";
-import { type OutputsGuard } from "./context/outputs.js";
+import type { StandardValues } from "./command-line/parse-input.js";
+import type { Outputs } from "./context/outputs.js";
 import type { Context } from "./context.js";
 import type { Command } from "./define.js";
-import type { PageInput } from "./list.js";
 import type { Style } from "./style.js";
 export interface Outcome {
     readonly value: unknown;
     render(style: Style): string;
 }
-export interface ExecuteFlags {
-    readonly dryRun: boolean;
-    /** The target the caller named with `--confirm`, if any. */
-    readonly confirm: string | undefined;
-    /** Whether the caller approved the cost with `--yes`. */
-    readonly yes: boolean;
-    /** The page a List Command's `run` receives with its input. */
-    readonly page: PageInput;
+export interface ExecuteRun {
+    readonly flags: StandardValues;
     /** The caller's command line and the Command's, for the hint of a confirmation error. */
     readonly commandLine: string;
     /** Prints a serve Command's data the moment `start` returns it. */
     readonly started: (outcome: Outcome) => Promise<void>;
-    /** The file system under `ctx.files`, unresolved and unclassified, for the outputs probe. */
-    readonly files: Files;
-    /** Guards the declared outputs of `ctx.files` and the ports' files once every check passes. */
-    readonly guardOutputs: OutputsGuard["guard"];
+    /** The run's Outputs, whose files are `ctx.files`. */
+    readonly outputs: Outputs;
 }
 /**
  * The data a Command returned or delivered as it prints it: parsed by its `output` schema when it
  * declares one, so data the schema rejects fails the run as a bug.
  */
 export declare function dataOutcome(command: Command, data: unknown, commandLine: string): Outcome;
-export declare function execute(command: Command, input: Record<string, unknown>, ctx: Context, { dryRun, confirm, yes, page, commandLine, started, files, guardOutputs }: ExecuteFlags): Promise<Outcome>;
+export declare function execute(command: Command, input: Record<string, unknown>, ctx: Context, { flags, commandLine, started, outputs: runOutputs }: ExecuteRun): Promise<Outcome>;

package/dist/execute.js

@@ -1,10 +1,8 @@
 import { encode } from "@toon-format/toon";
 import * as z from "zod";
 import { untilAborted } from "./abort.js";
-import { FORCE_FLAG } from "./command-line/flags.js";
 import { checkConfirmation } from "./context/confirm.js";
 import { checkCost } from "./context/cost.js";
-import { checkOutputs, probeOutputs } from "./context/outputs.js";
 import { checkSecrets } from "./context/secrets.js";
 import { checkTools } from "./context/tools.js";
 const PLAN_INDENT = "  ";
@@ -66,13 +64,13 @@ function serveContextOf(ctx, end) {
     const serveCtx = Object.create(ctx);
     return Object.assign(serveCtx, { end });
 }
-export async function execute(command, input, ctx, { dryRun, confirm, yes, page, commandLine, started, files, guardOutputs }) {
-    await checkTools(command.tools ?? [], ctx.env, ctx.rerun());
+export async function execute(command, input, ctx, { flags, commandLine, started, outputs: runOutputs }) {
+    await checkTools(command.tools ?? [], ctx, ctx.rerun());
     const { env, envFile, fileError } = ctx;
     checkSecrets(command.secrets ?? [], { env, envFile, fileError }, ctx.rerun());
     if (command.rows !== undefined) {
         const { render } = command;
-        return outcomeOf(await command.run({ ...input, ...page }, ctx), (data, style) => render === undefined ? encode(data.items) : render(data, style));
+        return outcomeOf(await command.run({ ...input, ...flags.page }, ctx), (data, style) => render === undefined ? encode(data.items) : render(data, style));
     }
     if (command.effect === "read" || command.effect === "act") {
         return dataOutcome(command, await command.run(input, ctx), commandLine);
@@ -88,20 +86,19 @@ export async function execute(command, input, ctx, { dryRun, confirm, yes, page,
         return outcome;
     }
     const plan = await command.plan(input, ctx);
-    if (dryRun) {
+    if (ctx.dryRun) {
         return dryRunOutcome(command, plan, commandLine);
     }
     const outputs = command.outputs?.(plan);
-    await checkOutputs({ rerun: ctx.rerun, commandLine, force: ctx.force, files: ctx.files }, outputs);
-    checkCost({ rerun: ctx.rerun, commandLine, yes }, command.cost?.(plan));
+    const { rerun, force } = ctx;
+    if (outputs !== undefined)
+        await runOutputs.refuseOverwrite(outputs, { rerun, commandLine, force });
+    checkCost({ rerun, commandLine, yes: flags.yes }, command.cost?.(plan));
     if (command.effect === "destructive") {
-        checkConfirmation({ rerun: ctx.rerun, commandLine, given: confirm }, command.confirm(plan));
-    }
-    if (outputs !== undefined) {
-        await probeOutputs({ files, cwd: ctx.cwd, fileError: ctx.fileError }, outputs);
-        if (!ctx.force)
-            guardOutputs(outputs, ctx.rerun({ add: [FORCE_FLAG.flag] }));
+        checkConfirmation({ rerun, commandLine, given: flags.confirm }, command.confirm(plan));
     }
+    if (outputs !== undefined)
+        await runOutputs.claim(outputs, { rerun, force });
     return dataOutcome(command, await command.apply(plan, ctx), commandLine);
 }
 //# sourceMappingURL=execute.js.map

package/dist/execute.js.map

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

package/dist/exit-classes.d.ts

@@ -1,3 +1,4 @@
+import type { SpecNode } from "./command-spec.js";
 import type { Cli } from "./define.js";
 import { type DeclaredExitClass, type ErrorTable } from "./error-table.js";
 /** Who must act on a failure (ADR 0005), which sets the exit code. */
@@ -16,17 +17,13 @@ export declare const EXIT_CODES: {
 };
 /** The codes of `errors` that the Runtime already declares, which a CLI cannot redeclare. */
 export declare function runtimeCodesIn(errors: ErrorTable): string[];
-export declare function isBug(error: unknown, errors: ErrorTable): boolean;
-export declare function isWait(error: unknown, errors: ErrorTable): boolean;
+/** The class of `code` in the Runtime's Error table or else in the CLI's `errors`. */
+export declare function classOfCode(code: string, errors: ErrorTable): ExitClass | undefined;
 /**
- * The classes other than bug and interrupt that a run of `cli` can end in: those of the Runtime's
- * codes it can reach, and those of its own table.
+ * The classes other than bug and interrupt that a run of `cli` can end in: those of the Runtime
+ * codes any Command can meet, those of the codes its Commands under `root` declare, Built-ins
+ * included, and those of its own table.
  */
-export declare function reachableExitClasses(cli: Cli): Set<DeclaredExitClass>;
+export declare function reachableExitClasses(cli: Cli, root: SpecNode): Set<DeclaredExitClass>;
 /** The signal named by an interrupt's abort reason; any other reason counts as Ctrl-C. */
 export declare function stopSignalOf(reason: unknown): StopSignal;
-/**
- * The exit code of a run that failed with `error`, given the CLI's error table; `stop` is the
- * signal that interrupted it, if any.
- */
-export declare function exitCodeOf(error: unknown, errors: ErrorTable, stop: AbortSignal | undefined): number;

package/dist/exit-classes.js

@@ -1,6 +1,5 @@
-import { installOf } from "./built-ins/install/install.js";
 import { errorTableOf } from "./error-table.js";
-import { CliError, errorsOf, UsageError } from "./errors.js";
+import { anyCommandClasses, isRuntimeCode, runtimeErrors } from "./runtime-codes.js";
 export const SIGNAL_EXIT_CODES = { SIGINT: 130, SIGTERM: 143 };
 export const EXIT_CODES = {
     caller: 1,
@@ -9,98 +8,38 @@ export const EXIT_CODES = {
     wait: 75,
     bug: 70,
 };
-// Typed by every Runtime code, so a code missing here or not on `runtimeCodes` fails to compile.
-const RUNTIME_EXIT_CLASSES = {
-    INVALID_INPUT: "caller",
-    UNKNOWN_OPTION: "caller",
-    UNKNOWN_COMMAND: "caller",
-    UNKNOWN_FIELD: "caller",
-    CONFIRMATION_REQUIRED: "caller",
-    CONFIRMATION_MISMATCH: "caller",
-    NOT_CONFIRMED: "operator",
-    NEEDS_OPERATOR: "operator",
-    OUTPUT_EXISTS: "caller",
-    STDIN_STALLED: "caller",
-    INTERRUPTED: "interrupted",
-    DEADLINE_EXCEEDED: "wait",
-    INTERNAL: "bug",
-    PERMISSION_DENIED: "operator",
-    DISK_FULL: "operator",
-    NOT_FOUND: "caller",
-    ALREADY_EXISTS: "caller",
-    NOT_A_FILE: "caller",
-    TOOL_FAILED: "operator",
-    TOOL_MISSING: "operator",
-    SECRET_MISSING: "operator",
-    PROJECT_INVALID: "operator",
-    DOCTOR_PROBLEMS: "operator",
-    NOT_GLOBAL_INSTALL: "operator",
-    NOT_ON_PATH: "operator",
-    REGISTRY_UNREACHABLE: "operator",
-    REGISTRY_AUTH: "operator",
-    INSTALL_FAILED: "operator",
-    NPM_FAILED: "operator",
-    NO_LATEST: "source",
-};
-function isRuntimeCode(code) {
-    return Object.hasOwn(RUNTIME_EXIT_CLASSES, code);
-}
 /** The codes of `errors` that the Runtime already declares, which a CLI cannot redeclare. */
 export function runtimeCodesIn(errors) {
     return Object.keys(errors).filter(isRuntimeCode);
 }
-// A code that neither the Runtime nor the CLI declares was thrown by mistake: a bug.
-function exitClassOfOne(error, errors) {
-    if (!(error instanceof CliError))
-        return "bug";
-    if (error instanceof UsageError)
-        return "caller";
-    if (isRuntimeCode(error.code))
-        return RUNTIME_EXIT_CLASSES[error.code];
-    return errors[error.code]?.class ?? "bug";
-}
-export function isBug(error, errors) {
-    return exitClassOfOne(error, errors) === "bug";
+/** The class of `code` in the Runtime's Error table or else in the CLI's `errors`. */
+export function classOfCode(code, errors) {
+    return isRuntimeCode(code) ? runtimeErrors[code].class : errors[code]?.class;
 }
-export function isWait(error, errors) {
-    return exitClassOfOne(error, errors) === "wait";
+function declaredCodesOf(node) {
+    return node.kind === "command"
+        ? (node.command.errors ?? [])
+        : Object.values(node.commands).flatMap(declaredCodesOf);
 }
-// Of several errors, the class that must act first decides; any bug makes the whole run one.
-const ACT_FIRST = ["caller", "operator", "source", "wait", "interrupted"];
-function exitClassOf(error, errors) {
-    const classes = errorsOf(error).map((each) => exitClassOfOne(each, errors));
-    if (classes.includes("bug"))
-        return "bug";
-    return ACT_FIRST.find((exitClass) => classes.includes(exitClass)) ?? "bug";
+function isDeclarable(exitClass) {
+    return exitClass !== undefined && exitClass !== "bug" && exitClass !== "interrupted";
 }
 /**
- * The classes other than bug and interrupt that a run of `cli` can end in: those of the Runtime's
- * codes it can reach, and those of its own table.
+ * The classes other than bug and interrupt that a run of `cli` can end in: those of the Runtime
+ * codes any Command can meet, those of the codes its Commands under `root` declare, Built-ins
+ * included, and those of its own table.
  */
-export function reachableExitClasses(cli) {
-    // Any CLI can write files or refuse an unconfirmed cost (the operator's); the Built-ins its
-    // install adds, which only a multi-Command CLI has, may reach more.
-    const runtime = [
-        "caller",
-        "operator",
-        "wait",
-        ...(cli.commands === undefined ? [] : installOf(cli).exitClasses),
+export function reachableExitClasses(cli, root) {
+    const table = errorTableOf(cli);
+    const classes = [
+        ...anyCommandClasses,
+        ...declaredCodesOf(root).map((code) => classOfCode(code, table)),
+        ...Object.values(table).map((declaration) => declaration.class),
     ];
-    const own = Object.values(errorTableOf(cli)).map((declaration) => declaration.class);
-    return new Set([...runtime, ...own]);
+    return new Set(classes.filter(isDeclarable));
 }
 /** The signal named by an interrupt's abort reason; any other reason counts as Ctrl-C. */
 export function stopSignalOf(reason) {
     return reason === "SIGTERM" ? "SIGTERM" : "SIGINT";
 }
-/**
- * The exit code of a run that failed with `error`, given the CLI's error table; `stop` is the
- * signal that interrupted it, if any.
- */
-export function exitCodeOf(error, errors, stop) {
-    const exitClass = exitClassOf(error, errors);
-    return exitClass === "interrupted"
-        ? SIGNAL_EXIT_CODES[stopSignalOf(stop?.reason)]
-        : EXIT_CODES[exitClass];
-}
 //# sourceMappingURL=exit-classes.js.map