@fnndsc/brasa 0.56.1 → 0.56.3

package/dist/builtins/net/netstat.d.ts

@@ -9,10 +9,35 @@ import { type CommandEnvelope } from '@fnndsc/menu';
  */
 export declare function netstat_render(snapshot: LedgerSnapshot, last: number): string;
 /**
- * `netstat [-n <count>] [-r]`
+ * `netstat [-r] [-n <count>]`: the declaration.
  *
- * @param args - `-n <count>` lists that many recent requests; `-r` / `--reset`
- *   forgets the count (the readout then shows what was forgotten).
- * @returns The ledger as text and as the `net.stats` model.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [netstatCommand] }, 'backend');
+ * ```
+ */
+export declare const netstatCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly options: {
+        readonly reset: {
+            readonly short: "r";
+            readonly long: "reset";
+            readonly summary: "Forget the count after showing it";
+        };
+        readonly count: {
+            readonly short: "n";
+            readonly summary: `List that many recent requests (default ${number})`;
+            readonly value: {
+                readonly name: "count";
+                readonly kind: "int";
+                readonly min: 0;
+            };
+        };
+    };
+}>;
+/**
+ * `netstat` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `netstat`.
+ * @returns The ledger, or the refusal of a bad line.
  */
 export declare function builtin_netstat(args?: string[]): Promise<CommandEnvelope>;

package/dist/builtins/net/netstat.js

@@ -7,13 +7,32 @@
  * `netstat -r`), by endpoint family with the time spent, and the last few
  * timed. Smoke asserts budgets against the same model; an operator on a
  * slow day asks it before guessing where the time went.
