@fnndsc/brasa 0.38.2 → 0.40.0

package/dist/buildinfo.json

@@ -1 +1 @@
-{"hash":"86ecd2"}
+{"hash":"bd5de9"}

package/dist/builtins/fs/find.d.ts

@@ -0,0 +1,70 @@
+import { type CommandEnvelope } from '@fnndsc/menu';
+/** One entry the walk visits. */
+export interface FindNode {
+    /** The path as printed (relative to how its starting point was typed). */
+    shown: string;
+    /** The entry's own name. */
+    name: string;
+    /** `d` a folder (any kind the namespace lists into), `l` a link, `f` anything else. */
+    type: 'f' | 'd' | 'l';
+    /** ISO date, when the listing carries one. */
+    date?: string;
+    /** Levels below its starting point. */
+    depth: number;
+}
+/** A parsed expression. */
+export type FindExpr = {
+    kind: 'and' | 'or';
+    left: FindExpr;
+    right: FindExpr;
+} | {
+    kind: 'not';
+    operand: FindExpr;
+} | {
+    kind: 'test';
+    test: (node: FindNode) => boolean;
+} | {
+    kind: 'print';
+    separator: string;
+};
+/** What the command line asks for. */
+export interface FindQuery {
+    starts: string[];
+    expr: FindExpr;
+    maxdepth: number;
+    mindepth: number;
+    /** Whether the expression names an action; without one, every match is printed. */
+    acts: boolean;
+}
+/**
+ * A shell pattern as a regular expression, the way `find` matches it: `*`
+ * any run of characters (a `/` included), `?` one, `[...]` a class.
+ *
+ * @param pattern - The pattern.
+ * @param ignoreCase - Whether case is ignored.
+ * @returns The expression, anchored at both ends.
+ */
+export declare function pattern_toRegExp(pattern: string, ignoreCase?: boolean): RegExp;
+/**
+ * Parses `find`'s arguments.
+ *
+ * @param args - The words after `find`.
+ * @returns The query, or the refusal to say.
+ */
+export declare function find_parse(args: string[]): FindQuery | string;
+/**
+ * Evaluates an expression on one entry, printing as its actions say.
+ *
+ * @param expr - The expression.
+ * @param node - The entry.
+ * @param out - Where printed paths go.
+ * @returns Whether the expression is true for the entry.
+ */
+export declare function find_evaluate(expr: FindExpr, node: FindNode, out: string[]): boolean;
+/**
+ * `find [path...] [expression]`.
+ *
+ * @param args - The words after `find`.
+ * @returns The selected paths, and why any part of the walk failed.
+ */
+export declare function builtin_find(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/fs/find.js

@@ -0,0 +1,323 @@
+/**
+ * @file `find`: walk the namespace and print the paths an expression selects.
+ *
+ * POSIX's form: starting points first (`.` when none), then an expression of
+ * tests and actions joined by implicit AND, `-o`, `!`/`-not` and parentheses.
+ * The walk reads every folder through the listing cache (`vfs.listing_get`),
+ * the same listings `ls` reads, so a tree already seen is walked without a
+ * word to CUBE; only a folder never listed, or one whose listing expired, is
+ * fetched. Links are not followed (POSIX's default). A long walk says how far
+ * it has got, and Ctrl-C stops it, saying where; a folder that cannot be read
+ * is named and the command fails, as POSIX `find` does, without stopping the
+ * walk.
+ *
+ * Tests: `-name`, `-iname`, `-path`, `-ipath` (shell patterns, `*` crossing `/`
+ * in a path), `-type f|d|l`, `-newermt DATE`; options `-maxdepth N`,
+ * `-mindepth N`; actions `-print` (the default) and `-print0`. Anything else
+ * is refused by name.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import path from 'path';
+import { path_resolve } from '../utils.js';
+import { vfs } from '../../lib/vfs/vfs.js';
+import { spinner } from '../../lib/spinner.js';
+import { commandCancellation_enable, commandCancellation_signalGet } from '../../core/cancellation.js';
+import { errorStack } from '@fnndsc/fond';
+import { envelope_error } from '@fnndsc/menu';
+/** How long a walk runs before it says how far it has got. */
+const PROGRESS_AFTER_MS = 1500;
+/** Listing types the namespace descends into. */
+const FOLDER_TYPES = new Set(['dir', 'vfs', 'job']);
+/**
+ * A shell pattern as a regular expression, the way `find` matches it: `*`
+ * any run of characters (a `/` included), `?` one, `[...]` a class.
+ *
+ * @param pattern - The pattern.
+ * @param ignoreCase - Whether case is ignored.
+ * @returns The expression, anchored at both ends.
+ */
+export function pattern_toRegExp(pattern, ignoreCase = false) {
+    let source = '';
+    for (let i = 0; i < pattern.length; i++) {
+        const ch = pattern[i];
+        if (ch === '*')
+            source += '.*';
+        else if (ch === '?')
+            source += '.';
+        else if (ch === '[') {
+            const close = pattern.indexOf(']', i + 2);
+            if (close === -1) {
+                source += '\\[';
+                continue;
+            }
+            const body = pattern.slice(i + 1, close).replace(/^!/, '^').replace(/\\/g, '\\\\');
+            source += `[${body}]`;
+            i = close;
+        }
+        else if (ch === '\\' && i + 1 < pattern.length) {
+            source += pattern[++i].replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+        }
+        else
+            source += ch.replace(/[.*+?^${}()|[\]\\/]/g, '\\$&');
+    }
+    return new RegExp(`^${source}$`, ignoreCase ? 'i' : '');
+}
+/**
+ * Parses `find`'s arguments.
+ *
+ * @param args - The words after `find`.
+ * @returns The query, or the refusal to say.
+ */
+export function find_parse(args) {
+    const starts = [];
+    let i = 0;
+    while (i < args.length && !/^[-!(]/.test(args[i]))
+        starts.push(args[i++]);
+    if (starts.length === 0)
+        starts.push('.');
+    const words = args.slice(i);
+    let at = 0;
+    let maxdepth = Number.POSITIVE_INFINITY;
+    let mindepth = 0;
+    let acts = false;
+    const argument = (predicate) => {
+        const value = words[++at];
+        if (value === undefined)
+            throw new Error(`find: ${predicate} needs an argument`);
+        return value;
+    };
+    const depth = (predicate) => {
+        const value = argument(predicate);
+        if (!/^\d+$/.test(value))
+            throw new Error(`find: ${predicate} takes a number, not '${value}'`);
+        return Number(value);
+    };
+    const primary = () => {
+        const word = words[at];
+        if (word === undefined)
+            throw new Error('find: an expression ends where a test was expected');
+        if (word === '(') {
+            at++;
+            const inner = or();
+            if (words[at] !== ')')
+                throw new Error("find: a '(' is not closed");
+            at++;
+            return inner;
+        }
+        let expr;
+        switch (word) {
+            case '-name':
+            case '-iname': {
+                const re = pattern_toRegExp(argument(word), word === '-iname');
+                expr = { kind: 'test', test: (node) => re.test(node.name) };
+                break;
+            }
+            case '-path':
+            case '-ipath':
+            case '-wholename': {
+                const re = pattern_toRegExp(argument(word), word === '-ipath');
+                expr = { kind: 'test', test: (node) => re.test(node.shown) };
+                break;
+            }
+            case '-type': {
+                const kind = argument(word);
+                if (!['f', 'd', 'l'].includes(kind))
+                    throw new Error(`find: -type takes f, d or l, not '${kind}'`);
+                expr = { kind: 'test', test: (node) => node.type === kind };
+                break;
+            }
+            case '-newermt': {
+                const when = argument(word);
+                const time = Date.parse(when);
+                if (Number.isNaN(time))
+                    throw new Error(`find: -newermt takes a date, not '${when}'`);
+                expr = { kind: 'test', test: (node) => node.date !== undefined && Date.parse(node.date) > time };
+                break;
+            }
+            case '-maxdepth':
+                maxdepth = depth(word);
+                expr = { kind: 'test', test: () => true };
+                break;
+            case '-mindepth':
+                mindepth = depth(word);
+                expr = { kind: 'test', test: () => true };
+                break;
+            case '-true':
+                expr = { kind: 'test', test: () => true };
+                break;
+            case '-false':
+                expr = { kind: 'test', test: () => false };
+                break;
+            case '-print':
+                acts = true;
+                expr = { kind: 'print', separator: '\n' };
+                break;
+            case '-print0':
+                acts = true;
+                expr = { kind: 'print', separator: '\0' };
+                break;
+            default: throw new Error(`find: unknown predicate '${word}'`);
+        }
+        at++;
+        return expr;
+    };
+    const not = () => {
+        if (words[at] === '!' || words[at] === '-not') {
+            at++;
+            return { kind: 'not', operand: not() };
+        }
+        return primary();
+    };
+    const and = () => {
+        let left = not();
+        while (at < words.length && words[at] !== '-o' && words[at] !== '-or' && words[at] !== ')') {
+            if (words[at] === '-a' || words[at] === '-and')
+                at++;
+            left = { kind: 'and', left, right: not() };
+        }
+        return left;
+    };
+    const or = () => {
+        let left = and();
+        while (words[at] === '-o' || words[at] === '-or') {
+            at++;
+            left = { kind: 'or', left, right: and() };
+        }
+        return left;
+    };
+    try {
+        const expr = words.length === 0 ? { kind: 'test', test: () => true } : or();
+        if (at < words.length)
+            return `find: unexpected '${words[at]}'`;
+        return { starts, expr, maxdepth, mindepth, acts };
+    }
+    catch (error) {
+        return error instanceof Error ? error.message : String(error);
+    }
+}
+/**
+ * Evaluates an expression on one entry, printing as its actions say.
+ *
+ * @param expr - The expression.
+ * @param node - The entry.
+ * @param out - Where printed paths go.
+ * @returns Whether the expression is true for the entry.
+ */
+export function find_evaluate(expr, node, out) {
+    switch (expr.kind) {
+        case 'and': return find_evaluate(expr.left, node, out) && find_evaluate(expr.right, node, out);
+        case 'or': return find_evaluate(expr.left, node, out) || find_evaluate(expr.right, node, out);
+        case 'not': return !find_evaluate(expr.operand, node, out);
+        case 'test': return expr.test(node);
+        case 'print':
+            out.push(node.shown + expr.separator);
+            return true;
+    }
+}
+/** An entry's kind, as `-type` names it. */
+function type_of(item) {
+    if (item.type === 'link')
+        return 'l';
+    return FOLDER_TYPES.has(item.type) ? 'd' : 'f';
+}
+/**
+ * `find [path...] [expression]`.
+ *
+ * @param args - The words after `find`.
+ * @returns The selected paths, and why any part of the walk failed.
+ */
+export async function builtin_find(args) {
+    const query = find_parse(args);
+    if (typeof query === 'string') {
+        process.exitCode = 1;
+        return envelope_error('', undefined, `${chalk.red(query)}\n`);
+    }
+    commandCancellation_enable();
+    const signal = commandCancellation_signalGet();
+    const out = [];
+    let failures = '';
+    let folders = 0;
+    let found = 0;
+    const startedAt = Date.now();
+    let announced = false;
+    const progress = () => {
+        if (Date.now() - startedAt < PROGRESS_AFTER_MS)
+            return;
+        const words = `find: ${folders} folder${folders === 1 ? '' : 's'} walked, ${found} found`;
+        if (announced)
+            spinner.updateMessage(words);
+        else {
+            spinner.start(words);
+            announced = true;
+        }
+    };
+    const visit = (node) => {
+        if (node.depth < query.mindepth)
+            return;
+        const before = out.length;
+        const matched = find_evaluate(query.expr, node, out);
+        if (!query.acts && matched)
+            out.push(`${node.shown}\n`);
+        if (out.length > before)
+            found++;
+    };
+    try {
+        for (const start of query.starts) {
+            const resolved = await path_resolve(start);
+            const shownRoot = start.startsWith('~') ? resolved : start;
+            const self = await vfs.listing_get(resolved, { directory: true });
+            const entry = self.ok ? self.value.items[0] : undefined;
+            if (entry === undefined) {
+                errorStack.stack_pop();
+                failures += `find: '${start}': No such file or directory\n`;
+                continue;
+            }
+            const rootType = type_of(entry);
+            visit({ shown: shownRoot, name: path.posix.basename(resolved) || resolved, type: rootType, date: entry.date || undefined, depth: 0 });
+            if (rootType !== 'd')
+                continue;
+            // Depth first, in listing order: an entry, then everything beneath it.
+            const walk = async (real, shown, depth) => {
+                if (signal?.aborted)
+                    return false;
+                if (depth >= query.maxdepth)
+                    return true;
+                const listed = await vfs.listing_get(real);
+                folders++;
+                progress();
+                if (!listed.ok) {
+                    const why = errorStack.stack_pop()?.message ?? 'cannot be read';
+                    failures += `find: '${shown}': ${why}\n`;
+                    return true;
+                }
+                for (const item of listed.value.items) {
+                    const node = {
+                        shown: shown === '/' ? `/${item.name}` : `${shown}/${item.name}`,
+                        name: item.name,
+                        type: type_of(item),
+                        date: item.date || undefined,
+                        depth: depth + 1,
+                    };
+                    visit(node);
+                    if (node.type === 'd' && !(await walk(path.posix.join(real, item.name), node.shown, node.depth)))
+                        return false;
+                }
+                return true;
+            };
+            if (!(await walk(resolved, shownRoot, 0))) {
+                failures += `find: stopped (Ctrl-C) after ${folders} folders; ${found} found so far\n`;
+                break;
+            }
+        }
+    }
+    finally {
+        if (announced)
+            spinner.stop();
+    }
+    if (failures !== '')
+        process.exitCode = 1;
+    return { status: failures === '' ? 'ok' : 'error', rendered: out.join(''), renderedErr: failures === '' ? undefined : chalk.red(failures) };
+}
+//# sourceMappingURL=find.js.map

package/dist/builtins/fs/find.js.map

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

package/dist/builtins/games/show.d.ts

@@ -21,7 +21,7 @@ export declare function builtin_cmatrix(args: string[]): Promise<CommandEnvelope
 export declare function builtin_rain(args: string[]): Promise<CommandEnvelope>;
 /** `asciiquarium`: fish. */
 export declare function builtin_asciiquarium(args: string[]): Promise<CommandEnvelope>;
-/** `tetris`: falling blocks, in ARGUS. */
+/** `tetris`: falling blocks. */
 export declare function builtin_tetris(args: string[]): Promise<CommandEnvelope>;
-/** `snake`: the snake, in ARGUS. */
+/** `snake`: the snake. */
 export declare function builtin_snake(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/show.js

@@ -2,15 +2,16 @@
  * @file The showpieces — `sl`, `cmatrix`, `rain`, `asciiquarium` — and the
  * arcade: `tetris`, `snake`.
  *
- * Each is a program a surface with a canvas runs: ARGUS opens its GAMES
- * pane on the `games.show` model and draws. The console gets the text: a
- * still of the show, or the words that there is nothing to play here and
- * where there is.
+ * Each is a program on a cell grid (`@fnndsc/menu/games`). A terminal
+ * plays it in place: chell takes the screen on the `games.show` model, and
+ * gives it back on q, Esc or Ctrl-C. `--pane` asks ARGUS to draw it in its
+ * GAMES pane instead, as the deprecated transcript console always does.
+ * Every surface also gets the text: a still of the show, and how to play it.
  *
  * @module
  */
 import chalk from 'chalk';
-import { envelope_ok } from '@fnndsc/menu';
+import { envelope_ok, envelope_error } from '@fnndsc/menu';
 /**
  * The starship `sl` sends across the screen (a typo's punishment, as the
  * train was): the Constitution-class refit, side view, from the Star Trek
@@ -50,15 +51,20 @@ export function still_of(program, random = Math.random) {
         case 'snake': return ['  . . . . . . . .', '  . @ o o o . . .', '  . . . . o . . .', '  . . * . . . . .'];
     }
 }
-/** What the console says beside a still: where the moving one is. */
-function note_of(program, arcade) {
-    return arcade
-        ? chalk.gray(`${program} plays in ARGUS: type it there and the GAMES pane opens with the keys live (arrows; Esc gives the keyboard back).`)
-        : chalk.gray(`a still; ARGUS draws ${program} moving in its GAMES pane.`);
+/** What the console says beside a still: how the moving one is played. */
+function note_of(program, arcade, pane) {
+    if (pane)
+        return chalk.gray(`${program}: ARGUS draws it in its GAMES pane${arcade ? ' with the keys live (arrows; Esc gives the keyboard back)' : ''}.`);
+    return chalk.gray(`${program}: a terminal plays it in place${arcade ? ' (arrows steer)' : ''}; q, Esc or Ctrl-C leaves. --pane draws it in ARGUS's GAMES pane.`);
 }
 function show_run(program, args, arcade) {
+    const unknown = args.find((arg) => arg.startsWith('-') && arg !== '--pane');
+    if (unknown !== undefined)
+        return envelope_error(`${program}: unknown option '${unknown}' (--pane)\n`);
+    const pane = args.includes('--pane');
+    const rest = args.filter((arg) => arg !== '--pane');
     const still = still_of(program);
-    return envelope_ok(`${still.join('\n')}\n${note_of(program, arcade)}\n`, { kind: 'games.show', data: { program, args, arcade } });
+    return envelope_ok(`${still.join('\n')}\n${note_of(program, arcade, pane)}\n`, { kind: 'games.show', data: { program, args: rest, arcade, pane } });
 }
 /** `sl`: a starship crosses the screen. */
 export async function builtin_sl(args) { return show_run('sl', args, false); }
@@ -68,8 +74,8 @@ export async function builtin_cmatrix(args) { return show_run('cmatrix', args, f
 export async function builtin_rain(args) { return show_run('rain', args, false); }
 /** `asciiquarium`: fish. */
 export async function builtin_asciiquarium(args) { return show_run('aquarium', args, false); }
-/** `tetris`: falling blocks, in ARGUS. */
+/** `tetris`: falling blocks. */
 export async function builtin_tetris(args) { return show_run('tetris', args, true); }
-/** `snake`: the snake, in ARGUS. */
+/** `snake`: the snake. */
 export async function builtin_snake(args) { return show_run('snake', args, true); }
 //# sourceMappingURL=show.js.map

package/dist/builtins/games/show.js.map

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

package/dist/builtins/help.js

@@ -162,6 +162,21 @@ export const helpText = {
             '# /home/chris/feeds/Brain MRI Analysis/dircopy v2.1.1/data',
         ],
     },
+    find: {
+        posix: { group: 'Files', differs: 'walks the namespace through the listing cache; links are not followed' },
+        category: 'Navigation',
+        usage: 'find [path...] [expression]',
+        description: 'Walk from each path (. when none) and print the paths the expression selects. Tests and actions join by implicit AND, -o, ! (or -not) and parentheses. Folders are read from the listing cache, so a tree already seen is walked without asking CUBE. A long walk says how far it has got; Ctrl-C stops it and says where.',
+        options: [
+            '-name PATTERN, -iname PATTERN  The entry\'s name matches a shell pattern (-iname ignores case)',
+            '-path PATTERN, -ipath PATTERN  The printed path matches; * crosses /',
+            '-type f|d|l                    A file, a folder, a link',
+            '-newermt DATE                  Changed after DATE (2026-10-10, or an ISO time)',
+            '-maxdepth N, -mindepth N       Descend at most N levels; test only from level N',
+            '-print, -print0                Print the path (the default), or end it with NUL',
+        ],
+        examples: ["find ~ -name '*.nii'", 'find ~/feeds -maxdepth 2 -type d', "find . -name '*.json' -o -name '*.csv'", "find /proc/jobs -maxdepth 1 -newermt 2026-10-10"],
+    },
     cat: {
         posix: { group: 'Files', differs: 'reads CFS files (and a pipe)' },
         category: 'Files',
@@ -502,39 +517,39 @@ export const helpText = {
         examples: ['stopwatch start', 'stopwatch lap', 'stopwatch', 'stopwatch stop'],
     },
     sl: {
-        usage: 'sl',
+        usage: 'sl [--pane]',
         summary: 'A starship crosses the screen (the punishment for mistyping ls)',
-        description: 'The train of old, refitted: in ARGUS the GAMES pane opens and a starship glides across it; a console with no canvas gets a still of it.',
-        examples: ['sl'],
+        description: 'The train of old, refitted: a starship glides across the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS\'s GAMES pane instead (the transcript console always does).',
+        examples: ['sl', 'sl --pane'],
     },
     cmatrix: {
-        usage: 'cmatrix',
+        usage: 'cmatrix [--pane]',
         summary: 'The glyph rain',
-        description: 'Columns of glyphs falling in ARGUS\'s GAMES pane; a console with no canvas gets one frame of it.',
-        examples: ['cmatrix'],
+        description: 'Columns of glyphs falling down the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS\'s GAMES pane instead (the transcript console always does).',
+        examples: ['cmatrix', 'cmatrix --pane'],
     },
     rain: {
-        usage: 'rain',
+        usage: 'rain [--pane]',
         summary: 'Rain',
-        description: 'Drops falling and ringing out on the floor in ARGUS\'s GAMES pane; a console with no canvas gets one frame of it.',
+        description: 'Drops falling and ringing out on the floor of the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS\'s GAMES pane instead (the transcript console always does).',
         examples: ['rain'],
     },
     asciiquarium: {
-        usage: 'asciiquarium',
+        usage: 'asciiquarium [--pane]',
         summary: 'An aquarium: fish, weed, bubbles',
-        description: 'Fish swimming both ways, weed swaying, bubbles rising, in ARGUS\'s GAMES pane; a console with no canvas gets a still.',
+        description: 'Fish swimming both ways, weed swaying, bubbles rising, in the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS\'s GAMES pane instead (the transcript console always does).',
         examples: ['asciiquarium'],
     },
     tetris: {
-        usage: 'tetris',
-        summary: 'Falling blocks (in ARGUS)',
-        description: 'Played in ARGUS\'s GAMES pane: left/right move, up rotates, down drops, Esc gives the keyboard back. A terminal gets a still and the words that the game lives in ARGUS.',
-        examples: ['tetris'],
+        usage: 'tetris [--pane]',
+        summary: 'Falling blocks',
+        description: 'Played in the terminal: left/right move, up rotates, down drops. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS\'s GAMES pane instead (the transcript console always does).',
+        examples: ['tetris', 'tetris --pane'],
     },
     snake: {
-        usage: 'snake',
-        summary: 'The snake (in ARGUS)',
-        description: 'Played in ARGUS\'s GAMES pane: arrows steer, eat the food, do not eat yourself. A terminal gets a still and the words that the game lives in ARGUS.',
+        usage: 'snake [--pane]',
+        summary: 'The snake',
+        description: 'Played in the terminal: arrows (or hjkl, wasd) steer; eat the food, do not eat yourself. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS\'s GAMES pane instead (the transcript console always does).',
         examples: ['snake'],
     },
     quiz: {
@@ -599,6 +614,12 @@ export const helpText = {
         description: 'Prints a month or year calendar with today highlighted, in the spirit of UNIX cal.',
         examples: ['cal', 'cal 2026', 'cal 7 2026'],
     },
+    clear: {
+        category: 'Settings',
+        usage: 'clear',
+        description: 'Empty the console: the screen and its scrollback in a terminal, the record in the transcript. Ctrl-L clears the screen alone.',
+        examples: ['clear'],
+    },
     prompt: {
         category: 'Settings',
         usage: 'prompt [list | <theme>]',