@fnndsc/brasa 0.53.0 → 0.54.0

package/dist/buildinfo.json

@@ -1 +1 @@
-{"hash":"43ed33"}
+{"hash":"382106"}

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

@@ -1,5 +1,5 @@
-import { ParsedArgs } from '../utils.js';
 import { type CommandEnvelope } from '@fnndsc/menu';
+export { plugin_addInteractive } from './plugin.sync.js';
 /**
  * Handles plugin commands.
  *
@@ -7,11 +7,3 @@ import { type CommandEnvelope } from '@fnndsc/menu';
  * @returns An envelope carrying the rendered plugin output.
  */
 export declare function builtin_plugin(args: string[]): Promise<CommandEnvelope>;
-/**
- * Interactive plugin add command with spinner and colored output.
- *
- * @param parsed - Parsed command arguments.
- * @returns An envelope carrying the add outcome. The spinner streams live via
- *   the status channel; the result summary is carried in the envelope.
- */
-export declare function plugin_addInteractive(parsed: ParsedArgs): Promise<CommandEnvelope>;

package/dist/builtins/res/plugin.js

@@ -4,7 +4,7 @@
  * Handles plugin management in chell. Subcommands:
  * - `list`  — fetch and render the plugin collection via chili
  * - `run`   — execute a plugin instance by searchable name/id
- * - `add`   — register a new plugin into CUBE (with spinner)
+ * - `add`, `sync`, `validate`, `index` — registering plugins, in `./plugin.sync.ts`
  *
  * Unknown subcommands fall through to a spawned chili process.
  * `plugin` and `plugins` are both registered as aliases in COMMAND_HANDLERS.
@@ -15,16 +15,16 @@ import chalk from 'chalk';
 import { commandArgs_process, cliOptions_extract } from '../utils.js';
 import { plugins_fetchList } from '@fnndsc/chili/commands/plugins/list.js';
 import { pluginFields_fetch } from '@fnndsc/chili/commands/plugins/fields.js';
-import { plugin_add } from '@fnndsc/chili/commands/plugins/add.js';
 import { pluginList_render } from '@fnndsc/chili/views/plugin.js';
 import { table_render } from '@fnndsc/chili/screen/screen.js';
-import { spinner } from '../../lib/spinner.js';
-import { chili_capture } from '@fnndsc/chili/screen/output.js';
 import { PLUGIN_INFO_MODEL_KIND, envelope_ok, envelope_error } from '@fnndsc/menu';
 import { pluginInfo_build, pluginInfoText_render, pluginSpecifier_parse, } from './plugin.info.js';
-import { authorizationFailure_is, sudoHint_build } from '../../core/elevation.js';
 import { errorStack } from '@fnndsc/fond';
 import { exitCode_set } from '../../core/handlerRun.js';
