@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/res/plugininstance.js

@@ -1,16 +1,27 @@
 /**
- * @file Builtin plugininstance command.
+ * @file `plugininstance` and its other names (`plugininstances`, `instance`,
+ * `instances`, `job`, `jobs`): CUBE's plugin instances, the jobs, listed,
+ * searched, and their fields named. A job is worked where it lives, in
+ * /proc/jobs; the verbs that would do it here say how instead.
  *
- * Subcommands: list, search, inspect
- * Aliases: plugininstance / plugininstances / instance / instances / job / jobs
+ * Declared in one record (`plugininstanceCommand`, its other names as aliases): the
+ * subcommands and the listing options every resource command reads.
+ *
+ * Key components:
+ * - plugininstanceCommand: the declaration, answered under each of its names.
+ * - builtin_plugininstance: the declaration run over words already split.
+ *
+ * @module
  */
 import chalk from 'chalk';
-import { commandArgs_process, cliOptions_extract, resourceListOptions_refusal, resourceSearchTerm_refusal, resourceSearch_args } from '../utils.js';
 import { pluginInstances_fetchList } from '@fnndsc/chili/commands/plugininstances/list.js';
 import { pluginInstanceFields_fetch } from '@fnndsc/chili/commands/plugininstances/fields.js';
 import { table_render } from '@fnndsc/chili/screen/screen.js';
 import { envelope_ok, 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';
+import { RESOURCE_LIST_OPTIONS_GRAMMAR, resourceListBag_build } from './resourceList.js';
 /**
  * Projects a listed row onto the wire's instance model: the fields the
  * listing selected, typed; a field the listing did not select is absent.
@@ -54,58 +65,119 @@ const PROC_WAYS = {
     log: '`cat <path>/log` is its log',
 };
 /**
- * Builtin handler for the `plugininstance` command.
+ * Lists the plugin instances a listing's options ask for, as a table and as
+ * the run history a surface reads (a catalogue's RECENT block) rather than scrapes.
  *
- * @param args - Parsed command arguments for the plugin-instance command.
+ * @param options - The bag chili's listing reads.
+ * @returns The table and model, or that there are none, or the error.
  */
-export async function builtin_plugininstance(args) {
-    const parsed = commandArgs_process(args);
-    const subcommand = parsed._[0];
-    if (!subcommand || subcommand === 'list') {
-        const refusal = resourceListOptions_refusal('plugininstance', parsed);
-        if (refusal !== null) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(refusal)}\n`);
-        }
-        try {
-            const { pluginInstances, selectedFields, totalCount } = await pluginInstances_fetchList(cliOptions_extract(parsed));
-            // The listing is a model as well as a table: the run history a surface
-            // reads (a catalogue's RECENT block) rather than scrapes.
-            const model = { kind: 'plugininstance.list', data: pluginInstances.map(instanceRow_project) };
-            if (pluginInstances.length === 0) {
-                return envelope_ok(`${chalk.gray('No plugin instances found.')}\n`, model);
-            }
-            return envelope_ok(table_render(pluginInstances, selectedFields, { title: { title: 'Plugin Instances', justification: 'center' }, pagination: totalCount !== undefined ? { shown: pluginInstances.length, total: totalCount } : undefined }), model);
-        }
-        catch (e) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(`plugininstance error: ${e instanceof Error ? e.message : String(e)}`)}\n`);
-        }
-    }
-    if (subcommand === 'search') {
-        const refusal = resourceSearchTerm_refusal('plugininstance', parsed);
-        if (refusal !== null) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(refusal)}\n`);
-        }
-        return builtin_plugininstance(resourceSearch_args(parsed));
-    }
-    if (subcommand === 'inspect') {
-        const fields = await pluginInstanceFields_fetch();
-        if (fields && fields.length > 0) {
-            return envelope_ok(table_render(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Plugin Instance fields', justification: 'center' } }));
+async function plugininstanceList_render(options) {
+    try {
+        const { pluginInstances, selectedFields, totalCount } = await pluginInstances_fetchList(options);
+        const model = { kind: 'plugininstance.list', data: pluginInstances.map(instanceRow_project) };
+        if (pluginInstances.length === 0) {
+            return envelope_ok(`${chalk.gray('No plugin instances found.')}\n`, model);
         }
-        return envelope_ok(`${chalk.gray('No fields found for plugin instances.')}\n`);
+        return envelope_ok(table_render(pluginInstances, selectedFields, { title: { title: 'Plugin Instances', justification: 'center' }, pagination: totalCount !== undefined ? { shown: pluginInstances.length, total: totalCount } : undefined }), model);
     }
-    // A job is worked where it lives, in /proc/jobs: these verbs name the path
-    // rather than keep a second way to do what the tree already does.
-    const where = PROC_WAYS[subcommand];
-    if (where !== undefined) {
-        const id = String(parsed._[1] ?? '<id>');
+    catch (e) {
         exitCode_set(1);
-        return envelope_error('', undefined, `${chalk.red(`plugininstance ${subcommand}: a job is worked in /proc/jobs; \`proc find ${id}\` names its path, then ${where}`)}\n`);
+        return envelope_error('', undefined, `${chalk.red(`plugininstance error: ${e instanceof Error ? e.message : String(e)}`)}\n`);
     }
+}
+/**
+ * Names the fields a plugin instance has.
+ *
+ * @returns The fields' table, or that there are none.
+ */
+async function plugininstanceFields_render() {
+    const fields = await pluginInstanceFields_fetch();
+    if (fields && fields.length > 0) {
+        return envelope_ok(table_render(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Plugin Instance fields', justification: 'center' } }));
+    }
+    return envelope_ok(`${chalk.gray('No fields found for plugin instances.')}\n`);
+}
+/**
+ * A job verb the tree already answers: names the /proc/jobs path and what to
+ * do there, rather than keep a second way to do what the tree does.
+ *
+ * @param verb - The verb asked for.
+ * @param id - The job's id as typed, if any.
+ * @returns The refusal that says how.
+ */
+function procWay_say(verb, id) {
     exitCode_set(1);
-    return envelope_error(`${chalk.red(`Unknown subcommand: ${subcommand}. Usage: plugininstances <list|search|inspect>`)}\n`);
+    return envelope_error('', undefined, `${chalk.red(`plugininstance ${verb}: a job is worked in /proc/jobs; \`proc find ${id ?? '<id>'}\` names its path, then ${PROC_WAYS[verb]}`)}\n`);
+}
+/** The operand of a job verb /proc/jobs answers: the job's id, which it names in the way it says. */
+const JOB_ID_OPERANDS = [{ name: 'id', kind: 'word', optional: true, summary: "The job's id" }];
+/** What a `plugininstance` line may hold. */
+const PLUGININSTANCE_GRAMMAR = {
+    bare: { summary: 'List the plugin instances, as list does', options: RESOURCE_LIST_OPTIONS_GRAMMAR },
+    subcommands: {
+        list: { summary: 'List the plugin instances, 20 to a page', options: RESOURCE_LIST_OPTIONS_GRAMMAR },
+        search: {
+            summary: 'List the plugin instances a filter matches (list --search <term>)',
+            operands: [{ name: 'term', kind: 'word', summary: 'The filter, field:value (inspect names the fields)' }],
+            options: RESOURCE_LIST_OPTIONS_GRAMMAR,
+        },
+        inspect: { summary: 'Name the fields a plugin instance has' },
+        cancel: { summary: 'Says how: rm <path> in /proc/jobs cancels a running job', operands: JOB_ID_OPERANDS },
+        delete: { summary: 'Says how: rm <path> in /proc/jobs removes a finished job', operands: JOB_ID_OPERANDS },
+        rm: { summary: 'Says how: rm <path> in /proc/jobs removes a finished job', operands: JOB_ID_OPERANDS },
+        output: { summary: 'Says how: <path>/data in /proc/jobs is its output folder', operands: JOB_ID_OPERANDS },
+        parameters: { summary: 'Says how: cat <path>/params in /proc/jobs lists its parameters', operands: JOB_ID_OPERANDS },
+        params: { summary: 'Says how: cat <path>/params in /proc/jobs lists its parameters', operands: JOB_ID_OPERANDS },
+        log: { summary: 'Says how: cat <path>/log in /proc/jobs is its log', operands: JOB_ID_OPERANDS },
+    },
+};
+/**
+ * Runs one `plugininstance` line.
+ *
+ * @param args - The line, parsed.
+ * @returns The listing, the fields, or the way /proc/jobs does it.
+ */
+async function plugininstance_run(args) {
+    switch (args.subcommand) {
+        case null:
+        case 'list': return plugininstanceList_render(resourceListBag_build(args.options));
+        case 'search': return plugininstanceList_render(resourceListBag_build(args.options, args.operands.term));
+        case 'inspect': return plugininstanceFields_render();
+        default: return procWay_say(args.subcommand, args.operands.id);
+    }
+}
+/**
+ * `plugininstance [[listing options] | list [listing options] | search <term> [listing options] | inspect | <job verb> [id]]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [plugininstanceCommand] }, 'backend');
+ * ```
+ */
+export const plugininstanceCommand = command_declare({
+    name: 'plugininstance',
+    aliases: [{ name: 'plugininstances', holds: [] }, 'instance', 'instances', 'job', 'jobs'],
+    grammar: PLUGININSTANCE_GRAMMAR,
+    help: {
+        summary: "CUBE's plugin instances, the jobs: list them, search them, name their fields",
+        description: 'List the plugin instances in CUBE, the jobs, a page at a time or every page, filtered by a field:value search and in the columns asked for; inspect names the fields a job has. A job is worked in /proc/jobs: proc find <id> names its path, rm <path> cancels it while it runs and removes it once done, cat <path>/params and cat <path>/log read it, and <path>/data is its output; the verbs that would do these here say so. plugininstance, plugininstances, instance, instances, job and jobs are one command.',
+        category: 'Resources',
+        examples: ['jobs list', 'jobs list --all', 'jobs search status:started', 'jobs list --search feed_id:5536', 'jobs inspect', 'proc find 42'],
+    },
+    handler: plugininstance_run,
+});
+/**
+ * `plugininstance` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `plugininstance`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_plugininstance(['search', 'status:started']);
+ * ```
+ */
+export async function builtin_plugininstance(args) {
+    return declaredCommand_run(plugininstanceCommand, args);
 }
 //# sourceMappingURL=plugininstance.js.map

