@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/net/status.js

@@ -18,7 +18,6 @@
  */
 import chalk from 'chalk';
 import { pacsQueries_list, pacsRetrieve_statusForQuery } from '@fnndsc/cumin';
-import { args_checkHasHelpFlag, help_render } from '../help.js';
 import { spinner } from '../../lib/spinner.js';
 import { pacsQuery_createAndWait, queryExpr_parse } from './query.js';
 import { queryId_extractFromFolder } from '@fnndsc/salsa';
@@ -174,23 +173,17 @@ function statusReport_render(report) {
  * Reports per-series pull status for a PACS query: expected vs registered
  * file counts, derived state, and the in-CUBE storage path.
  *
- * @param args - `[target]` where target is a query expression, a
- *   `/net/pacs/queries/...` path, or a numeric query id.
+ * `pacs status` parses its line against the `pacs` declaration; this runs it.
+ *
+ * @param target - A query expression, a `/net/pacs/queries/...` path, or a
+ *   numeric query id.
  * @returns An envelope carrying the rendered report and a typed model of it.
  * @example
  * pacs status AccessionNumber:22119730
  * pacs status /net/pacs/queries/AccessionNumber:22119730_qid:2833
  * pacs status 2833
  */
-export async function builtin_pacsStatus(args) {
-    if (args_checkHasHelpFlag(args, 'pacs')) {
-        return envelope_ok(help_render('pacs'));
-    }
-    const target = args.find((a) => !a.startsWith('--'));
-    if (!target) {
-        exitCode_set(1);
-        return envelope_error('', undefined, `${chalk.red('pacs status: Missing target. Usage: pacs status <expression | path | queryId>')}\n`);
-    }
+export async function pacsStatus_run(target) {
     const pacsserver = await pacsServer_resolve(null);
     if (!pacsserver) {
         exitCode_set(1);

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

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

package/dist/builtins/parametersofplugin.d.ts

@@ -1,14 +1,93 @@
 /**
- * @file Builtin that lists the parameters of a plugin.
+ * @file `parametersofplugin`: the parameters a plugin takes, as a manual
+ * page, or the fields a parameter has.
+ *
+ * A plugin's own `/bin` entry reads them too: `pl-dircopy-v2.1.1 --parameters`
+ * asks this command for the plugin it names.
+ *
+ * Declared in one record (`parametersofpluginCommand`).
+ *
+ * Key components:
+ * - parametersofpluginCommand: the declaration.
+ * - builtin_parametersofplugin: the declaration run over words already split.
  *
  * @module
  */
 import { type CommandEnvelope } from '@fnndsc/menu';
 /**
- * Handles the 'parametersofplugin' builtin command.
- * This command displays information about plugin parameters.
+ * `parametersofplugin [--plugin-id <id>] <list | fieldslist>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [parametersofpluginCommand] }, 'backend');
+ * ```
+ */
+export declare const parametersofpluginCommand: import("../core/commandDeclaration.js").CommandDeclaration<{
+    readonly options: {
+        readonly pluginId: {
+            readonly long: "plugin-id";
+            readonly summary: "The plugin's id; without it, the plugin of the current context";
+            readonly value: {
+                readonly name: "id";
+                readonly kind: "int";
+                readonly min: 1;
+            };
+        };
+    };
+    readonly subcommands: {
+        readonly list: {
+            readonly summary: "The plugin's parameters, as a manual page";
+            readonly options: {
+                readonly limit: {
+                    readonly long: "limit";
+                    readonly summary: "At most this many (default 20)";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly offset: {
+                    readonly long: "offset";
+                    readonly summary: "Start this many in";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 0;
+                    };
+                };
+                readonly fields: {
+                    readonly long: "fields";
+                    readonly summary: "The fields to show, comma-separated (fieldslist names them)";
+                    readonly value: {
+                        readonly name: "field,…";
+                        readonly kind: "word";
+                    };
+                };
+                readonly search: {
+                    readonly long: "search";
+                    readonly summary: "Filter by field:value, comma-separated";
+                    readonly value: {
+                        readonly name: "field:value";
+                        readonly kind: "word";
+                    };
+                };
+            };
+        };
+        readonly fieldslist: {
+            readonly summary: "Name the fields a parameter has";
+        };
+    };
+}>;
+/**
+ * `parametersofplugin` over words already split: the declaration's parse and handler.
  *
  * @param args - Arguments passed to the command.
  * @returns An envelope carrying the rendered parameters or fields.
+ *
+ * @example
+ * ```ts
+ * await builtin_parametersofplugin(['list', '--plugin-id', '42']);
+ * ```
  */
 export declare function builtin_parametersofplugin(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/parametersofplugin.js

@@ -1,38 +1,61 @@
 /**
- * @file Builtin that lists the parameters of a plugin.
+ * @file `parametersofplugin`: the parameters a plugin takes, as a manual
+ * page, or the fields a parameter has.
+ *
+ * A plugin's own `/bin` entry reads them too: `pl-dircopy-v2.1.1 --parameters`
+ * asks this command for the plugin it names.
+ *
+ * Declared in one record (`parametersofpluginCommand`).
+ *
+ * Key components:
+ * - parametersofpluginCommand: the declaration.
+ * - builtin_parametersofplugin: the declaration run over words already split.
  *
  * @module
  */
 import chalk from 'chalk';
-import { commandArgs_process } from './utils.js';
 import { PluginContextGroupHandler } from '@fnndsc/chili/plugins/pluginGroupHandler.js';
-import { envelope_ok, envelope_error } from '@fnndsc/menu';
+import { envelope_error } from '@fnndsc/menu';
 import { exitCode_set } from '../core/handlerRun.js';
+import { command_declare } from '../core/commandDeclaration.js';
+import { declaredCommand_run } from '../core/commandParse.js';
+/** What a `parametersofplugin` line may hold. */
+const PARAMETERSOFPLUGIN_GRAMMAR = {
+    options: {
+        pluginId: { long: 'plugin-id', summary: "The plugin's id; without it, the plugin of the current context", value: { name: 'id', kind: 'int', min: 1 } },
+    },
+    subcommands: {
+        list: {
+            summary: "The plugin's parameters, as a manual page",
+            options: {
+                limit: { long: 'limit', summary: 'At most this many (default 20)', value: { name: 'n', kind: 'int', min: 1 } },
+                offset: { long: 'offset', summary: 'Start this many in', value: { name: 'n', kind: 'int', min: 0 } },
+                fields: { long: 'fields', summary: 'The fields to show, comma-separated (fieldslist names them)', value: { name: 'field,…', kind: 'word' } },
+                search: { long: 'search', summary: 'Filter by field:value, comma-separated', value: { name: 'field:value', kind: 'word' } },
+            },
+        },
+        fieldslist: { summary: 'Name the fields a parameter has' },
+    },
+};
 /**
- * Handles the 'parametersofplugin' builtin command.
- * This command displays information about plugin parameters.
+ * Runs one `parametersofplugin` line.
  *
- * @param args - Arguments passed to the command.
- * @returns An envelope carrying the rendered parameters or fields.
+ * @param args - The line, parsed.
+ * @returns The parameters or the fields, or the error.
  */
-export async function builtin_parametersofplugin(args) {
-    const parsedArgs = commandArgs_process(args);
-    const subcommand = parsedArgs._[0]; // e.g., 'list', 'fieldslist'
-    const pluginIdFromArgs = parsedArgs['plugin-id'];
-    if (!subcommand) {
-        return envelope_ok(`${chalk.red('Usage: parametersofplugin <list|fieldslist> [--plugin-id <id>] ...')}\n`);
-    }
+async function parametersofplugin_run(args) {
     try {
-        // Instantiate the specialized handler
-        const handler = await PluginContextGroupHandler.handler_create('parametersofplugin', pluginIdFromArgs ? Number(pluginIdFromArgs) : undefined);
-        if (subcommand === 'list') {
-            // Use the specialized man-page style listing for parameters
-            return await handler.parameters_listManRender(parsedArgs);
-        }
-        else if (subcommand === 'fieldslist') {
+        const handler = await PluginContextGroupHandler.handler_create('parametersofplugin', args.options.pluginId);
+        if (args.subcommand === 'fieldslist')
             return await handler.parameters_fieldsRender();
-        }
-        return envelope_ok(`${chalk.yellow(`Unknown parametersofplugin subcommand: ${subcommand}`)}\n`);
+        const { limit, offset, fields, search } = args.options;
+        const options = {
+            ...(limit !== undefined ? { limit: String(limit) } : {}),
+            ...(offset !== undefined ? { offset: String(offset) } : {}),
+            ...(fields !== undefined ? { fields } : {}),
+            ...(search !== undefined ? { search } : {}),
+        };
+        return await handler.parameters_listManRender(options);
     }
     catch (error) {
         const msg = error instanceof Error ? error.message : String(error);
@@ -40,4 +63,37 @@ export async function builtin_parametersofplugin(args) {
         return envelope_error('', undefined, `${chalk.red(`Error in parametersofplugin: ${msg}`)}\n`);
     }
 }
+/**
+ * `parametersofplugin [--plugin-id <id>] <list | fieldslist>`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [parametersofpluginCommand] }, 'backend');
+ * ```
+ */
+export const parametersofpluginCommand = command_declare({
+    name: 'parametersofplugin',
+    grammar: PARAMETERSOFPLUGIN_GRAMMAR,
+    help: {
+        summary: 'The parameters a plugin takes, as a manual page',
+        description: "List a plugin's parameters as a manual page: each flag, its type, its default and its help. --plugin-id names the plugin by its id; without it, the plugin of the current context is read. fieldslist names the fields a parameter has. A plugin's /bin entry answers the same: pl-dircopy-v2.1.1 --parameters.",
+        category: 'Resources',
+        examples: ['parametersofplugin list --plugin-id 42', 'parametersofplugin fieldslist', 'pl-dircopy-v2.1.1 --parameters'],
+    },
+    handler: parametersofplugin_run,
+});
+/**
+ * `parametersofplugin` over words already split: the declaration's parse and handler.
+ *
+ * @param args - Arguments passed to the command.
+ * @returns An envelope carrying the rendered parameters or fields.
+ *
+ * @example
+ * ```ts
+ * await builtin_parametersofplugin(['list', '--plugin-id', '42']);
+ * ```
+ */
+export async function builtin_parametersofplugin(args) {
+    return declaredCommand_run(parametersofpluginCommand, args);
+}
 //# sourceMappingURL=parametersofplugin.js.map

package/dist/builtins/parametersofplugin.js.map

@@ -1 +1 @@
-{"version":3,"file":"parametersofplugin.js","sourceRoot":"","sources":["../../src/builtins/parametersofplugin.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,OAAO,EAAE,yBAAyB,EAAE,MAAM,6CAA6C,CAAC;AACxF,OAAO,EAAwB,WAAW,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAAc;IAC3D,MAAM,UAAU,GAAe,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACzD,MAAM,UAAU,GAAY,UAAU,CAAC,CAAc,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B;IACvF,MAAM,gBAAgB,GAAuB,UAAU,CAAC,WAAW,CAAW,CAAC;IAE/E,IAAI,CAAC,UAAU,EAAE,CAAC;QACd,OAAO,WAAW,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,oEAAoE,CAAC,IAAI,CAAC,CAAC;IAC/G,CAAC;IAED,IAAI,CAAC;QACD,sCAAsC;QACtC,MAAM,OAAO,GAA8B,MAAM,yBAAyB,CAAC,cAAc,CACrF,oBAAoB,EACpB,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,SAAS,CAC1D,CAAC;QAEF,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;YACxB,4DAA4D;YAC5D,OAAO,MAAM,OAAO,CAAC,wBAAwB,CAAC,UAAU,CAAC,CAAC;QAC9D,CAAC;aAAM,IAAI,UAAU,KAAK,YAAY,EAAE,CAAC;YACrC,OAAO,MAAM,OAAO,CAAC,uBAAuB,EAAE,CAAC;QACnD,CAAC;QACD,OAAO,WAAW,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,0CAA0C,UAAU,EAAE,CAAC,IAAI,CAAC,CAAC;IAEpG,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACtB,MAAM,GAAG,GAAW,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3E,YAAY,CAAC,CAAC,CAAC,CAAC;QAChB,OAAO,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,gCAAgC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAClG,CAAC;AACL,CAAC"}
+{"version":3,"file":"parametersofplugin.js","sourceRoot":"","sources":["../../src/builtins/parametersofplugin.ts"],"names":[],"mappings":"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"}

package/dist/builtins/proc.d.ts

@@ -7,9 +7,216 @@ import { type ProcUniverseModel, type CommandEnvelope } from '@fnndsc/menu';
  */
 export declare function procUniverseModel_build(): ProcUniverseModel;
 /**
- * Handles proc commands.
+ * `proc <jobs|stat|feeds|seen|universe|layout|refresh|retry|find|here|jump|watch|unwatch>`: the declaration.
  *
- * @param args - command arguments.
- * @returns An envelope carrying the subcommand's output.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [procCommand] }, 'backend');
+ * ```
+ */
+export declare const procCommand: import("../core/commandDeclaration.js").CommandDeclaration<{
+    readonly bare: {
+        readonly summary: "Rebuild the entire proc cache (as refresh)";
+    };
+    readonly subcommands: {
+        readonly jobs: {
+            readonly summary: "List all feeds with their counter fields (default 20), or inspect the field names";
+            readonly operands: readonly [{
+                readonly name: "view";
+                readonly kind: "enum";
+                readonly values: readonly ["list", "inspect"];
+                readonly optional: true;
+                readonly summary: "list (the default), or inspect: every field name";
+            }];
+            readonly options: {
+                readonly fields: {
+                    readonly long: "fields";
+                    readonly summary: "Select columns";
+                    readonly value: {
+                        readonly name: "f,f";
+                        readonly kind: "word";
+                    };
+                };
+                readonly sort: {
+                    readonly long: "sort";
+                    readonly summary: "Sort by field";
+                    readonly value: {
+                        readonly name: "field";
+                        readonly kind: "word";
+                    };
+                };
+                readonly reverse: {
+                    readonly long: "reverse";
+                    readonly summary: "Reverse the sort";
+                };
+                readonly table: {
+                    readonly long: "table";
+                    readonly summary: "Tabular output";
+                };
+                readonly csv: {
+                    readonly long: "csv";
+                    readonly summary: "CSV output";
+                };
+                readonly all: {
+                    readonly long: "all";
+                    readonly summary: "All feeds (no limit)";
+                };
+                readonly limit: {
+                    readonly long: "limit";
+                    readonly summary: "Feeds to show (default 20)";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly search: {
+                    readonly long: "search";
+                    readonly summary: "Filter by title substring";
+                    readonly value: {
+                        readonly name: "term";
+                        readonly kind: "word";
+                    };
+                };
+                readonly force: {
+                    readonly long: "force";
+                    readonly summary: "Wait for warm-up, then answer from the complete index";
+                };
+            };
+        };
+        readonly stat: {
+            readonly summary: "Show the cache summary, or one feed's raw counters and topology state";
+            readonly operands: readonly [{
+                readonly optional: true;
+                readonly name: "feed";
+                readonly kind: "word";
+                readonly summary: "The feed: feed_N or its id";
+            }];
+        };
+        readonly feeds: {
+            readonly summary: "Find feeds by title, feed_N name or id; an id the roster lacks is asked of CUBE";
+            readonly operands: readonly [{
+                readonly name: "query";
+                readonly kind: "word";
+                readonly optional: true;
+                readonly summary: "Title substring, feed_N or id; none lists the whole roster";
+            }];
+            readonly options: {
+                readonly fresh: {
+                    readonly long: "fresh";
+                    readonly summary: "Walk the whole feed index now";
+                };
+                readonly new: {
+                    readonly long: "new";
+                    readonly summary: "Feeds shared with you since your last visit, not yet opened (NEW)";
+                };
+                readonly force: {
+                    readonly long: "force";
+                    readonly summary: "Wait for warm-up, then answer from the complete index";
+                };
+            };
+        };
+        readonly seen: {
+            readonly summary: "Take the NEW mark off feeds you have looked at";
+            readonly operands: readonly [{
+                readonly name: "feeds";
+                readonly kind: "word";
+                readonly repeat: true;
+                readonly summary: "feed_N or N, or all";
+            }];
+        };
+        readonly universe: {
+            readonly summary: "Every feed the index holds as it landed: size, status, pipeline shape; honest while warming";
+        };
+        readonly layout: {
+            readonly summary: "Where a surface last laid the universe out under a layout; put keeps one (node ids to [x, y, z], as JSON)";
+            readonly operands: readonly [{
+                readonly name: "layout";
+                readonly kind: "word";
+                readonly summary: "The layout's name; or put, to keep one";
+            }, {
+                readonly name: "name";
+                readonly kind: "word";
+                readonly optional: true;
+                readonly summary: "With put: the layout's name";
+            }, {
+                readonly name: "places";
+                readonly kind: "word";
+                readonly optional: true;
+                readonly summary: "With put: node ids to [x, y, z], as JSON";
+            }];
+        };
+        readonly refresh: {
+            readonly summary: "Rebuild the entire proc cache, or one feed's";
+            readonly operands: readonly [{
+                readonly optional: true;
+                readonly name: "feed";
+                readonly kind: "word";
+                readonly summary: "The feed: feed_N or its id";
+            }];
+        };
+        readonly retry: {
+            readonly summary: "Resume a failed topology sweep at its failed page";
+        };
+        readonly find: {
+            readonly summary: "Find a job: an instance id (available during warm-up), or a plugin name";
+            readonly operands: readonly [{
+                readonly name: "query";
+                readonly kind: "word";
+                readonly summary: "An instance id, or a plugin name substring";
+            }];
+            readonly options: {
+                readonly force: {
+                    readonly long: "force";
+                    readonly summary: "Wait for warm-up, then answer from the complete index";
+                };
+            };
+        };
+        readonly here: {
+            readonly summary: "Navigate from a CFS feed/output path to its matching job";
+        };
+        readonly jump: {
+            readonly summary: "Go to a feed or node by id or /proc name (feed_N, plugin_N); a number that is both is not guessed";
+            readonly operands: readonly [{
+                readonly name: "target";
+                readonly kind: "word";
+                readonly summary: "A feed id, node id, feed_N or plugin_N";
+            }];
+            readonly options: {
+                readonly where: {
+                    readonly long: "where";
+                    readonly summary: "Only answer where it is; the cwd stays";
+                };
+            };
+        };
+        readonly watch: {
+            readonly summary: "Keep a running feed live: sample it while it runs, push its DAG to every surface; none lists the watches";
+            readonly operands: readonly [{
+                readonly optional: true;
+                readonly name: "feed";
+                readonly kind: "word";
+                readonly summary: "The feed: feed_N or its id";
+            }];
+        };
+        readonly unwatch: {
+            readonly summary: "Release the watch on a feed";
+            readonly operands: readonly [{
+                readonly name: "feed";
+                readonly kind: "word";
+                readonly summary: "The feed: feed_N or its id";
+            }];
+        };
+    };
+}>;
+/**
+ * `proc` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `proc`.
+ * @returns An envelope carrying the subcommand's output, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_proc(['stat']);
+ * ```
  */
 export declare function builtin_proc(args: string[]): Promise<CommandEnvelope>;