@fnndsc/brasa 0.31.5 → 0.32.0

package/dist/builtins/games/text.js

@@ -0,0 +1,133 @@
+/**
+ * @file Text toys from the shelf: `rev`, `tac`, `yes`, `seq`, `shuf`, `rot13`.
+ *
+ * Each reads what was piped in, else its arguments, and answers in kind:
+ * `fortune | rev`, `rot13 hello`, `seq 1 2 9`. `yes` is bounded — a shell
+ * that never ends is not a toy — and says how many it printed.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import chalk from 'chalk';
+import { text_input } from './stdin.js';
+/** Lines `yes` prints when not told how many. */
+export const YES_DEFAULT = 10;
+/** The most lines `yes` prints however it is asked. */
+export const YES_MAX = 10_000;
+/** The most numbers `seq` prints. */
+export const SEQ_MAX = 100_000;
+/** Reverses each line's characters, keeping the lines. */
+export function text_rev(text) {
+    return text.split('\n').map((line) => [...line].reverse().join('')).join('\n');
+}
+/** Reverses the order of the lines. */
+export function text_tac(text) {
+    const trailing = text.endsWith('\n');
+    const lines = (trailing ? text.slice(0, -1) : text).split('\n');
+    return lines.reverse().join('\n') + (trailing ? '\n' : '');
+}
+/** The ROT13 of a text; letters only, case kept. */
+export function text_rot13(text) {
+    return text.replace(/[a-zA-Z]/g, (c) => {
+        const base = c <= 'Z' ? 65 : 97;
+        return String.fromCharCode(((c.charCodeAt(0) - base + 13) % 26) + base);
+    });
+}
+/**
+ * The numbers `seq` prints: `seq LAST`, `seq FIRST LAST`, `seq FIRST STEP LAST`.
+ *
+ * @returns The numbers, or a refusal.
+ */
+export function seq_numbers(args) {
+    const nums = args.map(Number);
+    if (nums.length === 0 || nums.length > 3 || nums.some((n) => !Number.isFinite(n))) {
+        return { refusal: 'seq: usage: seq [FIRST [STEP]] LAST' };
+    }
+    const [first, step, last] = nums.length === 1 ? [1, 1, nums[0]]
+        : nums.length === 2 ? [nums[0], 1, nums[1]]
+            : [nums[0], nums[1], nums[2]];
+    if (step === 0)
+        return { refusal: 'seq: STEP must not be zero' };
+    const numbers = [];
+    for (let n = first; step > 0 ? n <= last : n >= last; n += step) {
+        numbers.push(Number(n.toFixed(10)));
+        if (numbers.length >= SEQ_MAX)
+            break;
+    }
+    return { numbers };
+}
+/** Shuffles lines (Fisher–Yates), with an optional source of chance for tests. */
+export function lines_shuffle(lines, random = Math.random) {
+    const out = [...lines];
+    for (let i = out.length - 1; i > 0; i--) {
+        const j = Math.floor(random() * (i + 1));
+        [out[i], out[j]] = [out[j], out[i]];
+    }
+    return out;
+}
+/** `rev [text]` */
+export async function builtin_rev(args) {
+    const text = text_input(args);
+    if (text === null)
+        return envelope_error('', undefined, 'rev: nothing to reverse (pipe text in, or give it)\n');
+    const out = text_rev(text.replace(/\n$/, ''));
+    return envelope_ok(`${out}\n`, { kind: 'games.rev', data: { text: out } });
+}
+/** `tac [text]` */
+export async function builtin_tac(args) {
+    const text = text_input(args);
+    if (text === null)
+        return envelope_error('', undefined, 'tac: nothing to turn over (pipe lines in)\n');
+    const out = text_tac(text.endsWith('\n') ? text : `${text}\n`);
+    return envelope_ok(out, { kind: 'games.tac', data: { text: out } });
+}
+/** `yes [word] [-n N]` */
+export async function builtin_yes(args) {
+    let count = YES_DEFAULT;
+    const words = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '-n') {
+            const n = Number(args[i + 1]);
+            if (!Number.isInteger(n) || n < 1)
+                return envelope_error('', undefined, 'yes: -n wants a positive whole number\n');
+            count = Math.min(n, YES_MAX);
+            i++;
+        }
+        else {
+            words.push(args[i]);
+        }
+    }
+    const word = words.length > 0 ? words.join(' ') : 'y';
+    const lines = `${word}\n`.repeat(count);
+    // Bounded on purpose, and it says so: the real yes runs until killed.
+    const note = chalk.gray(`yes: ${count} of forever (-n N for more, up to ${YES_MAX})\n`);
+    return envelope_ok(lines + note, { kind: 'games.yes', data: { word, count } });
+}
+/** `seq [FIRST [STEP]] LAST` */
+export async function builtin_seq(args) {
+    const answer = seq_numbers(args);
+    if ('refusal' in answer)
+        return envelope_error('', undefined, `${answer.refusal}\n`);
+    const note = answer.numbers.length >= SEQ_MAX ? chalk.gray(`seq: stopped at ${SEQ_MAX} numbers\n`) : '';
+    return envelope_ok(`${answer.numbers.join('\n')}\n${note}`, { kind: 'games.seq', data: { numbers: answer.numbers } });
+}
+/** `shuf [words...]`: lines piped in, or the words given, in a random order. */
+export async function builtin_shuf(args) {
+    const piped = text_input([]);
+    const lines = piped !== null
+        ? piped.replace(/\n$/, '').split('\n')
+        : args;
+    if (lines.length === 0)
+        return envelope_error('', undefined, 'shuf: nothing to shuffle (pipe lines in, or give words)\n');
+    const out = lines_shuffle(lines);
+    return envelope_ok(`${out.join('\n')}\n`, { kind: 'games.shuf', data: { lines: out } });
+}
+/** `rot13 [text]` */
+export async function builtin_rot13(args) {
+    const text = text_input(args);
+    if (text === null)
+        return envelope_error('', undefined, 'rot13: nothing to turn (pipe text in, or give it)\n');
+    const out = text_rot13(text.replace(/\n$/, ''));
+    return envelope_ok(`${out}\n`, { kind: 'games.rot13', data: { text: out } });
+}
+//# sourceMappingURL=text.js.map

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

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

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

