@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/core/commandRegistry.d.ts

@@ -123,14 +123,15 @@ export declare function commandOrder_set(order: {
  */
 export declare function commands_register(group: CommandGroup, owner?: CommandOwner): void;
 /**
- * A command's declaration, when it has one.
+ * A command's declaration, when it has one, by its name or an alias.
  *
- * @param name - The command name.
- * @returns The declaration, or undefined for a command not yet declared in one record.
+ * @param name - The command name, or an alias of it (`feeds`).
+ * @returns The declaration (an alias's named as the alias), or undefined for a command not yet declared in one record.
  *
  * @example
  * ```ts
  * commandDeclaration_get('ls')?.grammar;
+ * commandDeclaration_get('feeds')?.name; // 'feeds', the feed command under that word
  * ```
  */
 export declare function commandDeclaration_get(name: string): AnyCommandDeclaration | undefined;

package/dist/core/commandRegistry.js

@@ -1,4 +1,4 @@
-import { declaration_isParsed } from './commandDeclaration.js';
+import { commandAliases_list, declaration_isParsed } from './commandDeclaration.js';
 import { declaredHandler_make } from './commandParse.js';
 import { declarationHelp_derive } from './commandUsage.js';
 /** The names the core registered, which no backend may take. */
@@ -8,6 +8,8 @@ const plainHandlers = {};
 const helpEntries = {};
 const holdsEntries = new Map();
 const declarationEntries = new Map();
+/** Each alias of a declared command, to its declaration. */
+const aliasEntries = new Map();
 /** The listing order, by kind; empty until set. */
 const listingOrder = { envelope: [], plain: [], help: [] };
 /**
@@ -60,7 +62,7 @@ function names_ordered(record, order) {
  * @throws {Error} When a backend's group names a core command.
  */
 export function commands_register(group, owner = 'core') {
-    const declared = (group.declarations ?? []).map((declaration) => declaration.name);
+    const declared = (group.declarations ?? []).flatMap((declaration) => [declaration.name, ...declarationAliases_list(declaration).map((alias) => alias.name)]);
     const names = [...Object.keys(group.envelope ?? {}), ...Object.keys(group.plain ?? {}), ...declared];
     if (owner === 'backend') {
         const taken = names.filter((name) => coreNames.has(name));
@@ -82,18 +84,43 @@ export function commands_register(group, owner = 'core') {
     for (const declaration of group.declarations ?? [])
         declaration_register(declaration);
 }
+/**
+ * The command under each of its other words, as the registry answers them.
+ *
+ * @param declaration - The command's declaration.
+ * @returns One record per alias; none for a command without any.
+ */
+function declarationAliases_list(declaration) {
+    return commandAliases_list(declaration);
+}
 /**
  * Registers one declared command: its name answered by a handler that parses
  * the line against the grammar (an expression grammar's handler takes the
- * words), its help generated from the record, and what it holds.
+ * words), its help generated from the record, and what it holds. Each alias
+ * is registered the same way under its own word, so its usage and refusals
+ * say the word typed; the command alone is listed among the declarations,
+ * which the schema reads.
  *
  * @param declaration - The command's declaration.
  */
 function declaration_register(declaration) {
+    declarationEntries.set(declaration.name, declaration);
+    declaredName_register(declaration);
+    for (const alias of declarationAliases_list(declaration)) {
+        aliasEntries.set(alias.name, alias);
+        declaredName_register(alias);
+    }
+}
+/**
+ * Answers one word of a declared command: its handlers, its help entry and
+ * what it holds.
+ *
+ * @param declaration - The command, named as the word.
+ */
+function declaredName_register(declaration) {
     const handler = declaration_isParsed(declaration)
         ? declaredHandler_make(declaration)
         : (args) => declaration.handler(args);
-    declarationEntries.set(declaration.name, declaration);
     envelopeHandlers[declaration.name] = handler;
     // The plain form delivers what the handler answers, as envelopeHandler_wrap
     // does; the sink is loaded when it runs, so the registry loads no output path.
@@ -118,18 +145,19 @@ function declaration_register(declaration) {
         holdsEntries.set(declaration.name, declaration.holds);
 }
 /**
- * A command's declaration, when it has one.
+ * A command's declaration, when it has one, by its name or an alias.
  *
- * @param name - The command name.
- * @returns The declaration, or undefined for a command not yet declared in one record.
+ * @param name - The command name, or an alias of it (`feeds`).
+ * @returns The declaration (an alias's named as the alias), or undefined for a command not yet declared in one record.
  *
  * @example
  * ```ts
  * commandDeclaration_get('ls')?.grammar;
+ * commandDeclaration_get('feeds')?.name; // 'feeds', the feed command under that word
  * ```
  */
 export function commandDeclaration_get(name) {
-    return declarationEntries.get(name);
+    return declarationEntries.get(name) ?? aliasEntries.get(name);
 }
 /**
  * Every declared command, in registration order.

package/dist/core/commandRegistry.js.map

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

package/dist/core/commandSchema.js

@@ -71,7 +71,10 @@ function optionValue_schema(option) {
     if (option.value === undefined)
         return z.boolean().describe(option.summary);
     const value = argument_schema(option.value, option.summary);
-    return option.repeat === true ? z.array(value).describe(option.summary) : value;
+    if (option.repeat === true)
+        return z.array(value).describe(option.summary);
+    // One that asks takes null for "ask me".
+    return option.asks === true ? value.nullable() : value;
 }
 /**
  * One tool, its schema written by zod.
@@ -104,7 +107,7 @@ export function commandTools_derive(declaration) {
     const tools = [];
     if (grammar.subcommands === undefined || grammar.bare !== undefined) {
         const description = grammar.subcommands === undefined ? declaration.help.summary : (grammar.bare?.summary ?? declaration.help.summary);
-        tools.push(tool_make(declaration.name, description, { operands: grammar.operands ?? [], options: own }));
+        tools.push(tool_make(declaration.name, description, { operands: grammar.operands ?? [], options: { ...own, ...(grammar.bare?.options ?? {}) } }));
     }
     for (const [word, sub] of Object.entries(grammar.subcommands ?? {})) {
         tools.push(tool_make(`${declaration.name}_${word}`, sub.summary, { operands: sub.operands ?? [], options: { ...own, ...(sub.options ?? {}) } }));

package/dist/core/commandSchema.js.map

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

package/dist/core/commandUsage.d.ts

@@ -45,3 +45,18 @@ export declare function commandUsage_render(declaration: CommandDeclaration, sub
  * ```
  */
 export declare function declarationHelp_derive(declaration: CommandDeclaration): CommandHelp;
+/**
+ * The help record of one subcommand of a declared command (`help pacs
+ * query`): its usage, its summary, and its operands and options with the
+ * command's own beside them; the command's examples that run it.
+ *
+ * @param declaration - The command.
+ * @param subcommand - The subcommand's word.
+ * @returns The record, or undefined when the command has no such subcommand.
+ *
+ * @example
+ * ```ts
+ * subcommandHelp_derive(berthCommand, 'drop')?.usage; // 'berth drop <name>'
+ * ```
+ */
+export declare function subcommandHelp_derive(declaration: CommandDeclaration, subcommand: string): CommandHelp | undefined;

package/dist/core/commandUsage.js

@@ -22,8 +22,22 @@ function optionNames_render(option) {
         names.push(`-${option.short}`);
     if (option.long !== undefined)
         names.push(`--${option.long}`);
-    const value = option.value === undefined ? '' : ` <${option.value.name}>`;
-    return `${names.join(', ')}${value}`;
+    return `${names.join(', ')}${optionValue_render(option)}`;
+}
+/**
+ * An option's value as usage writes it: ` <field>`, `[=<language>]` for one
+ * that may be left out, ` [<file>]` for one that asks when it has none,
+ * nothing for a switch.
+ *
+ * @param option - The option.
+ * @returns The value's words.
+ */
+function optionValue_render(option) {
+    if (option.value === undefined)
+        return '';
+    if (option.value.optional === true)
+        return `[=<${option.value.name}>]`;
+    return option.asks === true ? ` [<${option.value.name}>]` : ` <${option.value.name}>`;
 }
 /**
  * The options and operands of one stretch of a line, as usage writes them:
@@ -50,7 +64,7 @@ function lineTail_render(line) {
         if (option.value === undefined)
             continue;
         const name = option.long !== undefined ? `--${option.long}` : `-${option.short ?? ''}`;
-        parts.push(`[${name} <${option.value.name}>]`);
+        parts.push(`[${name}${optionValue_render(option)}]`);
     }
     for (const operand of line.operands ?? [])
         parts.push(operand_usage(operand));
@@ -89,9 +103,12 @@ export function commandUsage_render(declaration, subcommand = null) {
     const own = lineTail_render({ ...(grammar.options !== undefined ? { options: grammar.options } : {}), ...(subcommands === undefined && grammar.operands !== undefined ? { operands: grammar.operands } : {}) });
     if (subcommands === undefined)
         return words_join(declaration.name, own);
-    const choices = Object.entries(subcommands)
-        .map(([word, sub]) => words_join(word, lineTail_render(sub)))
-        .join(' | ');
+    // The bare command's own options are its line, the first choice.
+    const bareTail = grammar.bare?.options !== undefined ? lineTail_render({ options: grammar.bare.options }) : '';
+    const choices = [
+        ...(bareTail !== '' ? [bareTail] : []),
+        ...Object.entries(subcommands).map(([word, sub]) => words_join(word, lineTail_render(sub))),
+    ].join(' | ');
     const bracketed = grammar.bare !== undefined ? `[${choices}]` : `<${choices}>`;
     return words_join(words_join(declaration.name, own), bracketed);
 }
@@ -148,8 +165,10 @@ function subcommandLines_render(grammar) {
     const headLines = columns_render(heads, '');
     const lines = [];
     let at = 0;
-    if (grammar.bare !== undefined)
+    if (grammar.bare !== undefined) {
         lines.push(headLines[at++]);
+        lines.push(...lineRows_render({ ...(grammar.bare.options !== undefined ? { options: grammar.bare.options } : {}) }, '  '));
+    }
     for (const sub of Object.values(subcommands)) {
         lines.push(headLines[at++]);
         lines.push(...lineRows_render(sub, '  '));
@@ -192,4 +211,37 @@ export function declarationHelp_derive(declaration) {
         ...(declaration.help.examples !== undefined ? { examples: [...declaration.help.examples] } : {}),
     };
 }
+/**
+ * The help record of one subcommand of a declared command (`help pacs
+ * query`): its usage, its summary, and its operands and options with the
+ * command's own beside them; the command's examples that run it.
+ *
+ * @param declaration - The command.
+ * @param subcommand - The subcommand's word.
+ * @returns The record, or undefined when the command has no such subcommand.
+ *
+ * @example
+ * ```ts
+ * subcommandHelp_derive(berthCommand, 'drop')?.usage; // 'berth drop <name>'
+ * ```
+ */
+export function subcommandHelp_derive(declaration, subcommand) {
+    const subcommands = declaration.grammar.subcommands;
+    if (subcommands === undefined || !Object.hasOwn(subcommands, subcommand))
+        return undefined;
+    const chosen = subcommands[subcommand];
+    const options = lineRows_render({
+        ...(chosen.operands !== undefined ? { operands: chosen.operands } : {}),
+        options: { ...(chosen.options ?? {}), ...(declaration.grammar.options ?? {}) },
+    }, '');
+    const lead = `${declaration.name} ${subcommand}`;
+    const examples = (declaration.help.examples ?? []).filter((line) => line === lead || line.startsWith(`${lead} `));
+    return {
+        usage: commandUsage_render(declaration, subcommand),
+        summary: chosen.summary,
+        description: chosen.summary,
+        ...(options.length > 0 ? { options } : {}),
+        ...(examples.length > 0 ? { examples } : {}),
+    };
+}
 //# sourceMappingURL=commandUsage.js.map

package/dist/core/commandUsage.js.map

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

package/dist/core/coreCommands.js

@@ -1,229 +1,80 @@
-import { builtin_leave, builtin_stopwatch, builtin_timer } from '../builtins/games/chimes.js';
-import { builtin_cowsay, builtin_cowthink } from '../builtins/games/cowsay.js';
-import { builtin_banner, builtin_figlet } from '../builtins/games/figlet.js';
-import { builtin_say, builtin_uptime, builtin_who } from '../builtins/games/lab.js';
-import { builtin_lolcat } from '../builtins/games/lolcat.js';
-import { builtin_morse } from '../builtins/games/morse.js';
-import { builtin_calc, builtin_factor, builtin_primes, builtin_roll, builtin_units } from '../builtins/games/numbers.js';
-import { builtin_2048, builtin_hangman, builtin_quiz } from '../builtins/games/play.js';
-import { builtin_trek } from '../builtins/games/trek.js';
-import { builtin_qr } from '../builtins/games/qr.js';
-import { builtin_asciiquarium, builtin_cmatrix, builtin_rain, builtin_sl, builtin_snake, builtin_tetris } from '../builtins/games/show.js';
-import { builtin_ddate, builtin_pom, builtin_stardate, builtin_sunrise } from '../builtins/games/sky.js';
-import { builtin_grep } from '../builtins/sys/grep.js';
-import { builtin_cut, builtin_head, builtin_sort, builtin_tail, builtin_uniq, builtin_wc } from '../builtins/sys/textFilters.js';
-import { builtin_command } from '../builtins/sys/command.js';
-import { builtin_kill, builtin_wait } from '../builtins/sys/tasks.js';
-import { builtin_fg, builtin_joblets } from '../builtins/sys/joblets.js';
-import { builtin_set, builtin_unset } from '../builtins/sys/variables.js';
-import { builtin_echo, builtin_printf } from '../builtins/sys/echo.js';
-import { builtin_expect } from '../builtins/res/expect.js';
-import { builtin_play } from '../builtins/res/play.js';
-import { builtin_apropos, builtin_man } from '../builtins/sys/apropos.js';
-import { builtin_rev, builtin_rot13, builtin_seq, builtin_shuf, builtin_tac, builtin_yes } from '../builtins/games/text.js';
-import { builtin_wtf } from '../builtins/games/wtf.js';
-import { builtin_debug } from '../builtins/debug.js';
-import { builtin_cat } from '../builtins/fs/cat.js';
-import { builtin_cd } from '../builtins/fs/cd.js';
-import { builtin_cp } from '../builtins/fs/cp.js';
+import { leaveCommand, stopwatchCommand, timerCommand } from '../builtins/games/chimes.js';
+import { cowsayCommand, cowthinkCommand } from '../builtins/games/cowsay.js';
+import { bannerCommand, figletCommand } from '../builtins/games/figlet.js';
+import { sayCommand, uptimeCommand, whoCommand } from '../builtins/games/lab.js';
+import { lolcatCommand } from '../builtins/games/lolcat.js';
+import { morseCommand } from '../builtins/games/morse.js';
+import { calcCommand, factorCommand, primesCommand, rollCommand, unitsCommand } from '../builtins/games/numbers.js';
+import { game2048Command, hangmanCommand, quizCommand } from '../builtins/games/play.js';
+import { trekCommand } from '../builtins/games/trek.js';
+import { qrCommand } from '../builtins/games/qr.js';
+import { asciiquariumCommand, cmatrixCommand, rainCommand, slCommand, snakeCommand, tetrisCommand } from '../builtins/games/show.js';
+import { ddateCommand, pomCommand, stardateCommand, sunriseCommand } from '../builtins/games/sky.js';
+import { grepCommand } from '../builtins/sys/grep.js';
+import { cutCommand, headCommand, sortCommand, tailCommand, uniqCommand, wcCommand } from '../builtins/sys/textFilters.js';
+import { commandCommand } from '../builtins/sys/command.js';
+import { killCommand, waitCommand } from '../builtins/sys/tasks.js';
+import { fgCommand, jobletsCommand } from '../builtins/sys/joblets.js';
+import { setCommand, unsetCommand } from '../builtins/sys/variables.js';
+import { echoCommand, printfCommand } from '../builtins/sys/echo.js';
+import { expectCommand } from '../builtins/res/expect.js';
+import { playCommand } from '../builtins/res/play.js';
+import { aproposCommand, manCommand } from '../builtins/sys/apropos.js';
+import { revCommand, rot13Command, seqCommand, shufCommand, tacCommand, yesCommand } from '../builtins/games/text.js';
+import { wtfCommand } from '../builtins/games/wtf.js';
+import { debugCommand } from '../builtins/debug.js';
+import { catCommand } from '../builtins/fs/cat.js';
+import { cdCommand } from '../builtins/fs/cd.js';
+import { cpCommand } from '../builtins/fs/cp.js';
 import { lsCommand } from '../builtins/fs/ls.js';
-import { builtin_mkdir } from '../builtins/fs/mkdir.js';
-import { builtin_mv } from '../builtins/fs/mv.js';
-import { builtin_pwd } from '../builtins/fs/pwd.js';
+import { mkdirCommand } from '../builtins/fs/mkdir.js';
+import { mvCommand } from '../builtins/fs/mv.js';
+import { pwdCommand } from '../builtins/fs/pwd.js';
 import { builtin_url } from '../builtins/fs/url.js';
-import { builtin_rm } from '../builtins/fs/rm.js';
-import { builtin_rmdir } from '../builtins/fs/rmdir.js';
-import { builtin_touch } from '../builtins/fs/touch.js';
-import { builtin_find } from '../builtins/fs/find.js';
-import { builtin_help } from '../builtins/help.js';
-import { builtin_cal } from '../builtins/sys/cal.js';
-import { builtin_date } from '../builtins/sys/date.js';
-import { builtin_fortune } from '../builtins/sys/fortune.js';
-import { builtin_timing } from '../builtins/sys/timing.js';
-import { builtin_version } from '../builtins/sys/version.js';
-import { builtin_weather } from '../builtins/sys/weather.js';
-import { builtin_notes } from '../builtins/sys/notes.js';
+import { rmCommand } from '../builtins/fs/rm.js';
+import { rmdirCommand } from '../builtins/fs/rmdir.js';
+import { touchCommand } from '../builtins/fs/touch.js';
+import { findCommand } from '../builtins/fs/find.js';
+import { helpCommand } from '../builtins/help.js';
+import { calCommand } from '../builtins/sys/cal.js';
+import { dateCommand } from '../builtins/sys/date.js';
+import { fortuneCommand } from '../builtins/sys/fortune.js';
+import { timingCommand } from '../builtins/sys/timing.js';
+import { versionCommand } from '../builtins/sys/version.js';
+import { weatherCommand } from '../builtins/sys/weather.js';
+import { notesCommand } from '../builtins/sys/notes.js';
 import { envelopeHandler_wrap } from './sink.js';
 const envelope = {
-    cat: builtin_cat,
-    find: builtin_find,
-    cd: builtin_cd,
-    cp: builtin_cp,
-    mv: builtin_mv,
-    rm: builtin_rm,
-    mkdir: builtin_mkdir,
-    rmdir: builtin_rmdir,
-    touch: builtin_touch,
-    pwd: builtin_pwd,
     url: builtin_url,
-    timing: builtin_timing,
-    debug: builtin_debug,
-    version: builtin_version,
-    fortune: builtin_fortune,
-    cowsay: builtin_cowsay,
-    cowthink: builtin_cowthink,
-    figlet: builtin_figlet,
-    banner: builtin_banner,
-    lolcat: builtin_lolcat,
-    rev: builtin_rev,
-    tac: builtin_tac,
-    grep: builtin_grep,
-    wc: builtin_wc,
-    head: builtin_head,
-    tail: builtin_tail,
-    sort: builtin_sort,
-    uniq: builtin_uniq,
-    cut: builtin_cut,
-    command: builtin_command,
-    apropos: builtin_apropos,
-    man: builtin_man,
-    yes: builtin_yes,
-    seq: builtin_seq,
-    factor: builtin_factor,
-    primes: builtin_primes,
-    shuf: builtin_shuf,
-    roll: builtin_roll,
-    rot13: builtin_rot13,
-    morse: builtin_morse,
-    calc: builtin_calc,
-    units: builtin_units,
-    who: builtin_who,
-    uptime: builtin_uptime,
-    say: builtin_say,
-    wtf: builtin_wtf,
-    qr: builtin_qr,
-    pom: builtin_pom,
-    stardate: builtin_stardate,
-    ddate: builtin_ddate,
-    sunrise: builtin_sunrise,
-    timer: builtin_timer,
-    kill: builtin_kill,
-    wait: builtin_wait,
-    fg: builtin_fg,
-    joblets: builtin_joblets,
-    set: builtin_set,
-    echo: builtin_echo,
-    printf: builtin_printf,
-    expect: builtin_expect,
-    play: builtin_play,
-    unset: builtin_unset,
-    leave: builtin_leave,
-    stopwatch: builtin_stopwatch,
-    sl: builtin_sl,
-    cmatrix: builtin_cmatrix,
-    rain: builtin_rain,
-    asciiquarium: builtin_asciiquarium,
-    tetris: builtin_tetris,
-    snake: builtin_snake,
-    quiz: builtin_quiz,
-    hangman: builtin_hangman,
-    trek: builtin_trek,
-    '2048': builtin_2048,
-    weather: builtin_weather,
-    notes: builtin_notes,
-    date: builtin_date,
-    cal: builtin_cal,
-    help: builtin_help,
 };
 const plain = {
-    cd: envelopeHandler_wrap(builtin_cd),
-    pwd: envelopeHandler_wrap(builtin_pwd),
     url: envelopeHandler_wrap((args) => builtin_url(args)),
-    cat: envelopeHandler_wrap(builtin_cat),
-    find: envelopeHandler_wrap(builtin_find),
-    rm: envelopeHandler_wrap(builtin_rm),
-    cp: envelopeHandler_wrap(builtin_cp),
-    mv: envelopeHandler_wrap(builtin_mv),
-    touch: envelopeHandler_wrap(builtin_touch),
-    mkdir: envelopeHandler_wrap(builtin_mkdir),
-    rmdir: envelopeHandler_wrap(builtin_rmdir),
-    timing: envelopeHandler_wrap(builtin_timing),
-    debug: envelopeHandler_wrap(builtin_debug),
-    fortune: envelopeHandler_wrap(builtin_fortune),
-    cowsay: envelopeHandler_wrap(builtin_cowsay),
-    cowthink: envelopeHandler_wrap(builtin_cowthink),
-    figlet: envelopeHandler_wrap(builtin_figlet),
-    banner: envelopeHandler_wrap(builtin_banner),
-    lolcat: envelopeHandler_wrap(builtin_lolcat),
-    rev: envelopeHandler_wrap(builtin_rev),
-    tac: envelopeHandler_wrap(builtin_tac),
-    grep: envelopeHandler_wrap(builtin_grep),
-    wc: envelopeHandler_wrap(builtin_wc),
-    head: envelopeHandler_wrap(builtin_head),
-    tail: envelopeHandler_wrap(builtin_tail),
-    sort: envelopeHandler_wrap(builtin_sort),
-    uniq: envelopeHandler_wrap(builtin_uniq),
-    cut: envelopeHandler_wrap(builtin_cut),
-    command: envelopeHandler_wrap(builtin_command),
-    apropos: envelopeHandler_wrap(builtin_apropos),
-    man: envelopeHandler_wrap(builtin_man),
-    yes: envelopeHandler_wrap(builtin_yes),
-    seq: envelopeHandler_wrap(builtin_seq),
-    factor: envelopeHandler_wrap(builtin_factor),
-    primes: envelopeHandler_wrap(builtin_primes),
-    shuf: envelopeHandler_wrap(builtin_shuf),
-    roll: envelopeHandler_wrap(builtin_roll),
-    rot13: envelopeHandler_wrap(builtin_rot13),
-    morse: envelopeHandler_wrap(builtin_morse),
-    calc: envelopeHandler_wrap(builtin_calc),
-    units: envelopeHandler_wrap(builtin_units),
-    who: envelopeHandler_wrap(builtin_who),
-    uptime: envelopeHandler_wrap(builtin_uptime),
-    say: envelopeHandler_wrap(builtin_say),
-    wtf: envelopeHandler_wrap(builtin_wtf),
-    qr: envelopeHandler_wrap(builtin_qr),
-    pom: envelopeHandler_wrap(builtin_pom),
-    stardate: envelopeHandler_wrap(builtin_stardate),
-    ddate: envelopeHandler_wrap(builtin_ddate),
-    sunrise: envelopeHandler_wrap(builtin_sunrise),
-    timer: envelopeHandler_wrap(builtin_timer),
-    kill: envelopeHandler_wrap(builtin_kill),
-    wait: envelopeHandler_wrap(builtin_wait),
-    fg: envelopeHandler_wrap(builtin_fg),
-    joblets: envelopeHandler_wrap(builtin_joblets),
-    set: envelopeHandler_wrap(builtin_set),
-    echo: envelopeHandler_wrap(builtin_echo),
-    printf: envelopeHandler_wrap(builtin_printf),
-    expect: envelopeHandler_wrap(builtin_expect),
-    play: envelopeHandler_wrap(builtin_play),
-    unset: envelopeHandler_wrap(builtin_unset),
-    leave: envelopeHandler_wrap(builtin_leave),
-    stopwatch: envelopeHandler_wrap(builtin_stopwatch),
-    sl: envelopeHandler_wrap(builtin_sl),
-    cmatrix: envelopeHandler_wrap(builtin_cmatrix),
-    rain: envelopeHandler_wrap(builtin_rain),
-    asciiquarium: envelopeHandler_wrap(builtin_asciiquarium),
-    tetris: envelopeHandler_wrap(builtin_tetris),
-    snake: envelopeHandler_wrap(builtin_snake),
-    quiz: envelopeHandler_wrap(builtin_quiz),
-    hangman: envelopeHandler_wrap(builtin_hangman),
-    trek: envelopeHandler_wrap(builtin_trek),
-    '2048': envelopeHandler_wrap(builtin_2048),
-    weather: envelopeHandler_wrap(builtin_weather),
-    notes: envelopeHandler_wrap(builtin_notes),
-    date: envelopeHandler_wrap(builtin_date),
-    cal: envelopeHandler_wrap(builtin_cal),
-    help: envelopeHandler_wrap(builtin_help),
 };
 /** The core commands: their handlers. Their help is registered from `builtins/help.ts`, which holds it. */
 /**
  * What the core's commands hold of the session: a read holds nothing and
- * runs beside anything; `cd` holds the working directory. A command not
- * named holds the whole session (a game, a play, anything that asks).
+ * runs beside anything. A command not named holds the whole session (a
+ * game, a play, anything that asks); a declared command says in its
+ * declaration (`cd` holds the working directory).
  */
-const holds = {
-    ...Object.fromEntries([
-        'apropos', 'banner', 'cal', 'calc', 'cat', 'cowsay', 'cowthink', 'cut', 'date', 'ddate', 'echo', 'factor',
-        'figlet', 'find', 'fortune', 'grep', 'head', 'help', 'lolcat', 'man', 'morse', 'notes', 'pom',
-        'primes', 'printf', 'pwd', 'qr', 'rev', 'rot13', 'seq', 'sort', 'stardate', 'tac', 'tail', 'uniq',
-        'units', 'uptime', 'version', 'wc', 'who',
-        // Following or stopping a task changes nothing of the session.
-        'fg', 'joblets', 'kill', 'wait',
-    ].map((name) => [name, []])),
-    cd: ['cwd'],
-};
+const holds = {};
 /** The core commands declared in one record each: grammar, kinds, handler, holds and help together. */
-const declarations = [lsCommand];
+const declarations = [
+    lsCommand, cdCommand, pwdCommand, timingCommand, debugCommand,
+    // General, in the order their handlers listed before they were declared.
+    commandCommand, aproposCommand, manCommand, killCommand, waitCommand, fgCommand, jobletsCommand,
+    setCommand, echoCommand, printfCommand, unsetCommand, versionCommand, notesCommand, dateCommand, helpCommand,
+    // The games shelf and the workflows, in the order their handlers listed before they were declared.
+    fortuneCommand, cowsayCommand, cowthinkCommand, figletCommand, bannerCommand, lolcatCommand, revCommand, tacCommand,
+    yesCommand, seqCommand, factorCommand, primesCommand, shufCommand, rollCommand, rot13Command, morseCommand,
+    calcCommand, unitsCommand, whoCommand, uptimeCommand, sayCommand, wtfCommand, qrCommand, pomCommand,
+    stardateCommand, ddateCommand, sunriseCommand, timerCommand, expectCommand, playCommand, leaveCommand, stopwatchCommand,
+    slCommand, cmatrixCommand, rainCommand, asciiquariumCommand, tetrisCommand, snakeCommand, quizCommand, hangmanCommand,
+    trekCommand, game2048Command, weatherCommand, calCommand,
+    // Files.
+    catCommand, findCommand, cpCommand, mvCommand, rmCommand, mkdirCommand, rmdirCommand, touchCommand,
+    grepCommand, wcCommand, headCommand, tailCommand, sortCommand, uniqCommand, cutCommand,
+];
 export const coreCommands = {
     envelope,
     plain,