@fnndsc/brasa 0.1.0

package/dist/builtins/res/plugin.js

@@ -0,0 +1,140 @@
+/**
+ * @file Builtin plugin/plugins command.
+ *
+ * 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 (interactive, with spinner)
+ *
+ * Unknown subcommands fall through to a spawned chili process.
+ * `plugin` and `plugins` are both registered as aliases in COMMAND_HANDLERS.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { commandArgs_process } 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_execute } from '@fnndsc/chili/commands/plugin/run.js';
+import { plugin_add } from '@fnndsc/chili/commands/plugins/add.js';
+import { pluginList_render, pluginRun_render } from '@fnndsc/chili/views/plugin.js';
+import { table_display } from '@fnndsc/chili/screen/screen.js';
+import { chiliCommand_run } from '../../core/chiliDelegate.js';
+import { spinner } from '../../lib/spinner.js';
+import { errorStack } from '@fnndsc/cumin';
+import { adminPrompt_register } from '@fnndsc/chili/utils/admin_prompt.js';
+import { repl_question, repl_questionHidden } from '../../core/question.js';
+/**
+ * Handles plugin commands.
+ *
+ * @param args - command arguments.
+ */
+export async function builtin_plugin(args) {
+    const parsed = commandArgs_process(args);
+    const subcommand = parsed._[0];
+    if (!subcommand) {
+        console.log(chalk.red("Usage: plugin <list|run|add> ..."));
+        return;
+    }
+    try {
+        if (subcommand === 'list') {
+            const { plugins, selectedFields, totalCount } = await plugins_fetchList(parsed);
+            console.log(pluginList_render(plugins, selectedFields, { table: !!parsed.table, csv: !!parsed.csv }));
+            if (totalCount !== undefined && plugins.length < totalCount) {
+                console.log(chalk.dim(`  ↓ showing ${plugins.length} of ${totalCount}  ·  --all to fetch all  ·  --limit <n> for page size`));
+            }
+        }
+        else if (subcommand === 'run') {
+            const searchable = parsed._[1];
+            if (!searchable) {
+                console.log(chalk.red("Usage: plugin run <plugin> [args...]"));
+                return;
+            }
+            const params = args.slice(2).join(' ');
+            const instance = await plugin_execute(searchable, params);
+            if (instance) {
+                console.log(pluginRun_render(instance));
+            }
+            else {
+                console.error(chalk.red("Plugin execution failed."));
+            }
+        }
+        else if (subcommand === 'add') {
+            await plugin_addInteractive(parsed);
+        }
+        else if (subcommand === 'inspect') {
+            const fields = await pluginFields_fetch();
+            if (fields && fields.length > 0) {
+                table_display(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Plugin fields', justification: 'center' } });
+            }
+            else {
+                console.log(chalk.gray('No fields found.'));
+            }
+        }
+        else if (subcommand === 'search') {
+            const query = parsed._[1] ?? '';
+            await builtin_plugin(['list', `--search`, query]);
+        }
+        else {
+            console.log(chalk.yellow('Directive not handled by chell... spawning chili directly'));
+            await chiliCommand_run('plugins', ['-s', ...args]);
+        }
+    }
+    catch (e) {
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(chalk.red(`Plugin error: ${msg}`));
+    }
+}
+/**
+ * Interactive plugin add command with spinner and colored output.
+ *
+ * @param parsed - Parsed command arguments.
+ */
+export async function plugin_addInteractive(parsed) {
+    const pluginInput = parsed._[1];
+    if (!pluginInput) {
+        console.log(chalk.red('Usage: plugin add <name|image|url> [--compute <resources>] [--store <url>]'));
+        return;
+    }
+    const options = {
+        compute: parsed.compute,
+        store: parsed.store,
+        adminUser: parsed.adminUser,
+        adminPassword: parsed.adminPassword,
+        public_repo: parsed.publicRepo,
+    };
+    errorStack.stack_clear();
+    adminPrompt_register(repl_question, repl_questionHidden);
+    console.log(chalk.cyan(`\nAdding plugin: ${pluginInput}\n`));
+    const outcome = await plugin_add(pluginInput, options);
+    spinner.stop();
+    if (outcome === 'installed') {
+        console.log(chalk.green('\n[SUCCESS] Plugin added successfully!\n'));
+    }
+    else if (outcome === 'already_exists') {
+        console.log(chalk.yellow(`\n[INFO] '${pluginInput}' is already registered in this CUBE.\n`));
+    }
+    else {
+        process.exitCode = 1;
+        console.log(chalk.red('\n[FAILED] Failed to add plugin.\n'));
+        const errors = errorStack.allOfType_get('error');
+        if (errors.length > 0) {
+            console.log(chalk.red('Errors:'));
+            errors.forEach((error) => {
+                const cleanError = error.replace(/^\[.*?\]\s+\|\s+/, '');
+                console.log(chalk.red(`  - ${cleanError}`));
+            });
+            console.log('');
+        }
+        const warnings = errorStack.allOfType_get('warning');
+        if (warnings.length > 0) {
+            console.log(chalk.yellow('Warnings:'));
+            warnings.forEach((warning) => {
+                const cleanWarning = warning.replace(/^\[.*?\]\s+\|\s+/, '');
+                console.log(chalk.yellow(`  [WARNING] ${cleanWarning}`));
+            });
+            console.log('');
+        }
+    }
+}
+//# sourceMappingURL=plugin.js.map

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

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

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

@@ -0,0 +1,6 @@
+/**
+ * Builtin handler for the `plugininstance` command.
+ *
+ * @param args - Parsed command arguments for the plugin-instance command.
+ */
+export declare function builtin_plugininstance(args: string[]): Promise<void>;

package/dist/builtins/res/plugininstance.js

@@ -0,0 +1,53 @@
+/**
+ * @file Builtin plugininstance command.
+ *
+ * Subcommands: list, search, inspect
+ * Aliases: plugininstance / plugininstances / instance / instances / job / jobs
+ */
+import chalk from 'chalk';
+import { commandArgs_process } 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_display } from '@fnndsc/chili/screen/screen.js';
+/**
+ * Builtin handler for the `plugininstance` command.
+ *
+ * @param args - Parsed command arguments for the plugin-instance command.
+ */
+export async function builtin_plugininstance(args) {
+    const parsed = commandArgs_process(args);
+    const subcommand = parsed._[0];
+    if (!subcommand || subcommand === 'list') {
+        try {
+            const { pluginInstances, selectedFields, totalCount } = await pluginInstances_fetchList(parsed);
+            if (pluginInstances.length === 0) {
+                console.log(chalk.gray('No plugin instances found.'));
+                return;
+            }
+            table_display(pluginInstances, selectedFields, { title: { title: 'Plugin Instances', justification: 'center' }, pagination: totalCount !== undefined ? { shown: pluginInstances.length, total: totalCount } : undefined });
+        }
+        catch (e) {
+            process.exitCode = 1;
+            console.error(chalk.red(`plugininstance error: ${e instanceof Error ? e.message : String(e)}`));
+        }
+        return;
+    }
+    if (subcommand === 'search') {
+        const query = parsed._[1] ?? '';
+        await builtin_plugininstance([...args.filter((a) => a !== subcommand), `--search`, query]);
+        return;
+    }
+    if (subcommand === 'inspect') {
+        const fields = await pluginInstanceFields_fetch();
+        if (fields && fields.length > 0) {
+            table_display(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Plugin Instance fields', justification: 'center' } });
+        }
+        else {
+            console.log(chalk.gray('No fields found for plugin instances.'));
+        }
+        return;
+    }
+    process.exitCode = 1;
+    console.log(chalk.red(`Unknown subcommand: ${subcommand}. Usage: plugininstances <list|search|inspect>`));
+}
+//# sourceMappingURL=plugininstance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plugininstance.js","sourceRoot":"","sources":["../../../src/builtins/res/plugininstance.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAc,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,yBAAyB,EAA4B,MAAM,gDAAgD,CAAC;AACrH,OAAO,EAAE,0BAA0B,EAAE,MAAM,kDAAkD,CAAC;AAC9F,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,IAAc;IACzD,MAAM,MAAM,GAAe,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,UAAU,GAAuB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,eAAe,EAAE,cAAc,EAAE,UAAU,EAAE,GAA6B,MAAM,yBAAyB,CAAC,MAA+B,CAAC,CAAC;YACnJ,IAAI,eAAe,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACpG,aAAa,CAAC,eAAe,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC7N,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,yBAAyB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClG,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAW,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,sBAAsB,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACnG,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAoB,MAAM,0BAA0B,EAAE,CAAC;QACnE,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,wBAAwB,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC/I,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,uCAAuC,CAAC,CAAC,CAAC;QACnE,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,UAAU,gDAAgD,CAAC,CAAC,CAAC;AAC5G,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Builtin handler for the `pluginmeta` command.
+ *
+ * @param args - Parsed command arguments for the plugin-meta command.
+ */
+export declare function builtin_pluginmeta(args: string[]): Promise<void>;

package/dist/builtins/res/pluginmeta.js

@@ -0,0 +1,53 @@
+/**
+ * @file Builtin pluginmeta command.
+ *
+ * Subcommands: list, search, inspect
+ * Aliases: pluginmeta / pluginmetas / meta / metas
+ */
+import chalk from 'chalk';
+import { commandArgs_process } 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_display } from '@fnndsc/chili/screen/screen.js';
+/**
+ * Builtin handler for the `pluginmeta` command.
+ *
+ * @param args - Parsed command arguments for the plugin-meta command.
+ */
+export async function builtin_pluginmeta(args) {
+    const parsed = commandArgs_process(args);
+    const subcommand = parsed._[0];
+    if (!subcommand || subcommand === 'list') {
+        try {
+            const { pluginMetas, selectedFields, totalCount } = await pluginMetas_fetchList(parsed);
+            if (pluginMetas.length === 0) {
+                console.log(chalk.gray('No plugin metas found.'));
+                return;
+            }
+            table_display(pluginMetas, selectedFields, { title: { title: 'Plugin Metas', justification: 'center' }, pagination: totalCount !== undefined ? { shown: pluginMetas.length, total: totalCount } : undefined });
+        }
+        catch (e) {
+            process.exitCode = 1;
+            console.error(chalk.red(`pluginmeta error: ${e instanceof Error ? e.message : String(e)}`));
+        }
+        return;
+    }
+    if (subcommand === 'search') {
+        const query = parsed._[1] ?? '';
+        await builtin_pluginmeta([...args.filter((a) => a !== subcommand), `--search`, query]);
+        return;
+    }
+    if (subcommand === 'inspect') {
+        const fields = await pluginMetaFields_fetch();
+        if (fields && fields.length > 0) {
+            table_display(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Plugin Meta fields', justification: 'center' } });
+        }
+        else {
+            console.log(chalk.gray('No fields found for plugin metas.'));
+        }
+        return;
+    }
+    process.exitCode = 1;
+    console.log(chalk.red(`Unknown subcommand: ${subcommand}. Usage: pluginmetas <list|search|inspect>`));
+}
+//# sourceMappingURL=pluginmeta.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pluginmeta.js","sourceRoot":"","sources":["../../../src/builtins/res/pluginmeta.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAc,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAwB,MAAM,4CAA4C,CAAC;AACzG,OAAO,EAAE,sBAAsB,EAAE,MAAM,8CAA8C,CAAC;AACtF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAc;IACrD,MAAM,MAAM,GAAe,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,UAAU,GAAuB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAE,GAAyB,MAAM,qBAAqB,CAAC,MAA+B,CAAC,CAAC;YACvI,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC5F,aAAa,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QACjN,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC9F,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAW,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,kBAAkB,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAC/F,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAoB,MAAM,sBAAsB,EAAE,CAAC;QAC/D,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,oBAAoB,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QAC3I,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,mCAAmC,CAAC,CAAC,CAAC;QAC/D,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,UAAU,4CAA4C,CAAC,CAAC,CAAC;AACxG,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Builtin handler for the `tag` command.
+ *
+ * @param args - Parsed command arguments for the tag command.
+ */
+export declare function builtin_tag(args: string[]): Promise<void>;

package/dist/builtins/res/tag.js

@@ -0,0 +1,53 @@
+/**
+ * @file Builtin tag command.
+ *
+ * Subcommands: list, search, inspect
+ * Singular/plural aliases: tag / tags
+ */
+import chalk from 'chalk';
+import { commandArgs_process } from '../utils.js';
+import { tags_fetchList } from '@fnndsc/chili/commands/tags/list.js';
+import { tagFields_fetch } from '@fnndsc/chili/commands/tags/fields.js';
+import { table_display } from '@fnndsc/chili/screen/screen.js';
+/**
+ * Builtin handler for the `tag` command.
+ *
+ * @param args - Parsed command arguments for the tag command.
+ */
+export async function builtin_tag(args) {
+    const parsed = commandArgs_process(args);
+    const subcommand = parsed._[0];
+    if (!subcommand || subcommand === 'list') {
+        try {
+            const { tags, selectedFields, totalCount } = await tags_fetchList(parsed);
+            if (tags.length === 0) {
+                console.log(chalk.gray('No tags found.'));
+                return;
+            }
+            table_display(tags, selectedFields, { title: { title: 'Tags', justification: 'center' }, pagination: totalCount !== undefined ? { shown: tags.length, total: totalCount } : undefined });
+        }
+        catch (e) {
+            process.exitCode = 1;
+            console.error(chalk.red(`tag error: ${e instanceof Error ? e.message : String(e)}`));
+        }
+        return;
+    }
+    if (subcommand === 'search') {
+        const query = parsed._[1] ?? '';
+        await builtin_tag([...args.filter((a) => a !== subcommand), `--search`, query]);
+        return;
+    }
+    if (subcommand === 'inspect') {
+        const fields = await tagFields_fetch();
+        if (fields && fields.length > 0) {
+            table_display(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Tag fields', justification: 'center' } });
+        }
+        else {
+            console.log(chalk.gray('No fields found for tags.'));
+        }
+        return;
+    }
+    process.exitCode = 1;
+    console.log(chalk.red(`Unknown subcommand: ${subcommand}. Usage: tags <list|search|inspect>`));
+}
+//# sourceMappingURL=tag.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tag.js","sourceRoot":"","sources":["../../../src/builtins/res/tag.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAc,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAiB,MAAM,qCAAqC,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,uCAAuC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,MAAM,GAAe,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,UAAU,GAAuB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,UAAU,EAAE,GAAkB,MAAM,cAAc,CAAC,MAA+B,CAAC,CAAC;YAClH,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC7E,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC3L,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,cAAc,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACvF,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAW,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,WAAW,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QACxF,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAoB,MAAM,eAAe,EAAE,CAAC;QACxD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACnI,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,CAAC;QACvD,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,UAAU,qCAAqC,CAAC,CAAC,CAAC;AACjG,CAAC"}

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

@@ -0,0 +1,6 @@
+/**
+ * Builtin handler for the `workflow` command.
+ *
+ * @param args - Parsed command arguments for the workflow command.
+ */
+export declare function builtin_workflow(args: string[]): Promise<void>;

package/dist/builtins/res/workflow.js

@@ -0,0 +1,53 @@
+/**
+ * @file Builtin workflow command.
+ *
+ * Subcommands: list, search, inspect
+ * Aliases: workflow / workflows
+ */
+import chalk from 'chalk';
+import { commandArgs_process } from '../utils.js';
+import { workflows_fetchList } from '@fnndsc/chili/commands/workflows/list.js';
+import { workflowFields_fetch } from '@fnndsc/chili/commands/workflows/fields.js';
+import { table_display } from '@fnndsc/chili/screen/screen.js';
+/**
+ * Builtin handler for the `workflow` command.
+ *
+ * @param args - Parsed command arguments for the workflow command.
+ */
+export async function builtin_workflow(args) {
+    const parsed = commandArgs_process(args);
+    const subcommand = parsed._[0];
+    if (!subcommand || subcommand === 'list') {
+        try {
+            const { workflows, selectedFields, totalCount } = await workflows_fetchList(parsed);
+            if (workflows.length === 0) {
+                console.log(chalk.gray('No workflows found.'));
+                return;
+            }
+            table_display(workflows, selectedFields, { title: { title: 'Workflows', justification: 'center' }, pagination: totalCount !== undefined ? { shown: workflows.length, total: totalCount } : undefined });
+        }
+        catch (e) {
+            process.exitCode = 1;
+            console.error(chalk.red(`workflow error: ${e instanceof Error ? e.message : String(e)}`));
+        }
+        return;
+    }
+    if (subcommand === 'search') {
+        const query = parsed._[1] ?? '';
+        await builtin_workflow([...args.filter((a) => a !== subcommand), `--search`, query]);
+        return;
+    }
+    if (subcommand === 'inspect') {
+        const fields = await workflowFields_fetch();
+        if (fields && fields.length > 0) {
+            table_display(fields.map((f) => ({ field: f })), ['field'], { title: { title: 'Workflow fields', justification: 'center' } });
+        }
+        else {
+            console.log(chalk.gray('No fields found for workflows.'));
+        }
+        return;
+    }
+    process.exitCode = 1;
+    console.log(chalk.red(`Unknown subcommand: ${subcommand}. Usage: workflows <list|search|inspect>`));
+}
+//# sourceMappingURL=workflow.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../../src/builtins/res/workflow.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,mBAAmB,EAAc,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,mBAAmB,EAAsB,MAAM,0CAA0C,CAAC;AACnG,OAAO,EAAE,oBAAoB,EAAE,MAAM,4CAA4C,CAAC;AAClF,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAG/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc;IACnD,MAAM,MAAM,GAAe,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACrD,MAAM,UAAU,GAAuB,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEnD,IAAI,CAAC,UAAU,IAAI,UAAU,KAAK,MAAM,EAAE,CAAC;QACzC,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,GAAuB,MAAM,mBAAmB,CAAC,MAA+B,CAAC,CAAC;YACjI,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,qBAAqB,CAAC,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YACvF,aAAa,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;QAC1M,CAAC;QAAC,OAAO,CAAU,EAAE,CAAC;YACpB,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;YACrB,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAC5F,CAAC;QACD,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,QAAQ,EAAE,CAAC;QAC5B,MAAM,KAAK,GAAW,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QACxC,MAAM,gBAAgB,CAAC,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,KAAK,UAAU,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;QAC7F,OAAO;IACT,CAAC;IAED,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,MAAM,MAAM,GAAoB,MAAM,oBAAoB,EAAE,CAAC;QAC7D,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAChC,aAAa,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,iBAAiB,EAAE,aAAa,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC;QACxI,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAC,CAAC;QAC5D,CAAC;QACD,OAAO;IACT,CAAC;IAED,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;IACrB,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,uBAAuB,UAAU,0CAA0C,CAAC,CAAC,CAAC;AACtG,CAAC"}

package/dist/builtins/store.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Handles store commands.
+ *
+ * @param args - command arguments.
+ */
+export declare function builtin_store(args: string[]): Promise<void>;

package/dist/builtins/store.js

@@ -0,0 +1,107 @@
+/**
+ * @file Builtin store command.
+ * Manages peer store interactions (list, search, install).
+ */
+import chalk from 'chalk';
+import { commandArgs_process } from './utils.js';
+import { store_listPlugins, store_searchPlugins } from '@fnndsc/chili/commands/store/list.js';
+import { grid_render, long_render } from '@fnndsc/chili/views/ls.js';
+import { spinner } from '../lib/spinner.js';
+import { plugin_addInteractive } from './res/plugin.js';
+import { DEFAULT_STORE_URL, storeUrl_get, storeUrl_isDefault, storeUrl_set, storeUrl_clear, storeConfig_persist, } from '../config/storeConfig.js';
+/**
+ * Handles store commands.
+ *
+ * @param args - command arguments.
+ */
+export async function builtin_store(args) {
+    const parsed = commandArgs_process(args);
+    const subcommand = parsed._[0];
+    if (!subcommand) {
+        console.log(chalk.red("Usage: store <list|search|install> ..."));
+        return;
+    }
+    const storeOptions = {
+        store: parsed.store
+    };
+    try {
+        spinner.start('Fetching from store...');
+        if (subcommand === 'list') {
+            const items = await store_listPlugins(storeOptions);
+            spinner.stop();
+            if (items.length === 0) {
+                console.log('No plugins found in store.');
+                return;
+            }
+            // Use grid render by default, or long render if -l flag (handled by view options in future, 
+            // but currently ls view helpers accept options).
+            // chell's ls uses args to parse flags. Here we have parsed args.
+            // parsed.l is boolean.
+            if (parsed.l) {
+                console.log(long_render(items, { human: !!parsed.h }));
+            }
+            else {
+                console.log(grid_render(items));
+            }
+        }
+        else if (subcommand === 'search') {
+            const query = parsed._[1];
+            if (!query) {
+                spinner.stop();
+                console.log(chalk.red("Usage: store search <query>"));
+                return;
+            }
+            const items = await store_searchPlugins(query, storeOptions);
+            spinner.stop();
+            if (items.length === 0) {
+                console.log(`No plugins found matching '${query}'.`);
+                return;
+            }
+            if (parsed.l) {
+                console.log(long_render(items, { human: !!parsed.h }));
+            }
+            else {
+                console.log(grid_render(items));
+            }
+        }
+        else if (subcommand === 'install') {
+            spinner.stop();
+            const installParsed = { ...parsed, _: [parsed._[0], parsed._[1]] };
+            await plugin_addInteractive(installParsed);
+        }
+        else if (subcommand === 'inspect') {
+            spinner.stop();
+            const current = storeUrl_get();
+            const isDefault = storeUrl_isDefault();
+            console.log(`${chalk.bold('Peer store URL:')} ${chalk.blue(current)}${isDefault ? chalk.gray(' (default)') : chalk.yellow(' (custom)')}`);
+        }
+        else if (subcommand === 'set') {
+            spinner.stop();
+            const url = parsed._[1];
+            if (!url) {
+                console.log(chalk.red('Usage: store set <url>'));
+                process.exitCode = 1;
+                return;
+            }
+            storeUrl_set(url);
+            await storeConfig_persist();
+            console.log(chalk.green(`Store URL set to: ${chalk.blue(url)}`));
+        }
+        else if (subcommand === 'reset') {
+            spinner.stop();
+            storeUrl_clear();
+            await storeConfig_persist();
+            console.log(chalk.green(`Store URL reset to default: ${chalk.blue(DEFAULT_STORE_URL)}`));
+        }
+        else {
+            spinner.stop();
+            console.log(chalk.red(`Unknown subcommand: ${subcommand}. Usage: store <list|search|install|inspect|set|reset>`));
+        }
+    }
+    catch (e) {
+        spinner.stop();
+        const msg = e instanceof Error ? e.message : String(e);
+        console.error(chalk.red(`Store error: ${msg}`));
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/builtins/store.js.map

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

package/dist/builtins/sys/context.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Displays the current ChRIS context.
+ *
+ * @param args - Command line arguments (optional flags).
+ */
+export declare function builtin_context(args: string[]): Promise<void>;

package/dist/builtins/sys/context.js

@@ -0,0 +1,50 @@
+/**
+ * @file Builtin context command.
+ * Displays the current session context.
+ */
+import chalk from 'chalk';
+import { context_getSingle } from '@fnndsc/salsa';
+import { session } from '../../session/index.js';
+import { table_display } from '@fnndsc/chili/screen/screen.js';
+/**
+ * Displays the current ChRIS context.
+ *
+ * @param args - Command line arguments (optional flags).
+ */
+export async function builtin_context(args) {
+    const context = await context_getSingle();
+    const tableData = [
+        {
+            Context: 'ChRIS User',
+            Value: context.user || chalk.gray('Not set'),
+        },
+        {
+            Context: 'ChRIS URL',
+            Value: context.URL || chalk.gray('Not set'),
+        },
+        {
+            Context: 'ChRIS Folder',
+            Value: context.folder || chalk.gray('Not set'),
+        },
+        {
+            Context: 'ChRIS Feed',
+            Value: context.feed || chalk.gray('Not set'),
+        },
+        {
+            Context: 'ChRIS Plugin',
+            Value: context.plugin || chalk.gray('Not set'),
+        },
+        {
+            Context: 'PACS Server',
+            Value: context.pacsserver || chalk.gray('Not set'),
+        },
+        {
+            Context: 'Physical Mode',
+            Value: session.physicalMode_get() ? chalk.magenta('Enabled') : chalk.gray('Disabled'),
+        },
+    ];
+    table_display(tableData, ['Context', 'Value'], {
+        title: { title: 'ChRIS Context', justification: 'center' },
+    });
+}
+//# sourceMappingURL=context.js.map

package/dist/builtins/sys/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../../src/builtins/sys/context.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,KAAK,MAAM,OAAO,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAU/D;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc;IAClD,MAAM,OAAO,GAAkB,MAAM,iBAAiB,EAAE,CAAC;IAEzD,MAAM,SAAS,GAAiB;QAC9B;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7C;QACD;YACE,OAAO,EAAE,WAAW;YACpB,KAAK,EAAE,OAAO,CAAC,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC5C;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC/C;QACD;YACE,OAAO,EAAE,YAAY;YACrB,KAAK,EAAE,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC7C;QACD;YACE,OAAO,EAAE,cAAc;YACvB,KAAK,EAAE,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SAC/C;QACD;YACE,OAAO,EAAE,aAAa;YACtB,KAAK,EAAE,OAAO,CAAC,UAAU,IAAI,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC;SACnD;QACD;YACE,OAAO,EAAE,eAAe;YACxB,KAAK,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC;SACtF;KACF,CAAC;IAEF,aAAa,CACX,SAAS,EACT,CAAC,SAAS,EAAE,OAAO,CAAC,EACpB;QACE,KAAK,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,QAAQ,EAAE;KAC3D,CACF,CAAC;AACJ,CAAC"}

package/dist/builtins/sys/physicalmode.d.ts

@@ -0,0 +1,8 @@
+import { CommandEnvelope } from '@fnndsc/cumin';
+/**
+ * Toggles or displays physical filesystem mode.
+ *
+ * @param args - Command line arguments: 'on', 'off', or empty to display status.
+ * @returns An envelope describing the (possibly updated) physical mode state.
+ */
+export declare function builtin_physicalmode(args: string[]): Promise<CommandEnvelope>;