@@ -0,0 +1,13 @@
+/**
+ * @file `wtf`: what an acronym means, from the book in `wtf.data.ts`.
+ *
+ * `wtf is lonk`, `wtf lonk`, `wtf cube pfdcm`. A term the book lacks is
+ * said so; `wtf -l` lists every term it has.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** The meanings of a term, or none. */
+export declare function wtf_lookup(term: string): ReadonlyArray<string>;
+/** `wtf [is] <term>... | wtf -l` */
+export declare function builtin_wtf(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/wtf.data.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @file What the acronyms around here mean: the book `wtf` reads from.
+ *
+ * BSD's `wtf` read /usr/share/misc/acronyms. Ours reads this: the ChRIS and
+ * DICOM words a new user meets in their first hour, and the names of the
+ * mise packages. Keys are matched without regard to case; a key may have
+ * several meanings, each its own line.
+ *
+ * @module
+ */
+/** The book: a term to its meanings. */
+export declare const ACRONYMS: Readonly<Record<string, ReadonlyArray<string>>>;

package/dist/builtins/games/wtf.data.js

@@ -0,0 +1,70 @@
+/**
+ * @file What the acronyms around here mean: the book `wtf` reads from.
+ *
+ * BSD's `wtf` read /usr/share/misc/acronyms. Ours reads this: the ChRIS and
+ * DICOM words a new user meets in their first hour, and the names of the
+ * mise packages. Keys are matched without regard to case; a key may have
+ * several meanings, each its own line.
+ *
+ * @module
+ */
+/** The book: a term to its meanings. */
+export const ACRONYMS = {
+    chris: ['ChRIS — the ChRIS Research Integration System: a platform that runs containerised analyses (plugins) on medical data, by the FNNDSC at Boston Children\'s Hospital'],
+    cube: ['CUBE — the ChRIS Ultron Back End: the REST API and database every ChRIS surface talks to (a Django app)'],
+    fnndsc: ['FNNDSC — the Fetal-Neonatal Neuroimaging and Developmental Science Center, Boston Children\'s Hospital; ChRIS\'s home'],
+    feed: ['feed — one analysis in ChRIS: a tree of plugin instances rooted on some data; what ARGUS lists under ANALYSES'],
+    plugin: ['plugin — a containerised program ChRIS can run; a step in a feed. Kinds: fs (makes data from nothing), ds (data in, data out), ts (joins several parents)'],
+    pipeline: ['pipeline — a saved shape of plugins to run in order, with their parameters; what `pipeline run` starts and `/bin` lists'],
+    instance: ['plugin instance — one run of a plugin inside a feed, with its own parameters, status and output folder; a job'],
+    job: ['job — a plugin instance, as `proc` and the dashboard count them'],
+    cfs: ['CFS — the ChRIS filesystem: the files CUBE holds, under /home/<user>, /SERVICES/PACS, /PIPELINES, /SHARED and /PUBLIC'],
+    swift: ['Swift — the object store CUBE kept files in originally; the paths in CFS still look like it'],
+    pfcon: ['pfcon — the process-and-file controller: the service CUBE hands a plugin run to, which stages the data and starts the container'],
+    pman: ['pman — the process manager behind pfcon: starts containers on a compute (Docker, Swarm, Kubernetes, Slurm)'],
+    pfdcm: ['pfdcm — the PACS front end: the service that asks a PACS (C-FIND) and tells it to send (C-MOVE); `pacs query` and `pull` go through it'],
+    oxidicom: ['oxidicom — the DICOM receiver (in Rust) that the PACS sends files to; it stores them and registers them in CUBE, and reports progress over LONK'],
+    lonk: ['LONK — Light Oxidicom NotifiKations: the small messages oxidicom publishes (over NATS) as a series arrives: a file count, done, or an error'],
+    nats: ['NATS — the message bus oxidicom publishes LONK on; CUBE relays it to a websocket a pull watches'],
+    pacs: ['PACS — Picture Archiving and Communication System: the hospital\'s image archive, spoken to in DICOM'],
+    dicom: ['DICOM — Digital Imaging and Communications in Medicine: the file format and the network protocol of medical imaging'],
+    'c-find': ['C-FIND — the DICOM query: ask a PACS what it holds (`pacs query`)'],
+    'c-move': ['C-MOVE — the DICOM retrieve: tell a PACS to send a study or series to a receiver (`pull`, with oxidicom receiving)'],
+    'c-store': ['C-STORE — the DICOM send: one image delivered to a receiver; what a C-MOVE sets off, many times'],
+    ae: ['AE title — Application Entity title: the name a DICOM node goes by on the network (the receiver here is an AE title the PACS knows)'],
+    aetitle: ['AE title — Application Entity title: the name a DICOM node goes by on the network'],
+    mrn: ['MRN — Medical Record Number: the hospital\'s patient identifier; PatientID in DICOM'],
+    accession: ['accession number — the identifier of one imaging order/study at the hospital; AccessionNumber in DICOM'],
+    study: ['study — one imaging visit in DICOM, holding series'],
+    series: ['series — one acquisition in a study: a stack of images of one kind (an axial T1, say); what `pull` fetches'],
+    sop: ['SOP — Service-Object Pair: DICOM\'s name for a kind of object (an MR image) and the services on it; a SOPInstanceUID names one image'],
+    uid: ['UID — a DICOM unique identifier (dotted numbers): StudyInstanceUID, SeriesInstanceUID, SOPInstanceUID'],
+    modality: ['modality — the kind of scanner: MR, CT, US, CR, DX, PT …'],
+    mpr: ['MPR — multiplanar reconstruction: a volume resliced into other planes'],
+    sr: ['SR — Structured Report: a DICOM document rather than an image (a radiology report); a PACS will often not send these'],
+    hu: ['HU — Hounsfield unit: CT intensity, water at 0, air at −1000'],
+    nifti: ['NIfTI — the neuroimaging volume format (.nii, .nii.gz) most analysis tools read; what DICOM gets converted to'],
+    bids: ['BIDS — the Brain Imaging Data Structure: a folder and naming convention for neuroimaging datasets'],
+    freesurfer: ['FreeSurfer — the brain MRI analysis suite (cortical surfaces, segmentations) many ChRIS plugins wrap'],
+    seagap: ['SeaGaP — Search, Gather, Process: the ChRIS workflow ARGUS is built around — find data, gather a cohort, run a pipeline on it'],
+    cohort: ['cohort — the set of series or files gathered to process together; GATHER in ARGUS; kept in ~/gather'],
+    mise: ['mise — this framework: an intent kernel (brasa) with surfaces (chell, ARGUS); the name is "mise en place"'],
+    brasa: ['brasa — the intent kernel: every command\'s meaning, returning typed envelopes; knows no surface'],
+    chell: ['chell — the terminal surface: a shell over brasa; also the program that starts a daemon'],
+    calypso: ['CALYPSO — the daemon: one session many surfaces attach to over a websocket; Accepts Language, Yielding Permitted Shell Operations'],
+    argus: ['ARGUS — the browser surface: panes over the same session, drawn in LCARS'],
+    porter: ['porter — the display manager: the door (login) that starts or finds a user\'s daemon and serves ARGUS behind it'],
+    menu: ['menu — the wire package: the message and model schemas every surface and the daemon agree on'],
+    cumin: ['cumin — the base library: the CUBE client, connection, caches and the error stack'],
+    salsa: ['salsa — the data layer: files, feeds, the virtual filesystem providers, the retrieve watch'],
+    chili: ['chili — the older command layer: the path mapper and the commands brasa still delegates to'],
+    orrery: ['orrery — the scene package: molecules, galaxies and the universe, drawn for ARGUS'],
+    envelope: ['envelope — what a command returns: rendered text, a status, and a typed model a surface may draw'],
+    lcars: ['LCARS — Library Computer Access/Retrieval System: the Star Trek interface ARGUS\'s look is after'],
+    aegis: ['AEGIS — ARGUS\'s interface standard: the laws every pane obeys, in apps/argus/docs/aegis.adoc'],
+    harbor: ['HARBOR — the project board the mise epics are tracked on'],
+    k8s: ['k8s — Kubernetes, which runs CUBE and its services here'],
+    oidc: ['OIDC — OpenID Connect; how the mise packages publish to npm without a token'],
+    wtf: ['wtf — this: BSD\'s acronym expander, with this book instead of /usr/share/misc/acronyms'],
+};
+//# sourceMappingURL=wtf.data.js.map

package/dist/builtins/games/wtf.data.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wtf.data.js","sourceRoot":"","sources":["../../../src/builtins/games/wtf.data.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,wCAAwC;AACxC,MAAM,CAAC,MAAM,QAAQ,GAAoD;IACvE,KAAK,EAAE,CAAC,oKAAoK,CAAC;IAC7K,IAAI,EAAE,CAAC,yGAAyG,CAAC;IACjH,MAAM,EAAE,CAAC,uHAAuH,CAAC;IACjI,IAAI,EAAE,CAAC,+GAA+G,CAAC;IACvH,MAAM,EAAE,CAAC,2JAA2J,CAAC;IACrK,QAAQ,EAAE,CAAC,yHAAyH,CAAC;IACrI,QAAQ,EAAE,CAAC,+GAA+G,CAAC;IAC3H,GAAG,EAAE,CAAC,iEAAiE,CAAC;IACxE,GAAG,EAAE,CAAC,uHAAuH,CAAC;IAC9H,KAAK,EAAE,CAAC,6FAA6F,CAAC;IACtG,KAAK,EAAE,CAAC,iIAAiI,CAAC;IAC1I,IAAI,EAAE,CAAC,4GAA4G,CAAC;IACpH,KAAK,EAAE,CAAC,wIAAwI,CAAC;IACjJ,QAAQ,EAAE,CAAC,iJAAiJ,CAAC;IAC7J,IAAI,EAAE,CAAC,6IAA6I,CAAC;IACrJ,IAAI,EAAE,CAAC,iGAAiG,CAAC;IACzG,IAAI,EAAE,CAAC,sGAAsG,CAAC;IAC9G,KAAK,EAAE,CAAC,qHAAqH,CAAC;IAC9H,QAAQ,EAAE,CAAC,mEAAmE,CAAC;IAC/E,QAAQ,EAAE,CAAC,oHAAoH,CAAC;IAChI,SAAS,EAAE,CAAC,iGAAiG,CAAC;IAC9G,EAAE,EAAE,CAAC,qIAAqI,CAAC;IAC3I,OAAO,EAAE,CAAC,mFAAmF,CAAC;IAC9F,GAAG,EAAE,CAAC,qFAAqF,CAAC;IAC5F,SAAS,EAAE,CAAC,wGAAwG,CAAC;IACrH,KAAK,EAAE,CAAC,oDAAoD,CAAC;IAC7D,MAAM,EAAE,CAAC,4GAA4G,CAAC;IACtH,GAAG,EAAE,CAAC,sIAAsI,CAAC;IAC7I,GAAG,EAAE,CAAC,uGAAuG,CAAC;IAC9G,QAAQ,EAAE,CAAC,0DAA0D,CAAC;IACtE,GAAG,EAAE,CAAC,uEAAuE,CAAC;IAC9E,EAAE,EAAE,CAAC,sHAAsH,CAAC;IAC5H,EAAE,EAAE,CAAC,8DAA8D,CAAC;IACpE,KAAK,EAAE,CAAC,+GAA+G,CAAC;IACxH,IAAI,EAAE,CAAC,mGAAmG,CAAC;IAC3G,UAAU,EAAE,CAAC,sGAAsG,CAAC;IACpH,MAAM,EAAE,CAAC,+HAA+H,CAAC;IACzI,MAAM,EAAE,CAAC,qGAAqG,CAAC;IAC/G,IAAI,EAAE,CAAC,2GAA2G,CAAC;IACnH,KAAK,EAAE,CAAC,kGAAkG,CAAC;IAC3G,KAAK,EAAE,CAAC,yFAAyF,CAAC;IAClG,OAAO,EAAE,CAAC,mIAAmI,CAAC;IAC9I,KAAK,EAAE,CAAC,0EAA0E,CAAC;IACnF,MAAM,EAAE,CAAC,iHAAiH,CAAC;IAC3H,IAAI,EAAE,CAAC,8FAA8F,CAAC;IACtG,KAAK,EAAE,CAAC,mFAAmF,CAAC;IAC5F,KAAK,EAAE,CAAC,4FAA4F,CAAC;IACrG,KAAK,EAAE,CAAC,4FAA4F,CAAC;IACrG,MAAM,EAAE,CAAC,mFAAmF,CAAC;IAC7F,QAAQ,EAAE,CAAC,kGAAkG,CAAC;IAC9G,KAAK,EAAE,CAAC,kGAAkG,CAAC;IAC3G,KAAK,EAAE,CAAC,+FAA+F,CAAC;IACxG,MAAM,EAAE,CAAC,0DAA0D,CAAC;IACpE,GAAG,EAAE,CAAC,yDAAyD,CAAC;IAChE,IAAI,EAAE,CAAC,6EAA6E,CAAC;IACrF,GAAG,EAAE,CAAC,yFAAyF,CAAC;CACjG,CAAC"}

package/dist/builtins/games/wtf.js

@@ -0,0 +1,45 @@
+/**
+ * @file `wtf`: what an acronym means, from the book in `wtf.data.ts`.
+ *
+ * `wtf is lonk`, `wtf lonk`, `wtf cube pfdcm`. A term the book lacks is
+ * said so; `wtf -l` lists every term it has.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import chalk from 'chalk';
+import { ACRONYMS } from './wtf.data.js';
+import { text_input } from './stdin.js';
+/** The meanings of a term, or none. */
+export function wtf_lookup(term) {
+    const key = term.trim().toLowerCase().replace(/[?.!,]+$/, '');
+    return ACRONYMS[key] ?? ACRONYMS[key.replace(/-/g, '')] ?? [];
+}
+/** `wtf [is] <term>... | wtf -l` */
+export async function builtin_wtf(args) {
+    if (args[0] === '-l' || args[0] === '--list') {
+        const terms = Object.keys(ACRONYMS).sort();
+        return envelope_ok(`${terms.join('  ')}\n`, { kind: 'games.wtf', data: { terms } });
+    }
+    const text = text_input(args);
+    const words = (text ?? '').trim().split(/\s+/).filter((w) => w.length > 0 && !/^(is|are|the|a|an)$/i.test(w));
+    if (words.length === 0)
+        return envelope_error('', undefined, 'wtf: usage: wtf [is] <term>   (wtf -l lists the terms)\n');
+    const lines = [];
+    const found = {};
+    for (const word of words) {
+        const meanings = wtf_lookup(word);
+        if (meanings.length === 0) {
+            lines.push(`${chalk.cyan(word.toUpperCase())}: ${chalk.gray('nothing known. Gee... I don\'t know what that means (wtf -l lists what I do)')}`);
+            continue;
+        }
+        found[word.toLowerCase()] = meanings;
+        // A meaning names its term first; the term is lit rather than repeated.
+        for (const meaning of meanings) {
+            const dash = meaning.indexOf(' — ');
+            lines.push(dash > 0 ? `${chalk.cyan(meaning.slice(0, dash))} — ${meaning.slice(dash + 3)}` : `${chalk.cyan(word.toUpperCase())}: ${meaning}`);
+        }
+    }
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.wtf', data: { terms: words, found } });
+}
+//# sourceMappingURL=wtf.js.map

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

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

package/dist/builtins/help.d.ts

@@ -87,6 +87,14 @@ export declare function builtin_help(args: string[]): Promise<CommandEnvelope>;
  * @returns Array of builtin command names.
  */
 export declare function builtinCommands_list(): string[];
+/**
+ * A command's one-line summary (its `summary`, else its description), for
+ * a listing that names many commands at once.
+ *
+ * @param command - The command.
+ * @returns The line, or undefined for a command with no help entry.
+ */
+export declare function commandSummary_get(command: string): string | undefined;
 /**
  * Gets the description for a builtin command.
  *