+import { PLUGIN_BOOLEAN_FLAGS, pluginAdd_run, pluginIndexVerb_run, pluginSync_run, pluginValidate_run, } from './plugin.sync.js';
+export { plugin_addInteractive } from './plugin.sync.js';
+/** The plugin verb's subcommands, as its usage line names them. */
+const PLUGIN_USAGE = 'plugin <list|add|sync|validate|index|info|inspect|search> ...';
 /**
  * Handles plugin commands.
  *
@@ -32,10 +32,10 @@ import { exitCode_set } from '../../core/handlerRun.js';
  * @returns An envelope carrying the rendered plugin output.
  */
 export async function builtin_plugin(args) {
-    const parsed = commandArgs_process(args);
+    const parsed = commandArgs_process(args, { booleanLongOptions: PLUGIN_BOOLEAN_FLAGS });
     const subcommand = parsed._[0];
     if (!subcommand) {
-        return envelope_ok(`${chalk.red("Usage: plugin <list|add|info|inspect|search> ...")}\n`);
+        return envelope_ok(`${chalk.red(`Usage: ${PLUGIN_USAGE}`)}\n`);
     }
     try {
         if (subcommand === 'list') {
@@ -55,7 +55,16 @@ export async function builtin_plugin(args) {
             return envelope_error('', undefined, `${chalk.red('plugin run is retired: run a plugin by its name, where you stand — pl-dcm2niix-v1.0.2 …, or A=$(pl-dcm2niix-v1.0.2 …) to name the run.')}\n`);
         }
         else if (subcommand === 'add') {
-            return await plugin_addInteractive(parsed);
+            return await pluginAdd_run(parsed, args);
+        }
+        else if (subcommand === 'sync') {
+            return await pluginSync_run(parsed, args);
+        }
+        else if (subcommand === 'validate') {
+            return await pluginValidate_run(parsed);
+        }
+        else if (subcommand === 'index') {
+            return await pluginIndexVerb_run(parsed);
         }
         else if (subcommand === 'inspect') {
             const fields = await pluginFields_fetch();
@@ -72,7 +81,7 @@ export async function builtin_plugin(args) {
             return await builtin_plugin(['list', `--search`, query]);
         }
         exitCode_set(1);
-        return envelope_error('', undefined, `${chalk.yellow(`Unknown subcommand: ${subcommand}. Usage: plugin <list|add|info|inspect|search>`)}\n`);
+        return envelope_error('', undefined, `${chalk.yellow(`Unknown subcommand: ${subcommand}. Usage: ${PLUGIN_USAGE}`)}\n`);
     }
     catch (e) {
         const msg = e instanceof Error ? e.message : String(e);
@@ -115,65 +124,4 @@ async function pluginInfo_show(words) {
         data: built.value,
     });
 }
-/**
- * Interactive plugin add command with spinner and colored output.
- *
- * @param parsed - Parsed command arguments.
- * @returns An envelope carrying the add outcome. The spinner streams live via
- *   the status channel; the result summary is carried in the envelope.
- */
-export async function plugin_addInteractive(parsed) {
-    const pluginInput = parsed._[1];
-    if (!pluginInput) {
-        return envelope_ok(`${chalk.red('Usage: plugin add <name|image|url> [--compute <resources>] [--store <url>]')}\n`);
-    }
-    const options = {
-        compute: parsed.compute,
-        store: parsed.store,
-        adminUser: parsed.adminUser,
-        adminPassword: parsed.adminPassword,
-        public_repo: parsed.publicRepo,
-    };
-    errorStack.stack_clear();
-    let rendered = `${chalk.cyan(`\nAdding plugin: ${pluginInput}\n`)}\n`;
-    const result = { outcome: 'failed' };
-    const captured = await chili_capture(async () => {
-        result.outcome = await plugin_add(pluginInput, options);
-    });
-    rendered += captured.out;
-    rendered += captured.err;
-    spinner.stop();
-    if (result.outcome === 'installed') {
-        rendered += `${chalk.green('\n[SUCCESS] Plugin added successfully!\n')}\n`;
-        return envelope_ok(rendered);
-    }
-    else if (result.outcome === 'already_exists') {
-        rendered += `${chalk.yellow(`\n[INFO] '${pluginInput}' is already registered in this CUBE.\n`)}\n`;
-        return envelope_ok(rendered);
-    }
-    exitCode_set(1);
-    rendered += `${chalk.red('\n[FAILED] Failed to add plugin.\n')}\n`;
-    const errors = errorStack.allOfType_get('error');
-    if (errors.length > 0) {
-        rendered += `${chalk.red('Errors:')}\n`;
-        errors.forEach((error) => {
-            const cleanError = error.replace(/^\[.*?\]\s+\|\s+/, '');
-            rendered += `${chalk.red(`  - ${cleanError}`)}\n`;
-        });
-        rendered += '\n';
-    }
-    if (errors.some(authorizationFailure_is)) {
-        rendered += `\n${sudoHint_build('plugin add', [pluginInput])}`;
-    }
-    const warnings = errorStack.allOfType_get('warning');
-    if (warnings.length > 0) {
-        rendered += `${chalk.yellow('Warnings:')}\n`;
-        warnings.forEach((warning) => {
-            const cleanWarning = warning.replace(/^\[.*?\]\s+\|\s+/, '');
-            rendered += `${chalk.yellow(`  [WARNING] ${cleanWarning}`)}\n`;
-        });
-        rendered += '\n';
-    }
-    return envelope_ok(rendered);
-}
 //# sourceMappingURL=plugin.js.map

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

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

package/dist/builtins/res/plugin.sync.d.ts

@@ -0,0 +1,129 @@
+/**
+ * @file The plugin verbs that register: `plugin add`, `sync`, `validate`, `index`.
+ *
+ * The logic is salsa's (`plugin_add`, the index reads, the plan, the checks);
+ * this module is the verb: it reads the words, asks where a change needs a
+ * yes, streams what lands, and answers with text and a typed model.
+ *
+ * `plugin sync` is a plan first. Anyone may see it (the plugin list is
+ * public); applying it needs an administrator, so a session that is not one
+ * sees the plan and the `sudo` line to run instead. After the plan comes one
+ * question, `[y/N]`, unless `--yes`; `--plan` stops at the plan. Uploads
+ * stream one line each as they land, and what landed stays when the job is
+ * stopped (`kill %N`): a rerun plans only what is still missing.
+ *
+ * Paths: a sync source with no prefix is a CUBE path (an index uploaded
+ * there, how a surface with no host access syncs); `plugin validate` and
+ * `plugin add --json` need no CUBE, so theirs is a host path. `host:` and
+ * `cube:` say which outright; `owner/repo[@ref]` is a GitHub repository.
+ *
+ * Key components:
+ * - pluginAdd_run: `plugin add <name|image|url>` and `plugin add --json <file>`.
+ * - pluginSync_run: `plugin sync [source] [--ref] [--plan] [--yes] [--compute]`.
+ * - pluginValidate_run: `plugin validate <file|dir|source> [--offline]`.
+ * - pluginIndexVerb_run: `plugin index [<source>] [--reset]`.
+ * - syncPlan_render / validateReport_render: the text a plan and a report read as.
+ *
+ * Typical usage:
+ * ```ts
+ * const envelope: CommandEnvelope = await pluginSync_run(commandArgs_process(args, { booleanLongOptions: PLUGIN_BOOLEAN_FLAGS }), args);
+ * ```
+ *
+ * Dependencies: salsa's plugin modules, the engine's question and sink, the
+ * index configuration.
+ *
+ * @module
+ */
+import type { SyncPlan, SyncSeams, ValidateReport } from '@fnndsc/salsa';
+import { type CommandEnvelope } from '@fnndsc/menu';
+import { type ParsedArgs } from '../utils.js';
+/** Long flags of the plugin verbs that take no value. */
+export declare const PLUGIN_BOOLEAN_FLAGS: readonly string[];
+/**
+ * `plugin add <name|image|url>` and `plugin add --json <file>`.
+ *
+ * @param parsed - The parsed words (`_[0]` is `add`).
+ * @param words - The words as typed after `plugin`, for the sudo line.
+ * @returns The add's outcome as text.
+ *
+ * @example
+ * ```ts
+ * await pluginAdd_run(commandArgs_process(['add', 'pl-dircopy']), ['add', 'pl-dircopy']);
+ * ```
+ */
+export declare function pluginAdd_run(parsed: ParsedArgs, words: readonly string[]): Promise<CommandEnvelope>;
+/**
+ * `plugin add` for a caller holding parsed words only (`store install`).
+ *
+ * @param parsed - The parsed words (`_[0]` is the subcommand, `_[1]` the plugin).
+ * @returns The add's outcome as text.
+ *
+ * @example
+ * ```ts
+ * await plugin_addInteractive({ _: ['install', 'pl-dircopy'] });
+ * ```
+ */
+export declare function plugin_addInteractive(parsed: ParsedArgs): Promise<CommandEnvelope>;
+/**
+ * `plugin sync [source] [--ref <ref>] [--plan] [--yes] [--compute a,b]`.
+ *
+ * @param parsed - The parsed words (`_[0]` is `sync`).
+ * @param words - The words as typed after `plugin`, for the sudo line.
+ * @param seams - The CUBE reads and the upload; the connected CUBE's by default.
+ * @returns The plan, or the plan with what applying it did, as text and a `plugin.sync` model.
+ *
+ * @example
+ * ```ts
+ * await pluginSync_run(commandArgs_process(['sync', '--plan'], { booleanLongOptions: PLUGIN_BOOLEAN_FLAGS }), ['sync', '--plan']);
+ * ```
+ */
+export declare function pluginSync_run(parsed: ParsedArgs, words: readonly string[], seamsGiven?: SyncSeams): Promise<CommandEnvelope>;
+/**
+ * `plugin validate <file|dir|source> [--offline]`.
+ *
+ * @param parsed - The parsed words (`_[0]` is `validate`).
+ * @param fetcher - The fetch rule 5 and a GitHub source use.
+ * @returns The report, as text and a `plugin.validate` model; exit 1 when a rule that ran failed.
+ *
+ * @example
+ * ```ts
+ * await pluginValidate_run(commandArgs_process(['validate', './plugins', '--offline'], { booleanLongOptions: PLUGIN_BOOLEAN_FLAGS }));
+ * ```
+ */
+export declare function pluginValidate_run(parsed: ParsedArgs, fetcher?: typeof fetch): Promise<CommandEnvelope>;
+/**
+ * `plugin index [<owner/repo[@ref]>|cube:<path>|host:<path>] [--reset]`.
+ *
+ * @param parsed - The parsed words (`_[0]` is `index`).
+ * @returns The index in effect, or what it was set to.
+ *
+ * @example
+ * ```ts
+ * await pluginIndexVerb_run({ _: ['index', 'FNNDSC/chris-plugins@v1'] });
+ * ```
+ */
+export declare function pluginIndexVerb_run(parsed: ParsedArgs): Promise<CommandEnvelope>;
+/**
+ * Renders a plan as the operator reads it.
+ *
+ * @param plan - The plan.
+ * @returns Its header, then each group with its plugins (skip as a count).
+ *
+ * @example
+ * ```ts
+ * syncPlan_render(plan); // 'plugin sync: chris-plugins @ 8c9a1f6, 175 plugins → this CUBE, on host\n…'
+ * ```
+ */
+export declare function syncPlan_render(plan: SyncPlan): string;
+/**
+ * Renders a validation report as the operator reads it.
+ *
+ * @param report - The report.
+ * @returns Each rule's state, then every finding, then the verdict.
+ *
+ * @example
+ * ```ts
+ * validateReport_render(report); // 'plugin validate: chris-plugins @ 8c9a1f6, 175 descriptors\n…'
+ * ```
+ */
+export declare function validateReport_render(report: ValidateReport): string;