package/dist/builtins/res/plugininstance.js.map

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

package/dist/builtins/res/pluginmeta.d.ts

@@ -1,7 +1,249 @@
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
- * Builtin handler for the `pluginmeta` command.
+ * `pluginmeta [[listing options] | list [listing options] | search <term> [listing options] | inspect]`: the declaration.
  *
- * @param args - Parsed command arguments for the plugin-meta command.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pluginmetaCommand] }, 'backend');
+ * ```
+ */
+export declare const pluginmetaCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly bare: {
+        readonly summary: "List the plugin metas, as list does";
+        readonly options: {
+            readonly all: {
+                readonly long: "all";
+                readonly summary: "Fetch every page";
+            };
+            readonly limit: {
+                readonly long: "limit";
+                readonly summary: "Page size (default 20)";
+                readonly value: {
+                    readonly name: "n";
+                    readonly kind: "int";
+                    readonly min: 1;
+                };
+            };
+            readonly offset: {
+                readonly long: "offset";
+                readonly summary: "Start this many rows in";
+                readonly value: {
+                    readonly name: "n";
+                    readonly kind: "int";
+                    readonly min: 0;
+                };
+            };
+            readonly page: {
+                readonly long: "page";
+                readonly summary: "Page size, when --limit is not given";
+                readonly value: {
+                    readonly name: "n";
+                    readonly kind: "int";
+                    readonly min: 1;
+                };
+            };
+            readonly fields: {
+                readonly long: "fields";
+                readonly summary: "The columns to show, comma-separated (inspect names them)";
+                readonly value: {
+                    readonly name: "field,…";
+                    readonly kind: "word";
+                };
+            };
+            readonly search: {
+                readonly long: "search";
+                readonly summary: "Filter by field:value, comma-separated (inspect names the fields)";
+                readonly value: {
+                    readonly name: "field:value";
+                    readonly kind: "word";
+                };
+            };
+            readonly sort: {
+                readonly long: "sort";
+                readonly summary: "Sort by a 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 subcommands: {
+        readonly list: {
+            readonly summary: "List the plugin metas, 20 to a page";
+            readonly options: {
+                readonly all: {
+                    readonly long: "all";
+                    readonly summary: "Fetch every page";
+                };
+                readonly limit: {
+                    readonly long: "limit";
+                    readonly summary: "Page size (default 20)";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly offset: {
+                    readonly long: "offset";
+                    readonly summary: "Start this many rows in";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 0;
+                    };
+                };
+                readonly page: {
+                    readonly long: "page";
+                    readonly summary: "Page size, when --limit is not given";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly fields: {
+                    readonly long: "fields";
+                    readonly summary: "The columns to show, comma-separated (inspect names them)";
+                    readonly value: {
+                        readonly name: "field,…";
+                        readonly kind: "word";
+                    };
+                };
+                readonly search: {
+                    readonly long: "search";
+                    readonly summary: "Filter by field:value, comma-separated (inspect names the fields)";
+                    readonly value: {
+                        readonly name: "field:value";
+                        readonly kind: "word";
+                    };
+                };
+                readonly sort: {
+                    readonly long: "sort";
+                    readonly summary: "Sort by a 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 search: {
+            readonly summary: "List the plugin metas a filter matches (list --search <term>)";
+            readonly operands: readonly [{
+                readonly name: "term";
+                readonly kind: "word";
+                readonly summary: "The filter, field:value (inspect names the fields)";
+            }];
+            readonly options: {
+                readonly all: {
+                    readonly long: "all";
+                    readonly summary: "Fetch every page";
+                };
+                readonly limit: {
+                    readonly long: "limit";
+                    readonly summary: "Page size (default 20)";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly offset: {
+                    readonly long: "offset";
+                    readonly summary: "Start this many rows in";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 0;
+                    };
+                };
+                readonly page: {
+                    readonly long: "page";
+                    readonly summary: "Page size, when --limit is not given";
+                    readonly value: {
+                        readonly name: "n";
+                        readonly kind: "int";
+                        readonly min: 1;
+                    };
+                };
+                readonly fields: {
+                    readonly long: "fields";
+                    readonly summary: "The columns to show, comma-separated (inspect names them)";
+                    readonly value: {
+                        readonly name: "field,…";
+                        readonly kind: "word";
+                    };
+                };
+                readonly search: {
+                    readonly long: "search";
+                    readonly summary: "Filter by field:value, comma-separated (inspect names the fields)";
+                    readonly value: {
+                        readonly name: "field:value";
+                        readonly kind: "word";
+                    };
+                };
+                readonly sort: {
+                    readonly long: "sort";
+                    readonly summary: "Sort by a 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 inspect: {
+            readonly summary: "Name the fields a plugin meta has";
+        };
+    };
+}>;
+/**
+ * `pluginmeta` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `pluginmeta`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_pluginmeta(['search', 'name:dircopy']);
+ * ```
  */
 export declare function builtin_pluginmeta(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/res/pluginmeta.js

@@ -1,58 +1,116 @@
 /**
- * @file Builtin pluginmeta command.
+ * @file `pluginmeta`, `pluginmetas`, `meta` and `metas`: CUBE's plugin
+ * metas, each a plugin's identity across its versions, listed, searched, and
+ * their fields named.
  *
- * Subcommands: list, search, inspect
- * Aliases: pluginmeta / pluginmetas / meta / metas
+ * Declared in one record (`pluginmetaCommand`, its other names as aliases): the
+ * subcommands and the listing options every resource command reads.
+ *
+ * Key components:
+ * - pluginmetaCommand: the declaration, answered under each of its names.
+ * - builtin_pluginmeta: the declaration run over words already split.
+ *
+ * @module
  */
 import chalk from 'chalk';
-import { commandArgs_process, cliOptions_extract, resourceListOptions_refusal, resourceSearchTerm_refusal, resourceSearch_args } from '../utils.js';
 import { pluginMetas_fetchList } from '@fnndsc/chili/commands/pluginmetas/list.js';
 import { pluginMetaFields_fetch } from '@fnndsc/chili/commands/pluginmetas/fields.js';
 import { table_render } from '@fnndsc/chili/screen/screen.js';
 import { envelope_ok, 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';
+import { RESOURCE_LIST_OPTIONS_GRAMMAR, resourceListBag_build } from './resourceList.js';
 /**
- * Builtin handler for the `pluginmeta` command.
+ * Lists the plugin metas a listing's options ask for.
  *
- * @param args - Parsed command arguments for the plugin-meta command.
+ * @param options - The bag chili's listing reads.
+ * @returns The table, or that there are none, or the error.
  */
-export async function builtin_pluginmeta(args) {
-    const parsed = commandArgs_process(args);
-    const subcommand = parsed._[0];
-    if (!subcommand || subcommand === 'list') {
-        const refusal = resourceListOptions_refusal('pluginmeta', parsed);
-        if (refusal !== null) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(refusal)}\n`);
-        }
-        try {
-            const { pluginMetas, selectedFields, totalCount } = await pluginMetas_fetchList(cliOptions_extract(parsed));
-            if (pluginMetas.length === 0) {
-                return envelope_ok(`${chalk.gray('No plugin metas found.')}\n`);
-            }
-            return envelope_ok(table_render(pluginMetas, selectedFields, { title: { title: 'Plugin Metas', justification: 'center' }, pagination: totalCount !== undefined ? { shown: pluginMetas.length, total: totalCount } : undefined }));
-        }
-        catch (e) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(`pluginmeta error: ${e instanceof Error ? e.message : String(e)}`)}\n`);
+async function pluginmetaList_render(options) {
+    try {
+        const { pluginMetas, selectedFields, totalCount } = await pluginMetas_fetchList(options);
+        if (pluginMetas.length === 0) {
+            return envelope_ok(`${chalk.gray('No plugin metas found.')}\n`);
         }
+        return envelope_ok(table_render(pluginMetas, selectedFields, { title: { title: 'Plugin Metas', justification: 'center' }, pagination: totalCount !== undefined ? { shown: pluginMetas.length, total: totalCount } : undefined }));
     }
-    if (subcommand === 'search') {
-        const refusal = resourceSearchTerm_refusal('pluginmeta', parsed);
-        if (refusal !== null) {
-            exitCode_set(1);
-            return envelope_error('', undefined, `${chalk.red(refusal)}\n`);
-        }
-        return builtin_pluginmeta(resourceSearch_args(parsed));
+    catch (e) {
+        exitCode_set(1);
+        return envelope_error('', undefined, `${chalk.red(`pluginmeta error: ${e instanceof Error ? e.message : String(e)}`)}\n`);
     }
-    if (subcommand === 'inspect') {
-        const fields = await pluginMetaFields_fetch();
-        if (fields && fields.length > 0) {
-            return envelope_ok(table_render(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Plugin Meta fields', justification: 'center' } }));
-        }
-        return envelope_ok(`${chalk.gray('No fields found for plugin metas.')}\n`);
+}
+/**
+ * Names the fields a plugin meta has.
+ *
+ * @returns The fields' table, or that there are none.
+ */
+async function pluginmetaFields_render() {
+    const fields = await pluginMetaFields_fetch();
+    if (fields && fields.length > 0) {
+        return envelope_ok(table_render(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Plugin Meta fields', justification: 'center' } }));
     }
-    exitCode_set(1);
-    return envelope_error(`${chalk.red(`Unknown subcommand: ${subcommand}. Usage: pluginmetas <list|search|inspect>`)}\n`);
+    return envelope_ok(`${chalk.gray('No fields found for plugin metas.')}\n`);
+}
+/** What a `pluginmeta` line may hold. */
+const PLUGINMETA_GRAMMAR = {
+    bare: { summary: 'List the plugin metas, as list does', options: RESOURCE_LIST_OPTIONS_GRAMMAR },
+    subcommands: {
+        list: { summary: 'List the plugin metas, 20 to a page', options: RESOURCE_LIST_OPTIONS_GRAMMAR },
+        search: {
+            summary: 'List the plugin metas a filter matches (list --search <term>)',
+            operands: [{ name: 'term', kind: 'word', summary: 'The filter, field:value (inspect names the fields)' }],
+            options: RESOURCE_LIST_OPTIONS_GRAMMAR,
+        },
+        inspect: { summary: 'Name the fields a plugin meta has' },
+    },
+};
+/**
+ * Runs one `pluginmeta` line.
+ *
+ * @param args - The line, parsed.
+ * @returns The listing, the fields, or the error.
+ */
+async function pluginmeta_run(args) {
+    switch (args.subcommand) {
+        case null:
+        case 'list': return pluginmetaList_render(resourceListBag_build(args.options));
+        case 'search': return pluginmetaList_render(resourceListBag_build(args.options, args.operands.term));
+        case 'inspect': return pluginmetaFields_render();
+    }
+}
+/**
+ * `pluginmeta [[listing options] | list [listing options] | search <term> [listing options] | inspect]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pluginmetaCommand] }, 'backend');
+ * ```
+ */
+export const pluginmetaCommand = command_declare({
+    name: 'pluginmeta',
+    aliases: ['pluginmetas', 'meta', 'metas'],
+    grammar: PLUGINMETA_GRAMMAR,
+    help: {
+        summary: "CUBE's plugin metas, each a plugin across its versions: list them, search them, name their fields",
+        description: 'List the plugin metas in CUBE, a page at a time or every page, filtered by a field:value search and in the columns asked for; inspect names the fields a plugin meta has. A plugin meta is a tool across its versions (pl-dircopy); a plugin is one version of it. pluginmeta, pluginmetas, meta and metas are one command.',
+        category: 'Resources',
+        examples: ['pluginmetas list', 'pluginmetas search name:dircopy', 'metas list --fields name,category', 'meta inspect'],
+    },
+    handler: pluginmeta_run,
+});
+/**
+ * `pluginmeta` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `pluginmeta`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_pluginmeta(['search', 'name:dircopy']);
+ * ```
+ */
+export async function builtin_pluginmeta(args) {
+    return declaredCommand_run(pluginmetaCommand, args);
 }
 //# sourceMappingURL=pluginmeta.js.map