+ *
+ * Declared in one record (`netstatCommand`): how many recent requests to
+ * list, and whether to reset the count.
+ *
+ * Key components:
+ * - netstatCommand: the declaration.
+ * - builtin_netstat: the declaration run over words already split.
+ * - netstat_render: the ledger as text.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_netstat(['-n', '30']);
+ * ```
+ *
+ * Dependencies: cumin's request ledger.
+ *
+ * @module
  */
 import chalk from 'chalk';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 // The ledger by its own door: a jest ESM test importing a name from the
 // cumin ROOT overflows cjs-module-lexer on that index and sees none of
 // the names added after the overflow — the subpath is small and seen whole.
 import { requestLedger_snapshot, requestLedger_reset } from '@fnndsc/cumin/request-ledger';
-import { NET_STATS_MODEL_KIND, envelope_ok, envelope_error } from '@fnndsc/menu';
+import { NET_STATS_MODEL_KIND, envelope_ok } from '@fnndsc/menu';
 /** How many recent requests the table shows unless asked otherwise. */
 const LAST_SHOWN = 10;
 /**
@@ -42,32 +61,54 @@ export function netstat_render(snapshot, last) {
     }
     return `${lines.join('\n')}\n`;
 }
+/** What a `netstat` line may hold. */
+const NETSTAT_GRAMMAR = {
+    options: {
+        reset: { short: 'r', long: 'reset', summary: 'Forget the count after showing it' },
+        count: { short: 'n', summary: `List that many recent requests (default ${LAST_SHOWN})`, value: { name: 'count', kind: 'int', min: 0 } },
+    },
+};
 /**
- * `netstat [-n <count>] [-r]`
+ * `netstat [-r] [-n <count>]`: the declaration.
  *
- * @param args - `-n <count>` lists that many recent requests; `-r` / `--reset`
- *   forgets the count (the readout then shows what was forgotten).
- * @returns The ledger as text and as the `net.stats` model.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [netstatCommand] }, 'backend');
+ * ```
+ */
+export const netstatCommand = command_declare({
+    name: 'netstat',
+    grammar: NETSTAT_GRAMMAR,
+    help: {
+        summary: 'What the session has asked of CUBE',
+        description: 'What the session has asked of CUBE: requests since the session (or the last reset), by endpoint family with the time spent, and the last few timed',
+        category: 'Connection',
+        examples: [
+            'netstat              # the count, by family, the last 10',
+            'netstat -n 30        # the last 30 requests, timed',
+            'netstat -r; cd ~/feeds; netstat   # what one navigation costs',
+        ],
+    },
+    handler: async (args) => netstat_run(args.options.count ?? LAST_SHOWN, args.options.reset),
+});
+/**
+ * `netstat` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `netstat`.
+ * @returns The ledger, or the refusal of a bad line.
  */
 export async function builtin_netstat(args = []) {
-    let last = LAST_SHOWN;
-    let reset = false;
-    for (let index = 0; index < args.length; index++) {
-        const arg = args[index];
-        if (arg === '-r' || arg === '--reset') {
-            reset = true;
-            continue;
-        }
-        if (arg === '-n') {
-            const value = Number(args[index + 1]);
-            if (!Number.isInteger(value) || value < 0)
-                return envelope_error('', undefined, `${chalk.red('netstat: -n takes a count')}\n`);
-            last = value;
-            index += 1;
-            continue;
-        }
-        return envelope_error('', undefined, `${chalk.red(`netstat: unknown option ${arg}`)}\n`);
-    }
+    return declaredCommand_run(netstatCommand, args);
+}
+/**
+ * Reads the ledger, and resets it when asked; the readout then shows what
+ * was forgotten.
+ *
+ * @param last - How many recent requests to list.
+ * @param reset - Forget the count after reading it.
+ * @returns The ledger as text and as the `net.stats` model.
+ */
+function netstat_run(last, reset) {
     const snapshot = requestLedger_snapshot({ last: Math.max(last, LAST_SHOWN) });
     if (reset)
         requestLedger_reset();

package/dist/builtins/net/netstat.js.map

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

package/dist/builtins/net/pacs.d.ts

@@ -2,27 +2,181 @@
  * @file Compound `pacs` command.
  *
  * Entry point for all PACS operations: server context management, querying,
- * and series retrieval. `pacs query` and `pacs pull` delegate to the standalone
- * builtins, which remain registered as permanent top-level aliases.
+ * and series retrieval. Declared in one record (`pacsCommand`) with a
+ * subcommand each; `pacs query` and `pacs pull` take the very lines of the
+ * standalone `query` and `pull` (one grammar each) and run their handlers.
+ *
+ * Key components:
+ * - pacsCommand: the declaration.
+ * - builtin_pacs: the declaration run over words already split.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_pacs(['connect', 'PACSDCM']);
+ * ```
+ *
+ * Dependencies: cumin's context and server listing; the query, pull and
+ * status verbs.
  *
  * @module
  */
 import { type CommandEnvelope } from '@fnndsc/menu';
 /**
- * PACS subsystem command — server context management, query, and pull.
- *
- * Subcommands:
- *   pacs                      — show active server
- *   pacs connect              — list servers with active marked
- *   pacs connect <name|id>    — set active PACS server
- *   pacs disconnect           — clear active PACS server
- *   pacs list                 — list servers (alias for: pacs connect)
- *   pacs query <Key:Value...> — create PACS query and wait for results
- *   pacs pull <vfs-path...>   — pull DICOM series into ChRIS storage
- *   pacs status <target>      — per-series pulled/pending report with CUBE paths
- *
- * @param args - Command arguments (subcommand + its own args).
+ * `pacs [connect [server] | disconnect | list | query … | pull … | status <target>]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsCommand] }, 'backend');
+ * ```
+ */
+export declare const pacsCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly bare: {
+        readonly summary: "Show the active PACS server";
+    };
+    readonly subcommands: {
+        readonly connect: {
+            readonly summary: "List the registered PACS servers with the active one marked; given one, make it active";
+            readonly operands: readonly [{
+                readonly name: "server";
+                readonly kind: "word";
+                readonly optional: true;
+                readonly summary: "The server, by identifier or by id";
+            }];
+        };
+        readonly disconnect: {
+            readonly summary: "Clear the active PACS server";
+        };
+        readonly list: {
+            readonly summary: "List the registered PACS servers with the active one marked";
+        };
+        readonly query: {
+            readonly summary: "Create a PACS query and wait for its answer, as query does (help query)";
+            readonly operands: readonly [{
+                readonly name: "expression";
+                readonly kind: "word";
+                readonly optional: true;
+                readonly repeat: true;
+                readonly summary: "The question: Key:Value[,Key:Value…] (Key:a,b,c asks for each), or a JSON object";
+            }];
+            readonly options: {
+                readonly title: {
+                    readonly long: "title";
+                    readonly summary: "Title for the query record (default: Query <timestamp>)";
+                    readonly value: {
+                        readonly name: "title";
+                        readonly kind: "word";
+                    };
+                };
+                readonly pacsserver: {
+                    readonly long: "pacsserver";
+                    readonly summary: "Override the PACS server (default: the context's); a comma-separated list asks each";
+                    readonly value: {
+                        readonly name: "id";
+                        readonly kind: "word";
+                    };
+                };
+                readonly patients: {
+                    readonly long: "patients";
+                    readonly summary: "Ask after several patients: MRNs comma-separated, or @<cfs-file> (one per line)";
+                    readonly value: {
+                        readonly name: "list";
+                        readonly kind: "word";
+                    };
+                };
+                readonly csv: {
+                    readonly long: "csv";
+                    readonly summary: "Render the answer as CSV (a row per study, and one per patient with none)";
+                };
+                readonly csvTo: {
+                    readonly long: "csv-to";
+                    readonly asks: true;
+                    readonly summary: "Write that CSV into ChRIS storage; given no path, the destination is asked for";
+                    readonly value: {
+                        readonly name: "cfs-path";
+                        readonly kind: "cfsPath";
+                    };
+                };
+                readonly force: {
+                    readonly long: "force";
+                    readonly summary: "Overwrite the table at that path; without it, an existing file is kept";
+                };
+                readonly table: {
+                    readonly long: "table";
+                    readonly summary: "Show the answer's rows as an aligned table: the CSV's columns, for a screen";
+                };
+                readonly series: {
+                    readonly long: "series";
+                    readonly summary: "One row per series instead of per study; alone, it shows the series table";
+                };
+                readonly anon: {
+                    readonly long: "anon";
+                    readonly summary: "Stand in for names and record numbers (for demonstrating on a live PACS)";
+                };
+                readonly fresh: {
+                    readonly long: "fresh";
+                    readonly summary: "Ask the PACS even if this question was answered before";
+                };
+            };
+        };
+        readonly pull: {
+            readonly summary: "Pull DICOM series into ChRIS storage, as pull does (help pull)";
+            readonly operands: readonly [{
+                readonly name: "target";
+                readonly kind: "pacsQuery";
+                readonly repeat: true;
+                readonly glob: true;
+                readonly summary: "A /net/pacs/queries/… path (a query, a study or a series), or a Key:Value question asked first";
+            }];
+            readonly options: {
+                readonly detach: {
+                    readonly long: "detach";
+                    readonly summary: "Fire the retrieves and return the handles at once: <seriesUID> <retrieveId> per line";
+                };
+                readonly nowait: {
+                    readonly long: "nowait";
+                    readonly summary: "The older spelling of --detach";
+                };
+                readonly retry: {
+                    readonly long: "retry";
+                    readonly summary: "Re-fire retrieves for [NO LONK] series up to N more times";
+                    readonly value: {
+                        readonly name: "N";
+                        readonly kind: "int";
+                        readonly min: 0;
+                    };
+                };
+                readonly newFeed: {
+                    readonly long: "new-feed";
+                    readonly repeat: true;
+                    readonly summary: "Create one named feed from the complete retrieved selection";
+                    readonly value: {
+                        readonly name: "title";
+                        readonly kind: "word";
+                    };
+                };
+            };
+        };
+        readonly status: {
+            readonly summary: "Per series, what has landed in CUBE and what is missing, with in-CUBE paths";
+            readonly operands: readonly [{
+                readonly name: "target";
+                readonly kind: "pacsQuery";
+                readonly glob: true;
+                readonly summary: "A query id, a /net/pacs/queries/… path, or a Key:Value question";
+            }];
+        };
+    };
+}>;
+/**
+ * `pacs` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The subcommand and its words.
  * @returns An envelope; streaming subcommands carry empty rendered text and
  *   emit their output live, while query/pull return their own envelopes.
+ *
+ * @example
+ * ```ts
+ * await builtin_pacs(['list']);
+ * ```
  */
 export declare function builtin_pacs(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/net/pacs.js

@@ -2,22 +2,38 @@
  * @file Compound `pacs` command.
  *
  * Entry point for all PACS operations: server context management, querying,
- * and series retrieval. `pacs query` and `pacs pull` delegate to the standalone
- * builtins, which remain registered as permanent top-level aliases.
+ * and series retrieval. Declared in one record (`pacsCommand`) with a
+ * subcommand each; `pacs query` and `pacs pull` take the very lines of the
+ * standalone `query` and `pull` (one grammar each) and run their handlers.
+ *
+ * Key components:
+ * - pacsCommand: the declaration.
+ * - builtin_pacs: the declaration run over words already split.
+ *
+ * Typical usage:
+ * ```ts
+ * await builtin_pacs(['connect', 'PACSDCM']);
+ * ```
+ *
+ * Dependencies: cumin's context and server listing; the query, pull and
+ * status verbs.
  *
  * @module
  */
 import chalk from 'chalk';
 import { chrisContext, pacsServers_list } from '@fnndsc/cumin';
 import { PACS_SERVERS_MODEL_KIND, envelope_ok, envelope_error } from '@fnndsc/menu';
-import { builtin_query } from './query.js';
+import { queryLine_run } from './query.js';
+import { QUERY_GRAMMAR } from './query.args.js';
 import { pacsRefusal_hint, pacsRefusal_is } from './pacsAccess.js';
-import { builtin_pacsStatus } from './status.js';
-import { builtin_pull } from '../fs/pull.js';
-import { args_checkHasHelpFlag, help_render } from '../help.js';
+import { pacsStatus_run } from './status.js';
+import { pullLine_run } from '../fs/pull.js';
+import { PULL_GRAMMAR } from '../fs/pull.args.js';
 import { sink_dataLine, sink_errLine } from '../../core/sink.js';
 import { errorStack } from '@fnndsc/fond';
 import { exitCode_set } from '../../core/handlerRun.js';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 /**
  * Streams the list of registered PACS servers, marking the active one.
  *
@@ -84,30 +100,79 @@ async function serversModel_build(active) {
     }
     return servers.length > 0 ? { servers } : null;
 }
+/** What a `pacs` line may hold: a subcommand, or none for the active server. */
+const PACS_GRAMMAR = {
+    bare: { summary: 'Show the active PACS server' },
+    subcommands: {
+        connect: {
+            summary: 'List the registered PACS servers with the active one marked; given one, make it active',
+            operands: [{ name: 'server', kind: 'word', optional: true, summary: 'The server, by identifier or by id' }],
+        },
+        disconnect: { summary: 'Clear the active PACS server' },
+        list: { summary: 'List the registered PACS servers with the active one marked' },
+        query: { summary: 'Create a PACS query and wait for its answer, as query does (help query)', operands: QUERY_GRAMMAR.operands, options: QUERY_GRAMMAR.options },
+        pull: { summary: 'Pull DICOM series into ChRIS storage, as pull does (help pull)', operands: PULL_GRAMMAR.operands, options: PULL_GRAMMAR.options },
+        status: {
+            summary: 'Per series, what has landed in CUBE and what is missing, with in-CUBE paths',
+            operands: [{ name: 'target', kind: 'pacsQuery', glob: true, summary: 'A query id, a /net/pacs/queries/… path, or a Key:Value question' }],
+        },
+    },
+};
 /**
- * PACS subsystem command — server context management, query, and pull.
+ * `pacs [connect [server] | disconnect | list | query … | pull … | status <target>]`: the declaration.
  *
- * Subcommands:
- *   pacs                      — show active server
- *   pacs connect              — list servers with active marked
- *   pacs connect <name|id>    — set active PACS server
- *   pacs disconnect           — clear active PACS server
- *   pacs list                 — list servers (alias for: pacs connect)
- *   pacs query <Key:Value...> — create PACS query and wait for results
- *   pacs pull <vfs-path...>   — pull DICOM series into ChRIS storage
- *   pacs status <target>      — per-series pulled/pending report with CUBE paths
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pacsCommand] }, 'backend');
+ * ```
+ */
+export const pacsCommand = command_declare({
+    name: 'pacs',
+    grammar: PACS_GRAMMAR,
+    help: {
+        summary: 'PACS subsystem — server context, query, and series retrieval',
+        description: 'PACS subsystem — server context, query, and series retrieval. Bare, it names the active server. '
+            + 'pacs query and pacs pull take the lines query and pull take; their pages say more.',
+        category: 'PACS',
+        examples: [
+            'pacs                              # Show active server',
+            'pacs connect                      # List all servers',
+            'pacs connect PACSDCM              # Set active server by identifier',
+            'pacs connect 1                    # Set active server by numeric ID',
+            'pacs disconnect                   # Clear active server',
+            'pacs list                         # List all servers',
+            'pacs query PatientID:1234         # Query PACS',
+            'pacs pull /net/pacs/queries/42_AccessionNumber:12345678',
+            'pacs status AccessionNumber:22119730   # What has landed in CUBE, what is missing',
+        ],
+    },
+    handler: pacs_run,
+});
+/**
+ * `pacs` over words already split: the declaration's parse and handler.
  *
- * @param args - Command arguments (subcommand + its own args).
+ * @param args - The subcommand and its words.
  * @returns An envelope; streaming subcommands carry empty rendered text and
  *   emit their output live, while query/pull return their own envelopes.
+ *
+ * @example
+ * ```ts
+ * await builtin_pacs(['list']);
+ * ```
  */
 export async function builtin_pacs(args) {
-    if (args_checkHasHelpFlag(args, 'pacs')) {
-        return envelope_ok(help_render('pacs'));
-    }
-    const subcommand = args[0];
+    return declaredCommand_run(pacsCommand, args);
+}
+/**
+ * PACS subsystem command — server context management, query, and pull.
+ *
+ * @param args - The line, parsed.
+ * @returns An envelope; streaming subcommands carry empty rendered text and
+ *   emit their output live, while query/pull return their own envelopes.
+ */
+async function pacs_run(args) {
     // No subcommand — show active server
-    if (!subcommand) {
+    if (args.subcommand === null) {
         const active = await chrisContext.PACSserver_get();
         if (active) {
             sink_dataLine(`Active PACS server: ${chalk.cyan(active)}`);
@@ -121,9 +186,9 @@ export async function builtin_pacs(args) {
         }
         return envelope_ok('');
     }
-    switch (subcommand) {
+    switch (args.subcommand) {
         case 'connect': {
-            const target = args[1];
+            const target = args.operands.server;
             if (!target) {
                 const active = await chrisContext.PACSserver_get();
                 if (!(await servers_print(active))) {
@@ -168,17 +233,11 @@ export async function builtin_pacs(args) {
             return envelope_ok('', { kind: PACS_SERVERS_MODEL_KIND, data: model });
         }
         case 'query':
-            return builtin_query(args.slice(1));
+            return queryLine_run(args);
         case 'pull':
-            return builtin_pull(args.slice(1));
+            return pullLine_run(args);
         case 'status':
-            return builtin_pacsStatus(args.slice(1));
-        default:
-            sink_errLine(chalk.red(`pacs: Unknown subcommand '${subcommand}'`));
-            sink_dataLine(chalk.gray('  Subcommands: connect, disconnect, list, query, pull, status'));
-            sink_dataLine(chalk.gray('  Try: help pacs'));
-            exitCode_set(1);
-            return envelope_error('');
+            return pacsStatus_run(args.operands.target);
     }
 }
 //# sourceMappingURL=pacs.js.map

package/dist/builtins/net/pacs.js.map

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